{{indexmenu_n>2}}
======Инструкция по обновлению======
<note important>
Начиная с версии [[dpi:changelog:versions:ver_12|12.0]], DPI поддерживается **только** на CentOS 8.x и [[veos:installation|VEOS]].
</note>

=====Подготовка к обновлению=====
  * Убедитесь, что конфигурация DPI и зависимых сервисов (PCRF, RADIUS) валидна.
  * Проверьте текущую установленную версию:<code bash>yum info fastdpi</code>
  * Если используется CentOS 8.x, **однократно** переключите репозитории на vault:<code bash>sed -i -e '/^mirrorlist=http:\/\//d' -e 's/^# *baseurl=http:\/\/mirror.centos.org/baseurl=http:\/\/vault.centos.org/' /etc/yum.repos.d/CentOS-*.repo</code>
  * При проблемах с зависимостями или если обновление не находится, выполните:<code bash>yum clean all</code>

=====Особые условия эксплуатации=====
**Для виртуальных машин, старых процессоров (примерно до 2009 года) и старых процессоров AMD (до Ryzen):**

Перед обновлением выполните:
<code bash>
touch /etc/dpi/noprioadj
</code>

В этом случае DPI будет запускаться с обычным (не realtime) приоритетом, что снижает нагрузку на CPU (sys), но может незначительно увеличить latency.

=====Обновление DPI=====
<note important>Начиная с версии [[dpi:changelog:versions:ver_14|14.0]] вводится разделение UDR на [[dpi:dpi_components:platform:dpi_admin:admin_db|UDR и SDR]]. Разделение происходит автоматически при обновлении версии.</note>

  * Обновление основной версии:<code bash>yum update fastdpi</code>
  * Установка тестовой (beta) версии:<code bash>yum --enablerepo vasexperts-beta update fastdpi</code>

<note tip>
Если при обновлении возникает ошибка ''Module yaml error'', обновите модуль: <code bash>dnf upgrade libmodulemd</code>
</note>

====Особенности обновления при распределенной установке====
Если модули СКАТ (fastdpi) и PCRF (fastpcrf) установлены на разных физических или виртуальных серверах, требуется соблюдение двух условий:
  - **Единая версия ПО:**\\ Убедитесь, что на обоих серверах устанавливаются одинаковые версии пакетов fastdpi и fastpcrf. Несоответствие версий между СКАТ и PCRF может привести к ошибкам.
  - **Последовательность перезапуска:**\\ Процессы должны быть перезапущены в указанном ниже порядке для корректного восстановления соединения.\\ Порядок действий для распределенной схемы:
    - На сервере СКАТ остановите службу DPI:<code bash>service fastdpi stop</code>
    - На сервере PCRF выполните перезапуск службы PCRF:<code bash>service fastpcrf restart</code>
    - На сервере СКАТ запустите службу fastdpi:<code bash>service fastdpi start</code>
Данный порядок обеспечивает корректный запуск всех служб.

=====Рестарт сервисов=====

После обновления или смены версии **обязательно** выполните рестарт DPI:
<code bash>
service fastdpi restart
</code>

Если используются PCRF и/или RADIUS, их также необходимо перезапустить (только при валидной конфигурации):
<code bash>
service fastpcrf restart
service fdpi_radius restart
</code>

**Рекомендуемый порядок рестарта PCRF:**
<code bash>
service fastdpi stop
service fastpcrf restart
service fastdpi start
</code>

=====Обновление операционной системы=====

<note important>
Не обновляйте версию ядра Linux и зависимые от него утилиты.
</note>

  * Для CentOS 8.x:<code bash>yum update</code>

=====Откат версии=====

  * Пример отката на версию 14.0:<code bash>yum downgrade fastdpi-14.0 fastpcrf-14.0 dpiutils-14.0 fastradius-14.0</code>
  * Пример отката на версию 12.4:<code bash>yum downgrade fastdpi-12.4-0 fastpcrf-12.4-0 dpiutils-12.4-0 fastradius-12.4-0</code>

После отката требуется рестарт сервисов:
<code bash>
service fastdpi stop
service fastpcrf restart
service fastdpi start
</code>

=====Важные замечания=====
  * Клиентам, использующим функциональность BRAS, необходимо учитывать изменения при обновлении на новые версии.
  * Обновление ядра Linux может привести к нарушению бинарной совместимости с Kernel ABI и проблемам загрузки сетевых драйверов.
  * Если ядро было обновлено, временно настройте загрузку предыдущей версии через GRUB, указав нужное значение параметра ''default'' в файле ''/etc/grub.conf''.