Обновление системы Pilot

Все компоненты системы должны быть одной версии. Подключение компонентов других версий к Pilot-Server для работы блокируется во избежание проблем совместимости.

Исключениями являются: Pilot-TextSearch-Server, Pilot-Sign-Server, 3D-Storage for Linux.

Обновление системы Pilot, если все компоненты установлены на ОС Windows

Информация о появлении обновления выводится администратору системы при запуске настольного приложения Pilot-myAdmin.

Если вы хотите получать уведомления о выходе не только релизов, но и бета-версий, то в меню Сервис→ Настройки включите опцию Проверять наличие бета-версий.

Дистрибутив обновления Pilot-Server содержит в себе все необходимые компоненты для обновления клиентских приложений под Windows.

Чтобы запустить обновление:

Получив уведомление в Pilot-myAdmin администратору необходимо нажать кнопку Обновить,
затем подтвердить решение в диалоговом окне с предупреждением.

После этого пакет обновления будет автоматически загружен и запущено обновление Pilot-Server.

Пользователям Pilot-Server, установленного на Windows, настраивая работу баз данных, следует обратить внимание, что при автоматических обновлениях системы, служба Pilot-Server запускается от учётной записи Local System. В том случае, если запуск службы должен осуществляться от другой учётной записи с правами администратора, необходимо переназначить её вручную.

Как только Pilot-Server обновится, он отправит обновления всем клиентским приложениям, включая Pilot-myAdmin, и службам, которые к нему подключаются.

Клиентское приложение при этом перейдёт в режим автономной работы, пользователь получит сообщение о необходимости применить обновление. Для установки обновлений клиентских приложений права администратора не требуются. Пользователь может запустить установку обновления сразу или отложить на некоторое время и сначала завершить свою текущую работу в автономном режиме. В этом случае, все локальные изменения будут отправлены на сервер после обновления приложения и восстановления соединения с сервером.

Pilot-BIM-Server обновляется автоматически в фоновом режиме.

Поскольку изменения в Pilot-TextSearch-Server и Pilot-Sign-Server происходят не часто, обновления чаще всего не требуется. При необходимости эти службы обновляются вручную. Для этого:

Перейдите на сайт загрузок.
Скачайте оттуда дистрибутив.
Запустите его и выполните обновление.

Обновление компонентов системы, установленных в docker-контейнерах

Чтобы иметь возможность автоматического обновления системы Pilot, развёрнутой в контейнерах, необходимо осуществить её установку с помощью Docker Compose. Эту утилиту для запуска мультиконтейнерных приложений можно установить с помощью документации https://docs.docker.com/compose/. После этого следуйте инструкции ниже.

Подготовка

Cоздайте папки:
# mkdir -p /usr/share/ASCON/'Pilot Server'/License
# mkdir -p /usr/share/ascon/pilot-server/settings
# mkdir -p /usr/share/ascon/databases
Cоздайте файл /usr/share/ascon/pilot-server/settings/settings.xml с содержимым "<Configuration></Configuration>":
$ echo "<Configuration></Configuration>" | # tee -a /usr/share/ascon/pilot-server/settings/settings.xml
Cкачайте и распакуйте демонстрационные базы данных, если собираетесь их использовать:

# wget https://pilot.ascon.ru/beta/Databases.zip

# unzip Databases.zip

Переместите нужную базу (например pilot-bim_ru) в расположение баз данных:

# cp -r ./Databases/pilot-bim_ru /usr/share/ascon/databases/
Перенесите лицензию в папку лицензий:

# cp License.lic /usr/share/ASCON/'Pilot Server'/License/

Запуск

Скачайте файл docker-compose.yml или скопируйте его содержимое и отредактируйте.

Перейдите в расположение файла docker-compose.yml и запустите его:

# docker compose up -d

Это действие затянет и запустит 4 контейнера:

pilotdev/pilot-server:latest
pilotdev/pilot-bim-server:latest
pilotdev/pilot-web-server:latest
pilotdev/pilot-web-myadmin:latest

Настройка

Создайте администратора сервера:

# docker exec -ti pilot-server ./Ascon.Pilot.Daemon --admin /usr/share/ascon/pilot-server/settings/settings.xml имя_администратора_сервера пароль_администратора_сервера
Подключите базу данных. Например, pilot-bim_ru подключается так:

# docker exec -ti pilot-server ./Ascon.Pilot.Daemon --attach pilot-bim_ru /usr/share/ascon/databases/pilot-bim_ru/base.dbp /usr/share/ascon/databases/pilot-bim_ru/FileArchive/44191f9c-c8a4-4689-b38b-474f2aba4465.pilotfa
- Откройте web-редакцию Pilot-myAdmin по адресу http://0.0.0.0:5553/ и войдите под учётной записью администратора сервера, созданной на шаге 1.
- Перейдите на вкладку Организационная структура и создайте пользователя для работы с Pilot-BIM-Server bimadmin или измените его пароль, если пользователь уже существует.
- Создайте ещё одного пользователя в качестве администратора базы данных или измените пароль предустановленного в демонстрационных базах данных пользователя sedov.
Если ваша лицензия позволяет работать с моделями, то подключите Pilot-BIM-Server:

# docker exec -ti pilot-bim-server ./pBimAdmin -c http://pilot-server:5545/pilot-bim_ru

Введите имя пользователя bimadmin и его пароль.
Веб-редакция системы Pilot готова к использованию по адресу http://0.0.0.0:5552. Для проверки войдите под администратором базы данных или пользователем sedov с соответствующим паролем.

Обновление на свежую версию

Перед обновлением проверьте файл docker-compose.yml. Для обновления на последнюю бета-версию имя образа контейнеров должно заканчиваться на тег latest. Для обновления на релизную версию должен быть указан тег release. Например, registry.ascon.ru/project/pilotdev/pilot/pilot-server:release.

Перейдите в папку с docker-compose.yml, который управляет стеком контейнеров Pilot. Завершите работу стека с одновременным удалением docker-образов:

# docker compose down --rmi all
Запустите стек. Docker Compose затянет свежие образы и запустит стек на их основе.

# docker compose up -d

Обновление компонентов системы, установленных на OC Linux

Для обновления Pilot-Server, установленного на OC Linux без использования контейнера, ознакомьтесь со следующими страницами:

Особенности обновления в кластерном режиме

Перед обновлением Pilot-Server, работающем в кластерном режиме, необходимо сделать резервную копию базы банных PostgreSQL.