Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Comandos operacionais da APM CLI

Este tópico fornece uma visão geral dos comandos de show, incluindo sintaxe, descrições de opção e saída de amostra. Use esses comandos na APM.

solicitar a apm ativar

Sintaxe

Descrição

Ative o APM para ativar o pool especificado excluindo o dreno ativo na piscina. Você pode emitir este comando quando o pool estiver em qualquer um dos seguintes estados de recuperação:

  • drain— O comando remove o dreno ativo antes que o BNG configure o dreno na piscina.

  • drain-set— O comando remove o dreno ativo quando a piscina está sendo drenada.

Use o show apm reclaim-events comando na APM para verificar o estado de recuperação do pool.

Nota:

Este comando só funciona quando o pool está no estado ou drain-set como draining resultado da recuperação manual. A APM bloqueia o comando quando o estado de recuperação é o resultado da recuperação automática.

Opções

entity ip-address

Especifique o endereço IP do BNG gerenciado que recebeu a instrução.

pool-domain name

Especifique o nome do domínio do pool que contém o pool direcionado.

pool pool-name

Especifique o nome da piscina onde o dreno será removido.

Nível de privilégio exigido

Raiz

Saída de amostra

solicitar a entidade de ativação de pm (Grupo específico)

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.

solicitar um dreno de pm

Sintaxe

Descrição

Acione o APM para instruir o BNG especificado a drenar o pool especificado no domínio da piscina. Quando o dreno está no pool, ele não pode alocar nenhum endereço. Você pode solicitar um dreno quando a piscina tiver o status de recuperação. Se não houver dreno colocado na piscina, o BNG ainda pode alocar endereços.

Use o show apm alarms comando para exibir o status do alarme. Use o show apm reclaim-events comando para verificar o estado de recuperação; A drain e drain-setsaída indicam que um dreno foi solicitado ou colocado na piscina.

Opções

entity ip-address

Especifique o endereço IP do BNG gerenciado que recebe a instrução.

pool-domain name

Especifique o nome do domínio do pool que contém o pool direcionado.

pool pool-name

Especifique o nome da piscina para drenar.

Nível de privilégio exigido

Raiz

Saída de amostra

solicitar um dreno de pm

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.

solicitar a recuperação da apm

Sintaxe

Descrição

Ative o APM para instruir o BNG especificado a deprovisionar o pool especificado no domínio do pool. Quando o pool é desprovisionado, a APM devolve os endereços que haviam sido atribuídos ao pool para a partição de origem para realocação. O pool deve estar ocioso, o que significa que ele não tem endereços em uso. O comando falha se algum endereço ainda estiver em uso.

Nota:

Esse comando só funciona quando o pool está no drain-set estado de recuperação como resultado da recuperação manual. A APM bloqueia o comando quando o estado do pool é o resultado da recuperação automática.

Opções

entity ip-address

Especifique o endereço IP do BNG gerenciado que recebe a instrução.

pool-domain name

Especifique o nome do domínio do pool que contém o pool direcionado.

pool pool-name

Especifique o nome do pool drenado de quais endereços são recuperados.

Nível de privilégio exigido

Raiz

Saída de amostra

solicitar a recuperação da pm (Pool específico)

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.

solicitar uma entidade de liberação de pm

Sintaxe

Descrição

Acione o APM para limpar quaisquer domínios de pool estabelecidos pela entidade e libere os domínios de uma entidade e seus prefixos de pool associados de volta à partição de origem de cada domínio. Se a rede de acesso não estiver usando os prefixos alocados por APM de uma entidade, a APM força a limpeza de quaisquer domínios e negocia os prefixos de pool associados na partição de origem de cada domínio. Esse comando só funciona se a entidade estiver inalcançável ou desconectada. Uma lista de prefixos que foram lançados e a partição alvo associada é exibida após o sucesso.

Nota:

A liberação dos prefixos os coloca à disposição de outras entidades cujos pools de endereços são gerenciados pela APM e usam a mesma partição. Se você não tiver cuidado para garantir que os prefixos da entidade não estejam mais em uso, a realocação para outra entidade pode causar endereços duplicados, loops de roteamento e assim por diante.

