Обновление продукта «Форсайт. Мобильная платформа»

Перед обновлением продукта «Форсайт. Мобильная платформа» на сервере хосте проверьте выполнение условий:

• продукт «Форсайт. Мобильная платформа» установлен;

• все действия выполняются под учетной записью, входящей в группу Docker;

• утилиты unzip, wget и docker-compose установлены;

• на жестком диске доступно не менее 10ГБ свободного места;

• версия сервера мобильной платформы совпадает с версией Relay-сервера, если он был установлен.

Для обновления продукта «Форсайт. Мобильная платформа» версии 23.05 используйте файл README.md, содержащийся в архиве standalone_compose_files_v23.12.03.zip.

Примечание. Для получения архива обратитесь в техническую поддержку по адресу support@fsight.ru или через сервисы технической поддержки, которые доступны после регистрации на сайте.

Процесс обновления других версий продукта «Форсайт. Мобильная платформа» отличается:

• обновление продукта версии 22.04;

• обновление продукта версии 21.04;

• обновление продукта версии 20.10 и ниже.

При обновлении продукта предыдущие логи будут недоступны.

Важно. Для обновления продукта «Форсайт. Мобильная платформа» до последней версии последовательно обновите мобильную платформу на каждую старшую версию.

Обновление продукта версии 22.04

Для обновления продукта версии 22.04:

1. Скачайте новые версии образов и файлов на сервер мобильной платформы. Распакуйте архив:

% unzip standalone_compose_files_v22.04.<порядковый номер версии>.zip

2. Выполните загрузку новых образов в локальное хранилище:

% docker load -i standalone_images_v22.04.<порядковый номер версии>.tgz

После выполнения действия в локальном хранилище будут содержаться файлы docker-compose.standalone.yaml и .env новой версии.

3. Измените параметр SERVER_NAME в файле .env, если доменное имя сервера отлично от «localhost»:

SERVER_NAME = <IP-адрес или DNS-имя сервера>

Для указания нескольких имён сервера используйте пробел, например:

SERVER_NAME = 127.0.0.1 localhost

4. Откройте файл update_standalone.py и задайте параметры:

• OLD_VERSION_COMPOSE_PATH. Укажите путь до файлов docker-compose.standalone.yaml и .env старой версии;

• NEW_VERSION_COMPOSE_PATH. Укажите путь до файлов docker-compose.standalone.yaml и .env новой версии;

• UP_TIMEOUT. При необходимости задайте время ожидания в секундах после запуска новой версии мобильной платформы до начала загрузки файлов в MinIO.

Пример файла update_standalone.py, содержащего заданные параметры:

py
OLD_VERSION_COMPOSE_PATH=./old_version
NEW_VERSION_COMPOSE_PATH=./new_version

Структура файлов, соответствующая заданным параметрам в примере:

~
│
└───old_version
│ │ docker-compose.standalone.yaml
│ │ .env
│
└───new_version
│ docker-compose.standalone.yaml
│ .env
│ update_standalone.py

5. Запустите на выполнение файл update_standalone.py с помощью Python версии 3.6 и выше:

python3 update_standalone.py

После выполнения действий будет выдано сообщение об успешной загрузки файлов в MinIO и продукт «Форсайт. Мобильная платформа» будет обновлен до последней версии.

Обновление продукта версии 21.04

Для обновления продукта версии 21.04:

1. Скачайте новые версии образов и файлов на сервер мобильной платформы. Распакуйте архив:

% unzip standalone_compose_files_v21.04.01.zip

2. Выполните загрузку новых образов в локальное хранилище:

% docker load -i standalone_images_v21.04.01.tgz

После выполнения действия в локальном хранилище будут содержаться файлы docker-compose.standalone.yaml и .env новой версии.

3. Откройте файл update_standalone.py и задайте параметры:

• OLD_VERSION_COMPOSE_PATH. Укажите путь до файлов docker-compose.standalone.yaml и .env старой версии;

• NEW_VERSION_COMPOSE_PATH. Укажите путь до файлов docker-compose.standalone.yaml и .env новой версии;

• UP_TIMEOUT. При необходимости задайте время ожидания в секундах после запуска новой версии мобильной платформы до начала загрузки файлов в MinIO.

Пример файла update_standalone.py, содержащего заданные параметры:

py
OLD_VERSION_COMPOSE_PATH=./old_version
NEW_VERSION_COMPOSE_PATH=./new_version

Структура файлов, соответствующая заданным параметрам в примере:

~
│
└───old_version
│ │ docker-compose.standalone.yaml
│ │ .env
│
└───new_version
│ docker-compose.standalone.yaml
│ .env
│ update_standalone.py

4. Запустите на выполнение файл update_standalone.py с помощью Python версии 3.6 и выше:

python3 update_standalone.py

После выполнения действий будет выдано сообщение об успешной загрузки файлов в MinIO и продукт «Форсайт. Мобильная платформа» будет обновлен до последней версии.

Обновление продукта версии 20.10 и ниже

Для обновления продукта версии 20.10 и ниже, а так же подсистемы Docker, развернутой на сервере:

1. Перейдите в каталог с файлом docker-compose.standalone.yml от текущей установки на сервере хосте и выполните остановку текущей версии платформы:

% docker-compose -f docker-compose.standalone.yml down

После успешной остановки платформы удалите существующие образы:

% docker image rm $(docker image ls -q)

2. Удалите файлы предыдущей установки:

• .env;

• docker-compose.standalone.yml.

3. Скачайте новые версии образов и файлов на сервер мобильной платформы. Распакуйте архив:

% unzip compose_files_v20.10.06.zip

4. Выполните загрузку новых образов в локальное хранилище:

# загрузка
% docker load -i fmp_v20.10.06.tgz

# удаление архива
% rm -rf fmp_v20.10.06.tgz

5. Выполните команды для последовательного обновления продукта с версии 18.04 на 19.03:

Примечание. Обновление продукта доступно с версии 18.04. При обновлении продукта с версии 19.03 на версию 20.10 пропустите данный шаг.

• при обновлении продукта с версии 18.04 на версию 18.09:

% docker-compose -f docker-compose.standalone.yml run --rm -u root hhive sed -i 's|/var/hhive/static|/var/hh_static/static|g' /var/hhive/nginx/includes/dashboard.inc

• при обновлении продукта с версии 18.09 на версию 18.12 и с версии 18.12 на версию 19.03:

% docker-compose -f docker-compose.standalone.yml run --rm hhive bash -c 'mkdir -p /var/hhive/ssh/ /var/hhive/supervisor/ && touch /var/hhive/ssh/ssh_conf_relay /var/hhive/supervisor/supervisor_ssh.conf'

6. Выполните команду для удаления статических элементов от прошлой сборки:

% docker volume rm hyperhive_var_static

7. Обновите версию продукта «Форсайт. Мобильная платформа»:

% docker-compose -f docker-compose.standalone.yml up

После выполнения действий продукт «Форсайт. Мобильная платформа» будет обновлен до последней версии.