Actualización

Advertencia

Si usas el puente XDP, el tráfico dejará de pasar por el puente mientras lqosd se reinicia (el puente XDP solo opera mientras lqosd está en ejecución).

Si instalaste el .deb

Importante

Desde v2.0, la ingesta de circuitos mapeados depende de un estado válido de licencia/grant con derecho. Sin un estado válido de licencia/grant de Insight o Local, LibreQoS solo lee los primeros 1000 circuitos mapeados válidos al estado de shaping activo. Esto incluye estado local de grant/licencia expirado o inválido por cualquier motivo. Vea Comportamiento de licenciamiento de Insight y Solución de problemas.

Ejecuta:

cd /tmp
sudo apt-get update
sudo apt-get upgrade
wget https://download.libreqos.com/libreqos_1.5-RC2.202510052233-1_amd64.deb
sudo apt install ./libreqos_1.5-RC2.202510052233-1_amd64.deb

Usar /tmp evita problemas de permisos con .deb locales cuando apt no puede acceder al paquete almacenado en un directorio home privado con el usuario _apt.

Si apt install termina normalmente, reinicia los servicios:

sudo systemctl restart lqosd lqos_scheduler

Hotfix de Ubuntu 24.04 si la actualización se detiene

En hosts Ubuntu 24.04 afectados que usan systemd-networkd, apt install puede detenerse y mostrar un mensaje requiriendo el hotfix. Esto es esperado.

Si eso ocurre, ejecuta:

sudo /opt/libreqos/src/systemd_hotfix.sh install
sudo reboot

El instalador del hotfix configura el repositorio APT firmado de LibreQoS en https://repo.libreqos.com, instala el conjunto parchado de paquetes systemd de Noble y fija esos paquetes para futuras actualizaciones. De forma predeterminada, selecciona la versión actual del hotfix desde ese repositorio. Si Soporte de LibreQoS te indica que tu paquete instalado es anterior a v2.2, usa este comando de recuperación en su lugar:

sudo HOTFIX_PACKAGE_VERSION=255.4-1ubuntu9999+libreqos1 /opt/libreqos/src/systemd_hotfix.sh install
sudo dpkg --configure -a
sudo reboot

Después del reinicio, reanuda la actualización y reinicia los servicios:

cd /tmp
wget https://download.libreqos.com/libreqos_1.5-RC2.202510052233-1_amd64.deb
sudo apt install ./libreqos_1.5-RC2.202510052233-1_amd64.deb
sudo systemctl restart lqosd lqos_scheduler

Reinicio posterior a la actualización

Ahora reinicia tu servidor LibreQoS con:

sudo reboot

Esto limpiará los mapas eBPF antiguos y cargará la última versión de LibreQoS.

Validación obligatoria post-actualización

Después de actualizar/reiniciar, ejecute:

sudo systemctl status lqosd lqos_scheduler
journalctl -u lqosd -u lqos_scheduler --since "20 minutes ago"

Luego valide:

  1. Dashboard y Scheduler Status saludables en WebUI.

  2. En modo integración: sincronización reciente con resultados esperados en ShapedDevices.csv/network.json.

  3. Profundidad topológica consistente con la estrategia seleccionada.

Si algo falla, vaya a Solución de problemas antes de otros cambios.

Si instalaste desde Git

  1. Cambia a tu directorio LibreQoS (por ejemplo cd /opt/LibreQoS)

  2. Actualiza desde Git: git pull

  3. git switch develop

  4. Recompila: ./build-rust.sh

  5. sudo rust/remove_pinned_maps.sh

Hotfix de Ubuntu 24.04 para instalaciones desde Git

Antes de reiniciar los servicios de LibreQoS en Ubuntu 24.04, verifica si se debe ofrecer el hotfix de Noble para systemd-networkd:

cd /opt/libreqos/src
./systemd_hotfix.sh status

Si el script indica que el hotfix debe ofrecerse, instálalo y reinicia antes de continuar:

sudo ./systemd_hotfix.sh install
sudo reboot

El instalador selecciona la versión actual del hotfix desde el repositorio APT firmado de LibreQoS. Soporte de LibreQoS puede proporcionar un valor HOTFIX_PACKAGE_VERSION para un incidente específico.

Ejecuta los siguientes comandos para recargar los servicios de LibreQoS:

sudo systemctl restart lqosd lqos_scheduler

Síntomas para pausar y hacer triage

Detenga el rollout y haga triage si aparece:

  • lqosd o lqos_scheduler no saludable tras reinicio

  • cambio inesperado de jerarquía tras sync de integración

  • scheduler persistentemente no saludable en WebUI