Declarações de configuração da CLI do APM

recuperação automática (APM)

Sintaxe

Nível de hierarquia

Descrição

Configure o APM para drenar pools automaticamente e recuperar seus prefixos para uso em outros pools.

Observação:

Você habilita auto-reclamation configurando a auto-reclamation estrofe. Ao configurar a auto-reclamation estrofe, você deve configurá-la com pelo menos uma opção ativa (always ou window).

Observação:

O APM cancela todas as transações pendentes de drenagem e recuperação quando você remove auto-reclamation da configuração.

Opções

active (always | window)

Especifique quando a recuperação automática está ativa.

  • always— O APM sempre avalia os pools que são críticos ou ociosos para determinar se deve iniciar a recuperação.

  • window— O APM avalia os pools para recuperação somente durante a janela de tempo que você define com as window-start opções e window-duration . Se qualquer uma dessas opções estiver definida como 0, o APM agirá como se você tivesse configurado a always opção.

    Observação:

    Um pool será recuperado após a expiração da janela se ambos os itens a seguir ocorrerem:

    • A piscina começa a drenar, mas não a conclui durante a janela de tempo. Isso significa que o pool ainda tem alguns endereços e, portanto, não está ocioso.

    • O pool continua a drenar e fica ocioso depois que a janela expira.

    Observação:

    Se o pool estiver ocioso, o pool será recuperado fora da janela.

  • Padrão: always

window-duration minutes

Especifique (em minutos) por quanto tempo a janela fica aberta a window-start partir do momento em que o APM avalia pools e inicia a recuperação.

  • Padrão: 60 minutos

  • Faixa: 15 a 720 minutos

window-start time-offset

Especifique a hora de início da janela usando a hora local do cluster, incluindo seu deslocamento UTC. Por exemplo, se os nós de cluster estiverem configurados para usar um deslocamento UTC de -5 horas e você quiser que a janela de recuperação automática comece às 4:00, defina a hora de início da janela como 04:00-0500.

Informações de versão

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

correspondência de entidade (APM)

Sintaxe

Nível de hierarquia

Descrição

Configure a lista de correspondência de entidade para mapear BNGs válidos para um perfil de domínio de pool.

A entity-match declaração identifica. Uma entity-match declaração direciona as entidades de APM de entrada para um perfil de domínio de pool. O APM reconcilia seus domínios de pool com a lista do BNG para que as duas listas correspondam. Se algum domínio for excluído durante a reconciliação, ele terá seus prefixos de pool associados retornados à partição original. Se um domínio estiver vazio no final da reconciliação, o APM e o BNG removerão o domínio do pool da lista. Se uma entidade do APM (identificada por sua id do sistema) não estiver presente na lista de correspondência de entidades, ela não terá permissão para se conectar e a conexão será anulada.

Opções

entity-match 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 é usado para identificar a entidade ao APM após uma conexão bem-sucedida.

pool-domain-profile domain-profile-name

O perfil de domínio do pool a ser usado para este sistema.

inet-pool (APM)

Sintaxe

Nível de hierarquia

Descrição

Configure como o APM particiona seu pool global de endereços IPv4 e como ele aloca endereços para domínios individuais do pool BNG. O pool de endereços definido pela inet-pool instrução consiste em várias partições que você cria para definir contextos de alocação. Você configura vários prefixos raiz para cada partição. Você pode especificar o tamanho mínimo e máximo dos prefixos raiz válidos para a partição. Você especifica a menor sub-rede que o APM pode subdividir de um prefixo raiz específico. O APM subdivide os prefixos raiz e aloca as sub-redes resultantes a domínios de pool individuais, conforme necessário, para complementar os endereços disponíveis do domínio.

Opções

partition partition-name Defina o nome da partição.
free-prefix-utilization percentage

Defina a porcentagem de limite mínimo para prefixos não alocados na partição. Quando a porcentagem cai abaixo desse valor, uma mensagem de aviso é gerada para indicar que a partição está com poucos endereços disponíveis. A notificação é apenas informativa e não aciona nenhuma outra ação.

  • Padrão: 10

  • Faixa: 0 a 100

max-prefix-length max-prefix-length

Defina o tamanho do prefixo raiz válido nesta partição. Essa configuração define o limite superior de comprimentos de prefixo válidos para os prefixos raiz nessa partição. Esse limite superior define o prefixo raiz com o menor número de endereços de host a serem distribuídos. À medida que o comprimento do prefixo aumenta, o APM pode subdividir menos prefixos subordinados do prefixo raiz.

  • Padrão: 24

  • Faixa: 1 a 31

O max-prefix-len valor é o número máximo de bits usados na definição de uma sub-rede. Deve ser maior ou igual ao min-prefix-len valor. Caso contrário, o APM não adicionará o prefixo à partição.

min-prefix-len min-prefix-length

Defina a maior sub-rede que é válida nesta partição. Essa configuração define o limite inferior de comprimentos de prefixo válidos para os prefixos raiz nessa partição. Esse limite inferior define o prefixo raiz com a maioria dos endereços de host a serem distribuídos. À medida que o comprimento do prefixo diminui, o APM pode subdividir mais prefixos subordinados do prefixo raiz.

  • Padrão: 8

  • Faixa: 1 a 31

O min-prefix-len valor deve ser menor ou igual ao max-prefix-len valor. Caso contrário, o APM não adicionará o prefixo à partição.

role O papel da partição. Se uma função não estiver configurada, a origem será assumida por padrão. A função pode ser uma das seguintes:
  • origin— A partição de origem da qual o APM aloca endereços para um domínio de pool.

  • backup— A partição de backup da qual o APM aloca endereços a um domínio de pool quando uma partição de origem associada é esgotada.

