Intellect X Reports в ОС Linux

Intellect X Reports − локальная версия облачного сервиса ITV Cloud.

Список поддерживаемых ОС

Работа Intellect X Reports возможна в OS Linux Ubuntu 20.04 и Debian 11.

Минимальные требования для установки и работы Intellect X Reports

Для работы с Intellect X Reports рекомендуется использовать персональный компьютер на базе процессора с частотой от 1.0 ГГц с двумя и более ядрами, с объемом оперативной памяти от 2 ГБ.

Требования к дисковой подсистеме: 4 ГБ для установки Intellect X Reports и из расчета 1 МБ = 1000 событий для хранения событий от детекторов в БД.

Установка Docker

Для установки последний версии Docker из официального репозитория необходимо:

1. Обновить существующий перечень пакетов:

   sudo apt update

2. Установить пакеты, которые позволяют APT использовать HTTPS:

   sudo apt install apt-transport-https ca-certificates curl software-properties-common

3. Добавить в систему ключ CFG официального репозитория Docker:

   curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

   Примечание

   При установке на Debian 11 данная команда будет выглядеть следующим образом:

   curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -

4. Добавить репозиторий Docker в список источников пакетов APT:
   

   sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"

   Примечание

   При установке на Debian 11 данная команда будет выглядеть следующим образом:

   sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian stretch stable"

5. Обновить существующий перечень пакетов с учетом пакетов Docker из добавленного репозитория:
   

   sudo apt update

6. Убедиться, что установка выполняется из репозитория Docker:
   

   apt-cache policy docker-ce

   Пример ответа:
   

   docker.service - Docker Application Container Engine
      Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
      Active: active (running) since Thu 2018-07-05 15:08:39 UTC; 2min 55s ago
        Docs: https://docs.docker.com
    Main PID: 10096 (dockerd)
       Tasks: 16
      CGroup: /system.slice/docker.service
              ├─10096 /usr/bin/dockerd -H fd://
              └─10113 docker-containerd --config /var/run/docker/containerd/containerd.toml

7. Установить Docker:
   

   sudo apt install docker-ce

8. Убедиться, что Docker запущен: 
   

   sudo systemctl status docker

   В ответе должен быть статус active (running):
   

   docker.service - Docker Application Container Engine
      Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
      Active: active (running) since Thu 2018-07-05 15:08:39 UTC; 2min 55s ago
        Docs: https://docs.docker.com
    Main PID: 10096 (dockerd)
       Tasks: 16
      CGroup: /system.slice/docker.service
              ├─10096 /usr/bin/dockerd -H fd://
              └─10113 docker-containerd --config /var/run/docker/containerd/containerd.toml

Установка Intellect X Reports

Для установки Intellect X Reports необходимо:

1. Скачать архив дистрибутива на сайте компании ITV и распаковать в любую папку.

2. По умолчанию используется протокол доступа HTTPS, требующий ручной установки сертификатов на компьютерах клиентов Intellect X Reports. Если необходимо перейти на HTTP, выполнить команду:
   

   sudo ./http_https_switcher.sh HTTP

   HTTP − незащищенный протокол, не требующий установки сертификата. Чтобы вновь перейти на HTTPS, выполнить команду:
   

   sudo ./http_https_switcher.sh HTTPS

3. В терминале выполнить команду для предоставления скриптам (load.sh, once.sh, run.sh, stop.sh) прав на исполнение:

   sudo chmod +x *.sh

4. Запустить скрипт once.sh:

   sudo ./once.sh

5. Запустить скрипт load.sh:

   sudo ./load.sh

6. Создать Docker сервисы:

   sudo ./run.sh

7. Проверить статус сервисов:

   sudo docker service ls

   В столбце REPLICAS все значения должны быть 1/1.
   

8. Изменить имя домена vmscloud.local в файле /etc/hosts.

9. Установить корневой сертификат. Сертификат должен быть в PEM-формате с расширением .crt.
   

   sudo mkdir /usr/share/ca-certificates/extra
   sudo cp rootCA.pem /usr/share/ca-certificates/extra/rootCA.crt
   sudo dpkg-reconfigure ca-certificates

   Для Firefox сертификат rootCA необходимо самостоятельно добавить в «Центры сертификации».

