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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

% unzip standalone_compose_files_v22.04.01.zip

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

% docker load -i fmp_v22.04.01.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 fmp_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 standalone_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

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