Comandos operacionais da CLI do APM

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

Solicitar ativação do APM

Sintaxe

Descrição

Acione o APM para ativar o pool especificado excluindo o dreno ativo no pool. Você pode emitir esse comando quando o pool estiver em um dos seguintes estados de recuperação:

  • drain— O comando remove o dreno ativo antes que o BNG tenha configurado 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 no APM para verificar o estado de recuperação do pool.

Observação:

Esse comando funciona somente quando o pool está no draining estado ou drain-set como resultado da recuperação manual. O 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 de destino.

pool pool-name

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

Nível de privilégio necessário

raiz

Saída de amostra

solicitar entidade de ativação do APM (pool específico)

Informações de versão

Declaração introduzida no APM versão 3.0.0.

Solicitar drenagem APM

Sintaxe

Descrição

Acione o APM para instruir o BNG especificado a drenar o pool especificado no domínio do pool. Quando o dreno está no lugar na piscina, ele não pode alocar nenhum endereço. Você pode solicitar uma drenagem 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 de destino.

pool pool-name

Especifique o nome da piscina a ser drenada.

Nível de privilégio necessário

raiz

Saída de amostra

Solicitar drenagem APM

Informações de versão

Declaração introduzida no APM versão 3.0.0.

Solicitar recuperação de APM

Sintaxe

Descrição

Acione o APM para instruir o BNG especificado a desprovisionar o pool especificado no domínio do pool. Quando o pool é desprovisionado, o APM retorna os endereços que foram 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 falhará se algum endereço ainda estiver em uso.

Observação:

Esse comando funciona somente quando o pool está no drain-set estado de recuperação como resultado da recuperação manual. O 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 de destino.

pool pool-name

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

Nível de privilégio necessário

raiz

Saída de amostra

solicitar recuperação de APM (pool específico)

Informações de versão

Declaração introduzida no APM versão 3.0.0.

Solicitar entidade de liberação do APM

Sintaxe

Descrição

Dispare o APM para limpar todos os domínios de pool estabelecidos pela entidade e liberar os domínios de uma entidade e seus prefixos de pool associados de volta para a partição de origem de cada domínio. Se a rede de acesso não estiver usando os prefixos alocados pelo APM de uma entidade, o APM forçará a limpeza de todos os domínios e desalocará os prefixos de pool associados na partição de origem de cada domínio. Esse comando só funcionará se a entidade estiver inacessível ou desconectada. Uma lista de prefixos que foram liberados e a partição de destino associada é exibida após o sucesso.

Observação:

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

Opções

entity system-id

Especifique a id do sistema da entidade. O system-id é uma cadeia de caracteres exclusiva de até 45 caracteres atribuída ao BNG gerenciado. Ele identifica a entidade para o APM após a conexão bem-sucedida.

Nível de privilégio necessário

raiz

Saída de amostra

Solicitar drenagem APM

Informações de versão

Declaração introduzida no APM versão 3.1.0.

Mostrar alarmes APM

Sintaxe

Descrição

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

Opções

entity ip-address

(Opcional) Exiba os alarmes do roteador especificado.

pool-domain name

(Opcional) Exiba os alarmes no domínio do pool especificado.

Nível de privilégio necessário

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 são listados em ordem alfabética.

Tabela 1: mostrar campos de saída de alarmes APM

Nome do 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 livres para o domínio do 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 o APM. O APM pode então iniciar uma drenagem ativa para o domínio do pool.
  • apportion— Quando o número de endereços livres cai abaixo do limite de repartição, o BNG envia um alarme de repartição. O APM responde distribuindo prefixos a serem adicionados a um domínio de pool.
  • pool-drained— Quando um pool é completamente drenado, o BNG envia um alarme de pool drenado informando ao APM que o prefixo alocado para o pool pode ser recuperado.

Info

Nome do pool distribuído.

Age

Há quanto tempo um alarme está pendente.

Saída de amostra

Mostrar alarmes APM

Informações de versão

Declaração introduzida no APM versão 3.0.0.

Mostrar entidade APM

Sintaxe

Descrição

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

Opções

id system-id

