Page History

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

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

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

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

1. Пользователя, под которым будет производится управление ПО РТЛС, добавить в группу docker

   Code Block
   sudo usermod -aG docker appuser

2. Повторно авторизоваться под пользователем appuser для применения прав доступа

3. Удалить старые версии пакетов Docker Engine (если были установлены ранее) . Docker, запущенный через snap, должен быть удален!

   Code Block
   Code Block
   sudo apt-get remove docker docker-engine docker.io containerd runc sudo snap remove docker

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

   Code Block

   sudo apt-get update sudo apt-get install \ ca-certificates \ curl \ gnupg \ lsb-release sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. Установить последние версии пакетов Docker Engine

   Code Block
   sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

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

   Code Block
   docker version docker compose version

7. Пользователя, под которым будет производится управление ПО РТЛС, добавить в группу docker

   Code Block
   sudo usermod -aG docker appuser

8. Повторно авторизоваться под пользователем appuser для применения прав доступа

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

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

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

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

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

4. Скачать и распаковать архив в папку rtls (где <version> версия ПО, которую требуется установить, например v4v5.3.8) 0) , <repo-user> имя пользователя для доступа к ресурсам репозитория РТЛС. В процессе выполнения команды curl потребуется ввести пароль для пользователя <repo-user>

   Code Blockcode
   mkdir rtls cd rtls export RTLS_VERSION=<version> curl -u <repo-user> -v -L https://repo.rtlsnet.ru/repository/rawrtls-rtlspublic/srv/releasesrelease/$RTLS_VERSION/RTLS-compose-$RTLS_VERSION.tar.gz -o rtls.tar.gz tar -zxvfxvf rtls.tar.gz rm rtls.tar.gz

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

   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

6. После полного старта контейнера SRV статус должен перейти в healthy

   Code Block

   docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES c58f0cc80b8e repo.rtlsnet.ru:5000/emqx:4.4.2 "/usr/bin/docker-ent…" 43 hours ago Up 5 minutes (healthy) 1883/tcp, 4369-4370/tcp, 5369/tcp, 6369-6370/tcp, 8081/tcp, 8083-8084/tcp, 8883/tcp, 11883/tcp, 0.0.0.0:18083->18083/tcp, :::18083->18083/tcp rtls-emqx-1 af20240c2d95 repo.rtlsnet.ru:5000/srv:v5.0 "/entrypoint.sh -c s…" 44 hours ago Up 5 minutes (healthy) 0.0.0.0:9993->9993/tcp, :::9993->9993/tcp, 0.0.0.0:80->8080/tcp, :::80->8080/tcp, 0.0.0.0:8300->8081/tcp, :::8300->8081/tcp, 0.0.0.0:443->8443/tcp, :::443->8443/tcp rtls-srv-1 f16b0ad37ef3 repo.rtlsnet.ru:5000/le:v5.0 "/entrypoint.sh '-f …" 44 hours ago Up 5 minutes 0.0.0.0:5683->5683/udp, :::5683->5683/udp, 0.0.0.0:17320-17321->17320-17321/udp, :::17320-17321->17320-17321/udp, 0.0.0.0:8320->8320/tcp, :::8320->8320/tcp rtls-le-1 d95d0ae66074 repo.rtlsnet.ru:5000/postgres:9.6 "/entrypoint.sh post…" 44 hours ago Up 5 minutes (healthy) rtls-postgres-1

7. После старта сервисов должны быть доступны пользовательские интерфейсы, где <ip> адрес машины, на которой развернуто ПО РТЛС

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

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

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

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

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

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

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

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

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

4. Скачать и распаковать архив в папку rtls (где <version> версия ПО, которую требуется установить, например v4v5.3.8) 0) , <repo-user> имя пользователя для доступа к ресурсам репозитория РТЛС. В процессе выполнения команды curl потребуется ввести пароль для пользователя <repo-user>

   Code Block
   mkdir rtls cd rtls export RTLS_VERSION=<version> curl -u <repo-user> -v -L https://repo.rtlsnet.ru/repository/rawrtls-rtlspublic/srv/releasesrelease/$RTLS_VERSION/RTLS-compose-$RTLS_VERSION.tar.gz -o rtls.tar.gz tar -zxvfxvf rtls.tar.gz rm rtls.tar.gz

5. Загрузить образы в локальное хранилище

   Code Block
   docker compose pull

6. Сохранить образ в файл (где <file_name> имя контейнера, <version> - версия контейнера, например v5.0).

   Code Block
   docker save -o <file_name>.tar repo.rtlsnet.ru:5000/name:<version> gzip <file_name>.tar

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

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

   2. с поддержкой LoRa: postgres, srv, le, emqx, emqx_init, redis, actobus

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

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

9. Импортировать каждый контейнер в docker (где <file_name> имя контейнера)

   Code Block
   docker load -i <file_name>.tar.gz

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

    Code Block
    docker images

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

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

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

   Посмотреть текущие версии ПО

   1. Code Block
      docker

   ps

   1. compose up -d

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

      Code Block
      docker compose --profile actobus up -d

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

      Code Block
      docker compose --profile ble up -d

