Documentación de BQN
Cerrar icono

Problemas de instalación

Compruebe lo siguiente:

  • La ISO debería haberse copiado en una unidad USB con particiones MBR y modo DD.
  • La BIOS del servidor debe tener su modo de arranque por defecto (por ejemplo, DUAL).
  • Si hay una controladora RAID, se debe configurar una unidad lógica y marcarla como de arranque.
  • Compruebe si el servidor utilizado en la instalación cumple los requisitos de hardware de BQN.
  • Compruebe que la instalación se ha realizado en el disco duro y no se ha sobrescrito la unidad USB.

No hay acceso a la dirección IP de gestión

El BQN utiliza una interfaz de red dedicada para la gestión. La interfaz de gestión soporta los servicios SSH y WEB (HTTPs). En caso de problemas para acceder a la IP de gestión configurada, compruebe lo siguiente:

  • Asegúrese de que el puerto de interfaz de red de gestión está conectado a la red adecuada.
  • Compruebe que el estado del enlace de la interfaz de red de gestión es up. Si la interfaz de gestión está conectada a un conmutador de red, compruebe que el puerto del conmutador está activo y que sus atributos coinciden con las propiedades que muestra el comando show interface.
  • Si accede a la dirección IP de gestión desde una red diferente, asegúrese de que el enrutamiento estático está configurado para la red de acceso, como se explica en la sección Interfaz de red de la Guía del usuario.
  • Si hay firewall en la red de gestión, permita el acceso al puerto TCP 22 para el servicio SSH y al puerto TCP 443 para el servicio WEB.
  • Verifique mediante la consola del sistema que la dirección IP de gestión y el prefijo de red son correctos. Conecte un monitor y un teclado al servidor e inicie sesión como root:
 
bqn0:˜# bqnsh
root@bqn0# show interface management detail
Interface: en0o1
IP address: 192.168.0.121/24 
Default gateway: 192.168.0.1
Nameserver: n/a
  • Si sospecha que la configuración de la IP OAM es incorrecta o desconocida, conecte un monitor y un teclado al servidor e inicie sesión como root para cambiarla utilizando el asistente bta en modo interactivo. Por ejemplo, para cambiar la interfaz de gestión a en0o1 con la dirección IP 10.10.10.12/24 (pulse intro para aceptar la respuesta sugerida):
 
bqn0:˜# bqnsh
root@bqn0# wizard bta interactive
Available network interfaces:
  en0o1
  en0p0s0
  en0p0s1
Enter management interface [en0p0s0]: en0o1
Enable VLAN on management interface? (yes/no) [no]:
Enter management IP address and prefix [192.168.0.120/24]: 10.10.10.12/24
Enter default gateway IP address [192.168.0.1]: 10.10.10.1
Configure a nameserver? (yes/no) [no]:

Available network interfaces:
  en0p0s0
  en0p0s1
Select access-side interface for wire:  en0p0s0
Select internet-side interface for wire: en0p0s1
Enable SDR generation? (yes/no) [yes]:
Enter random optimization percentage [99]:
Enter random udr generation percentage [2]:
System vendor: Dell
System name: bqn
System serial: 0
System supported: yes
CPU model: 12th Gen Intel(R) Core(TM) i7-12700H
CPU cores: 4

Management interface:  en0o1
Management IP:         10.10.10.12/24
Management gateway:    10.10.10.1

Wire 1: en0p0s0(access)-en0p0s1(internet)

SDR generation: enabled

BTA random optimization: 99%
UDR random generation:   2%

If the proposed configuration is not valid execute the command
     wizard bta interactive
to manually enter the configuration.

Proceed with configuration? (yes/no) [yes]: yes


root@bqn0# show interface management detail
Interface: en0o1
IP address: 10.10.10.12/24
Default gateway: 10.10.10.1
Nameserver: n/a

root@bqn0# show interface management detail
Interface: en0o1
IP address: 10.10.10.12/24
Default gateway: 10.10.10.1
Nameserver: n/a

Si la interfaz no está disponible en el momento del cambio (por ejemplo, participó en un wire), un mensaje solicitará un reinicio. Tras el reinicio, la BQN debería tener la nueva IP y la nueva interfaz de red de gestión.

 
Management interface en0o1 seems not to be set. A process reboot may fix the problem. 
Proceeed with the process reboot? (yes/now) [yes]: yes
  • La interfaz de gestión de BQN puede estar protegida por su propio cortafuegos. El problema podría ser que su dirección IP de origen no esté incluida en esa lista blanca del cortafuegos. Esto podría ocurrir incluso para direcciones de la misma subred de la IP de gestión de BQN si la subred no forma parte de las reglas del cortafuegos. Puede desactivar el cortafuegos temporalmente hasta que se restablezca la conexión con el puerto de gestión. Conecte un monitor y un teclado al servidor e inicie sesión como root:
bqn0:˜# bqnsh
root@bqn0# show interface firewall 
IFACE CHAIN RANGE
en0o1 input 10.0.0.0/8
en0o1 input 172.16.0.0/12
en0o1 input 192.168.0.0/16 
root@bqn0# clear interface en0o1 firewall input 
root@bqn0# show interface firewall 
IFACE CHAIN RANGE 
root@bqn0#

Una vez que la IP de gestión es alcanzable, puede definir la nueva lista blanca de rangos de IP de origen permitidos.

  • If the command <span class="character-highlight">wizard bta interactive</span> fails,  connect with a console and a keyboard and try changing the configuration directly. In the following example, the management interface is in en0o2 and we will move it to interface en0o1 and from IP address 192.168.0.121 to IP address 10.0.0.121, with default gateway 10.0.0.1:
bqn0:˜# bqnsh
root@bqn0# show interface management detail
Interface: en0o2
IP address: 192.168.0.121/24
Default gateway: 192.168.0.1
Nameserver: 8.8.8.8
root@bqn0# show interface
IFACE                TYPE       MAC                STATE LINK
lo0                  loopback   00:00:00:00:00:00  up    yes
en0o1                ethernet   ff:2f:6b:72:12:01  up    no
en0o2                ethernet   ff:2f:6b:72:12:02  up    yes
en0o3                ethernet   ff:2f:6b:72:12:03  up    no
en0o4                ethernet   ff:2f:6b:72:12:04  up    no
root@bqn0# configure
root@bqn0(config)# interface en0o2
root@bqn0(config-iface)# no ip address 192.168.0.121/24
root@bqn0(config-iface)# no management
root@bqn0(config-iface)# root
root@bqn0(config)# interface en0o1
root@bqn0(config-iface)# ip address 10.0.0.121/24
root@bqn0(config-iface)# management
root@bqn0(config-iface)# root
root@bqn0(config)# router static
root@bqn0(config-static)# route 0.0.0.0/0 via 10.0.0.1
root@bqn0(config-static)# root
root@bqn0(config)# commit
root@bqn0(config)# end
root@bqn0# exit
bqn0:˜#

Web no accesible

  • Compruebe que la dirección IP de gestión es accesible mediante SSH,
  • Compruebe que está utilizando HTTPS en el acceso (HTTP no es compatible). Ejemplo de URL: https://192.168.0.121
  • Compruebe que está usando el usuario bqnadm (no se puede usar root en el acceso a la GUI).
  • Cuando se instala desde cero, asegúrese de que el comando "wizard bta" se ejecutó (de lo contrario, el servicio web GUI no estará activo un usuario bqnadm no creado).
  • Verifique que el puerto SSH del servidor BQN no ha sido modificado. Para acceder al BQN utilizando un puerto distinto del 22, puede definir reglas de reenvío de puertos en el router en la ruta de acceso, pero el puerto SSH del BQN no puede ser modificado. Accediendo al servidor como root, puede verificar que el puerto SSH es el 22 de la siguiente manera:


bqn:~ # grep Port/etc/ssh/sshd_config
#Port 22
#GatewayPorts no

Si es necesario, comente la línea que especifica un puerto distinto del 22.

  • Compruebe que su navegador es compatible (Edge, Firefox, Chrome). MS Explorer, por ejemplo, no es compatible.

Interfaz de red inactiva

Si el icono de Interfaces de Red en el Tablero de Control no está en verde.

Vaya a Configuration->Interfaces->Data Wires

En rojo (crítico)

  • Si no hay ningún wire configurado, cree uno.
  • Si hay wires configurados pero sus interfaces no están en estado UP, lo más probable es que esto indique que las interfaces no son compatibles con Intel. Vaya a Configuración->Interfaces->Datos Wires y haga clic en la interfaz bajada para ver el modelo(PCI vendor ID) y confirmar que no es Intel. Elimine el wire y cree uno nuevo con ambas interfaces en modo pcap. Esto debería poner las interfaces en estado UP, pero con una capacidad de throughput mucho menor (menos de 1Gbps).
  • Si hay wires configurado, con interfaces en estado UP pero con el LINK caído, hay un problema en la conexión con el otro equipo. Conecte ambos puertos de interfaz entre sí en bucle utilizando un cable/fibra adecuado. Si ambos interfaces están en up, entonces el problema está en el otro equipo.

Si el enlace sigue sin funcionar y se utilizan puertos ópticos, verifique que los transceptores:

  • son compatibles con Intel
  • (consulte la lista en Tarjetas de red compatibles).
  • del tipo requerido por la instalación (por ejemplo, SFP+-LR en una instalación con fibra monomodo y SFP+-LR en el otro lado).

