WebSphere Application Server Network Deployment, Version 6.1   
             オペレーティング・システム: AIX , HP-UX, Linux, Solaris, Windows, Windows Vista

             目次と検索結果のパーソナライズ化

WASPostUpgrade コマンド

WebSphere Application Server バージョン 6.1 の WASPostUpgrade コマンドを使用すると、 ユーザーが指定した backupDirectoryWASPreUpgrade コマンドで作成された、 保管されている構成を検索できます。 WebSphere Application Server バージョン 6.1 の WASPostUpgrade スクリプトは、 このディレクトリーから WebSphere Application Server バージョン 6.1 にマイグレーションする構成を読み取り、 マイグレーションされたすべてのアプリケーションをバージョン 6.1 インストール・システムの app_server_root/installedApps ディレクトリーに追加します。

ロケーション

コマンド・ファイルは、 バージョン 6.1 app_server_root/bin ディレクトリーにあり、ここで実行します。

構文

構文は次のようになります。

[AIX] [HP-UX] [Linux] [Solaris]
WASPostUpgrade.sh backupDirectory
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-scriptCompatibility true | false]
                     [-portBlock port_starting_number]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-includeApps true | false | script]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]
[Windows]
WASPostUpgrade.bat backupDirectory
                     [-oldProfile profile_name]
                     [-profileName profile_name]
                     [-scriptCompatibility true | false]
                     [-portBlock port_starting_number]
                     [-backupConfig true | false]
                     [-replacePorts true | false]
                     [-includeApps true | false | script]
                     [-keepAppDirectory true | false]
                     [-keepDmgrEnabled true | false]
                     [-appInstallDirectory user_specified_directory]
                     [-traceString trace_spec [-traceFile file_name]]

パラメーター

パラメーターは、以下のとおりです。

backupDirectory
これは必須パラメーターです。値 backupDirectory は、 WASPreUpgrade ツールが保管した構成およびファイルを格納し、 WASPostUpgrade ツールが構成およびファイルを読み取るディレクトリーの名前を 指定します。
-oldProfile
これは WebSphere Application Server の前のバージョンから インスタンスまたはプロファイルをマイグレーションするためのオプション・パラメーターです。 このコマンドを実行する前に、 インスタンスまたはプロファイルがすでにマイグレーション・バックアップ・ディレクトリーに存在している必要があります。

WebSphere Application Server バージョン 5.x では、 -instanceName および -hostName を連結させた固有のインスタンス名が定義されていました。 この連結によって、-oldprofile パラメーターと一緒に使用するのに必要な profile_name が 形成されます。WebSphere Application Server バージョン 5.x では、この連結形は app_server_root/properties ディレクトリーの wsinstance.config と呼ばれるファイルに格納されていました。

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

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

-scriptCompatibility
これは、マイグレーションで以下のバージョン 5.x または 6.0.x 構成定義を 作成するかどうかを指定するために使用するオプション・パラメーターです。
  • トランスポート
  • ProcessDef
  • バージョン 5.x または 6.0.x SSL
以下のバージョン 6.1 構成定義の代わり:
  • チャネル
  • ProcessDefs
  • バージョン 6.1 SSL

デフォルトは true です。

既存の管理スクリプトに対する影響を最小限に抑えるため、このパラメーターを true に指定します。 例えば、サード・パーティーの構成 API を使用する既存の wsadmin スクリプト またはプログラムで、バージョン 5.x または 6.0.x 構成定義を作成または変更する場合、 マイグレーション中にこのオプションを true に指定できます。

注: こうすることで、環境内のすべてのノードがバージョン 6.1 レベルになるまで、一時的な移行が提供されます。 すべてのノードがバージョン 6.1 レベルになったら、以下のアクションを実行する必要があります。
  1. すべてのバージョン 6.1 設定を使用するように、管理スクリプトを変更します。
  2. convertScriptCompatability コマンドを使用して、 すべてのバージョン 6.1 設定に一致するように、構成を変換します。

    convertScriptCompatibility コマンド を参照してください。

-portBlock
これはオプション・パラメーターです。port_starting_number 値は、 コマンド・スクリプトが実行するときに割り当てる連続したポート番号のブロックの最初を指定します。
-backupConfig
これは、WASPostUpgrade ツールが変更を行う前に、 既存の WebSphere Application Server バージョン 6.1 構成を保管するかどうかを指定するために使用する オプション・パラメーターです。 デフォルトは true になります。backupConfig コマンドを 使用して、現在の構成のコピーを profile_name/temp ディレクトリーに保存します。

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

