Documenti BQN

Gruppi di abbonati

‍

Un gruppo di abbonati è un insieme di abbonati. Un abbonato può essere associato a un gruppo tramite l'indirizzo IP o il suo ID abbonato. Un abbonato può appartenere a un massimo di sette gruppi di abbonati diversi, più un gruppo predefinito chiamato all-subscribers a cui appartengono tutti gli indirizzi IP. L'appartenenza può essere basata sull'indirizzo IP, su intervalli di indirizzi, sull'ID dell'abbonato e sulla VLAN.

Il BQN può mostrare le metriche di rete per gruppo di abbonati. A seconda di come vengono definiti i gruppi, queste metriche consentono di analizzare i punti di accesso, le sottoreti di rete o qualsiasi categorizzazione dei clienti che possa essere mappata in gruppi.

‍

Creare gruppi di abbonati

‍

Per creare un gruppo di abbonati, andare su Stato->Abbonati->Gruppi di abbonati. Si può anche accedere a Configurazione->Gruppi di abbonati.

Clockon Aggiungi gruppo di abbonati...

A un gruppo di abbonati viene assegnato un nome, senza spazi.

È possibile definire i membri dell'abbonamento:

• In base all'indirizzo IP o all'intervallo di indirizzi, cliccando su Aggiungi indirizzo IP/intervallo...
• Per ID abbonato, cliccando su Aggiungi ID abbonato...
• Per VLAN, cliccando su AggiungiID VLAN...

Gli indirizzi IP e/o gli ID possono essere aggiunti caricando un file di testo con una voce per riga. Le opzioni di caricamento del file si trovano nel menu in alto a destra. Esempi:

• L'opzione di menu Unisci indirizzo IP da file... aggiunge gli indirizzi IP contenuti nel file a quelli già esistenti nel gruppo.
• L'opzione di menu Sostituisci ID abbonati con file... sostituisce l'insieme di ID abbonati correnti con quelli contenuti nel file caricato.

La tabella a destra, Indirizzi IP correnti, mostra tutti gli indirizzi IP che fanno parte del gruppo, sia perché aggiunti direttamente sia perché associati a un ID utente o a una VLAN del gruppo. La tabella indica anche quali indirizzi IP hanno traffico(Attivo sì).

I gruppi di abbonati creati sono elencati nella tabella Stato->Abbonati->Gruppi di abbonati e possono essere modificati cliccando sull'icona di modifica.

‍

Vedere Metriche del gruppo di abbonati

‍

In Stato->Abbonati->Gruppi di abbonati o in Statistiche->Abbonati->Gruppi di abbonati, una tabella mostra i gruppi di abbonati definiti e le loro metriche.

Il grafico mostra per impostazione predefinita i primi 10 gruppi di abbonati e una colonna PLOT nella tabella indica i gruppi inclusi nel grafico. È possibile visualizzare fino a 30 gruppi di abbonati contemporaneamente, selezionando le rispettive caselle di selezione della trama. Il grafico viene aggiornato automaticamente dopo alcuni secondi. Se si deseleziona il segno di spunta della trama, il gruppo viene rimosso dal grafico.

Le metriche possono riguardare le direzioni downlink o uplink e un periodo di tempo fino a tre mesi.

Le metriche disponibili sono:

• Velocità media.
• Flussi attivi.
• Flussi creati al minuto.
• Latenza.
• Ritrasmissione.
• Congestione.
• % di traffico che procede alla massima velocità.

Queste metriche sono simili a quelle mostrate per un abbonato (per maggiori dettagli, vedere la descrizione della dashboard Abbonato nella sezione visibilità della rete per i dettagli).

È possibile utilizzare un filtro per selezionare solo i gruppi che hanno come membro un indirizzo IP o un ID utente:

Esiste anche una mappa di calore che aiuta a identificare i valori insoliti delle metriche. Funziona come la mappa di calore nella pagina delle metriche QoE degli abbonati.

Facendo clic sul nome di un gruppo di abbonati, viene visualizzata una dashboard del gruppo di abbonati, con le metriche in grafici separati:

‍

Quando si filtra per indirizzo IP, la colonna PERMANENTE indica se il gruppo di abbonati è stato assegnato a questo indirizzo IP tramite CLI o REST (permanente) o tramite RADIUS o Fatturazione (non permanente). Le assegnazioni a un gruppo di abbonati tramite REST o CLI hanno quindi la precedenza su RADIUS e Billing, che possono essere utilizzati per regolare l'appartenenza al gruppo di abbonati,

È anche possibile accedere a questa pagina cliccando con il tasto destro del mouse sul nome del gruppo di sottoscrittori nella legenda del grafico o sul grafico stesso.

Limitazione della tariffa del gruppo di abbonati

‍

