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

Все права защищены (c) 2001-2011 NetUP (www.netup.ru)
Перепечатка материалов разрешается только с предварительного разрешения
компании NetUP (info@netup.ru)

Предупреждение

В сборке 5.2.1-006 были произведены следующие серьезные изменения:

1. Изменен механизм лицензирования. Если на 22.05.2008 г. или более поздний момент действовала подписка на поставку обновлений, то новая лицензия доступна для генерации в личном кабинете.

2. URFA-функции, связанные с генерацией отчетов, перенесены в библиотеку liburfa-reports. При обновлении необходимо изменить конфигурацию ядра UTM5 таким образом, чтобы данная библиотека была загружена. В противном случае функция генерации отчетов будет недоступна.

3. Изменена структура таблицы discount_transactions_all, в которой хранится информация о списаниях, в связи с чем обновление структуры базы данных может занять существенное время. Для минимизации времени простоя можно использовать функционал архивирования таблиц с информацией о списаниях.

4. Изменены требования интерфейса администратора к минимальной версии установленного JRE. Теперь для работы интерфейса администратора требуется использования версии JRE не ниже, чем 1.6.

Полную информацию о произведенных изменениях можно найти в списке изменений.

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

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

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

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

СУБД: 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. Сгенерируйте в личном кабинете новый лицензионный ключ, активируйте необходимые модули. Загрузите файл лицензионного ключа (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

8. В radius5.cfg и rfw5.cfg измените значение параметра core_port с 11758 на 12758

9. Произведите обновление структуры базы данных.

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

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

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

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

10. Загрузите в базу данных UTM5 новый лицензионный ключ.

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

mysql UTM5 < ~/reg.sql

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

psql -f ~/reg.sql -d UTM5

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

12. Для снижения нагрузки на ядро при активном использовании web-интерфейса в конфигурационном файле web5.cfg рекомендуется установить параметр web_lang в значение "ru".