管理エージェント・プロファイルおよびその一連の登録済み管理対象ベース・アプリケーション・サーバーのマイグレーション

管理エージェント・プロファイルは、開発、単体テスト、またはそのような段階にある単一マシン上のサーバー・ファームなどの環境にある、複数のベース・アプリケーション・サーバーを管理します。管理対象ベース・アプリケーション・サーバーをバージョン 7.0 以降からバージョン 9.0 にマイグレーションする前に、管理エージェントをマイグレーションする必要があります。

始める前に

サポートされる構成 サポートされる構成:

この項目では、プロファイル構成マイグレーションについて説明します。アプリケーションを最新バージョンにマイグレーションするには、WebSphere® Application Server Migration Toolkit を使用します。詳しくは、WASdev の Migration Toolkit を参照してください。

sptcfg

マイグレーション計画情報を再度確認します。『ナレッジ・コレクション: WebSphere Application Server のマイグレーション計画』を参照してください。

ヒント: マイグレーション・コマンドに個々のパラメーターを指定するのではなく、-properties file_name.properties パラメーターを指定することでプロパティー・ファイルを入力できます。詳しくは、プロパティーによるマイグレーションの定義を参照してください。

このタスクについて

ベース・アプリケーション・サーバーは、1 つの管理エージェントに登録されたときに管理対象になります。管理エージェントは 1 つ以上のベース・アプリケーション・サーバーを管理する場合があり、管理対象のベース・アプリケーション・サーバーと同じリリース・レベルであると同時に、同じマシン上になければなりません。この制約のために、古いリリースおよび新しいリリースの両方の管理エージェントは、すべての管理対象ベース・アプリケーション・サーバーがマイグレーションされるまで同時実行されます。管理エージェントのマイグレーションでは古いポート値はマイグレーションされませんが、他のすべての構成データがマイグレーションされます。

新しいバージョン 9.0 管理エージェントの serverindex.xml ファイルに定義されているとおりに、WC_ adminhost または WC_ adminhost_ のセキュア・ポートを使用して、 バージョン 9.0 の管理エージェント・コンソールにアクセスします。また、この手順を実行している間は、バージョン 7.0 以降 の管理エージェントをシャットダウンしたり、使用不可に設定しないでください。

柔軟な管理環境にある管理対象ベース・アプリケーション・サーバーをマイグレーションする場合、ノード名がバージョン 9.0 と前のリリースで同じであることを確認してください。

トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): オープン・ファイルの最大数の設定を必ず 10000 以上にしてください。 オープン・ファイルの数が少なすぎると、マイグレーションでさまざまな障害が発生する可能性があります。gotcha