È possibile impostare un limite di velocità al traffico complessivo del gruppo di abbonati, che deve essere condiviso da tutti gli abbonati del gruppo. La limitazione della velocità implementa l'equità max-min, cioè l'obiettivo è scegliere limiti per abbonato che massimizzino quelli più bassi, in modo che la distribuzione dei limiti del gruppo sia il più equa possibile tra i membri del gruppo.

Per applicare i limiti tariffari per gruppo di abbonati, verificare innanzitutto che sia abilitato in Configurazione->Impostazioni di ottimizzazione (è abilitato per impostazione predefinita):

‍

Il passo successivo è creare un criterio di velocità in Configurazione->Tariffe abbonati con i limiti di velocità in uplink e downlink. In questo esempio, imposteremo un limite di 500 Mbps in downlink e nessun limite in uplink (n/a).

Si noti che per i gruppi di abbonati vengono applicati solo i limiti di velocità (gli altri parametri dei criteri, come gli attributi di burst, vengono ignorati).

Infine, accedere alla pagina di modifica del gruppo di sottoscrittori e selezionare la tariffa della polizza.

Una finestra di dialogo elenca le politiche tariffarie disponibili. Selezionate quella da associare al gruppo di abbonati.

‍

Saltare la limitazione delle tariffe dei gruppi di abbonati

‍

È possibile liberare parte del traffico dai limiti di velocità del gruppo di abbonati. Questo si ottiene definendo una politica di flusso che ha abilitato lo switch Salta le limitazioni di velocità dei gruppi di abbonati, come nell'esempio seguente:

È possibile decidere quale traffico non è soggetto ai limiti del gruppo di abbonati definendo delle regole da valutare in base a questa politica di flusso. Nell'esempio seguente, una VLAN è esclusa dai limiti del gruppo di abbonati:

‍

‍

‍

‍

Gestire i gruppi di abbonati da API REST

‍

Oltre all'interfaccia grafica, è possibile utilizzare l'API REST di BQN per gestire i gruppi di abbonati.

‍

Per aggiungere un IP 10.0.0.35 esistente a un gruppo di abbonati "city-north":

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"subscriberGroups": ["city-north”]}'

‍

Il gruppo di abbonati viene creato automaticamente se non esiste.

L'elenco dei gruppi deve sempre riflettere l'elenco completo dei membri. Ad esempio, per aggiungere un IP 10.0.0.35 a un gruppo di abbonati "vip":

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35 -H "Content-Type: application/json" --data '{"subscriberGroups": ["city-north”, “vip”]}'

‍

Se l'IP ha appartenenze a un gruppo, queste verranno restituite da un GET:

curl -k -u myuser:mypassword -X GET https://192.168.0.121:3443/api/v1/subscribers/10.0.0.35

{
  "subscriberIp" : "10.0.0.35",
  "subscriberId" : "sub-12",
  "subscriberGroups" : [ "city-north", "vips" ],
  "policyRate" : "Plan-200Mbps"
}

‍

L'appartenenza a uno specifico gruppo di abbonati può essere ottenuta come segue:

curl -k -u myuser:mypassword -X GET https://192.168.0.121:3443/api/v1/subscriberGroups/city-north

{
  "subscriberGroupName" : "city-north",
  "memberSubscriberIps" : [ "10.0.0.35", "10.0.0.15", "10.0.0.25", "10.0.0.10" ]
}

‍

E per ottenere l'elenco completo dei gruppi di abbonati:

curl -k -u myuser:mypassword -X GET https://192.168.0.121:3443/api/v1/subscriberGroups

{
  "items" : [
    {
      "subscriberGroupName" : "city-north",
      "memberSubscriberIps" : [ "10.0.0.35", "10.0.0.15", "10.0.0.25", "10.0.0.10" ]
    },
    {
      "subscriberGroupName" : "vips",
      "memberSubscriberIps" : [ "10.0.0.35", "10.0.0.15", "10.0.0.25", "10.0.0.20" ]
    }
  ]
}

‍

È possibile aggiungere membri a un gruppo in base agli ID degli abbonati, inviando un PORT con l'elenco degli ID al punto finale del gruppo di abbonati:

curl -k -u myuser:mypassword -X POST https://192.168.0.121:3443/api/v1/subscriberGroups/city-north -H "Content-Type: application/json" --data '{memberSubscriberIds: [“sub-1”, “sub-2”, “sub-3”]}’

È inoltre possibile impostare i limiti di velocità del gruppo di abbonati come segue (1 Gbps in downlink e 500 Mbps in uplink nell'esempio):

curl -k -u myuser:mypassword -X PUT https://192.168.0.121:3443/api/v1/subscriberGroups/city-north -H "Content-Type: application/json" --data '{“policyRate”: "my-SG-Policy"}’

‍

Per maggiori dettagli, consultare il riferimento all'API REST.

‍

Gestire i gruppi di abbonati da RADIUS

‍

BQN nell'implementazione del proxy RADIUS può gestire gruppi di abbonati. Per maggiori dettagli, consultare il capitolo RADIUS .