1. Advanced Management Consoleインストレーションおよび構成ガイド
  2. Advanced Management Consoleの移行

10 Advanced Management Console の移行

使用可能な最新バージョンへのAdvanced Management Consoleの移行には、WebLogic Server管理者コンソール内の以前のAdvanced Management Consoleバージョンへの最新のEnterprise Archive (EAR)ファイルの再デプロイが含まれます。Advanced Management Console サーバーでデータベースが手動または自動で更新される更新ウィザードにより、移行プロセスが容易になります。次に、再デプロイされたAdvanced Management Consoleサーバーと一致するようにAdvanced Management Consoleエージェントを最新バージョンに更新します。

ノート:

  • 上位バージョンのAdvanced Management Consoleの下位バージョンへの移行はサポートされていません。
  • ベスト・プラクティスとして、アップグレード・プロセスを続行する前に、必ず既存のデータベースのバックアップまたはスナップショットを取得するようにしてください。バックアップしないと、どの時点であっても、エラーが発生した場合に、戻ることやその後にアップグレードを試みることはできません。
  • Advanced Management Consoleエージェントを2.22より前のバージョンからアップグレードし、エージェント自動更新が有効になっている場合は、キーストア証明書を検証する必要があります。Advanced Management Consoleエージェントの自動更新を参照してください。

移行プロセス中、Advanced Management Console サーバーはエージェントからのリクエストの処理、Java使用状況トラッカ・レコードの処理およびセキュリティ・ベースライン・レコードの更新を停止します。

このトピックには、最新バージョンへのAdvanced Management Consoleサーバーのアップグレード、Advanced Management Consoleデータベースの更新およびAdvanced Management Consoleエージェントの更新について説明する次の各項があります:

ノート:

Advanced Management Console を新しいバージョンに更新した後は、必ずブラウザのキャッシュとCookieを消去するようにしてください。

新しいバージョンのAdvanced Management Console Serverのアップロード

Advanced Management Consoleの移行プロセスは、WebLogic Server管理コンソール内の以前のAdvanced Management Consoleバージョンに最新のEnterprise Archive (EAR)ファイルを再デプロイすることから始まります。移行タスクを実行するには、WebLogic Server管理者権限が必要です。

以前のバージョン全体にわたってAdvanced Management Console をアップロードするには、次のようにします。

  1. https://wls-hostname:/port/consoleとWebブラウザに入力します。ここで、wls-hostnameおよびportは管理サーバーのDNS名およびSSLリスニング・ポート番号です。
  2. 管理者の資格証明を使用して認証します。
  3. 「ドメイン構造」パネルで「デプロイメント」オプションを選択します。
  4. 右パネルで、 Advanced Management Console アプリケーションのチェック・ボックスを選択します。
  5. 「更新」をクリックします。
  6. ナビゲーション・パネルで最新バージョンのAdvanced Management Console ファイル用のEARファイルを検索してチェックインします。たとえば、2.20バージョン用のEARファイルはJavaAMC-2_20.earです。
  7. 「次」をクリックします。デフォルト値を使用します。
  8. 「終了」をクリックします。
  9. Advanced Management Console がデプロイされた後にWebLogic Serverを再起動します。

Advanced Management Console データベースの更新

新しいバージョンのAdvanced Management Console EARファイル(JavaAMC-2_20.earなど)をWebLogic Serverにアップロードした後、Advanced Management Console管理者がAdvanced Management Consoleデータベースを更新する必要があります。

ノート:

以前とその後のAMCのバージョン間にデータベースに対する変更がない場合は、データベースを更新する必要はありません。

データベースを更新するには、/amcwebuiをロードして、Advanced Management Console のデータベース更新画面(更新ウィザード)が表示されるかどうかを確認します。画面が表示されない場合は、変更の必要がなく、Advanced Management Console は完全に機能します。画面が表示される場合は、データベース更新を実行するためのガイドが表示されます。

管理者の資格証明を使用して手動または自動でデータベースを更新できます。現在のAMCのバージョンから最新バージョンにデータベースを更新する必要がない場合は、更新ウィザードは表示されず、タスクを明示的に実行する必要はありません。次のトピックに従って、Advanced Management Console を更新します。

データベースの自動更新

Advanced Management Console データベースの自動更新を行うには、次のようにします。

  1. https://wls-hostname:port/consoleとWebブラウザに入力します。ここで、wls-hostnameおよびportは、WebLogic Server管理コンソールを起動するWebLogic Serverサーバーインスタンス(デフォルト・ポートは7002)のDNS名およびSSLリスニング・ポートです。データベースの更新を示す「ようこそ」画面が表示されます。
  2. ようこそ画面で「次」をクリックし、図10-1に示すように自動または手動のデータベースの更新を選択します。

    図10-1 Advanced Management Consoleデータベースの更新 — ようこそ画面

    図10-1の説明が続きます
    図10-1「Advanced Management Consoleデータベースの更新 — ようこそ画面」の説明
  3. AMCサーバーの「自動更新」をクリックすると、データベースが更新されます。
  4. 「更新」をクリックしてプロセスを完了します。または「取消」をクリックしてデータベースの自動更新を取り消します。

更新が完了すると、AMCデータベースが正常に更新されたことを示す画面が表示されます。

データベースの手動更新

