Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

APM CLI 配置语句

自动回收 (APM)

语法

层次结构级别

描述

配置 APM 以自动清空池并恢复其前缀以在其他池中使用。

注意:

您可以通过配置auto-reclamation节来启用auto-reclamation。配置节auto-reclamation时,必须至少使用一个活动选项(alwayswindow)对其进行配置。

注意:

当您从配置中删除 auto-reclamation 时,APM 会取消所有挂起的清空和恢复事务。

选项

active (always | window)

指定自动回收何时处于活动状态。

  • always— APM 始终评估关键或空闲的池,以确定是否启动回收。

  • window— APM 仅在使用和window-duration选项定义window-start的时间窗口内评估要回收的池。如果这些选项中的任何一个设置为 0,则 APM 的行为就像您配置了该always选项一样。

    注意:

    如果同时发生以下两种情况,则在窗口到期后回收池:

    • 池开始排干,但在时间窗口内没有完成。这意味着池仍然有一些地址,因此不是空闲的。

    • 池继续排空,并在窗口到期后变为空闲状态。

    注意:

    如果池处于空闲状态,则会在窗口外回收池。

  • 默认值: always

window-duration minutes

指定(以分钟为单位)从 APM 评估池和启动回收的时间开始打开 window-start 窗口多长时间。

  • 默认值: 60 分钟

  • 范围: 15 到 720 分钟

window-start time-offset

使用群集的本地时间(包括其 UTC 偏移量)指定窗口开始时间。例如,如果群集节点设置为使用 -5 小时的 UTC 偏移量,并且您希望自动回收窗口从凌晨 4:00 开始,请将窗口开始时间 04:00-0500设置为 。

发布信息

在 APM 3.0.0 版中引入的语句。

实体匹配 (APM)

语法

层次结构级别

描述

配置实体匹配列表,以将有效 BNG 映射到池域配置文件。

entity-match 声明标识了。entity-match 语句将传入的 APM 实体定向到池域配置文件。APM 将其池域与 BNG 的列表进行核对,以便两个列表匹配。如果在协调期间删除了任何域,那么它们的关联池前缀将返回到其原始分区。如果对帐结束时域为空,则 APM 和 BNG 都会从其列表中删除池域。如果实体匹配列表中不存在 APM 实体(由其系统 ID 标识),则不允许连接,连接将中止。

选项

entity-match system-id

指定实体的系统 ID。系统 ID 是分配给托管 BNG 的唯一字符串,最多包含 45 个字符。它用于在成功连接后识别 APM 的实体。

pool-domain-profile domain-profile-name

要用于此系统的池域配置文件。

inet-pool (APM)

语法

层次结构级别

描述

配置 APM 如何对其全球 IPv4 地址池进行分区,以及如何将地址分配给各个 BNG 池域。该语句定义 inet-pool 的地址池由您为定义分配上下文而创建的多个分区组成。您可以为每个分区配置多个根前缀。您可以指定对分区有效的根前缀的最小和最大大小。您可以指定 APM 可以从特定根前缀细分的最小子网。APM 细分根前缀,并根据需要将生成的子网分配给各个池域,以补充域的可用地址。

选项

partition partition-name 设置分区的名称。
free-prefix-utilization percentage

设置分区中未分配前缀的最小阈值百分比。当百分比低于此值时,将生成一条警告消息,以指示分区的可用地址不足。该通知仅提供信息,不会触发其他操作。

  • 默认值: 10

  • 范围: 0 到 100

max-prefix-length max-prefix-length

定义在此分区中有效的根前缀的大小。此配置为此分区中的根前缀设置有效前缀长度的上限。此上限定义要分配的主机地址最少的根前缀。随着前缀长度的增加,APM 可以从根前缀中细分更少的从属前缀。

  • 默认值: 24

  • 范围: 1 到 31

max-prefix-len 值是定义子网时使用的最大位数。它必须大于或等于该 min-prefix-len 值。否则,APM 不会将前缀添加到分区。

min-prefix-len min-prefix-length

定义在此分区中有效的最大大小子网。此配置为此分区中的根前缀设置有效前缀长度的下限。此下限定义要分配的主机地址最多的根前缀。随着前缀长度的减小,APM 可以从根前缀中细分出更多的从属前缀。

  • 默认值: 8

  • 范围: 1 到 31

min-prefix-len 值必须小于或等于该 max-prefix-len 值。否则,APM 不会将前缀添加到分区。

role 分区的作用。如果未配置角色,则默认承担来源。角色可以是以下类型之一:
  • origin— APM 从中将地址分配给池域的源分区。

  • backup—当关联的源分区耗尽时,APM 从中将地址分配给池域的备份分区。