Opções

entity system-id

Especifique a id do sistema da entidade. A id do sistema é uma cadeia única de até 45 caracteres atribuídos ao BNG gerenciado. Ela identifica a entidade à APM após uma conexão bem-sucedida.

Nível de privilégio exigido

Raiz

Saída de amostra

solicitar um dreno de pm

Informações de versão

Declaração introduzida na versão 3.1.0 da APM.

mostrar alarmes apm

Sintaxe

Descrição

Exibir todos os alarmes de domínio de pool pendentes. Você pode exibir alarmes em todos os roteadores gerenciados ou limitar o display a um roteador BNG específico ou domínio de pool.

Opções

entity ip-address

(Opcional) Exibir os alarmes para o roteador especificado.

pool-domain name

(Opcional) Exibir os alarmes no domínio de pool especificado.

Nível de privilégio exigido

Raiz

Campos de saída

A Tabela 1 lista os campos de saída para o show apm alarms comando. Os campos de saída estão listados em ordem alfabética.

Tabela 1: mostrar alarmes de pm Campos de saída

Nome de campo

Descrição do campo

Entity

Endereço IP do BNG gerenciado.

Pool Domain

Nome do domínio do pool com o pool crítico.

Alarm

Nome do alarme.

  • reclaim— Quando o número de endereços gratuitos para o domínio de pool no BNG aumenta acima do limite de recuperação, o BNG envia uma mensagem de alarme de recuperação com o nome do pool para APM. A APM pode então iniciar um dreno ativo para o domínio do pool.
  • apportion— Quando o número de endereços gratuitos fica abaixo do limite de rateio, o BNG envia um alarme de rateio. A APM responde pelo rateio de prefixos a serem adicionados a um domínio de pool.
  • pool-drained— Quando uma piscina é completamente drenada, o BNG envia um alarme drenado na piscina, informando à APM que o prefixo alocado para o pool pode ser recuperado.

Info

Nome do pool rateado.

Age

Há quanto tempo um alarme é excepcional.

Saída de amostra

mostrar alarmes apm

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.

mostrar uma entidade pm

Sintaxe

Descrição

Monitore as associações de APMs com BNGs gerenciados. Você pode especificar um determinado roteador ou domínio de pool para visualizar detalhes adicionais.

Opções

id system-id

Especifique a system-id entidade. A id do sistema é uma cadeia única de até 45 caracteres atribuídos ao BNG gerenciado. Ela identifica a entidade à APM após uma conexão bem-sucedida.

address ip-address

Especifique o endereço IP do BNG gerenciado para exibir informações apenas para esse BNG.

pool-domain name

Especifique o nome de um domínio de pool para exibir informações apenas para esse domínio.

Nível de privilégio exigido

Raiz

Campos de saída

A Tabela 2 lista os campos de saída para o show apm entity comando, em ordem alfabética.

Tabela 2: mostre a entidade pm Output Fields

Nome de campo

Descrição do campo

Allocations

Número de alocações que a APM fez para o domínio do pool.

Entity Id

ID de sistema exclusivo atribuído à entidade.

APMi Version

Versão APM que o BNG gerenciado usa para se comunicar.

Entity Address

Endereço IP do BNG gerenciado.

Entity Statistics

Detalhes sobre o roteador gerenciado.

  • IP Address— endereço IP do BNG gerenciado.

  • Name— Nome do BNG gerenciado.

  • Status— Status da conexão com o BNG: up ou down.

Pool

Nome de um pool no domínio. Um asterisco (*) ao lado do nome indica que um dreno ativo foi configurado para o pool.

Pool Domain Statistics