backup-partition partition-name Nome da partição de backup da qual o APM aloca endereços para um domínio de pool. A backup-partition declaração só pode ser configurada se os seguintes requisitos forem atendidos:
  • A função da partição é origin.

  • A partição de backup existe na configuração.

  • A partição de backup e a partição min-prefix-len de origem e max-prefix-len correspondem.

  • Os prefixos da partição de backup não se sobrepõem aos prefixos da origem.

  • A função da partição de backup é definida como backup.

prefix ip-address Especifique o prefixo raiz da partição. O APM subdivide as sub-redes dessa raiz para provisionar endereços para os domínios do pool de um BNG. O comprimento do prefixo raiz deve estar dentro do intervalo definido pelos valores do nível min-prefix-len de partição e max-prefix-len das opções. Normalmente, você configura mais de um prefixo raiz por partição.
  • max-prefix-length max-prefix-length— Defina a granularidade do prefixo raiz e o menor prefixo que o APM pode subdividir do prefixo raiz especificado. À medida que o comprimento do prefixo aumenta, o tamanho da sub-rede diminui.
    • Padrão: 24

    • Faixa: 1 a 31

  • prefix-recycle-hold seconds— Especifique a duração, em segundos, que o APM manterá o prefixo recuperado antes que ele possa ser disponibilizado para alocação.
  • route-tag tag— Especifique uma lista de números a serem usados como tags de rota que o roteador associa à rota ao criar uma rota de descarte estática para o prefixo. O APM percorre a lista de tags de rota de forma rodízio sempre que um subprefixo é alocado a partir do prefixo raiz.
  • Faixa: 5 a 300

Informações de versão

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

perfil de domínio de pool (APM)

Sintaxe

Nível de hierarquia

Descrição

Configure os perfis de domínio do pool usados para criar domínios de pool em BNGs durante a repartição. O perfil especifica o número de prefixos que serão distribuídos, os limites que os BNGs monitorarão e se a recuperação automática está ativa.

Opções

pool-domain-profile domain-profile-name Nome do perfil de domínio do pool.
monitoring

Defina os atributos para monitorar como um domínio de pool e os pools dentro de um domínio de pool estão usando endereços. Os limites para endereços gratuitos (disponíveis) e usados (alocados) estabelecem os pontos nos quais o APM gera um alarme.

  • apportion-threshold apportion-threshold-count— Defina o número mínimo de endereços disponíveis no domínio do pool que aciona um evento de provisionamento.
  • reclaim-threshold reclaim-threshold-count— Defina o limite de recuperação para domínios de pool criados a partir desse perfil. Se a retenção de recuperação estiver desativada (definida como 0), o APM comparará o valor do limite de recuperação definido com um valor de limite calculado e usará o valor maior. O valor do limite calculado é derivado da equação limite calculado = limiar de repartição + (contagem de prefixos * 2^(32 – prefixo-preferencial-len)) + 1.
  • reclamation-hold-down— Defina a duração em segundos para que a entidade suspenda qualquer evento potencial para um domínio de pool após um evento de repartição. A configuração de um valor de retenção de recuperação diferente de zero permite que você defina valores mais baixos reclaim-threshold que podem ser úteis quando o domínio do pool está ocioso (resulta em menos prefixos de pool alocados deixados na entidade). Como um evento de repartição contendo vários prefixos de recuperação pode empurrar temporariamente o número de endereços livres acima do limite de recuperação, suprimir eventos de recuperação por um tempo especificado permite que a taxa de login do assinante alcance o conjunto de prefixos distribuídos. Se o evento apportion adicionar endereços a um domínio de pool de modo que a contagem de endereços livres do domínio do pool esteja acima do limite de recuperação, você desejará suprimir a geração de um evento de recuperação até que o número de endereços livres caia abaixo do limite de recuperação.
    • Padrão: 0

      O hold-down timer será desabilitado se tiver um valor de 0.

    • Faixa: 1 a 3600

      Observação:

      O reclamation-hold-down será habilitado se estiver definido entre 30 e 3600 segundos, e o APM reverterá o limite de recuperação para o valor que você configurou. Independentemente de estar ativado ou desativado, o reclamation-hold-down APM notifica as entidades afetadas sobre uma alteração por meio de uma resposta de gatilho DOMAIN_THRESHOLDS_CHANGE.

Algumas declarações são explicadas separadamente. Clique na instrução vinculada na seção Sintaxe para obter detalhes.

Informações de versão

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

reclamation-hold-down Opção introduzida na versão 3.1.0

sistema (APM)

Sintaxe

Nível de hierarquia

Descrição

Configure os atributos que determinam como o APM se comporta para alarmes e transações e defina o número de entidades do APMi com permissão para se conectar ao APM.

Opções

transaction-time-out seconds

(Opcional) Especifique (em segundos) quanto tempo o APM aguarda para que uma transação seja concluída antes de declarar que a transação foi paralisada (expirou). Uma transação consiste em uma lista de tarefas. Por exemplo, uma transação de repartição consiste em uma tarefa para obter um endereço, uma tarefa para provisionar a entidade e uma tarefa para atualizar o estado de runtime. Se alguma tarefa em uma transação falhar, as tarefas executadas anteriormente na lista serão revertidas. Por exemplo, se a tarefa de provisionamento falhar, a tarefa para obter o endereço será revertida e o endereço será retornado à partição.

  • Padrão: 240

  • Faixa: 60 a 900

max-clients <0..500>

Especifique o número de entidades APMi autorizadas a se conectar ao servidor APM.

  • Padrão: 0

  • Faixa: 0 a 500

Informações de versão

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

max-clients introduzida no APM versão 3.1.0.