両方のコントローラ（プライマリとセカンダリ）が Enterprise Console にオンボードされたら、HA コントローラ アップグレード ウィザードを使用できます。 

HA ツールキット（HATK）を使用していて、それをカスタマイズした場合、AppDynamics では、特定の状況を確認し、移行を進める必要があるかどうかを判断することをお勧めします。詳細については、Enterprise Console を使用した新しい HA モジュールへの移行を参照してください。

HA ペアのアップグレードは、展開に応じた異なる手順で構成されます。

  • Enterprise Console で管理されていない展開については、「Option 1 - Discover and Upgrade」に従ってください。
    検出およびアップグレードジョブを使用して、プライマリコントローラをアップグレードする前に HA コントローラペアを Enterprise Console にオンボードします。
  • Enterprise Console で管理されている HA ペアの展開については、「Option 2 - Upgrade」に従ってください。
    アップグレードオプションを使用し、現在の Enterprise Console インスタンスで管理されるプライマリおよびセカンダリコントローラをアップグレードします。

アップグレードウィザードを使用してアップグレードする場合：


ステップ1：アップグレードの準備

  1. AppDynamics ダウンロードセンターから最新のリリースをダウンロードします。
    Linux シェルを使用する場合は、「AppDynamicsソフトウェアのダウンロード」を参照してください。

  2. Enterprise Consoleのインストール）。

  3. アップグレードを実行する前に、フェールオーバーを実行して、セカンダリコントローラが正常な状態であることを確認する必要があります。AppDynamics は、セカンダリコントローラのホストにログインし、<controller-home>/HA/failover.sh コマンドを実行してコントローラのフェールオーバーを実行することを強くお勧めします。


ステップ 2：コントローラのクレデンシャルの入力

  1. Discover and Upgrade を選択します。

  2. コントローラのクレデンシャル、インストールディレクトリのパスを入力し、プライマリホストとセカンダリホストを決定します。
    Discover Controller

  3. [Continue] を選択します。システムは、コントローラに対して入力したクレデンシャルを確認します。

  4. クレデンシャルが正常に検証されると、検証の概要が次のように表示されます。

    Verification summary

    - [Continue ] を選択し、プライマリコントローラをアップグレードします。「ステップ 5：プライマリコントローラのアップグレード」に進みます。
    - アップグレードプロセスを停止する場合は、[Abort] を選択します。

  1. Upgrade を選択します。

  2. コントローラのクレデンシャルを入力します。
    Upgrade Controller

  3. [Continue] を選択します。システムは、コントローラに対して入力したクレデンシャルを確認します。

  4. クレデンシャルが正常に検証されると、検証の概要が次のように表示されます。

    Verification summary
    - [Continue ] を選択し、セカンダリコントローラにフェールオーバーを実行します。「ステップ 4：フェールオーバーの実行」に進みます。
    - アップグレードプロセスを停止する場合は、[Abort] を選択します。

ステップ 3：フェールオーバーの実行

Step 3: Perform a Failover 「オプション 1：検出とアップグレード」に適用されません。「ステップ 4：プライマリコントローラのアップグレード」に進みます。

コントローラをアップグレードする前に、AppDynamics は、他のコントローラが機能しているかどうかを判断するためにフェールオーバーを実行することを強くお勧めします。

プライマリコントローラは機能することが分かっているため、このステップにより、アップグレードで問題が発生した場合にフェールバックできる安定した構成が提供されます。コントローラ HA フェールオーバージョブが正常に完了すると、次の確認メッセージが表示されます。

Verification summary
[Continue ] を選択し、プライマリコントローラをアップグレードします。 


ステップ 4：プライマリコントローラのアップグレード

  1. [Discover Upgrade] を選択します。 
  2. プライマリコントローラが正常に検出されてアップグレードされると、次のメッセージが表示されます。
    Verification summary
    [Continue ] を選択し、プライマリコントローラを検証します。
  1. [Upgrade] を選択します。
  2. プライマリコントローラが正常にアップグレードされると、次のメッセージが表示されます。
    Verification summary
    [Continue ] を選択し、プライマリコントローラを検証します。

プライマリアップグレードが失敗した場合は、「アップグレードのトラブルシューティング」を参照してください。

ステップ 5：プライマリ コントローラ アップグレードの確認

この手順では、アップグレードプロセスを一時停止し、新しいコントローラバージョンを手動で確認できます。

セカンダリコントローラのアップグレードを進める前に、コントローラにログインし、過去 5 分以内にメトリックが受信されたことを確認することで、コントローラが動作していることを確認することをお勧めします。アップグレードに問題がある場合は、開始した古いバージョンにロールバックすることができます。 

アップグレードに問題がなく、続行する場合：

  1. [Yes, I want to continue the upgrade] を選択します。
    Continue upgrade

  2. [Continue ] を選択し、セカンダリコントローラをアップグレードします。 

アップグレードに問題がある場合は、次の手順を実行します。
  1. [No, I am not ready to continue] を選択します。
    Confirm discontinue

  2. プロセスを中止してアップグレードウィザードを終了するには、[OK ] を選択します。またはアップグレードプロセスに戻るには、[Cancel] を選択します。
    プロセスを中止し、アップグレードウィザードを終了する場合は、[Fail Over and Rebuild Secondary] を選択し、「Option 1- Discover and Upgrade」に従ってプロセスを続行します。

