Cisco SCMS SM LEGs ユーザ ガイド Release 3.1.6
SCE-Sniffer DHCP LEG の設定
SCE-Sniffer DHCP LEG の設定
発行日;2012/01/16 | ドキュメントご利用ガイド | ダウンロード ; この章pdf , ドキュメント全体pdf (PDF - 2MB) | フィードバック

目次

SCE-Sniffer DHCP LEG の設定

SCE-Sniffer DHCP LEG の設定の概要

一般的な設定

ポリシー アソシエーションの設定

ポリシー情報のダイナミックな割り当て

ポリシー情報のダイナミックな割り当ての例

ポリシー情報のスタティックな割り当て

SCE-Sniffer DHCP LEG の設定

ここでは、SCE-Sniffer DHCP LEG の設定方法について説明します。

SCE-Sniffer DHCP LEG の設定の概要

SCE-Sniffer DHCP LEG は 2 つのコンフィギュレーション ファイル( dhcpsnif.cfg および dhcp_pkg.cfg )を使用して設定されます。これらのファイルは sm-inst-dir /sm/server/root/config ディレクトリにあります( sm-inst-dir は to the SM インストレーション ディレクトリを示します)。

コンフィギュレーション ファイルは、角カッコで囲まれたセクション タイトル(たとえば、 [RDR Server] )で始まるセクションで構成されています。各セクションは、 parameter=value という形式の、いくつかのパラメータで構成されます。番号記号(#)で始まる行は、注釈行です。

SCE-Sniffer DHCP LEG の一般的なコンフィギュレーションは dhcpsnif.cfg にあります。ダイナミックなパッケージ アソシエーションの設定は dhcp_pkg.cfg にあります。

「一般的な設定」

「ポリシー アソシエーションの設定」

一般的な設定

次に、 dhcpsnif.cfg の設定変数について説明します。

[SCE-Sniffer DHCP LEG] セクションには、次のパラメータがあります。

start

起動時に SM が SCE-Sniffer DHCP LEG を実行するかどうかを定義します。

このパラメータの設定値は、 yes および no です。デフォルト値は、 no です。

RDR サーバが受信した DHCP メッセージを抽出して処理するには、このパラメータを yes に設定する必要があります。

log_failures

SM がユーザ ログに障害に関するメッセージを追加するかどうかを定義します。

このパラメータの設定値は、 true および false です。デフォルト値は、 true です。

log_all

SM がユーザ ログに、正常なログインおよびログアウトを含めた、すべてのメッセージを追加するかどうかを定義します。

このパラメータの設定値は、 true および false です。デフォルト値は、 false です。

use_default_domain

すべてのログイン動作で、デフォルトのドメイン「サブスクライバ」を使用するかどうかを定義します。

このパラメータの設定値は、 true および false です。デフォルト値は、 true です。

値が false に設定されている場合、SM はそのサブスクライバの DHCP トラフィックを受信した SCE の IP アドレスと同じドメイン名を使用して、サブスクライバをログインさせます。この場合、『 Cisco SCMS Subscriber Manager User Guide 』に従って、ドメイン エイリアスを設定する必要があります。

is_cable

これがケーブル モデム トランザクションであるかどうかの確認を示します。たとえば、Remote-ID サブオプション(Option 82 のサブオプション 2)の値と haddr DHCP ヘッダー フィールドを比較します。ケーブル モデム トランザクションの場合は、ポリシー情報のみを使用します。

このパラメータの設定値は、 true および false です。デフォルト値は、 true です。

[Sniffer] セクションには、次のパラメータが含まれています。

packet_types

LEG に送信する DHCP パケットのタイプが含まれます。

このパラメータの設定値は、 DHCPACK DHCPRELEASE のあらゆる組み合わせになります。デフォルト値は DHCPACK および DHCPRELEASE に設定されています。


) この LEG を正しく動作させるには、コンフィギュレーション ファイルを使用して SM で RDR サーバをイネーブルにします。


[Subscriber ID] セクションには、次のパラメータが含まれています。

dhcp_option

サブスクライバ ID アソシエーションに使用する DHCP オプションを定義します。サブオプションのある DHCP オプションは、コロンで DHCP オプションとサブオプションを区切ります。デフォルト値は、リモート ID 情報を使用するリレー エージェント情報、すなわち 82:2 です。

dhcp_option_type

上記の dhcp_option パラメータで定義した DHCP オプションのフォーマット タイプを定義します。

このパラメータの設定値は、 binary または string です。デフォルト値は、 binary です。

default_id

