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を使用します。

場所

このコマンド・ファイルは、app_server_root/bin ディレクトリーにあり、このディレクトリーから実行する必要があります。

構文

WASPostUpgrade.sh 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]
                     [-newDmgrHostname host_name]
                     [[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
                     [-keepDmgrEnabled true | false]
                     [-requestTimeout seconds]
                     [-javaoption -Xms...m -javaoption -Xmx...m]
                     [[-appInstallDirectory user_specified_directory] | 
                     [-keepAppDirectory true | false]]
                     [-traceString trace_spec [-traceFile file_name]]
                     [-clone true | false]
                     [-newDmgrHostname hostName]
                     [-newDmgrSoapPort port]
                     [-newDmgrRmiPort port]

WASPostUpgrade.bat 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]
                     [-newDmgrHostname host_name]
                     [[-newDmgrSoapPort port_number] | [-newDmgrRmiPort port_number]]
                     [-keepDmgrEnabled true | false]
                     [-requestTimeout seconds]
                     [-javaoption -Xms...m -javaoption -Xmx...m]
                     [[-appInstallDirectory user_specified_directory] | 
                     [-keepAppDirectory true | false]]
                     [-traceString trace_spec [-traceFile file_name]]
                     [-clone true | false]
                     [-newDmgrHostname hostName]
                     [-newDmgrSoapPort port]
                     [-newDmgrRmiPort port]

ターゲットとソースの両方の管理エージェントに対してセキュリティーが有効になっている登録済みアプリケーション・サーバーをマイグレーションする場合は、以下のパラメーターを使用します。 [Linux]

WASPostUpgrade.sh 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 ]

WASPostUpgrade.bat 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

これは必須パラメーターです。値 backupDirectory は、 WASPreUpgrade ツールが保管した構成およびファイルを格納し、 WASPostUpgrade ツールが構成およびファイルを読み取るディレクトリーの名前を指定します。

-プロパティー

これはオプション・パラメーターです。 properties_file_name 値は、 WASPostUpgrade などのマイグレーション・ツールがどのように動作するのかを定義するパラメーター・プロパティーを含むプロパティー・ファイルへのパスを指定します。

コマンド行でほとんどのオプション・パラメーターを指定する代わりに、マイグレーション・プロパティー・ファイルにパラメーター・プロパティーを定義できます。パラメーターがプロパティー・ファイルとコマンド行の両方で指定されている場合、コマンド行で指定されたパラメーターが優先されます。

注: -properties パラメーター自体や -username および -passwordなど、特定のパラメーターをプロパティー・ファイルに指定することはできません。プロパティーとして定義できないパラメーターのリストについては、 app_server_root/bin ディレクトリー内のテンプレート migration.properties ファイルを参照してください。

-username

これはオプション・パラメーターです。値 userID は、現在の WebSphere Application Server バージョン 7.0 以降のインストール済み環境の管理ユーザー名を指定します。

以下の条件が該当する場合、これは必須パラメーターです。

デプロイメント・マネージャーまたは統合ノードをマイグレーションする。
ソース・インストールで管理セキュリティーまたはグローバル・セキュリティーが有効である。
管理セキュリティーまたはグローバル・セキュリティーのユーザー ID が security.xml ファイルに定義されていない。

-password

これはオプション・パラメーターです。値 password は、現行の WebSphere Application Server バージョン 7.0 以降インストール済み環境の管理ユーザー名のパスワードを指定します。

以下の条件が該当する場合、これは必須パラメーターです。

デプロイメント・マネージャーまたは統合ノードをマイグレーションする。
ソース・インストールで管理セキュリティーまたはグローバル・セキュリティーが有効である。
管理セキュリティーまたはグローバル・セキュリティーのパスワードが security.xml ファイルに定義されていない。

ヒント: マイグレーション・ウィザードでパスワードを指定する必要がある場合、またはコマンド行で-password パラメーターを指定して WASPostUpgrade コマンドを使用する場合は、パスワードをプレーン・テキストで入力するか、xor 暗号化された値を使用することができます。 xor 暗号化された値を使用するには、パラメーターの値として {xor} 接頭部を含む暗号全体を入力します。この xor 暗号化された値は、 soap.client.propsファイル、 ssl.client.propsファイル、および security.xml ファイルを含む、前の構成のいくつかの WebSphere Application Server 構成ファイルのいずれかで指定できます。

