Для облегчения развертывания системы QoW, предусмотрен вариант развертывания при помощи Docker. Для работы сервера на хосте необходим только установленный Docker и встроенный в него плагин Docker Compose, а также открытые и незанятые порты 80 и 8883 в системе (при использовании HTTPS также необходим открытый порт 443).

Система QoW представлена в виде файла конфигурации для инструмента Docker Compose, в котором заданы конфигурации для отдельных контейнеров с Nginx, MQTT сервером, MongoDB сервером и QoW сервером. При развертывании инструмент Docker Compose автоматически создает и настраивает отдельные контейнеры, а также связывает их в общую сеть для их коммуникации, открывая наружу только минимум необходимых портов для работы системы. Модульность системы Compose позволяет гибко настраивать конфигурацию сервера и отдельных его компонентов, что позволяет запускать его как в базовом варианте с минимумом настроек, так и создавать более сложные конфигурации.

Ниже приведена инструкция для развертывания системы QoW в системе Linux, но возможно развертывание и под Windows.

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

  1. Установите Docker и Docker Compose, если они еще не установлены в системе. Информацию по установке можно найти в официальной документации к Docker Engine (https://docs.docker.com/engine/install/).
  2. Создайте директорию, в которой будут храниться конфигурационные файлы и данные из контейнеров, а также необходимые директории для работы контейнеров:
    mkdir -p qow-server-docker/ 
    cd qow-server-docker
    mkdir -p mosquitto/certs/ nginx/
  3. Скачайте конфигурационный файл docker-compose.yml по данной ссылке TODO и положите его в корень директории qow-server-docker.
  4. Запросите у нашей службы технической поддержки файлы сертификатов для работы MQTT, написав на почту support@netams.com.
  5. После получения файлов сертификатов (qow-ca.crt, qow-server.crt, qow-server.key), положите их в созданную ранее директорию ./mosqutto/certs/. Имена файлов обязательно должны быть такими же, иначе измените их имена в файле docker-compose.yml.
  6. Откройте файл docker-compose.yml в текстовом редакторе, найдите переменную NETAMS_LICENSE_KEY и замените ее значение LICENSE_KEY на ваш лицензионный ключ.
  7. Выполните логин в наш Docker Registry для скачивания образа сервера QoW, логин и пароль для входа запросите у службы технической поддержки:
    docker login packages.wnam.ru
  8. После успешной авторизации выполните скачивание всех необходимых для работы образов контейнеров:
    docker compose pull
  9. После скачивания всех образов запустите контейнеры:
    docker compose up -d
  10. После запуска контейнеров перейдите в браузере по адресу http://localhost или по IP адресу хоста, на котором вы запустили контейнеры.
  11. Просмотреть логи можно при помощи команды docker compose logs -f -n 0, либо в папке ./qow/logs/.
  12. Обновить образ QoW можно следующими командами: 
    docker compose down
    docker compose pull
    docker compose up -d