2. После полного старта контейнера SRV статус должен перейти в healthy

   Code Block

   docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES c58f0cc80b8e repo.rtlsnet.ru:5000/emqx:4.4.2 "/usr/bin/docker-ent…" 43 hours ago Up 5 minutes (healthy) 1883/tcp, 4369-4370/tcp, 5369/tcp, 6369-6370/tcp, 8081/tcp, 8083-8084/tcp, 8883/tcp, 11883/tcp, 0.0.0.0:18083->18083/tcp, :::18083->18083/tcp rtls-emqx-1 af20240c2d95 repo.rtlsnet.ru:5000/srv:v5.0 "/entrypoint.sh -c s…" 44 hours ago Up 5 minutes (healthy) 0.0.0.0:9993->9993/tcp, :::9993->9993/tcp, 0.0.0.0:80->8080/tcp, :::80->8080/tcp, 0.0.0.0:8300->8081/tcp, :::8300->8081/tcp, 0.0.0.0:443->8443/tcp, :::443->8443/tcp rtls-srv-1 f16b0ad37ef3 repo.rtlsnet.ru:5000/le:v5.0 "/entrypoint.sh '-f …" 44 hours ago Up 5 minutes 0.0.0.0:5683->5683/udp, :::5683->5683/udp, 0.0.0.0:17320-17321->17320-17321/udp, :::17320-17321->17320-17321/udp, 0.0.0.0:8320->8320/tcp, :::8320->8320/tcp rtls-le-1 d95d0ae66074 repo.rtlsnet.ru:5000/postgres:9.6 "/entrypoint.sh post…" 44 hours ago Up 5 minutes (healthy) rtls-postgres-1

3. После старта сервисов должны быть доступны пользовательские интерфейсы, где <ip> адрес машины, на которой развернуто ПО РТЛС

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

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

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

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

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

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

   Code Block
   cd rtls docker compose stop

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

   Code Block
   cd ../rtls rm -rf rtls

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

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

1. Посмотреть текущие версии ПО

   Code Block
   docker ps

2. *Получить от РТЛС скрипт update.sql для обновления струкруры БД до нужной версии, если скрипт отсутствует на странице описания релиза, обновление БД не требуется. Не требуется для версий ПО РТЛС выше 6.6

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

   Code Block
   cd rtls docker compose stop

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

   Code Block
   cd ../ mv rtls rtls_bup

5. Скачать и распаковать архив в папку rtls (где <version> версия ПО, которую требуется установить, например v4.3.8)

   Code Block
   mkdir rtls cd rtls export RTLS_VERSION=<version> curl -u <repo-user> -v -

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

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

   Code Block
   cd rtls docker compose stop

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

   Code Block
   cd ../ mv rtls rtls_bup

9. Скачать и распаковать архив в папку rtls (где <version> версия ПО, которую требуется установить, например v4.3.8)

   Code Block
   mkdir rtls cd rtls export RTLS_VERSION=<version> curl -L https://repo.rtlsnet.ru/repository/rawrtls-rtlspublic/srv/releasesrelease/$RTLS_VERSION/RTLS-compose-$RTLS_VERSION.tar.gz -o rtls.tar.gz tar -zxvf rtls.tar.gz rm rtls.tar.gz

10. Скопировать сохраненное состояние БД в новую рабочую директорию

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

11. * Загрузить со страницы с описанием релиза скрипт Положить полученный от разработчиков update.sql файл для обновления БД и положить в папку rtls/postgresЗапустить контейнер rtls_postgres_1 . Для версий ПО РТЛС выше 6.6 пп.7-9 можно пропустить

12. Запустить контейнер postgres

    Code Block
    docker compose up -d postgres

13. * Запустить процедуру обновления БД, заменить update.sql на правильное название файла, если оно отличается

    Code Block
    docker compose up -d postgres

    Запустить процедуру обновления БД

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

14. Скопировать конфигурацию emxq контейнера (если исходная версия ПО РТЛС v5.x и были дополнительные настройки интеграции в EMQX в процессе работы, иначе можно пропустить)

    Code Block
    cp -R ../rtls_bup/emqx/data/* emqx/data/

15. Скопировать параметры конфигурации контейнеров 

    Code Block
    cp -R ../rtls_bup/.env ./
    Code Block
    docker compose exec -ti postgres psql -d postgres -U rtls_pu -f /var/lib/postgresql/data/update.sql

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

    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

17. Дождаться полного старта контейнера srv (статус healthy при опросе статуса контейнеров)

    Code Block

    docker ps CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES c58f0cc80b8e repo.rtlsnet.ru:5000/emqx:4.4.2 "/usr/bin/docker-ent…" 43 hours ago Up 5 minutes (healthy) 1883/tcp, 4369-4370/tcp, 5369/tcp, 6369-6370/tcp, 8081/tcp, 8083-8084/tcp, 8883/tcp, 11883/tcp, 0.0.0.0:18083->18083/tcp, :::18083->18083/tcp rtls-emqx-1 af20240c2d95 repo.rtlsnet.ru:5000/srv:v5.0 "/entrypoint.sh -c s…" 44 hours ago Up 5 minutes (healthy) 0.0.0.0:9993->9993/tcp, :::9993->9993/tcp, 0.0.0.0:80->8080/tcp, :::80->8080/tcp, 0.0.0.0:8300->8081/tcp, :::8300->8081/tcp, 0.0.0.0:443->8443/tcp, :::443->8443/tcp rtls-srv-1 f16b0ad37ef3 repo.rtlsnet.ru:5000/le:v5.0 "/entrypoint.sh '-f …" 44 hours ago Up 5 minutes 0.0.0.0:5683->5683/udp, :::5683->5683/udp, 0.0.0.0:17320-17321->17320-17321/udp, :::17320-17321->17320-17321/udp, 0.0.0.0:8320->8320/tcp, :::8320->8320/tcp rtls-le-1 d95d0ae66074 repo.rtlsnet.ru:5000/postgres:9.6 "/entrypoint.sh post…" 44 hours ago Up 5 minutes (healthy) rtls-postgres-1

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

    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/

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

    Code Block
    docker compose restart srv

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

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

cd rtls
docker compose stop

cd ../rtls
rm -rf rtls

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