Обновление

  2 минутное чтение  

Обновление выполняется с помощью файлов *.mbu.

В имени файла указывается

  • ОС для которой обновление предназначено(linux/windows)
  • версия АП(X.Y.Z) с которой это обновление можно применить
  • версия АП(X.Y.Z), которая будет результатом обновления

Например, файл обновления modusbi-windows-3.0.0-3.1.9.mbu предназначен для обновления АП развернутого на windows, для любой версии АП начиная с 3.0.0 (подойдут порталы версии 3.0.0, 3.0.1, … ,3.0.9, 3.1.3 и т.д.). После успешного обновления версия АП будет установлена в 3.1.9

Перед обновлением портала необходимо сделать копию базы метаданных средствами postrge SQL

ВАЖНО! До версии 3.0.0 обновление было не кумулятивным и требовалось строгое совпадение номеров версий обновляемого портала, и версии применяемого обновления. Например, обновление modusbi-linux-2.4.0-2.4.4.mbu можно установить только если версия портала 2.4.0. Применить такое обновление для портала версии 2.4.1 нельзя.

Поиск подходящих файлов обновлений и их применение выполняется всегда автоматически при запуске портала, до старта основного функционала.

Поиск файлов обновления выполняется в каталоге update по месту установки портала. Путь до каталога задается в параметре update.path файла настроек modusbi.json

После обработки у файла обновления добавляется расширение в имени:

  • invalid - если обновление не удалось применить
  • apply - если обновление успешно применено

Файл обновления можно скопировать в эту папку через файловую систему. Либо через веб-интерфейс портала - “Настройки портала” - “Импортировать обновление” (Рисунок 1) image (Рисунок 1. Настройки портала)

Если при старте портала было найдено подходящее обновление, то портал выполняет бэкап основных файлов портала:

  • исполняемый файл портала
  • файл настроек
  • файл базы метаданных для базы формата SQLite

Бэкап сохраняется в папке заданной в настройках backup.path. По умолчанию папка backup. Формат mbb - суть zip архив с дополнительной метаинформацией в файле.

Процедура обновления портала состоит из следующих этапов:

  1. Оповещение пользователей.
  2. Остановка портала и создание бэкапа базы метаданных из СУБД PostgreSQL с помощью средств самой субд. Для SQLIte достаточно скопировать файл с метаданными. Остановка портала:
  • для linux можно использовать команду systemctl stop modusbi
  • для windows службу можно остановить через оснастку службы
  • если портал запущен не как служба, необходимо завершить процесс связанный с исполняемым файлом(modusbi).
  1. Копирование нужного файла обновления в папку для обновлений(update)
  2. Запуск портала. В процессе запуска портал попробует применить обновление. Процесс обновления логирует свои действия в основной лог, поэтому контролировать его можно по этому логу.
  3. После применения обновления портал попробует выполнить перезапуск. Текущая реализация работы в режиме службы не всегда позволяет автоматический перезапуск портала, поэтому иногда может требоваться ручная остановка портала и запуск, уже новой версии портала.

Версию портала и его частей можно проверить на странице Лицензия

ВАЖНО! Остановка и запуск портала могут потребовать административных (root) прав. До обновления нужно проверить их наличие.