Kafka と ZooKeeper のデータファイルの場所の変更—GeoEvent Server

Kafka と ZooKeeper のデータファイルの場所

ArcGIS GeoEvent Gateway では、Kafka のオンディスクトピックキューと ZooKeeper の構成ファイルにローカルフォルダーが使用されます。

Windows でのデフォルトディレクトリは C:\ProgramData\Esri\GeoEvent-Gateway です。
Linux でのデフォルトディレクトリは /home/arcgis/.esri/GeoEvent-Gateway です。

ArcGIS GeoEvent Server をデフォルト以外のドライブまたはファイルパスにインストールした場合でも、GeoEvent Gateway で Kafka および ZooKeeper ファイルには上記のデフォルトフォルダーが使用されます。たとえば組織の慣例で C ドライブ上のディスクの利用を制限して、代わりにソフトウェアを別のドライブにインストールすることになっている場合、これによって問題が生じることがあります。その場合、上記のデフォルトフォルダー以外のフォルダーにデータファイルを書き込むように GeoEvent Gateway を再構成する必要があります。この変更は GeoEvent Server をインストールした後で行う必要があります。

Windows または Linux で以下の手順に従って、Kafka のオンディスクトピックキューと ZooKeeper の構成ファイルの場所を変更します。

注意:

以下の手順では、GeoEvent Server の既存の構成が削除されます。これらの変更は GeoEvent Server をインストールした直後に実行し、その後で GeoEvent Server の構成やカスタムコンポーネントの配置を行うことをお勧めします。

注意:

ArcGIS GeoEvent Server サービスと ArcGIS GeoEvent Gateway サービス (Windows 上) または同等のデーモン (Linux 上) の実行に使用するシステムアカウントには、GeoEvent Gateway データファイル用に選択したファイルパスへのファイルの読み取り/書き込み、作成、削除を行うためのフルコントロールが必要です。

注意:

Windows UNC パス名はサポートされていません。ゲートウェイデータのディレクトリを指定する際には、C:\ProgramData\Esri や D:\Data\Esri などのローカルサーバーディレクトリ (Windows 上) または GeoEvent Server の実行に使用されているユーザーアカウントの下の /home/arcgis/.esri などのパス (Linux 上) を使用します。

作業を始める前に

入力コネクタ、出力コネクタ、またはジオイベントサービスやジオイベント定義などのその他のエレメントが GeoEvent Server で構成されている場合、以下の手順に従って現在の構成をエクスポートしてから、以降のセクションの手順に進みます。

ArcGIS GeoEvent Manager を開き、[サイト] → [ジオイベント] → [構成ストア] に移動します。
[構成のエクスポート] をクリックして、既存の構成のバックアップを作成します。

カスタムコンポーネント (コネクタ/プロセッサ) をデプロイしている場合、次の手順を実行してこれらを GeoEvent Server から削除してから、次のセクションの手順に進むことをお勧めします。
ArcGIS GeoEvent Server サービスが実行されている状態で、deploy フォルダー内の既存のすべての *.jar ファイルをテンポラリディレクトリ内に移動します。 deploy フォルダーは以下の場所にあります。
<ArcGIS Server installation directory>\GeoEvent\deploy

Windows での場所の変更

ArcGIS GeoEvent Server サービスと ArcGIS GeoEvent Gateway Windows サービスを停止します。
ファイルエクスプローラーで、以下のディレクトリにある etc フォルダー内の GeoEvent Gateway 構成ファイルに移動します。

<ArcGIS Server installation directory>\GeoEvent\gateway\etc
テキストエディターで kafka.properties ファイルを開き、プロパティ gateway.data.dir および log.dirs の値を自分の値に更新します。
これらのプロパティのデフォルト値は次のとおりです。
- gateway.data.dir=C://ProgramData//Esri//GeoEvent-Gateway//
- log.dirs= kafka/logs,kafka/logs1,kafka/logs2
注意:

ゲートウェイデータのディレクトリには既存のフォルダーを指定する必要があります。ログディレクトリには、GeoEvent Gateway サービスが再起動されたときに作成されるサブフォルダーのカンマ区切りリストを指定します。

注意:

ArcGIS GeoEvent Server 10.8.1 以前のリリースでは、単一のサブフォルダー kafka/logs が指定されていました。 10.9 以降では、複数のパーティションとトピックが構成されるため、3 つのサブフォルダーを指定する必要があります (kafka/logs,kafka/logs1,kafka/logs2 など)。
kafka.properties ファイルを保存して閉じます。
ファイルエクスプローラーで、以下のディレクトリにある etc フォルダー内の GeoEvent Gateway 構成ファイルに移動します。

<ArcGIS Server installation directory>\GeoEvent\gateway\etc
テキストエディターで zookeeper.properties ファイルを開き、プロパティ gateway.data.dir および data.dir の値を自分の値に更新します。
これらのプロパティのデフォルト値は次のとおりです。
- gateway.data.dir=C://ProgramData//Esri//GeoEvent-Gateway//
- data.dir=zookeeper-data
注意:
ゲートウェイデータのディレクトリには既存のフォルダーを指定する必要があります。データディレクトリには、GeoEvent Gateway サービスが再起動されたときに作成される構成サブフォルダーを指定します。
ファイルエクスプローラーで、以下の場所にある data フォルダーに移動し、そのフォルダー内のファイルとフォルダーを削除します。