Especifique o system-id da entidade. O system-id é uma cadeia de caracteres exclusiva de até 45 caracteres atribuída ao BNG gerenciado. Ele identifica a entidade para o APM após a 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 necessário

raiz

Campos de saída

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

Tabela 2: mostrar campos de saída da entidade apm

Nome do campo

Descrição do campo

Allocations

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

Entity Id

ID de sistema exclusiva atribuída à entidade.

APMi Version

Versão do 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— Carimbo de data/hora em que a última operação de alocação de endereço foi concluída.

  • Last Discovery— Carimbo de data/hora em que a última operação de descoberta foi concluída.

  • Last Reclamation— Carimbo de data e hora em que ocorreu a última recuperação do pool.

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

  • Pool head— Nome do cabeçalho do pool 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 para a 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 da qual os prefixos foram alocados para este domínio do pool.

  • Apportion Alarms— Número de alarmes de repartição enviados para este domínio do pool.

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

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

Pool Domains

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

Prefix

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

Status

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

Used

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

Saída de amostra

mostrar entidade apm (todos os BNGs)

mostrar entidade apm (BNG específico)

mostrar entidade apm (domínio do pool)

Informações de versão

Declaração introduzida no APM versão 3.0.0.

<id system-id> opção introduzida na versão 3.1.0

Mostrar APM Saúde

Sintaxe

Descrição

Exibe informações de integridade dos subsistemas do APM e suas funções atuais (ativas ou de backup).

Opções

none

Exibe informações de integridade de todos os subsistemas do APM. Somente os subsistemas ativos são listados.

subsystem subsystem-name Você pode exibir informações de integridade para os seguintes subsistemas especificados:
  • addrman—Gerenciador de endereços

  • apm-db—Banco de dados APM (redis)

  • apm-mgmt—Gerenciamento de CLI

  • apm-operator—Operador de APM

  • dbsync— Sincronização de banco de dados

  • entman—Gerente de entidade

  • provman—Gerente de provisionamento

deployment

Exibe informações de implantação para o subsistema especificado.

extensive

Em várias configurações geográficas, a extensive opção não exibe nenhuma informação, a menos que as informações de integridade de ambos os clusters de carga de trabalho possam ser coletadas.

Nível de privilégio necessário

raiz

Campos de saída

A Tabela 3 lista os campos de saída para o show apm health comando.

Tabela 3: mostrar a integridade do APM

Nome do campo

Descrição do campo

Name

O nome do subsistema

Cluster

O nome do cluster de carga de trabalho no qual um subsistema está sendo executado.

Subsystem-State

O estado do subsistema. Ou active ou dormant.

Health

Integridade do subsistema APM. A seguir estão os níveis de integridade:

  • Íntegro — Todos os itens a seguir devem existir: Todos os serviços estão ativos, a memória compartilhada está íntegra, a recuperação de estado inicial foi bem-sucedida e todos os principais endpoints estão ativos.

  • Unhealthy-major — Se houver algum dos seguintes itens: Qualquer um dos serviços está permanentemente inativo, a memória compartilhada não está íntegra ou a recuperação do estado inicial falhou.

  • Unhealthy-minor — Se houver algum dos seguintes itens: Qualquer um dos serviços está inativo, a recuperação do estado inicial está em andamento, qualquer um dos endpoints principais está inativo.

Up-time

A quantidade de tempo que o serviço está ativo.

Generation

O número de geração do subsistema. O número de geração de um subsistema é incrementado sempre que ele alterna os clusters de carga de trabalho.

Configuration

O estado de sincronização da configuração. O estado é sincronizado ou não sincronizado. Você deve aguardar até que a configuração seja sincronizada antes de iniciar o processo de switchover.

Database

O estado de sincronização do banco de dados. O estado é sincronizado ou não sincronizado. Você deve aguardar até que o banco de dados seja sincronizado antes de iniciar o processo de alternância.

Subsystem

O subsistema para o qual as informações estão sendo exibidas.

Active cluster

O cluster que está ativo no momento.

Deployment-Env

Lista informações detalhadas para o ambiente de implantação.

Pod-name

Nome do pod.

Node

