Integración con Splynx

Resumen

Use esta integración cuando Splynx sea su fuente de verdad CRM/NMS.

Configuración básica

  1. Configure Splynx en /etc/lqos.conf.

  2. Seleccione estrategia de topología (flat, ap_only, ap_site, full).

  3. Habilite sincronización automática y reinicie scheduler.

Inicio rápido para nuevos operadores

Base recomendada:

  • strategy = "ap_only" (menos confusión inicial)

  • enable_splynx = true

  • network.json queda reservado para despliegues DIY o manuales

Después, ejecute una sincronización manual y valide salidas antes de aumentar frecuencia de refresh.

Notas operativas

  • La sincronización actualiza automáticamente los datos importados y de shaping que LibreQoS usa con Splynx.

  • network.json queda para despliegues DIY o manuales.

  • Use la WebUI para confirmar que la importación y la profundidad del árbol son las esperadas.

  • Use WebUI para ajustes operativos diarios.

  • Cuando Splynx no puede inferir el padre de un circuito desde access_device o los metadatos del router, LibreQoS deja ese circuito sin padre para shaping en lugar de adjuntarlo a un sitio o AP sintético. Corrija el padre en Splynx o Topology Manager si debe aparecer bajo un sitio o AP real.

  • En modo ap_site, LibreQoS trata los Network Sites de Splynx como contenedores de sitio y las filas de monitoreo con access_device = 1 como AP o nodos de acceso. Las ramas grandes de sitios y APs, incluidas ramas de uplink o agregación representadas como nodos Site o AP, pueden virtualizarse automáticamente cuando superan queue_auto_virtualize_threshold_mbps, tienen ramas de cola hijas y no tienen circuitos conectados directamente al ID del nodo. Defina una anulación virtual del nodo en false cuando un nodo específico deba permanecer como cola física.

Validación en 5 minutos después de cambios Splynx

  1. Ejecute prueba de integración:

python3 integrationSplynx.py

  1. Confirme archivos actualizados:

ls -lh /opt/libreqos/src/topology_import.json /opt/libreqos/src/shaping_inputs.json

  1. Confirme salud de servicios:

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

  1. Verifique en WebUI que Scheduler Status y profundidad de árbol coincidan con la estrategia elegida.

Referencia completa

Las versiones actuales también exponen una política compartida de margen para puertos Ethernet en Configuration -> Integrations -> Integration Defaults. Las integraciones que pueden aportar la velocidad Ethernet negociada hacia el suscriptor usan un multiplicador conservador por defecto de 0.94, salvo que el operador lo cambie.