Установка Логин Центра на клиентский сервер¶

Получение дистрибутива¶

LC на платформе Docker разворачивается на предварительно установленном Docker. При запуске инсталлятора он получает передаваемые параметры и пытается найти необходимые ему для дальнейшей инсталляции обязательные пути, файлы, а также проверяет наличие версий LC, установленных предыдущим инсталлятором, и выполняет импорт настроек приложения.

Предварительная подготовка¶

Подключаемся к серверу через ssh протокол.

Переходим в аккаунт root с помощью команды:

sudo su

Затем скачиваем дистрибутив Логин Центра через терминал. Если предоставлена прямая ссылка на nextcloud optimacros то с помощью команды:

wget <direct_link>/download -O ИМЯ_ФАЙЛА.С_РАСШИРЕНИЕМ

clean_install_1

Warning

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

Переходим в директории с файлом (как правило, это /om/workspace1) и выполняем команду cat manifest.json

После того как мы удостоверились что находимся на нужном сервере (например TEST или PROD) завершаем работу воркспейса.

install_docker_2

Далее нам необходимо установить на сервере docker. Устанавливаем его, следуя инструкции c официального сайта, для соответствующей Операционной Системы, согласно инструкции по предварительной установке:

Версия docker не имеет принципиального значения. Устанавливаем самую актуальную на момент установки.

Warning

Установка Docker в системе РЭД ОС имеет нюансы. Смотрите подробнее...

Интерактивная установка LC¶

Далее мы подготавливаем необходимые директории на сервере под Логин Центр.

Warning

Внимание, для установки ЛЦ на один сервер с воркспейсом шаги будут отличаться, необходимо ознакомиться с инструкцией по совместной установке далее по тексту рассматривается инструкция по отдельной установке ЛЦ

Для этого переходим в папку om с помощью команды:

cd /om

Создаём там необходимые директории login-center с помощью команды:

mkdir -p login-center/data/nginx/cert

Далее нам необходимо заполнить manifest. Пример заполнения:

vim /om/login-center/manifest.yml

Описание полей manifest.yml файла

install_docker_3

Для поля пароля базы данных (mongo.dbPassword), с помощью любого генератора паролей, сгенерируйте надёжный пароль длиной не более 20 символов.

Warning

Важно: пароль не должен содержать символов @:;/% - это приведет к багу установки.

Также необходимо сгенерировать пароли для полей секции nats - password и systemPassword. Их длина должна быть не менее  22 символов.

Поле publicHostname в секции main должно быть заполнено значением доменного имени сервера, где будет работать LC вместо "defaulthost.com".

После подготовки манифеста или env файла, нам необходимо положить ssl-сертификаты в директорию /om/login-center/data/nginx/cert, Файлы должны называться bundle.crt и crt.key соответственно. Если у вас уже есть заранее подготовленные сертификаты, переименовываем их и помещаем в нужную директорию. Например:

mv /home/username/company-certificate.crt /om/login-center/data/nginx/cert/bundle.crt
mv /home/username/company-certificate-key.key /om/login-center/data/nginx/cert/crt.key

Либо можно сгенерировать самоподписанные сертификаты:

cd /om/login-center/data/nginx/cert/
openssl req -newkey rsa:2048 -nodes -keyout crt.key -x509 -days 1095 -out bundle.crt

Отвечаем на вопросы, которые задаст программа генерации.

Теперь когда мы подготовили директорию для установки Логин Центра, манифест или env, сертификаты, и скачали дистрибутив, нам необходимо будет установить его. Для этого переходим в директорию со скачанным ранее дистрибутивом, например, с помощью команды:

cd /home/username

Выдаём файлу права с помощью команды

chmod +x login-center-версия.sh

В зависимости от версии ЛЦ, имя инсталлятора может отличаться. Например: installer-f-1.100.0.0.sh или login-center-1.12.sh

Запускаем инсталлятор с помощью команды:

./login-center-версия.sh

Во время установки инсталлятор запросит путь для установки у пользователя интерактивно. По умолчанию путь для установки /opt/om/login-center, мы меняем на ту, которую мы подготовили (/om/login-center).

install_docker_4

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

install_docker_5

Затем увидим вот такую консоль, это значит что Логин Центр успешно установлен:

install_docker_6

или

install_docker_7

Можно проверять результат установки в браузере введя имя хоста нашего логин центра.

Автоматизированная установка LC на платформе Docker¶

Для автоматизированной установки LC необходимо, чтобы на сервере, где производится установка уже была папка, где будет установлен LC.

В папке установки должна присутствовать вложенная папка data/nginx/cert, в которой должны быть файлы сертификатов bundle.crt и crt.key.

В папке установки должен находиться файл манифеста manifest.yml с заполненными полями.

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

./installer.версия.sh -- -p docker -d путь_установки

При этих условиях инсталлятор распакует Docker образы и запустит LC автоматически, не прерываясь и не задавая вопросов.

Возможные ошибки¶

Инсталлятор выдаёт ошибку со следующим содержимым:

Это говорит о том, что по заданным путям отсутствуют файлы сертификатов. Затем мы переходим в директорию, где лежит Логин Центр

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

Значит необходимо заполнить файл manifest.yml следуя шаблону, который описан выше.
Инсталлятор, выдаёт предупреждение, со следующим содержимым:

Возможно была опечатка в пути установки. Либо последний сохранённый путь установки ошибочный. Проверить и/или изменить его можно в файле: /var/lib/login-center/optimacros_lc.

Варианты решений:
- Запустить инсталлятор в стандартом режиме и указать путь установки, когда данный путь появится на экране.
- Очистить или изменить на нужное значение, файл /var/lib/login-center/optimacros_lc.