Инструкция по обновлению версий Fine BI 5.1 до версии Fine BI 6.0.5
Fine BI де-факто становится реальной заменой западным BI-решениям, разработчики которых в той или иной степени решили приостановить работу в России. Но если с функциональностью системы проблем нет и основной вопрос – в ее изучении, то с переходом на новую версию после серьезного обновления есть некоторые сложности в силу относительной молодости решения. Поэтому мы подготовили отдельную статью о том, как перейти с Fine BI 5.1 на 6.0.5 без танцев с бубном и риска потери данных. Отметим, что в финальной части статьи мы также даем рекомендации о том, как обновляться дальше (спойлер: это будет проще).
Подготовка перед обновлением
Перед обновлением необходимо запросить у вашего менеджера по продажам, лицензии на 6 версию FineBI. Лицензии 5 версии не подходят для 6 версии.
Проверьте совместимость
Перво-наперво советуем изучить описание совместимости, чтобы узнать об изменениях между версиями 5.1 и 6.0.
Узнать, какая именно версия FineBI у вас установлена, можно во вкладке Manage> Registration> Version Information:
Отключите лицензию
Если в вашей среде используется официальная лицензия, то есть авторизация со сроком регистрации 100 лет, перед обновлением её необходимо отключить. Пользователям с годовой лицензией не нужно её отключать!
Чтобы посмотреть лицензию, необходимо войти в качестве администратора на вкладку Manage> Registration> Version Information. Если она истекает через 100 лет, то свяжитесь с компанией, у которой вы её приобретали.
Создайте резервную копию
Перед обновлением обязательно нужно выполнить Резервное копирование проекта 5.1, обнаружение и устранение элементов риска обновления. Это действие доступно только администратору, так что нужно войти в систему под аккаунтом администратора. Ниже распишем по пунктам, как это сделать.
Настройте путь резервного копирования
Для этого администратор открывает вкладку Manage> Intelligent Operations> Backup and Restore, нажимает Global Settings и задает путь резервного копирования, как показано на следующем рисунке:
Путь резервного копирования по умолчанию. . / backup, а файлы резервных копий хранятся в папке проекта % FineBI %/webapps/webroot/backup folder.
Пользователи могут изменить папку резервного копирования на другие папки, но сохранение по пути, отличному от проекта, не поддерживается.
Метод резервного копирования
На вкладках Platform Configuration, Report Template, BI Template, JAR Package и Plugin поддерживается как ручное, так и автоматическое резервное копирование.
Если вам необходимо создать резервную копию BI Template, одновременно создавайте резервную копию Platform Configuration, чтобы в будущем можно было успешно восстановить дашборд.
Резервное копирование вручную
Чтобы сделать копирование в ручном режиме, нажмите Manual Backup. Появится диалоговое окно, в котором можно переименовать резервную копию, затем нажмите OK - резервное копирование вручную завершено. Выглядит это так, как показано ниже:
Автоматическое резервное копирование
Администратор может установить Backup Frequency (Частота резервного копирования), Number of Copies(Максимальное количество копий), Backup Capacity(Резервная емкость) и Backup Failure Reminder(Напоминание об ошибке резервного копирования) для автоматического резервного копирования в Global Settings, как показано ниже:
Обновление в ОС Windows
Закройте проект BI
Среди пользователей детектируется распространенная проблема: прямое закрытие проекта FineBI в системе Windows может не остановить плагин защиты от сбоев, что приведет к невозможности заменить файлы JAR во время процесса обновления и приведет к сбою обновления.
Решение данной проблемы таково: в командной строке введите jps, чтобы проверить, существует ли процесс с именем Operation. Если это так, введите taskkill /f /pid %pid%, чтобы завершить процесс с именем Operation.
Чтобы проверить, был ли процесс закрыт полностью, переименуйте файл lib в %FineBI%\webapps\webroot\WEB-INF, и если файл можно переименовать, это означает, что проект полностью закрыт. Не забудьте изменить имя файла обратно после проверки.
Загрузите инструмент обновления для вашей ОС
Windows:
https://fineoverseas-download.obs.myhuaweicloud.com/FineBI/upgrade/fine-bi-upgrade-windows-en.zip
Linux:
https://fineoverseas-download.obs.myhuaweicloud.com/FineBI/upgrade/fine-bi-upgrade-linux-en.zip
https://fineoverseas-download.obs.myhuaweicloud.com/FineBI/upgrade/fine-bi-upgrade-linux-arm-en.zip
Разархивируйте инструмент обновления
После того, как вы разархивировали инструмент обновления*, перейдите к папке Fine-bi-upgrade-windows\bin и отредактируйте файл JvmConfig.properties, чтобы добавить памяти. Если вы не редактируете файл, то по умолчанию будет выделена 1/4 проекта BI:
Обновление
Дважды щелкните файл start-upgrade.bat, чтобы запустить инструмент обновления. Выберите Closed и нажмите Next:
Выберите %FineBI%\webapps\webroot в качестве Project path и нажмите Start detection:
После завершения обнаружения нажмите Next:
Выберите режим ** и нажмите Start Upgrade:
После завершения обновления нажмите Next:
Обновление завершено.
Проверка отчета об обновлении
Вы можете проверить файл upgrade.log в разделе Fine-bi-upgrade-windows\logs.
Обнаруженные элементы риска находятся под Fine-bi-upgrade-windows\exports.
Запуск проекта
Запустите проект и нажмите Global Update Now во всплывающем окне:
Щелчок по Global Update Now инициирует обновление всех наборов данных самообслуживания, настроенных для обновления с помощью родительской таблицы.
Пока обновление не будет завершено, доступ к любому URL-адресу проекта будет перенаправлять на следующую страницу, и доступ к проекту будет недоступен.
Обратите внимание: будут обновлены только наборы данных самообслуживания, а базовая таблица обновлена не будет.
Обновление Linux
Закройте проект FineBI
Введите следующую команду для просмотра процесса FineBI: ps -ef | grep finebi
Число 791 на данном скриншоте – это ID процесса Fine BI.
Чтобы остановить процесс Fine BI, выполните команду:
sudo kill -9 791
Разархивируйте инструмент обновления
Загрузить на сервер дистрибутив можно с помощью команды wget . Затем разархивируйте средство обновления. Перейдите к папке Fine-bi-upgrade-windows\bin и отредактируйте файл JvmConfig.properties. Если вы не редактируете файл, по умолчанию будет выделена 1/4 проекта BI.
В fine-bi-upgrade-linux\bin введите команду для запуска средства обновления:
./start-upgrade.sh
Введите 2 и нажмите Enter, чтобы запустить средство обновления.
Обновление
Выберите %FineBI%\webapps\webroot в качестве пути к проекту и нажмите Enter, чтобы начать обнаружение. После завершения обнаружения обновления появится сообщение Next Step.
Введите номер для выбора режима ** и нажмите Enter. Дождитесь завершения обновления.
Проверьте отчет об обновлении. Вы можете проверить файл upgrade.log в разделе fine-bi-upgrade-linux\logs. Обнаруженные элементы риска находятся под fine-bi-upgrade-linux\exports.
Запуск проекта BI
Запустите проект BI и щелкните Global Update Now.
Как обновлять версии после 6.0.5
Перейдите в раздел Manage> Intelligent Operations> Backup and Restore и нажмите Manual Backup в разделах Platform Configuration, Report Templates, JAR Packages и Plugins соответственно.
Если на странице Manage> Intelligent Operations> Backup and Restore вы видите подсказку the current environment is a built-in database that does not support the backup and restore function, это означает, что у вас старая версия FineBI, которая не поддерживает функцию резервного копирования и восстановления. В этом случае вам нужно вручную скопировать шесть папок (dashboards, embed, lib, plugins, reportlets, resources) из %FineBI%/webroot/WEB-INF в %FineBI%/webroot/backup.
Закройте проект FineBI.
Вручную замените файлы JAR в каталоге %FineBI%/webroot/WEB-INF/lib.
Локальную версию просто перезапустите. А чтобы запустить серверный проект, замените файлы JAR и начните с одного узла. Убедитесь, что узел запускается без ошибок, прежде чем запускать остальные узлы один за другим. Избегайте одновременного запуска всех узлов.
Чтобы проверить версию регистрационной информации, выберите Manage > Registration > Version Information.
Обновление завершено.
Проверка после обновления
После завершения обновления:
1.Протестируйте учетные записи администратора и обычного пользователя, чтобы обеспечить успешный вход в систему.
2. Войдите в систему и перейдите на страницу Manage> Plugin. Выполните обновления плагинов в соответствии с запросами.
*Дистрибутивы, которые представлены вендором:
https://intl.finebi.com/download
https://datafinder.ru/downloads
**Режим обновления
Для обновления до версии 6.0 доступны четыре режима обновления.
Режим |
Описание |
Extract mostly |
Spider: Структура The business package сохранена Direct: The business package упакована и перемещена в Public business package – direct |
Direct mostly |
Direct: Структура The business package сохранена Spider: The business package упакована и перемещена в Public business package – spider |
Fold both |
Spider: The business package перемещена в Public business package – spider Direct: The business package перемещена в Public business package – direct |
Merge both |
Структура The business package Spider и Direct сохраняется и отображается вместе Прим.:если существуют два The business package с одинаковыми именами в режиме spider и direct, то бизнес-пакет в режиме direct будет иметь приставку direct |