Page History

Подготовка к развертыванию системы РТЛС

Минимальные требования (требования по ресурсам могут меняться в зависимости от используемых модулей, конфигурации инфраструктуры, кол-ва меток, частоты обновления данных от меток, сроков хранения данных и т.д):

...

Подготовка ОС к установке ПО РТЛС

1. Установить пакеты doсker (CE) и docker-compose. Подробные инструкции доступны в официльной документации https://docs.docker.com/install/linux/docker-ce/centos/. 

   1. Установить пакеты для управления репозиториями

      Code Block
      sudo yum install -y yum-utils

   2. Добавить репозиторий

      Code Block
      sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

   3. Установить пакет docker-ce

      Code Block
      sudo yum install docker-ce

   4. Установить последнюю версию docker-compose (версию 2.5.1 в URL заменить на более новую при необходимости)

      Code Block
      sudo curl -L "https://github.com/docker/compose/releases/download/2.5.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose

   5. проверить, что пакеты установились успешно

      Code Block
      docker version docker-compose version

   6. Добавить сервис docker на автостарт

      Code Block
      sudo systemctl enable docker

   7. Запустить сервис

      Code Block
      sudo systemctl start docker

2. Добавить сертификат для доступа к RTLS репозиторию repo.rtlsnet.ru (193.247.73.160) . В случае, если нет возможности подключения к RTLS репозиторию по сети интернет,  см. Инструкции по обновлению контейнеров через процедуру import

   1. Проверить подлючение к репозиторию

      Code Block
      openssl s_client -connect repo.rtlsnet.ru:5000

3. Создать пользователя под которым будет происходить запуск ПО (например  appuser). Добавить его в группу docker для работы с docker сервисами

   Code Block
   sudo adduser appuser sudo usermod -aG docker appuser

4. если id пользователя и его персональной группы отличается от 1000:1000 в файле .env поменять USER_UID,USER_GID на правильные

   1. проверить id пользователя и его персональной группы c помощью комманды id

      Code Block
      id uid=1001(appuser) gid=1001(appuser) groups=1001(appuser),998(docker)

   2. поменять в .env USER_UID и USER_GID. Здесь же можно настроить TZ , которая будет использоваться внутри контейнеров

      Code Block
      USER_UID=1002 USER_GID=1001 TZ=Europe/Moscow

Чистая установка ПО РТЛС

1. Получить от РТЛС Логин и Пароль для доступа к репозиторию.

2. Авторизоваться в docker с полученными параметрами подключения

   Code Block
   docker login repo.rtlsnet.ru:5000 Username: *** Password: **** Login Succeeded

3. На странице доступных релизов найти архив с конфигурацией нужной версии

   Code Block
   https://repo.rtlsnet.ru/service/rest/repository/browse/raw-rtls/releases/

4. Скачать и распаковать архив в папку rtls (где $(version) версия ПО, которую требуется установить)

   Code Block
   mkdir rtls cd rtls curl -L https://repo.rtlsnet.ru/repository/raw-rtls/releases/$(version)/RTLS-compose-$(version).tar.gz -o rtls.tar.gz tar -zxvf rtls.tar.gz rm rtls.tar.gz

5. В результате распаковки в файловой системе доступна для работы папка rtls со следующей
   структурой

   Code Block

   [appuser@srv rtls]$ ls -lh total 12K drwxrwxr-x. 4 appuser appuser 31 Nov 27 2019 actobus drwxrwxr-x. 4 appuser appuser 31 Jan 15 2020 ble-solver -rw-rw-r--. 1 appuser appuser 5.3K Nov 24 11:58 docker-compose.yml drwxrwxr-x. 2 appuser appuser 38 Nov 27 2019 emulator drwxrwxr-x. 5 appuser appuser 42 Nov 27 2019 le drwxrwxr-x. 4 appuser appuser 109 Nov 22 17:30 postgres -rw-rw-r--. 1 appuser appuser 789 Nov 27 2019 README.md drwxrwxr-x. 4 appuser appuser 32 Nov 27 2019 redis drwxrwxr-x. 8 appuser appuser 112 Nov 22 17:27 srv