En amarillo (aviso)

  • Si los wires que aparecen como caídos tienen supuestamente tráfico, siga los pasos del apartado anterior (Crítico)
  • Si los wires que aparecen como caídos no están en uso y quiere eliminar la señal de aviso, puede eliminar los wires no utilizados. Considera que los cambios en la configuración de los cables detendrán el tráfico durante algunos segundos.

Tráfico invertido

Si el icono de tráfico invertido en el panel de control es de color naranja (advertencia), indica que el rendimiento del tráfico en el sentido ascendente es mayor que en el sentido descendente. Esto puede ser normal en despliegues pequeños (menos de cien abonados, como en una BQN en un laboratorio) pero en un despliegue de red lo más probable es que indique que algunos de los wires se han conectado incorrectamente, con el puerto de acceso conectado al lado de Internet y viceversa.

Para comprobar que esto es así, vaya a Estadísticas->Paso->Interfaces y seleccione la interfaz wire configurada en el lado de acceso. Si muestra más throughput recibido que enviado, es indicativo de que wire está invertido. Esto se puede confirmar seleccionando el throughput de la interfaz del lado de Internet para ver que su tráfico enviado es mayor que su tráfico recibido.

Para solucionar el problema, vaya a Configuration->Interfaces->Data Wires y, en el hilo invertido, pulse el icono paraIntercambiar interfaces.

Tráfico bajo

Si el icono de tráfico bajo en el tablero no está en verde.

En amarillo (aviso)

Pase el ratón por encima del icono para confirmar que se muestra el aviso de tráfico bajo. Indica que hay muy poco tráfico pasando por el servidor BQN. Esto es normal si el sistema todavía está esperando que el tráfico sea enrutado a través de él. Sin embargo, en un sistema en producción puede ser una indicación de que algún fallo en otra parte de la red está impidiendo que el tráfico llegue al servidor BQN.

En color naranja (aviso)

Pase el ratón por encima del icono. El enlace ascendente de tráfico o el enlace descendente de tráfico deberían estar en alerta. Esto se debe a que no hay tráfico que pase por el BQN en esa dirección y por lo tanto el tráfico es asimétrico. Debe ir a Configuración->TCPO/ACM y poner la Optimización TCP general en Off mientras se soluciona el problema.

Arregle el enrutamiento del tráfico para que el BQN vea ambas direcciones (enlace ascendente y descendente). Cuando haya terminado y después de que el icono vuelva a ser verde, vaya a Configuración->Configuración de TCP/ACM para activar la optimización general de TCP.

Administrador de licencias

Si el icono del Gestor de Licencias en el dashboard está en Amarillo y el texto dice "license-mgr-connection:notice", esto es porque el servidor BQN no puede alcanzar el gestor de licencias. El gestor de licencias es responsable de validar las licencias SW de BQN y también ayuda a Bequant a proporcionar un soporte más proactivo informando de los problemas del servidor.

Asegúrese de que el servidor BQN puede iniciar conexiones salientes a la IP del administrador de licencias (póngase en contacto con el servicio de asistencia de Bequant para obtener más información).

Para verificar que una conexión saliente es posible, inicie sesión como root y un telnet a la IP y el puerto proporcionados debería funcionar:


bqn0:˜# telnet ip port
Trying ip...
Connected to ip.
Escape character is '^]'.

Licencia no OK

Si el icono de Licencia en el Panel de Control es Rojo, y el texto dice "license-available:critical"o"license-expiration: critical", no hay una licencia válida. Esto puede deberse a varias razones:

  • No hay ninguna licencia definida en el nodo
  • La licencia no es válida
  • La licencia ya no es válida (su fecha límite ha expirado).

Póngase en contacto con su distribuidor para obtener una licencia válida.

Puede comprobar el estado de la licencia en Administration->License.

Cuando no haya una licencia válida, la BQN reenviará todo el tráfico de forma transparente: el servicio no se verá afectado, pero no se aplicará al tráfico ninguno de los procesamientos avanzados de la BQN.

Límite de licencia superado

Si el icono de Licencia en el Panel de Control es Naranja, y el texto dice "license-usage: warning", la capacidad máxima de la licencia está siendo excedida (el tráfico en todo el servidor BQN está por encima del límite de la licencia).

Póngase en contacto con su distribuidor para obtener una actualización de la licencia.

Puede comprobar la capacidad de la licencia en Administration->License.

En Statistics->Throughput->Overview, una línea roja mostrará el límite de la licencia junto con los niveles recientes de producción.

La superación del límite de licencia debe ser temporal, mientras que la licencia se actualiza a la capacidad adecuada.

Cuando se supere el límite de licencia, la QoE no dejará caer ningún paquete; simplemente los puenteará.

El efecto sobre el tráfico es diferente a nivel de flujo y a nivel de sesión de abonado.

