WASPostUpgrade コマンド
WebSphere® Application Server 用の WASPostUpgrade コマンドは、 WASPreUpgrade コマンドによって作成された保存済み構成を、指定した backupDirectory から取得します。 WebSphere Application Server の WASPostUpgrade スクリプトは、 WebSphere Application Server バージョン 9.0 にマイグレーションする構成をこのディレクトリーから読み取り、マイグレーションされたすべてのアプリケーションを バージョン 9.0 インストール済み環境の app_server_root/installedApps ディレクトリーに追加します。
このトピックでは、プロファイル構成のマイグレーションについて説明します。 アプリケーションを最新バージョンにマイグレーションするには、 WebSphere Application Server Migration Toolkitを使用します。
Location
このコマンド・ファイルは、app_server_root/bin ディレクトリーにあり、このディレクトリーから実行する必要があります。
権限
このコマンド・スクリプトを実行するには、 ユーザー・プロファイルに *ALLOBJ 権限が必要です。
構文
WASPostUpgrade backupDirectory
[-properties properties_file_name]
[-username userID]
[-password password]
[-oldProfile profile_name]
[-profileName profile_name]
[-setPorts useOld | generateNew | port_starting_number]
[-resolvePortConflicts incrementCurrent | port_starting_number]
[-backupConfig true | false]
[-includeApps true | false | script]
[-requestTimeout seconds]
[-javaoption -Xms...m -javaoption -Xmx...m]
[[-appInstallDirectory user_specified_directory] |
[-keepAppDirectory true | false]]
[-traceString trace_spec [-traceFile file_name]]
WASPostUpgrade backupDirectory
[-oldAdminAgentProfilePath path to old admin agent]
[-oldAdminAgentSoapPort soap port of old admin agent]
[-oldAdminAgentHostname hostname of old admin agent, defaults to localhost ]
[-oldAdminAgentUsername login username for old admin agent, if admin security is enabled ]
[-oldAdminAgentPassword login password for old admin agent, if admin security is enabled ]
[-newAdminAgentProfilePath path to new admin agent ]
[-newAdminAgentSoapPort soap port of new admin agent ]
[-newAdminAgentHostname hostname of new admin agent, defaults to localhost ]
[-newAdminAgentUsername login username for new admin agent, if admin security is enabled ]
[-newAdminAgentPassword login password for new admin agent, if admin security is enabled ]
パラメーター
このコマンドには、以下のパラメーターがあります。
- これは必須パラメーターです。 値 backupDirectory は、 WASPreUpgrade ツールが保管した構成およびファイルを格納し、 WASPostUpgrade ツールが構成およびファイルを読み取るディレクトリーの名前を 指定します。
- これはオプション・パラメーターです。 properties_file_name 値は、
WASPostUpgrade などのマイグレーション・ツールがどのように動作するのかを定義するパラメーター・プロパティーを含むプロパティー・ファイルへのパスを指定します。
コマンド行でほとんどのオプション・パラメーターを指定する代わりに、マイグレーション・プロパティー・ファイルにパラメーター・プロパティーを定義できます。 パラメーターがプロパティー・ファイルとコマンド行の両方で指定されている場合、コマンド行で指定されたパラメーターが優先されます。
注: 一部のパラメーター ( -properties パラメーター自体、 -username および -passwordなど) は、プロパティー・ファイルでは指定できません。 プロパティーとして定義できないパラメーターのリストについては、 app_server_root/bin ディレクトリー内のテンプレート migration.properties ファイルを参照してください。 - これはオプション・パラメーターです。 値 userID は、現在の WebSphere Application Server バージョン 7.0 以降 のインストール済み環境の管理ユーザー名を指定します。
- これはオプション・パラメーターです。 値 password は、現在の WebSphere Application Server バージョン 7.0 以降 のインストール済み環境の管理ユーザー名のパスワードを指定します。
- これは、以前のバージョンの WebSphere Application Server からインスタンスまたはプロファイルをマイグレーションするためのオプション・パラメーターです。 このコマンドを実行する前に、
インスタンスまたはプロファイルがすでにマイグレーション・バックアップ・ディレクトリーに存在している必要があります。-oldProfile パラメーターを指定しない場合には、デフォルト・プロファイルが 使用されます。 デフォルトのプロファイルが見つからない場合は、システムがエラーを報告します。問題の回避:oldProfileに特定のプロファイル名を指定しないと、指定された「デフォルト」プロファイルがすべてマイグレーションされます。 新しい バージョン 9.0 環境でクライアントが必要とするすべてのプロファイルごとに-oldProfile および-profileName パラメーターを指定した WASPostUpgrade 事後マイグレーション・コマンドを使用して、事前マイグレーションで取られたバックアップ内の各プロファイルをマイグレーションしなければならない場合があります。 以前のプロファイルに、サンプル・アプリケーションとシステム・アプリケーションの他にインストール済みアプリケーション (installedApps) が含まれている場合、 マイグレーション・プロセスは自動的にそれらのアプリケーションをマイグレーションします。
- これは、 WebSphere Application Server バージョン 9.0で特定のプロファイルにマイグレーションする場合のオプション・パラメーターです。 値 profile_name は、スクリプトが構成をマイグレーションする バージョン 9.0 プロファイルの名前を指定します。 WASPostUpgrade コマンドを呼び出す前に、
このプロファイルを作成しておく必要があります。-profileName パラメーターを指定しない場合には、デフォルト・プロファイルが 使用されます。 デフォルトのプロファイルが見つからない場合は、システムがエラーを報告します。問題の回避:profileNameに特定のプロファイル名を指定しないと、指定された「デフォルト」プロファイルがすべてマイグレーションされます。 事前マイグレーションで取られたバックアップ内の各プロファイルを、新しい環境でクライアントが必要とするすべてのプロファイルごとに -oldProfile パラメーターと -profileName パラメーターを指定した WASPostUpgrade 事後マイグレーション・コマンドを使用してマイグレーションすることが必要な場合があります。 以前のプロファイルに、サンプル・アプリケーションとシステム・アプリケーションの他にインストール済みアプリケーション (installedApps) が含まれている場合、 マイグレーション・プロセスは自動的にそれらのアプリケーションをマイグレーションします。注: バージョン 9.0からスタンドアロン・アプリケーション・サーバーをマイグレーションする場合、既に管理エージェントに登録されているスタンドアロン・アプリケーション・サーバー・ノードをマイグレーションのターゲットとして選択できます。
- これは、 WASPostUpgrade ツールによって変更が行われる前に、既存の WebSphere Application Server バージョン 9.0 構成を保存するかどうかを指定するために使用されるオプション・パラメーターです。 デフォルトでは true になります。
すなわち、backupConfig コマンドを使用して、現在の構成のコピーを profile_name/temp ディレクトリーに保存します。
restoreConfig コマンドを使用して、必要に応じて構成をリストアします。 詳しくは、『restoreConfig コマンド』を参照してください。
- これは、新規プロファイルのポートを設定する方法を指定するオプション・パラメーターです。 このパラメーターは、
以下の値を取ります。
このパラメーターに値が指定されていると、割り当てられる新しいポートはこの値に基づいて設定されます。 新しいポート値が必要となるたびに、この値に基づいてポートが作成され、次の使用に備えてシード値が増加します。 重複ポートは割り当てられません。
- このオプション・パラメーターは、ポート値のマップ方法を指定するために使用されます。 ポートを使用できない場合に、
使用可能なポートが見つかるまで、開始値からこの値分ずつ増やしていきます。
- ビジネス・レベル・アプリケーション、資産、および構成単位をマイグレーションの一部として含めることができます。 オプションで、これらの項目を WASPostUpgrade コマンドに -IncludeApps パラメーターを使用してマイグレーションできます。 これは、以下の方法で指定できるオプション・パラメーターです。
WebSphere Application Server システム・アプリケーションは、このパラメーターで設定された値に関係なくマイグレーションされます。
- これは、すべてのアプリケーションを、現在配置されているものと同じディレクトリーにインストールするかどうか
を指定するために使用するオプション・パラメーターです。 デフォルトは false です。
このパラメーターが true に指定されると、 個々のアプリケーションはそのロケーションを保持します。
このパラメーターを指定する場合は、-appInstallDirectory パラメーターを指定することはできません。
制約事項: このパラメーターを true に指定すると、ロケーションは既存の WebSphere Application Server バージョン 7.0 以降 のインストール済み環境と バージョン 9.0 のインストール済み環境によって共有されます。 マイグレーションされたアプリケーションを以前のバージョンのアプリケーションと同じロケーションに保持する場合は、以下の制約事項が適用されます。 - これは、マイグレーション中にすべてのアプリケーションをインストールする際に
使用するディレクトリー名を渡すために使用するオプション・パラメーターです。 このパラメーターが指定されていない場合は、デフォルトの profile_name\installedApps が使用されます。
このパラメーターを指定する場合は、-keepAppDirectory パラメーターを指定することはできません。
1 つ以上のスペースを含むディレクトリー名は引用符で囲む必要があります。
このパラメーターを使用すると、マイグレーション・ツールは、バックアップ・ディレクトリー (古いリリースの変数) と宛先プロファイル (新しいリリースからの変数) の両方で、マイグレーションするノードのノード・レベル変数を調べます。 パスがこれらのリリースのどちらかである次のいずれかの変数の一部であると、ツールはパス情報を縮小して関連する変数を使用します。MIGR0341W: Application install directory has been updated to {0}.
以下に例を示します。MIGR0341W: Application install directory has been updated to ${USER_INSTALL_ROOT}¥customAppDirectory.
またはMIGR0341W: Application install directory has been updated to ${APP_INSTALL_ROOT}¥ cellName¥customAppDirectory¥.
- これはオプション・パラメーターです。 値 trace_spec は、
収集するトレース情報を指定します。
すべてのトレース情報を収集するには、 "*=all=enabled" (引用符を付けて) を指定します。
-traceString または -traceFile パラメーターを指定しないと、 コマンドはデフォルトでトレース・ファイルを作成し、そのファイルを backupDirectory/logs ディレクトリーに配置します。
- これはオプション・パラメーターです。 値 file_name は、
トレース情報の出力ファイルの名前を指定します。
-traceString または -traceFile パラメーターを指定しないと、 コマンドはデフォルトでトレース・ファイルを作成し、そのファイルを backupDirectory/logs ディレクトリーに配置します。
- これはオプション・パラメーターです。 値 seconds は、wsadmin 接続試行が失敗する前に、
マイグレーションが待機する秒数を表します。
この値は、アプリケーションをマイグレーション中のタイムアウト・パラメーターとしても使用されます。
- これはオプション・パラメーターです。 値 path to old
admin agent は、元の管理エージェントのプロファイル・ディレクトリーのファイル・システム・パスを表します。
マイグレーションされるアプリケーション・サーバーが管理エージェントによって管理されている場合にのみ、このパラメーターは必須です。
- これはオプション・パラメーターです。 値 soap port of
old admin agent は、元の管理エージェントが管理接続に使用していた SOAP ポートを表します。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 値 hostname of
old admin agent は、元の管理エージェントのホスト名のロケーションを表します。 このパラメーターを指定しないと、値はデフォルトで「localhost」に設定されます。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 値 login username
for old admin agent は、元の管理エージェントのユーザー名を表します。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが、管理セキュリティーが使用可能になっている管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 値 path to new
admin agent は、新しくマイグレーションした管理エージェントのプロファイル・ディレクトリーのファイル・システム・パスを表します。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 値 soap port of
new admin agent は、新しくマイグレーションした管理エージェントが管理接続に使用する SOAP ポートを表します。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 その値である新しい管理エージェントのホスト名 は、新しい管理エージェントのホスト名の場所を指します。 このパラメーターを指定しないと、値はデフォルトで「localhost」に設定されます。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 値 login username
for new admin agent は、新しい管理エージェントのユーザー名を表します。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが、管理セキュリティーが使用可能になっている管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 値 login password
for new admin agent は、新しい管理エージェントのパスワードを表します。
このパラメーターは、マイグレーションされているアプリケーション・サーバーが、管理セキュリティーが使用可能になっている管理エージェントによって管理されている場合にのみ必要です。
- これはオプション・パラメーターです。 このパラメーターを使用して、
WASPostUpgrade が使用する Java ヒープのメモリー・サイズを指定します。
値 "-Xms...m" は、初期ヒープ・サイズを指定します。 「...」を置換します。 必要なメガバイト単位のサイズになります。 例えば、初期ヒープ・サイズを 128 MB にする場合には、このパラメーターに -javaoption -Xms128m と指定します。
値「-Xmx...m」は、最大ヒープ・サイズを指定します。 「...」を置換します。 必要なメガバイト単位のサイズになります。 例えば、最大ヒープ・サイズを 1024 MB にする場合には、このパラメーターに -javaoption -Xmx1024m と指定します。
セキュリティーに関する考慮事項
マイグレーションの前にターゲット・システムのセキュリティーを無効にしておく必要があります。 セキュリティーが有効になっているソース構成からマイグレーションする場合、 WASPostUpgrade コマンドは、マイグレーション中に バージョン 9.0 ターゲット構成のセキュリティーを自動的に有効にします。