Установка и настройка утилиты

Установка

1. Скачайте два исполняемых файла утилиты (updater и clear_dict) с FS https://fs.hflabs.ru/%ваш_спейс%/updater/ — если такой папки в вашем спейсе ещё нет, обратитесь в поддержку

2. Переместите их в директорию «Апдейтера» и выдайте права на выполнение

   # Перемещаем исполняемые файлы (если загрузили их директорию /tmp)
   mv /tmp/updater /opt/updater/
   mv /tmp/clear_dict /opt/updater/
   
   # Устанавливаем владельца
   chown updater: /opt/updater/updater
   chown updater: /opt/updater/clear_dict
   
   # Выдаем права
   chmod 755 /opt/updater/updater
   chmod 755 /opt/updater/clear_dict

Настройка

Для работы утилите надо знать базовый путь к справочникам, а также пользователя, под которым они работают. Настройки указываются в файле updater.env. 
Сгенерировать умолчательный конфиг для изменения можно с помощью команды:

su - updater
cd /opt/updater
./updater generate config

Команда может выдать ошибку — INFO error applying migration script, already applied: alter table event add uuid text not null default. Это нестрашно, файл всё равно создастся.

Будет создан файл конфигурации приложения config, который нужно переименовать в updater.env.
В нём необходимо оставить настройки только для необходимых вам продуктов:

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

unset ARTIFACTORY_HOST
unset FACTOR_DICTIONARY_HOME
unset FACTOR_USERNAME
unset FACTOR_BUILD
unset SUGGESTIONS_DICTIONARY_HOME
unset SUGGESTIONS_USERNAME
unset SUGGESTIONS_API_PORT
unset CDI_DICTIONARY_HOME
unset CDI_USERNAME
unset CDI_API_USERNAME
unset CDI_API_PASSWORD
unset CDI_API_PORT

Для базовых справочников дополнительных настроек не требуются, они настроены по умолчанию.
Но если используются внешние справочники (или требуется изменить настройки базовых), то их необходимо добавить в конфиг dictionaries.json
Сгенерировать файл конфигурации справочников для изменения можно командой:

su - updater
cd /opt/updater
./updater generate dicts

Будет создан файл конфигурации справочников dicts, который нужно переименовать в dictionaries.json.