このページでは、イベントサービスを手動でアップグレードする方法について説明します。これは、Platform Administration ApplicationやEnterprise Consoleを使用せずにイベントサービスをデプロイする場合に便利です。この方法は、リモートのWindowsマシン上でホストされているイベントサービスをアップグレードする必要がある場合に主に使用します。

手動アップグレードの実行

前提条件

events-service.exe が動作するためには Java 1.8 が必須です。

イベントサービスを手動でアップグレードするには

  1. イベントサービスの配布アーカイブ events-service.zip を AppDynamics のダウンロードサイトからイベントサービスマシンにダウンロードします。 

  2. イベントサービスのプロセスを停止します。

    bin/events-service.sh stop
  3. 既存のイベント サービス ディレクトリの名前を変更します。例：events-service-backup 
  4. ダウンロードしたイベントサービスの配布アーカイブを、イベントサービスを実行するマシン上の場所に解凍します。 
  5. バックアップしたイベントサービスのディレクトリにあるプロパティファイルから、新しいイベントサービスのディレクトリにある conf/events-store-api-store.properties ファイルに構成の変更を移行します。使用しているデプロイタイプによっては、次のファイル内の設定を調べて移行することが必要になる場合もあります。
    • events-service-all.propertiesまたは
    • events-service-api-store.properties

    4.2 から 4.3.x または最新バージョンにアップグレードしている場合は、events-service-api-store.properties ファイルを編集してポート範囲 [9300-9400] を :9300 に置き換える必要があります。

    たとえば、4.2 では events-service-api-store.properties ファイルは次のようになっています。

    ad.es.node.unicast.hosts=node1.example.com[9300-9400],node2.example.com[9300-9400],node3.example.com[9300-9400]

    4.3以降ではこのファイルは次のようになっています。

    ad.es.node.unicast.hosts=node1.example.com:9300,node2.example.com:9300,node3.example.com:9300

  6. 以下の手順に従って、コントローラでイベントサービスへの接続を構成し、イベントサービス用のコントローラキーを取得します。

    1. コントローラの実行中に、ルートユーザーとして管理コンソールを開きます。 
    2. [Controller Settings] ページで appdynamics.on.premise.event.service.url を検索します。
    3. デフォルト値をイベントサービスマシンの内部ホスト名に置き換え、イベントサービスのデフォルトのリスンポートを9080に置き換えます。
    4. その他の設定を検索します。イベントサービスからコントローラへの接続を有効するために必要な設定は appdynamics.on.premise.event.service.key です。 

    5. そのプロパティの値をクリップボードにコピーします。次の手順で、イベントサービスのプロパティファイルでこの値を構成する必要があります。 

  7. イベントサービスからコントローラへの接続を構成します。

    1. ターミナルで、events-service ディレクトリに移動します。

      cd events-service
      TEXT

    2. conf/events-service-api-store.properties ファイルを開いて編集します。

    3. 次のプロパティを見つけて、コピーしたキーで controller-key を置き換えます。

      ad.accountmanager.key.controller=controller-key
      TEXT

  8. events-service-api-store.properties ファイルで以下の重要なプロパティが適切に構成されていることを確認します。

    • ad.accountmanager.keyNamesCSV=EUM,CONTROLLER,MDS,OPS,SLM,JF
    • ad.accountmanager.key.eum=
    • ad.accountmanager.key.controller=
    • ad.accountmanager.key.mds=
    • ad.accountmanager.key.ops=
    • ad.accountmanager.key.slm=
    • ad.accountmanager.key.jf=
    • ad.accountmanager.key.service=
    • ad.jvm.heap.min=1g
    • ad.jvm.heap.max=1g
    • ad.es.jvm.heap.min=1g
    • ad.es.jvm.heap.max=1g

  9. 4.2 から 4.3.x 以降へのアップグレード中に events-services-api-store.properties の ad.es.node.unicast.hosts プロパティを移動します。

  10. events-service-api-store.properties ファイルを保存して閉じます。 
  11. 新しいイベントサービスのホームディレクトリが存在することを確認します。イベントサービスのホームディレクトリは、イベントサービスを起動するために使用されるプロパティファイルにある ad.es.path.home プロパティによって決定されます。
    このディレクトリが存在しない場合は作成します。たとえば、次のディレクトリを作成します。/opt/appdynamics/events-service/appdynamics-events-service

  12. 古いイベントサービスのデータディレクトリを新しいイベントサービスのホームディレクトリに（コピーではなく）移動します。例： 

    mv /opt/appdynamics/events-service-backup/appdynamics-events-service/data /opt/appdynamics/events-service/appdynamics-events-service/

  13. 新しいディレクトリに移動してからイベントサービスのプロセスを再起動します。

    nohup bin/events-service.sh start -p conf/events-service-api-store.properties &

  14. ノードの正常性を確認します。
    Windows
    bin\events-service.exe check-health -hp localhost:9081
    Linux
    curl -XGET localhost:9081/healthcheck?pretty=true

    サービスステータスとして、プロセスが正常に動作していることを表す「Healthy」が出力されていることを確認します。

    [appduser@controller-one events-service]$ bin/events-service.exe check-health -hp 192.168.33.22:9081
[2015-12-09T18:30:45,342-08:00] HV000001: Hibernate Validator 5.0.2.Final
[2015-12-09T18:30:45,956-08:00] Individual statuses below:
[2015-12-09T18:30:45,956-08:00] [192.168.33.22:9081] status is [200 OK]
[2015-12-09T18:30:45,956-08:00] Overall status Healthy
...
    TEXT

  15. 「イベントサービスへの接続」で説明しているように、分析エージェント、EUM サーバー、またはデータベース モニターリング エージェントからイベントサービスへの接続を構成します。
    これらの手順の実行の詳細については、「Install the Events Service on Windows」を参照してください。

4.3.x以前のバージョンから4.4.xにアップグレードしている場合は、イベントサービスを開始および停止するためのコマンドが変更されています。詳細については、Administer the Events Serviceを参照してください。