Инструкция по обновлению UTM 5 до версии 5.3-004

Предварительные действия

Если обновление производится со сборки 5.3-001-update6 или более ранней, настоя­тельно рекомендуется также изучить инструкции по обновлению и списки изменений для предыдущих выпущенных сборок (см. Инструкция по обновлению биллинговой системы UTM 5 до версии 5.3-003).

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

В сборке 5.3-003-update10 был полностью переработан механизм взаимодействия с платёжными системами по эквайринговой схеме, реализованный в Web-интерфейсе поль­зователя. Если обновление производится с более старой сборки и этот механизм использо­вался, то следует изучить  Инструкцию по обновлению эквайринговых платёжных систем. Кроме того, в сборке 5.3-004 в данный механизм были внесены дополнительные изменения. Для его работы требуются лицензии и модуль интеграции с платёжными систе­мами. Перед обновлением необходимо убедиться, что модуль интеграции с платёжными системами установлен и работает, и в него импортированы все требуемые лицензии.

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

Порядок обновления

1.Остановите все компоненты UTM5 (ядро, RADIUS-сервер, DHCP-сервер и т. д.). На­пример, в Linux для остановки ядра выполните команду:

/etc/init.d/utm5_core stop

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

ps ax | grep utm5_core

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

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

4.Удалите старую версию пакета UTM5. Например, в Debian удаление производится ко­мандой:

dpkg -r utm5

 
Команда для FreeBSD:

pkg delete utm5

 
Команда для CentOS:

yum remove utm5

5.Установите новую версию пакета UTM5. Например, в Debian установка производится командой:

dpkg -i utm5-3.004.deb

 

 

Если в системе отсутствуют какие-либо библиотеки, прописанные в зависимостях установочного пакета, появится соответствующее сообщение, и установка будет приостановлена. В этом случае выполните команду apt-get install -f.
Будут установлены все недостающие библиотеки, и установка UTM5 продолжится.

 
Команда для FreeBSD:

pkg add utm5-3.004.tbz

 
Команда для CentOS (V - версия CentOS: 5, 6 или 7):

yum --nogpgcheck localinstall utm5-3.004.x86_64-centosV_x64.rpm

6.При первом запуске новой версии ядра производится автоматическое обновление структуры БД (если соответствующий параметр не отключен в конфигурационном файле). В связи с этим необходимо, чтобы учетная запись пользователя БД, используе­мая ядром UTM5, обладала правами, необходимыми для создания и изменения таблиц БД.
При необходимости возможно обновление структуры БД вручную. Например, при ис­пользовании СУБД MySQL, обновление производится командой

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

:

Если используется СУБД PostgreSQL, выполните команду:

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

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

verify_database_index=enable

 

 

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

При необходимости, произведите обновление индексов базы данных вручную. Напри­мер, при использовании СУБД MySQL, обновление производится командой:

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

Если используется СУБД PostgreSQL, выполните команду:

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

 

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

 

Следует учесть, что по умолчанию всегда выполняется проверка структуры архивных таблиц на соответствие требованиям ядра. Если в файле конфигурации ядра включен дополнительный параметр verify_archive_tables, то ядро попыта­ется привести структуру таблиц в соответствие требованиям. Если попытка будет успешной, то данные из архива после завершения изменения структуры будут использоваться при формировании отчетов. В противном случае архивные данные при формировании отчетов учитываться не будут.

8.Начиная с версии 5.3-004 лицензия определяет доступность обновлений. Перед обновлением до этой версии необходимо в личном кабинете на странице netup.ru/UTM5/customer.php продлить и загрузить продленную лицензию. Затем, перед первым запуском обновленного ядра системы, нужно поместить файл reg.sql в директорию /netup/utm5. При запуске обновленное ядро автоматически загрузит лицензионный ключ из файла /net­up/utm5/reg.sql в БД и удалит этот файл. Таким же образом следует обновить данные о лицензии в случае каких-либо изменений в её составе, например, при приобретении дополнительных модулей UTM5.

 

Перед обновлением до версии 5.3-004 нужно обязательно обновить лицензию, иначе после обновления ядро UTM5 не запустится

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

 

Все компоненты системы должны иметь одинаковый номер сборки. Если использу­ются несколько серверов, на которых запущены различные компоненты UTM5, то обновления должны быть установлены для всех этих компонентов. Совместное использование компонентов системы с различными номерами сборки недопустимо.

 

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

/etc/init.d/utm5_core start

/etc/init.d/utm5_dhcp start

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