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

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

Внимание! Перед обновлением системы внимательно прочитайте
список изменений

Инструкция по обновлению UTM5 до сборки 5.2.1-005 для UNIX-подобных ОС

Внимание! В случае использования ОС FreeBSD 6.х следует перед началом процедуры обновления установить пакет openssl версии 0.9.8

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

    • Произведите резервное копирование конфигурационных файлов из директории /netup/utm5/.

    • Убедитесь в наличии актуальной резервной копии SQL базы данных и детальной информации о трафике. В случае отсутствия резервной копии, произведите резервное копирование SQL базы данных (например, утилитами mysqldump, pg_dump). Убедитесь в том, что все данные можно восстановить из резервной копии.

    • Удалите старый пакет UTM5.

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

rpm -e utm5

Или в ОС FreeBSD командой:

pkg_delete utm5

    • Установите пакет UTM5.

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

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

Или в ОС FreeBSD командой:

pkg_add utm5-X-X-XXX.tgz
    • Произведите корректировку конфигурационных файлов в директории /netup/utm5/. В файле utm5.cfg обязательно должна присутствовать строка: urfa_lib_file=/netup/utm5/lib/utm5_core/liburfa-std.so

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

    • Произведите обновление базы данных.

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

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

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

psql -f /netup/utm5/UTM5_PG_update.sql UTM5
  • Произведите запуск компонентов системы UTM5 (ядра биллинговой системы, радиус-сервера, utm5_rfw и т.д.).




Инструкция по обновлению UTM5 до сборки 5.2.1-005 для платформы Win32 с переходом на новую версию MySQL

Внимание! В сборке 5.2.1-005 изменен порядок поставки сервера БД в дистрибутиве, расположение исполняемых файлов и библиотек. Перед началом процедуры обновления следует внимательно и до конца прочитать данную инструкцию. В противном случае возможна потеря данных.

Конфигурационные файлы UTM5 подверглись существенным изменениям. Рекомендуется производить конфигурацию UTM5 при помощи файлов конфигурации, поставляемых с данной сборкой.

Для обновления UTM5 до сборки 5.2.1-005 выполните следующую процедуру:

    • Остановите службы utm5_core, utm5_radius, utm5_rfw, utm5_unif и utm5_unif_web, если они запущены.

    • Перейдите в директорию с установленным UTM5. Далее перейдите в директорию mysql\bin. Выполните команду:

      mysqldump UTM5 > UTM5.sql

      Если параметры доступа к БД отличны от параметров по умолчанию, передайте утилите mysqldump данные параметры.

    • Остановите службу MySQL database server.

    • Скопируйте файл UTM5.sql. Скопируйте директорию db. Скопируйте директорию mysql\data для возможности восстановления данных в случае сбоя.

    • Удалите старую версию UTM5 с помощью пункта Установка и удаление программ панели управления Windows.

Произведите удаление, в том числе и всех модифицированных файлов.

    После завершения удаления ещё раз удалите старую версию (для удаления записи о UTM5 из списка установленных программ).
  • Удалите службы UTM5 и MySQL, выполнив команды:

    sc delete utm5_core

    sc delete utm5_radius

    sc delete utm5_rfw

    sc delete utm5_unif

    sc delete utm5_unif_web

    sc delete mysql

  • Запустите установщик новой версии. Выберите язык установщика. Выберите директорию, в которую будет установлен UTM5. Выберите компоненты, необходимые для установки.

    При обновлении основного сервера выберите как минимум Базовая система UTM5 и Сервер MySQL 5.

  • Введите параметры доступа к БД, если параметры отличаются от параметров по умолчанию. Укажите директорию, в которую следует установить MySQL. Выберите Обновить структуру базы данных. Укажите директорию, содержащую файл лицензии.

  • При помощи автоматически запустившегося установщика установите MySQL. С помощью конфигуратора MySQL указажите следующие опции:

    • тип сервера - как минимум server machine;
    • тип базы - transactional only;
    • кодировка по умолчанию - utf8;

    Если установщику UTM5 указывались параметры доступа к БД, отличные от параметров по умолчанию - укажите конфигуратору эти параметры в настойках безопасности. В противном случае - снимите опцию modify security settings. Директорию с установленным MySQL следует включить в директории поиска исполняемых файлов Windows.

  • С помощью утилиты mysqladmin создайте базу данных, указанную установщику UTM5. При использовании параметров, указанных по умолчанию, выполняемая для создания базы данных команда выглядит следующим образом: mysqladmin -u root create UTM5

  • Восстановите данные из резервной копии БД. При использовании параметров, указанных по умолчанию, выполняемая для восстановления базы данных команда выглядит следующим образом:

    mysql - u root UTM5 < UTM5.sql

    где UTM5.sql - путь к файлу UTM5.sql, скопированному в п.4.

  • Перейдите в директорию с установленным UTM5. Выполните команду:

    mysql -u root -f UTM5 < UTM5_MYSQL_update.sql

    Если параметры доступа к БД отличны от параметров по умолчанию, передайте утилите mysql данные параметры.

  • Добавьте в конфигурационный файл utm5.cfg параметр

    database_charset=utf8.

  • Скопируйте файлы из директории db, созданной в п.4, в директорию db с установленным UTM5.

  • В установщике UTM5 отметьте опцию Запустить службы UTM5 и нажмите кнопку Finish.




Инструкция по обновлению UTM5 до сборки 5.2.1-005 для платформы Win32 без перехода на новую версию MySQL

Внимание! В сборке 5.2.1-005 изменен порядок поставки сервера БД в дистрибутиве, расположение исполняемых файлов и библиотек. Перед началом процедуры обновления следует внимательно и до конца прочитать данную инструкцию. В противном случае возможна потеря данных.

Конфигурационные файлы UTM5 подверглись существенным изменениям. Рекомендуется производить конфигурацию UTM5 при помощи файлов конфигурации, поставляемых с данной сборкой.

В случае если резервное копирование или восстановление из резервной копии занимает значительное время, существует возможность использовать версию СУБД MySQL, уже установленную в системе.

В этом случае для обновления UTM5 до сборки 5.2.1-005 выполните следующую процедуру:

  • Остановите службы utm5_core, utm5_radius, utm5_rfw, utm5_unif и utm5_unif_web, если они запущены.

  • Удалите вручную старую версию UTM5. Для этого необходимо удалить все файлы и поддиректории в директории с установленным UTM5 за исключением:

    • поддиректории mysql
    • поддиректории db
    • файлов и директорий cgi-компонентов UTM5.
  • Удалите службы UTM5, выполнив команды:

    sc delete utm5_core

    sc delete utm5_radius

    sc delete utm5_rfw

    sc delete utm5_unif

    sc delete utm5_unif_web

  • Удалите UTM5 с помощью пункта Установка и удаление программ панели управления Windows. Деинсталлятор не будет найден. Запись о UTM5 будет удалена из списка установленных программ.
  • Запустите установщик новой версии. Выберите язык установщика. Выберите директорию, в которую будет установлен UTM5. Выберите компоненты, необходимые для установки. При этом сервер MySQL устанавливать не следует.

  • Введите параметры доступа к БД, если параметры отличаются от параметров по умолчанию. В качестве директории установленной копии MySQL укажите поддиректорию mysql директории, в которую была ранее установлена система. Выберите Обновить структуру базы данных. Укажите директорию, содержащую файл лицензии.

  • В установщике UTM5 отметьте опцию Запустить службы UTM5 и нажмите кнопку Finish.