Развертывание кластера

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

Для развертывания кластера Active/Active/NoDB+ExternalFS необходимо выполнить следующие действия:

  1. перед запуском утилиты iva-cli на всех головных серверах, медиасерверах и серверах базы данных, на которых в качестве базы данных используется программное обеспечение компании IVA Technologies, необходимо выполнить команду:

    sudo iva-cli configurator unlock
  2. запустить процесс сборки кластера, выполнив следующий скрипт на одном из головных серверов:

    sudo iva-cli cluster2 configure \
      --public-ip <PUBLIC_IP> \
      --database-ip <DATABASE_IP> \
      --head-node-ip <HEAD_NODE_IP> \
      --media-node-ip <MEDIA_NODE_IP> \
      --external-database-host <EXTERNAL_DATABASE_HOST> \
      --external-database-port <EXTERNAL_DATABASE_PORT> \
      --external-database-name <EXTERNAL_DATABASE_NAME> \
      --external-database-username <EXTERNAL_DATABASE_USERNAME> \
      --external-database-password <EXTERNAL_DATABASE_PASSWORD> \
      --external-filestorage-device <EXTERNAL_FILESTORAGE_DEVICE> \
      --external-filestorage-domain <EXTERNAL_FILESTORAGE_DOMAIN> \
      --external-filestorage-username <EXTERNAL_FILESTORAGE_USERNAME> \
      --external-filestorage-password <EXTERNAL_FILESTORAGE_PASSWORD> \
      --disable-local-media-service

    где:

    • <PUBLIC_IP> — плавающий IP-адрес, по которому доступен web-интерфейс и SIP- / H.323-сигнализация (обязательный параметр)

    • <DATABASE_IP> — IP-адрес внешнего сервера базы данных (опциональный параметр, указывается для внешней базы данных, установленной с помощью программного обеспечения компании IVA Technologies)

    • <HEAD_NODE_IP> — IP-адрес головного сервера (обязательный параметр)

    • <MEDIA_NODE_IP> — IP-адрес медиасервера (опциональный параметр, рекомендуется добавлять медиасервера к кластеру головных серверов)

    • <EXTERNAL_DATABASE_HOST> — IP-адрес внешнего сервера базы данных (опциональный параметр, указывается для внешней базы данных, не установленной с помощью программного обеспечения компании IVA Technologies)

    • <EXTERNAL_DATABASE_PORT> — порт внешнего сервера базы данных (опциональный параметр, указывается для внешней базы данных, не установленной с помощью программного обеспечения компании IVA Technologies)

    • <EXTERNAL_DATABASE_NAME> — название внешней базы данных (опциональный параметр, указывается для внешней базы данных, не установленной с помощью программного обеспечения компании IVA Technologies)

    • <EXTERNAL_DATABASE_USERNAME> — имя пользователя, используемое для доступа к внешней базе данных (опциональный параметр, указывается для внешней базы данных, не установленной с помощью программного обеспечения компании IVA Technologies)

    • <EXTERNAL_DATABASE_PASSWORD> — пароль пользователя, используемый для доступа к внешней базе данных (опциональный параметр, указывается для внешней базы данных, не установленной с помощью программного обеспечения компании IVA Technologies)

    • <EXTERNAL_FILESTORAGE_DEVICE> — URI внешнего файлового хранилища (обязательный параметр)

      Адреса внешних файловых хранилищ указываются в следующем формате:

      • при использовании NFS: nfs://<IP-адрес>:/path_to_share или <IP‑адрес>:/path_to_share

      • при использовании CIFS / SMB: //<IP-адрес>/share_name

    • <EXTERNAL_FILESTORAGE_DOMAIN> — доменное имя внешнего файлового хранилища (опциональный параметр, указывается при наличии доменного имени внешнего файлового хранилища)

    • <EXTERNAL_FILESTORAGE_USERNAME> — имя пользователя, используемое для аутентификации на внешнем файловом хранилище (опциональный параметр, указывается, если требуется аутентификация на внешнем файловом хранилище)

    • <EXTERNAL_FILESTORAGE_PASSWORD> — пароль пользователя, используемый для аутентификации на внешнем файловом хранилище (опциональный параметр, указывается, если требуется аутентификация на внешнем файловом хранилище)

    • disable-local-media-service — ключ, выключающий медиасервисы на головных серверах (опциональный параметр, рекомендуется отключать медиасервисы на головных серверах)

      Команда sudo iva-cli cluster2 configure является идемпотентной (может выполняться много раз без последствий для сервера) и приводит кластер в указанное состояние

      При сборке кластера Active/Active/NoDB+ExternalFS необходимо указывать один из ключей:

      --database-ip <DATABASE_IP>

      или

      --external‑database‑host <EXTERNAL_DATABASE_HOST>

      При указании ключа --external‑database‑host <EXTERNAL_DATABASE_HOST> необходимо дополнительно указывать следующие ключи:

      --external-database-port <EXTERNAL_DATABASE_PORT> \
      --external-database-name <EXTERNAL_DATABASE_NAME> \
      --external-database-username <EXTERNAL_DATABASE_USERNAME> \
      --external-database-password <EXTERNAL_DATABASE_PASSWORD> \
      После последнего ключа не ставится символ обратный слеш (\)

      Если к кластеру подключается одновременно несколько головных или медиасерверов, то данные серверы необходимо указывать подряд без добавления порядкового номера, например:

      --media-node-ip 10.10.10.10 \
      --media-node-ip 10.10.10.11 \
      --media-node-ip 10.10.10.12

      или

      --head-node-ip 10.10.10.13 \
      --head-node-ip 10.10.10.14
      В качестве внешней СУБД поддерживается PostgreSQL версии 9.6 и выше (включая PostgreSQL Pro)
  3. сохранить изменения на головных серверах, медиасерверах и сервере базы данных, выполнив команду:

    sudo iva-cli live save-changes
    Если программное обеспечение компании IVA Technologies установлено на серверы с ОС Astra Linux, то команду sudo iva-cli live save-changes выполнять не требуется
  4. после завершения настройки выполнить команду:

    sudo iva-cli configurator lock
    Команду необходимо выполнять на всех серверах, установленных с помощью программного обеспечения компании IVA Technologies
    Если команда sudo iva-cli configurator lock не была запущена, то она автоматически выполнится через 1 час после завершения настройки