WASMigrationAppInstaller コマンド
WebSphere® Application Server バージョン 9.0 の WASMigrationAppInstaller コマンドは、アプリケーションを、前にインストールされたバージョンの WebSphere Application Server から新しいバージョンにマイグレーションします。まだインストールされていないアプリケーションのみがマイグレーションされます。
ロケーション
コマンド・ファイルは、バージョン 9.0 profile_root/bin ディレクトリーにあり、このディレクトリーから実行する必要があります。統合ノードのあるデプロイメント・マネージャーの場合、 このコマンドはデプロイメント・マネージャー profile_root/bin ディレクトリーからのみ実行し、 統合ノード・プロファイルからは決して実行しないでください。スタンドアロン・ノードの場合は、 ノードの profile_root/bin ディレクトリーからこのコマンドを実行してください。
権限
このコマンド・スクリプトを実行するには、 ユーザー・プロファイルに *ALLOBJ 権限が必要です。
構文
WASMigrationAppInstaller backupDirectory
[-properties properties_file_name]
[-traceString trace_spec [-traceFile file_name ]]
[-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
パラメーター
このコマンドには、以下のパラメーターがあります。
- これは必須パラメーターで、最初に指定する必要があります。
backupDirectory 値は、このコマンドが構成データをそこからロードし、アプリケーションをインストールするスクリプトを実行するディレクトリーの名前です。
トラブルの回避 (Avoid trouble): WAS_INSTALL および USER_INSTALL ルート・ディレクトリーは、WebSphere バックアップ・ディレクトリーとして無効なディレクトリーです。gotcha
これは、WASPostUpgrade コマンドが構成を読み取るディレクトリーでもあります。
- これはオプション・パラメーターです。properties_file_name 値は、
WASMigrationAppInstaller などのマイグレーション・ツールがどのように動作するのかを定義するパラメーター・プロパティーを含んでいるプロパティー・ファイルへのパスを指定します。
コマンド・ラインに大部分のオプション・パラメーターを指定するのではなく、 マイグレーション・プロパティー・ファイル内にパラメーター・プロパティーを定義することができます。プロパティー・ファイルで定義されているパラメーターがコマンド・ラインでも指定された場合は、コマンド・ラインに指定されたパラメーターが優先されます。
注: プロパティー・ファイル内に指定できないパラメーターがあります (-properties パラメーター自体や -javaoption など)。プロパティーとして定義できないパラメーターのリストについては、 app_server_root/bin ディレクトリー内のテンプレート migration.properties ファイルを参照してください。 - これはオプション・パラメーターです。値 trace_spec は、
収集するトレース情報を指定します。
すべてのトレース情報を収集するには、 "*=all=enabled" (引用符を付けて) を指定します。
-traceString または -traceFile パラメーターを指定しないと、 コマンドはデフォルトでトレース・ファイルを作成し、そのファイルを backupDirectory/logs ディレクトリーに配置します。
- これはオプション・パラメーターです。値 file_name は、
トレース情報の出力ファイルの名前を指定します。
-traceString または -traceFile パラメーターを指定しないと、 コマンドはデフォルトでトレース・ファイルを作成し、そのファイルを backupDirectory/logs ディレクトリーに配置します。
- これはオプション・パラメーターです。このパラメーターを使用して、
WASPreUpgrade コマンドが使用する Java™ ヒープのメモリー・サイズを指定します。
値「-Xms...m」は、開始ヒープ・サイズを示すために指定するパラメーターです。 「...」は、使用する予定だったサイズ (M バイト) に置き換えます。例えば、初期ヒープ・サイズを 128 MB にする場合には、このパラメーターに -javaoption -Xms128m と指定します。
値「-Xmx...m」は、最大ヒープ・サイズを示すために指定するパラメーターです。 「...」は、使用する予定のサイズ (M バイト) に置き換えます。例えば、最大ヒープ・サイズを 1024 MB にする場合には、このパラメーターに -javaoption -Xmx1024m と指定します。
ロギング
WASMigrationAppInstaller ツールは、実行されている間は画面に状況を表示します。 また、このツールは、広範囲にわたるロギング情報のセットを、backupDirectory ディレクトリーに書き込まれる WASMigrationAppInstaller.time_stamp.log ファイルに保存します。 ここで、backupDirectory は、backupDirectory パラメーターに指定された値です。WASMigrationAppInstaller.time_stamp.log ファイルはテキスト・エディターを使用して表示できます。
マイグレーション済みリソース
WASMigrationAppInstaller ツールは、ターゲット・リリースにまだインストールされていないアプリケーションのみをマイグレーションします。正常にインストールされないアプリケーションがある場合、 このツールを必要なだけ何度でも再実行することができ、その際に同じアプリケーションが繰り返し再インストールされることはありません。
また、このツールは、ビジネス・レベル・アプリケーション (BLA) を自動的にインストールします。