<ArcGIS Server installation directory>\GeoEvent\data
ArcGIS GeoEvent Gateway Windows サービスを再起動します。
ArcGIS GeoEvent Gateway が実行を開始するまで数分待ってから、ArcGIS GeoEvent Server Windows サービスを開始します。
ArcGIS GeoEvent Manager を開き、サインインできることを確認します。
以前にカスタムコンポーネントを配置している場合、必要に応じて、*.jar ファイルを以下の場所にある deploy フォルダーに戻します。

<ArcGIS Server installation directory>\GeoEvent\deploy
前の手順で GeoEvent Server の構成をエクスポートした場合、必要に応じて、ArcGIS GeoEvent Manager で [サイト] → [ジオイベント] → [構成ストア] に移動して [構成のインポート] をクリックすることで構成をインポートします。

注意:

GeoEvent Gateway が再起動した後で、指定したゲートウェイデータディレクトリの下に新しいファイルとフォルダーが作成されない場合、ArcGIS GeoEvent Server の実行に使用されているシステムアカウントの権限に問題があり、ArcGIS GeoEvent Gateway は実質的に、指定されたフォルダーへのファイルの読み取り/書き込みができていないことが考えられます。

Linux での場所の変更

ArcGIS GeoEvent Server デーモンと ArcGIS GeoEvent Gateway Linux デーモンを停止します。
以下のディレクトリにある etc フォルダー内の GeoEvent Gateway 構成ファイルに移動します。

<ArcGIS Server installation directory>\GeoEvent\gateway\etc
テキストエディターで kafka.properties ファイルを開き、プロパティ gateway.data.dir および log.dirs の値を自分の値に更新します。
これらのプロパティのデフォルト値は次のとおりです。
- gateway.data.dir=/home/arcgis/.esri/GeoEvent-Gateway
- log.dirs= kafka/logs,kafka/logs1,kafka/logs2
注意:

ゲートウェイデータのディレクトリには既存のフォルダーを指定する必要があります。データディレクトリには、GeoEvent Gateway デーモンが再起動されたときに作成される構成サブフォルダーを指定します。

注意:

ArcGIS GeoEvent Server 10.8.1 以前のリリースでは、単一のサブフォルダー kafka/logs が指定されていました。 10.9 以降では、複数のパーティションとトピックが構成されるため、3 つのサブフォルダーを指定する必要があります (kafka/logs,kafka/logs1,kafka/logs2 など)。
kafka.properties ファイルを保存して閉じます。
以下のディレクトリにある etc フォルダー内の GeoEvent Gateway 構成ファイルに移動します。

<ArcGIS Server installation directory>\GeoEvent\gateway\etc
テキストエディターで zookeeper.properties ファイルを開き、プロパティ gateway.data.dir および data.dir の値を自分の値に更新します。
これらのプロパティのデフォルト値は次のとおりです。
- gateway.data.dir=/home/arcgis/.esri/GeoEvent-Gateway
- data.dir=zookeeper-data
注意:

ゲートウェイデータのディレクトリには既存のフォルダーを指定する必要があります。データディレクトリには、GeoEvent Gateway デーモンが再起動されたときに作成される構成サブフォルダーを指定します。
以下の場所にある data フォルダーに移動し、そのフォルダー内のファイルとフォルダーを削除します。

/home/arcgis/server > rm -rf GeoEvent/data/*
ArcGIS GeoEvent Gateway デーモンを再起動します。
ArcGIS GeoEvent Gateway が実行を開始するまで数分待ってから、ArcGIS GeoEvent Server デーモンを開始します。
ArcGIS GeoEvent Manager を開き、サインインできることを確認します。
以前にカスタムコンポーネントを配置している場合、必要に応じて、*.jar ファイルを以下の場所にある deploy フォルダーに戻します。

<ArcGIS Server installation directory>\GeoEvent\deploy
前の手順で GeoEvent Server の構成をエクスポートした場合、必要に応じて、ArcGIS GeoEvent Manager で [サイト] → [ジオイベント] → [構成ストア] に移動して [構成のインポート] をクリックすることで構成をインポートします。

注意:

その他の注意事項

Kafka オンディスクトピックキューと ZooKeeper 構成ファイルは同じデータディレクトリに配置する必要があります。たとえば、Windows では、Kafka オンディスクトピックキューのデフォルトディレクトリは C:\ProgramData\Esri\GeoEvent-Gateway\kafka\logs、ZooKeeper 構成ファイルのデフォルトディレクトリは C:\ProgramData\Esri\GeoEvent-Gateway\zookeeper-data です。Kafka と ZooKeeper は緊密に連携しているため、これらのランタイムファイルを同じ場所に配置する必要があります。

ArcGIS GeoEvent Server サービスと ArcGIS GeoEvent Gateway サービスは常に相互に通信しています。イベントレコードのデータは、取り込まれ、処理され、配布されるときに Kafka トピックを通過します。 GeoEvent Server によってキャッシュされた構成済みのエレメントと情報のステータスが ZooKeeper 構成ストア内で頻繁に更新されます。

GeoEvent Gateway ランタイムファイルは、ArcGIS GeoEvent Gateway サービス (Windows) または同等のデーモン (Linux) が実行されているサーバー上にローカルに保存する必要があります。これらのファイルをネットワーク共有フォルダーや SAN/NAS に保存しないでください。これらの場所に保存した場合、パフォーマンス、ソリューションの信頼性、安定性が低下します。

このトピックへのフィードバック