...

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

docker compose version

При установке на операционные системы Astra Linux, RedOS или Альт Сервер команда проверки версии установленного docker-compose имеет вид:

docker-compose version

Offline-установка

Установка ЕССМ в систему без доступа к сети Интернет подробно описана в разделе "Offline-установка ECCM".

...

cd eccm/2.7
wget "https://cloud.eltex-co.ru/index.php/s/n4RRd4rgx9pgxUO/download?path=%2F&files=peeper-client.tar" -O peeper-client.tar
tar -xvf peeper-client.tar -C peeper

...

POSTGRES_EXPORTER_ENABLED=true # Включение снятия метрик с базы данных PostgreSQL
POSTGRES_HOST="100.110.2.2" # Адрес базы данных PostgreSQL для подключения и снятия метрик
POSTGRES_PORT="5432" # Порт базы данных PostgreSQL для подключения и снятия метрик
POSTGRES_DB="" # Название базы данных PostgreSQL для мониторинга
POSTGRES_USER="tester" # Пользователь базы данных PostgreSQL для подключения и снятия метрик
POSTGRES_PASSWORD="tester" # Пароль для пользователя $POSTGRES_USER, который нужен для снятия метрик

Для запуска проекта ECCM в интеграции с Peeper добавьте ключ --peeper к стандартной команде запуска:  

sudo ./compose-tools.sh --start 100.110.2.2 --peeper

Запуск ЕССМ с базой данных на отдельном сервере

...

ECCM Application Server  — сервер, на котором развернуто приложение, обеспечивающее работу системы и взаимодействие с устройствами, а также веб-интерфейс пользователя.

Database Server  — сервер с базами данных PostgreSQL 14. Возможно использование уже существующего в инфраструктуре кластера.

Device Management Network  — IP-сеть управления оборудованием, через которые ECCM имеет доступ по L3.

Operator/Administrator  — оператор системы, занимающийся мониторингом и настройкой подконтрольного оборудования/системный администратор компании или сотрудники техподдержки Eltex, если есть договоренность об удаленном доступе.

Для случая, когда необходимо запустить ЕССМ на нескольких серверах (один сервер — для базы данных PostgreSQL, второй сервер — для остального стека сервисов ЕССМ), возможно использовать опцию многохостовой установки. Для этого:

1. Установите docker и docker-compose на обоих серверах согласно разделу "Установка ЕССМ";

2. Настройте сервер с базами данных:

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

2.2. Запустите базу данных PostgreSQL на сервере с БД. Для запуска БД перейдите в директорию eccm/postgres и выполните команду для запуска контейнера:

cd eccm/postgres
docker compose up -d

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

3.1. Для переопределения переменных, отвечающих за авторизацию пользователя в системе ECCM и поведение проекта (адрес веб-интерфейса, временная зона, адрес БД, логин/пароль для доступа к БД и пр.), отредактируйте файл "eccm/.env";

3.2. Выполните запуск ЕССМ на сервере с ЕССМ с помощью следующей команды:

sudo ./compose-tools.sh --start <ECCM ADDRESS> --database-host <DB ADDRESS> --database-port <DB PORT>

, где <DB ADDRESS> и <DB PORT>— это IP-адрес и порт, по которым будет выполняться подключение к серверу БД. Например, если адрес сервера ЕССМ 100.110.2.2, адрес сервера БД 100.110.2.4, порт сервера БД 5432, то команда будет выглядеть:

sudo ./compose-tools.sh --start 100.110.2.2 --database-host 100.110.2.4 --database-port 5432

Запуск ЕССМ в отказоустойчивой системе

Начиная с версии 2.6 в ЕССМ появилось резервирование формата Active-Active. Процесс запуска ЕССМ в отказоустойчивой системе с сервером базы данных и с отдельным сервером для базы данных описан в разделе Запуск ЕССМ в отказоустойчивой системе.

...

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

postgres/.env
postgres/data/postgresql.conf​
​eccm/.env

...

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

...

Адрес docker-registry, с которого будет выполняться получение образа postgres. Если используется локальное зеркало, то можно указать его адрес

...

