Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Для проверки установленного docker - compose в Ubuntu можно выполнить командыкоманду:

Блок кода
docker compose version

...

2.1. Для переопределения логина/пароля/временной зоны/ограничения ОЗУ для работы с БД отредактируйте файл postgreseccm/.env. Для изменения параметров, влияющих на производительность базы данных, отредактируйте файл postgres/data/postgresql.conf (настройки по умолчанию достаточны для тестового запуска и поддержки около 100 устройств);

Scroll Pagebreak

...

Блок кода
cd eccm/postgres
docker compose --env-file=../eccm/.env up -d

3. Настройте сервер с приложениями:

...

Файлы, необходимые для запуска ECCM и содержащие переменные окружения и конфигурации, находятся в директории, в которую был распакован установочный архив:

Блок кода
postgres/.env
postgres/data/postgresql.conf​
​eccm/.env
.env.cluster

Якорь

...

Postgresdata

...

Postgresdata
postgres/data/postgresql.

...

conf

Файл содержит параметры, влияющие на производительность базы данных. Настройки по умолчанию достаточны для тестового запуска и поддержки около 100 устройств. Для изменения конфигурации ECCM ознакомьтесь с полным Руководством пользователя или обратитесь в Службу технической поддержки Eltex.

Якорь
Eccm
Eccm
eccm/.env

В файле eccm/.env находятся переменные, определяющие поведение проекта и стека БД PostgreSQL при его запуске в контейнереВ таблице ниже представлено описание данных переменных:

ПеременнаяЗначение по умолчаниюОписание

...

В postgres/.env содержатся переменные, определяющие поведение стека БД PostgreSQL при его запуске в контейнере. В таблице ниже представлено описание данных переменных:

ПеременнаяЗначение по умолчаниюОписание
COMPOSE_PROJECT_NAME
postgres
eccmНазвание проекта в docker-compose (используется для идентификации, в случае если на сервере запущено несколько проектов)
POSTGRES
ECCM_
TAG
PROFILEproductionПрофиль проекта
ECCM_TAG2
2
.7Версия
образа контейнера postgresPOSTGRES
образов контейнеров
ECCM_REGISTRYhub.eltex-co.ruАдрес docker-registry, с которого будет выполняться получение
образа postgres
образов системы. Если используется локальное зеркало, то можно указать его адрес
ECCM_NETWORK_MODEstandalone

Режим работы ЕССМ. Доступные значения: cluster, standalone

. Если переменная не задана, значение будет установлено в standalone автоматически при запуске  compose-tools.sh без флага "--cluster"KEEPALIVE_INTERVAL5

Интервал секундах, означающий проверку доступности узла кластера. При истечении времени, если ответа не последовало, keepalived переключится на другую доступную ноду

ROOT_POSTGRES_USERПараметр, позволяющий переопределить логин суперпользователя для доступа и конфигурирования базы данныхROOT_POSTGRES_PASSWORDПараметр, позволяющий переопределить пароль суперпользователя для доступа и конфигурирования базы данных
ECCM_DATABASEeccmНазвание базы данных стека сервисов eccmPOSTGRES_TIMEZONEAsia/NovosibirskВременной пояс, в котором работает система (указывается в соответствии с tz database, например "Asia/Novosibirsk")POSTGRES_SHM_SIZE2gbОграничение выделенной оперативной памяти для работы с БД PostgreSQLPOSTGRES_PRIVILEGED_MODEfalseЗапуск контейнера в привилегированном режиме

POSTGRES_HOST

192.168.0.1

Внешний адрес БД PostgreSQL

POSTGRES_PORT

5432

Порт, на котором доступна БД PostgreSQL

LOGGING_MAX_FILES

5

Максимальное количество лог-файлов контейнеров

LOGGING_MAX_FILE_SIZE

50MМаксимальный размер лог-файлов контейнеров

LOGGING_COMPRESS

trueРазрешение сжатия лог-файлов контейнеров

POSTGRES_CONFIGURATOR_TAG

0.5

Версия образа контейнера postgres-configurator

ENABLE_POSTGRES_CONFIGURATOR

trueАктивация запуска контейнера postgres-configurator при старте системы

...

Информация

Если ключ --cluster не указывается в скрипте запуска, то выбирается режим работы standalone.

ECCM_BACKBONE_ADDRESS192.168.0.1Внутренний адрес, на котором будет работать

...

Файл содержит параметры, влияющие на производительность базы данных. Настройки по умолчанию достаточны для тестового запуска и поддержки около 100 устройств. Для изменения конфигурации ECCM ознакомьтесь с полным Руководством пользователя или обратитесь в Службу технической поддержки Eltex.

...

В файле eccm/.env находятся переменные, определяющие поведение проекта. В таблице ниже представлено описание данных переменных:

