ジョブ・マネージャー・プロファイルおよび一連の登録済みサーバーをバージョン 7.0 以降からバージョン 9.0 にマイグレーションできます。
このタスクについて
ジョブ・マネージャー・プロファイルには、以下の登録済みのサーバー・タイプの 1 つ以上を含めることができます。
- デプロイメント・マネージャー・サーバー
- 管理対象ベース・アプリケーション・サーバー (管理エージェントにも登録済み)
トラブルの回避 (Avoid trouble): - 管理対象ベース・アプリケーション・サーバーおよびデプロイメント・マネージャー・サーバーは、前バージョンのジョブ・マネージャーからジョブを受け入れることはできません。
問題を回避するには、ご使用のジョブ・マネージャー・プロファイルをバージョン 9.0 にマイグレーションしてから、管理対象ベース・アプリケーション・サーバーおよびデプロイメント・マネージャー・サーバーをバージョン 9.0 にマイグレーションします。
- 柔軟な管理環境にある管理対象ベース・アプリケーション・サーバーまたは管理対象デプロイメント・マネージャーをマイグレーションする場合、ノード名はバージョン 9.0 と前のリリースで同じである必要があります。
- オープン・ファイルの最大数の設定を必ず 10000 以上にしてください。
オープン・ファイルの数が少なすぎると、マイグレーションでさまざまな障害が発生する可能性があります。
gotcha
手順
- WebSphere Application Server Network Deployment
バージョン 9.0 を、ターゲット・ホストの新規ディレクトリーにインストールします。
詳しくは、インストール資料を参照してください。
- ジョブ・マネージャーのマイグレーションのターゲットになる バージョン 9.0 のジョブ・マネージャー・プロファイルを作成します。
適切なパラメーターを指定して manageprofiles コマンドを実行し、新しいジョブ・マネージャー・プロファイルを作成します。
以下に例を示します。C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName JobMgr01
-profilePath C:\WebSphere\AppServer90\profiles\JobMgr01 -templatePath C:\WebSphere\AppServer90\profileTemplates\management
-serverType JOB_MANAGER -nodeName JobMgr01Node01 -cellName JobMgr01Cell01 -hostName localhost
- 古いジョブ・マネージャーを停止します。 古いジョブ・マネージャーのデータベース内に存在するすべてのジョブは、マイグレーションの一部としてマイグレーションされます。
- 新しい WebSphere Application Server インストール・ルート bin ディレクトリーから WASPreUpgrade コマンドを実行することによって、
現行のジョブ・マネージャー構成をマイグレーション・バックアップ・ディレクトリーに保存します。
WASPreUpgrade コマンドによって、古い構成に変更は加えられません。
- WASPreUpgrade コマンドを実行します。 例:
C:¥WebSphere¥AppServer90¥bin>WASPreUpgrade.bat C:¥WAS70JobMgrbackup C:¥WebSphere¥AppServer70 -oldProfile JobMgr01
-traceString *=all=enabled -tracefile C:¥WAS70JobMgrbackup¥logs¥WASPreMigrationSummary.log
- コンソール出力および WASPreUpgrade ログで警告またはエラーを確認します。 WASPreUpgrade コマンドが完了したら、コンソール出力で「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。
次に、以下のログ・ファイルに警告またはエラーがないかを確認します。
- migration_backup_dir/logs/WASPreMigrationSummary.log
- WASPreUpgrade.timestamp.log
- WASPreUpgrade.trace
エラーがあった場合、エラーを修正して、WASPreUpgrade コマンドを再度実行します。
警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。
コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。
- 前のジョブ・マネージャー構成をリストアします。 新しい WebSphere Application Server インストール・ルートの bin ディレクトリーから WASPostUpgrade コマンドを実行して、マイグレーション・バックアップ・ディレクトリーに保存した前のジョブ・マネージャー構成をリストアします。
トラブルの回避 (Avoid trouble): データベースの不整合を回避するために、
WASPreUpgrade の完了直後に
WASPostUpgrade を実行します。
WASPreUpgrade の一部として、データベースのバックアップが作成されます。
WASPostUpgrade の実行前に古いジョブ・マネージャーを再始動すると、バックアップのデータベースと古いジョブ・マネージャーのデータベースの同期がずれます。
gotcha
- WASPostUpgrade コマンドを実行して、保存したジョブ・マネージャー構成を、新しいバージョン 9.0 の管理エージェント・プロファイルにリストアします。 例:
C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70JobMgrbackup -oldProfile JobMgr01 -profileName JobMgr01
-traceString *=all=enabled -tracefile C:¥WAS70JobMgrbackup¥logs¥WASPostMigrationSummary.log -username myuser -password mypass
- コンソール出力および WASPostUpgrade ログで警告またはエラーを確認します。 WASPostUpgrade コマンドの完了後、コンソール出力に「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。
次に、以下のログ・ファイルに警告またはエラーがないかを確認します。
- migration_backup_dir/logs/WASPostMigrationSummary.log
- WASPostUpgrade.target_profile_name.timestamp.log
- WASPostUpgrade.target_profile_name.trace
エラーがあった場合、エラーを修正して、WASPostUpgrade コマンドを再度実行します。警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。
コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。
- バージョン 9.0 ジョブ・マネージャーを開始し、バージョン 7.0 以降およびバージョン 9.0 の両方のジョブ・マネージャーが実行していることを確認します。
- 新しい バージョン 9.0 のジョブ・マネージャー・プロファイルの bin ディレクトリーに移動します。
- startServer jobmgr コマンドを実行します。
- 警告またはエラーがないか SystemOut.log ファイルを確認します。
注: このトピックでは、
1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。推奨される代替案として、分散システムや IBM® i システムの SystemOut.log、SystemErr.log、trace.log、activity.log ファイルではなく、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成できます。また HPEL は、ネイティブ z/OS® ロギング機能と連携させて使用することができます。HPEL を使用する場合、LogViewer コマンド・ライン・ツールを
サーバー・プロファイルの bin ディレクトリーから使用して、すべてのログ・ファイルにアクセスし、
情報をトレースできます。HPEL の使用について詳しくは、HPEL を使用してのアプリケーションの
トラブルシューティングに関する情報を参照してください。
- 登録済みサーバーをマイグレーションします。
バージョン 9.0 のジョブ・マネージャーは、
バージョン 7.0 以降の登録済みサーバーを管理できます。バージョン 7.0 以降のトポロジーが新しいバージョン 9.0 のジョブ・マネージャーで機能するように、登録済みサーバーをマイグレーションする必要はありません。
バージョン 9.0 にマイグレーションしようと予定している登録済みサーバーそれぞれに対して、以下のステップを実行します。
タスクの結果
マイグレーション・ツールを使用して、ジョブ・マネージャー・プロファイルおよびその関連付けられた管理対象ベース・アプリケーション・サーバーを WebSphere Application Server バージョン 7.0 以降からバージョン 9.0 にマイグレーションできました。