По мере обнаружения ошибок в текущей версии программы выпускаются обновления в виде новых билдов (сборок). Каждый новый билд модуля сопровождается комментарием к сделанным исправлениям. Комментарии доступны на странице загрузки продукта.
Периодически следует сверять текущие установленные билды модулей и плагинов с доступными на сайте. Для получения информации по версиям и билдам компонентов биллинга воспользуйтесь меню Справка=>О программе.
В верхней области отображаются версии и билды клиента и сервера. Обновление клиента и сервера доступны на сайте единым пакетом. Ниже перечислены установленные в системе модули и плагины, их версии и билды.
С версии 8.2104+ используется новый механизм установки обновлений
На сервере биллинга запустить скрипт update.sh (при этом на время обновления произойдет остановка сервера биллинга и планировщика, учитывайте это при выборе момента запуска обновления)
После запуска выберите из меню пункт 2
выберите сборку на которую хотите обновиться, 1 - самая последняя
После загрузки обновлений выберите из меню 0 для выхода и запуска сервера биллинга и планировщика
Для версий младше 8.0
Для установки модулей и плагинов используется утилита bg_installer.sh (.bat).
./bg_installer.sh <имя_файла_с_модулем>
Для Linux.
bg_installer.bat <имя_файла_с_модулем>
Для Windows.
Файл с модулем должен быть загружен и располагаться в каталоге BGBillingServer.
При установке обновлений следует останавливать процесс сервера биллинга, планировщика и загрузчика логов и запускать их после установки пакетов.
Для установки обновления пакет модуля, либо плагина необходимо установить повторно. Поддерживается автоматическое обновление с FTP-сервера ftp://bgbilling.ru. Для обновления системы остановите сервер биллинга, планировщик и загрузчик логов а затем выполните команду:
./bg_installer.sh update
Для Linux платформы.
bg_installer.bat update
Для Win платформы.
Инсталлятор проверит наличие обновлений и предложит их установить выбрав нажав клавишу y.
[bill@bill-reg BGBillingServer]$ ./bg_installer.sh update Update starting.. Update from ftp://bgbilling.ru/pub/bgbilling Server version is 4.4 Changing dir to /pub/bgbilling/4.4 Checking updates for ru.bitel.bgbilling.plugins.crm.. Found update for crm build 50 packet crm_4.4_52.zip updating to build 52 Checking updates for ru.bitel.bgbilling.plugins.documents.. Checking updates for card.. Checking updates for dialup.. Checking updates for email.. Checking updates for ipn.. Checking updates for npay.. Checking updates for reports.. Checking updates for voiceip.. Checking updates for bill.. Checking updates for gorod.. Checking updates for server.. Found update for BGBillingServer build 102 packet update_4.4.zip updating to build 104 Checking updates for client.. Install 2 updates (y/n):
Возможно установить только все обновления сразу. Также необходимо останавливать сервер, планировщик и загрузчик логов до обновления и стартовать после.
Не забывайте делать резервную копию каталога BGBillingServer при установке обновлений. Обновление перетирает все XSLT-шаблоны и многие другие файлы, заменяя их стандартными из пакета.
Для Linux также есть скрипт update.sh, который самостоятельно останавливает службы, запускает процесс обновления и стартует службы после. Кроме того, он сохраняет лог процесса обновления в файл.
Для предотвращения перетирания файла при обновлении вы можете перед его модификацией создать копию с именем <file_name>.orig (например, style.css.orig). При установке пакета инсталлятор будет проверять перед записью каждого файла наличие файла с таким же именем в текущей установке. Если файл существует, но отличается от того, что в пакете, то предпринимается попытка найти файл <file_name>.orig . Если orig-файл существует и не отличается от файла из нового пакета, то ничего не будет перезаписано, система сообщит: File doesn't changed <filePath>. Если же и оригинальный файл не совпадает со вновь предлагаемым из новой версии пакета, файл будет записан.
Перечень перезаписанных файлов сообщается после завершения процедуры установки, либо обновления после фразы REPLACED FILES:. Вы должны вновь внести в данные файлы требуемые корректировки и снова создать .orig-копию файла (из нового файла из дистрибутива).
Обновление клиента происходит автоматически при последующем подключении к серверу биллинга и установленной опции Загружать обновления с данного сервера.
При выходе новых версий биллинга предоставляется инструкция по переходу на новую версию ПО, далее в пределах версии обновление производится по описанному выше алгоритму.
В системе обновления биллинга работает механизм предотвращения повторного выполнения SQL-запросов обновления базы данных, что значительно ускоряет обновление системы. Выполненные SQL-запросы кэшируются и хранятся в базе данных биллинга. В случае, если по какой-либо причине необходимо повторное выполнение SQL-запросов при обновлении модуля (или ядра), то необходимо запустить
./bg_installer.sh killhash <entity_id>
для Linux или
bg_installer.bat killhash <entity_id>
для Windows,
где <entity_id> - код сущности, для которой необходимо уничтожить кэш SQL-запросов (для ядра = 0; для плагина = код плагина из Плагины => Настройки плагинов; для экземпляра модуля = m<mid>, где <mid> - код экземпляра модуля из Модули => Редактор модулей и услуг).
Например:
./bg_installer.sh killhash m10
Обновление других серверных приложений
Все сторонние приложения получают обновления от сервера биллинга (серверные приложения, CashCheck-сервер итд). Единый набор серверных библиотек биллинга на всех приложениях обеспечивает унифицированную среду для работы скриптов и расширений. Для обновления приложения используется скрипт update.sh (.bat). В момент обновления BGBillingServer должен быть запущен. Также нужно убедиться что в aplication.xml (или соответствующем) прописан путь до корня сервлетов сервера биллинга ("server.update.url"), см. Установка приложений биллинга (BGInetAccess, BGVoiceProcwssor и др.) (с версии 8.2104).
Следите, чтобы все ваши серверные приложения были обновлены!
Данная схема распространяется только на серверные приложения, связанные с ядром через JMS. Изолированные приложения обновляются отдельно. У них нет скрипта update.*. К таким приложениям относятся, например, DHCP-сервер модуля IPN.
Снапшоты
В данный момент есть версия скрипта только для ОС Linux! Для Windows выполняйте требования по резервному копированию перед обновлением!
Для сохранения текущего состояния библиотек биллинга, каталога webroot, данных по установленным модулям и плагинам в БД с BGBilling поставляется скрипт snapshot.sh. Для создания снапшота вызовите перед обновлением:
./snapshot.sh create
Снапшоты сохраняются архивами в каталог BGBillingServer/snapshots. Для восстановления снапшота команда:
./shapshot.sh restore <FILE>
, где <FILE> - имя файла со снапшотом.
Восстановив сервер из снапшота необходимо обновить с него все другие серверные приложения. Функционал скрипта реализован исключительно сторонними приложениями и может быть легко скорректирован.