パケットに DHCP オプションが設定されていない場合に実行するフォールバックのタイプを定義します。

このパラメータの設定値は ip です。割り当てられた IP を使用して IP_a.b.c.d の形式でサブスクライバ ID を作成します。このパラメータが設定されていない場合、フォールバックは実行されず、ログインが失敗します。デフォルトではパラメータを設定しません。

次に、コンフィギュレーション ファイルの例を示します。

[SCE-Sniffer DHCP LEG]
start=yes
log_failures=true
log_all=false
use_default_domain=true
is_cable=true
[Sniffer]
packet_types=DHCPACK
[Subscriber ID]
dhcp_option=82:2
dhcp_option_type=binary
default_id=ip

ポリシー アソシエーションの設定


) ここで説明する設定は任意です。


SCE-Sniffer DHCP LEG でのサブスクライバ ポリシーの設定は、次のいずれかの方法で処理できます。

DHCP パケットから抽出した情報を使用して、ポリシー情報をダイナミックに割り当てます(ポリシー情報のダイナミックな割り当てを参照)。

SCE-Sniffer DHCP LEG 経由でログインするすべてのサブスクライバに、一定のパッケージ ID をスタティックに割り当てます(ポリシー情報のスタティックな割り当てを参照)。

ポリシー情報のダイナミックな割り当て

ポリシー情報が DHCP パケットで提供される場合、ポリシー情報をダイナミックに割り当てることができます。LEG は指定したオプションを連結し、ポリシー名を作成します。この設定を使用して、ポリシー名とアプリケーション ポリシー パラメータ(パッケージ ID や仮想リンクなど)の間でマッピングできます。SCE-Sniffer DHCP LEG は複数のポリシーをサポートできます。

DHCP パケットからポリシー情報データを抽出するには、 dhcp_pkg.cfg コンフィギュレーション ファイルを使用して、ポリシー情報を含んだオプション タイプと、ポリシー名から Service Control Application for Broadband(SCA BB)のパッケージ ID(または他のポリシー)への変換マップを定義します。

LEG は、LEG の設定に基づいて、ログイン動作に詳細なデータを追加できます。このデータは、キーと値のペアとして追加されます。SOAP LEG などのログイン チェーンの他のモジュールがこのデータを使用できます(「 SOAP LEG 」を参照)。このデータは、複数の DHCP オプションのデータを連結することで作成でき、ユーザ定義のラベルを指定できます。

[DHCP.Policy.XXX] セクションには、次のパラメータが含まれています。

options_order_for_policy_name

ポリシー アソシエーション情報を含んだ DHCP オプションを定義し、データの連結順序を定義します。giaddr(リレー エージェント IP)という DHCP ヘッダー フィールドもサポートされますが、 option_type パラメータで integer タイプを使用する必要があります。

このパラメータにはデフォルト値はありません。

形式: option[:subtype],option[:subtype],giaddr

options_type

options_order_for_policy_name パラメータで定義した DHCP オプションおよびフィールドのフォーマット タイプを定義します。

このパラメータの設定値は binary (ASCII 16 進数ストリングに変換されるバイナリ ストリング)、 string (ASCII ストリング)、または integer (ドット付き表記の IP アドレス ストリングに変換される 4 バイトの整数)です。リストの順序は options_order_for_policy_name と同じです。

このパラメータにはデフォルト値はありません。

name_seperator_value

2 つのオプションを連結してポリシー名を作成するとき、オプションの間で使用する区切り文字を定義します。任意の文字を使用できます。デフォルト値は、「_」です。

use_default

ポリシー情報を DHCP データから抽出できない場合(設定可能なオプションがない、またはオプションが設定されていないなど)に、デフォルトのポリシーを使用するかどうかを決定します。

このパラメータの設定値は、 true または false です。デフォルト値は、 false です。

default_policy

ポリシー情報を DHCP データから抽出できない場合に使用するデフォルトのポリシー ID を定義します。このパラメータが該当するのは、 use_default パラメータが true に設定されている場合だけです。

このパラメータの設定値は、任意の整数になります。このパラメータにはデフォルト値はありません。

allow_login_with_no_policy

ポリシー情報を DHCP データから抽出できず、 use_default パラメータが false に設定されていた場合に、ポリシー情報を使用しないでログインを実行するかどうかを定義します。

このパラメータが該当するのは、 use_default パラメータが false に設定されている場合だけです。

このパラメータの設定値は、 true または false です。デフォルト値は、 true です。

policy_property_name

