イベントサービスノードを使用したデータの移行

この移行方法では、イベントサービス 4.5.x がインストールされているノードと同じノードにイベントサービス 24.x をインストールする必要があります。ただし、Enterprise Console を使用して、ノード内の 2 つの異なるプラットフォームとしてイベントサービスのバージョンをインストールする必要があります。したがって、この方法はコロケーション方法と呼ばれます。各イベントサービスノードでは、イベント サービス プラットフォームのインストールパスとリスナーポートが異なります。このように、イベント サービス プラットフォームは同じホストを共有しますが、異なるエンティティとして動作します。したがって、移行に特別なハードウェアは必要ありません。

移行ユーティリティを使用して、イベントサービス 4.5.x から 24.x プラットフォームにデータを移行します。このユーティリティでは、最初にすべてのノードで既存のイベントサービスデータをイベントサービス 4.5.x から 24.x プラットフォームに移行します。移行中にイベントサービス 4.5.x プラットフォームでデータまたはメタデータが収集されると、移行ユーティリティは次の処理を実行します。

  1. タイムスタンプを使用して、差分データまたはメタデータを識別します。
  2. 差分をイベントサービス 24.x プラットフォームにコピーします。
  3. 新しいデータとメタデータがイベントサービス 24.x プラットフォームに流れるようにします。

システム要件

イベントサービスのインストールとデータ移行には、次の構成が必要です。

  • ディスクサイズは現在のイベントサービス 4.5.x の 4 倍必要です。または、ディスク容量の 75% 以上をイベントサービスのインストールとデータ移行に使用できるよう空けておく必要があります。

    たとえば、イベントサービス 4.5.x で 1 TB を使用している場合、4 TB のディスクサイズが必要です。または、ディスク容量の 3 TB 以上が空いていることを確認します（必要とされる 4 TB の 75% に該当します）。

  • 各イベントサービスノードには、16 個の CPU コアと 128 GB の RAM が必要です。

移行プロセス

次の表に、Elasticsearch 2.4.1 から 8.10.x バージョンにデータを移行するタスクの概要を示します。

注:

始める前に：

シリアル番号（Serial Number）ステップ
1.移行ユーティリティのダウンロード
2.Enterprise Console を最新のバージョンにアップグレード
3.移行のためのイベントサービスの準備
4.ロードバランサの設定
5.カットオフポイントの特定
6.Cisco AppDynamics ユーティリティを使用してデータを移行

移行ユーティリティのダウンロード

  1. analytics-on-prem-es2-es8-migration-[LATEST]-exec.jar をダウンロードします。
    1. Enterprise Console をインストールするか、最新のバージョンにアップグレードします。「Enterprise Console のインストールNo Content found for /db/organizations/splunk/repositories/portal-production/content/documents/AppDynamics/on_premises/c_install_the_enterprise_console.dita」を参照してください。
    2. <YOUR_EC_HOME>/appdynamics/platform/platform-admin/archives/events-service/ に移動します。
    3. events-service.zip ファイルを抽出します。
    4. events-service/bin/migration に移動して、移行ユーティリティ jar を使用します。
  2. JDK 17 および SQLite 3.x を、移行ユーティリティをダウンロードしたマシンにインストールします。SQLite は、移行ステータスをモニターする際に役立ちます。
    注: 移行中は、この SQLlite データベース（dataMigration.db）に接続するツールを使用しないでください。

Enterprise Console のアップグレード

Enterprise Console を 23.11.0 以降にアップグレードします。詳細については、「Enterprise Console のアップグレード」を参照してください。

注: Enterprise Console 23.11.0 以降でのみ、複数のプラットフォームがサポートされています。そのため、クラスタノード内のイベントサービスデータを移行するには、Enterprise Console を 23.11.x にアップグレードする必要があります。

移行のためのイベントサービスの準備

単一ノード内でイベントサービス 4.5.x から 24.x にデータを移行するには、異なるインストールパスとポートを使用してイベントサービス 24.x の新しいプラットフォームを作成する必要があります。

