Изменение параметров установленного Логин Центра

В случае необходимости изменения адреса Логин Центра, для начала следует остановить работу воркспейса. Это можно сделать при помощи команды:

/om/workspace-installer/current/install workspace --path /om/workspace1/manifest.json shutdown

Далее нам необходимо изменить данные manifest.yml файле для правильной работы nginx, за которым стоит сам Login Center. Для этого перейдём в директорию с Логин Центром с помощью команды:

cd /om/login-center/

Затем остановим работу Логин Центра с помощью команды om:

./manage stop

В директории с Логин Центром находится файл manifest.yml, можем посмотреть его содержимое с помощью команды:

cat manifest.yml

main:
  app: "login-center"
  version: "s-1.200.27.0"
  publicHostname: "dist.advexcel.tech"
initialization:
  adminUsername: "admin@optimacros.com"
  adminPassword: "login-center"
  firstWorkspaceName: "Test"
  firstWorkspaceHostname: "workspace1"
  allowUIAddUsers: true
mongo:
  version: "4.4.21"
  dbUsername: "login-center"
  dbPassword: "login-center"
redis:
  version: "6.2-alpine"
nginx:
  version: "1.24.0"
  workspaceProxyUrl: "http://10.0.3.15"
exportService:
  allowExport: ""
constraints:
  concurrentSessionsLimit: "0" # if 0 or not set => no limit
syslog:
  enabled: "true"
  messageFormat: "RFC5424"
  eventsStoreInMinutes: "3"
  sendEverySeconds: "15"
  hostIp: ""
  port: "6514"
  rootCaPath: ""
  clientCertPath: ""
  clientKeyPath: ""
  hostId: ""
nats:
  password: "pass" # пароль > 22 символов
  systemPassword: "pass" # пароль > 22 символов
node:
  extraCaCerts: ""

Теперь для изменения данных Логин Центра, нам нужно изменить соответствующие поля, инструкция с обозначениями полей ниже.

Более подробное описание полей можно посмотреть тут: описание полей manifest.yml Чтобы отредактировать файл manifest.yml воспользуйтесь командой:

vim manifest.yml

Затем сохраняем изменения.

Далее в случае смены адреса Логин Центра нам необходимо изменить manifest файл воркспейса.

Note

Тут надо не путать manifest файл воркспейса и логин центра. Как минимум они имеют разный формат. Для параметров воркспейса используется файл manifest.json, а для логин центра manifest.yml. Естественно каждый их этих файлов имеет свои заданные поля для конфигурации соответствующего приложения.

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

cd /om/workspace1/

Находясь в этой директории, мы можем открыть для редактирования файл манифеста с помощью команды:

nano manifest.json

Этот файл выглядит примерно вот так.

{
  "container": {
    "ip": "10.0.3.15",
    "cpu": 6,
    "memory": 33685016576,
    "ports": {},
    "hosts": {},
  },
  "workspace": {
    "id": "8522aedecc6b4219ee87ee28",
    "name": "TEST",
    "web": {
      "url": "https://om.test.workspace.ru"
    },
    "loginCenter": {
      "url": "https://lc.company.ru/", // <= Интересующее нас поле в случае смены адреса Логин Центра
      "token": "4aed337a0ac34dd13716c476a4c7",
      "apiUrl": "wss://lc.company.ru/api/ws/v1/" // <= Интересующее нас поле в случае смены адреса Логин Центра
    },
    "admin": {
      "email": "admin@optimacros.com"
    }
  }
}

Нам нужно отредактировать поля Логин Центра, в частности url и apiUrl. После редактирования, файл манифеста будет иметь примерно такой вид.

{
  "container": {
    "ip": "10.0.3.15",
    "cpu": 6,
    "memory": 33685016576,
    "ports": {},
    "hosts": {},
  },
  "workspace": {
    "id": "8522aedecc6b4219ee87ee28",
    "name": "TEST",
    "web": {
      "url": "https://om.test.workspace.ru"
    },
    "loginCenter": {
      "url": "https://новыйАдрес/",
      "token": "4aed337a0ac34dd13716c476a4c7",
      "apiUrl": "wss://новыйАдрес/api/ws/v1/"
    },
    "admin": {
      "email": "admin@optimacros.com"
    }
  }
}

После этого нам остаётся вновь запустить Логин Центр и возобновить работу воркспейса. Переходим в директорию Логин Центра с помощью команды:

cd /om/login-center/

Так как мы меняли параметры в manifest.yml логин центра, требуется выполнить повторную генерацию файлов docker compose для логин центра. Для этого следует выполнить скрипт:

./configure.sh

Note

Если запускается configure.sh выполнять команды для остановки и запуска логин центра (./manage stop и ./manage start) не требуется. Как будет видно при запуске этого скрипта, все контейнеры логин центра будут остановлены, затем пройдет обновление файлов конфигураций с новыми параметрами из манифеста, и после этого логин центр будет запущен.

Затем запускаем работу воркспейса командой:

/om/workspace-installer/current/install workspace --path /om/workspace1/manifest.json up

Дожидаемся такого вывода терминала:

И так же в случае смены адреса Логин Центра, обязательно нужно изменить параметр webroot на странице конфигурации Login Center (по адресу http://.../admin/config/urls) для правильных ссылок, отправляемых в email письмах о сбросе пароля и приглашении новых пользователей.

Warning

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

• Если вы меняете только имя хоста и у вас стоит для логин центра wildcard сертификат, то естественно этот сертификат подходит для любого имени в данном домене.
• Если ваш сертификат выдан на конкретный url или у вас меняется домен логин центра, потребуется замена сертификата.

Это важно учесть при планировании миграции сервера на новое имя или домен.