6. Запустить ПО в зависимости от необходимой конфигурации

   1. запуск с поддержкой UWB

      Code Block
      docker-compose up -d

   2. запуск с поддержкой получения данных по LoRa

      Code Block
      docker-compose --profile actobus up -d

   3. Запуск с поддержкой BLE (включая получение данных по LoRa)

      Code Block
      docker-compose --profile ble up -d

7. Результат запуска средствами докера. Должны быть подняты 3 основных контейнера + actobus (ble-solver) в зависимости от профиля запуска

   Code Block
   docker ps

8. После старта сервисов должны быть доступны пользовательские интерфейсы

   1. https://<ip>/CToolUI - интерфейс конфигурации

   2. https://<ip>/BA-UI - пользовательский интерфейс

   3. http://<ip>:8420 - ресурсы actobus (при запуске ПО с профилем actobus и ble)

   4. http://<ip>:8520 - ресурсы BLE (при запуске ПО с профилем ble)

Загрузка контейнеров через процедуру import

1. На странице доступных релизов найти архив с конфигурацией нужной версии

   Code Block
   https://repo.rtlsnet.ru/service/rest/repository/browse/raw-rtls/releases/

2. Скачать и распаковать архив в папку rtls

   Code Block
   mkdir rtls cd rtls curl -L https://repo.rtlsnet.ru/repository/raw-rtls/releases/$(version)/RTLS-compose-$(version).tar.gz -o rtls.tar.gz tar -zxvf rtls.tar.gz rm rtls.tar.gz

3. Загрузить локально контейнеры

   Code Block
   docker-compose pull

4. Сохранить контейнер в файл (name - имя контейнера, version - версия контейнера, например v4.3.0). В итоге будет получена заархивированная копия контейнера <название файла>.tar.gz

   Code Block
   docker save -o <название файла>.tar repo.rtlsnet.ru:5000/name:version gzip <название файла>.tar

5. Повторить процедуру выгрузки для всех необходимых контейнеров

   1. с поддержкой UWB: postgres, srv, le

   2. запуск с поддержкой получения данных по LoRa: postgres, srv, le, actobus, redis

   3. Запуск с поддержкой BLE (включая получение данных по LoRa): postgres, srv, le, actobus, ble-solver, redis

6. Скопировать в домашнюю директорию пользователя appuser на машине, где развертывается ПО архивы

7. Импортировать каждый контейнер в docker

   Code Block
   docker load -i <название файла>.tar.gz

8. Проверить результат импорта (в списке должны отображаться версии контейнеров, экспортированные ранее)

   Code Block
   docker images

Обновление ПО ( сохранением данных)

1. Проверить версию docker-compose. 

   1. docker-compose version

   2. Если версия ниже 1.28 для работы с последними версиями ПО РТЛС необходимо переустановить docker-compose (см. Подготовка ОС к установке ПО РТЛС )

2. Посмотреть текущую версию ПО РТЛС для контейнера srv в файле  rtls/docker-compose.yml

   Code Block
   nano rtls/docker-compose.yml

3. Получить от РТЛС скрипт update.sql для обновления струкруры БД до нужной версии

4. На странице доступных релизов найти архив с конфигурацией нужной версии

   Code Block
   https://repo.rtlsnet.ru/service/rest/repository/browse/raw-rtls/releases/

5. Выключить все контейнеры

6. Сделать бекап текущего состояния через изменение имени рабочей директории rtls

   Code Block
   mv rtls rtls_bup

7. Скачать и распаковать архив в папку rtls (заменить version на нужную версию ПО, например v4.3.7)

   Code Block
   mkdir rtls cd rtls curl -L https://repo.rtlsnet.ru/repository/raw-rtls/releases/$(version)/RTLS-compose-$(version).tar.gz -o rtls.tar.gz tar -zxvf rtls.tar.gz rm rtls.tar.gz

