Переход со старой python версии Апдейтера

Установка и настройка

1. Сохраните копию старой утилиты, например в /tmp, после чего очистите корневой каталог утилиты

   cp -r /opt/updater /tmp
   rm -R  /opt/updater/*

2. Для директорий справочников приложений выдайте права 777 и SGID бит, пути к справочникам можно посмотреть в файлах конфигурации старой утилиты (/tmp/updater/updater.env или /tmp/updater/custom.env):

   chmod -R 2777 /opt/suggestions/appserver/dictionaries

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

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

   # Перемещаем исполняемые файлы (если загрузили их директорию /tmp)
   mv /tmp/{updater, 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

5. Скопируйте файл updater.env из старой версии утилиты

   cp /tmp/updater.env /opt/updater

6. Оставьте в нём только строки с переменными из списка ниже:

    Click here to expand...

   FACTOR_DICTIONARY_HOME
   FACTOR_USERNAME
   
   SUGGESTIONS_DICTIONARY_HOME
   SUGGESTIONS_USERNAME
   SUGGESTIONS_API_PORT
   
   CDI_DICTIONARY_HOME
   CDI_USERNAME
   CDI_API_USERNAME
   CDI_API_PASSWORD
   CDI_API_PORT

7. Укажите значения для недостающих обязательных настроек:

    Click here to expand...

   updater.env

   # Логин и пароль для авторизации в Artifactory (если у вас их нет, обратитесь в поддержку)"
   ARTIFACTORY_LOGIN="..."
   ARTIFACTORY_PASSWORD="..."
   
   
   # Использовать ли команду chown для изменения прав (по умолчанию false)
   WITH_ROOT="false"
   
   
   # Хост, на котором работает API Фактора (если отличается от localhost)
   FACTOR_API_HOST="..."
   
   # Порт, на котором работает API Фактора 
   FACTOR_API_PORT="..."
   
   # Имя заказчика в адресе к Фактору http://host:18080/factor-service-<имя заказчика>
   FACTOR_API_TAG="..."
   
   
   # Хост, на котором работает API Подсказок (если отличается от localhost)
   SUGGESTIONS_API_HOST="..."
   
   # Пароль пользователя API Подсказок (если включена авторизация в админку)
   SUGGESTIONS_API_PASSWORD="..."
   
   
   # Хост, на котором работает API Единого клиента (если отличается от localhost)
   CDI_API_HOST="..."

8. Если необходимо, укажите значения для дополнительных настроек:

    Click here to expand...

   updater.env

   # Путь к Artifactory по умолчанию:
   # ARTIFACTORY_PATH="https://maven.hflabs.ru/artifactory/repo"
   # Если есть локальное зеркало Artifactory, достаточно раскрыть эту переменную,
   # чтобы Апдейтер переключился с maven.hflabs.ru на локальное зеркало, например:
   # ARTIFACTORY_PATH="http://maven.mycorp.ru/artifactory/hflabs-maven-remote"
   
   
   # Управление проверкой сертификата Artifactory.
   # По умолчанию значение true.
   CHECK_CERTIFICATE = "..."
   
   # Ограничивает скорость скачивания словарей (указывается в килобайтах в секунду).
   # Значение по умолчанию - 0 (без ограничений).
   DOWNLOAD_RATE_LIMIT=0
   
   # Настройки подключения к прокси-серверу в формате 'http://user:password@ipaddress:port'
   HTTP_PROXY='http://...'
   # Уровень логирования - ERROR, WARN, INFO, DEBUG (по умолчанию INFO)
   LOGGING_LEVEL="INFO"
   
   # Включение HTTPS протокола отдельно для каждого из продуктов
   CDI_HTTPS="true"
   FACTOR_HTTPS="true"
   SUGGESTIONS_HTTPS="true"

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

    unset_env.sh

   unset ARTIFACTORY_PATH
   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

10. Если используются внешние справочники Подсказок, то они будут работать по умолчанию, но с одним условием — перед названием обязательно указывается тэг продукта, например: suggestions_car_brand

11. Если у вас была настроена загрузка справочников по расписанию, то пришлите, пожалуйста, все ваши .sh скрипты нам на почту. Мы конвертируем их в формат нового «Апдейтера» и вернем их вам обратно.

12. Замените старые скрипты на конвертированные из пункта выше, после чего из cron-расписания на сервере (редактируется командой «crontab -e») удалите часть с "&& . /opt/updater/updater.env".

     Пример

    Было:

    00 21 * * 6  cd /opt/updater && . /opt/updater/updater.env && /opt/updater/download-dictionaries.sh
    00 01 * * 0  cd /opt/updater && . /opt/updater/updater.env && /opt/updater/update-dictionaries.sh

    Стало:

    00 21 * * 6  cd /opt/updater && /opt/updater/download-dictionaries.sh
    00 01 * * 0  cd /opt/updater && /opt/updater/update-dictionaries.sh