backup-partition partition-name APM 将地址分配给池域的备份分区的名称。只有满足以下要求,才能配置该 backup-partition 语句:
  • 分区的作用是 origin

  • 配置中存在备份分区。

  • 备份分区和源分区的 和max-prefix-len匹配min-prefix-len

  • 备份分区的前缀不与源的前缀重叠。

  • 备份分区的角色设置为备份。

prefix ip-address 指定分区的根前缀。APM 从此根细分子网,为 BNG 的池域配置地址。根前缀长度必须在分区级别 min-prefix-lenmax-prefix-len 选项值定义的范围内。通常,您为每个分区配置多个根前缀。
  • max-prefix-length max-prefix-length—定义根前缀的粒度以及 APM 可以从指定根前缀细分的最小前缀。随着前缀长度的增加,子网的大小会减小。
    • 默认值: 24

    • 范围: 1 到 31

  • prefix-recycle-hold seconds—指定 APM 在可供分配之前保留回收前缀的持续时间(以秒为单位)。
  • route-tag tag- 指定要用作路由标记的编号列表,路由器在为前缀创建静态丢弃路由时,要将其与路由关联。每次从根前缀分配子前缀时,APM 都会以轮询方式循环遍历路由标记列表。
  • 范围: 5 到 300

发布信息

在 APM 3.0.0 版中引入的语句。

池域配置文件 (APM)

语法

层次结构级别

描述

配置用于在分配期间在 BNG 上创建池域的池域配置文件。该配置文件指定将分配的前缀数量、BNG 将监控的阈值以及自动回收是否处于活动状态。

选项

pool-domain-profile domain-profile-name 池域配置文件名称。
monitoring

设置用于监控池域和池域内的池如何使用地址的属性。可用(可用)和已用(已分配)地址的阈值可确定 APM 生成告警的点。

  • apportion-threshold apportion-threshold-count- 设置池域中触发调配事件的最小可用地址数。
  • reclaim-threshold reclaim-threshold-count- 为此配置文件创建的池域设置回收阈值。如果禁用回收抑制(设置为 0),APM 会将设置的回收阈值与计算的阈值进行比较,并使用较大的值。计算出的阈值源自等式计算 阈值 = 分配阈值 + (前缀计数 * 2^(32 – preferred-prefix-len)) + 1。
  • reclamation-hold-down- 设置实体在分配事件后挂起池域的任何潜在事件的持续时间(以秒为单位)。配置非零回收抑制值允许您设置较低 reclaim-threshold 的值,这在池域空闲时可能很有用(导致实体上剩余的已分配池前缀减少)。由于包含回收多个前缀的分配事件可能会暂时将可用地址数推高到回收阈值以上,因此在指定时间内抑制回收事件可以使订阅者登录速率赶上分配的前缀集。如果分配事件将地址添加到池域,使得池域的空闲地址计数高于回收阈值,则要抑制生成回收事件,直到空闲地址数低于回收阈值。
    • 默认值: 0

      如果值为 0,则禁用 hold-down timer

    • 范围: 1 至 3600

      注意:

      reclamation-hold-down如果设置为 30 到 3600 秒之间,则启用,并且 APM 会将回收阈值恢复为您配置的值。无论是reclamation-hold-down启用还是禁用,APM 都会通过DOMAIN_THRESHOLDS_CHANGE触发器响应通知受影响的实体更改。

有些陈述单独解释。单击“语法”部分中的链接语句以获取详细信息。

发布信息

在 APM 3.0.0 版中引入的语句。

reclamation-hold-down 3.1.0 中引入的选项

系统 (APM)

语法

层次结构级别

描述

配置确定 APM 如何为报警和事务行为的属性,并定义允许连接到 APM 的 APMi 实体数量。

选项

transaction-time-out seconds

(选答)指定(以秒为单位)APM 在声明事务已停止(超时)之前等待事务完成的时间。事务由任务列表组成。例如,分摊事务由获取地址的任务、配置实体的任务和更新运行时状态的任务组成。如果事务中的任何任务失败,则列表中以前执行的任务将回滚。例如,如果配置任务失败,则回滚获取地址的任务,并将地址返回到分区。

  • 默认值: 240

  • 范围: 60 到 900

max-clients <0..500>

指定允许连接到 APM 服务器的 APMi 实体数量。

  • 默认值: 0

  • 范围: 0 到 500

发布信息

在 APM 3.0.0 版中引入的语句。

max-clients 在 APM 3.1.0 版中引入的选项。