LibreQoS/docs-es/v2.0/update-es.md

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 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](insight-es.md#límites-de-circuitos-mapeados-y-estado-de-licencia) y [Solución de problemas](troubleshooting-es.md).

A partir de v2.2, la API del nodo usa la misma política. Las redes con 1.000 circuitos mapeados válidos o menos pueden usar la API sin una suscripción a Insight; las redes mayores requieren un derecho válido de API o Insight. Las llamadas continúan autenticadas. Un administrador puede crear hasta 16 claves locales con nombre en **License & Services**; cada clave se muestra una sola vez, se guarda únicamente como resumen SHA-256 y se puede revocar. Las claves de licencia y el token local heredado siguen siendo compatibles, y los cambios pueden tardar hasta 30 segundos en surtir efecto.

Ejecuta:

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

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/{deb_url_v1_5}
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:

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