コマンド行ツールを使用したセルのマイグレーション
始める前に

この項目では、プロファイル構成マイグレーションについて説明します。アプリケーションを最新バージョンにマイグレーションするには、WebSphere® Application Server Migration Toolkit を使用します。詳しくは、WASdev の Migration Toolkit を参照してください。
sptcfg『Knowledge Collection: Migration planning for WebSphere Application Server』のマイグレーション計画情報を確認してください。
このシナリオでは、同一ホスト上のセルのマイグレーションを扱います。 別のホストにセルをマイグレーションする場合は、 『コマンド行ツールを使用した新しいホスト・マシンへのセルのマイグレーション』を参照してください。
このタスクについて
コマンド行ツールを使用して、WebSphere Application Server の前のバージョンからバージョン 9.0 にセルをマイグレーションできます。セル構成は、デプロイメント・マネージャーと、1 つ以上のノード、Web サーバー、およびアプリケーション・クライアントで構成されます。すべてのポートは、新しい構成にマイグレーションされます。この手順では、前の構成が稼働中であると想定しています。


- WebSphere Extended Deployment Compute Grid または Feature Pack for Modern Batch
- WebSphere Virtual Enterprise または Intelligent Management
手順
- デプロイメント・マネージャーおよびすべての古いノードをバックアップします。
マイグレーション時の障害に備えて、現行のデプロイメント・マネージャーおよびノードの構成を、後でリカバリー目的で使用できるように、backupConfig コマンドを使用してファイルに保存します。詳しくは、backupConfig コマンドを参照してください。
- deployment_manager_profile_root/bin ディレクトリーに変更します。
- 適切なパラメーターを指定して backupConfig コマンドを実行し、現行のプロファイル構成をファイルに保存します。 例:
/opt/WebSphereV70/profiles/v70dmgr01/bin/backupConfig.sh /mybackupdir/v70dmgr01backupBeforeV90migration.zip -username myuser -password mypass -nostop
- この構成に含まれるノードごとに、node_profile_root/bin ディレクトリーに移動します。
- 適切なパラメーターを指定して backupConfig コマンドを実行し現行のプロファイル構成をファイルに保存します。 例:
/opt/WebSphereV70/profiles/v70node01/bin/backupConfig.sh /mybackupdir/ v70node01backupBeforeV90migration.zip -username myuser -password mypass -nostop
- WebSphere Application Server
バージョン 9.0 を、各ターゲット・マシンの新規ディレクトリーにインストールします。
詳しくは、インストール資料を参照してください。
- 適切なパラメーターを指定して manageprofiles コマンドを実行することによって、ターゲット・デプロイメント・マネージャー・プロファイルを作成します。
ターゲットのデプロイメント・マネージャー・プロファイルは、マイグレーション・ターゲットになる新しいデプロイメント・マネージャー・プロファイルです。
例:トラブルの回避 (Avoid trouble): バージョン 9.0 プロファイルの nodeName と cellName は、以前のバージョン 7.0 以降の nodeName および cellName と一致している必要があります。バージョン 9.0 のデプロイメント・マネージャーの cellName または nodeName が異なると、 マイグレーションは失敗します。gotcha
/opt/WebSphereV90/bin/manageprofiles.sh -create -profileName v70toV90dmgr01 -templatePath /opt/WebSphereV90/profileTemplates/management -serverType DEPLOYMENT_MANAGER -nodeName currentDmgrNodeName -cellName currentCellName -hostName mydmgrhost.company.com
- 新しいデプロイメント・マネージャー・プロファイル bin ディレクトリーから WASPreUpgrade コマンドを実行することによって、現行のデプロイメント・マネージャー構成をマイグレーション・バックアップ・ディレクトリーに保存します。
WASPreUpgrade コマンドによって、バージョン 7.0 以降 構成は変更されません。詳しくは、WASPreUpgrade コマンドを参照してください。
注: バージョン 8.0 以降から バージョン 9.0 にマイグレーションし、プロファイルがデプロイメント・マネージャーである場合、WASPreUpgrade コマンドを実行すると、バージョン 8.0 プロファイルが停止されます。コマンド行で -keepDmgrEnabled true を指定するか、マイグレーション・ウィザードでそれに対応するオプションを指定した場合にのみ、WASPreUpgrade が完了する前にデプロイメント・マネージャーが開始されます。- WASPreUpgrade コマンドを実行します。 例:
/opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90dmgr01 /opt/WebSphereV70 -oldProfile 70dmgr01
- コンソール出力および WASPreUpgrade ログで警告またはエラーを確認します。
WASPreUpgrade コマンドが完了したら、コンソール出力で「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。 次に、WASPreUpgrade.old_Profile.timestamp.log および WASPreUpgrade.trace ログ・ファイルで、警告またはエラーがないかを確認します。
エラーがあった場合は、エラーを修正し、WASPreUpgrade コマンドを再度実行します。警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。
コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。
- WASPreUpgrade コマンドを実行します。 例:
- WASPostUpgrade コマンドを実行することによって、マイグレーション・バックアップ・ディレクトリーに保存した前のデプロイメント・マネージャー構成をリストアします。
以下の例で示すオプションを使用すると、すべてのポートがマイグレーションされ、古いデプロイメント・マネージャーがシャットダウンされて使用不可になるほか、すべてのアプリケーションがインストールされます。
詳しくは、WASPostUpgrade コマンドを参照してください。
- WASPostUpgrade コマンドを実行します。 例:
プロファイルを作成する場合、1 インストールにつきデフォルト・プロファイルと見なされるのは 1 つのプロファイルのみです。/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90dmgr01 -profileName v70toV90dmgr01 -oldProfile 70dmgr01 -resolvePortConflicts incrementCurrent -backupConfig TRUE -includeApps TRUE -keepDmgrEnabled FALSE -username myuser -password mypass
You can identify the default profiles by looking in the profileRegistry.xml file in the WAS_HOME/properties directory. ソースの profileRegistry.xml は、WASPreUpgrade コマンドの一環として、マイグレーション・バックアップ・ディレクトリーにコピーされています。
古いプロファイルをマイグレーション後も使用し続けたい場合、 -clone TRUE パラメーターを指定します。デプロイメント・マネージャーの複製マイグレーションを指定する場合は、 デプロイメント・マネージャーの統合ノードもすべて複製する必要があります。複製マイグレーションを指定すると、-keepDmgrEnabled は自動的に true に設定されます。
トラブルの回避 (Avoid trouble): WASPostUpgrade コマンドを実行する際には、常に -oldProfile および -profileName パラメーターを指定します。gotcha
- コンソール出力および WASPostUpgrade ログで警告またはエラーを確認します。 WASPostUpgrade コマンドが完了したら、コンソール出力で「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。
次に、migration_backup_dir/logs/WASPostUpgrade.target_profile_name.timestamp.log および migration_backup_dir/logs/WASPostUpgrade.target_profile_name.trace ログ・ファイルで、警告またはエラーがないかを確認します。エラーがあった場合は、エラーを修正し、WASPostUpgrade コマンドを再度実行します。警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。
構成は正しくマイグレーションされたが、インストールされなかったアプリケーションがある場合、WASMigrationAppInstaller コマンドを実行して、マイグレーションされなかったアプリケーションのみをインストールできます。詳しくは、WASMigrationAppInstaller コマンドを参照してください。
コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。
- WASPostUpgrade コマンドを実行します。 例:
- バージョン 9.0 デプロイメント・マネージャーに対して backupConfig コマンドを実行することによって、バージョン 9.0 のデプロイメント・マネージャー構成をファイルにバックアップします。
トラブルの回避 (Avoid trouble): これは、セル・マイグレーション計画において重要なステップです。いずれかのノード・マイグレーションが失敗した場合、失敗前のポイントにセル構成をリストアし、修正アクションを適用してから、ノード・マイグレーションを再試行できます。gotcha
- deployment_manager_profile_root/bin ディレクトリーに変更します。
- 適切なパラメーターを指定して backupConfig コマンドを実行します。 例:
/opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/ v70toV90dmgr01backupMigratedDmgrOnly.zip -username myuser -password mypass
- バージョン 9.0 デプロイメント・マネージャーを開始します。
前バージョンのデプロイメント・マネージャーが稼働中でないことを確認してください。
- 新しい バージョン 9.0 デプロイメント・マネージャー・プロファイルの bin ディレクトリーに移動します。
- startManager コマンドを実行します。
- デプロイメント・マネージャーの稼働中に、警告またはエラーがないか 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 を使用してのアプリケーションの トラブルシューティングに関する情報を参照してください。
- ノードのノード・エージェントおよびアプリケーション・サーバーのすべてのログを調べて新しい警告またはエラーがないか確認します。 自動同期が使用可能に設定されている場合、ノードの同期を可能にし、アプリケーションが再始動できるようにしてから、新しい警告またはエラーがないかログを確認します。
- Compute Grid または Feature Pack for Modern Batch 用に、ジョブ・スケジューラーが正しくマイグレーションされたこと、および、バッチ・アプリケーションをホストしている旧バージョンのサーバーにジョブをディスパッチできることを検証します。
ジョブ・スケジューラーのマイグレーションを検証するには、デプロイメント・マネージャー再始動後に、Web ブラウザーを介してジョブ管理コンソールにアクセスします。
バッチ・アプリケーションをホストしている旧バージョンのサーバーが正しく機能していることを検証するには、次のようにします。- マイグレーションされたサーバーまたはクラスター上のバッチ・アプリケーションが開始されることを検証します。サーバー・ログまたはクラスター・ログで、エラーがないかどうか調べてください。
- マイグレーションされたジョブ・スケジューラー・サーバーからジョブをサブミットすることによって、マイグレーションされたサーバーにバッチ・ジョブをディスパッチできることを検証します。ジョブのサブミットは、 ジョブ管理コンソール、WSGrid ユーティリティー、EJB インターフェース、または Web サービス・インターフェースを使用して行うことができます。
- Web サーバーのプラグインをマイグレーションします。
- バージョン 9.0 のデプロイメント・マネージャーが稼働中であることを確認します。
- セルで使用されている Web サーバー・プラグインのバージョンをアップグレードします。
- ご使用の Web サーバーのタイプとバージョンに適用可能なサポート情報を参照します。
- アプリケーション・クライアント・インストール済み環境をマイグレーションします。
クライアント・リソースを バージョン 9.0 レベルのリソースにマイグレーションします。
- WebSphere バージョン 9.0 Application Client をインストールします。
詳しくは、インストール資料を参照してください。
- バージョン 9.0
WASPreUpgrade コマンドを実行して、アプリケーション・クライアントのセキュリティー設定をマイグレーション・バックアップ・ディレクトリーに保存します。 例:
/opt/AppClientV90/bin/WASPreUpgrade.sh /mybackup/v70clientToV90 /opt/AppClientV70
- バージョン 9.0
WASPostUpgrade コマンドを実行して、アプリケーション・クライアントのセキュリティー設定を、新しいバージョン 9.0 のクライアントにリストアします。 例:
/opt/AppClientV90/bin/WASPostUpgrade.sh /mybackup/v70clientToV90
- WebSphere バージョン 9.0 Application Client をインストールします。
- ノードをマイグレーションします。
マイグレーション・ツールを使用して、構成に含まれるノードの前バージョンを バージョン 9.0 にマイグレーションします。バージョン 9.0 にマイグレーションする予定のノードごとに以下の手順を実行します。
トラブルの回避 (Avoid trouble): バージョン 9.0 へマイグレーションする各ノードに、同じソース・ノード名を使用する必要がありますが、一時セル名は異なるものを使用する必要があります。gotcha
- バージョン 9.0 のデプロイメント・マネージャーが稼働中であることを確認します。
- ターゲットのノード・プロファイルを作成します。適切なパラメーターを指定して manageprofiles コマンドを実行し、新しい管理対象プロファイルを作成します。 例:
/opt/WebSphereV90/manageprofiles.sh -create -profileName node1 -templatePath /opt/WebSphereV90/profileTemplates/managed -nodeName currentNode1Name -cellName currentCellName -hostName mynode1host.company.com
- WASPreUpgrade コマンドを実行して、現行のノード構成情報をマイグレーション・バックアップ・ディレクトリーに保存します。バックアップ・ファイルのための新しいディレクトリーを選択します。 例:
/opt/WebSphereV90/bin/WASPreUpgrade.sh /mybackup/v70toV90node1 /opt/WebSphereV70 -oldProfile 70node1
- コンソール出力および WASPreUpgrade ログで警告またはエラーを確認します。
WASPreUpgrade コンソール出力に「失敗してエラーが発生しました」または「警告を伴って完了しました」というようなメッセージがないか確認します。
以下のログに警告またはエラーがないか調べます。- migration_backup_dir/logs/WASPreUpgrade.old_profile.timestamp.log
- migration_backup_dir/logs/WASPreUpgrade.trace
WASPreUpgrade コマンドが正常に完了した場合、エラーまたは警告がないかログを確認する必要はありません。
- ノード・エージェントを停止します。 バージョン 9.0 へのマイグレーション中に実行しているバージョン 7.0 以降のノードがある場合、マイグレーションされるノード上のノード・エージェントを停止する必要があります。ノード・エージェント を停止しないと、破損の問題が発生する可能性があります。
- WASPostUpgrade コマンドを実行して、保存したノード構成を、新しい バージョン 9.0 管理対象プロファイルにリストアします。 例:
/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90node1 -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent -backupConfig TRUE -username myuser -password mypass
デプロイメント・マネージャーを複製した場合は、統合ノードもすべて複製する必要があります。 -clone TRUE パラメーターを指定し、新しいデプロイメント・マネージャーのホスト名と、 SOAP ポートまたは RMI ポートを指定してください。デプロイメント・マネージャーも複製されたのではない場合は、統合ノードを複製しないでください。/opt/WebSphereV90/bin/WASPostUpgrade.sh /mybackup/v70toV90node1 -profileName currentNode1Name -oldProfile 70node1 -resolvePortConflicts incrementCurrent -backupConfig TRUE -username myuser -password mypass -clone TRUE -newDmgrHostName myV90DmgrHost.mycompany.com -newDmgrSoapPort 8879
- コンソール出力および WASPostUpgrade ログで警告またはエラーを確認します。
WASPostUpgrade コンソール出力に「失敗してエラーが発生しました」または「警告を伴って完了しました」というようなメッセージがないか確認します。
以下のログにエラーまたは警告がないか調べます。- migration_backup_dir/logs/WASPostUpgrade.target_profile.timestamp.log
- migration_backup_dir/logs/WASPostUpgrade.target_profile.trace
注: WASPostUpgrade コマンドが失敗した場合、バージョン 9.0 デプロイメント・マネージャーを backupConfig ファイルからリストアする必要が生じる場合があります。WASPostUpgrade の処理によって syncNode コマンドが実行された場合、 デプロイメント・マネージャーはノードがマイグレーションされたことを認識しています。デプロイメント・マネージャーがノードのマイグレーション前の状態にリストアされない限り、ノードを再びマイグレーションすることはできません。構成は正しくマイグレーションされたが、インストールされなかったアプリケーションがある場合、WASMigrationAppInstaller コマンドを実行して、マイグレーションされなかったアプリケーションのみをインストールできます。詳しくは、WASMigrationAppInstaller コマンドを参照してください。
コマンドが正常に完了した場合、エラーまたは警告がないかログを確認する必要はありません。
- 警告またはエラーがないか バージョン 9.0 デプロイメント・マネージャーの 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 ノード・エージェントを始動します。
- 警告またはエラーがないか バージョン 9.0 デプロイメント・マネージャーおよびノードの SystemOut.log ファイルを確認します。
- セルを同期化します。
- マイグレーションされたバージョン 9.0 ノード上のすべてのアプリケーション・サーバーを停止します。
- マイグレーションされたバージョン 9.0 ノード上の該当のアプリケーション・サーバーを始動します。
- Compute Grid または Feature Pack for Modern Batch 用に、ジョブ・スケジューラーが正しくマイグレーションされたこと、および、バッチ・アプリケーションをホストしているマイグレーションされたサーバーにジョブをディスパッチできることを検証します。
ジョブ・スケジューラーのマイグレーションを検証するには、マイグレーションされたアプリケーション・サーバーまたはクラスターの再始動後に、Web ブラウザーを介してジョブ管理コンソールにアクセスします。
バッチ・アプリケーションをホストしているバージョン 9.0 サーバーが正しく機能していることを検証するには、次のようにします。- マイグレーションされたサーバーまたはクラスター上のバッチ・アプリケーションが開始されることを検証します。サーバー・ログまたはクラスター・ログで、エラーがないかどうか調べてください。
- マイグレーションされたジョブ・スケジューラー・サーバーからジョブをサブミットすることによって、マイグレーションされたサーバーにバッチ・ジョブをディスパッチできることを検証します。ジョブのサブミットは、 ジョブ管理コンソール、WSGrid ユーティリティー、EJB インターフェース、または Web サービス・インターフェースを使用して行うことができます。
- 適切なパラメーターを指定して backupConfig コマンドを実行して、バージョン 9.0 プロファイル構成をファイルに保存します。 例:
backupConfig コマンドを実行するたびに、新しいバックアップ・ファイル名を使用してください。/opt/WebSphereV90/profiles/v70toV90node1/bin/backupConfig.sh /mybackupdir/ v70toV90node1.zip -username myuser -password mypass -nostop
- 適切なパラメーターを指定して backupConfig コマンドを実行することで、デプロイメント・マネージャー構成をファイルに保存します。 コマンドを実行する前に、バージョン 9.0 デプロイメント・マネージャー・ホスト上の deployment_manager_profile_root/bin ディレクトリーに移動します。注: マイグレーション済みの各ノードで、バージョン 9.0 のデプロイメント・マネージャー構成を新しいバックアップ・ファイルにバックアップします。例:
/opt/WebSphereV90/profiles/v70toV90dmgr01/bin/backupConfig.sh /mybackupdir/ v70toV90dmgr01backupMigratedDmgrPlusNodeX.zip -username myuser -password mypass
注: ノードを別のホストにマイグレーションする場合は、『コマンド行ツールを使用した新しいホスト・マシンへのセルのマイグレーション』で、ノードのマイグレーションについての説明を参照してください。
タスクの結果
マイグレーション・ツールを使用して、前バージョンから WebSphere Application Server バージョン 9.0 へのマイグレーションを実行しました。


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=tmig_migrate_cells_commandline
ファイル名:tmig_migrate_cells_commandline.html