Efectos a nivel de caudal:

  • Mientras se supere el límite de licencias, los nuevos flujos no tendrán licencia.
  • Los caudales existentes antes de la superación de la licencia no se ven afectados: si estaban siendo optimizados siguen siéndolo y lo mismo si no tienen licencia.
  • Una vez que el tráfico optimizado cae por debajo del límite, se vuelven a optimizar nuevos flujos.
  • Los caudales existentes antes de la licencia que bajan del límite no se ven afectados: si no tenían licencia siguen así y lo mismo si se estaban optimizando.
  • Un flujo sin licencia no tiene TCPO, ni shaping y no genera métricas (retransmisiones, latencias, DPI, etc.).

Efectos a nivel de sesión de abonado:

  • Mientras se supere el límite de licencia, las nuevas sesiones de abonado no tendrán licencia.
  • Las sesiones de abonado existentes antes de que se sobrepase la licencia permanecen inicialmente en su estado actual: si estaban siendo optimizadas permanecen así e igualmente si no tienen licencia.
  • Si la licencia se mantiene por encima del límite, las sesiones de abonado que se están optimizando pueden pasar a no tener licencia si acumulan un gran número de flujos no optimizados.
  • Una vez que el tráfico optimizado cae por debajo del límite, las nuevas sesiones de abonado vuelven a optimizarse.
  • Las sesiones de abonado que salen antes de que la licencia baje del límite permanecen inicialmente en su estado actual: si no tenían licencia siguen así y lo mismo si estaban siendo optimizadas.
  • Si la licencia permanece por debajo del límite, las sesiones de abonado sin licencia pueden pasar a ser optimizadas si acumulan un pequeño número de flujos optimizados.
  • Una sesión de abonado sin licencia no tiene ACM, ni limitación de velocidad y sigue generando totales de volumen de tráfico. Se suspenden los informes de volumen de cuota. No se producirá el bloqueo cuando se agote la cuota. Las demás métricas, como retransmisiones, latencias, etc. se reducirán a las de los flujos que se estén optimizando.
  • Una sesión de abonado que esté siendo optimizada se verá afectada por el hecho de que algunos de sus flujos pueden no tener licencia y, por lo tanto, el abonado puede tener un conjunto reducido de mediciones en comparación con el funcionamiento normal. Esto afecta al ACM y también a las métricas generadas para ese abonado.

El efecto de superar el límite de la licencia es que cada vez más tráfico dejará de obtener funcionalidad QoE y, a la inversa, la cantidad de tráfico que obtiene funcionalidad QoE se reduce. Una vez que la cantidad de tráfico que obtiene funcionalidad QoE es inferior al límite de licencia, los nuevos flujos y sesiones de abonado recuperarán la funcionalidad QoE. Esto continúa hasta que se supera el límite de licencia, tras lo cual el efecto se repite de nuevo. Con este comportamiento oscilante, la QoE sigue proporcionando funcionalidad al tráfico hasta el límite de licencia. La BQN comprueba continuamente el nivel de rendimiento frente a los límites de licencia (cada minuto o menos), por lo que la adaptación es bastante rápida.

Alta carga de la CPU

Si el icono de la CPU en el Dashboard no está en verde, algunas CPUs están funcionando a niveles anormalmente altos. Esto se debe normalmente a un tráfico desequilibrado (concentrado en unas pocas IPs de abonados) o a que el servidor de BQN está procesando demasiado tráfico.

La BQN dispone de mecanismos internos para mitigar esta situación, tratando de evitar las pérdidas de tráfico mediante la reducción de la cantidad de tráfico optimizado.

El nivel de rendimiento se puede verificar en Statistics->Throughput->Overview y los niveles de CPU en Statistics->System->CPU.

Hay dos tipos de alarma, según los niveles de carga de la CPU:

  • Naranja si algunos núcleos de la CPU están en alta carga (por encima del 80% de uso).  
  • Rojo si algunos núcleos de la CPU están a una carga muy alta (por encima del 90% de uso).  

Siga estos pasos:

  • Si está utilizando NAT entre el BQN y los abonados finales, incremente el número de IPs utilizadas por el NAT, para que el BQN pueda distribuir el tráfico entre más direcciones. Puede ver cómo se distribuye el tráfico entre las IPs en Statistics->Subscribers->Top By Time.
  • Habilitar la ruta de bypasso, si no es posible, reducir la cantidad de tráfico que se dirige a través de la BQN
  • Desactivar la optimización TCP en Configuración->TCPO/ACM.
  • Puede ser necesaria una actualización de hardware. Póngase en contacto con el servicio de soporte de Bequant.

