この移行方法でイベントサービスデータを 4.5.x クラスタから 23.x クラスタに移行するには、追加でロードバランサが必要になります。移行する前に、イベントサービス 4.5.x クラスタと同じように、イベントサービス 23.x クラスタを作成して設定する必要があります。

コンポーネントバージョン

イベントサービス 4.5.x からイベントサービス 23.x にデータを移行するには、次のバージョンの Splunk AppDynamics コンポーネントを実行していることを確認します。

Enterprise ConsoleイベントサービスコントローラEUM サーバー

23.1.3-32 以降

4.5.2.x23.1.3-66 以降21.4.6.34822 以降

Cisco AppDynamics コンポーネントとの互換性」を参照してください。

Windows OS での移行に関する考慮事項

Windows OS にイベントサービスをインストールするには、次のことを推奨します。

  • Windows Server 2016 または 2019 を使用します。「Windows におけるイベントサービスのインストール」を参照してください。
  • Elasticsearch の互換性は、Windows Server のエディションごとに異なります。互換性のある Windows Server のエディションを選択していることを確認してください。

移行プロセス

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

始める前に:

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

移行中にコントローラ設定を確実に保持するには、イベントサービス 4.5.x クラスタと同じ設定で新しいイベントサービス 23.x クラスタを作成することを推奨します。これにより、次の図に示すように、すべてのデータがイベントサービス 23.x にシームレスに移行され、新しいロードバランサがイベントサービス 23.x で設定されたノードを指すようになります。

 


ステップ 1:イベントサービス 23.x クラスタの作成と設定

  1. イベントサービス 4.5.x クラスタと同じ数のノードとハードウェアリソースを持つイベントサービス 23.x クラスタを作成します。詳細については、「マルチノードクラスタ」を参照してください。
  2. イベントサービス 4.5.x から新しく作成したイベントサービス 23.x クラスタにキーと設定をコピーします。
  3. イベントサービス 23.x でロードバランサを設定して、ノード間でトラフィックを分散させます。または、ラウンドロビン DNS を使用することもできます。

    イベントサービス 4.5.x ノードが DNS を使用している場合、データ移行が遅延し、データが失われる可能性があります。遅延時間は、設定したエージェントの数によって異なります。

ステップ 2:イベントサービスでの SSL の有効化(オプション)

Enterprise Console CLI を使用して、イベントサービスで SSL を有効にします。イベントサービス 4.5.x クラスタと同じワイルドカード証明書、キーストアファイル、およびパスワードを使用します。「イベントサービスで SSL を使用できるようにする」を参照してください。

次の CURL コマンドを使用して SSL 接続を確認します。

curl --cacert /path/to/ca.pem https://localhost:9080/_ping
curl --cacert /path/to/ca.pem https://<<IP_ADDRESS_Events_Service_23.x>>:9080/_ping>>
curl --cacert /path/to/ca.pem https://<<Events_Service_23.x_LOAD_BALANCER>>:9080/_ping>>
CODE

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

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

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

説明 プロパティ
ビジネスジャーニーの有効化(オプション)
ad.bizoutcome.enabled=false to true
CODE
エージェントを再起動したり、コントローラ構成のプロパティを変更したりしないでください。
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>>
CODE
キーストアのパスを設定します。
ad.dw.https.keyStorePath=<<Absolute path of JKS file>>
CODE
トラストストアのパスを設定します。
ad.dw.https.trustStorePath=<<Trust store path of cacerts>>
CODE

ロードバランサの構成

新しく設定されたクラスタに新しいロードバランサを導入します。イベントサービス 4.5.x からイベントサービス 23.x にメタデータおよびデータインデックスをコピーするには、ロードバランサが必要です。 

SSL 証明書の設定

DNS ホスト名を使用して SSL 証明書を生成した場合は、SSL 証明書を設定し、Splunk AppDynamics コンポーネントを再起動する必要があります。 

ワイルドカードを使用して SSL 証明書を生成した場合は(例:*.example.com)、この手順をスキップできます。

SSL 証明書の確認

イベントサービスノードにインストールされている SSL 証明書がドメインまたはホスト名と一致していることを確認します。この証明書には、標準の SSL 証明書、または複数のドメインとホスト名を持つサブジェクト代替名(SAN)証明書を使用できます。SSL 証明書で特定のドメインまたはホスト名のロードバランサにアクセスできない場合、SSL/TLS ハンドシェイクが失敗する可能性があります。 

javax.net.ssl.SSLHandshakeException などの例外が表示された場合は、データを移行しないでください。

次のコンポーネントで新しい SSL 証明書を使用します。

コンポーネント

手順
Agent(エージェント)
  1. 新しい CA 署名付き SSL 証明書を取得します。
    または、イベントサービス 23.x ノードのすべてのホスト名を使用して証明書を生成することができます。
  2. 新しい証明書を使用するようにエージェント設定を更新します。この設定では、次を指定する必要があります。
    • 新しい証明書ファイルのパス。
    • 構成ファイル内の秘密キーファイル。
  3. エージェントを再起動して、新しい SSL 証明書と設定の変更を適用します。
コントローラ
  1. 新しい SSL 証明書を Java 信頼ストアにインポートします。これにより、Java アプリケーションはセキュア通信のために信頼ストアを使用できます。
  2. コントローラを再起動します。

EUM サーバー

  1. EUM サーバーを実行している Java 信頼ストアに、新しい SSL 証明書をインポートします。
  2. 証明書をキーストアにインポートし、JVM を再起動します。
  3. EUMサーバーを再起動します。

設定された SSL 証明書を使用して、サービスまたはエージェントが実行されているすべてのノードで接続をテストします。

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

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

移行ユーティリティ

イベントサービスを準備し、SSL 証明書を設定したら、Splunk AppDynamics 移行ユーティリティの使用に進みます。「ロードバランサを使用したイベントサービスデータの移行」を参照してください。