Detalhes sobre o domínio do pool:

  • Free addresses— Número de endereços no domínio do pool que estão disponíveis para alocação.

  • Last Allocation— Temporizou quando a última operação de alocação de endereços foi concluída.

  • Last Discovery— Temporizamos quando a última operação de descoberta foi concluída.

  • Last Reclamation— Temporizador quando a última recuperação da piscina ocorreu.

  • Pool Domain— Nome do domínio de pool no roteador gerenciado.

  • Pool head— Nome da cabeça de grupo do domínio.

  • Pools— Número de pools no domínio do pool.

  • Reclamations— Número de pools no domínio que foram desprovisionados e seus endereços recuperados na partição de origem para uso futuro.

  • Allocations— Número de prefixos (pools) que foram adicionados a este domínio de pool.

  • Source Partition— A partição a partir da qual os prefixos foram alocados para este domínio de pool.

  • Apportion Alarms— Número de alarmes de rateio enviados para este domínio de pool.

  • Reclamation Alarms— Número de alarmes de recuperação enviados para este domínio de pool.

  • Pool-drained Alarms— Número de alarmes drenados de piscina enviados para este domínio de pool.

Pool Domains

Número de domínios de pool no BNG gerenciado.

Prefix

Sub-rede alocada em um pool de endereços. A APM cria esse prefixo subdividindo o prefixo raiz da partição de origem.

Status

Exibe se a entidade é acessível ou inalcançável.

Used

Número de endereços usados na piscina. O pool fica ocioso quando o valor é zero.

Saída de amostra

mostrar uma entidade pm (Todos os BNGs)

mostrar entidade pm (BNG específica)

mostrar uma entidade pm (Domínio de pool)

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.

<id system-id> opção introduzida em 3.1.0

mostrar a alocaçãopm inet-pool

Sintaxe

Descrição

Exibir informações sobre como os prefixos são alocados em todas as partições, para uma partição específica, para uma entidade específica ou para uma partição específica em uma entidade específica.

Opções

entity ip-address

Especifique o endereço IP do BNG gerenciado para exibir informações apenas para esse BNG.

partition name

Especifique o nome de uma partição para exibir informações apenas para essa partição. A partição pode ser usada para vários BNGs.

Nível de privilégio exigido

Raiz

Campos de saída

A Tabela 3 lista os campos de saída para o show apm inet-pool allocation comando. Os campos de saída estão listados em ordem alfabética.

Tabela 3: mostrar apm inet-pool alocação Campos

Nome de campo

Descrição do campo

Allocations

Número de alocações que a APM fez de uma partição.

Entity Address

Endereço IP do BNG gerenciado.

Filter fields

Filtros aplicados à saída antes de serem exibidos. Os filtros correspondem às qualificações especificadas por você quando você emite o comando, como nome de partição ou endereço IP da entidade.

Partition

Nome de uma partição da qual a APM aloca endereços para um domínio de pool.

Pool Domain

Nome de um domínio de pool provisionado a partir da partição.

Prefix

Sub-rede alocada em um pool de endereços. Este prefixo é dividido do prefixo raiz de uma partição por APM. Um determinado pool pode ter vários prefixos alocados.

Source Partition

Nome de uma partição da qual a APM aloca endereços para um domínio de pool.

Saída de amostra

mostrar a alocaçãopm inet-pool (Todas as partições)

mostrar a alocaçãopm inet-pool (Partição específica)

mostrar apm inet-pool alocação (BNG específica)

mostrar a alocação de grupo de inetpm (Partição específica e BNG)

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.

mostrar apm inet-pool utilização

Sintaxe

Descrição

Exibir informações sobre como os prefixos estão sendo usados. Você pode exibir a utilização para todas as partições, para uma partição específica ou para um prefixo e partição específicos.

Opções

partition name

Especifique o nome de uma partição para exibir a utilização do endereço apenas para essa partição.

prefix address/prefix-length

Especifique um prefixo raiz (fonte) e um nome de partição para exibir a utilização do endereço apenas para essa combinação.

Nível de privilégio exigido

Raiz

Campos de saída

A Tabela 4 lista os campos de saída para o show apm inet-pool utilization comando. Os campos de saída estão listados em ordem alfabética.

Tabela 4: mostre apm inet-pool utilization Fields

Nome de campo

Descrição do campo

Allocated

