アップグレードウィザードを使用した HA コントローラペアのアップグレード

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

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

Enterprise Console を使用した新しい HA モジュールへの移行

.
制約事項:

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

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

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

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

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

  1. ダウンロードポータルから最新のリリースをダウンロードします。Linux シェルを使用する場合は、「Download Software」を参照してください。
  2. Enterprise Console をインストールします。
  3. アップグレードを実行する前に、フェールオーバーを実行して、セカンダリコントローラが正常な状態であることを確認する必要があります。セカンダリコントローラのホストにログインし、<controller-home>/HA/failover.sh コマンドを実行してコントローラのフェールオーバーを実行することを強くお勧めします。

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

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

  1. [Discover Upgrade] を選択します。
  2. コントローラのクレデンシャル、インストールディレクトリのパスを入力し、プライマリホストとセカンダリホストを決定します。
  3. [Continue] を選択します。システムは、コントローラに対して入力したクレデンシャルを確認します。
  4. クレデンシャルが正常に検証されると、検証の概要が次のように表示されます。

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

    アップグレードプロセスを停止する場合は、[Abort] を選択します。

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

  1. [Upgrade] を選択します。
  2. コントローラのクレデンシャルを入力します。
  3. [Continue] を選択します。システムは、コントローラに対して入力したクレデンシャルを確認します。
  4. クレデンシャルが正常に検証されると、検証の概要が次のように表示されます。

    [Continue] を選択し、セカンダリコントローラにフェールオーバーを実行します。「ステップ 4：フェールオーバーの実行」に進みます。

    アップグレードプロセスを停止する場合は、[Abort] を選択します。

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

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

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

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

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

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

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

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

    [Continue] を選択し、プライマリコントローラを確認します。

プライマリアップグレードが失敗した場合は、「Troubleshooting the Upgrade」を参照してください。

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

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

    [Continue] を選択し、プライマリコントローラを確認します。

プライマリアップグレードが失敗した場合は、「Troubleshooting the Upgrade」を参照してください。

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

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

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

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

アップグレードに問題がなく、続行する場合：
  1. [Yes, I want to continue the upgrade] を選択します。
  2. [Continue] を選択し、セカンダリコントローラをアップグレードします。
アップグレードに問題がある場合は、次の手順を実行します。
  1. [No, I am ready to continue] を選択します。

  2. [OK] を選択し、プロセスを中止してアップグレードウィザードを終了することを確認します。または、[Cancel] を選択してアップグレードプロセスに戻ります。プロセスを中止してアップグレードウィザードを終了する場合は [Fail Over and Rebuild Secondary] を選択し、「オプション 1 - 検出とアップグレード」に従ってプロセスを続行します。

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

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

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

  2. [Continue] を選択し、セカンダリコントローラをアップグレードします。
アップグレードに問題があり、ロールバックする場合：

  1. [No, I want to failover & rebuild secondary] を選択します。

  2. [Failover & Rebuild Secondary] を選択し、プロセスを開始します。[Fail Over and Rebuild Secondary] に進みます。

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

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

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

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

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

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

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

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

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

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

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

このスクリプトは、ウォッチドッグプロセスを終了し、現在のセカンダリコントローラでアプリケーションサーバーを起動して、コントローラの 1 つを以前のバージョンに復元します。HA ペアの他のコントローラを再構築するには、レプリケーションを確定する必要があります。このために、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 – 現在のセカンダリでウォッチドッグプロセスを開始します
これで現在のセカンダリサーバの再構築が完了するため、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 回完了するようにします。レプリケーションの完了ジョブには、現在のプライマリコントローラのダウンタイムが含まれます。