Si el servidor BQN se utiliza sólo para TCPO y/o límites de velocidad por flujo, la distribución de la carga de la CPU puede mejorarse habilitando la dirección por flujo. El control por flujo distribuye la carga de tráfico entre los núcleos de la CPU por flujo individual, en lugar de la distribución de tráfico por suscriptor predeterminada. Esto mejora el equilibrio de la carga de la CPU, pero como el control por abonado se realiza por núcleo, no permite el control a nivel de abonado, como ACM, tasas de política o límites de flujo por abonado.

Alta carga de memoria

Si el icono de la memoria en el panel de control no está en verde, algunos procesos se están quedando sin memoria. Esto se debe normalmente a un tráfico desequilibrado (tráfico concentrado en unas pocas IPs de abonados) o a demasiado tráfico procesado por el servidor de BQN.

La BQN dispone de mecanismos internos para mitigar esta situación, tratando de evitar las pérdidas de tráfico mediante la reducción de la cantidad de tráfico optimizado.

El nivel de rendimiento puede verificarse en Statistics->Throughput->Overview y los niveles de memoria en Statistics->System->Memory.

Hay dos tipos de alarma, según los niveles de carga de la memoria:

  • Naranja si algunos procesos alcanzan un uso elevado (por encima del 90% de uso).  
  • Rojo si algunos procesos alcanzan un uso muy elevado (por encima del 95% de uso).  

Siga estos pasos:

  • Si está utilizando NAT entre el BQN y los abonados finales, incremente el número de IPs utilizadas por el NAT, para que el BQN pueda distribuir el tráfico entre más direcciones. Puede ver cómo se distribuye el tráfico entre las IPs en Statistics->Subscribers->Top By Time.
  • Habilite la ruta de desvío o, si no es posible, reduzca la cantidad de tráfico que se enruta a través de la BQN.
  • Desactivar la optimización TCP en Configuración->TCPO/ACM.
  • Puede ser necesaria una actualización de hardware. Póngase en contacto con el servicio de soporte de Bequant.

No se reciben mensajes RADIUS

Si no se muestra información sobre RADIUS en la interfaz gráfica de usuario de BQN, para comprobar si se reciben mensajes RADIUS, inicie sesión en el shell de BQN y ejecute el siguiente comando:


$ ssh bqnadm@192.168.0.121
bqnadm@bqn# system interface en0o1 capture filter 'udp and port 1813'
listening on eno1, link-type EN10MB (Ethernet), capture size 65535 bytes


En este ejemplo, la interfaz de gestión es eno1. Compruebe la de su servidor BQN en Configuración->Interfaces->Gestión (el 0 añadido por la configuración BQN debe ser eliminado, por ejemplo, en0s1f0 en BQN GUI es ens1f0 en Linux).

Si el cortafuegos BQN está configurado(Configuración->Interfaces->Cortafuegos de gestión), se deben añadir todas las IPs de los clientes RADIUS (en este ejemplo, 10.10.10.10 y 10.10.10.11).

Y ahora los mensajes RADIUS deben ser recibidos:


bqnadm@bqn# system interface en0o1 capture filter 'udp and port 1813'
listening on eno1, link-type EN10MB (Ethernet), capture size 65535 bytes
14:21:20.177347 IP 10.10.10.10.60072 > 192.168.0.121.radius-acct: RADIUS, Accounting Request (4), id: 0xf0 length: 222
14:21:20.177424 IP 192.168.0.121.radius-acct > 10.10.10.10.60072: RADIUS, Accounting Response (5), id: 0xf0 length: 20
. . .

Si los mensajes RADIUS siguen sin recibirse, el resto de los saltos de tráfico necesitan verificación. En nuestro ejemplo, los clientes RADIUS se encuentran en la subred 10.10.10.0/24 y BQN en la subred 192.168.0.0/24. Hay que verificar si hay rutas válidas entre las dos subredes y que ningún cortafuegos intermedio está bloqueando el puerto UDP 1813 (RADIUS Accounting). Puede iniciar la verificación en el cliente RADIUS; por ejemplo, si es un Mikrotik, utilice Herramientas->Tourch con el puerto radius-acct.

Si se reciben los mensajes RADIUS, pero la información no se refleja como se esperaba, habilite el registro de eventos entrando en el shell del servidor BQN vía ssh:

bqnadm@bqn# configure
bqnadm@bqn(config)# api common
bqnadm@bqn(config-api)# event level general
bqnadm@bqn(config-api)# event level radius
bqnadm@bqn(config-api)# event level policy
bqnadm@bqn(config-api)# event level subscriber
bqnadm@bqn(config-api)# root
bqnadm@bqn(config)# commit
bqnadm@bqn(config)# end
bqnadm@bqn#

Ahora, puede ver el registro de eventos de las peticiones RADIUS recibidas:

bqnadm@bqn# show api event log
2023-05-24T18:16:32.138 [radius] Sent Accounting-Response message to 172.27.1.194:42043: id(134)
2023-05-24T18:16:32.138 [radius] Received Accounting-Request message from 172.27.1.194:42043: id(134) statusType(start) framedIpAddress(10.0.0.11) mikrotikAddressList() mikrotikRateLimit(45M/90M 90M/100M 45M/90M 5/5)
2023-05-24T18:16:32.138 [policy] Created "RA-45M/90M-90M/100M-45M/90M-5" policy: rate(45000/90000) burstRate(90000/100000) burstDurationMs(5000/5000) burstThreshold(45000/90000) burstThresholdWindow(-1/-1) burstTransitionDurationMs(-1/-1) autoCongestionManagement(yes/yes)
2023-05-24T18:16:32.138 [subscriber] Updated "10.0.0.11" subscriber: policy(RA-45M/90M-90M/100M-45M/90M-5) sessionId(1234) userName(Sub-102) callingStationId(+34100100102) nasId() nasPort(4294967295)
2023-05-24T18:16:32.157 [radius] Sent Accounting-Response message to 172.27.1.194:22090: id(75)
2023-05-24T18:16:32.157 [radius] Received Accounting-Request message from 172.27.1.194:22090: id(75) statusType(start) framedIpAddress(10.0.0.12) mikrotikAddressList() mikrotikRateLimit(10M/20M 0K/0K 0K/0K 0/0)
2023-05-24T18:16:32.157 [subscriber] Updated "10.0.0.12" subscriber: policy(RA-10M/20M-0K-0K-0) sessionId(1234) userName(Sub-103) callingStationId(+34100100103) nasId() nasPort(4294967295)
. . .

No se reciben mensajes REST

Si la información REST no se muestra en la interfaz gráfica de usuario, la recepción de mensajes REST puede comprobarse en el BQN accediendo al shell del BQN y ejecutando el siguiente comando:


$ ssh bqnadm@192.168.0.121
bqnadm@bqn# system interface en0o1 capture filter ‘tcp and port 3443’
listening on eno1, link-type EN10MB (Ethernet), capture size 65535 bytes


En este ejemplo, eno1 es la interfaz de gestión.

Compruebe la de su servidor yendo a Configuración->Interfaces->Gestión (elimine el 0 añadido por la configuración de BQN, por ejemplo, en0s1f0 en la GUI de BQN es ens1f0 en UNIX).

Si el cortafuegos de BQN está configurado(Configuración->Interfaces->Cortafuegos de gestión), hay que añadir las IPs de todos los clientes REST (en nuestro ejemplo, 10.10.10.10 y 10.10.10.11).

Y ahora los mensajes deben ser recibidos:

bqnadm@bqn# system interface en0o1 capture filter ‘tcp and port 3443’
listening on eno1, link-type EN10MB (Ethernet), capture size 65535 bytes
17:30:30.767149 IP 192.168.88.12.48316 > 192.168.88.13.ov-nnm-websrv: Flags [S], seq 639501187, win 64240, options [mss 1460,sackOK,TS val 3813494325 ecr 0,nop,wscale 7], length 0
17:30:30.767163 IP 192.168.88.13.ov-nnm-websrv > 192.168.88.12.48316: Flags [S.], seq 2135448282, ack 639501188, win 28960, options [mss 1460,sackOK,TS val 607264358 ecr 3813494325,nop,wscale 5], length 0
17:30:30.767260 IP 192.168.88.12.48316 > 192.168.88.13.ov-nnm-websrv: Flags [.], ack 1, win 502, options [nop,nop,TS val 3813494325 ecr 607264358], length 0
. . .

Si aún no se reciben los mensajes REST, compruebe el resto de saltos del tráfico. En este ejemplo, los clientes REST están en 10.10.10.0/24 y el BQN en 192.168.0.0/24. Compruebe que hay rutas válidas entre ambas subredes y que ningún cortafuegos intermedio está bloqueando el puerto TCP 3443.

Si se reciben los mensajes REST, pero la información no se refleja como se esperaba, active el registro de eventos y rastros entrando en el shell del servidor BQN a través de ssh:

bqnadm@bqn# configure
bqnadm@bqn(config)# api common
bqnadm@bqn(config-api)# event level general
bqnadm@bqn(config-api)# event level rest
bqnadm@bqn(config-api)# event level policy
bqnadm@bqn(config-api)# event level subscriber
bqnadm@bqn(config-api)# root
bqnadm@bqn(config)# api rest
bqnadm@bqn(config-rest)# trace request 5
bqnadm@bqn(config-rest)# trace response 5
bqnadm@bqn(config-rest)# root
bqnadm@bqn(config)# commit
bqnadm@bqn(config)# end
bqnadm@bqn#

Ahora, puede ver el registro de eventos de las peticiones REST recibidas. En el siguiente ejemplo, la BQN recibe algunas POST asignando abonados a políticas tarifarias:

bqnadm@bqn# show api event log
2023-05-24T17:41:40.268 [subscriber] [10.0.0.3] Updated subscriber: policy(rest-static-3) sessionId() subscriberId(n/a) customerId(1) name() mac() nasId() nasPort(4294967295) change(0x71)
2023-05-24T17:41:40.268 [rest] [172.27.1.194:49428] Send HTTP response: code(200) httpLength(70) contentLength(0) hdrExt(0)
2023-05-24T17:41:40.296 [rest] [172.27.1.194:49434] Received HTTP request: method(POST) hdr(44/248) uri(/api/v1/subscribers/10.0.0.4) authorization(Basic) contentLength(56) connection(0) transferEncoding(0x0)
2023-05-24T17:41:40.296 [subscriber] [10.0.0.4] Created subscriber: policy(rest-static-1) sessionId() subscriberId(sub-4) customerId() name() mac() nasId() nasPort(4294967295) change(0x7fff)
2023-05-24T17:41:40.296 [rest] [172.27.1.194:49434] Send HTTP response: code(201) httpLength(75) contentLength(0) hdrExt(0)
. . .

Y las trazas de las últimas peticiones y respuestas se pueden encontrar en el directorio /opt/bqn/var/trace:

bqn0:~ # ls -al /opt/bqn/var/trace/rest*
-rw-r--r-- 1 root root 318 May 24 15:14 rest-req-0000
-rw-r--r-- 1 root root 364 May 24 11:30 rest-req-0001
-rw-r--r-- 1 root root 358 May 24 11:30 rest-req-0002
. . .

No se reciben mensajes de facturación

Si el sistema de Facturación está configurado y el icono de Facturación en el Panel de Control está en rojo, el acceso al sistema de Facturación está fallando.

Haga clic en el icono de facturación para ir a la página de estado de facturación:

En este ejemplo, hubo una sincronización exitosa a las 12:13:52 recuperando 1000 suscriptores, pero hubo un intento fallido después. Puede forzar un intento de sincronización pulsando el botón Sincronizar ahora.

Si el fallo persiste, siga estos pasos:

  • Compruebe que la configuración de facturación es correcta (dirección y credenciales).
  • Compruebe que la dirección IP de facturación es accesible desde el servidor BQN:
bqnadm@bqn# net ping 192.168.0.122
PING 192.168.0.122 (192.168.0.122) 56(84) bytes of data.
64 bytes from 172.27.1.194: icmp_seq=1 ttl=64 time=0.169 ms
64 bytes from 172.27.1.194: icmp_seq=2 ttl=64 time=0.180 ms
64 bytes from 172.27.1.194: icmp_seq=3 ttl=64 time=0.152 ms
^C
bqnadm@bqn#
  • Habilitar los registros de la API entrando en el shell del servidor BQN a través de ssh:

bqnadm@bqn# configure
bqnadm@bqn(config)# api common
bqnadm@bqn(config-api)# event level general
bqnadm@bqn(config-api)# event level billing
bqnadm@bqn(config-api)# event level policy
bqnadm@bqn(config-api)# event level subscriber
bqnadm@bqn(config-api)# commit
bqnadm@bqn(config-api)# end
bqnadm@bqn#

Ahora, puede ver el registro de eventos entre el BQN y el sistema de facturación. En el siguiente ejemplo, el BQN se conecta a un Azotel facturación son recupera tres políticas asociadas a diez suscriptores:


bqnadm@bqn# show api event log
2022-12-09T10:43:54.480 [billing] Sent HTTP POST request: uri(/restapi/listCustomerBucketData) host(172.27.1.194:443)
2022-12-09T10:43:54.482 [policy] Updated "AZ-1000-500" policy: rate(500/1000)
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.1 subscriber: policy(AZ-1000-500) block(no) customerId(10) name(Subscriber_number_10) nickname()
2022-12-09T10:43:54.482 [policy] Updated "AZ-2000-1000" policy: rate(1000/2000)
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.2 subscriber: policy(AZ-2000-1000) block(no) customerId(11) name(Subscriber_number_11) nickname()
2022-12-09T10:43:54.482 [policy] Updated "AZ-3000-1500" policy: rate(1500/3000)
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.3 subscriber: policy(AZ-3000-1500) block(no) customerId(12) name(Subscriber_number_12) nickname()
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.4 subscriber: policy(AZ-1000-500) block(no) customerId(13) name(Subscriber_number_13) nickname()
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.5 subscriber: policy(AZ-2000-1000) block(no) customerId(14) name(Subscriber_number_14) nickname()
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.6 subscriber: policy(AZ-3000-1500) block(no) customerId(15) name(Subscriber_number_15) nickname()
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.7 subscriber: policy(AZ-1000-500) block(no) customerId(16) name(Subscriber_number_16) nickname()
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.8 subscriber: policy(AZ-2000-1000) block(no) customerId(17) name(Subscriber_number_17) nickname()
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.9 subscriber: policy(AZ-3000-1500) block(no) customerId(18) name(Subscriber_number_18) nickname()
2022-12-09T10:43:54.482 [subscriber] Created 10.0.0.10 subscriber: policy(AZ-1000-500) block(no) customerId(19) name(Subscriber_number_19) nickname()
2022-12-09T10:43:54.482 [billing] Updated 10/10 billing subscribers
bqnadm@bqn#

