Инструкция по обновлению биллинговой системы UTM 5 до версии 5.3-003

Все права защищены (c) 2001-2015 NetUP (www.netup.ru)
Перепечатка материалов разрешается только с предварительного разрешения
компании NetUP (info@netup.ru)
Инструкция по обновлению биллинговой системы UTM 5 до версии 5.3-003
Если обновление производится со сборки 5.3-001-update5 или старше, настоятельно рекомендуется также изучить инструкции по обновлению и списки изменений для предыдущих выпущенных сборок.

 

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

При обновлении до 5.3-003-update8 и выше, во избежание проблем с автоматической конвертацией данных в таблице dtagg_iptraffic, рекомендуется в настройках СУБД MySQL установить параметр max_allowed_packet не менее 32M.

 

  1. Инструкция по обновлению

    1. Остановите компоненты системы UTM5 (ядро биллинговой системы, радиус-сервер, utm5_rfw и т.д.).

    Например, для Linux, выполните команды:

    /etc/init.d/utm5_core stop

    /etc/init.d/utm5_radius stop

    /etc/init.d/utm5_rfw stop

    Далее следует убедиться в том, что службы остановлены:

    ps aux | grep utm5_core

    ps aux | grep utm5_radius

    ps aux | grep utm5_rfw

    1. Произведите резервное копирование конфигурационных файлов из директории /netup/utm5/.
       
    2. Убедитесь в наличии актуальной резервной копии SQL базы данных и детальной информации о трафике. В случае отсутствия резервной копии, произведите резервное копирование SQL базы данных (например, утилитами mysqldump, pg_dump). Убедитесь в том, что все данные можно восстановить из резервной копии.
       
    3. Удалите старый пакет UTM5.

      Например, в дистрибутивах ОС Debian GNU/Linux, удаление производится командой:

      dpkg -r utm5

      В ОС FreeBSD командой:

      pkg_delete utm5
       
    4. Установите пакет UTM5.

      Например, в дистрибутивах ОС Debian GNU/Linux, установка производится командой:

      dpkg -i utm-5-X.XXX.deb

      В ОС FreeBSD командой:

      pkg_add utm5-X-X-XXX.tgz
       
    5. При первом запуске новой версии ядра производится автоматическое обновление структуры БД. В связи с этим необходимо, чтобы учетная запись пользователя БД, используемая ядром UTM5, обладала правами, необходимыми для создания и изменения таблиц БД.

    При необходимости возможно обновление структуры БД вручную.

    Например, при использовании СУБД MySQL, обновление производится командой:

    mysql -f UTM5 < /netup/utm5/UTM5_MYSQL_update.sql

    Или, при использовании СУБД PostgreSQL, командой:

    psql -f /netup/utm5/UTM5_PG_update.sql -d UTM5
     

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

    verify_database_index=enable

    Следует учесть, что эта операция может занять много времени.

    При необходимости, произведите обновление индексов базы данных вручную.

    Например, при использовании СУБД MySQL, обновление производится командой:

    mysql -f UTM5 < /netup/utm5/UTM5_indexes.sql

    Или, при использовании СУБД PostgreSQL, командой:

    psql -f /netup/utm5/UTM5_indexes.sql -d UTM5

    Внимание. Данная операция может занять значительное количество времени. Для минимизации времени простоя можно использовать функционал архивирования таблиц с информацией о списаниях.
     

    1. При обновлении со сборки 5.3-001 и старше, после распаковки дистрибутива, приведения файлов конфигурации системы в актуальное состояние, и обновления схемы БД (непосредственно перед первым запуском ядра системы) необходимо произвести конвертацию старого функционала пересчета услуг в новый функционал "политик списания". Для этого предназначен автоматический конвертер, входящий в состав дистрибутива. Запуск конвертера в общем случае:

      /netup/utm5/bin/block_conv -v старая_версия_биллинга

      Где старая_версия_биллинга:

      007 - 5.2.1-007 и обновления
      008 - 5.2.1-008 и обновления
      009 - 5.2.1-009 и обновления (значение по-умолчанию)
      5.3 - 5.3-001 и обновления (значение, функционально аналогичное 009)

      Далее конвертер отобразит настройки конвертации, в случае их корректности необходимо подтвердить согласие с настройками.
       
    2. В случае каких-либо изменений в лицензии, например, при приобретении дополнительных модулей UTM5, необходимо обновить данные о лицензии

    Для этого до первого запуска обновленного ядра системы, поместите файл reg.sql в директорию /netup/utm5

    При первом запуске обновленное ядро автоматически загрузит лицензионный ключ из файла /netup/utm5/reg.sql в БД и удалит этот файл

    1. Для использования модуля utm5_dhcpd необходимо:

      - обновить лицензию (если предполагается коммерческая эксплуатация модуля, иначе модуль работает в демо-режиме)

      - отредактировать файл конфигурации /netup/utm5/dhcpd5.cfg и указать:
      a) актуальные настройки доступа к БД UTM5
      б) актуальные настройки доступа к ядру системы utm5_core по протоколу Stream
      в) список обслуживаемых сетевых интерфейсов

      - при необходимости (см. п. "б") добавить системного пользователя для сервиса utm5_dhcpd, по умолчанию используется учетная запись с логином "dhcp" и паролем "dhcp", доступ разрешен с адреса 127.0.0.1. Данный пользователь добавляется только при инициализации новой БД!
       
    2. Произведите запуск компонентов системы UTM5 (ядро биллинговой системы, радиус-сервера, utm5_rfw и т.д.).

    Например, в случае ОС Debian GNU/Linux, выполните команды:

    /etc/init.d/utm5_core start

    /etc/init.d/utm5_radius start

    /etc/init.d/utm5_rfw start

    1. Система формирования документов UTM 5.3-003 не совместима с предыдущими версиями. Рекомендуем ознакомиться с документацией UTM5, и, при необходимости, обновить шаблоны документов. Для возможности генерации документов в формате PDF требуется наличие на сервере с UTM5 пакета LibreOffice (в противном случае документы генерируются в формате ODT).