Обновление уже установленной версии дистрибутива Логин Центра

Рассмотрим обновление Логин Центра (далее LC) на клиентском сервере.

Подготовка дистрибутива

Если доступ к серверу клиента осуществляется через VPN, сначала подключитесь к сети клиента. Для подключения могут использоваться FortiClient VPN, OpenVPN, Cisco и другие клиенты.

Дистрибутивы Логин Центра находятся в хранилище артефактов Optimacros, в каталоге OM_DISTS/LOGIN_CENTER/builds. Откройте каталог нужной версии. Как правило, каталог актуальной версии имеет наибольший индекс в имени:

Скачайте дистрибутив и расположенный рядом файл с контрольными суммами. В командах ниже login-center-ВЕРСИЯ.sh обозначает файл дистрибутива; замените это имя на фактическое имя скачанного файла.

Перенесите оба файла на целевой сервер, например в каталог /home/имяПользователя. Для передачи можно использовать WinSCP:

Подключитесь к серверу по SSH, например через PuTTY, и перейдите в режим суперпользователя:

sudo su

Проверка дистрибутива

Перейдите в каталог, в который перенесли дистрибутив и файл с контрольными суммами:

cd /home/имяПользователя

Вычислите контрольную сумму дистрибутива алгоритмом, указанным в файле с контрольными суммами. Например, для SHA-256 выполните:

sha256sum login-center-ВЕРСИЯ.sh

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

Подготовка к обновлению

Перейдите в каталог /om/:

cd /om/

В рассматриваемом примере LC и воркспейс установлены на одном сервере. Здесь находятся каталог установленного Логин Центра login-center, каталог воркспейса workspace1 и каталог инсталляторов воркспейса workspace-installer с подкаталогами prev и current.

В prev находятся файлы предыдущей версии дистрибутива, а в current — текущей установленной версии.

До начала обновления LC переведите все подключённые к нему Workspace (далее WS) в сервисный режим. Команды управления WS выполняйте на машине, где установлен соответствующий воркспейс. Если он установлен на другом сервере, подключитесь к этому серверу по SSH. Для перевода в сервисный режим используйте команду управления сервисным режимом с параметром --enable:

cd /om/workspace-installer/
current/install workspace --path /om/workspace1/manifest.json maintenance --enable

Выполните команду для каждого подключённого WS, указав путь к его манифесту. После перевода всех WS в сервисный режим перейдите на машину, где установлен LC, и создайте его резервную копию по инструкции резервного копирования, начиная с раздела «Создание резервной копии». На время резервного копирования и обновления LC все подключённые WS должны оставаться в сервисном режиме.

После создания резервной копии вернитесь к этому руководству.

Обновление Логин Центра

Warning

Если обновление происходит с версии f-1.100.0.0 и ниже, требуется удалить файл docker-compose-Linux-x86_64 в папке где расположен LC и все файлы в папке docker-compose/* иначе обновление произойдет с ошибкой.

Перейдите в каталог с уже загруженным и проверенным дистрибутивом:

cd /home/имяПользователя

Выдайте дистрибутиву права на запуск:

chmod +x login-center-ВЕРСИЯ.sh

Warning

С версии f-1.200.40.108 для хранения чувствительных данных используется .env файл

Warning

Если обновлении с версии ниже f-1.200.40.108 из манифеста автоматически будет выполнена миграция чувствительных данных в .env файл. Тем самым произойдет бесшовная миграция и обновление Логин Центра.

Запустите установщик:

./login-center-ВЕРСИЯ.sh

Если установщик запросит каталог установки, укажите путь к существующему Логин Центру — в данном примере /om/login-center.

Дождитесь завершения установки обновлённой версии Логин Центра:

Warning

Затем вручную потребуется почистить манифест от чувствительных данных.

Возврат воркспейсов в работу и проверка

После завершения обновления LC выведите все подключённые WS из сервисного режима. На машине, где установлен соответствующий WS, выполните команду управления сервисным режимом с параметром --disable:

cd /om/workspace-installer/
current/install workspace --path /om/workspace1/manifest.json maintenance --disable

Выполните команду для каждого WS, указав путь к его манифесту.

Откройте Логин Центр в браузере и проверьте, что отображается новая версия:

Авторизуйтесь под учётной записью администратора и проверьте вход на воркспейс. Чтобы открыть профиль пользователя, снова перейдите по адресу Логин Центра и выберите профиль в правом верхнем углу:

Проверьте доступность всех подключённых WS и работоспособность Optimacros:

На этом обновление Логин Центра завершено.