Número de prefixos que atualmente são alocados de uma partição ou do prefixo raiz de uma partição. É possível que um prefixo seja reservado e alocado.

Partition Name

Nome de uma partição da qual a APM aloca endereços para um domínio de pool.

Prefix

Prefixo de rota (fonte) de uma partição. As estatísticas listadas são mostradas para todos os prefixos em uma partição ou apenas para esse prefixo específico em uma partição específica.

Prefixes

Número total de prefixos disponíveis para alocação a partir de uma partição ou do prefixo raiz de uma partição.

Reserved

Número de prefixos que são mantidos em reserva de uma partição ou de um prefixo raiz específico em uma partição.

State

O estado limiar da partição. O limite é definido pela free-prefix-utilization declaração no nível de [edit apm inet-pool partition partition-name] hierarquia. Uma partição pode ter um dos seguintes estados limiares:

  • empty
  • above-threshold
  • below-threshold

Prefix Statistics

As estatísticas a seguir são exibidas para uma combinação especificada de partição e prefixo raiz:

  • Prefix— Prefixo de rota (fonte) de uma partição para a qual as estatísticas são exibidas.

  • Total sub-prefixes— Número total de sub-redes possíveis para o prefixo raiz da partição.

  • Total reserved— Número total de prefixos que estão atualmente reservados para todas as sub-redes do prefixo raiz.

  • Total allocated— Número total de prefixos que estão atualmente alocados para todas as sub-redes do prefixo raiz.

  • Prefix length— Comprimento de um prefixo subdividido do prefixo raiz da partição.

  • Free— Número de prefixos que atualmente não estão alocados ou gratuitos para sub-redes do prefixo raiz, indicado pelo comprimento do prefixo.

  • Allocated— Número de prefixos que estão atualmente alocados para sub-rede do prefixo raiz, indicado pelo comprimento do prefixo.

Saída de amostra

mostrar apm inet-pool utilização (Todas as partições)

mostrar apm inet-pool utilização (Partição específica)

mostrar apm inet-pool utilização (Prefixo específico e partição)

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.

mostrar apm recuperar eventos

Sintaxe

Descrição

Exibir informações sobre eventos ativos de recuperação de pool para todos os BNGs, para um BNG específico ou para um domínio específico de BNG e pool.

Opções

entity ip-address

Especifique o endereço IP do BNG gerenciado para exibir informações para pools apenas nesse BNG.

pool-domain name

Especifique o nome de um domínio de pool para exibir informações para pools apenas nesse domínio.

Nível de privilégio exigido

Raiz

Campos de saída

A Tabela 5 lista os campos de saída para o show apm reclaim-events comando. Os campos de saída estão listados em ordem alfabética.

Tabela 5: mostre apm reclaim-events Fields

Nome de campo

Descrição do campo

Entity

Endereço IP de um BNG gerenciado.

Pool Domain

Nome de um domínio de pool.

Pool

Nome de um pool no domínio do pool.

State

Estado de recuperação atual do pool:

  • draining— A APM enviou instruções ao BNG para configurar um dreno ativo na piscina. A piscina ainda não está drenando. Este é um estado transitório. Quando a operação de drenagem é concluída, o estado faz a transição para drain-set.

  • drain-set— O BNG configurou um dreno neste pool em resposta às instruções da APM. O pool não pode alocar nenhum endereço. Isso significa que a piscina está ociosa.

  • pending— O pool está em processo de desprovisionamento (removido do BNG) pela APM. Este é um estado transitório. Se essa operação falhar, o estado volta para drain-set.

    Desprovisionamento e recuperação de endereços seguem esta sequência:

    1. O BNG notifica o gerente de provisionamento quando o último endereço em uso no pool for liberado.

    2. A APM envia instruções de desprovisionamento para o roteador.

    3. Quando o roteador termina deprovisionar o pool, a entrada do pool desaparece da saída de show comando.

    4. A APM coloca os endereços drenados de volta na partição associada para alocação futura.

Saída de amostra

mostrar apm reclaim-events (Entidade específica)

Informações de versão

Declaração introduzida na versão 3.0.0 da APM.