10. Изменить адрес Intellect X Reports в конфигурации Интеллект X:
    
    1. Остановить Сервер.
    2. В файле infra.dictionar заменить адрес у параметра CLOUD_URL на vmscloud.local. Если Сервер Интеллект X установлен на ОС Linux, то файл будет в директории opt/ITV/IntellectX/Dictionary.local. Если на ОС Windows − C:\Program Files\ITV\IntellectX\Dictionary.local.
    3. Запустить Сервер.
11. На Сервере Интеллект X в файл hosts (C:\Windows\System32\drivers\etc или /etc/hosts) внести адрес компьютера, на котором установлен Intellect X Reports. Например, 192.168.11.12 vmscloud.local. Если Intellect X Reports установлен на одном компьютере с Сервером Интеллект X, то этот пункт можно пропустить.

Intellect X Reports будет доступен по адресу vmscloud.local. По умолчанию доступно 2 тестовых пользователя:

1. Admin1/admin1password.
2. Admin2/admin2password.

Обновление протокола передачи данных на ранее установленной Intellect X Reports

Чтобы поменять протокол передачи данных на ранее установленном Intellect X Reports, необходимо:

1. Остановить Intellect X Reports:

   sudo  ./stop.sh

2. Поменять протокол:

   sudo ./http_https_switcher.sh HTTP - смена https на http
   sudo ./http_https_switcher.sh HTTPS - смена http на https

3. Подгрузить изменения:

   sudo  ./load.sh

4. Запустить Intellect X Reports:
   

   sudo  ./run.sh

5. Проверить доступность Intellect X Reports:
   

   sudo docker service ls

   В столбце REPLICAS все значения должны быть 1/1.

Обновление Intellect X Reports

Для обновления Intellect X Reports необходимо:

1. Остановить Intellect X Reports:

   sudo  ./stop.sh

2. Перенести папку uploads в папку с новой версией Intellect X Reports:
   

   Внимание!

   Папка uploads располагается в директории /opt/IntellectXReports/uploads/. На версиях Intellect X Reports 3.9 и младше папка располагается в корневой директории. 

3. В терминале выполнить команду для предоставления скриптам (load.sh, once.sh, run.sh, stop.sh) прав на исполнение в папке с новой версией Intellect X Reports:
   

   sudo chmod +x *.sh

4. Подгрузить изменения:
   

   sudo  ./load.sh

5. Запустить Intellect X Reports:
   

   sudo  ./run.sh

Обновление Intellect X Reports завершено.

Удаление Intellect X Reports

Для полного удаления Intellect X Reports необходимо:

1. Удалить все контейнеры:
   1. Остановить Intellect X Reports:
      

      sudo  ./stop.sh

   2. Остановить все Docker контейнеры:
      

      sudo docker stop $(docker ps -qa)

   3. Удалить все Docker контейнеры:
      

      sudo docker rm $(docker ps -qa)

   4. Удалить все образы:
      

      sudo docker rmi -f $(docker images -qa)

   5. Удалить все тома:
      

      sudo docker volume rm $(docker volume ls -q)

   6. Удалить все сети:
      

      sudo docker network rm $(docker network ls -q)

   7. Для подтверждения нажать Y.
      Нижеперечисленные команды не должны выводить какие-либо элементы:
      

      sudo docker ps -a

      sudo docker images -a

      sudo docker volume ls

   8. Удалить все неиспользованные образы:
      

      sudo docker system prune 

   9. Для подтверждения нажать Y.
2. Удалить Docker. Последовательно ввести команды:
   

   sudo dpkg -l | grep -i docker

   sudo apt-get purge -y docker-buildx-plugin docker-ce docker-ce-cli docker-ce-rootless-extras docker-compose-plugin

   sudo apt-get autoremove -y --purge docker-buildx-plugin docker-ce docker-ce-cli docker-ce-rootless-extras docker-compose-plugin

   sudo rm -rf /var/lib/docker /etc/docker

   
   

   sudo /etc/apparmor.d/docker

   sudo groupdel docker

   sudo -rf /var/run/docker.sock

3. Удалить папку uploads и папку Intellect X Reports:
   

   sudo rm -rf /opt/IntellectXReports/

   Внимание!

   Папка uploads располагается в директории /opt/IntellectXReports/uploads/. На версиях Intellect X Reports 3.9 и младше папка располагается в корневой директории. 

Удаление Intellect X Reports завершено.