ヒント: コマンド・ラインで-password パラメーターを指定して WASPostUpgrade コマンドを使用する場合は、パスワードをプレーン・テキストで入力するか、xor 暗号化された値を使用することができます。 xor 暗号化された値を使用するには、パラメーターの値として {xor} 接頭部を含む暗号全体を入力します。この xor 暗号化された値は、 soap.client.propsファイル、 ssl.client.propsファイル、および security.xml ファイルを含む、前の構成のいくつかの WebSphere Application Server 構成ファイルのいずれかで指定できます。

-oldProfile

これは、以前の WebSphere Application Server バージョンからインスタンスまたはプロファイルをマイグレーションするためのオプション・パラメーターです。このコマンドを実行する前に、インスタンスまたはプロファイルがすでにマイグレーション・バックアップ・ディレクトリーに存在している必要があります。

-oldProfile パラメーターを指定しない場合には、デフォルト・プロファイルが使用されます。デフォルトのプロファイルが見つからない場合は、システムがエラーを報告します。

トラブルを避ける： -oldProfile,、特定のプロファイル名を指定しなければ、指定された「デフォルト」プロファイルが移行される。マイグレーション前に取得したバックアップの各プロファイルを、 WASPostUpgrade ポストマイグレーションコマンドを使用して、新しいバージョン 9.0 環境でクライアントが希望する各プロファイルの -oldProfile と -profileName パラメータを指定してマイグレーションする必要があるかもしれません。以前のプロファイルに、サンプル・アプリケーションとシステム・アプリケーションの他にインストール済みアプリケーション (installedApps) が含まれている場合、マイグレーション・プロセスは自動的にそれらのアプリケーションをマイグレーションします。

-profileName

これは、 WebSphere Application Server バージョン 9.0の特定のプロファイルにマイグレーションする場合のオプション・パラメーターです。値 profile_name は、スクリプトが構成をマイグレーションする先のバージョン 9.0 プロファイルの名前を指定します。 WASPostUpgrade コマンドを呼び出す前に、このプロファイルを作成しておく必要があります。

-profileName パラメーターを指定しない場合には、デフォルト・プロファイルが使用されます。デフォルトのプロファイルが見つからない場合は、システムがエラーを報告します。

トラブルを避ける： -profileName,、特定のプロファイル名を指定しなければ、指定された「デフォルト」プロファイルが移行される。事前マイグレーションで取られたバックアップ内の各プロファイルを、新しい環境でクライアントが必要とするすべてのプロファイルごとに -oldProfile パラメーターと -profileName パラメーターを指定した WASPostUpgrade 事後マイグレーション・コマンドを使用してマイグレーションすることが必要な場合があります。以前のプロファイルに、サンプル・アプリケーションとシステム・アプリケーションの他にインストール済みアプリケーション (installedApps) が含まれている場合、マイグレーション・プロセスは自動的にそれらのアプリケーションをマイグレーションします。

注: スタンドアロン・アプリケーション・サーバーをバージョン 9.0からマイグレーションする場合、マイグレーションのターゲットとして、管理エージェントに既に登録されているスタンドアロン・アプリケーション・サーバー・ノードを選択できます。

-backupConfig

これは、 WASPostUpgrade ツールによって変更が行われる前に、既存の WebSphere Application Server バージョン 9.0 構成を保存するかどうかを指定するために使用されるオプション・パラメーターです。デフォルトは true です。つまり、backupConfig コマンドを使用して、現在の構成のコピーを profile_name/temp ディレクトリーに保存します。

restoreConfig コマンドを使用して、必要に応じて構成をリストアします。詳しくは、『restoreConfig コマンド』を参照してください。

-setPorts

これは、新規プロファイルのポートを設定する方法を指定するオプション・パラメーターです。このパラメーターは、以下の値を取ります。

useOld (デフォルト): 古いプロファイルで使用していたポートと同じポートを使用します。ローカル・マイグレーションの場合、この値を -clone true オプションと一緒に使用することはできません。
generateNew: デフォルトのポート割り当てに基づいて新しいポートを生成します。
port_starting_number: 指定された値から増やして、新しいポートを生成します。

このパラメーターに値が指定されていると、割り当てられる新しいポートはこの値に基づいて設定されます。新しいポート値が必要となるたびに、この値に基づいてポートが作成され、次の使用に備えてシード値が増加します。重複ポートは割り当てられません。

-resolvePortConflicts

このオプション・パラメーターは、ポート値のマップ方法を指定するために使用されます。ポートを使用できない場合に、使用可能なポートが見つかるまで、開始値からこの値分ずつ増やしていきます。

