Измените местоположение файлов данных Kafka и Zookeeper

ArcGIS GeoEvent Gateway использует локальную папку для Apache Kafka очереди тем на диске и файлов конфигурации Apache Zookeeper.

• В Windows директория по умолчанию C:\ProgramData\Esri\GeoEvent-Gateway.
• В Linux директория по умолчанию /home/arcgis/.esri/GeoEvent-Gateway.

При установке ArcGIS GeoEvent Server на диск или по файловому пути, отличному от настроек по умолчанию, GeoEvent Gateway будет использовать папки по умолчанию выше для файлов Kafka и Zookeeper. Это может привести к проблемам, если, например, практика стандартов организации заключается в ограничении доступного пространства на диске С и установке программного обеспечения на другом диске. В этом случае вы можете перенастроить 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 или Определения GeoEvent Definitions настраиваются в GeoEvent Server, выполните следующие шаги для экспорта текущей конфигурации перед тем, как перейти к следующим разделам:

1. Запустите ArcGIS GeoEvent Manager и перейдите к Site > GeoEvent > Хранилище конфигурации.
2. Щелкните Экспорт конфигурации, чтобы создать резервную копию существующей конфигурации.

   Если у вас есть развернутые пользовательские компоненты (коннекторы или процессоры), рекомендуется выполнить следующий шаг, чтобы удалить их из GeoEvent Server перед тем, как перейти к следующему разделу.

3. С помощью запущенного сервиса ArcGIS GeoEvent Server переместите существующие файлы *.jar в папку deploy во временную директорию.

   Папка deploy в директории <ArcGIS Server installation directory>\GeoEvent\deploy.

Измените местоположение на Windows

1. Остановите ArcGIS GeoEvent Server и сервисы ArcGIS GeoEvent Gateway Windows.
2. В Проводнике файлов, перейдите к файлам конфигурации GeoEvent Gateway в папке etc в директории <ArcGIS Server installation directory>\GeoEvent\gateway\etc.
3. Откройте файл 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 настроено несколько разделов и тем, для чего необходимо указать три подпапки (например, kafka/logs,kafka/logs1,kafka/logs2).

4. Сохраните и закройте файл kafka.properties.
5. В Проводнике файлов, перейдите к файлам конфигурации GeoEvent Gateway в папке etc в директории <ArcGIS Server installation directory>\GeoEvent\gateway\etc.
6. Откройте файл zookeeper.properties в текстовом редакторе и измените значения свойств gateway.data.dir и data.dir на подходящие значения.

   Значения по умолчанию для этих свойств приведены ниже:

   • gateway.data.dir=C://ProgramData//Esri//GeoEvent-Gateway//
   • data.dir=zookeeper-data

   Примечание:

   Директория данных шлюза должна указывать существующую папку. Директория данных определяет подпапку конфигурации, которую создает GeoEvent Gateway при перезапуске сервиса.

7. В Проводнике найдите и удалите файлы и папки в папке data в директории <ArcGIS Server installation directory>\GeoEvent\data.
8. Перезапустите сервис ArcGIS GeoEvent Gateway Windows.
9. Подождите несколько минут, пока запустится ArcGIS GeoEvent Gateway, затем запустите сервис ArcGIS GeoEvent Server Windows.
10. Запустите ArcGIS GeoEvent Manager и убедитесь, что вы можете выполнить вход.
11. Дополнительно, если вы развернули пользовательские компоненты, переместите файлы *.jar обратно в папку deploy в директории <ArcGIS Server installation directory>\GeoEvent\deploy:
12. Дополнительно, если вы экспортировали конфигурации GeoEvent Server, импортируйте ее в ArcGIS GeoEvent Manager, перейдя в Site > GeoEvent > Хранилище данных и щелкнув Импорт конфигурации.

Примечание:

Если новые файлы и папки не создаются в указанной директории данных шлюза, то после перезапуска GeoEvent Gateway, скорее всего, возникнет проблема с разрешениями, которая связана с системной учетной записью, используемой для запуска ArcGIS GeoEvent Server, и ArcGIS GeoEvent Gateway не может читать и записывать файлы в указанную папку.

Измените местоположение на Linux

1. Остановите демонов ArcGIS GeoEvent Server и ArcGIS GeoEvent Gateway Linux.
2. Перейдите к файлам конфигурации GeoEvent Gateway в папке etc в директории <ArcGIS Server installation directory>\GeoEvent\gateway\etc.
3. Откройте файл 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 настроено несколько разделов и тем, для чего необходимо указать три подпапки (например, kafka/logs,kafka/logs1,kafka/logs2).

4. Сохраните и закройте файл kafka.properties.
5. Перейдите к файлам конфигурации GeoEvent Gateway в папке etc в директории <ArcGIS Server installation directory>\GeoEvent\gateway\etc.
6. Откройте файл zookeeper.properties в текстовом редакторе и измените значения свойств gateway.data.dir и data.dir на подходящие значения.

   Значения по умолчанию для этих свойств приведены ниже:

   • gateway.data.dir=/home/arcgis/.esri/GeoEvent-Gateway
   • data.dir=zookeeper-data

   Примечание:

   Директория данных шлюза должна указывать существующую папку. Директория данных определяет подпапку конфигурации, которую создает GeoEvent Gateway при перезапуске демона.

7. Найдите и удалите файлы и папки в папке data в директории /home/arcgis/server > rm -rf GeoEvent/data/*.
8. Перезапустите демона ArcGIS GeoEvent Gateway.
9. Подождите несколько минут, пока запустится ArcGIS GeoEvent Gateway, затем запустите демон ArcGIS GeoEvent Server.
10. Запустите ArcGIS GeoEvent Manager и убедитесь, что вы можете выполнить вход.
11. Дополнительно, если вы развернули пользовательские компоненты, переместите файлы *.jar обратно в папку deploy в директории <ArcGIS Server installation directory>\GeoEvent\deploy:
12. Дополнительно, если вы экспортировали конфигурации GeoEvent Server, импортируйте ее в ArcGIS GeoEvent Manager, перейдя в Site > GeoEvent > Хранилище данных и щелкнув Импорт конфигурации.

Примечание:

Если новые файлы и папки не создаются в указанной директории данных шлюза после перезапуска GeoEvent Gateway, вероятно, это вследствие проблемы с разрешениями системной учетной записи, используемой для запуска ArcGIS GeoEvent Server, и ArcGIS GeoEvent Gateway не может читать и записывать файлы в указанную папку.

Дополнительные условия

Местоположение очереди тем на диске 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, это повлияет на производительность, надежность и стабильность решения.