Actualización

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

Desde v2.0, la ingesta de circuitos mapeados depende del estado válido de la licencia Insight. Sin una suscripción/licencia Insight válida, 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](insight-es.md#límites-de-circuitos-mapeados-y-estado-de-licencia) y [Solución de problemas](troubleshooting-es.md).

Ejecuta:

cd ~
sudo apt-get update
sudo apt-get upgrade
wget https://download.libreqos.com/{deb_url_v1_5}
sudo apt install ./{deb_url_v1_5}

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

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

cd ~
sudo apt install ./{deb_url_v1_5}
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:

Dashboard y Scheduler Status saludables en WebUI.
En modo integración: sincronización reciente con resultados esperados en ShapedDevices.csv/network.json.
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

Cambia a tu directorio LibreQoS (por ejemplo cd /opt/LibreQoS)
Actualiza desde Git: git pull
git switch develop
Recompila: ./build-rust.sh
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

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

3.2 KiB Raw Blame History