ステップ 1：イベントサービス 24.x プラットフォームの作成

  1. Enterprise Console GUI にログインします。
  2. [Platforms] で、イベントサービス 4.5.x ノードを確認します。
  3. [Platforms] で、[Create Platform] を選択します。
  4. [Custom Install] を選択します。
  5. プラットフォームの指定：
    1. イベントサービス 24.x プラットフォームの [Name] を指定します。
    2. イベントサービス 24.x をインストールするパスを指定します。このパスは、イベントサービス 4.5.x とは異なるものにする必要があります。
  6. 新しく作成したプラットフォームを選択し、ホストとログイン情報を追加します。ホストとログイン情報は、イベントサービス 4.5.x プラットフォームと同じである必要があります。
詳細については、「Enterprise Console の管理」を参照してください。

ステップ 2：イベントサービス 24.x のインストール

新しいプラットフォームにイベントサービス 24.x をインストールします。

  1. Enterprise Console GUI にログインします。
  2. イベントサービス 24.x 用に作成した新しいプラットフォームを選択します。
  3. [Events Service] に移動し、[Install Events Service] をクリックします。
    1. [Target Version] で、最新のイベントサービスビルドを選択します。
    2. [Prod] プロファイルを選択します。
    3. [Data Directory] パスを確認します。このパスは、イベントサービス 4.5.x プラットフォームとは異なるものにする必要があります。
    4. 一意のポート番号を指定し、イベントサービス 4.5.x プラットフォームと競合しないようにします。
      注: イベントサービス 4.5.x および 24.x プラットフォームに同じポート番号を指定すると、イベントサービスクラスタがクラッシュします。
    5. [Hosts] で、すべてのイベントサービスノードを選択します。
    6. [送信（Submit）] をクリックします。

ステップ 3：イベントサービスプロパティの更新

注: イベントサービスクラスタを停止せずに、イベントサービスのプロパティを更新できます。ただし、一部の変更は、クラスタのローリング再起動後に有効になる場合があります。

events-service-api-store.properties ファイルで、次のプロパティを更新します。

説明プロパティ
ビジネスジャーニーの有効化（オプション） 
ad.bizoutcome.enabled=false to true
エージェントを再起動したり、コントローラ構成のプロパティを変更したりしないでください。 
ad.accountmanager.key.eum=<<COPY_SAME_KEY_VALUE_FROM_Events_Service_4.5.x>>

ad.accountmanager.key.controller=<<COPY_SAME_KEY_VALUE_FROM_Events_Service_4.5.x>>

ad.accountmanager.key.mds=<<COPY_SAME_KEY_VALUE_FROM_Events_Service_4.5.x>>

ad.accountmanager.key.ops=<<COPY_SAME_KEY_VALUE_FROM_Events_Service_4.5.x>>

ad.accountmanager.key.slm=<<COPY_SAME_KEY_VALUE_FROM_Events_Service_4.5.x>>

ad.accountmanager.key.jf=<<COPY_SAME_KEY_VALUE_FROM_Events_Service_4.5.x>>

ad.accountmanager.key.account_service=<<COPY_VALUE_FROM(ad.accountmanager.key.service)>>

ad.accountmanager.key.admin_service=<<COPY_VALUE_FROM(ad.accountmanager.key.service)>>

ad.accountmanager.key.service=<<COPY_SAME_KEY_VALUE_FROM_Events_Service_4.5.x>>

キーストアのパスを設定します。

注: イベントサービス 4.5.x で SSL が有効になっている場合は、このプロパティを更新します。
 
ad.dw.https.keyStorePath=<<Absolute path of JKS file>>

トラストストアのパスを設定します。

注: イベントサービス 4.5.x で SSL が有効になっている場合は、このプロパティを更新します。
 
ad.dw.https.trustStorePath=<<Trust store path of cacerts>>

カットオフポイントの特定

この移行では、データフローがイベントサービス 4.5.x から 24.x プラットフォームに切り替わるカットオーバーの方法を使用します。アクティブなセッションまたはビジネストランザクションで部分的なデータ損失が発生する場合があります。そのため、カットオーバーを実行する非ピーク時間を特定する必要があります。差分が小さくなるまで差分移行を繰り返してから、カットオーバーを終了します。 これにより、カットオーバー後の移行のために最小限のビジネス トランザクション データが残るようになります。