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
request apm activate entity ip-address pool-domain name pool pool-name
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.
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)
root@jnpr-apm-mgmt> request apm activate entity 10.4.4.108 pool-domain vs009afd pool jnpr-ipb-vs009afd-004 Pool jnpr-ipb-vs009afd-004 in pool domain vs009afd at entity 10.4.4.108 has activated.
Informações de versão
Declaração introduzida na versão 3.0.0 da APM.
solicitar um dreno de pm
Sintaxe
request apm drain entity ip-address pool-domain name pool pool-name
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-set
saí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
root@jnpr-apm-mgmt> request apm drain entity 10.4.4.108 pool-domain vs009afd pool jnpr-ipb-vs009afd-004 Pool jnpr-ipb-vs009afd-004 in pool domain vs009afd at entity 10.4.4.108 has been set to drain.
Informações de versão
Declaração introduzida na versão 3.0.0 da APM.
solicitar a recuperação da apm
Sintaxe
request apm reclaim entity ip-address pool-domain name pool pool-name
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.
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)
root@jnpr-apm-mgmt> request apm reclaim entity 10.4.4.108 pool-domain vs009afd pool jnpr-ipb-vs009afd-004 Pool jnpr-ipb-vs009afd-004 in pool-domain vs009afd at entity 10.4.4.108 has been reclaimed.
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
request apm release entity system-id
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.
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
root@jnpr-apm-mgmt> request apm release entity test-002 Released Prefix Destination Partition 192.168.0.0/24 westford 192.168.1.0/24 westford 192.168.2.0/24 westford 192.168.3.0/24 westford 192.168.4.0/24 westford
Informações de versão
Declaração introduzida na versão 3.1.0 da APM.
mostrar alarmes apm
- Sintaxe
- Descrição
- Opções
- Nível de privilégio exigido
- Campos de saída
- Saída de amostra
- Informações de versão
Sintaxe
show apm alarms <entity ip-address> <pool-domain name>
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.
Nome de campo |
Descrição do campo |
---|---|
|
Endereço IP do BNG gerenciado. |
|
Nome do domínio do pool com o pool crítico. |
|
Nome do alarme.
|
|
Nome do pool rateado. |
|
Há quanto tempo um alarme é excepcional. |
Saída de amostra
mostrar alarmes apm
root@jnpr-apm-mgmt> show apm alarms Entity Pool Domain Alarm Info Age 10.4.4.108 vks009-default reclaim vks009-default-0005 2:33:15 10.2.1.1 alpha-drop reclaim alpha-Drop-0000 3 days, 15:20:01 10.3.23.10 feeder-default apportion - 0:0:10 152.13.5.5 azimuth-ri2 pool-drained azimuth-ri2-0007 0:0:21
Informações de versão
Declaração introduzida na versão 3.0.0 da APM.
mostrar uma entidade pm
- Sintaxe
- Descrição
- Opções
- Nível de privilégio exigido
- Campos de saída
- Saída de amostra
- Informações de versão
Sintaxe
show apm entity <id system-id> <address ip-address> <pool-domain name>
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 |
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.
Nome de campo |
Descrição do campo |
---|---|
|
Número de alocações que a APM fez para o domínio do pool. |
|
ID de sistema exclusivo atribuído à entidade. |
|
Versão APM que o BNG gerenciado usa para se comunicar. |
|
Endereço IP do BNG gerenciado. |
|
Detalhes sobre o roteador gerenciado.
|
|
Nome de um pool no domínio. Um asterisco (*) ao lado do nome indica que um dreno ativo foi configurado para o pool. |
|
Detalhes sobre o domínio do pool:
|
|
Número de domínios de pool no BNG gerenciado. |
|
Sub-rede alocada em um pool de endereços. A APM cria esse prefixo subdividindo o prefixo raiz da partição de origem. |
|
Exibe se a entidade é acessível ou inalcançável. |
|
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)
mostrar uma entidade pm (Todos os BNGs)
root@jnpr-apm-mgmt> show apm entity root@jnpr-apm-mgmt> show apm entity Entity ID APMi Ver Name Status Pool Domains test-002 1 reachable 1 10.9.164.40 0 yarmouth reachable 1
mostrar entidade pm (BNG específica)
root@jnpr-apm-mgmt> show apm entity id test-002 Entity Statistics ID : test-002 APMi Ver: 1 Name : test-002 Status : reachable Pool Domain Last Discovery Pools Last Allocation Allocations Last Reclamation Reclamations iroh-default 2022-03-29T22:11:55Z 1 2022-03-29T22:11:55Z 1 - 0 – 0
mostrar uma entidade pm (Domínio de pool)
root@jnpr-apm-mgmt> show apm entity id test-002 pool-domain iroh-default Entity Statistics: Entity ID: test-002 APMi Ver : 1 Name : test-002 Status : reachable Pool Domain Statistics: Pool Domain : iroh-default Source Partition: westford Free Addresses : 245 Pool Head : iroh-default Pools : 1 Thresholds: Apportion : 200 Reclamation: 457 Events: Last Discovery : 2022-03-28T13:05:27Z Last Allocation : 2022-03-28T13:05:27Z Last Reclamation: - Allocations : 1 Reclamations : 0 Alarms: Apportion : 1 Reclamation : 0 Pool-drained: 0 Abatement : 0 Pool Prefix Total Addrs Used Addrs iroh-default 192.168.41.0/24 255 10
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
- Opções
- Nível de privilégio exigido
- Campos de saída
- Saída de amostra
- Informações de versão
Sintaxe
show apm inet-pool allocation <entity ip-address> <partition name>
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.
Nome de campo |
Descrição do campo |
---|---|
|
Número de alocações que a APM fez de uma partição. |
|
Endereço IP do BNG gerenciado. |
|
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. |
|
Nome de uma partição da qual a APM aloca endereços para um domínio de pool. |
|
Nome de um domínio de pool provisionado a partir da partição. |
|
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. |
|
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)
mostrar a alocaçãopm inet-pool (Todas as partições)
root@jnpr-apm-mgmt> show apm inet-pool allocation Partition Allocations new-england 4 wholesalers 2 vpn 7
mostrar a alocaçãopm inet-pool (Partição específica)
root@jnpr-apm-mgmt> show apm inet-pool allocation partition wholesalers Filter fields: partition=wholesalers, entity= Source Partition Prefix Entity Address Pool Domain wholesalers 198.51.100.100/20 192.0.2.108 cust-a970 wholesalers 198.51.100.200/20 192.0.2.108 cust-a970 wholesalers 198.51.100.1/20 192.0.2.233 L3-001a
mostrar apm inet-pool alocação (BNG específica)
root@jnpr-apm-mgmt> show apm inet-pool allocation entity 192.0.2.108 Filter fields: partition=, entity=192.0.2.108 Source Partition Prefix Entity Address Pool Domain new-england 203.0.113.10/24 192.0.2.108 mx480-a3-default new-england 203.0.113.20/24 192.0.2.108 mx480-a3-default new-england 203.0.113.30/24 192.0.2.108 mx480-a3-default new-england 203.0.113.40/24 192.0.2.108 mx480-a3-default new-england 203.0.113.50/24 192.0.2.108 mx480-a3-red new-england 203.0.113.60/24 192.0.2.108 mx480-a3-red wholesalers 198.51.100.100/20 192.0.2.108 cust-a970 wholesalers 198.51.100.200/20 192.0.2.108 cust-a970 vpn 192.0.2.0/25 192.0.2.108 local56
mostrar a alocação de grupo de inetpm (Partição específica e BNG)
root@jnpr-apm-mgmt> show apm inet-pool allocation entity 192.0.2.108 partition new-england Filtered Partition Allocations Filter fields: partition=new-england, entity=192.0.2.108 Source Partition Prefix Entity Address Pool Domain new-england 203.0.113.10/24 192.0.2.108 mx480-a3-default new-england 203.0.113.20/24 192.0.2.108 mx480-a3-default new-england 203.0.113.30/24 192.0.2.108 mx480-a3-default new-england 203.0.113.40/24 192.0.2.108 mx480-a3-default new-england 203.0.113.50/24 192.0.2.108 mx480-a3-red new-england 203.0.113.60/24 192.0.2.108 mx480-a3-red
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
- Opções
- Nível de privilégio exigido
- Campos de saída
- Saída de amostra
- Informações de versão
Sintaxe
show apm inet-pool utilization <partition name> <prefix address/prefix length>
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.
Nome de campo |
Descrição do campo |
---|---|
|
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. |
|
Nome de uma partição da qual a APM aloca endereços para um domínio de pool. |
|
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. |
|
Número total de prefixos disponíveis para alocação a partir de uma partição ou do prefixo raiz de uma partição. |
|
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. |
|
O estado limiar da partição. O limite é definido pela
|
|
As estatísticas a seguir são exibidas para uma combinação especificada de partição e prefixo raiz:
|
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)
mostrar apm inet-pool utilização (Todas as partições)
root@jnpr-apm-mgmt> show apm inet-pool utilization Partition State Prefixes Reserved Allocated new-england above-threshold 3 0 0 wholesalers above-threshold 511 0 2
mostrar apm inet-pool utilização (Partição específica)
root@jnpr-apm-mgmt> show apm inet-pool utilization partition new-england Partition Statistics Partition Name: new-england State: above-threshold Prefixes: 7 Reserved: 0 Allocated: 4 Prefix Prefixes Reserved Allocated 203.0.113.0/24 7 0 4
mostrar apm inet-pool utilização (Prefixo específico e partição)
root@jnpr-apm-mgmt> show apm inet-pool utilization partition new-england prefix 203.0.113.0/16 Partition Statistics: Partition Name: new-england State: above-threshold Prefixes: 7 Reserved: 0 Allocated: 4 Prefix Statistics: Prefix: 203.0.113.0/24 Total sub-prefixes: 7 Total reserved: 0 Total allocated: 4 Prefix Length Free Allocated 24 0 1 25 1 1 26 2 2
Informações de versão
Declaração introduzida na versão 3.0.0 da APM.
mostrar apm recuperar eventos
- Sintaxe
- Descrição
- Opções
- Nível de privilégio exigido
- Campos de saída
- Saída de amostra
- Informações de versão
Sintaxe
show apm reclaim-events <entity ip-address> <pool-domain name>
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.
Nome de campo |
Descrição do campo |
---|---|
|
Endereço IP de um BNG gerenciado. |
|
Nome de um domínio de pool. |
|
Nome de um pool no domínio do pool. |
|
Estado de recuperação atual do pool:
|
Saída de amostra
mostrar apm reclaim-events (Entidade específica)
root@jnpr-apm-mgmt> show apm reclaim-events entity 10.4.4.108 Entity Pool Domain Pool State 10.4.4.108 vks009afd jnpr-ipb-vs009afd-0003 draining 10.4.4.108 uk001bnf jnpr-ipb-uk001bnf-0001 pending
Informações de versão
Declaração introduzida na versão 3.0.0 da APM.