Режим работы ЕССМ. Доступные значения: cluster, standalone. Если переменная не задана, значение будет установлено в standalone автоматически при запуске  compose-tools.sh без флага "--cluster"

...

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

...

POSTGRES_HOST

...

192.168.0.1

...

POSTGRES_PORT

...

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

...

LOGGING_MAX_FILES

...

5

...

LOGGING_MAX_FILE_SIZE

...

LOGGING_COMPRESS

...

POSTGRES_CONFIGURATOR_TAG

...

0.5

...

Для запуска проекта ECCM в интеграции с Peeper добавьте ключ --peeper к стандартной команде запуска:  

sudo ./compose-tools.sh --start 100.110.2.2 --peeper

Запуск ЕССМ с базой данных на отдельном сервере

ECCM Application Server  — сервер, на котором развернуто приложение, обеспечивающее работу системы и взаимодействие с устройствами, а также веб-интерфейс пользователя.

DataBase Server  — сервер с базами данных PostgreSQL 14. Возможно использование уже существующего в инфраструктуре кластера.

Device Management Network  — IP-сеть управления оборудованием, через которую ECCM имеет доступ по L3.

Operator/Administrator  — оператор системы, занимающийся мониторингом и настройкой подконтрольного оборудования/системный администратор компании или сотрудники техподдержки Eltex (если есть договоренность об удаленном доступе).

Для случая, когда необходимо запустить ЕССМ на нескольких серверах (один сервер — для базы данных PostgreSQL, второй сервер — для остального стека сервисов ЕССМ), возможно использовать опцию многохостовой установки. Для этого:

1. Установите docker и docker-compose на обоих серверах согласно разделу "Установка ЕССМ";

2. Настройте сервер с базами данных:

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

2.2. Запустите базу данных PostgreSQL на сервере с БД. Для запуска БД выполните команду используйте следующую команду:

sudo ./compose-tools.sh --start <DB ADDRESS> --database-only

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

3.1. Для переопределения переменных, отвечающих за авторизацию пользователя в системе ECCM и поведение проекта (адрес веб-интерфейса, временная зона, адрес БД, логин/пароль для доступа к БД и пр.), отредактируйте файл "eccm/.env";

3.2. Выполните запуск ЕССМ на сервере с ЕССМ с помощью следующей команды:

sudo ./compose-tools.sh --start <ECCM ADDRESS> --database-host <DB ADDRESS> --database-port <DB PORT>

, где <DB ADDRESS> и <DB PORT>— это IP-адрес и порт, по которым будет выполняться подключение к серверу БД. Например, если адрес сервера ЕССМ 100.110.2.2, адрес сервера БД 100.110.2.4, порт сервера БД 5432, то команда будет выглядеть:

sudo ./compose-tools.sh --start 100.110.2.2 --database-host 100.110.2.4 --database-port 5432

Запуск ЕССМ в отказоустойчивой системе

Начиная с версии 2.6 в ЕССМ появилось резервирование формата Active-Active. Процесс запуска ЕССМ в отказоустойчивой системе с сервером базы данных и с отдельным сервером для базы данных описан в разделе Запуск ЕССМ в отказоустойчивой системе.

Якорь
Vars Vars

Переменные окружения

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

postgres/data/postgresql.conf​
​eccm/.env
.env.cluster

...

ENABLE_POSTGRES_CONFIGURATOR

...

Якорь
Postgresdata Postgresdata

postgres/data/postgresql.conf

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

Якорь
Eccm_env Eccm_env

eccm/.env

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

./cert/server.crt

./cert/server.key

443

...

./cert/server.crt

./cert/server.key

443

Якорь
Cluster Cluster

.env.cluster

В файле .env.cluster находятся переменные, определяющие поведение кластера при запуске ЕССМ в отказоустойчивой системе. В таблице ниже представлено описание данных переменных:

REPMGR_USER

...

В файле .env.cluster находятся переменные, определяющие поведение кластера при запуске ЕССМ в отказоустойчивой системе. В таблице ниже представлено описание данных переменных:

REPMGR_USER

Доступ к веб-интерфейсу

Для подключения к веб-интерфейсу ECCM откройте браузер и в адресной строке введите следующее:

...

...