8. Скопировать предыдущее состояние БД (папку pgdata в рабочую директорию)

   Code Block
   cp -R ../rtls_bup/postgres/pgdata ./postgres/

9. Положить полученный от разработчиков update.sql файл в папку rtls/postgres

10. Запустить ПО

    Code Block
    docker-compose up -d

11. Подключиться к БД контейнеру и запустить SQL скрипт

    Code Block
    docker exec -ti rtls_postgres_1 psql -d postgres -U rtls_pu -f /var/lib/postgresql/data/update.sql

12. После старта  в файловой системе должна быть доступна актуальная конфигурация настроек geo данных rtls/srv/geoserver-data

    Code Block

    [appuser@srv rtls]$ ls -l srv/geoserver-data/ total 44 -rw-r--r--. 1 appuser appuser 855 Nov 22 17:27 csw.xml drwxr-xr-x. 4 appuser appuser 36 Nov 23 11:49 data drwxr-xr-x. 2 appuser appuser 4096 Nov 22 17:27 demo -rw-r--r--. 1 appuser appuser 1930 Nov 23 11:49 global.xml drwxr-xr-x. 3 appuser appuser 40 Nov 22 17:27 gwc -rw-r--r--. 1 appuser appuser 965 Nov 22 17:27 gwc-gs.xml drwxr-xr-x. 2 appuser appuser 266 Nov 23 11:49 gwc-layers drwxr-xr-x. 2 appuser appuser 28 Nov 22 17:27 layouts -rw-r--r--. 1 appuser appuser 144 Nov 22 17:27 logging.xml drwxr-xr-x. 2 appuser appuser 265 Nov 22 17:27 logs drwxr-xr-x. 2 appuser appuser 76 Nov 22 17:27 palettes drwxr-xr-x. 2 appuser appuser 4096 Nov 22 17:27 plugIns -rw-r--r--. 1 appuser appuser 3276 Nov 22 17:27 README.rst drwxr-xr-x. 8 appuser appuser 252 Nov 22 17:27 security drwxr-xr-x. 2 appuser appuser 4096 Nov 22 17:27 styles drwxr-xr-x. 2 appuser appuser 29 Nov 22 17:27 user_projections drwxr-xr-x. 2 appuser appuser 56 Nov 22 17:27 validation -rw-r--r--. 1 appuser appuser 1397 Nov 22 17:30 wcs.xml -rw-r--r--. 1 appuser appuser 1907 Nov 22 17:30 wfs.xml -rw-r--r--. 1 appuser appuser 1614 Nov 22 17:30 wms.xml drwxr-xr-x. 4 appuser appuser 49 Nov 22 17:27 workspaces drwxr-xr-x. 4 appuser appuser 76 Nov 22 17:27 www

13. Скопировать данные о картографических слоях, загруженных в раннюю версию ПО, в новую конфигурацию

    Code Block
    cp -R ../rtls_bup/srv/geoserver-data/data/rtls srv/geoserver-data/data/ cp -R ../rtls_bup/srv/geoserver-data/workspaces/rtls/site* srv/geoserver-data/workspaces/rtls/

14. Перезапустить контейнер сервера приложений

    Code Block
    docker restart rtls_srv_1

15. Авторизоваться в BA-UI и проверить, что загруженные ранее карты доступны для работы

Обновление ПО ( без сохранения данных)

1. Проверить версию docker-compose. 

   1. docker-compose version

   2. Если версия ниже 1.28 для работы с последними версиями ПО РТЛС необходимо переустановить docker-compose (см. <Подготовка ОС к установке ПО РТЛС> )

2. Выключить все контейнеры

   Code Block
   docker-compose -f rtls/docker-compose.yml stop

3. Удалить папку rtls

   Code Block
   rm -rf rtls

4. Провести установку согласно инструкциям раздела <Чистая установка ПО РТЛС>

...