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

Enterprise Console の新しいコントローラ HA モジュールの一部として、Enterprise Console はコントローラのフェールオーバーを管理しなくなりました。代わりに、新しい HA モジュールがコントローラのホストにコントローラウォッチドッグをインストールし、コントローラのホストがフェールオーバーの実行を担当するようになりました。新しい HA モジュールは、Enterprise Console でパッケージ化されていて、HA ツールキット（HATK）などの古い HA 実装からこの新しい HA モジュールにシームレスに移行することができます。新しい HA モジュールは、最新バージョンの Enterprise Console に含まれていて、コントローラをインストールまたはアップグレードする場合にインストールされます。ただし、HA ペアを移行するまではアクティブになりません。

HA モジュールを使用する必要があるユーザ

  • Splunk AppDynamics HA の実装を開始したばかりの新しいユーザーの場合は、HA モジュールを使用する必要があります（これがデフォルトのオプションです）。

  • 既存のユーザがコマンドライン（CLI）および HATK の代わりに Enterprise Console UI 統合を使用する場合は、HA モジュールを使用する必要があります。

  • 既存のユーザが既存の DevOps を変更したくない場合、追加のトレーニングを実施する場合、または HATK 機能の使用を続行する場合は、HATK を使用します。

注: コントローラのバージョンがバージョン 4.5.13 よりも古い場合は、HA モジュールの代わりに HA ツールキット（HATK）を使用してインストールして高可用性を設定する必要があります。

はじめる前に

高可用性の前提条件に加えて、次の要件が満たされていることを確認してください。

  • 両方のサーバで同じ Linux ユーザ名とグループ名を使用します。

  • 両方のサーバに同じ Splunk AppDynamics ディレクトリ構造があり、両方のサーバ上でシンボリックリンクを使用せずに同じ Splunk AppDynamics パス名が使用されています。

コントローラ高可用性ペアの移行

ここでは、2 つの異なるシナリオに必要な Enterprise Console とコントローラの HA ペアのアップグレードプロセスについて説明します。

シナリオ 1：Enterprise Console と HA ツールキットを使用するアップグレード展開

  1. Enterprise Console の最新バージョンを [Downloads] ページからダウンロードしてインストールします。

  2. Enterprise Console を開き、[Controller] を選択します。[Controller] リストには、HA ペアのプライマリコントローラのみが表示されます。Enterprise Console で管理されていない HA コントローラの既存のペアがある場合は、Enterprise Console 内のコントローラを忘れる必要があります。プライマリコントローラのみが表示されます。

  3. コントローラを選択し、[Remove] を選択します。
    警告: [Remove Controller] ダイアログで、[Remove Binaries] を選択解除します。この時点では、コントローラを Enterprise Console から削除するだけで、HA コントローラで実行されている Splunk AppDynamics オンプレミスソフトウェアは削除しません。

  4. 新しい HA モジュールをアクティブにするには、Enterprise Console 内で両方のコントローラを検出する必要があります。コントローラの削除ジョブが完了したら、[Controller > Discover and Upgrade Controller] を選択します。

  5. [Discover Controller] ダイアログでは、コントローラのプライマリホストと、コントローラのセカンダリホストまたはレプリカの両方のホスト名を指定することに注意してください。

  6. [Discover Controller] ダイアログのフィールドに入力し、[Continue] を選択します。これにより、HA ペアが Enterprise Console に追加され、そこで管理とアップグレードを行うことができます。[Jobs] ページにアクセスして、正常に完了したいくつかのジョブを確認します。コントローラの検出およびアップグレードジョブが完了するまでに時間がかかります。コントローラの検出とアップグレードに関連するタスクの進行状況を追跡するには、[View Details] を選択します。HA ペアの検出とアップグレードのプロセスが完了したら、[Controller] ページは次のようになります。現在、Enterprise Console はこの HA ペアを認識し、新しい HA モジュールが HA ペアのプライマリコントローラとセカンダリコントローラにコピーされています。

  7. HA ペアをアクティブにするには、Enterprise Console ホストでコマンドシェルを開き、次のように入力します。
    platform-admin.sh submit-job --service controller --job activate-ha-modules
    以下のような出力が表示されます。

  8. コントローラの HA フェールオーバーが機能していることを確認するには、プライマリコントローラを終了し、コントローラウォッチドッグがフェールオーバーをトリガーできるようにします。次に数分待って、Splunk AppDynamics エージェントがコントローラにメトリックを報告していることを確認します。

シナリオ 2：Enterprise Console 単体で管理されるアップグレード展開

  1. Enterprise Console の最新バージョンを [Downloads] ページからダウンロードしてインストールします。

  2. Enterprise Console ホストでインストーラを実行して、インストールされている Enterprise Console のバージョンをアップグレードします。

  3. [Upgrade Controller] を選択して両方のコントローラをアップグレードします。

  4. HA ペアをアクティブにするには、Enterprise Console ホストでコマンドシェルを開き、次のように入力します。以下のような出力が表示されます。
    platform-admin.sh submit-job --service controller --job activate-ha-modules
    以下のような出力が表示されます。

  5. コントローラの HA フェールオーバーが機能していることを確認するには、プライマリコントローラを終了し、コントローラウォッチドッグがフェールオーバーをトリガーできるようにします。次に数分待って、Splunk AppDynamics エージェントがコントローラにメトリックを報告していることを確認します。

  6. HA モジュールを有効にすると、HATK フォルダの名前が変更され、サービスが破損します。HA サーバーのペアにサービスを正しく再インストールするには、プライマリサーバーとセカンダリサーバーで次のように入力する必要があります。

    1. ルート権限でログインします。

    2. ディレクトリを <controller_home>/controller-ha/init に変更します。

    3. HA モジュールで最初に次のスクリプトを実行して、HATK によってインストールされたサービスを削除する必要があります。
      ./uninstall-init.sh
    4. install-init.sh を実行して、同じサービスをインストールします。その際、ユーザー権限を昇格させるために次のいずれかのオプションを指定します。
      • -c #use setuid c wrapper
      • -s #use sudo
      • -p #use prune wrapper
      • -x #use user privilege wrapper

Watchdog Widget

After activating the HA Module, a new widget displays in the Enterprise Console UI indicating the Controller Watchdog status. It has three states:

Controller Watchdog StatusDefinition
The Controller watchdog process is constantly checking the health of your primary Controller. No user action is required.
In the event that your primary Controller goes down, the failover is not automatic. We recommend that you start the Controller watchdog using the Start Controller Watchdog option in Enterprise Console.
Failover is currently in progress where your primary Controller and secondary Controller switch roles

Prior to performing any maintenance operations on your Primary Controller host (which could result in stopping the Controller), we recommend that you select Stop Controller Watchdog to prevent a failover from initiating. Use the Enterprise Console UI to start and stop watchdog by clicking the watchdog widget, and then selecting Stop or Start Controller Watchdog.

Start and Stop the Controller Watchdog with CLI

You can start and stop the Controller Watchdog using the following commands:

Stop the Controller Watchdog 

./platform-admin.sh submit-job --job stop-controller-watchdog --service controller

Start the Controller Watchdog 

./platform-admin.sh submit-job --job start-controller-watchdog --service controller