Обновление Modus BI

  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» — если обновление успешно применено.

Файл обновления можно скопировать в эту папку через файловую систему. Либо через веб-интерфейс портала — «Настройки портала» / «Импортировать обновление»:

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

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

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

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

  1. Оповещение пользователей.

  2. Остановка портала и создание бэкапа базы метаданных из СУБД PostgreSQL с помощью средств самой субд. Для SQLIte достаточно скопировать файл с метаданными. Остановка портала:

    • для Linux можно использовать команду systemctl stop modusbi;
    • для Windows службу можно остановить через оснастку службы;
    • если портал запущен не как служба, необходимо завершить процесс связанный с исполняемым файлом («modusbi»).

  3. Копирование нужного файла обновления в папку для обновлений («update»).

  4. Запуск портала. В процессе запуска портал попробует применить обновление. Процесс обновления логирует свои действия в основной лог, поэтому контролировать его можно по этому логу.

  5. После применения обновления портал попробует выполнить перезапуск. Текущая реализация работы в режиме службы не всегда позволяет автоматический перезапуск портала, поэтому иногда может требоваться ручная остановка портала и запуск, уже новой версии портала.

Версию портала и его частей можно проверить в разделе Аналитического портала «Лицензия».

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