This commit is contained in:
Robert Chacon committed 2026-04-04 15:46:31 -06:00
1 parent cbd5b56627
commit a41396ea5a
22 files changed
+2105 -196

No files matched your search

+7 -8
View File
@@ -141,16 +141,15 @@ You have the option to run `uisp_integration` automatically on boot and every X
### UISP Overrides
You can also modify the the following files to more accurately reflect your network:
- integrationUISPbandwidths.csv
Puede usar las siguientes entradas de override para reflejar su red con mayor precisión:
- `Rate Override` en la página del árbol, guardado como overrides operatorios `AdjustSiteSpeed` en `lqos_overrides.json`
- `Topology Override` en la página del árbol para nodos compatibles de UISP `full`, guardado en `lqos_overrides.json`
- integrationUISProutes.csv
- integrationUISPbandwidths.csv solo como entrada heredada de compatibilidad
Each of the files above have templates available in the `/opt/libreqos/src` folder. If you don't find them there, you can navigate [here](https://github.com/LibreQoE/LibreQoS/tree/develop/src). To utilize the template, copy the file (removing the `.template` part of the filename) and set the appropriate information inside each file.
For example, if you want to change the set bandwidth for a site, you would do:
```
sudo cp /opt/libreqos/src/integrationUISPbandwidths.template.csv /opt/libreqos/src/integrationUISPbandwidths.csv
```
And edit the CSV using LibreOffice or your preferred CSV editor.
Las compilaciones UISP actuales auto-migran un `integrationUISPbandwidths.csv` heredado hacia overrides operatorios `AdjustSiteSpeed` en la siguiente ejecución de la integración cuando todavía no existen overrides de tasa del operador. Si ya existen, el CSV se ignora.
Las plantillas de los archivos heredados siguen disponibles en `/opt/libreqos/src`. Si no las encuentra allí, puede obtenerlas [aquí](https://github.com/LibreQoE/LibreQoS/tree/develop/src). Para cambios nuevos de ancho de banda, prefiera los overrides operatorios en `lqos_overrides.json`.
#### UISP Route Overrides
+10 -8
View File
@@ -320,7 +320,7 @@ Las compilaciones actuales también incluyen estas opciones en los editores de c
- `insecure_ssl`: deshabilita validación de certificados TLS para UISP.
- `airmax_flexible_frame_download_ratio`: cuando UISP reporta capacidad agregada de un AP AirMax con flexible framing y no entrega `dlRatio`, LibreQoS usa esta proporción de descarga como respaldo. `0.8` significa 80/20 descarga/subida.
Las versiones actuales limitan este manejo de flexible framing a equipos donde UISP reporta `identification.type == "airMax"` y `identification.role == "ap"`. Esos AP AirMax prefieren la capacidad agregada de `theoreticalTotalCapacity` y la dividen usando `dlRatio` cuando UISP lo entrega.
Las versiones actuales limitan este manejo de flexible framing a equipos donde UISP reporta `identification.type == "airMax"` y `identification.role == "ap"`. En esos AP AirMax, `theoreticalTotalCapacity` se usa solo como pista de flexible framing. La velocidad real de shaping sale de `totalCapacity` cuando UISP lo entrega, o de la capacidad direccional más fuerte cuando no lo hace, y la división sigue prefiriendo `dlRatio` cuando UISP lo reporta.
Uso recomendado:
@@ -346,16 +346,18 @@ Tiene la opción de ejecutar `uisp_integration` automáticamente al iniciar el e
### Sobrescrituras de UISP
También puede modificar los siguientes archivos para reflejar su red con mayor precisión:
- integrationUISPbandwidths.csv
Puede usar las siguientes entradas de override para reflejar su red con mayor precisión:
- `Rate Override` para cambios de ancho de banda a nivel de nodo guardados como entradas operatorias `AdjustSiteSpeed` en `lqos_overrides.json`
- `Topology Override` para correcciones de selección de padre en UISP `full`, también guardadas en `lqos_overrides.json`
- integrationUISProutes.csv
- integrationUISPbandwidths.csv solo como entrada heredada de compatibilidad
Las compilaciones actuales aplican `Topology Override` antes de generar `network.json` y `ShapedDevices.csv`, y le dan precedencia sobre los overrides heredados de costos de ruta de UISP. El soporte actual en WebUI es solo `Pinned Parent`, forzando un único padre inmediato detectado.
Las compilaciones UISP actuales también auto-migran un `integrationUISPbandwidths.csv` heredado hacia overrides operatorios `AdjustSiteSpeed` en la siguiente ejecución de la integración cuando todavía no existen overrides de tasa del operador. Si ya existen, el CSV se ignora.
Cada uno de los archivos mencionados arriba tienen plantillas, las cuales están disponibles en la carpeta `/opt/libreqos/src`. Si no los encuentra, puede obtenerlos [aquí](https://github.com/LibreQoE/LibreQoS/tree/develop/src). Para utilizarlos, copie el archivo (eliminando la parte `.template` del nombre) y edítelo con la información correspondiente.
Por ejemplo, si desea cambiar el bando de ancha de un sitio, ejecutaría:
```
sudo cp /opt/libreqos/src/integrationUISPbandwidths.template.csv /opt/libreqos/src/integrationUISPbandwidths.csv
```
Y luego editaría el CSV con LibreOffice o el editor de CSV de su preferencia.
Para cambios nuevos de ancho de banda, prefiera los overrides operatorios en `lqos_overrides.json`. `integrationUISPbandwidths.csv` queda como una entrada heredada para migración única, no como el flujo preferido a largo plazo.
#### Sobrescrituras de Rutas UISP
+1 -1
View File
@@ -59,4 +59,4 @@ journalctl -u lqos_scheduler --since "30 minutes ago"
Los valores por defecto de integración también incluyen el límite compartido para puertos Ethernet. Cuando UISP puede detectar la velocidad Ethernet negociada hacia el suscriptor, las versiones actuales aplican un multiplicador conservador por defecto de `0.94`, salvo que el operador lo sobrescriba en `Configuration -> Integrations -> Integration Defaults`.
Las versiones actuales también manejan de forma específica los AP AirMax donde UISP reporta `identification.type == "airMax"` y `identification.role == "ap"`. Cuando UISP entrega capacidad agregada de flexible framing (`theoreticalTotalCapacity`), LibreQoS la divide usando `dlRatio` si está disponible; si no, usa `airmax_flexible_frame_download_ratio`, cuyo valor por defecto `0.8` significa 80/20 descarga/subida.
Las versiones actuales también manejan de forma específica los AP AirMax donde UISP reporta `identification.type == "airMax"` y `identification.role == "ap"`. En esos AP AirMax, `theoreticalTotalCapacity` se usa solo como pista de flexible framing. La velocidad real de shaping sale de `totalCapacity` cuando UISP lo entrega, o de la capacidad direccional más fuerte cuando no lo hace, y la división sigue prefiriendo `dlRatio` cuando UISP lo reporta; si no, usa `airmax_flexible_frame_download_ratio`, cuyo valor por defecto `0.8` significa 80/20 descarga/subida.
+7 -1
View File
@@ -30,7 +30,13 @@ Esta página documenta las vistas clave de la WebUI (Node Manager) y su comporta
- Los circuitos adjuntos se muestran en una tabla dedicada para el nodo seleccionado.
- La columna de IP de circuitos adjuntos mantiene las filas compactas mostrando una dirección inline y colapsando las adicionales como `+X`, mientras la lista completa sigue disponible al pasar el cursor.
- Los circuitos adjuntos limitados por Ethernet pueden mostrar insignias `10M`, `100M` o `1G` junto al valor de `Plan (Mbps)`; al pasar el cursor se explica el auto-cap y al hacer clic en la insignia se abre la página dedicada de revisión Ethernet.
- Los administradores pueden guardar o limpiar valores de `Operator Override` cuando el nodo admite overrides a nivel de nodo. Los usuarios de solo lectura y los nodos no compatibles siguen mostrando los valores actuales sin controles de edición.
- Los administradores pueden guardar o limpiar valores de `Rate Override` cuando el nodo admite overrides a nivel de nodo. Los usuarios de solo lectura y los nodos no compatibles siguen mostrando los valores actuales sin controles de edición.
- Las ediciones de tasa desde la página del árbol escriben overrides operativos `AdjustSiteSpeed` en `lqos_overrides.json`.
- En compilaciones UISP `full`, un `integrationUISPbandwidths.csv` heredado se auto-migra a esos overrides en la siguiente ejecución de la integración cuando todavía no existen overrides operativos de tasa; en caso contrario, el CSV se ignora.
- Las ediciones de tasa desde la página del árbol requieren sesión de administrador, un `node_id` estable y un nodo no generado. Los nodos generados/sintéticos de la integración permanecen en solo lectura en este editor.
- La página del árbol mantiene `Node Details` como una tarjeta compacta de resumen y coloca los editores de override como filas compactas directamente debajo de la tabla de detalles.
- Los nodos de UISP con estrategia `full` también pueden exponer un editor de `Topology Override` en la página del árbol. Las compilaciones actuales soportan solo `Pinned Parent`, usando los candidatos inmediatos detectados aguas arriba del nodo y guardando esa decisión del operador en `lqos_overrides.json`.
- El selector de padre fijado usa `Default upstream parent` cuando no existe un override. Elegir esa opción deja el nodo con el padre seleccionado por la integración.
### Site Map
- Mapa operativo plano de sitios y APs usando geodatos importados de nodos.