UTM5 - Документация

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


Перед тем как приступить к обновлению, обязательно ознакомьтесь со всеми пунктами данной инструкции

Шаг 1. Проведите предварительную подготовку

Начиная с версии 5.3-005, прекращена поддержка PostgreSQL. Если Вы использовали данную СУБД, перейдите на MySQL до обновления биллинга.

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

  • Убедитесь, что учётная запись пользователя баз данных (БД), используемая ядром UTM5, обладает правами для создания и изменения таблиц БД.

По умолчанию, при первом запуске новой версии ядра, включено обновление структуры БД (verify_database=enable), и отключено обновление индексов БД (verify_database_index=disable), потому что операция обновления индексов может занять много времени. Вы можете изменить эти настройки в конфигурационном файле ядра.

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

  • Произведите архивирование таблиц, чтобы сократить время на обновление БД.

Откройте интерфейс администратора, перейдите в Настройки ⇒ Архивирование БД и создайте архив.
Архивирование можно производить не чаще одного раза в 28 дней. Если кнопка Создать не активна, значит с момента предыдущего архивирования прошло менее 28 дней.

При первом запуске новой версии ядра выполняется проверка структуры архивных таблиц на соответствие требованиям ядра. Если структура соответствует требованиям ядра, архивные данные будут учитываться при формировании отчётов, в противном случае — отчёты будут формироваться без них.

По умолчанию в конфигурационном файле ядра параметр verify_archive_tables=disable, т.е. ядро проверяет структуру таблиц, но не пытается исправить найденные ошибки. Если в конфигурационном файле установить verify_archive_tables=enable, то ядро проверит архивные таблицы и попытается структурировать их в соответствии со своими требованиями. Если во время структурирования возникнут какие-либо ошибки, они будут отражены в log-файлах.

  • Проверьте максимальную дату релиза, указанную в Вашей лицензии в личном кабинете, и сопоставьте её с датой релиза, указанной в сборке установочного пакета.

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

Дата релиза, указанная в сборке установочного пакета, остаётся неизменной для всех обновлений, которые будут выпущены после выхода релиза. Например, для сборки 5.3-004-release и обновления 5.3-004-update10 устанавливается одна и та же дата релиза.

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

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

Шаг 2. Остановите все компоненты биллинга

Остановите все компоненты биллинга: ядро, RADIUS-сервер, DHCP-сервер и т. д.
В Linux выполните следующие команды:

  • остановить ядро — /etc/init.d/utm5_core stopps

  • проверить состояние ядра — ps ax | grep utm5_core

Шаг 3. Выполните резервное копирование

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

Проверьте наличие актуальной резервной копии базы данных и детальной информации о трафике. В случае отсутствия резервной копии произведите резервное копирование базы данных, например, с помощью утилиты mysqldump.

Убедитесь в том, что все данные можно восстановить из резервной копии.

Шаг 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

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

Шаг 6. Обновите структуру и индексы базы данных

По умолчанию при первом запуске новой версии ядра происходит автоматическое обновление структуры БД. Если Вы отключили этот параметр в конфигурационном файле ядра, выполните обновление структуры БД вручную до запуска ядра:
mysql -f UTM5 < /netup/utm5/UTM5_MYSQL_update.sql

Автоматическое обновление индексов при запуске ядра по умолчанию отключено. Если Вы НЕ вносили изменений в конфигурационный файл, запустите обновление индексов до запуска ядра с помощью следующей команды:
mysql -f UTM5 < /netup/utm5/UTM5_indexes.sql

Шаг 7. Загрузите файл с обновлённой лицензией

Войдите в личный кабинет на нашем сайте и на странице Лицензионные ключи продлите Вашу лицензию. Затем загрузите файл reg.sql и поместите его в директорию >/netup/utm5. При запуске ядра будет автоматически активирована лицензия, после чего файл reg.sql будет удалён.

Таким же образом следует обновить данные о лицензии в случае каких-либо изменений в её составе, например, при приобретении дополнительных модулей UTM5

Шаг 8. Запустите компоненты UTM5

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

Для запуска ядра и модуля DHCP выполните следующие команды:
>/etc/init.d/utm5_core start
/etc/init.d/utm5_dhcp start

Шаг 9. Замените шаблоны документов

Ознакомьтесь с документацией UTM5, и, если необходимо, обновите шаблоны документов.

Установите на сервере с UTM5 пакет LibreOffice, чтобы генерировать документы в формате PDF, в противном случае документы будут генерироваться в формате ODT.