-replacePorts
このオプション・パラメーターは、仮想ホストおよび Web コンテナー・トランスポート・ポート用のポート値をマップする方法を指定するために使用されます。
  • False
    マイグレーション中は、デフォルトのポート定義を置き換えないでください。
    • 前のバージョンの構成はそのままです。チャネルは削除されていません。
    • 以下の 4 つの名前のチャネルは、前のリリースに設定された値と同等の値に設定されます。
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • マイグレーション・プロセスは、-scriptCompatibility 設定に基づいて前のリリースのポート用にトランスポートまたはチャネルを作成します。
    • マイグレーション・プロセスは、すべての非 Web コンテナー・ポートを、前のリリース用に設定した値に設定します。
    • マイグレーション・プロセスが、Web コンテナーで定義されたものと同じトランスポートまたはチャネルを作成した場合、ポートの競合が生じることがあります。

    これはデフォルトです。

  • True

    マイグレーション中に、すべての仮想ホスト・エイリアス・ポート設定を置き換えます。

    デフォルトでは、マイグレーション・プロセスは、前の環境の構成データを、新規の WebSphere Application Server バージョン 6.1 環境のデータに追加します。 ただし、場合によってこれは、ポート値に対して望ましい動作でないことがあります。 例えば、以前のリリースからの既存のポート定義は、 他の製品とのポート競合を回避するために慎重に設定されている可能性があります。そのような場合、これらの設定をバージョン 6.1 の構成にマイグレーションする可能性が高いです。 新規の値が追加される前に、このパラメーターに True を指定して、バージョン 6.1 の構成から、一致する仮想ホストのポートを除去します。
    • 前のリリースに設定された値と同等の値が設定されている以下の 4 つの名前のチャネル以外の、Web コンテナーに関連するすべてのトランスポート・チャネルは削除されます。
      • WC_adminhost
      • WC_defaulthost
      • WC_adminhost_secure
      • WC_defaulthost_secure
    • マイグレーション・プロセスは、-scriptCompatibility 設定に基づいて前のリリースのポート用にトランスポートまたはチャネルを作成します。
    • マイグレーション・プロセスは、すべての非 Web コンテナーのポートを、前のリリース用に設定した値に設定します。
-includeApps
これは、以下の方法で指定できるオプション・パラメーターです。
  • True

    マイグレーションの一環として、ユーザー・エンタープライズ・アプリケーションを組み込みます。

    これはデフォルトです。

  • False

    WASPostUpgrade の処理の間は、ユーザー・エンタープライズ・アプリケーションに対して何の処置も行いません。

  • Script

    WASPostUpgrade の処理の間には実際のインストールを行わずに、 WebSphere Application Server バージョン 6.1 installableApps ディレクトリーで ユーザー・エンタープライズ・アプリケーションのインストール準備を行います。

    これらのアプリケーションのインストールに使用できる JACL スクリプトは、 backupDirectory ディレクトリーで生成され保管されます。 WASPostUpgrade コマンドが完了したら、 これらのファイルを、任意の場所、任意の組み合わせで実行できます。 また、必要に応じて、アプリケーションのインストール効率を高めるために、これらの JACL ファイルを再編成および結合することもできます。

WebSphere Application Server システム・アプリケーションは、このパラメーターに設定された値に関わらず、マイグレーションします。

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

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

制約事項: このパラメーターを true に指定すると、 既存の WebSphere Application Server バージョン 5.x または 6.0.x インストール・システムと バージョン 6.1 インストール・システムでロケーションを共用することになります。 前のバージョンと同じロケーションにマイグレーション済みのアプリケーションを保持する場合、以下の制約事項が適用されます。
  • WebSphere Application Server バージョン 6.1 の混合ノード・サポート制限に従う必要があります。 つまり、wsadmin コマンドを呼び出す際に、以下のサポートを使用できません。
    • JSP のプリコンパイル
    • バイナリー構成の使用
    • EJB のデプロイ
  • バージョン 5.x または 6.0.x インストール・システムを管理 (例えばアンインストール) する際に、 後でこれらのロケーションからアプリケーションを削除する場合、 マイグレーション済みのアプリケーションを意図せず失う危険性があります。
-keepDmgrEnabled
これは、既存の WebSphere Application Server バージョン 5.x または 6.0.x デプロイメント・マネージャーを 使用不可にするかどうかを指定するために使用するオプション・パラメーターです。 デフォルトは false です。

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

注意: このパラメーターを使用する際には注意が必要です。
  • 複数のデプロイメント・マネージャーで同じノードを管理することを防ぐために、 WebSphere Application Server バージョン 5.x または 6.0.x デプロイメント・マネージャー構成は、 通常は停止され、無効にされます。 バージョン 6.1 デプロイメント・マネージャーの使用を開始する前に、バージョン 5.x または 6.0.x デプロイメント・マネージャーを停止する必要があります。 これを行わないと、デプロイメント・マネージャーの 2 番目のインスタンスが開始される際に ポート競合が生じるというエラーが起こる可能性があります。
  • このパラメーターを true に指定すると、マイグレーション中に以前の構成で 行われた構成変更がマイグレーションされない可能性があります。
-appInstallDirectory
これは、マイグレーション中にすべてのアプリケーションをインストールする際に 使用するディレクトリー名を渡すために使用するオプション・パラメーターです。 このパラメーターが指定されない場合、デフォルトの profile_name¥installedApps が使用されます。

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

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

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

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

このパラメーターを指定する場合は、-traceFile パラメーターも指定する必要があります。

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

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

-traceString パラメーターを指定するが、-traceFile パラメーターを指定しない場合、スクリプトはトレース・ファイルを生成しません。

ロギング

WASPostUpgrade ツールは、 実行中に画面に状況を表示します。 また、このツールは、さまざまなロギング情報のセットを、profile_root/logs ディレクトリーに ある WASPostUpgrade.time_stamp.log ファイルに保管します。 テキスト・エディターを使用して、WASPostUpgrade.time_stamp.log ファイルを 表示することができます。




関連タスク
製品構成のマイグレーション
マイグレーション・ツールを使用した製品構成のマイグレーション
関連資料
clientUpgrade コマンド
WASPreUpgrade コマンド
参照トピック    

ご利用条件 | フィードバック

最終更新: Jan 21, 2008 7:44:53 PM EST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r1/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/rmig_WASPostUpgrade.html