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と、APMは5秒ごとにドメインの監視更新を要求します。

メモ:

自動再利用を有効にするには、既定値の場合でも、少なくとも 1 つの auto-reclamation オプションを構成する必要があります。

メモ:

構成から削除すると auto-reclamation 、APM は保留中のドレインと回復のトランザクションをすべてキャンセルします。

オプション

active (always | window)

自動再利用がいつアクティブになるかを指定します。

  • always- APMは常にクリティカルまたはアイドル状態のプールを評価して、レクラメーションを開始するかどうかを決定します。

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

    メモ:

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

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

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

  • 既定: always

window-duration minutes

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

  • デフォルト: 60 分

  • 範囲: 15〜720分

window-start time

評価および再利用のためにウィンドウを開くタイミングを指定します。このオプションを使用するには、 オプションwindowactive に設定する必要があります。時刻を指定するには、次のいずれかの形式で 24 時間制を使用します。

  • HH:MM+hhmm- 時刻を指定し、現地時間との正のオフセットを示します。例えば、15:21+01:00 を指定した場合、開始時刻は現地時間の 16:21 になります。

  • HH:MM-hhmm- 時刻を指定し、現地時間からの負のオフセットを示します。例えば、15:21-01:00 を指定すると、開始時刻は現地時間の 14:21 になります。

リリース情報

APMリリース3.0.0で導入されたステートメント。

エンティティクライアント(APM)

構文

階層レベル

説明

着信接続のAPMセキュリティパラメータを定義することで、安全な着信接続を構成します。動的管理BNGの場合、 コマンドを使用してシークレットを定義し、 entity-clients 受信APM接続を保護します。エンティティ クライアントがない場合、受信 APM 接続は安全ではないと見なされます。この構成の は filenames、セットアップ時に指定したセキュリティ キーと証明書ファイルと一致する必要があります。

オプション

secrets

接続がBNGまたは外部マネージャーにアクセスするために必要なアクセス資格情報を指定します。

  • certificate filename- APM 証明書を含むファイル名。
  • private-key filename- APMのプライベートキーを含むファイル名。
  • ca-certificate filename- エンティティの認証に使用されるルート認証局(CA)のルート証明書を含むファイル名。

リリース情報

APMリリース3.1.0で導入されたステートメント。

エンティティマッチ(APM)

構文

階層レベル

説明

エンティティ一致リストを設定して、有効なBNGをプールドメインプロファイルにマッピングします。

ステートメントは entity-match 以下を識別します。エンティティ一致ステートメントは、受信APMエンティティをプールドメインプロファイルに誘導します。APMは、2つのリストが一致するように、プールドメインを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-lenmax-prefix-len 以下である必要があります。それ以外の場合、APMはプレフィックスをパーティションに追加しません。

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が再利用されたプレフィックスを割り当て可能にできるようになるまで保持する期間を秒単位で指定します。
  • reserved-prefix sub-prefix- このパーティションから割り当てることができないサブネットワークを指定します。オプションで、予約を特定のBNGに制限するか、そのBNG上の指定されたプールドメインに制限することで、予約を認定することができます。
  • 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- エンティティが割り当てイベントの後にプールドメインの潜在的なイベントを一時停止する期間を秒単位で設定します。ゼロ以外のrelamation-hold-down値を設定すると、プールドメインがアイドル状態のときに役立つ可能性がある低い reclaim-threshold 値を設定できます(エンティティに残っている割り当て済みプールプレフィックスが少なくなります)。複数のプレフィックスの再利用を含む割り当てイベントによって、空きアドレスの数が一時的に再利用のしきい値を超える可能性があるため、指定した時間再利用イベントを抑制することで、加入者のログイン レートが割り当てられたプレフィックス セットに追いつくことができます。プール ドメインの空きアドレス数が再利用しきい値を超えるように、割り当てイベントがプール ドメインにアドレスを追加する場合は、空きアドレスの数が再利用しきい値を下回るまで再利用イベントの生成を抑制します。
    • デフォルト: 0

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

    • 範囲: 1 から 3600

      メモ:

      は30〜3600秒に設定されている場合に有効になり、APMは reclamation-hold-down 再利用しきい値を構成した値に戻します。が有効になっているか無効になっているか 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 で導入されたオプション。