ПеременнаяЗначение по умолчаниюОписание
COMPOSE_PROJECT_NAMEeccmНазвание проекта в docker-compose (используется для идентификации, в случае если на сервере запущено несколько проектов)
ECCM_PROFILEproductionПрофиль проекта
ECCM_TAG2.7Версия образов контейнеров
ECCM_REGISTRYhub.eltex-co.ruАдрес docker-registry, с которого будет выполняться получение образов системы. Если используется локальное зеркало, то можно указать его адрес
ECCM_BACKBONE_ADDRESS192.168.0.1Внутренний адрес, на котором будет работать система ECCM с устройствами в сети
ECCM_WEB_ADDRESS192.168.0.1Адрес, на котором будет работать веб-интерфейс системы ECCM
ECCM_WEB_PORT80Порт для доступа к веб-интерфейсу
ECCM_TIMEZONEAsia/NovosibirskВременной пояс, в котором работает система (указывается в соответствии с tz database, например "Asia/Novosibirsk")
ECCM_LOGLEVELINFOУровень логирования в проекте
MAX_CONCURRENT_SSH_TASKS20Количество одновременно выполняемых операций с устройствами
POSTGRES_HOST192.168.0.1Адрес, на котором работает БД PostgreSQL
POSTGRES_PORT5432Порт для доступа к БД PostgreSQLБД PostgreSQL
ROOT_POSTGRES_DBpostgresПараметр, позволяющий переопределить базу данных для ее конфигурирования
ROOT_POSTGRES_USER
Параметр, позволяющий переопределить логин суперпользователя для доступа и конфигурирования базы данных
ROOT_POSTGRES_USERPASSWORD
Параметр, позволяющий переопределить логин пароль суперпользователя для доступа и конфигурирования базы данных
ROOT
ECCM_POSTGRES_DBeccmНазвание базы данных для сервисов ECCM
ECCM_POSTGRES_PASSWORDUSER
Параметр, позволяющий переопределить пароль суперпользователя для доступа и конфигурирования базы данных
ECCM_POSTGRES_DBeccmНазвание базы данных для сервисов ECCM
логин по умолчанию для доступа к базе данных ECCM_POSTGRES_DB
POSTGRES_TIMEZONEAsia/NovosibirskВременной пояс, в котором работает система (указывается в соответствии с tz database, например "Asia/Novosibirsk")
POSTGRES_SHM_SIZE2gbОграничение выделенной оперативной памяти для работы с БД PostgreSQL
POSTGRES_PRIVILEGED_MODEfalseЗапуск контейнера в привилегированном режиме
POSTGRES_CONFIGURATOR_TAG0.5Версия образа контейнера postgres-configurator
ENABLE_POSTGRES_CONFIGURATORtrueАктивация запуска контейнера postgres-configurator при старте системыECCM_POSTGRES_USERПараметр, позволяющий переопределить логин по умолчанию для доступа к базе данных ECCM_POSTGRES_DB
ECCM_POSTGRES_PASSWORD
Параметр, позволяющий переопределить пароль по умолчанию для доступа к базе данных ECCM_POSTGRES_DB

ECCM_DEVICE_MANAGER_ELM_DOWN_WEB_NOTIFICATION_INTERVAL

10mИнтервал отображения push-уведомлений в веб-интерфейсе при ошибке получения лицензии

ECCM_LICENSE_SERVICE_ELM_DOWN_NOTIFICATION_INTERVAL

60mИнтервал рассылки уведомлений telegram/email при ошибке получения лицензии

ECCM_LICENSE_SERVICE_NODE_NUMBER

1Номер текущей ноды. Должен быть уникальным в схеме резервирования

ECCM_MONITORING_SERVICE_XMX

1GОграничение физической памяти для docker-контейнера

CERT_PATH

./cert/server.crt
Путь к файлу с сертификатом для HTTPS

KEY_PATH

./cert/server.key
Путь к файлу с ключом для HTTPS
KEY_PASS_PATH./cert/key.passПуть к файлу с паролем ключа для HTTPS

ECCM_WEB_HTTPS_PORT

443
Порт, на котором ECCM будет доступен по HTTPS
LOGGING_ASPECT_ENABLEDfalse

Включение логирования через аспекты сервисов. Аспект логирует все входы и выходы из методов, их параметры, а также возвращаемые значения

Примечание
Не рекомендуется включать этот параметр при штатной работе системы


Информация
Переменные настройки логирования (LOGGING_*) применяются ко всем контейнерам стека eccm


LOGGING_MAX_FILES

5

Максимальное количество лог-файлов контейнера

LOGGING_MAX_FILE_SIZE

50MМаксимальный размер лог-файлов контейнера

LOGGING_COMPRESS

trueРазрешить сжатие лог-файлов контейнера
AUTH_ECCM_AUTHENTICATION_ENABLEDfalseВключение аутентификации с помощью локальных учетных записей

...

ПеременнаяЗначение по умолчаниюОписание
ECCM_NETWORK_MODEcluster

Режим работы ЕССМ. Доступные значения: cluster, standalone

Информация