Advanced Management Console データベースの手動更新を行うには、次のようにします。

  1. https://wls-hostname:port/consoleとブラウザに入力します。ここで、wls-hostnameおよびportは、WebLogic Server管理コンソールを起動するWebLogic Serverサーバー・インスタンス(デフォルト・ポートは7002)のDNS名およびSSLリスニング・ポートです。データベースの更新を示す「ようこそ」画面が表示されます。
  2. ようこそ画面で「次」をクリックし、自動または手動のデータベースの更新を選択します。
  3. SQLスクリプトを使用してデータベースを更新するには、「手動更新」をクリックします。
  4. SQLスクリプト・リンクをクリックしてSQLスクリプトをダウンロードします。

    SQLスクリプトはamc_mysql_update.sqlとして保存されます。AMCデータベースに接続して適用します。

  5. SQLスクリプトをデータベースに適用したら、「続行」をクリックします。または「取消」をクリックしてデータベースの手動更新を取り消します。

更新が完了すると、AMCデータベースが正常に更新されたことを示すメッセージが表示されます。

セキュリティ質問の設定

データベースを正常に設定した後、Advanced Management Consoleにアクセスします。セキュリティ質問を設定するように求められます。ドロップダウンから3つの質問を選択し、回答を入力します。ログイン・ページにリダイレクトされます。

Advanced Management Console エージェントの更新

データベースを更新した後、再デプロイされたAdvanced Management Consoleサーバーと一致するようにAdvanced Management Consoleエージェントを最新リリースに更新します。

Advanced Management Consoleエージェントを手動または自動で更新できます。ただし、自動更新をお薦めします。

Advanced Management Console エージェント・バージョン2.0の手動更新

Advanced Management Consoleサーバーと一致するようにAdvanced Management Consoleバージョン2.0を手動で更新する方法について詳しく学習します。

Advanced Management Console エージェント・バージョン2.0を手動で更新するには、次のようにします。

  1. 古いエージェントは削除しないでください。Windowsコマンド・プロンプトで、sc stop "AMC Agent"またはnet stop "AMC Agent"と入力して、エージェント・サービスを停止します。
    このコマンドが機能するには、管理者権限が必要です。
  2. %programData%\Oracle\Java_AMC_2フォルダが保持されていることを確認します。新しいエージェントは、このフォルダから自動的に設定を選択します。
  3. <既存のamcエージェント・ルート・ディレクトリ>の内容を削除します。サーバーを最新リリースのAdvanced Management Consoleに更新した後で、サーバーから最新のエージェント・バンドルをダウンロードします。新しいエージェント・バンドルの.zipファイルを、同じ<既存のamcエージェント・ルート・ディレクトリ>に抽出します。
  4. Windowsコマンド・プロンプトで、sc start "AMC Agent"またはnet start "AMC Agent"と入力して、エージェント・サービスを再び起動します。
    このコマンドが機能するには、管理者権限が必要です。
  5. 新しいエージェントを開始して、動作を確認したら、%programData%\Oracle\Java_AMC_2を削除できます。

Advanced Management Console エージェント・バージョン2.1以上の手動更新

Advanced Management Consoleサーバーと一致するようにAdvanced Management Consoleエージェントのバージョン2.1以上を手動で更新する方法について詳しく学習します。

Advanced Management Console エージェント・バージョン2.1以上を手動で更新するには、次のようにします。

  1. 古いエージェントは削除しないでください。Windowsコマンド・プロンプトで、sc stop "AMC Agent"またはnet stop "AMC Agent"と入力して、エージェント・サービスを停止します。
    このコマンドが機能するには、管理者権限が必要です。
  2. conf\AMCServer.propertiesおよびconf\AMCUser.propertiesファイルが存在している場合は、これらのバックアップを作成します。
  3. <既存のamcエージェント・ルート・ディレクトリ>の内容を削除します。サーバーを最新リリースのAdvanced Management Consoleに更新した後で、サーバーから最新のエージェント・バンドルをダウンロードします。新しいエージェント・バンドルの.zipファイルを、同じ<既存のamcエージェント・ルート・ディレクトリ>に抽出します。
  4. ステップ2で保存したconf\AMCServer.propertiesおよびconf\AMCUser.propertiesファイルをリストアします。
  5. Windowsコマンド・プロンプトで、sc start "AMC Agent"またはnet start "AMC Agent"と入力して、エージェント・サービスを再び起動します。
    このコマンドが機能するには、管理者権限が必要です。

Advanced Management Consoleエージェントの自動更新

バージョン2.7以降、Advanced Management Consoleを新しいリリースに更新すると、エージェントは自動的にその特定のバージョンに更新されます。

Advanced Management Consoleエージェントを2.22より前のバージョンからアップグレードし、エージェント自動更新が有効になっている場合は、キーストア証明書を検証する必要があります。次のステップに従って、署名用証明書の変更に対応します:
  1. 「構成」→「エージェントのダウンロード」→「AMC署名キーストア」セクションからAMCSigning.jksファイルをダウンロードします。
  2. このファイルをすべてのエージェント・マシンに配布します。
  3. エージェント・サービスを手動で停止します。
  4. <既存のAMCエージェントのルート・ディレクトリ>/confフォルダのAMCSigning.jksファイルを配布されたファイルに置き換えます。

    ノート:

    AMCバージョン2.19、2.20または2.21から2.23以上にアップグレードする場合は、追加のステップが必要です:
    • <existing amc agent root directory>/confフォルダにあるAMCKeystore.propertiesファイルからsigning.keystore.passwordエントリを削除します。
    • AMCKeystore.propertiesファイルを保存します。
  5. エージェント・サービスを手動で起動します。