ポリシー情報を含んだアプリケーション プロパティの名前を定義します。このパラメータにはデフォルト値はありません。


policy_property_name パラメータは、大文字と小文字が区別されます。SCA BB コンソールで定義されたとおりに記述されなければいけません(たとえば、packageIdmonitorupVlinkId、または downVlinkId)。


log_all

すべてのポリシー アソシエーション イベントに対して、詳細なユーザ ログ メッセージを書き込むかどうかを定義します。

このパラメータの設定値は、 true または false です。デフォルト値は、 false です。

log_default_assignment

デフォルト値( default_policy パラメータで定義)を割り当てるたびに、ユーザ ログ メッセージを記述するかどうかを定義します。

このパラメータの設定値は、 true または false です。デフォルト値は、 false です。

mapping_table.<policy_name>

DHCP パケットのポリシー情報から、SCA BB アプリケーションが使用するポリシーのプロパティ値に変換するための情報が含まれる複数のエントリです。

これらのエントリには、デフォルト値はありません。


) policy_name は、大文字と小文字が区別されます。DHCP パケットにあるとおりに記述する必要があります。


コンフィギュレーション ファイルの [Additional Data] セクションには、次のパラメータがあります。

label_options

ログイン動作への追加のために抽出する DHCP オプションを定義します。

設定値はオプション番号です。サブオプションがある DHCP オプションの場合は、オプションとサブオプションをコロンで区切ります(43:123 または 61 など)。

このパラメータにデフォルト値はありません。

label_keys

label_options パラメータで定義された DHCP オプションをマーキングするキーを定義します。

このパラメータにデフォルト値はありません。

label_options_type

label_options パラメータで定義された DHCP オプションのフォーマット タイプを定義します。

このパラメータの設定値は binary (ASCII 16 進数ストリングに変換されるバイナリ ストリング)または string (ASCII ストリング)です。

デフォルト値は、 binary です。

ポリシー情報のダイナミックな割り当ての例

DHCP パケットの Option 43(Vendor Specific オプション)でポリシー情報が表示され、サブタイプ 102 および 101 が両方とも使用されているものと仮定します。次のように options_order_for_policy_name パラメータを設定します。

options_order_for_policy_name=43:102,43:101
 

サブタイプ 102 の Option 43 にパッケージ タイプ(gold、silver、または bronze)が含まれ、サブタイプ 101 の Option 43 にドメイン情報が含まれているものと仮定します(パッケージ タイプの意味はドメインごとに異なります)。区切り値がデフォルト値に設定されている場合、mapping_table エントリを次のように設定します。

mapping_table.gold_domain1=11
mapping_table.gold_domain2=12
mapping_table.silver_domain1=13
mapping_table.silver_domain2=14
 

この設定では、DHCP パケットで、サブタイプ 102 の Option 43 に「gold」値が含まれ、サブタイプ 101 の Option 43 に「domain1」値が含まれている場合、SM のサブスクライバに対応付けられるパッケージ ID は 11 という値になります。

次の設定例では、追加データとして、リレー エージェント回線 ID オプションのデータをログイン動作に追加する方法を示します。

[Additional Data]
label_options=82:1
label_keys=PORT_ID
label_option_type=string
 

次に、コンフィギュレーション ファイル全体の例を示します。

[DHCP.Policy.Package]
options_order_for_policy_name=43:102,43:101
name_separator_value=_
use_default=true
default_policy=1
policy_property_name=packageId
allow_login_with_no_policy=false
log_all=false
log_default_assignment=false
mapping_table.gold_domain1=11
mapping_table.gold_domain2=12
mapping_table.silver_domain1=13
mapping_table.silver_domain2=14
[Additional Data]
label_options=82:1
label_keys=PORT_ID
label_option_type=string
 

ポリシー情報のスタティックな割り当て

インストールでパッケージ情報をダイナミックに割り当てる必要がない場合、次の例のように、コンフィギュレーション ファイル dhcp_pkg.cfg は、すべてのサブスクライバに割り当てるデフォルトのパッケージ ID を定義する必要があります。

[DHCP.Policy.Package]
policy_property_name=packageId
allow_login_with_no_policy=false
use_default=true
default_policy=1
[DHCP.Policy.VirtualLinkDownstream]
policy_property_name=downVlinkId
allow_login_with_no_policy=false
use_default=true
default_policy=0
[DHCP.Policy.VirtualLinkUpstream]
policy_property_name=upVlinkId
allow_login_with_no_policy=false
use_default=true
default_policy=0
 

他のパラメータはいずれも設定しません。