APM CLI構成ステートメント

自動レクラメーションがアクティブになるタイミングを指定します。

• always—APMは、クリティカルまたはアイドル状態のプールを常に評価して、再利用を開始するかどうかを決定します。

• window—APMは、 window-start オプションと window-duration オプションで定義した時間枠内でのみ、プールの再利用を評価します。これらのオプションのいずれかが0に設定されている場合、APMは always オプションを設定したかのように動作します。

  手記：

  ウィンドウの期限が切れた後、次の両方が発生した場合、プールが再利用されます。

  • プールは排水を開始しますが、時間枠内には完了しません。これは、プールにはまだいくつかのアドレスがあるため、アイドル状態ではないことを意味します。

  • プールは引き続きドレインし、ウィンドウの期限が切れるとアイドル状態になります。

  手記：

  プールがアイドル状態の場合、プールはウィンドウの外側で再利用されます。

• デフォルト： always

APMがプールを評価し、再利用を開始する window-start 時間からウィンドウが開いている時間を指定します(分単位)。

• 既定値: 60 分

• 範囲: 15 分から 720 分

UTC オフセットを含むクラスターのローカル時間を使用して、ウィンドウの開始時刻を指定します。たとえば、クラスター ノードが -5 時間の UTC オフセットを使用するように設定されていて、自動再利用ウィンドウを午前 4:00 に開始する場合は、ウィンドウの開始時刻を 04:00-0500 に設定します。

エンティティのシステムIDを指定します。system-id は、マネージド BNG に割り当てられた最大 45 文字の一意の文字列です。これは、接続が成功したときに APM にエンティティを識別するために使用されます。

このシステムに使用するプールドメインプロファイル。

パーティション内の未割り当てプレフィックスの最小しきい値パーセンテージを設定します。パーセンテージがこの値を下回ると、区画の使用可能なアドレスが少なくなっていることを示す警告メッセージが生成されます。通知は情報提供のみを目的としており、他のアクションはトリガーされません。

• デフォルト: 10

• 範囲: 0 から 100

このパーティションで有効なルートプレフィックスのサイズを定義します。この設定では、このパーティションのルートプレフィックスの有効なプレフィックス長の上限を設定します。この上限は、割り当てるホストアドレスが最も少ないルートプレフィックスを定義します。プレフィックス長が長くなると、APMはルートプレフィックスから下位プレフィックスをより少なく分割できます。

• デフォルト: 24

• 範囲: 1 から 31

max-prefix-len値は、サブネットワークの定義に使用される最大ビット数です。min-prefix-len値以上である必要があります。それ以外の場合、APMはパーティションにプレフィックスを追加しません。

このパーティションで有効な最大サイズのサブネットワークを定義します。この設定では、このパーティションのルートプレフィックスの有効なプレフィックス長の下限を設定します。この下限は、割り当てるホストアドレスが最も多いルートプレフィックスを定義します。プレフィックス長が短くなると、APMはルートプレフィックスからより多くの下位プレフィックスを細分化できます。

• デフォルト: 8

• 範囲: 1 から 31

min-prefix-len値は、max-prefix-len値以下である必要があります。それ以外の場合、APMはパーティションにプレフィックスを追加しません。

• max-prefix-length max-prefix-length- ルートプレフィックスの粒度と、指定されたルートプレフィックスからAPMが細分化できる最小プレフィックスを定義します。プレフィックス長が長くなると、サブネットワークのサイズは小さくなります。

  • デフォルト: 24

  • 範囲: 1 から 31

• prefix-recycle-hold seconds—割り当て可能になるまでに、APMが再利用されたプレフィックスを保持する期間を秒単位で指定します。
• reserved-prefix sub-prefix- このパーティションから割り当てできないサブネットワークを指定します。オプションで、予約を指定された BNG またはその BNG 上の指定されたプール ドメインに制限することで、予約を限定することができます。
• route-tag tag- ルーターがプレフィックスの静的廃棄ルートを作成する際にルートに関連付けるルート タグとして使用する番号のリストを指定します。APMは、サブプレフィックスがルートプレフィックスから割り当てられるたびに、ラウンドロビン方式でルートタグリストを循環します。

• 範囲: 5 から 300

プールドメインとプールドメイン内のプールがアドレスをどのように使用しているかを監視するための属性を設定します。空き(使用可能)アドレスと使用済み(割り当て済み)アドレスのしきい値は、APMがアラームを生成するポイントを確立します。

• apportion-threshold apportion-threshold-count- プロビジョニング イベントをトリガーするプール ドメインで使用可能なアドレスの最小数を設定します。
• reclaim-threshold reclaim-threshold-count- このプロファイルから作成されたプール ドメインの再利用しきい値を設定します。reclamation-hold-down が使用不可になっている (0 に設定されている) 場合、APM は設定された再利用しきい値と計算されたしきい値を比較し、大きい方の値を使用します。計算されたしきい値は、計算されたしきい値 = apportion-threshold + (prefix-count * 2^(32 – preferred-prefix-len)) + 1 の式から導き出されます。
• reclamation-hold-down- 按分イベント後にエンティティがプール ドメインの潜在的なイベントを一時停止する期間を秒単位で設定します。0以外のreclamation-hold-down値を設定すると、プールドメインがアイドル状態のときに便利な低い reclaim-threshold 値を設定できます(結果、エンティティに残る割り当て済みプールプレフィックスが少なくなります)。複数のプレフィクス再利用を含む割り当てイベントは、空きアドレスの数を一時的に再利用しきい値以上に押し上げる可能性があるため、指定された時間再利用イベントを抑制することで、加入者のログイン率が配分されたプレフィックス セットに追いつくことができます。プール ドメインの空きアドレス数が再利用しきい値を超えるように、割り当てイベントによってプール ドメインにアドレスが追加された場合は、空きアドレスの数が再利用しきい値を下回るまで、再利用イベントの生成を抑制します。

  • デフォルト: 0

    値が 0 の場合、 hold-down timer は無効になります。

  • 範囲: 1 から 3600

    手記：

    reclamation-hold-downは、30〜3600秒の間で設定された場合に有効になり、APMはreclaim-thresholdを設定した値に戻します。reclamation-hold-downが有効になっているか無効かに関係なく、APMはDOMAIN_THRESHOLDS_CHANGEトリガー応答を通じて影響を受けるエンティティに変更を通知します。

(オプション)トランザクションが停止した(タイムアウトした)と宣言する前に、APMがトランザクションの完了を待機する時間を指定します(秒単位)。トランザクションは、タスクのリストで構成されます。たとえば、按分トランザクションは、アドレスを取得するタスク、エンティティをプロビジョニングするタスク、およびランタイム状態を更新するタスクで構成されます。トランザクション内のいずれかのタスクが失敗すると、リスト内の以前に実行されたタスクがロールバックされます。たとえば、プロビジョニング タスクが失敗した場合、アドレスを取得するタスクはロールバックされ、アドレスがパーティションに返されます。

• デフォルト: 240

• 範囲: 60 から 900

APMサーバーに接続できるAPMiエンティティの数を指定します。

• デフォルト: 0

• 範囲: 0 から 500