Si se produce un error, el registro debe dar alguna indicación de lo que está sucediendo.

  • También es posible ampliar el registro a trazas detalladas de las solicitudes y respuestas intercambiadas entre el BQN y el sistema de facturación:

bqnadm@bqn# configure
bqnadm@bqn(config)# api billing
bqnadm@bqn(config-api)# trace request 5
bqnadm@bqn(config-api)# trace response 5
bqnadm@bqn(config-api)# commit
bqnadm@bqn(config-api)# end
bqnadm@bqn#

Y el BQN generará trazas de las últimas 5 peticiones y respuestas entre el BQN y el sistema de facturación. Las trazas se pueden encontrar en el directorio /opt/bqn/var/trace:


bqn0:~ # ls -al /opt/bqn/var/trace/billing*
-rw-r--r-- 1 root root  224 Apr 13 18:43 /opt/bqn/var/trace/billing-req-0000
-rw-r--r-- 1 root root  224 Apr 13 18:43 /opt/bqn/var/trace/billing-req-0001
-rw-r--r-- 1 root root 1955 Apr 13 18:43 /opt/bqn/var/trace/billing-rsp-0000
-rw-r--r-- 1 root root 1955 Apr 13 18:43 /opt/bqn/var/trace/billing-rsp-0001
. . .
  • Como último recurso, puede enviar una solicitud directamente desde el BQN al sistema de facturación utilizando el comando curl de UNIX, siguiendo las convenciones de la API del sistema de facturación. Por ejemplo, para enviar una consulta a una facturación de Azotel:

PS C:\Users\myuser>ssh root@bqn
bqn:~ # curl -H 'Accept: application/json' -H 'Content-Type: application/json' -X POST -d  '{"api_username": "myuser", "api_password": "mypassword", "allcustomers": "1"}' https://demo.azotel.com/restapi/listCustomerBucketData
{"ip":"10.10.0.12","result":0}
bqn:~ #

No hay servidores NTP sincronizados

Si el icono NTP está amarillo, el NTP no está configurado. Haga clic en el icono para ir a la página de configuración.

Si los servidores NTP están configurados pero el BQN no puede sincronizarse con ninguno de ellos, el icono NTP del guión estará en naranja:

Un cambio brusco en la hora del sistema por falta de sincronización NTP, puede provocar breves pérdidas de servicio mientras el sistema se ajusta. Para evitar que esto ocurra, ten siempre al menos un servidor NTP sincronizado.

Puede consultar la lista de servidores NTP configurados en Administración->Fecha del sistema->Servidores NTP.

Al menos un servidor NTP debe estar sincronizado. En el ejemplo anterior, el servidor NTP 145.238.203.14 ha sido elegido para la sincronización del reloj (indicado por el * junto a la dirección IP del servidor) y ha sido contactado hace 36 segundos (columna WHEN).

Si no hay ningún servidor NTP disponible, el BQN mostrará el mensaje de advertencia NTP not synchronized, como en la ventana siguiente:

To solve the issue, if you have a local NTP server, add it to the list clicking the <i class="fa-solid fa-ellipsis-vertical"></i> menu icon and selecting Add Server…

Si no tiene servidores NTP locales, asegúrese de que el puerto UDP 123 está abierto desde la IP de gestión de BQN a Internet, incluso en el cortafuegos de BQN, si está activado.

Problemas de disco

Para comprobar el estado del disco del sistema, haga clic en el icono DISCO del panel de control:

El icono del disco estará en naranja (estado de advertencia) cuando menos del 15% del almacenamiento del disco esté libre.

Etiquetas de estilo Docs
[.p-highlight] Lorem ipsum... [.p-highlight]

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

[.p-highlight-blue] Lorem ipsum... [.p-highlight-blue]

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

[.p-highlight-red] Lorem ipsum... [.p-highlight-red]

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse varius enim in eros elementum tristique. Duis cursus, mi quis viverra ornare, eros dolor interdum nulla, ut commodo diam libero vitae erat. Aenean faucibus nibh et justo cursus id rutrum lorem imperdiet. Nunc ut sem vitae risus tristique posuere.

Vista previa para el estilo de una sola [.c-highlight]palabra monoespaciada[.c-highlight].
Avance del single word mono-spaced con estilo.
anterior
SIGUIENTE