| Metadata list |
|---|
|| DeviceType | |
|| DeviceName | ECCM |
|| DocTitleMain | Инструкция по установке ECCM |
|| fwversion | 0.6 |
|| username | eccm |
|| password | eccm |
|
Требования к серверу
Для стабильной работы сервер должен отвечать следующим требованиям:
операционная система семейства Linux, поддерживающая docker (рекомендуется Ubuntu server 18 и новее)
объем оперативной памяти от 8 Гб
процессор, поддерживающий виртуализацию и имеющий от 4-х ядер
от 40 Гб свободного места на жестком диске
наличие сетевого интерфейса 1 Гбит/с
Получение привилегий sudo без дополнительного ввода пароля
От имени непривилегированного пользователя необходимо выполнить команду:
...
и указать пароль. После этого для выполнения команд с sudo или перехода в режим суперпользователя дополнительный ввод пароля не потребуется.
Установка docker и docker-compose
Установка docker
Наиболее простой и быстрый способ установки — воспользоваться скриптом с официального сайта :
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Добавление непривилегированного пользователя в группу docker
Это позволит работать с docker без использования sudo:
sudo usermod -aG docker $(whoami)Установка docker-compose
Docker-compose — отдельный проект от docker. Для получения свежей версии его нужно скачать с github:
sudo curl -L "https://github.com/docker/compose/releases/download/1.25.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-composeЗапуск ECCM
Файлы и конфигурация
Для запуска ECCM необходимо распаковать в директорию /opt/eccm следующие файлы:
...
| Переменная | Значение по умолчанию | Описание |
|---|---|---|
| COMPOSE_PROJECT_NAME | eccm | Название проекта в docker-compose. Используется для идентификации, в случае если на сервере запущено несколько проектов. |
| ECCM_PROFILE | production | Профиль запуска системы. Внутренняя переменная. |
| ECCM_TAG | 0.6 | Номер версии системы. |
| ECCM_WEB_ADDRESS | yourserver.ru | Адрес, на котором будет работать web-интерфейс системы. |
| ECCM_WEB_PORT | 8080 | Порт для доступа к web-интерфейсу. |
| ECCM_BACKBONE_ADDRESS | yourserver.ru | Адрес ECCM в сети управления устройствами. |
| ECCM_DISCOVERY_IP_RANGE | 192.168.0.1,192.168.1.1-63 | Диапазон автоматического поиска устройств в сети. В качестве аргумента передается список IP-адресов, разделенных запятой. Также в список можно включить диапазоны адресов в виде 192.168.1.1-255 . |
| ECCM_TIMEZONE | Asia/Novosibirsk | Временной пояс, в котором работает система, указывается в соответствии с tz database, например Asia/Novosibirsk. |
| ECCM_LOGLEVEL | 'INFO' | Уровень логирования в проекте. |
Примеры команд для запуска ECCM
Для запуска проекта нужно перейти в директорию с файлами и выполнить команду:
...
Для остановки проекта используйте команду:
docker-compose downДоступ к web-интерфейсу
Для подключения к web-интерфейсу ECCM нужно ввести в строке браузера следующий адрес:
http://<IP адрес вашего сервера (ECCM_WEB_ADDRESS)>:8080/
Известные проблемы и методы решения
При запуске проекта может возникнуть ошибка следующего вида:
...