Problemi di installazione
Controllare quanto segue:
- La ISO deve essere copiata su un'unità USB con partizioni MBR e modalità DD.
- Il BIOS del server deve avere la modalità di avvio predefinita (ad esempio, DUAL).
- Se è presente un controller RAID, un'unità logica deve essere configurata e contrassegnata come avviabile.
- Verificare se il server utilizzato per l'installazione soddisfa i requisiti hardware di BQN.
- Verificare che l'installazione sia stata eseguita sul disco rigido e non abbia sovrascritto l'unità USB.
Nessun accesso all'indirizzo IP di gestione
The BQN uses a dedicated network interface for management. The management interface supports both the SSH and WEB (HTTPs) services. In case of problems accessing the configured management IP check the following:
- Ensure that the management network interface port is connected to the appropriate network.
- Verify that the link state of the management network interface is up. If the management interface is connected to a network switch, verify that the port in the switch is up and its attributes match the properties shown by the show interface command.
- Se si accede all'indirizzo IP di gestione da una rete diversa, assicurarsi che il routing statico sia configurato verso la rete di accesso, come spiegato nella sezione Interfaccia di rete della Guida dell'utente.
- Se nella rete di gestione sono presenti firewall, consentire l'accesso alla porta TCP 22 per il servizio SSH e alla porta TCP 443 per il servizio WEB.
- Verificare con la console di sistema che l'indirizzo IP di gestione e il prefisso di rete siano corretti. Collegare un monitor e una tastiera al server ed eseguire il login come root:
- Se si sospetta che le impostazioni IP OAM siano errate o sconosciute, collegare un monitor e una tastiera al server e accedere come root per modificarle utilizzando la procedura guidata bta in modalità interattiva. Ad esempio, per cambiare l'interfaccia di gestione in en0o1 con l'indirizzo IP 10.10.10.12/24 (premere invio per accettare la risposta suggerita):
Se l'interfaccia non è disponibile al momento della modifica (ad esempio, ha partecipato a un wire), un messaggio richiederà un riavvio. Dopo il riavvio, il BQN dovrebbe avere il nuovo IP e la nuova interfaccia di rete di gestione.
- The BQN management interface may be protected by its own firewall. The problem could be that your source IP address is not included in that firewall white list. This could happen even for addresses from the same subnet of the BQN management IP if the subnet is not part of the firewall rules. You can disable the firewall temporarily until the connection to the management port is restored. Connect a monitor and a keyboard to the server and login as root:
Una volta che l'IP di gestione è raggiungibile, è possibile definire la nuova lista bianca degli intervalli IP di origine consentiti.
- 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:
Web non accessibile
- Verificare che l'indirizzo IP di gestione sia accessibile tramite SSH,
- Verificare che l'accesso avvenga tramite HTTPS (HTTP non è supportato). Esempio di URL: https://192.168.0.121
- Verificare che si stia utilizzando l'utente bqnadm (root non può essere utilizzato nell'accesso alla GUI).
- Quando si installa da zero, assicurarsi che sia stato eseguito il comando guidato bta (altrimenti il servizio web dell'interfaccia grafica non sarà attivo e non verrà creato un utente bqnadm).
- Verificare che la porta SSH del server BQN non sia stata modificata. Per accedere al BQN utilizzando una porta diversa dalla 22, è possibile definire regole di port forwarding nel router del percorso di accesso, ma la porta SSH del BQN non può essere modificata. Accedendo al server come root, è possibile verificare che la porta SSH sia la 22 come segue:
Se necessario, commentare la riga che specifica una porta diversa da 22.
- Verificare che il proprio browser sia supportato (Edge, Firefox, Chrome). MS Explorer, ad esempio, non è supportato.
Interfaccia di rete disattivata
Se l'icona Interfacce di rete nella Dashboard non è verde.
Andare a Configurazione->Interfacce->Dati Wires
In rosso (critico)
- Se non è stato configurato wire , crearne uno.
- Se wires è configurato ma le sue interfacce non sono in stato di UP, ciò indica molto probabilmente che le interfacce non sono compatibili con Intel. Andare a Configurazione->Interfacce->Dati Wires e fare clic sull'interfaccia in basso per vedere il modello(PCI vendor ID) e confermare che non è Intel. Rimuovere il sito wire e crearne uno nuovo con entrambe le interfacce in modalità pcap. Questo dovrebbe portare le interfacce in stato UP, ma con una capacità di throughput molto inferiore (meno di 1Gbps).
- Se è configurato wires , con le interfacce in stato UP ma con LINK down, c'è un problema di connessione con l'altra apparecchiatura. Collegare entrambe le porte di interfaccia tra loro in un loop utilizzando un cavo/fibra adeguato. Se entrambe le interfacce sono attive, il problema è dell'altra apparecchiatura.
Se il collegamento è ancora interrotto e si utilizzano porte ottiche, verificare che i ricetrasmettitori:
- sono compatibili con Intel
- are supported (see Supported Network Cards for a list).
- del tipo richiesto dall'installazione (ad esempio, SFP+-LR in un'installazione con fibra monomodale e SFP+-LR sull'altro lato).
In giallo (Avviso)
- Se il sito wires che appare come non funzionante si suppone che abbia traffico, seguire i passi della sezione precedente (Critico)
- Se i wires che appaiono inattivi non sono in uso e si vuole rimuovere il segnale di avviso, si può cancellare il wires inutilizzato. Considerate che le modifiche alla configurazione di wire interromperanno il traffico per alcuni secondi.
Traffico invertito
If the Inverted Traffic icon in the Dashboard is in orange (Warning), it is indication that traffic throughput in the uplink direction is bigger than in the downlink direction. This can be normal in small deployments (less than a hundred subscribers, like in a BQN in a lab) but in a network deployment most likely indicates that some of the wires have been connected incorrectly, with the access port connected to the Internet side and vice versa.
To verify that this is the case, go to Statistics->Throughput->Interfaces and select the wire interface configured in the access side. If it shows more received throughput that sent throughput, it is indication that the wire is inverted. This can be confirm selecting the throughput of the Internet-side interface to see that its sent traffic is bigger than its received traffic.
Per risolvere il problema, accedere a Configurazione->Interfacce->Dati Wires e, nel riquadro wire, premere l'icona Scambia interfacce.
Traffico ridotto
Se l'icona Basso traffico nel Dashboard non è verde.
In giallo (Avviso)
Passare il mouse sull'icona per confermare che viene visualizzato l'avviso di traffico ridotto. Indica che il traffico che attraversa il server BQN è molto ridotto. Questo è normale se il sistema sta ancora aspettando che il traffico venga instradato attraverso di esso. Tuttavia, in un sistema in produzione può essere un'indicazione che qualche guasto in un altro punto della rete impedisce al traffico di raggiungere il server BQN.
In arancione (Attenzione)
Passare il mouse sull'icona. Il Traffic-uplink o il Traffic-downlink dovrebbero essere segnalati. Questo perché non c'è traffico che attraversa il BQN in quella direzione e quindi il traffico è asimmetrico. Andare in Configurazione->Impostazioni TCP/ACM e impostare l'Ottimizzazione generale TCP su Off mentre si risolve il problema.
Sistemare l'instradamento del traffico in modo che il BQN veda entrambe le direzioni (uplink e downlink). Al termine e dopo che l'icona è tornata verde, andare a Configurazione->Impostazioni TCP/ACM per abilitare l'ottimizzazione TCP complessiva.
Gestore delle licenze
Se l'icona License Manager nella dashboard è in giallo e il testo dice "license-mgr-connection:notice", è perché il server BQN non riesce a raggiungere il license manager. Il gestore delle licenze è responsabile della convalida delle licenze SW BQN e aiuta Bequant a fornire un supporto più proattivo segnalando i problemi del server.
Assicurarsi che il server BQN sia in grado di avviare connessioni in uscita verso l'IP di License Manager (per maggiori dettagli, contattare l'assistenza di Bequant ).
Per verificare che sia possibile una connessione in uscita, accedere come root e fare un telnet all'IP e alla porta forniti:
Licenza non OK
Se l'icona della licenza nella Dashboard è rossa e il testo dice "license-available:critical" o"license-expiration: critical", non c'è una licenza valida. Ciò potrebbe essere dovuto a diversi motivi:
- Non esiste una licenza definita nel nodo
- La licenza non è valida
- La licenza non è più valida (la data finale è scaduta).
Contattare il distributore per ottenere una licenza valida.
È possibile controllare lo stato della licenza in Amministrazione->Licenza.
Quando non c'è una licenza valida, il BQN inoltrerà tutto il traffico in modo trasparente: il servizio non sarà influenzato, ma nessuna delle elaborazioni avanzate del BQN sarà applicata al traffico.
Limite di licenza superato
Se l'icona della licenza nella Dashboard è arancione e il testo dice "license-use: warning", la capacità massima della licenza è stata superata (il traffico nel server BQN è superiore al limite della licenza).
Contattare il distributore per un aggiornamento della licenza.
È possibile controllare la capacità della licenza in Amministrazione->Licenza.
In Statistiche->Throughput->Overview, una linea rossa mostra il limite della licenza e i livelli di throughput recenti.
Il superamento del limite della licenza deve essere temporaneo, mentre la licenza viene aggiornata alla giusta capacità.
Quando il limite della licenza viene superato, il QoE non fa cadere i pacchetti, ma li fa semplicemente passare in ponte.
L'effetto sul traffico è diverso a livello di flusso e di sessione dell'abbonato.
Effetti a livello di flusso:
- Mentre il limite di licenza viene superato, i nuovi flussi non avranno alcuna licenza.
- Existing flows prior to the license being exceeded are unaffected: if they were being optimized remain so and likewise if without a license.
- Quando il traffico ottimizzato scende al di sotto del limite, i nuovi flussi vengono nuovamente ottimizzati.
- I flussi esistenti prima della licenza che scendono al di sotto del limite non sono influenzati: se non avevano la licenza rimangono tali e allo stesso modo se erano in fase di ottimizzazione.
- Un flusso senza licenza non ha TCPO, non ha shaping e non genera metriche (ritrasmissioni, latenze, DPI, ecc.).
Effetti a livello di sessione abbonati:
- Mentre il limite di licenze viene superato, le nuove sessioni di abbonati non avranno alcuna licenza.
- Le sessioni di abbonati esistenti prima del superamento della licenza rimangono inizialmente nel loro stato attuale: se erano in fase di ottimizzazione rimangono tali e allo stesso modo se sono prive di licenza.
- Se la licenza rimane al di sopra del limite, le sessioni di abbonati ottimizzate possono passare a nessuna licenza se accumulano un numero elevato di flussi non ottimizzati.
- Quando il traffico ottimizzato scende al di sotto del limite, le nuove sessioni degli abbonati vengono nuovamente ottimizzate.
- Le sessioni degli abbonati che escono prima che la licenza scenda al di sotto del limite rimangono inizialmente nel loro stato attuale: se non avevano licenza rimangono tali e allo stesso modo se erano in fase di ottimizzazione.
- Se la licenza rimane al di sotto del limite, le sessioni degli abbonati senza licenza possono passare a essere ottimizzate se accumulano un piccolo numero di flussi ottimizzati.
- Una sessione di abbonati senza licenza non ha ACM, non ha limitazione di velocità e continua a generare i totali del volume di traffico. La segnalazione del volume della quota è sospesa. Il blocco all'esaurimento della quota non avrà luogo. Le altre metriche, come le ritrasmissioni, le latenze, ecc. saranno ridotte a quelle dei flussi ottimizzati.
- Una sessione di abbonato in fase di ottimizzazione sarà influenzata dal fatto che alcuni dei suoi flussi potrebbero non avere una licenza e quindi l'abbonato potrebbe avere un set di misure ridotto rispetto al funzionamento normale. Ciò influisce sull'ACM e anche sulle metriche generate per quell'abbonato.
L'effetto del superamento del limite della licenza è che sempre più traffico non otterrà più la funzionalità QoE e, viceversa, la quantità di traffico che ottiene la funzionalità QoE si riduce. Una volta che la quantità di traffico che ottiene la funzionalità QoE è inferiore al limite della licenza, i nuovi flussi e le sessioni degli abbonati riacquistano la funzionalità QoE. Ciò continua fino al superamento del limite di licenza, dopodiché l'effetto si ripete nuovamente. Con questo comportamento oscillante, il QoE continua a fornire funzionalità al traffico fino al limite della licenza. Il BQN controlla continuamente il livello di throughput rispetto ai limiti di licenza (ogni minuto o meno), quindi l'adattamento è piuttosto rapido.
Elevato carico della CPU
Se l'icona della CPU nella Dashboard non è verde, alcune CPU stanno funzionando a livelli anormalmente alti. Ciò è normalmente dovuto a un traffico sbilanciato (concentrato in alcuni IP di abbonati) o a un traffico eccessivo da parte del server BQN.
Il BQN dispone di meccanismi interni per mitigare questa situazione, cercando di prevenire le perdite di traffico riducendo la quantità di traffico ottimizzato.
Il livello di throughput può essere verificato in Statistiche->Throughput->Overview e i livelli di CPU in Statistiche->Sistema->CPU.
Esistono due tipi di allarme, a seconda dei livelli di carico della CPU:
- Arancione se alcuni core della CPU sono ad alto carico (oltre l'80% di utilizzo).
- Red if some CPU cores are at very high load (above 90% usage).
Procedere come segue:
- Se si utilizza il NAT tra il BQN e gli abbonati finali, aumentare il numero di IP utilizzati dal NAT, in modo che il BQN possa distribuire il traffico tra più indirizzi. Si può vedere come il traffico è distribuito tra gli IP in Statistiche->Sottoscrittori->Top per tempo.
- Abilitare il percorso di bypass o, se non è possibile, ridurre la quantità di traffico instradato attraverso il BQN.
- Disattivare l'ottimizzazione TCP in Configurazione->Impostazioni TCP/ACM.
- Potrebbe essere necessario un aggiornamento dell'hardware. Contattare l'assistenza Bequant .
Se il server BQN viene utilizzato solo per il TCPO e/o per i limiti di velocità per flusso, è possibile migliorare la distribuzione del carico della CPU abilitando lo steeting per flusso. La gestione per flusso distribuisce il carico di traffico tra i core della CPU per ogni singolo flusso, invece della distribuzione predefinita del traffico per abbonato. Questo migliora il bilanciamento del carico della CPU, ma poiché il controllo per abbonato viene effettuato per core, non consente il controllo a livello di abbonato, come ACM, tassi di policy o limiti di flusso per abbonato.
Elevato carico di memoria
Se l'icona Memoria nel Dashboard non è verde, alcuni processi stanno esaurendo la memoria. Ciò è normalmente dovuto a un traffico sbilanciato (traffico concentrato in alcuni IP di abbonati) o a un traffico eccessivo elaborato dal server BQN.
Il BQN dispone di meccanismi interni per mitigare questa situazione, cercando di prevenire le perdite di traffico riducendo la quantità di traffico ottimizzato.
Il livello di throughput può essere verificato in Statistiche->Throughput->Overview e i livelli di memoria in Statistiche->Sistema->Memoria.
Esistono due tipi di allarme, a seconda dei livelli di carico della memoria:
- Arancione se alcuni processi raggiungono un utilizzo elevato (oltre il 90%).
- Red if some processes reach very high usage (above 95% usage).
Procedere come segue:
- Se si utilizza il NAT tra il BQN e gli abbonati finali, aumentare il numero di IP utilizzati dal NAT, in modo che il BQN possa distribuire il traffico tra più indirizzi. Si può vedere come il traffico è distribuito tra gli IP in Statistiche->Sottoscrittori->Top per tempo.
- Abilitare il percorso di bypass o, se non è possibile, ridurre la quantità di traffico instradato attraverso il BQN.
- Disattivare l'ottimizzazione TCP in Configurazione->Impostazioni TCP/ACM.
- Potrebbe essere necessario un aggiornamento dell'hardware. Contattare l'assistenza Bequant .
Non vengono ricevuti messaggi RADIUS
Se nella GUI di BQN non vengono visualizzate informazioni RADIUS, per verificare se sono in arrivo messaggi RADIUS, accedere alla shell di BQN ed eseguire il seguente comando:
In this example, the management interface is eno1. Check the one of your BQN server in Configuration->Interfaces->Management (the 0 added by BQN configuration must be removed, for example, en0s1f0 in BQN GUI is ens1f0 in Linux).
If the BQN firewall is configured (Configuration->Interfaces->Management Firewall), all RADIUS client IPs must be added (in this example, 10.10.10.10 and 10.10.10.11).
Ora i messaggi RADIUS dovrebbero essere ricevuti:
If RADIUS messages are still no received, the rest of the traffic jumps need verification. In our example, RADIUS clients are in subnet 10.10.10.0/24 and BQN in subnet 192.168.0.0/24. It has to be verified if there are valid routes between the two subnets and that no intermediate firewall is blocking UDP port 1813 (RADIUS Accounting). You can start the verification at the RADIUS client; for example, if it is a Mikrotik, use Tools->Tourch with port radius-acct.
If the RADIUS messages are received, but the information is not reflected as expected, enable the event log entering the BQN server shell via ssh:
Ora è possibile vedere il registro degli eventi delle richieste RADIUS ricevute:
Non vengono ricevuti messaggi REST
Se le informazioni REST non vengono visualizzate nella GUI, è possibile verificare la ricezione dei messaggi REST nel BQN accedendo alla shell BQN ed eseguendo il seguente comando:
In questo esempio, eno1 è l'interfaccia di gestione.
Check the one in your server going to Configuration->Interfaces->Management (remove the 0 added by BQN configuration, e.g., en0s1f0 in the BQN GUI is ens1f0 in UNIX).
If the BQN firewall is configured (Configuration->Interfaces->Management Firewall), the IPs of all the REST clients must be added (in our example, 10.10.10.10 and 10.10.10.11).
Ora i messaggi dovrebbero essere ricevuti:
Se i messaggi REST non vengono ancora ricevuti, verificare le altre fasi del traffico. In questo esempio, i client REST si trovano in 10.10.10.0/24 e il BQN in 192.168.0.0/24. Verificare che esistano percorsi validi tra le due sottoreti e che nessun firewall intermedio stia bloccando la porta TCP 3443.
Se i messaggi REST vengono ricevuti, ma le informazioni non si riflettono come previsto, attivare il registro eventi e le tracce entrando nella shell del server BQN tramite ssh:
Ora è possibile vedere il registro degli eventi delle richieste REST ricevute. Nell'esempio seguente, il BQN riceve alcuni POST che assegnano gli abbonati alle politiche tariffarie:
Le tracce delle ultime richieste e risposte si trovano nella directory /opt/bqn/var/trace:
Non vengono ricevuti messaggi di fatturazione
Se il sistema di fatturazione è configurato e l'icona Fatturazione nella Dashboard è rossa, l'accesso al sistema di fatturazione non è possibile.
Cliccare sull'icona della fatturazione per accedere alla pagina dello stato di fatturazione:
In questo esempio, la sincronizzazione è avvenuta con successo alle 12:13:52, recuperando 1000 abbonati, ma successivamente c'è stato un tentativo fallito. È possibile forzare un tentativo di sincronizzazione premendo il pulsante Sincronizza ora.
Se il guasto persiste, procedere come segue:
- Verificare che la configurazione della fatturazione sia corretta (direzione e credenziali).
- Verificare che l'indirizzo IP di fatturazione sia raggiungibile dal server BQN:
- Abilitare i registri API entrando nella shell del server BQN tramite ssh:
Ora è possibile vedere il registro degli eventi tra il BQN e il sistema di fatturazione. Nell'esempio seguente, il BQN si collega a un sistema di fatturazione Azotel e recupera tre politiche associate a dieci abbonati:
Se si verifica un errore, il log dovrebbe fornire qualche indicazione su ciò che sta accadendo.
- È anche possibile estendere la registrazione a tracce dettagliate delle richieste e delle risposte scambiate tra il BQN e il sistema di fatturazione:
BQN genererà le tracce delle ultime 5 richieste e risposte tra BQN e il sistema di fatturazione. Le tracce si trovano nella directory /opt/bqn/var/trace:
- Come ultima risorsa, è possibile inviare una richiesta direttamente dal BQN al sistema di fatturazione utilizzando il comando UNIX curl, seguendo le convenzioni API del sistema di fatturazione. Ad esempio, per inviare una richiesta a un sistema di fatturazione Azotel:
Nessun server NTP sincronizzato
Se l'icona NTP è gialla, l'NTP non è configurato. Fare clic sull'icona per accedere alla pagina di configurazione.
Se i server NTP sono configurati ma il BQN non può sincronizzarsi con nessuno di essi, l'icona NTP nel dash sarà arancione:
An abrupt change in the system time because of lack of NTP synchronization, may lead to brief service losses while the system adjusts. To avoid this from happening, have always at least one NTP server in sync.
You can check the list of configured NTP servers in Administration->System Date->NTP Servers.
È necessario sincronizzare almeno un server NTP. Nell'esempio precedente, il server NTP 145.238.203.14 è stato scelto per la sincronizzazione dell'orologio (indicato dal simbolo * accanto all'indirizzo IP del server) ed è stato contattato 36 secondi fa (colonna WHEN).
Se non è disponibile un server NTP, il BQN mostrerà il messaggio di avviso NTP non sincronizzato, come nella finestra seguente:
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…
Se non si dispone di server NTP locali, assicurarsi che la porta UDP 123 sia aperta dall'IP di gestione del BQN verso Internet, anche nel firewall del BQN, se attivato.
Problemi del disco
Per controllare lo stato del disco di sistema, fare clic sull'icona DISK del dashboard:
L'icona del disco è arancione (stato di avviso) quando è libero meno del 15% della memoria del disco.
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.
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.
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.