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

Если обновление производится со сборки 5.2.1-006 или ниже, настоятельно рекомендуется также изучить инструкции по обновлению и списки изменений для предыдущих выпущенных сборок.

 

Поддерживаемые версии программного обеспечения

Аппаратная платформа: x86

Операционные системы: FreeBSD 4.11, 5.5, 6.2 (openssl 0.9.8), 7.0, 8.0, RedHat Enterprise Linux 5.0, CentOS 5.0, Debian Etch, Debian Sarge, Gentoo 2007, RedHat 9, Debian Lenny (начиная с 5.2.1-007-rc2)

СУБД: mysql 5.0.x, mysql 4.1.x, mysql 4.0.x, postgresql 8.2.x, postgresql 8.1.x, postgresql 8.0.x

Аппаратная платформа: x86

Операционная система: Windows 2003 Server

СУБД: mysql 5.0.x

Аппаратная платформа: sparc

Операционная система: Solaris 9 (32-bit glibc, libpthread, libstdc++, libssl 0.9.7) - сборка предоставляется по требованию

СУБД: mysql 5.0.x

Рекомендуемые версии программного обеспечения

Аппаратная платформа: x86

Операционные системы: FreeBSD 6.2 (openssl 0.9.8), RedHat Enterprise Linux 5.0, CentOS 5.0, Debian Etch, Gentoo 2007

СУБД: mysql 5.0.51

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

  1. При обновлении с версии 5.2.1-006 и более ранних, при использовании модулей UTM5 Dynashape, модуля интеграции с 1С, сгенерируйте в личном кабинете новый лицензионный ключ, активируйте необходимые модули. Загрузите файл лицензионного ключа (reg.sql) на сервер.
  2. Остановите компоненты системы UTM5 (ядро биллинговой системы, радиус-сервер, utm5_rfw и т.д.).
  3. Произведите резервное копирование конфигурационных файлов из директории /netup/utm5/.
  4. Убедитесь в наличии актуальной резервной копии SQL базы данных и детальной информации о трафике. В случае отсутствия резервной копии, произведите резервное копирование SQL базы данных (например, утилитами mysqldump, pg_dump). Убедитесь в том, что все данные можно восстановить из резервной копии.
  5. Удалите старый пакет UTM5.

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

    rpm -e utm-5

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

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

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

    rpm -ihv --nodeps utm-5-X-X-XXX.i386.rpm

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

    pkg_add utm5-X-X-XXX.tgz

  7. Откорректируйте конфигурационные файлы в директории /netup/utm5/. В файле utm5.cfg обязательно должны присутствовать строки:
    urfa_lib_file=/netup/utm5/lib/utm5_core/liburfa-std.so
    urfa_lib_file=/netup/utm5/lib/utm5_core/liburfa-utils.so
    urfa_lib_file=/netup/utm5/lib/utm5_core/liburfa-reports.so
    urfa_lib_file=/netup/utm5/lib/utm5_core/liburfa-user.so

    При использовании UTM5 Dynashape:

    urfa_lib_file=/netup/utm5/lib/utm5_core/liburfa-dynashape.so

    При использовании модуля интеграции с 1С:

    urfa_lib_file=/netup/utm5/lib/utm5_core/liburfa-ic.so
  8. Произведите обновление структуры базы данных.

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

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

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

    psql -f /netup/utm5/UTM5_PG_update.sql -d UTM5
  9. Произведите обновление индексов базы данных.

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

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

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

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

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

  10. Произведите обновление списка шаблонов (только для версии 5.2.1-008-beta)

  11. Загрузите файл обновления списка шаблонов из личного кабинета. Поместите его в текущую директорию с именем UTM5_templates_update.sql.

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

    mysql -f UTM5 < UTM5_templates_update.sql

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

    psql -f UTM5_templates_update.sql -d UTM5

  12. Произведите конвертацию правил файрвола (при обновлении с версии 5.2.1-007 и выше, выполнение данного пункта не обязательно)

    Обновление осуществляется командой:

    /netup/utm5/bin/fix_fwrules -f

  13. В случае обновления с версии 007 или ниже рекомендуется выполнить конвертацию таблицы dtagg_iptraffic перед первым запуском нового ядра:

    /netup/utm5/bin/dtagg_conv -f

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

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

    Например, при использовании СУБД MySQL:

    mysql UTM5 < reg.sql

    Или, при использовании СУБД PosgreSQL:

    psql -f reg.sql -d UTM5
  15. Произведите запуск компонентов системы UTM5 (ядро биллинговой системы, радиус-сервера, utm5_rfw и т.д.).
  16. В интерфейсе администратора UTM5 проверьте корректность преобразования правил файрволла (если выполнялся пункт 11)
  17. В случае необходимости проверьте параметры динамического шейпирования, и настройки синхронизации с 1С.