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-startwindow-duration 选项定义的时间窗口内评估池的回收情况。如果这些选项中的任何一个设置为 0,则 APM 的行为就像您配置了 always 该选项一样。

    注意:

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

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

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

    注意:

    如果游泳池闲置,则在窗外回收游泳池。

  • 违约: always

window-duration minutes

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

  • 默认值: 60 分钟

  • 范围: 15 到 720 分钟

window-start time-offset

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

发布信息

在 APM 3.0.0 版中引入的语句。

实体匹配 (APM)

语法

层次结构级别

描述

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

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

选项

entity-match system-id

指定实体的系统 ID。system-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

  • 备份分区存在于配置中。

  • 备份分区和源分区 min-prefix-len 的 和 max-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 – 首选前缀-len)) + 1。
  • reclamation-hold-down- 设置实体在分摊事件后暂停池域的任何潜在事件的持续时间(以秒为单位)。通过配置非零 reclamation-hold-down 值,可以设置较低的 reclaim-threshold 值,该值在池域空闲时可能很有用(会导致实体上剩余的已分配池前缀减少)。由于包含回收多个前缀的分摊事件可能会暂时将可用地址数推高到回收阈值以上,因此在指定时间内抑制回收事件将允许订阅者登录速率赶上分配的前缀集。如果 apportion 事件将地址添加到池域,使池域的可用地址计数高于回收阈值,则需要暂停生成回收事件,直到可用地址数低于回收阈值。
    • 默认值: 0

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

    • 范围: 1 至 3600

      注意:

      reclamation-hold-down如果在 30 到 3600 秒之间设置,则启用该,并且 APM 会将回收阈值还原为您配置的值。无论启用还是禁用,reclamation-hold-downAPM 都会通过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 版中引入的选项。