Установка ПО "МТС Линк Чаты"

Руководство по установке on-premise версии

Подготовка сервера

Требования к операционной системе и оборудованию

Для установки требуется Linux-сервер версии DEB-based Linux Debian 11 (Bullseye). Обязательно должны быть установлены все текущие обновления.

В процессе установки ПО разворачивается на предварительно подготовленном сервере, который обеспечивает работу его основных частей: программного кода, баз данных и других внутренних сервисов.


В таблице приведены требования к производительности сервера и сети в зависимости от максимального количества одновременных пользователей:

Количество одновременных пользователейvCPURAMSSDПараметры сети
500016 vCPU32 GBОт 1 Tb
(в зависимости от активности использования ПО)
1-10 Gbit/s
(в зависимости от количества одновременных пользователей)


Настройка доменов

К IP-адресу сервера требуется привязать четыре домена — главную страницу и хосты служебных сервисов:

IP-адресДомен
IP-адрес сервераchats.example.ru
chats-gateway.example.ru
chats-storage.example.ru
chats-s3.example.ru

Важно!

  1. Адрес главной страницы сервиса «chats.example.ru» — это имя домена (chat domain name), которое понадобится ввести во время установки. Здесь:

    • «chats» — субдомен. Его нужно заменить на любое значение;

    • «example» — домен второго уровня. Он, как правило, заменяется на имя компании или связанное с компанией название;

    • «ru» — домен верхнего уровня. Зависит от доменной зоны компании.

  2. Если сервер расположен внутри корпоративной (локальной) сети с использованием маршрутизаторов/файерволов, то есть с использованием NAT, то трем доменам будет присвоен его внутренний IP-адрес. При этом в DNS должны быть прописаны внешние IP-адреса этих доменов.

    Другими словами, при расположении сервера внутри локальной сети он должен определяться локальным адресом. Например: если «chats.example.ru» прописан на IP-адрес X.X.X.X, при этом сервер располагается за файерволом и имеет IP-адрес Y.Y.Y.Y, то это значит, что локально «chats.example.ru» должен определяться адресом Y.Y.Y.Y, и все три домена необходимо прописать в файл /etc/hosts на адрес Y.Y.Y.Y.

    Если в /etc/hosts есть запись вида «127.0.0.1» или «127.0.1.1» со значением «chats.example.ru», ее необходимо удалить!


Настройка портов

Для работы ПО необходимо открыть порты, указанные в таблице:

Протокол

Источник

Приемник

Примечание

Адрес

Порт

Адрес

Порт

IP

Интернет

*

Сервер c ПО МТС Линк Чаты

80, 443

Порт 80: выполнение acme-challenge в ходе получения SSL сертификатов

Порт 443: веб-трафик интерфейса ПО

Сервер с ПО МТС Линк Встречи

443

Сервер c ПО МТС Линк Чаты

443

Важно!

  1. При использовании proxy-серверов и других специфических ограничений сети сервис может работать некорректно.

  2. Разделенная система доменных имен (Split DNS) не поддерживается.


Установка и лицензирование

Дистрибутив ПО "МТС Линк Чаты" автоматически устанавливает его на сервер.

Настройка и подключение сертификата (SSL)

Сертификат и секретный ключ шифрования необходимо разместить в директории «certs» в одном каталоге с мастером установки «installer.sh».

Важно!

  1. Так как перед запуском установки программа проверяет сертификат, файл .сrt должен:

    • содержать полную цепочку сертификации для того, чтобы браузеры доверяли подключениям;

    • иметь актуальный рабочий срок действия;

    • имя сертификата и секретного ключа должно включать в себя имя домена: chats.example.ru.crt / chats.example.ru.key.

  2. Перед началом установки требуется убедиться, что в файле /etc/resolv.conf (файл конфигурации, в котором содержатся адреса серверов имен, к которым система имеет доступ) отсутствуют записи вида: "domain example.ru" и "search example.ru".

    Эту проверку можно выполнить командой: sudo more /etc/resolv.conf

    Также можно использовать и другие команды чтения файлов (cat, tail и т.д.).

    ВНИМАНИЕ: ЕСЛИ УКАЗАННЫЕ ЗАПИСИ НЕ БУДУТ УДАЛЕНЫ, РАБОТА СЕРВИСА БУДЕТ НЕВОЗМОЖНА!

  3. Необходимо предоставить доступ к:

    • license-chat.mts-link.ru;

    • premise-registry.mts-link.net;

    • rep-box.webinar.ru.


Установка

  1. Файл лицензии, полученный от представителя компании "МТС Линк", необходимо разместить в одной директории с дистрибутивом перед началом установки.

  2. Загрузить на сервер исполняемый файл дистрибутива (расположен по ссылке) командой: wget https://rep-box.webinar.ru/chats/latest/installer.sh

  3. Присвоить файлу права на запуск командой: chmod +x installer.sh

  4. Открыть файл от имени пользователя с root-привилегиями командой: sudo ./installer.sh

  5. В процессе исполнения программа подготовит сервер для дальнейшей установки, при необходимости поставит недостающие компоненты и запросит дополнительные данные:

    • имя домена сервера, на который устанавливается ПО "МТС Линк Чаты" (chat domain name);

    • имя домена сервера, на который установлено ПО "МТС Линк Встречи" (является компонентом основного ПО; выполняет функции авторизации и администрирования);

    • имя пользователя и пароль (User/Password).

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

  6. Для выполнения настроек конфигураций после завершения установки необходимо выполнить команду в консоли управления сервером ПО "МТС Линк Встречи":  sudo ./installer.sh --chatscfg

    И далее указать имя домена сервера ПО МТС Линк Чаты (chat domain name).
👆 На этом пока всё