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 ツールキットの両方の展開
シナリオ 2：Enterprise Console 単体で HA ペアを管理する展開

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

Enterprise Console の最新バージョンを [Downloads] ページからダウンロードしてインストールします。
Enterprise Console を開き、[Controller] を選択します。[Controller] リストには、HA ペアのプライマリコントローラのみが表示されます。Enterprise Console で管理されていない HA コントローラの既存のペアがある場合は、Enterprise Console 内のコントローラを忘れる必要があります。プライマリコントローラのみが表示されます。
コントローラを選択し、[Remove] を選択します。

[Remove Controller] ダイアログで、[Remove Binaries] を選択解除します。この時点では、コントローラを Enterprise Console から削除するだけで、HA コントローラで実行されている Splunk AppDynamics On-Premises ソフトウェアは削除しません。
新しい HA モジュールをアクティブにするには、Enterprise Console 内で両方のコントローラを検出する必要があります。コントローラ削除ジョブが完了したら、[Controller > Discover & Upgrade Controller] を選択します。
[Discover Controller] ダイアログでは、コントローラのプライマリホストとコントローラのセカンダリホストまたはレプリカの両方のホスト名を指定することに注意してください。
[Discover Controller] ダイアログのフィールドに入力し、[Continue] を選択します。これにより、HA ペアが Enterprise Console に追加され、管理およびアップグレードが可能になります。
正常に完了した複数のジョブを表示するには、[Jobs] ページにアクセスします。コントローラ検出およびアップグレードジョブが完了するまでに時間がかかります。コントローラの検出とアップグレードに関連するタスクの進行状況を追跡する場合には、[View Details] を選択します。

HA ペアの検出とアップグレードのプロセスが完了したら、[Controller] ページは次のようになります。

現在、Enterprise Console はこの HA ペアを認識し、新しい HA モジュールが HA ペアのプライマリコントローラとセカンダリコントローラにコピーされています。
HA ペアをアクティブにするには、Enterprise Console ホストでコマンドシェルを開き、次のように入力します。
```
platform-admin.sh submit-job --service controller  --job activate-ha-modules
```
CODE
以下のような出力が表示されます。
コントローラの HA フェールオーバーが機能していることを確認するには、プライマリコントローラを終了し、コントローラウォッチドッグがフェールオーバーをトリガーできるようにします。次に、数分待って Splunk AppDynamics エージェントがコントローラにメトリックを報告していることを確認します。

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

Enterprise Console の最新バージョンを [Downloads] ページからダウンロードしてインストールします。
Enterprise Console ホストでインストーラを実行して、インストールされている Enterprise Console のバージョンをアップグレードします。
[Upgrade Controller] を選択して両方のコントローラをアップグレードします。
HA ペアをアクティブにするには、Enterprise Console ホストでコマンドシェルを開き、次のように入力します。
```
platform-admin.sh submit-job --service controller  --job activate-ha-modules
```
CODE
以下のような出力が表示されます。
コントローラの HA フェールオーバーが機能していることを確認するには、プライマリコントローラを終了し、コントローラウォッチドッグがフェールオーバーをトリガーできるようにします。次に、数分待って Splunk AppDynamics エージェントがコントローラにメトリックを報告していることを確認します。
HA モジュールを有効にすると、HATK フォルダの名前が変更され、サービスが破損します。
HA サーバのペアにサービスを正しく再インストールするには、プライマリサーバとセカンダリサーバで次のように入力する必要があります。
1. root 権限を使用してログインします。
2. 次のディレクトリに変更します。<controller_home>/controller-ha/init
3. HA モジュールで最初に次のスクリプトを実行して、HATK によってインストールされたサービスを削除する必要があります。
```
./uninstall-init.sh
```
  CODE
4. install-init.sh を実行して、同じサービスをインストールします。その際、ユーザ権限を昇格させるために次のいずれかのオプションを指定します。
  - -c #use setuid c wrapper
  - -s #use sudo
  - -p #use prune wrapper
  - -x #use user privilege wrapper

ウォッチドッグウィジェット

HA モジュールをアクティブにすると、コントローラウォッチドッグステータスを示す新しいウィジェットが Enterprise Console UI に表示されます。次の 3 つの状態があります。

コントローラウォッチドッグステータス	定義
	コントローラウォッチドッグプロセスは、常にプライマリコントローラの正常性をチェックしています。ユーザの対処は必要ありません。
	プライマリコントローラがダウンした場合、フェールオーバーは自動的に行われません。Enterprise Console で [Start Controller Watchdog] オプションを使用して、コントローラウォッチドッグを開始することをお勧めします。
	フェールオーバーは、プライマリコントローラとセカンダリコントローラのスイッチロールで現在進行中です。

プライマリコントローラホストでメンテナンス操作を実行する前に（コントローラが停止する可能性があります）、フェールオーバーを開始しないように [Stop Controller Watchdog] を選択することをお勧めします。Enterprise Console UI を使用してウォッチドッグを開始および停止するには、ウォッチドッグウィジェットをクリックし、[Stop] または [Start Controller Watchdog] を選択します。

CLI を使用したコントローラウォッチドッグの開始および停止

次のコマンドを使用して、コントローラウォッチドッグを開始および停止できます。

Stop the Controller Watchdog

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

CODE

Start the Controller Watchdog

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

CODE