Рекомендуется устанавливать Chat Server на Ubuntu 20.04.

Для развертывания Chat Server необходимо подключение к сети Internet. Для получения документации по развертыванию Chat Server в закрытом контуре, запросите документацию в коммерческом отделе компании Eltex: eltex@eltex-co.ru.

Разворачивание docker-образа

Скачайте скрипт установки командой:

wget https://s3.eltex-co.ru/shared/elph-chat-server/ecss-elph-chat-server.sh

Выдайте права на исполнение:

chmod +x ecss-elph-chat-server.sh

Запустите скрипт, начнется загрузка:

./ecss-elph-chat-server.sh install

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

Please, relogin in bash for access to docker group: 
$ su - user 
And repeat you command:

И повторить команду:

./ecss-elph-chat-server.sh install

В процессе установки будет необходимо авторизоваться во внешнем docker-регистре (данные авторизации вы можете уточнить в коммерческом отделе компании Eltex: eltex@eltex-co.ru):

Enter docker registry user: 
Enter docker registry password:

И ответить на вопросы, предназначенные для правильной базовой настройки конфигурации сервера:

ВопросыПояснение или пример ответа

Enter your elph-proxy domain name or ip address. (Example: https://elph-proxy.loc):

Введите доменное имя или IP-адрес прокси-сервера в формате: https://[адрес_сервера], например (https://192.168.1.1)

Enter your elph-chat-server domain name and port or ip address and port. (Example: https://elph-chat.loc:3443):Введите доменное имя или IP-адрес Chat Server в формате: https://[адрес_сервера], например https://192.168.1.1:3443

Enter your ecss-core domain name or ip address. (Example: ecss-core.loc):

Введите доменное имя или IP-адрес ecss-core в формате: [адрес_сервера], например 192.168.1.1

Enter your ecss10 domain name. (Example: default):

Введите ecss10-домен. (default-domain).

Do you want to use the current default domain or will we have multiple domains (y/n)?:

Хотите ли вы использовать текущий домен по умолчанию или у вас будет несколько доменов(y/n)?
Данная настройка предназначена для выбора домена по умолчанию. 
При выборе y(yes), будет использоваться один домен, заданный выше. При выборе n(no), чат-сервер будет
ожидать имя домена в авторизационных данных от клиента.

Enter a user database domain name or ip address. (Example: address-book.mysql.ecss):

Введите доменное имя или IP-адрес базы данных ecss-mysql (192.168.1.1).
Enter avatar-storage preffix patch. (Example: https://elphapi:8098/loadlocal/):Введите адрес хранилища аватаров в формате https://[адрес_elph_proxy]/elph_api/loadlocal/(рекомендуется) или https://[адрес_хранилища]:8098/loadlocal/.
Enter RabbitMQ domain or ip address. (Example: amqp://guest:guest@172.17.0.1:5672/):

Введите доменное имя или IP-адрес брокера RabbitMQ. Начиная с версии 2.4.0 поставляется в составе User Status Service.

(amqp://guest:guest@[адрес_user_status_service]:5672/)

Do you want to change support-user password or leave it as default (y/n)?:

Хотите ли вы изменить стандартный пароль (password) для чата поддержки? (y/n)

Enter new support-user password:

При выборе y в пункте выше, введите пароль.

В случае правильного ввода конфигурационных настроек Chat Server запустится автоматически. Об этом будет свидетельствовать следующее сообщение:

Successfully start Elph-chat-server latest in stable

Обязательный к изменению параметр: BEARER_TOKEN_PRIVATE_KEY — секретный ключ для генерации токена авторизации. По умолчанию стоит демонстрационное значение, которое важно поменять для обеспечения безопасности сервера. Значением может выступать любая комбинация символов >256 бит (примерно 32 символа). Значение данного параметра должно быть одинаковое в конфигурационном файле Chat Server и на сервисах: User Status Service, Call History Service и Address Book Service.

Изменение конфигурации

Перед изменением конфигурации сначала остановите Chat Server:

Для остановки Chat Server без очистки контейнеров и docker-network:

./ecss-elph-chat-server.sh stop

Для остановки Chat Server с очисткой контейнеров и docker-network:

./ecss-elph-chat-server.sh down

Обратите внимание! Начиная с версии 2.4.0 ./ecss-elph-chat-server.sh down очищает только контейнеры и docker-network. Для очистки базы данных необходимо удалить директорию volumes. Для этого используйте команду:

rm -r elph-chat-server/stable/volumes/

Изменить конфигурацию можно двумя способами:

  1.  Заново сконфигурировать при установке. Заново запустите скрипт с установкой:

    ./ecss-elph-chat-server.sh install

  2.  Изменить файл конфигурации вручную. Подробнее об этом в разделе «2.4.0 Настройка и управление Chat Server».

    Для этого остановите Chat Server:

    ./ecss-elph-chat-server.sh down

    Измените конфигурацию:

    <nano/vim/mcedit> elph-chat-server/stable/.env

    Запустите Chat Server командой:

    ./ecss-elph-chat-server.sh up

Инструкция по установке Chat Server на Astra Linux

Для установки Chat Server необходимо предварительно установить следующие пакеты:

Версия должна быть не ниже 20.10.2

  • docker-compose

Версия должна быть не ниже 1.29.2

apt install docker.io docker-compose

Следующие шаги установки не отличаются от штатных.

  • Нет меток