Остановка Chat Server без очистки docker container и docker network:
./ecss-elph-chat-server.sh stop |
Остановка Chat Server с очисткой docker container и docker network:
./ecss-elph-chat-server.sh down |
Запуск Chat Server:
./ecss-elph-chat-server.sh up |
Рестарт Chat Server:
./ecss-elph-chat-server.sh restart |
Просмотр запущенных контейнеров:
docker ps |
Для просмотра логов баз данных:
docker logs elph-chat-server-stable-mongo-1 |
Для просмотра логов сервера:
docker logs elph-chat-server-stable-server-1 |
Для просмотра логов в реальном времени добавить "--follow" в конце команды:
docker logs elph-chat-server-stable-server-1 --follow |
Конфигурация Chat Server хранится в файле ./elph-chat-server/stable/.env
Чтобы перейти в файл конфигурации введите команду:
<nano/vim/mcedit> elph-chat-server/stable/.env |
# ELPH-CHAT-SERVER CONFIGFILE 2.11.0^ # ######################## Docker ######################## DEPLOY_PLATFORM=docker # ######################## Параметры подключения к mongodb ######################## # ####################### Для работы сервера ######################## # ######################## Авторизация на чат сервере ######################## # ######################## Аутентификация через ECSS10 ######################## # ######################## Получения доп. информации о пользователе (аватар/дисплейнейм) ######################## # Параметры подключения к ecss-mysql (БД meeting-db — для работы чатов телеконференций) ECSS_ADDRESSBOOK_DB_NAME=ecss_address_book # Если обновления аватара не было UPDATE_ADDRBOOK_AVATAR_EVERY_MS секунд, обновить данные при входе пользователя # Префикс перенаправления на ecss-elph-api # ######################## Разметка сообщений (markdown, katex, autolink) ######################## # ######################## Тех. поддержка (сбор обратной связи отчетов/клиентских логов) ######################## OVERWRITE_SETTING_Support_User_Cluster_Update_Message_Enable=true # ######################## Пользователь для агента безопасности ######################## # ######################## Системные отчеты использования системы ######################## # ######################## Системное уведомление в чате пользователей о заполненности диска на сервере базы данных ######################## # ######################## Cпецифичная настройка ######################## # NGINX_ACCESS_LOGS=./log/ecss-chat-server.access.log # ######################## Фильтры для логов ######################## # общая шина # Настройки файлового хранилища MinIO TUS_SERVER_URL=http://file-service:3000/tus |
В первоначальной настройке необходимо изменить следующие параметры:
Обязательный к изменению параметр: BEARER_TOKEN_PRIVATE_KEY — секретный ключ для генерации токена авторизации. По умолчанию стоит демонстрационное значение, которое важно поменять для обеспечения безопасности сервера. Значением может выступать любая комбинация символов >256 бит (примерно 32 символа). Значение данного параметра должно быть одинаковым в конфигурационном файле Chat Server и на всех сервисах: User Status Service, Call History Service и Address Book Service. |
PUBLIC_URL=https://<ip_or_domain_elph_proxy> — aдрес Elph Proxy, по которому Chat Server будет доступен извне;
ROOT_URL="https://<ip_or_domain_chat_server>:3443" — адрес Chat Server;
ECSS_CORE_HOST=<ip_or_domain_ecss_core> — адрес ядра ECSS;
ECSS_CORE_DOMAIN="ssw-domain" — домен SSW;
ECSS_ADDRESSBOOK_URL=http://<ip_or_domain_address_book_service>:4000 — адрес address-book-service;
ECSS_MEETING_DB_HOST="ip_or_domain_ecss_mysql" — адрес ecss-mysql;
ECSS_AVATAR_URL_ORIGIN_PREFIX=https://<ip_or_domain_elph_proxy>/elph_api/loadlocal/ — адрес Elph-API для доступа к аватарам, подробнее об этом в разделе «Настройка аватаров»;
RABBITMQ_URL="amqp://<rabbit_login>:<rabbit_password>@<rabbitMQ_address_or_domain>:5672/" — адрес брокера RabbitMQ. Начиная с версии 2.4.0, поставляется совместно с User Status Service. Стандартные логин:пароль — guest:guest;
Для корректной работы к RabbitMQ должен подключаться Chat Server той же версии, что и сам rabbit. |
MINIO_ROOT_USER=ecss;
MINIO_ROOT_PASSWORD=password — стандартные логин пароль для доступа к MinIO(http://<chat-address>:9000).
После изменения любого параметра нужно перезапустить Chat Server:
|
Если используется один стандартный домен, то производится настройка параметров ECSS_CORE_USE_DEFAULT_DOMAIN и ECSS_CORE_DOMAIN: ECSS_CORE_USE_DEFAULT_DOMAIN="true" — все пользователи без домена при логине будут отправляться на стандартный домен. При значении "false" Chat Server будет ожидать имя домена в авторизационных данных от клиента; ECSS_CORE_DOMAIN=<domain_name> — имя домена ECSS, с которым будет работать Chat Server. При ECSS_CORE_USE_DEFAULT_DOMAIN="false" допускается оставить значение параметра ECSS_WEB_API_DOMAIN пустым. |
Отчеты по использованию системы по умолчанию настроены на отправку отчетов раз в неделю пользователю supportuser.
Список интервалов, поддерживаемых для отправки отчетов: weeks, months. Указывать меньший интервал не рекомендуется.
SYSTEM_REPORTS_INTERVAL="1_week" |
Пример отчета использования системы:

Список интервалов поддерживаемых для отправки отчетов: day, weeks, months. Указывать меньший интервал не рекомендуется.
USED_SPACE_REPORTER_PERCENT_LIMIT — процент заполненности диска, при достижении которого начинают отправляться уведомления. По умолчанию равен 85. При заполненности диска менее указанного процента, отчеты о заполненности приходить не будут.
USED_SPACE_REPORTER_ENABLE=true USED_SPACE_REPORTER_INTERVAL=1_day USED_SPACE_REPORTER_PERCENT_LIMIT=85 |
Пример уведомления о заполненности диска:

Остальные параметры являются опциональными. Изменять их необходимо в случае, если используется нестандартная схема развёртывания ECSS-10.
Обратите внимание на архитектуру: для корректной работы конференций Chat Server должен иметь доступ к ecss-mysql. Для этого настройте маску доступа к mysql. |
Введите команду:
dpkg-reconfigure ecss-mysql |
Откроется диалоговое окно с вопросом о маске, например, для доступа всех IP-адресов можно задать маску: %.%.%.%.
Более подробно про настройку ecss-mysql можно почитать в разделе «Версия 2.11.0. Настройка SSW для работы c Elph». |
3443 — https-порт для доступа к Chat Server.
9000 — http-порт для доступа к MinIO.
OVERWRITE_SETTING_Log_Level
В .env можно настроить с каким уровнем выводить логи. Доступные значения: 0, 1 или 2.
0 - warning; 1 - info; 2 - debug. |
LOGGER_LOG_LABELS
Также есть возможность настроить вывод логов только определенных лейблов.
Для нормальной работы оставить пустым.
LOGGER_LOG_LABELS=Push,System,Other |
После очистки контейнеров логи очищаются. Поэтому, перед остановкой Chat Server с очисткой контейнеров (./ecss-elph-chat-server.sh down), рекомендуется скопировать логи. |
Начиная с версии 2.5.0, добавлена ротация логов.
По умолчанию пишутся 10 файлов по 50 Мб. Логи расположены в /var/lib/docker/containers/<container>/.
Вывести список контейнеров можно командой:
docker ps |
Для настройки параметров ротации нужно отредактировать docker-compose.yaml, расположенный в elph-chat-server/stable/. В данном файле под каждый контейнер отведен свой блок настроек:
logging:
driver: "json-file"
options:
max-size: "50m"
max-file: "10" |
И перезапустить Chat Server:
./ecss-elph-chat-server.sh down ./ecss-elph-chat-server.sh up |