incrementCurrent (デフォルト): 競合したポート値から増やします。
port_starting_number: 指定された共通開始ポート値から増やします。

-includeApps

ビジネス・レベル・アプリケーション、資産、および構成単位をマイグレーションの一部として含めることができます。オプションで、これらの項目を WASPostUpgrade コマンドに -IncludeApps パラメーターを使用してマイグレーションできます。これは、以下の方法で指定できるオプション・パラメーターです。

はい
ユーザーのエンタープライズ・アプリケーション、ビジネス・レベル・アプリケーション、資産、および構成単位をマイグレーションの一部として含めます。

この値がデフォルトです。
いいえ
WASPostUpgrade 処理の間は、ユーザーのエンタープライズ・アプリケーション、ビジネス・レベル・アプリケーション、資産、および構成単位に対して何の処置も行いません。
Script
- エンタープライズ・アプリケーション
  WASPostUpgrade 処理中にインストールせずに、 WebSphere Application Server バージョン 9.0 installableApps ディレクトリーにインストールするユーザー・エンタープライズ・アプリケーションを準備します。
  
  これらのアプリケーションのインストールに使用できるスクリプトは、 backupDirectory ディレクトリーで生成され保存されます。 WASPostUpgrade コマンドが完了したら、これらのファイルを、任意の場所、任意の組み合わせで実行できます。また、アプリケーションのインストールをより効率的に行うために、これらのファイルを再編成して結合することもできます。
- ビジネス・レベル・アプリケーション、資産、および構成単位
  install_all_BLAs.jy スクリプトが生成され、バックアップ・ディレクトリーに配置されます。このスクリプトによって、バックアップ・ディレクトリー内のすべてのビジネス・レベル・アプリケーション、資産、および構成単位をターゲット・プロファイルにマイグレーションできます。 <WAS_PROFILE_ROOT>/bin ディレクトリー内に配置されている WASPostUpgradeBLAHelper.bat/.sh スクリプトは、install_all_BLAs.txt ファイル内のビジネス・レベル・アプリケーション、資産、および構成単位をマイグレーションするために使用されます。
  
  問題の回避: ビジネス・レベル・アプリケーション、資産、および構成単位をマイグレーションするには、最初にそれらの依存関係を作成する必要があります。

WebSphere Application Server システム・アプリケーションは、このパラメーターによって設定された値に関係なくマイグレーションされます。

-clone

このオプション・パラメーターは、複製マイグレーションを実行するかどうかを示します。つまり、バージョン 9.0 環境にマイグレーションした後も、ソース・プロファイルを引き続き使用できます。デフォルト値はfalseです。

[9.0.5.11 以降] WebSphere Application Server バージョン 9.0 プロファイルを、 WebSphere Application Server バージョン 9.0 インストール済み環境から別のインストール済み環境 (別のマシン上のインストール済み環境を含む) にマイグレーションすることができます。これを行うには、 WASPreUpgrade コマンドで -allowSameRelease パラメーターを設定し、 -clone パラメーターを trueに設定します。

-clone パラメーターが true の場合、-setPorts useold を指定できるのは、リモート・マイグレーションの場合のみです。リモート・マイグレーションは、異なるマシンへのマイグレーションです。ローカル・マイグレーションの場合、 -setPorts useoldを指定することはできません。共存することになる新しい構成と古い構成でポート競合が発生しないようにするために、新しいプロファイル構成では固有のポート番号を使用する必要があります。

デプロイメント・マネージャーを複製する場合は、その統合ノードを複製する必要があります。また、デプロイメント・マネージャーを複製せずに統合ノードを複製することはできません。統合ノードの複製マイグレーションを行うには、以下のパラメーターで、新規ホスト名と、ノードの SOAP ポートまたは RMI ポートのいずれかを設定する必要があります。

-newDmgrHostname: バージョン 9.0 デプロイメント・マネージャーのホスト名
-newDmgrSoapPort: バージョン 9.0 デプロイメント・マネージャーの Simple Object Access Protocol (SOAP) ポート
-newDmgrRmiPort: バージョン 9.0 デプロイメント・マネージャーのリモート・メソッド呼び出し (RMI) ポート

-keepDmgrEnabled

これは、既存の WebSphere Application Server バージョン 7.0 以降のデプロイメント・マネージャーを使用不可にするかどうかを指定するために使用されるオプション・パラメーターです。 -clone パラメーターが true でない限り、デフォルトは false です。true の場合、 -keepDmgrEnabled も true に設定されます。

