イベントサービスの手動アップグレード

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

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

警告:

前提条件

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

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

イベントサービスの配布アーカイブ events-service.zip をダウンロードサイトからイベントサービスマシンにダウンロードします。
イベントサービスのプロセスを停止します。
```
bin/events-service.sh stop
```
既存のイベントサービスディレクトリの名前を変更します。例：events-service-backup
ダウンロードしたイベントサービスの配布アーカイブを、イベントサービスを実行するマシン上の場所に解凍します。
バックアップしたイベントサービスのディレクトリにあるプロパティファイルから、新しいイベントサービスのディレクトリにある conf/events-service-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
```
以下の手順に従って、コントローラでイベントサービスへの接続を構成し、イベントサービス用のコントローラキーを取得します。
1. コントローラの実行中に、ルートユーザーとして管理コンソールを開きます。
2. [Controller Settings] ページで、appdynamics.on.premise.event.service.url を見つけます。
3. デフォルト値をイベントサービスマシンの内部ホスト名に置き換え、イベントサービスのデフォルトのリスンポートを9080に置き換えます。
4. 追加の設定、つまりイベントサービスからコントローラへの接続を有効するために必要な設定である appdynamics.on.premise.event.service.key を見つけます。
5. そのプロパティの値をクリップボードにコピーします。次の手順で、イベントサービスのプロパティファイルでこの値を構成する必要があります。
イベントサービスからコントローラへの接続を構成します。
1. 端末で、events-service ディレクトリに移動します。
```
cd events-service
```
2. 編集のために conf/events-service-api-store.properties ファイルを開きます。
3. 次のプロパティを見つけて、コピーしたキーで controller-key を置き換えます。
```
ad.accountmanager.key.controller=controller-key
```
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
4.2 から 4.3.x 以降へのアップグレード中に、ad.es.node.unicast.hosts プロパティを events-services-api-store.properties に移動します。
events-service-api-store.properties ファイルを保存して閉じます。
新しいイベントサービスのホームディレクトリが存在することを確認します。イベントサービスのホームディレクトリは、イベントサービスを起動するために使用されるプロパティファイルにある ad.es.path.home プロパティによって決定されます。このディレクトリが存在しない場合は作成します。たとえば、次のディレクトリを作成します： /opt/appdynamics/events-service/appdynamics-events-service
古いイベントサービスのデータディレクトリを新しいイベントサービスのホームディレクトリに（コピーではなく）移動します。例：
```
mv /opt/appdynamics/events-service-backup/appdynamics-events-service/data /opt/appdynamics/events-service/appdynamics-events-service/
```
新しいディレクトリに移動してからイベントサービスのプロセスを再起動します。
```
nohup bin/events-service.sh start -p conf/events-service-api-store.properties &
```

ノードの正常性を確認します。

Windows bin\events-service.exe check-health -hp localhost:9081

Linuxcurl -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
...

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

警告: 4.3.x以前のバージョンから4.4.xにアップグレードしている場合は、イベントサービスを開始および停止するためのコマンドが変更されています。ビジネスインサイトの

イベントサービスの管理

」を参照してください。