O nome do nó de cluster no qual o subsistema está programado no momento.

Pod health

Saúde do pod. A seguir estão os níveis de integridade:

  • Íntegro — Todas as atividades estão íntegras.

  • Unhealthy-major — Atividade incomum é detectada e a atividade está afetando a operação do pod.

  • Unhealthy-minor — Atividade incomum é detectada, mas não está afetando a operação do pod no momento.

Pod phase

O status do Kubernetes do pod (por exemplo, Inicialização, Pendente, Inicialização do pod, Execução, Encerramento e assim por diante).

Pod Age

A duração desde que o pod foi agendado nesse nó de cluster.

Container uptime

Há quanto tempo o contêiner está em execução.

Container restarts

O número de vezes que o contêiner foi reiniciado.

Unexpected conditions

Quaisquer eventos inesperados do Kubernetes que tenham ocorrido que possam estar afetando a função do pod.

Saída de amostra

Mostrar APM Saúde

Mostrar APM Health Extensive

mostrar implantação do subsistema de integridade do APM <nome do subsistema>

Informações de versão

Declaração introduzida no APM versão 3.6.0.

mostrar alocação de pool de inet do APM

Sintaxe

Descrição

Exiba 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 necessário

raiz

Campos de saída

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

Tabela 4: mostrar campos de alocação de pool de inet do apm

Nome do campo

Descrição do campo

Allocations

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

Entity Address

Endereço IP do BNG gerenciado.

Backup

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

Backup-allocations

O número de prefixos alocados da partição de backup.

Filter fields

Filtros aplicados à saída antes de ser exibida. Os filtros correspondem aos qualificadores especificados ao emitir o comando, como um nome de partição ou endereço IP de entidade.

Partition

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

Pool Domain

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

Prefix

Sub-rede alocada a um pool de endereços. Esse prefixo é separado do prefixo raiz de uma partição pelo APM. Um determinado pool pode ter vários prefixos alocados.

Source Partition

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

Saída de amostra

mostrar alocação de pool de inet do apm (todas as partições)

mostrar alocação de pool de inet do apm (partição específica)

mostrar alocação de pool de inet do apm (BNG específico)

mostrar alocação de pool de inet do apm (partição específica e BNG)

Informações de versão

Declaração introduzida no APM versão 3.0.0.

mostrar utilização do pool de inet do APM

Sintaxe

Descrição

Exiba informações sobre como os prefixos estão sendo usados. Você pode exibir a utilização de todas as partições, de uma partição específica ou de 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 (origem) e um nome de partição para exibir a utilização de endereço apenas para essa combinação.

Nível de privilégio necessário

raiz

Campos de saída

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

Tabela 5: mostrar campos de utilização do apm inet-pool

Nome do campo

Descrição do campo

Allocated

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

Backup-partition

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

Partition Name

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

Prefix

Prefixo de rota (origem) 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 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.

Role

O papel do particionário. A função pode ser uma das seguintes:

  • Origem

  • backup

State

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

  • empty
  • above-threshold
  • below-threshold

Prefix Statistics

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

  • Prefix— Prefixo de rota (origem) 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 estão atualmente não alocados ou livres para sub-redes do prefixo raiz, indicado pelo comprimento do prefixo.

  • Allocated— Número de prefixos atualmente alocados para sub-redes 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 utilization (partição específica)

mostrar apm inet-pool utilização partion pation-name prefixo

Informações de versão

Declaração introduzida no APM versão 3.0.0.

mostrar eventos de recuperação de APM

Sintaxe

Descrição

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

Opções

entity ip-address

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

pool-domain name

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

Nível de privilégio necessário

raiz

Campos de saída

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

Tabela 6: mostrar campos de eventos de recuperação do apm

Nome do 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—O 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 do APM. O pool não pode alocar endereços. Isso significa que o pool está ocioso.

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

    O desprovisionamento e a recuperação de endereços seguem esta sequência:

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

    2. O APM envia instruções de desprovisionamento ao roteador.

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

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

Saída de amostra

mostrar eventos de recuperação de apm (entidade específica)

Informações de versão

Declaração introduzida no APM versão 3.0.0.