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

Местоположение файлов данных 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. Это может привести к проблемам, если, например, практика стандартов организации заключается в ограничении доступного пространства на диске С и установке программного обеспечения на другом диске. В этом случае вам может потребоваться перенастроить 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 и перейдите к Сайт > 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, перейдя в раздел Сайт > 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, перейдя в раздел Сайт > 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, это повлияет на производительность, надежность и стабильность решения.