アップグレードに問題がなく、続行する場合：
  1. [Yes, I want to continue the upgrade] を選択します。
    Continue upgrade
  2. [Continue ] を選択し、セカンダリコントローラをアップグレードします。 
アップグレードに問題があり、ロールバックする場合：
  1. [No, I want to failover & rebuild secondary] を選択します。
    Failover and rebuild secondary
  2. [Failover & Rebuild Secondary ] を選択し、プロセスを開始します。[Fail Over and Rebuild Secondary] に進みます。

ステップ 6：セカンダリコントローラのアップグレード

  1. コントローラのクレデンシャルを入力します。 
    Controller credentials
  2. [Continue] を選択します。
  3. セカンダリコントローラが正常に検出されてアップグレードされると、次の確認メッセージが表示されます。
    Verification summary
    [Done ] を選択し、アップグレードウィザードを完了します。
セカンダリコントローラのアップグレード中、エージェントトラフィックを処理するためにプライマリコントローラが使用可能になり、ダウンタイム期間が終了します。[Continue ] を選択し、アップグレードウィザードを終了します。

アップグレードのトラブルシューティング

セカンダリのフェールオーバーおよび再構築

サービスを迅速に復元する場合は、現在のセカンダリ コントローラ ホストで次のスクリプトを実行して、以前のコントローラバージョンに手動でフェールオーバーできます。 

<controller-home>/HA/failover.sh -f
CODE

このスクリプトは、ウォッチドッグプロセスを終了し、現在のセカンダリコントローラでアプリケーションサーバを起動して、コントローラの 1 つを以前のバージョンに復元します。
HA ペアの他のコントローラを再構築するには、レプリケーションを確定する必要があります。このために、AppDynamics は、HATK で incremental-replication ジョブと finalize-replication ジョブを実行することをお勧めします。 

  1. HA ツールキット（HATK）から、replicate コマンドを入力して現在のセカンダリコントローラを再構築します。

    ./replicate.sh -s <secondary_hostname> -e <external_vip> -i <internal_vip>

    コマンドオプションは次のとおりです。
    -s <secondary_hostname>：次で設定した現在のセカンダリのホスト名。/etc/hosts
    -e <external_vip>：ロードバランサまたは他のタイプのリバースプロキシでクライアントに公開されるコントローラペアのホスト名とポート。これは、通常、アプリケーション エージェントとコントローラ UI クライアントがコントローラに対処するアドレスです。たとえば、http://controllervip.example.com:80。
    -i  <internal_vip>：コントローラが保護ネットワーク（ロードバランサに関連する）内にあり、仮想 IP に直接対応できない場合は、この値を使用し、コントローラが使用する内部仮想 IP アドレスを指定します。例：http://controllervip.internal.example.com:80

  2. HATK から、finalize replication コマンドを入力します。

    この手順には、現在のプライマリコントローラのダウンタイムが含まれます。

    ./replicate.sh -s <secondary_hostname> -f -w -e <external_vip> -i <internal_vip>

    コマンドオプションは次のとおりです。
    -f ：スクリプトが設定を完了し、コントローラを再起動します
    -w ：現在のセカンダリでウォッチドッグプロセスを開始します

  1. フェールオーバーおよび再構築プロセスを開始して現在のセカンダリコントローラを再構築すると、コントローラ HA フェールオーバージョブが成功した場合に次のメッセージが表示されます。
    Verification summary

    HATK を使用している場合は、各サーバで次のスクリプトを実行して、プライマリおよびセカンダリコントローラの現在の状態を確認できます。<controller_home>/HA/appdstatus.sh

    1. 再構築の増分レプリケーションを開始し、ステップ 2 に進むには、[Continue ] を選択します。 
    2. それ以外の場合は、フェールオーバーと再構築セカンダリプロセスをキャンセルする必要がある場合は、[Abort] を選択して終了します。次の確認メッセージが表示されます。
      Confirm
    3. [OK] を選択し、キャンセルを確定します。 
  2. コントローラの増分レプリケーションジョブが成功すると、次のメッセージが表示されます。
    Verification summary
    セカンダリコントローラへのレプリケーションを確定するには、[Continue] を選択します。
  3. コントローラのレプリケーションジョブが正常に完了すると、次のメッセージが表示されます。
    Verification summary
    [Done] を選択します。

これで現在のセカンダリサーバの再構築が完了するため、HA ペアの両方のコントローラがデータを複製するようになります。

セカンダリコントローラのアップグレードの失敗

セカンダリコントローラのアップグレードが失敗する場合：


  • 障害の原因を特定し、手動で問題を解決した場合は、[Resume] を選択してアップグレードを再試行します。
  • 手動ですでに問題を解決しようとしていて、[Resume] オプションを選択しても問題を解決できなかった場合は、[Rebuild Secondary] を選択してセカンダリコントローラを再構築します。コントローラデータのサイズによっては、時間がかかることがあります。

Upgrade failed message

  1. [More] メニューから、[Incremental Replication] を選択します。増分レプリケーションジョブには、現在のプライマリコントローラのダウンタイムは含まれません。
    Incremental replication
  2. [Finalize Replication] を選択する前に、増分レプリケーションジョブが実行され、少なくとも 3 回完了するようにします。レプリケーションの完了ジョブには、現在のプライマリコントローラのダウンタイムが含まれます。