手順

  1. WebSphere Application Server バージョン 9.0 を、ターゲット・ホストの新規ディレクトリーにインストールします。

    詳しくは、インストール資料を参照してください。

  2. 管理エージェントのマイグレーションのターゲットになる、バージョン 9.0 管理エージェント・プロファイルを作成します。

    適切なパラメーターを指定して manageprofiles コマンドを実行し、新しい管理エージェント・プロファイルを作成します。

    以下に例を示します。
    C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AdminAgent01 -profilePath 
    C:\WebSphere\AppServer90\profiles\AdminAgent01 -templatePath C:\WebSphere\AppServer90\profileTemplates\management 
    -serverType ADMIN_AGENT -nodeName AdminAgentNode01 -cellName AdminAgentCell01 -hostName <myhostname>
  3. すべての進行中のジョブが管理対象プロファイル上で完了したことを確認します。
  4. ジョブ・マネージャーからジョブを取得しているプロファイルでのジョブ・マネージャーのポーリングを停止します。

    ジョブのポーリングを開始する前に、管理対象プロファイルに対する WASPreUpgrade および WASPostUpgrade を完了してください。詳しくは、『wsadmin スクリプトを使用する AdminTask オブジェクトの ManagedNodeAgent コマンド・グループ』を参照してください。

  5. 新しい WebSphere Application Server インストール・ルート bin ディレクトリーから WASPreUpgrade コマンドを実行することによって、現行の管理エージェント構成をマイグレーション・バックアップ・ディレクトリーに保存します。

    WASPreUpgrade コマンドによって、古い構成に変更は加えられません。

    1. WASPreUpgrade コマンドを実行します。

      コマンド・パラメーターについて詳しくは、WASPreUpgrade コマンドを参照してください。

      例:
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70AdminAgentbackup C:\WebSphere\AppServer70 -oldProfile AdminAgent01 
      -traceString *=all=enabled -tracefile C:¥WAS70AdminAgentbackup¥logs¥WASPreMigrationSummary.log
    2. コンソール出力および WASPreUpgrade ログで警告またはエラーを確認します。 WASPreUpgrade コマンドが完了したら、コンソール出力で「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。 次に、以下のログ・ファイルで警告またはエラーがないかを確認します。
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

      エラーがあった場合は、エラーを修正し、WASPreUpgrade コマンドを再度実行します。警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。

      コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。

  6. 新しい WebSphere Application Server インストール・ルート bin ディレクトリーから WASPostUpgrade コマンドを実行することによって、前の管理エージェント構成をリストアします。
    1. WASPostUpgrade コマンドを実行して、保存した管理エージェント構成を、新しい バージョン 9.0 の管理エージェント・プロファイルにリストアします。 例:
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70AdminAgentbackup -oldProfile AdminAgent01 -profileName AdminAgent01 
      -traceString *=all=enabled -tracefile C:¥WAS70AdminAgentbackup¥logs¥WASPostMigrationSummary.log -username myuser -password mypass
    2. コンソール出力および WASPostUpgrade ログで警告またはエラーを確認します。 WASPostUpgrade コマンドが完了したら、コンソール出力で「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。 次に、以下のログ・ファイルで警告またはエラーがないかを確認します。
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

      エラーがあった場合は、エラーを修正し、WASPostUpgrade コマンドを再度実行します。警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。

      コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。

  7. バージョン 9.0 管理エージェントを開始し、 バージョン 7.0 以降およびバージョン 9.0 の両方の管理エージェントが実行していることを確認します。
    1. 新しい バージョン 9.0 管理エージェント・プロファイルの bin ディレクトリーに移動します。
    2. startServer adminagent コマンドを実行します。
    3. 警告またはエラーがないか SystemOut.log ファイルを確認します。
      注: このトピックでは、 1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。推奨される代替案として、分散システムや IBM® i システムの SystemOut.logSystemErr.logtrace.logactivity.log ファイルではなく、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成できます。また HPEL は、ネイティブ z/OS® ロギング機能と連携させて使用することができます。HPEL を使用する場合、LogViewer コマンド・ライン・ツールを サーバー・プロファイルの bin ディレクトリーから使用して、すべてのログ・ファイルにアクセスし、 情報をトレースできます。HPEL の使用について詳しくは、HPEL を使用してのアプリケーションの トラブルシューティングに関する情報を参照してください。
  8. 管理対象ベース・アプリケーション・サーバーをマイグレーションします。
    トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): マイグレーションを成功させるには、以下を実行してください。
    • 管理対象ベース・アプリケーション・サーバーは、関連付けられる管理エージェントと同じマシン上になければなりません。
    • ノード名は、バージョン 9.0 と前のリリースで同一である必要があります。
    • [Windows]Windows プラットフォームがあり、SIB コンポーネントをマイグレーションしようとしている場合は、マイグレーションの実行前に AppSrv サーバーを停止してください。
    gotcha

    バージョン 9.0 にマイグレーションしようと予定している管理対象ベース・アプリケーション・サーバーそれぞれに対して、以下のステップを実行します。

    1. ターゲットのベース・アプリケーション・サーバー・プロファイルを作成します。適切なパラメーターを指定して manageprofiles コマンドを実行し、新しい管理対象プロファイルを作成します。 以下に例を示します。
      C:\WebSphere\AppServer90\bin>manageprofiles.bat -create -profileName AppSrv01 
      -profilePath C:¥WebSphere¥AppServer90¥profiles¥AppSrv01
      -templatePath C:¥WebSphere¥AppServer90¥profileTemplates¥default
      -serverType APPLICATION_SERVER -nodeName AppSrv01Node01 
      -cellName AppSrv01Cell01 -hostName <myhostname>
    2. WASPreUpgrade コマンドを実行して、現行の管理対象ベース・アプリケーション・サーバー情報を、マイグレーション・バックアップ・ディレクトリーに保存します。バックアップ・ファイルのための新しいディレクトリーを選択します。 以下に例を示します。
      C:\WebSphere\AppServer90\bin>WASPreUpgrade.bat C:\WAS70Appserver01backup 
      C:¥WebSphere¥AppServer70 -oldProfile Appserver01 -traceString *=all=enabled
      -summaryLogName C:¥WAS70Appserver01backup¥logs¥WASPreMigrationSummary.log
    3. コンソール出力および WASPreUpgrade ログで警告またはエラーを確認します。 WASPreUpgrade コマンドが完了したら、コンソール出力で「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。 次に、以下のログ・ファイルで警告またはエラーがないかを確認します。
      • migration_backup_dir/logs/WASPreMigrationSummary.log
      • WASPreUpgrade.timestamp.log
      • WASPreUpgrade.trace

      エラーがあった場合は、エラーを修正し、WASPreUpgrade コマンドを再度実行します。警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。

      コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。

    4. WASPostUpgrade コマンドを実行して、保存した管理対象アプリケーション・サーバー・プロファイル構成を、新しいバージョン 9.0 のベース・アプリケーション・サーバー・プロファイルにリストアします。
      トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): このコマンドには、その他のパラメーターが必要です。次の例では、いずれの管理エージェントでもセキュリティーが有効に設定されていると想定しています。gotcha
      以下に例を示します。
      C:\IBM\WebSphere\AppServer90\bin>WASPostUpgrade.bat C:\WAS70Appserver01backup 
      -oldProfile AppSrv01 -profileName AppSrv01 -traceString *=all=enabled 
      -summaryLogName C:¥WAS70Appserver01backup¥logs¥WASPostMigrationSummary.log 
      -oldAdminAgentProfilePath C:¥WebSphere¥Appserver70¥profiles¥AdminAgent01
      -oldAdminAgentHostname myhostname -oldAdminAgentSoapPort 8879 -oldAdminAgentUsername 
      myusername -oldAdminAgentPassword mypassword -newAdminAgentProfilePath 
      C:\WebSphere\AppServer90\profiles\AdminAgent01 -newAdminAgentHostname 
      myhostname -newAdminAgentSoapPort 8887 -newAdminAgentUsername 
      myusername1 -newAdminAgentPassword mypassword1
    5. コンソール出力および WASPostUpgrade ログで警告またはエラーを確認します。 WASPostUpgrade コマンドが完了したら、コンソール出力で「失敗してエラーが発生しました」または「警告を伴って完了しました」というメッセージがないかを確認します。 次に、以下のログ・ファイルで警告またはエラーがないかを確認します。
      • migration_backup_dir/logs/WASPostMigrationSummary.log
      • WASPostUpgrade.target_profile_name.timestamp.log
      • WASPostUpgrade.target_profile_name.trace

      エラーがあった場合は、エラーを修正し、WASPostUpgrade コマンドを再度実行します。警告が バージョン 9.0 での他のマイグレーションやランタイムのアクティビティーに影響するかどうかを確認します。

      コマンドが正常に完了した場合は、エラーや警告がないかログを確認する必要はありません。

    6. マイグレーション済みの バージョン 9.0 管理対象アプリケーション・サーバーを始動します。
    7. 警告またはエラーがないか バージョン 9.0 管理対象アプリケーション・サーバーの SystemOut.log ファイルを確認します。
      注: このトピックでは、 1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。推奨される代替案として、分散システムや IBM i システムの SystemOut.logSystemErr.logtrace.logactivity.log ファイルではなく、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成できます。また HPEL は、ネイティブ z/OS ロギング機能と連携させて使用することができます。HPEL を使用する場合、LogViewer コマンド・ライン・ツールを サーバー・プロファイルの bin ディレクトリーから使用して、すべてのログ・ファイルにアクセスし、 情報をトレースできます。HPEL の使用について詳しくは、HPEL を使用してのアプリケーションの トラブルシューティングに関する情報を参照してください。

タスクの結果

マイグレーション・ツールを使用して、管理エージェント・プロファイルおよびその関連付けられた管理対象ベース・アプリケーション・サーバーをWebSphere Application Server バージョン 7.0 以降からバージョン 9.0 にマイグレーションできました。バージョン 7.0 以降の管理エージェントを停止することができ、 バージョン 7.0 以降のポートをバージョン 9.0 管理エージェントに割り当てることができます。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=tmig_migrate_admin_agent
ファイル名:tmig_migrate_admin_agent.html