管理者は、convertScriptCompatibility コマンドを使用して、
WebSphere Application Server バージョン 5.x または 6.0.x の管理スクリプトの後方互換性をサポートするモードから、
完全にバージョン 6.1.x 構成モデルであるモードに構成を変換します。
構成の有効範囲は、処理されているプロファイルのタイプに応じて変化します。
ノードは、混合ノード構成をサポートするための処理が行われる前に、WebSphere Application
Server バージョン 6.1.x レベルであることを検査するために、チェックされます。
クライアント環境は処理されません。
以下の型変換は、このツールを使用して
行われます。
- processDef から processDefs
WebSphere Application Server バージョン 5.x の
タイプ processDef である WCCM オブジェクトは、バージョン 6.1.x server.xml モデルに定義されているように、processDefs を使用するために変換されます。
既存の processDef オブジェクトは構成内に残り、
実行時に無視されます。
- トランスポートからチャネル
WebSphere Application Server バージョン 5.x の構成にある
既存のトランスポート・エントリーは、チャネル・サポートにマップされます。
このことは、server.xml および serverindex.xml ファイルに影響を与えます。
トランスポート設定の値が使用されて新規のチャネル・エントリーが作成されます。
- SSL 構成
WebSphere Application Server バージョン 6.1.x には SSL 構成の拡張機能が含まれ、
これは、結果的に既存の SSL 構成モデルをリファクタリングします。新旧いずれのモデルもサポートされます。
デフォルトでは、WebSphere Application Server バージョン 5.x または 6.0.x の SSL 構成モデルにマップします。
- bootstrapAddress から bootstrapAddresses
各単一ブートストラップ・アドレス構成は、その単一ブートストラップ・アドレスを含む新規のブートストラップ・アドレス・リスト構成に変換されます。
- ObjectRequestBroker サーバー・スレッド・プールの不使用からサーバー・スレッド・プールの使用へ
例えば、<ObjectRequestBroker useServerThreadPool="false"...> は <ObjectRequestBroker useServerThreadPool="true"> に変わります。
構文
構文は次のようになります。
convertScriptCompatibility [-help]
convertScriptCompatibility [-profileName profile_name]
[-backupConfig true | false]
[-nodeName node_name [-serverName server_name]]
[-traceString trace_spec [-traceFile file_name]]
パラメーター
サポートされる引数には次のパラメーターがあります。
- -help
- このコマンドのヘルプを表示します。
- -backupConfig
- 現行のプロファイルの既存の構成をバックアップするために使用するオプション・パラメーター。
デフォルトは true になります。backupConfig コマンドを
使用して、現在の構成のコピーを
profile_name/temp
ディレクトリーに保存します。
restoreConfig コマンドを使用して、必要に応じて構成をリストアします。
restoreConfig コマンド
を参照してください。
- -profileName
- バージョン 6.1.x 環境でプロファイル構成を指定するために使用するオプション・パラメーター。
指定されていない場合は、デフォルト・プロファイルが使用されます。
デフォルト・プロファイルが設定されていないか検出できない場合、システムはエラーを戻します。
- -nodeName
- 構成内のすべてのノードではなく、処理される特定のノード名を指定するために使用するオプション・パラメーター。
指定されていない場合、すべてのノードがその構成内で変換されます。
- -serverName
- 構成内のすべてのサーバーではなく、処理される特定のサーバー名を指定するために使用するオプション・パラメーター。
すべてのプロファイル・タイプで使用することができ、
Network Deployment 構成を処理するときに、-nodeName パラメーターと連動して使用することができます。
このパラメーターが指定されていない場合、すべてのサーバーがその構成内で変換されます。
-nodeName パラメーターと連動して使用される場合、すべての処理は、指定されたノード名に制限されます。
- -traceString
- これはオプション・パラメーターです。値 trace_spec は、
収集するトレース情報を指定します。すべてのトレース情報を収集するには、
"*=all=enabled" (引用符を付けて) を指定します。デフォルトでは、
トレース情報は収集されません。このパラメーターを指定する場合は、-traceFile パラメーターも指定する必要があります。
- -traceFile
- これはオプション・パラメーターです。値 file_name は、
トレース情報の出力ファイルの名前を指定します。-traceString パラメーターを指定するが、
-traceFile パラメーターを指定しない場合、コマンドはトレース・ファイルを生成しません。
使用法
- スタンドアロンのアプリケーション・サーバー・プロファイル
- 「シナリオの例」
- WASPostUpgrade コマンドを実行し、-scriptCompatibility パラメーター (デフォルト値は true) に -scriptCompatibility=true を指定するか、値を指定しないでください。
- 以下の手順に従い、このスタンドアロン・プロファイル下のすべてのサーバーを変換します。
- Qshell セッションを開始します。
STRQSH
- バージョン 6.1.x の app_server_root/bin ディレクトリーに変更します。
- 以下のコマンドを実行します。
convertScriptCompatibility -profileName profile_name
このコマンドを実行する場所について詳しくは、コマンド行ツールの使用
を参照してください。