Если ключ --cluster не указывается в скрипте запуска, то выбирается режим работы standalone.

RESTART_CLUSTER

falseИспользование перезапуска кластера с принудительным назначением ролей БД. Используется в случаях разрушения кластера

ROLE

MASTER


Роль внешней базы данных при развертывании кластера. Используется только при запуске ЕССМ в отказоустойчивой системе с разделением приложения и БД

POSTGRES_HOST


IP-адрес внешней базы данных PostgreSQL, установленной на другом хосте. Не использовать, если на хосте с ЕССМ запущена БД PostgreSQL

POSTGRES_PORT

5432Порт подключения к внешней базе данных PostgreSQL, установленной на другом хосте. Не использовать, если на хосте с ЕССМ запущена БД PostgreSQL

BACKUP_POSTGRES_HOST


IP-адрес подключения к внешней slave базе данных PostgreSQL, установленной на другом хосте. Использовать при развертывании отказоустойчивой системы с разделением на приложение и БД

BACKUP_POSTGRES_PORT

5432Порт подключения к внешней slave базе данных PostgreSQL, установленной на другом хосте. Использовать при развертывании отказоустойчивой системы с разделением на приложение и БД

REPMGR_DB

repmgrНаименование служебной базы данных, которая используется для отслеживания состояния баз данных в кластере

REPMGR_USER

repmgrИмя пользователя, созданного для управления работой и связью между серверами баз данных в кластере

REPMGR_PASSWORD

repmgrПароль, обеспечивающий безопасный доступ к служебной базе данных для пользователя 
REPMGR_USER

REPMGR_CONNECT_TIMEOUT

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

REPMGR_MONITOR_INTERVAL

2Интервал в секундах, с которым система проверяет состояние и доступность всех серверов в кластере

REPMGR_RECONNECT_ATTEMPT

3Количество повторных попыток для установления соединения с другим сервером в случае сбоя. Каждая попытка выполняется в течение REPMGR_RECONNECT_INTERVAL

REPMGR_RECONNECT_INTERVAL

3Время в секундах между повторными попытками соединения с сервером после неудачи

ALLOWED_HOSTS


Разрешенные хосты для подключения в кластер. Указываются все IP-адреса нод, составляющих кластер: master, slave и witness

MASTER_HOST


IP-адрес master-ноды

MASTER_NODE_NAME

masterНаименование master-ноды внутри базы данных ECCM

MASTER_NODE_ID

1Уникальный идентификатор master-ноды

SLAVE_HOST


IP-адрес slave-ноды

SLAVE_NODE_NAME

slaveНаименование slave-ноды внутри базы данных ECCM

SLAVE_NODE_ID

2Уникальный идентификатор slave-ноды

WITNESS_HOST


IP-адрес witness-ноды

WITNESS_NODE_NAME

witnessНаименование witness-ноды внутри базы данных ECCM

WITNESS_NODE_ID

100Уникальный идентификатор witness-ноды

SENTINEL_ANNOUNCE_IP


Внутренний адрес сервера, используемый Redis Sentinel для связи внутри кластера. Если переменная не задана, значение будет определено автоматически при запуске

SENTINEL_MASTER_NAME

redis-masterУникальное имя, присваиваемое кластеру баз данных для их мониторинга

SENTINEL_PASSWORD


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

REDIS_REPLICATION_NODE_COUNT

1Количество нод, используемых в репликации. Учитывается только количество slave-нод

SENTINEL_DOWN_AFTER_MS

5000Время в миллисекундах, по истечении которого служба мониторинга считает ноду недоступной

SENTINEL_FAILOVER_TIMEOUT

10000Максимальное время в миллисекундах, в течение которого система мониторинга пытается завершить процесс автоматического переключения мастерства между нодами

REDIS_BIND

0.0.0.0

Сетевые адреса, на которых сервер ожидает входящие подключения для репликации

Информация

Рекомендуется оставлять значение REDIS_BIND по умолчанию, для избежания проблем с сетевыми интерфейсами

ECCM_DATABASE

eccmИмя основной базы данных ЕССМ. Дублируется имя базы данных из postgres/.env

DATABASE_WAIT_INTERVAL_SEC

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

CN

clusterCommon name сертификата. Должен совпадать с Common name сертификата в блоке [ dn ]

CERT_FILE_NAME

cluster.crtНаименование сертификата кластера

ROOT_CA_FILE_NAME

ca.crtНаименование корневого сертификата. Необходим для авторизации кластерного сертификата в Redis/Sentinel и Postgresql

KEY_FILE_NAME

cluster.keyНаименование ключа сертификата кластера

TRUSTSTORE_PASSWORD

changeitПароль truststore.p12 при генерации средствами ECCM

INPUT_TRUSTSTORE_NAME

truststore.p12Наименование truststore.p12 при загрузке кастомного truststore.p12

CA_ALIAS


Имя, под которым Java будет хранить и идентифицировать сертификат внутри truststore.p12

...