Руководство по установке#

Импорт данных — это сервисное приложение для обработки и импорта данных из различных источников в Систему.

Развёртывание модуля#

Установка импортёра производится с помощью Ansible. См. Обновление и установка Системы с использованием Ansible.

Предварительно необходимо установить средства поддержки Docker и Docker-compose. См. Установка и обновление средств поддержки Docker.

В установочном yml-файле конфигурации укажите следующие параметры:

Переменные, которые являются обязательными к изменению#

Обязательная к изменению

Название переменной

Значение по умолчанию

Описание переменной

gvEMERALD_INSTALL_DIR

/opt/Emerald

Директория, в которой будет развернут ипмортер данных Emerald

gvEMERALD_EXTERNAL_PORT

6000

Внешний порт, по которому будет доступен ипмортер данных Emerald

треугольник

gvEMERALD_NGINX_ENABLE

true

Необходимость в создании конфигурационного файла для Nginx’а. Возможные значения: true или false

gvEMERALD_PUBLIC_ORIGIN

https://emerald-{{ gvNGINX_FQDN }}

URL-адрес, по которому доступен ВЕБ-интерфейс Emerald

gvEMERALD_GEOMETA_DNS_NAME

{{ gvNGINX_FQDN }}

URL-адрес, по которому доступен ВЕБ-интерфейс Geometa. По умолчанию используется значение, указанное в переменной gvNGINX_FQDN

треугольник

gvEMERALD_GEOMETA_IP

10.4.1.52

IP-адрес виртуальной машины на которой установлена Geometa

gvEMERALD_CONNECTION_STRING

Server={{ gvPOSTGRESQL_SERVER }};Port={{ gvPOSTGRESQL_PORT }};Database={{ gvPOSTGRESQL_IAS_DB_NAME }};User Id={{ gvPOSTGRESQL_IAS_USER }};Password={{ gvPOSTGRESQL_IAS_USER_PASS }};ApplicationName=Emerald;

Строка подключения к БД. Данная строка формируется автоматически на основе ранее указанных параметров (используется импорт переменных), без необходимости не корректируйте значение данной переменной!

gvEMERALD_NGINX_SSL_CERT_FILE

{ gvNGINX_SSL_CERTS_FILE_NAME }}

Имя файла SSL сертификата, который должен быть в хостовой системе, по пути /etc/ssl/certs. По умолчанию используется значение, указанное в переменной gvNGINX_SSL_CERTS_FILE_NAME

gvEMERALD_NGINX_SSL_CERT_KEY_FILE

{{ gvNGINX_SSL_CERTS_PRIVATE_KEY_NAME }}

Имя файла приватоного ключа для SSL сертификата, который должен быть в хостовой системе, по пути /etc/ssl/private. По умолчанию используется значение, указанное в переменной gvNGINX_SSL_CERTS_FILE_NAME

gvEMERALD_GEOMETA_SSL_CERTS_FOLDER

/etc/ssl/certs

Путь до директории, в которой расположены SSL сертификаты

gvEMERALD_FILE_RETENTION

14400

Время в секундах, по истечении которого файлы считаются устаревшими и могут быть удалены службой очистки

gvEMERALD_RUN_CLEANUP

1440

Интервал запуска службы очистки временных файлов задач импорта (в секундах)

Cостав сборки определяется в JSON файле утилитой ProjectPackageBuilder.

Перечень компонентов для импортёра в JSON файле:

[
  "Geometa",
  "Emerald.Service",
  "Module.Emerald.Plugins.Gml",
  "Module.Emerald.Plugins.Csv",
  "Module.Emerald.Plugins.Excel",
  "Module.Emerald.Plugins.Mif",
  "Module.Emerald.Plugins.Tab",
  "Module.Emerald.Plugins.Gpx",
  "Module.Emerald.Plugins.Kml",
  "Module.Emerald.Plugins.Shp"
]

После развёртывания модуля перезапустите STS.

Примечание

Для увелечения быстродействия импорта данных необходимо использовать функцию sist_import.