管理エージェント・プロファイルは、開発、単体テスト、またはそのような段階にある単一マシン上のサーバー・ファームなどの環境にある、複数のベース・アプリケーション・サーバーを管理します。管理対象ベース・アプリケーション・サーバーをバージョン 7.0 以降からバージョン 9.0 にマイグレーションする前に、管理エージェントをマイグレーションする必要があります。
このタスクについて
このタスクでは、管理エージェントおよびその一連の関連付けられた管理対象ベース・アプリケーション・サーバーを、WebSphere Application Server バージョン 7.0 以降から
バージョン 9.0 にマイグレーションするための z/OS 構成マイグレーション管理ツールの使用方法を説明します。ベース・アプリケーション・サーバーは、1 つの管理エージェントに登録されたときに管理対象になります。管理エージェントは 1 つ以上のベース・アプリケーション・サーバーを管理する場合があり、管理対象のベース・アプリケーション・サーバーと同じリリース・レベルであると同時に、同じマシン上になければなりません。z/OS 上では、
どの時点においてもバージョン 7.0 以降またはバージョン 9.0 の管理エージェントのみが実行されるよう制限されています。以下の説明は、古い管理エージェントおよび新規管理エージェントの開始と停止のタイミングを述べています。
以下の制約事項では、すべての管理対象ベース・アプリケーション・サーバーを同時にマイグレーションすることが要求されます。
トラブルの回避 (Avoid trouble): 柔軟な管理環境にある管理対象ベース・アプリケーション・サーバーをマイグレーションする場合、ノード名が
バージョン 9.0 と前のリリースで同じであることを確認してください。
gotcha
手順
- backupConfig コマンドを実行することによって、ソース管理エージェントおよびノード構成をバックアップします。
backupConfig コマンドは、管理エージェントおよびノード構成を、後でリカバリー用に使用できるファイルに保存します。
- administrative_agent_profile_root/bin ディレクトリーに変更します。
- 管理エージェントおよびすべての管理対象ベース・アプリケーション・サーバーで適切なパラメーターを指定して backupConfig コマンドを実行します。 以下に例を示します。
/opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh
/mybackupdir/v70dmgr01backupBeforeV90migration.zip
-username myuser -password mypass -nostop
- この構成に含まれるノードごとに、profile_root/bin ディレクトリーに移動します。
- 適切なパラメーターを指定して backupConfig コマンドを実行し現行のプロファイル構成をファイルに保存します。 以下に例を示します。
/opt/WebSphereV70/profiles/v70mas01/bin/backupConfig.sh
/mybackupdir/v70mas01rbackupBeforeV90migration.zip
-username myuser -password mypass -nostop
あるいは、PAX コマンドを使用して、すべての HFS ファイルをバックアップできます。詳しくは、z/OS UNIX pax コマンドの使用 (Using the z/OS UNIX pax command) を参照してください。
- WebSphere Application Server for z/OS®
バージョン 9.0 を各ターゲット・ホストにインストールします。
詳しくは、インストール資料を参照してください。
- z/OS マイグレーション管理ツールで新しい管理エージェントのマイグレーション構成を指定します。
z/OS マイグレーション管理ツールを使用して、マイグレーション定義を作成し、管理エージェントをマイグレーションするジョブをアップロードします。
トラブルの回避 (Avoid trouble): バージョン 9.0 のセル名は、
バージョン 7.0 以降の構成内のセル名と一致する必要があります。新規セル名でプロファイルを作成すると、
マイグレーションは失敗します。
gotcha
- 以下のワークシートを埋めます。 z/OS マイグレーション管理ツール内のデプロイメント・マネージャー・マイグレーション構成の指定: ワークシート
- 「マイグレーション・ノード・タイプの選択」パネルで、「管理エージェントのマイグレーション」を選択します。
- ワークシートの値を使用して、後続のパネル上のフィールドを埋めます。
- 管理エージェントのマイグレーション定義を検討して、すべての値が正しいことを確認します。
- WebSphere Application Server for z/OS マイグレーション定義テーブルで、検討するマイグレーション定義を選択します。
- 「表示」をクリックします。
- マイグレーション定義の詳細については、「要約」、「指示」、または「応答ファイル (Response file)」タブを
クリックします。
- マイグレーション・ジョブをターゲット z/OS システムにアップロードします。
- すべての進行中のジョブが管理対象プロファイル上で完了したことを確認します。
管理対象アプリケーション・サーバーまたはデプロイメント・マネージャーに対して WASPreUpgrade コマンドを実行する前に、進行中のすべてのジョブは完了していなければなりません。
- 管理エージェントがジョブ・マネージャーに登録されている場合、ジョブ・マネージャーのポーリングを停止します。
ジョブ・マネージャーの停止方法について詳しくは、『wsadmin スクリプトを使用する AdminTask オブジェクトの ManagedNodeAgent コマンド・グループ』を参照してください。
- z/OS マイグレーション管理ツールの「マイグレーションの指示」ビューにある指示に従うか、または、ターゲット z/OS システムにアップロードした CNTL データ・セットの BBOMAINS メンバーにある指示に従って、管理エージェントのマイグレーション・ジョブを実行します。
CRPROF (profile create)、PREUPGRD (preUpgrade) および UPGRADE の各ステップはこのプロセス中にすべて実行されます。
- (ZMMT 内で指定された) HFS/ZFS の作業ディレクトリー内に作成されたすべての出力およびバッチ・ジョブで作成されたすべての MVS ジョブ出力を検査します。
戻りコードの 0 を受け取ることを確認し、構成ファイル・システム上のマイグレーションの一時ディレクトリーにあるログ・ファイルを調べてください。
マイグレーション一時ディレクトリーは temporary_directory_location/nnnnn であり、
ここで、temporary_directory_location は一時ディレクトリー・ロケーションに指定したディレクトリー、
nnnnn はマイグレーション・ジョブの生成時にマイグレーション ID 用に
生成した数値です。デフォルトの一時ディレクトリー・ロケーションは /tmp/migrate です。
- z/OS マイグレーション管理ツールで管理対象アプリケーション・マイグレーション構成を指定します。
z/OS マイグレーション管理ツールを使用して、マイグレーション定義を作成し、管理対象ベース・アプリケーション・サーバーをマイグレーションするジョブをアップロードします。
トラブルの回避 (Avoid trouble): バージョン 9.0 のセル名は、
バージョン 7.0 以降の構成内のセル名と一致する必要があります。新規セル名でプロファイルを作成すると、
マイグレーションは失敗します。
gotcha
- 以下のワークシートを埋めます。 z/OS マイグレーション管理ツール内の統合ノード・マイグレーション構成の指定: ワークシート
- 「マイグレーション・ノード・タイプの選択」パネルで、「管理対象ベース・アプリケーション・サーバーのマイグレーション」を選択します。
- ワークシートの値を使用して、後続のパネル上のフィールドを埋めます。
- 統合ノードのマイグレーション定義を検討して、
すべての値が正しいことを確認します。
- WebSphere Application Server for z/OS マイグレーション定義テーブルで、検討するマイグレーション定義を選択します。
- 「表示」をクリックします。
- マイグレーション定義の詳細については、「要約」、「指示」、または「応答ファイル (Response file)」タブを
クリックします。
- マイグレーション・ジョブをターゲット z/OS システムにアップロードします。
- z/OS マイグレーション管理ツールの「マイグレーションの指示」ビューにある指示に従うか、または、ターゲット z/OS システムにアップロードした CNTL データ・セットの BBOMDINS メンバーにある指示に従って、管理対象ベース・アプリケーション・サーバーのマイグレーション・ジョブを実行します。
CRPROF (profile create)、PREUPGRD (preUpgrade) および UPGRADE の各ステップはこのプロセス中にすべて実行されます。
トラブルの回避 (Avoid trouble): - ソース管理エージェントが実行していて、アプリケーション・サーバーを管理エージェントから登録抹消できることを確認します。
- 管理対象アプリケーション・サーバーがジョブ・マネージャーにも登録されている場合、管理対象アプリケーション・サーバーのマイグレーションを実行する前にジョブ・マネージャーからの登録を抹消する必要があります。マイグレーションが完了したら、管理エージェントとジョブ・マネージャーに再度登録してください。
gotcha
- (ZMMT 内で指定された) HFS の作業ディレクトリー内に作成されたすべての出力およびバッチ・ジョブで作成されたすべての MVS ジョブ出力を検査します。
戻りコードの 0 を受け取ることを確認し、構成ファイル・システム上のマイグレーションの一時ディレクトリーにあるログ・ファイルを調べてください。
マイグレーション一時ディレクトリーは temporary_directory_location/nnnnn であり、
ここで、temporary_directory_location は一時ディレクトリー・ロケーションに指定したディレクトリー、
nnnnn はマイグレーション・ジョブの生成時にマイグレーション ID 用に
生成した数値です。デフォルトの一時ディレクトリー・ロケーションは /tmp/migrate です。
- 新しい バージョン 9.0 のマイグレーションされた管理エージェントに移動します。
トラブルの回避 (Avoid trouble): 古い管理エージェントに登録されていたすべての管理対象アプリケーション・サーバーがマイグレーションされるようにしてください。これらはすべて、このマイグレーション・プロセスの間に登録解除されているはずです。
gotcha
- 古い バージョン 7.0 以降 管理エージェントを停止します。
- 新規バージョン 9.0 の管理エージェントを開始します。
- 管理対象アプリケーション・サーバーを始動します。
- 各管理対象ベース・アプリケーション・サーバーを始動します。
- 各管理対象アプリケーション・サーバーを新しい管理エージェントに登録します。
ノード・エージェント・ログでエラーがないかを確認します。
- ジョブ・マネージャーのポーリングを開始します。
詳しくは、『wsadmin スクリプトを使用する AdminTask オブジェクトの ManagedNodeAgent コマンド・グループ』を参照してください。
タスクの結果
マイグレーション・ツールを使用して、管理エージェント・プロファイルおよびその関連付けられた管理対象ベース・アプリケーション・サーバーを WebSphere Application Server バージョン 7.0 以降からバージョン 9.0 にマイグレーションできました。