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

Различия

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

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

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