Upgrade the HA Controller Pair Using the Upgrade Wizard

You can use the HA Controller Upgrade Wizard once both of your Controllers (primary and secondary) have been onboarded into the Enterprise Console.

Note: If you are using the HA ToolKit (HATK) and made any customizations to it, we recommend that you review your particular situation and determine if you should proceed with the migration. For more details, see

Migrate to the New HA Module Using Enterprise Console

.
Restriction:

Upgrading the HA Controller pair consists of different procedures based on your deployment:

  • Follow Option 1 - Discover and Upgrade for deployments that are not managed by the Enterprise Console.Use the discover and upgrade job to onboard your HA Controller pair to the Enterprise Console before upgrading the primary Controller.
  • Follow Option 2 - Upgrade for HA pair deployments that are managed by the Enterprise Console.Use the upgrade option to upgrade your primary and secondary Controllers managed by the current Enterprise Console instance.

To upgrade using the Upgrade Wizard:

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

Option 1 - Discover and Upgrade

  1. Download the latest release from Download Portal.If you prefer to use the Linux shell, see Download Software.
  2. Install the Enterprise Console.
  3. Before you perform an upgrade, you must ensure that your secondary Controller is in a healthy state by performing a failover. We recommend that you log in to your secondary Controller host and run the <controller-home>/HA/failover.sh command to perform a Controller failover.

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

Option 1 - Discover and Upgrade

  1. Select Discover and Upgrade .
  2. Enter the credentials for the Controller, installation directory path, and determine the primary and secondary hosts.
  3. Select Continue . The system verifies the credentials you entered for the Controller.
  4. After the credentials have been successfully verified, the verification summary displays:

    -Select Continue to upgrade the primary Controller. Continue with Step 5: Upgrade the Primary Controller.

    - If you wish to stop the upgrade process, select Abort .

Option 2 - Upgrade

  1. Select Upgrade .
  2. Enter the credentials for the Controller.
  3. Select Continue . The system verifies the credentials you entered for the Controller.
  4. After the credentials have been successfully verified, the verification summary displays:

    - Select Continue to perform a failover to the secondary Controller. Continue with Step 4: Perform a Failover.

    - If you wish to stop the upgrade process, select Abort .

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

オプション2 - アップグレード

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

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

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

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

Option 1 - Discover and Upgrade

  1. Select Discover Upgrade.
  2. After the primary Controller has been successfully discovered and upgraded, the following message displays.

    Select Continue to verify the primary Controller.

See Troubleshooting the Upgrade if the primary upgrade fails.

Option 2 - Upgrade

  1. Select Upgrade.
  2. After the primary Controller has been successfully upgraded, the following message displays:

    Select Continue to verify the primary Controller.

See Troubleshooting the Upgrade if the primary upgrade fails.

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

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

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

Option 1 - Discover and Upgrade

If you are satisfied with the upgrade and want to continue:
  1. Select Yes, I want to continue the upgrade.
  2. Select Continue to upgrade the secondary Controller.
If you are not satisfied with the upgrade and want to stop:
  1. Select No, I am not ready to continue.

  2. Select OK to confirm that you want to abort the process and exit the Upgrade Wizard; or select Cancel to return to the upgrade process.If you abort the process and exit from the Upgrade Wizard, select Fail Over and Rebuild Secondary and follow Option 1- Discover and Upgrade to continue the process

Option 2 - Upgrade

If you are satisfied with the upgrade and want to continue

  1. Select Yes, I want to continue the upgrade.

  2. Select Continue to upgrade the secondary Controller.
If you are not satisfied with the upgrade and want to roll back:

  1. Select No, I want to failover & rebuild secondary.

  2. Select Failover & Rebuild Secondary to start the process. Continue to Fail Over and Rebuild Secondary.

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

オプション1 - 検出とアップグレード

  1. コントローラのクレデンシャルを入力します。
  2. Continue を選択します。
  3. セカンダリコントローラが正常に検出されてアップグレードされると、次の確認メッセージが表示されます。

    [Done] を選択し、アップグレードウィザードを完了します。

オプション2 - アップグレード

セカンダリコントローラのアップグレード中、エージェントトラフィックを処理するためにプライマリコントローラが使用可能になり、ダウンタイム期間が終了します。[Continue] を選択し、アップグレードウィザードを完了します。

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

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

オプション1 - 検出とアップグレード

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

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

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

  1. HA ツールキット（HATK）から、replicate コマンドを入力して現在のセカンダリコントローラを再構築します。
    CODE 
    ./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 コマンドを入力します。
    注: この手順には、現在のプライマリコントローラのダウンタイムが含まれます。
    CODE 
    ./replicate.sh -s <secondary_hostname> -f -w -e <external_vip> -i <internal_vip>
    コマンドオプションは次のとおりです。-f を使用するとスクリプトによりセットアップが完了し、コントローラが再起動されます。-w を使用すると現在のセカンダリでウォッチドッグプロセスが開始されます。
これで現在のセカンダリサーバの再構築が完了するため、HA ペアの両方のコントローラがデータを複製するようになります。

オプション2 - アップグレード

  1. フェールオーバーおよび再構築プロセスを開始して現在のセカンダリコントローラを再構築すると、コントローラ HA フェールオーバージョブが成功した場合に次のメッセージが表示されます。
    注: HATK を使用している場合は、各サーバーでスクリプト <controller_home>/HA/appdstatus.sh を実行して、プライマリおよびセカンダリコントローラの現在の状態を確認できます。
    1. 再構築の増分レプリケーションを開始し、ステップ 2 に進むには、[Continue] を選択します。
    2. フェールオーバーと再構築セカンダリプロセスをキャンセルする必要がある場合は、[Abort] を選択して終了します。次の確認メッセージが表示されます。
    3. [OK] を選択し、キャンセルを確定します。
  2. コントローラの増分レプリケーションジョブが正常に完了すると、次のメッセージが表示されます。

    [Continue] を選択し、セカンダリコントローラへのレプリケーションを完了します。

  3. コントローラのレプリケーションジョブが正常に完了すると、次のメッセージが表示されます。

    Done を選択します。

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

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

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

オプション1 - 検出とアップグレード

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

オプション2 - アップグレード

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