このパラメーターを true に指定すると、マイグレーションの完了時に既存のバージョン 7.0 以降のデプロイメント・マネージャーを使用できます。これは、デプロイメント・マネージャーをマイグレーションしている場合のみ有効であり、それ以外のすべてのマイグレーションでは無視されます。

注意: このパラメーターは注意して使用してください。

WebSphere Application Server バージョン 7.0 以降のデプロイメント・マネージャー構成が通常は停止して使用不可になる理由は、複数のデプロイメント・マネージャーが同じノードを管理しないようにするためです。バージョン 9.0 デプロイメント・マネージャーの使用を開始する前に、バージョン 7.0 以降のデプロイメント・マネージャーを停止する必要があります。これを行わないと、デプロイメント・マネージャーの 2 番目のインスタンスが開始される際にポート競合が生じる、というエラー条件が起こる可能性が極めて高くなります。
このパラメーターを true に指定すると、マイグレーション中に以前の構成で行われた構成変更がマイグレーションされない可能性があります。

-keepAppDirectory

これは、すべてのアプリケーションを、現在配置されているものと同じディレクトリーにインストールするかどうかを指定するために使用するオプション・パラメーターです。デフォルトは false です。

このパラメーターが true に指定されると、個々のアプリケーションはそのロケーションを保持します。

このパラメーターを指定する場合は、-appInstallDirectory パラメーターを指定することはできません。

制約事項: このパラメーターが true に指定されている場合、ロケーションは、既存の WebSphere Application Server バージョン 7.0 以降インストール済み環境およびバージョン 9.0 インストール済み環境によって共有されます。マイグレーションされたアプリケーションを以前のバージョンのアプリケーションと同じロケーションに保持する場合は、以下の制約事項が適用されます。

WebSphere Application Server バージョン 9.0 混合ノード・サポートの制限に従う必要があります。つまり、wsadmin コマンドを呼び出す場合に以下のサポートは使用できません。
- JSP のプリコンパイル
- バイナリー構成の使用
- EJB のデプロイ
バージョン 7.0 以降のインストール済み環境を管理する際に、後でこれらのロケーションからアプリケーションを削除すると、マイグレーションされたアプリケーションが意図せずに失われる危険性があります。

-appInstallDirectory

これは、マイグレーション中にすべてのアプリケーションをインストールする際に使用するディレクトリー名を渡すために使用するオプション・パラメーターです。このパラメーターを指定しない場合は、デフォルトの profile_name\installedApps が使用されます。

このパラメーターを指定する場合は、-keepAppDirectory パラメーターを指定することはできません。

1 つ以上のスペースを含むディレクトリー名は引用符で囲む必要があります。

このパラメーターを使用すると、マイグレーション・ツールは、バックアップ・ディレクトリー (古いリリースの変数) と宛先プロファイル (新しいリリースからの変数) の両方で、マイグレーションするノードのノード・レベル変数を調べます。パスがこれらのリリースのどちらかである次のいずれかの変数の一部であると、ツールはパス情報を縮小して関連する変数を使用します。

APP_INSTALL_ROOT
USER_INSTALL_ROOT
WAS_INSTALL_ROOT

縮小が行われると、指定された値をツールが変更したこと、およびその縮小された値を示す次の警告メッセージが表示されます。

MIGR0341W: Application install directory has been updated to {0}.

例：

MIGR0341W: Application install directory has been updated to ${USER_INSTALL_ROOT}&#xa5;customAppDirectory.

または

MIGR0341W: Application install directory has been updated to ${APP_INSTALL_ROOT}&#xa5;
cellName\customAppDirectory\.

-traceString

これはオプション・パラメーターです。値 trace_spec は、収集するトレース情報を指定します。

すべてのトレース情報を収集するには、 "*=all=enabled" (引用符を付けて) を指定します。

-traceString または -traceFile パラメーターを指定しないと、コマンドはデフォルトでトレース・ファイルを作成し、そのファイルを backupDirectory/logs ディレクトリーに配置します。

-traceFile

これはオプション・パラメーターです。値 file_name は、トレース情報の出力ファイルの名前を指定します。

-requestTimeout

これはオプション・パラメーターです。値 seconds は、wsadmin 接続試行が失敗する前に、マイグレーションが待機する秒数を表します。

この値は、アプリケーションをマイグレーション中のタイムアウト・パラメーターとしても使用されます。

-oldAdminAgentProfilePath

これはオプション・パラメーターです。値 path to old admin agent は、元の管理エージェントのプロファイル・ディレクトリーのファイル・システム・パスを表します。