Инструкция по обновлению [Документация VAS Experts]

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слеваПредыдущая версия
Следующая версия
Предыдущая версия
dpi:changelog:update_guide [2025/12/22 11:59] elena.krasnobryzhdpi:changelog:update_guide [2026/02/12 09:23] (текущий) – [Обновление DPI] elena.krasnobryzh
Строка 1: Строка 1:
 {{indexmenu_n>2}} {{indexmenu_n>2}}
 ======Инструкция по обновлению====== ======Инструкция по обновлению======
-<note important>Начиная с версии 12.0, DPI устанавливается только на CentOS 8.x и [[veos:installation|VEOS]]!</note>+<note important> 
 +Начиная с версии [[dpi:changelog:versions:ver_12|12.0]], DPI поддерживается **только** на CentOS 8.x и [[veos:installation|VEOS]]
 +</note>
  
-Если у вас установлена версия CentOS 6.x или CentOS 8.x, то однократно переключите репозиторий командой: +=====Подготовка к обновлению===== 
-<code bash> +  * Убедитесь, что конфигурация DPI и зависимых сервисов (PCRF, RADIUS) валидна. 
-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 bash>yum info fastdpi</code> 
-</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> <code bash>
-yum update fastdpi+touch /etc/dpi/noprioadj
 </code> </code>
  
-<note tip>Если при обновлении появляется ошибка ''Module yaml error'', то следует обновить модуль ''dnf upgrade libmodulemd''.</note>+В этом случае DPI будет запускаться с обычным (не realtime) приоритетомчто снижает нагрузку на CPU (sys), но может незначительно увеличить latency.
  
-После обновления выполните рестарт DPI: +=====Обновление DPI===== 
-<code bash>service fastdpi restart</code>+<note important>Начиная с версии [[dpi:changelog:versions:ver_14|14.0]] вводится разделение UDR на [[dpi:dpi_components:platform:dpi_admin:admin_db|UDR и SDR]]. Разделение происходит автоматически при обновлении версии.</note>
  
-и других зависимых процессов (PCRF/Radius), но только если они реально используются и их конфигурация валидна: +  * Обновление основной версии:<code bash>yum update fastdpi</code> 
-<code bash> +  * Установка тестовой (beta) версии:<code bash>yum --enablerepo vasexperts-beta update fastdpi</code> 
-service fastpcrf restart + 
-service fdpi_radius restart +<note tip> 
-</code>+Если при обновлении возникает ошибка ''Module yaml error'', обновите модуль: <code bash>dnf upgrade libmodulemd</code
 +</note>
  
-При необходимости можно обновить компоненты операционной системы. **Не проводите обновление версии ядра и зависимых от него утилит!**\\ +====Особенности обновления при распределенной установке==== 
-Для CentOS 6.x:+Если модули СКАТ (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> <code bash>
-yum --exclude=kernel*,util-linux-ng,libuuid,libblkid update+service fastdpi restart
 </code> </code>
  
-Для CentOS 8.x:+Если используются PCRF и/или RADIUS, их также необходимо перезапустить (только при валидной конфигурации):
 <code bash> <code bash>
-yum update+service fastpcrf restart 
 +service fdpi_radius restart
 </code> </code>
  
-**Пользователям, эксплуатирующим DPI на виртуальных машинах, старых процессорах (2009 года выпуска) и старых процессорах AMD (до Ryzen):**\\  +**Рекомендуемый порядок рестарта PCRF:**
-Выполните перед обновлением команду:+
 <code bash> <code bash>
-touch /etc/dpi/noprioadj+service fastdpi stop 
 +service fastpcrf restart 
 +service fastdpi start
 </code> </code>
  
-и процесс DPI будет запускаться с обычным (не ''realtime'') приоритетом, что существенно снизит потребление системных (''sys'') ресурсов CPU, но немного увеличит ''latency'' на платформе.+=====Обновление операционной системы=====
  
-<note tip>Клиентам, использующим функционал BRAS, при обновлении СКАТ на новую версию необходимо обратить внимание на изменения.</note>+<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> 
-<code bash> +  * Пример отката на версию 12.4:<code bash>yum downgrade fastdpi-12.4-0 fastpcrf-12.4-0 dpiutils-12.4-0 fastradius-12.4-0</code>
-yum info fastdpi +
-</code> +
-  +
-Откат на 12.4: +
-<code bash> +
-yum downgrade fastdpi-12.4-0 fastpcrf-12.4-0 +
-</code> +
- +
-После обновления или смены версии требуется рестарт сервиса: +
-<code bash> +
-service fastdpi restart +
-</code>+
  
-:!: Если используются PCRF и/или Radius, их тоже надо рестартовать. Для рестарта PCRF предпочтителен следующий порядок:+После отката требуется рестарт сервисов:
 <code bash> <code bash>
 service fastdpi stop service fastdpi stop
Строка 70: Строка 80:
 </code> </code>
  
-:!: Не проводите обновления ядра Linux. В новых версиях ядра может быть нарушена бинарная совместимость с Kernel ABI и сетевой драйвер после обновления не загрузится. Если вы все-таки произвели обновлението на время решения проблемы настройте в загрузчике GRUB загрузку прежней версии ядра: в файле ''/etc/grub.conf'' установите параметр ''default=1''.+=====Важные замечания===== 
 +  * Клиентам, использующим функциональность BRAS, необходимо учитывать изменения при обновлении на новые версии. 
 +  * Обновление ядра Linux может привести к нарушению бинарной совместимости с Kernel ABI и проблемам загрузки сетевых драйверов
 +  * Если ядро было обновлено, временно настройте загрузку предыдущей версии через GRUB, указав нужное значение параметра ''default'' в файле ''/etc/grub.conf''.
  
-Если при обновлении появляется сообщение, что обновление не найдено или возникают проблемы с зависимостями, то перед обновлением выполните команду: 
-<code bash> 
-yum clean all 
-</code>