Documentos BQN

Grupos de assinantes

‍

Um grupo de assinantes é um conjunto de assinantes. Um assinante pode ser associado a um grupo através do endereço IP ou do seu ID de assinante. Um assinante pode pertencer a até sete grupos de assinantes diferentes, além de um grupo padrão chamado all-subscribers ao qual todos os endereços IP pertencem. A associação pode ser baseada no endereço IP, intervalos de endereços, ID de assinante e VLAN.

O BQN pode apresentar métricas de rede por grupo de assinantes. Dependendo de como os grupos são definidos, essas métricas permitem a análise por pontos de acesso, sub-redes de rede ou qualquer categorização de clientes que possa ser mapeada em grupos.

‍

Criar grupos de subscritores

‍

Para criar um grupo de subscritores, vá a Status->Subscribers->Subscriber Groups (Estado->Subscritores->Grupos de subscritores). Também pode ser acedido a partir de Configuration->Subscriber Groups (Configuração->Grupos de assinantes).

Clockon Adicionar grupo de subscritores...

É atribuído um nome, sem espaços, a um grupo de assinantes.

Os membros subscritores podem ser definidos:

• Por endereço IP ou intervalo de endereços, clicar em Adicionar endereço IP/intervalo...
• Por ID de assinante, clicando em Adicionar ID de assinante...
• Por VLAN, clicando emAdicionarVLAN ID...

Os endereços IP e/ou IDs podem ser adicionados carregando um ficheiro de texto com uma entrada por linha. As opções de carregamento de ficheiros estão no menu no canto superior direito. Exemplos:

• A opção de menu Fundir endereço IP do ficheiro... adicionará os endereços IP contidos no ficheiro aos já existentes no grupo.
• A opção de menu Substituir IDs de assinante por ficheiro... substitui o conjunto atual de IDs de assinante pelos contidos no ficheiro carregado.

A tabela da direita, Endereços IP actuais, mostra todos os endereços IP que fazem parte do grupo, quer porque foram adicionados diretamente, quer porque estão associados a um ID de assinante ou a uma VLAN que faz parte do grupo. A tabela também indica quais os endereços IP que têm tráfego(Active yes).

Os grupos de assinantes criados são listados na tabela Status->Subscribers->Subscriber Groups e podem ser editados clicando no ícone de edição.

‍

Como ver as métricas do grupo de assinantes

‍

Várias métricas de grupos de assinantes podem ser encontradas no Painel de Controle do Grupo de Assinantes e em Status->Subscribers->Subscriber Groups ou Statistics->Subscribers->Subscriber Groups. Veja detalhes do modo em Métricas de Grupos de Assinantes.

Limitação da tarifa do grupo de assinantes

‍

É possível definir um limite de taxa para o tráfego global do grupo de assinantes, a ser partilhado por todos os assinantes do grupo. O rate limiting implementa max-min fairness, ou seja, o objetivo é escolher limites por subscritor que maximizem os mais baixos, de modo a que a distribuição dos limites do grupo seja o mais equitativa possível entre os membros do grupo.

Para aplicar limites de tarifas por grupo de assinantes, verifique primeiro se está ativado em Configuração->Configurações de otimização (está ativado por defeito):

‍

O próximo passo é criar uma política de taxas em Configuration->Subscriber Rates com os limites de taxas de uplink e downlink. Neste exemplo, vamos definir um limite de 500 Mbps na direção da ligação descendente e nenhum limite na ligação ascendente (n/a).

Tenha em atenção que, para os grupos de assinantes, apenas são aplicados os limites de débito (outros parâmetros de política, como os atributos de débito, são ignorados).

Por fim, aceda à página de edição do grupo de assinantes e seleccione a taxa da apólice.

É apresentada uma caixa de diálogo com as políticas tarifárias disponíveis. Seleccione a que deve ser associada ao grupo de assinantes.

‍

Saltar a limitação da taxa do grupo de assinantes

‍

É possível liberar algum tráfego dos limites de taxa do grupo de assinantes. Isso é feito definindo uma política de fluxo que habilitou o switch Ignorar limitações de taxa de grupo de assinantes, como no exemplo abaixo:

É possível decidir qual tráfego é liberado dos limites do grupo de assinantes definindo regras que avaliam essa política de fluxo. No exemplo seguinte, uma VLAN está isenta do limite do grupo de assinantes:

‍

‍

‍

‍

Gerir grupos de subscritores a partir da API REST

‍

Para além da GUI, a API REST do BQN pode ser utilizada para gerir grupos de subscritores.

‍

Para adicionar um IP 10.0.0.35 existente a um grupo de assinantes "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”]}'

‍

O grupo de assinantes será criado automaticamente se não existir.

A lista de grupos deve reflectir sempre a lista completa de membros. Por exemplo, para adicionar um IP 10.0.0.35 existente a um grupo de assinantes "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 o IP tiver membros de grupo, estes serão devolvidos por um 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"
}

‍

A filiação de um grupo de assinantes específico pode ser obtida da seguinte forma:

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 para obter a lista completa dos grupos de subscritores:

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" ]
    }
  ]
}

‍

Pode adicionar membros a um grupo através dos IDs dos assinantes, enviando um PORT com a lista de IDs para o ponto final do grupo de assinantes:

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”]}’

Também pode definir os limites de taxa do grupo de assinantes da seguinte forma (1 Gbps de ligação descendente e 500 Mbps de ligação ascendente no exemplo):

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"}’

‍

Consulte a referência da API REST para obter mais detalhes.

‍

Gerir grupos de subscritores a partir de RADIUS

‍

O BQN na implementação de proxy RADIUS pode tratar grupos de assinantes. Para mais pormenores, consulte o capítulo RADIUS .