Broadband Access Center for Cable がサポートするツールと高度な概念

この章では、Broadband Access Center for Cable（BACC）の保守、および製品のインストール、配備、使用の高速化と改善に役立つツールとその使用方法について説明します。

この章では、次のトピックについて取り上げます。

• テンプレート ファイルの作成
• 構成ファイル ユーティリティ
• PKCert ツールによる KDC 証明書の管理
• ChangeNRProperties.sh ツールの使用
• Keygen ツールの使用方法
• rduSnmpAgent.sh コマンドの使用方法
• 利用可能なディスク領域の監視

この項では、ツールの使用方法について、多くの例を示します。多くの場合、ツールのファイル名には <BPR_HOME> と指定されたパスが含まれます。これは、デフォルトのディレクトリ位置を示しています。

テンプレート ファイルの作成

BACC が使用するテンプレートは、管理者がダイナミック PacketCable、DOCSIS、および CableHome ファイルを配備するときに役立ちます。テンプレートを使用して、読みやすく編集しやすい形式のテンプレート ファイルを作成できます。テンプレートは、有効な PacketCable、DOCSIS、または CableHome ファイルを生成するときに使用する PacketCable、DOCSIS、または CableHome のオプションおよび値を表すASCII テキスト ファイルです。BACC は、.tmpl ファイル拡張子を使用してテンプレート ファイルを識別します。サービス クラスでテンプレート ファイルを参照する前に、アドミニストレータのユーザ インターフェイスまたは API を使用して、外部ファイルとしてそのファイルを RDU に追加する必要があります。

BACC RDU コンポーネントをインストールするときに、いくつかのサンプル テンプレート ファイルが <BPR_HOME>/rdu/samples/templates ディレクトリにコピーされます。

テンプレートを作成または編集するために必要なツールは単純なテキスト エディタだけですが、独自のテンプレート ファイルを作成する前に、次の点を十分に理解する必要があります。

• BACC プロビジョニングのフロー
• DOCSIS 1.0/1.1 RFI の仕様
• MTA デバイス プロビジョニングの仕様
• CableHome 1.0 の仕様
• ケーブル デバイス用の SNMP MIB（DOCS-CABLE-DEVICE-MIB など）

テンプレートの 文法

テンプレートは、4 種類の異なる文で構成されます。

• コメント
• インクルード
• オプション
• インスタンス修飾子

コメントで、テンプレートに注釈を付けることができます。Include 文で、ほかのテンプレートで使用するビルディング ブロック テンプレートを作成できます。オプションで、PacketCable、DOCSIS、または CableHome の TLV（type length value）を説明的に指定できます。 テンプレートの文法 に、利用可能なテンプレートの文法オプションを示します。

テンプレートの文法

オプション	説明
<comment>	::= #[ascii-string]
<include>	::= include "<filename.tmpl>"
<option-description>	::= option <option-num> [instance <instance-num>] <option-value>
<option-num>	::= <unsigned-byte>[.<unsigned-byte>]*
<option-value>	::= <well-defined-value> | <custom-value>
<well-defined-value>	::= <option-value-string>[,<option-value-string>]*
<custom-value>	::= <ascii-value> | <hex-value> | <ip-value>
<ascii-value>	::= ascii <ascii-string>
<hex-value>	::= hex <hex-string>
<ip-value>	::= ip <ip-string>
<instance-num>	::= <unsigned integer>
<template>	::= <template-statement>*
<template-statement>	::= <comment> | <include> | <option-description>

コメント

コメントは情報のみを提供し、常にシャープ記号（#）から行末までの間に配置されます。 コメントの使用方法の例 に、コメントの使用方法の例を示します。

1. コメントの使用方法の例

#

# Template for gold service

#

option 3 1 # enabling network access

インクルード

インクルード ファイルによって、似ているが少し異なるテンプレートの階層を構築できます。多くのサービス クラスで共通のオプションを定義する場合に、複数のテンプレートでオプションを重複させる必要がなくなり、便利です。

単一のテンプレートで複数の include 文を使用できますが、テンプレート中での include 文の場所は重要です。インクルード ファイルの内容は、テンプレート中で include 文が見つかった場所で読み込まれます。インクルードするテンプレートは、使用する前に、外部ファイルとして RDU に追加する必要があります。テンプレートは RDU データベースにパス情報なしにストアされるため、インクルードするファイルには ../.. などの位置修飾子を含めることができません。例 include 文の正しい使用方法 と include 文の誤った使用方法 は、それぞれ、インクルード オプションの正しい使用方法と誤った使用方法を示しています。

1. include 文の正しい使用方法

# Valid, including common options

include "common_options.tmpl"

1. include 文の誤った使用方法

# Invalid, using location modifier

include "../common_options.tmpl"

# Invalid, using incorrect file suffix

include "common_options.common"

# Invalid, not using double quotes

include common_options.tmpl

オプション

PacketCable、DOCSIS、および CableHome の構成ファイルは、適切に符号化されたオプション ID と値のペアで構成されます。サポートされるオプションの形式には、定義済みとカスタムの 2 種類があります。

• オプションを正しく定義するには、 オプション番号と値が必要です。値は、オプション番号の符号化タイプに基づいて符号化されます。
• カスタム オプションには、オプション番号、明示的な値の符号化タイプ、値が必要です。

option 43 などの複合オプションを使用するときは、インスタンス修飾子を使用して、TLV グループを指定できます。詳細については、 インスタンス修飾子 を参照してください。

テンプレートで定義済みオプションのいずれかを指定するときは、値の値符号化を指定する必要はありません。定義済み符号化タイプの詳細については、 定義済みオプションの符号化タイプ および DOCSIS のオプションとバージョンのサポート を参照してください。

カスタム オプション（option 43 など）を指定するときは、オプションの符号化タイプを指定する必要があります。利用可能な符号化タイプは、次のとおりです。

• ASCII：ASCII タイプは、指定された任意の値を NULL ターミネータなしの ASCII 文字列として符号化します。値にスペースを含める場合は、二重引用符で囲む必要があります。
• hex：値は有効な 16 進数で、各オクテットに正確に 2 文字入るようにする必要があります。値として 01 を指定した場合は、符号化で正確に 1 オクテットが使用されます。値として 0001 を指定した場合は、符号化で正確に 2 オクテットが使用されます。
• IP アドレス：IP アドレス タイプでは、指定された任意の値が 4 オクテットに符号化されます。たとえば、IP アドレス 10.10.10.1 は 0A0A0A01 に符号化されます。

1 行に複数の値があるオプションでは、カンマを使用して値を 区切ります。このように値が扱われるので、場合によっては値の 1 つを二重引用符で囲む必要がありますが、ほかの値を囲む必要はありません。複数の値を持つオプションの例として、option 11（SNMP Varbind）があります。詳細については、 SNMP Varbind を参照してください。

複合オプションを指定するときは、トップ レベル オプション（option 4.1 を指定するときの option 4 など）を指定する必要がありません。例 option 文の正しい使用方法 と option 文の誤った使用方法 は、それぞれ、option 文の正しい使用方法と誤った使用方法を示しています。

1. option 文の正しい使用方法

# Valid, specifying the number for well known option 3

option 3 1

# Valid, specifying the number for option 4 sub-option 1

option 4.1 1

# Valid, specifying a vendor option as hex

option 43.200 hex 00000C

# Valid, specifying a vendor option as ascii

option 43.201 ascii "enable log"

# Valid, specifying a vendor option as IP

option 43.202 ip 10.4.2.1

1. option 文の誤った使用方法

# Invalid, using hex with incorrect hex separator

option 43.200 hex 00.00.0C

# Invalid, not using double quotes when needed

option 43.201 ascii enable log

# Invalid, not specifying IP address correctly

option 43.202 ip 10-10-10-1

# Invalid, specifying the description for option "Network Access Control"

option "Network Access Control" 1

# Invalid, specifying top level option

option 4

インスタンス修飾子

インスタンス修飾子は、複合オプションを特定の個別 Tag-Length-Value（TLV）にグループ化するために使用します。例 正しい IOS コマンドライン入力 と 誤った IOS コマンドライン入力 は、それぞれ、個別の TLV を作成する正しい方式と誤った方式を示しています。IOS コマンドを 2 つの個別のコマンドに解釈するために、IOS DOCSIS モデムをイネーブルにする必要があります。

1. 正しい IOS コマンドライン入力

# Valid, each IOS command gets it's own TLV

option 43.8 instance 1 00-00-0C

option 43.131 instance 1 ascii "login"

option 43.8 instance 2 00-00-0C

option 43.131 instance 2 ascii "password cable"

1. 誤った IOS コマンドライン入力

# Invalid, IOS commands are grouped into one TLV

option 43.8 00-00-0C

option 43.131 ascii "login"

option 43.131 ascii "password cable"

# Invalid, using instance on non-compound options

option 3 instance 1 1

option 43.8 の符号化タイプは Organizationally Unique Identifier（OUI）です。 option 文の正しい使用方法 とは異なり、00-00-0C 形式のみが可能です。

SNMP Varbind

DOCSIS option 11、 PacketCable option 64、または CableHome option 28 を指定するときは、 Object Identifier（OID; オブジェクト識別子）を使用する必要があります。OID を含む MIB は、RDU がロードする次の MIB のいずれかに存在する必要があります。オブジェクトを一意に識別するために必要な数の OID を指定する必要があり、OID の名前または番号を使用できます。RDU は、次の MIB を自動的にロードします。

• SNMPv2-SMI
• SNMPv2-TC
• CISCO-SMI
• CISCO-TC
• SNMPv2-MIB
• RFC1213-MIB
• IANAifType-MIB
• IF-MIB
• DOCS-IF-MIB
• DOCS-BPI-MIB
• CISCO-CABLE-SPECTRUM-MIB
• CISCO-DOCS-EXT-MIB
• SNMP-FRAMEWORK-MIB
• DOCS-CABLE-DEVICE-MIB
• DOCS-CABLE-DEVICE-MIB-OBSOLETE
• CISCO-CABLE-MODEM-MIB
• CLAB-DEF-MIB
• PKTC-MTA-MIB
• PKTC-SIG-MIB
• PKTC-EVENT-MIB

DOCSIS MIB

RDU にロードされる DOCSIS MIB には、2 つのバージョンがあります。

• DOCS-CABLE-DEVICE-MIB-OBSOLETE（実験的ブランチ）
• DOCS-CABLE-DEVICE-MIB（mib2 ブランチ）

そのため、 DOCSIS MIB は完全修飾する必要があります。例 option 11 の正しい使用方法 と option 11 の誤った使用方法 は、それぞれ、option 11 の正しい使用方法と誤った使用方法を示しています。

1. option 11 の正しい使用方法

# Valid, uniquely identifying an OID

option 11 .experimental.docsDev.docsDevMIBObjects.docsDevNmAccessTable.docsDevNmAccess
Entry.docsDevNmAccessStatus.1, Integer, 4

# Valid, uniquely identifying a PacketCable OID

option 11 .pktcMtaDevEnabled.0, Integer, 1

1. option 11 の誤った使用方法

# Invalid, docsDevNmAccessStatus is not uniquely identified, its in experimental and

# mib-2 branches

option 11 .docsDevNmAccessStatus.1, Integer, 4

CableHome MIB

次の CableHome MIB が RDU にロードされます。

• CABH-CAP-MIB
• CABH-CDP-MIB
• CABH-CTP-MIB
• CABH-PS-DEV-MIB
• CABH-QOS-MIB
• CABH-SEC-MIB

次の追加 MIB が必要ですが、BACC 製品の一部ではありません。

• CABH-CTP-MIB には RMON2-MIB、TOKEN-RING-RMON-MIB が必要です。
• CABH-SEC-MIB には DOCS-BPI2-MIB が必要です。
• CABH-PS-DEV-MIB には RFC-1217-MIB が必要です。

マクロ変数

マクロ変数はテンプレートで値として指定され、これを使用してデバイス固有のオプション値を指定できます。マクロ変数がテンプレートにあると、プロパティ階層でマクロ変数名が検索され、変数の値が代入されます。変数名は カスタム プロパティで、事前に RDU に定義します。スペースは使用できません。

カスタム プロパティを定義すると、次の階層で使用できるようになります。

• システム デフォルト
• テクノロジー デフォルト（PacketCable、DOCSIS、CableHome など）
• DHCP 基準プロパティ
• サービス クラス プロパティ
• デバイス プロパティ

テンプレート パーサーは、階層の下から上にプロパティを検索し（最初はデバイス、次にサービス クラス）、テンプレート オプション構文に変換します。 マクロ変数をサポートする構文は 3 つあります。

• ${var-name}：この構文は、単純な代入です。変数が見つからない場合は、エラーが生成されます。
• ${var-name, ignore}：この構文では、変数値がプロパティ階層で見つからなかった場合に、このオプションが無視されます。
• ${var-name, default-value}：この構文では、変数がプロパティ階層で見つからなかった場合に、デフォルト値が使用されます。

例 マクロ変数の正しい使用方法 と マクロ変数の誤った使用方法 は、それぞれ、option 11 の正しい使用方法と誤った使用方法を示しています。

1. マクロ変数の正しい使用方法

# Valid, using macro variable for max CPE's, straight substitution

option 18 ${MAX_CPES}

# Valid, using macro variable for max CPE's, ignore option if variable not found

# option 18 will not be defined in the DOCSIS configuration file if MAX_CPES

# is not found in the properties hierarchy

option 18 ${MAX_CPES, ignore}

# Valid, using macro variable for max CPE's with a default value

option 18 ${MAX_CPES, 1}

# Valid, using macro variable for vendor option

option 43.200 hex ${MACRO_VAR_HEX}

# Valid, using macro variable for vendor option

option 43.201 ascii ${MACRO_VAR_ASCII}

# Valid, using macro variable for vendor option

option 43.202 ip ${MACRO_VAR_IP}

# Valid, using macro variable in double quotes

option 18 "${MAX_CPES}"

# Valid, using macro variable within a value

option 43.131 ascii "hostname ${HOSTNAME}"

# Valid, using macro variables in multi-valued options

option 11 ${ACCESS_CONTROL_MIB, .mib-2.docsDev.docsDevMIBObjects.docsDevNmAccessTable.docsDevNmAccessEntry.docsDevNmAccessControl.1}, Integer, ${ACCESS_CONTROL_VAL, 3}

# Valid, using macro variable in an include statement

include "${EXTRA_TEMPLATE}"

# Valid, using macro variable in an include statement with a default value

include "${EXTRA_TEMPLATE, modem_reset.tmpl}"

# Valid, using macro variable in an include statement with a default value

include "${EXTRA_TEMPLATE, modem_reset}.tmpl"

# Valid, using macro variable in an include statement with an ignore clause

include "${MY_TEMPLATE, ignore}"

1. マクロ変数の誤った使用方法

# Invalid, using macro variable as the option number

option ${MAX_CPES} 1

# Invalid, using macro variable with space in name

option 18 ${MAX CPES}

定義済みオプションの符号化タイプ

定義済みオプション符号化タイプ に、定義済み 符号化タイプを持つオプションを示します。

定義済みオプション符号化タイプ

符号化	入力	例
ブール値	0 が false、1 が true です。	0
バイト	連続した 16 進オクテットです。各オクテットの長さは、正確に 2 文字です。	000102030405060708
IP アドレス	ドット（.）で区切られた 4 つの 8 ビット符号なし整数です。	10.10.10.1
複数の IP アドレス	カンマで区切られた IP アドレスのリストです。	10.11.12.13,10.11.12.14
MAC アドレス	コロン（:）またはダッシュ（-）で区切られた 6 つの 16 進オクテットです。各オクテットの長さは、正確に 2 文字です。コロンとダッシュを混在させることはできません。	00:01:02:03:04:05 または 00-01-02-03-04-05
MAC アドレスとマスク	コロン（:）またはダッシュ（-）で区切られた 12 オクテットです。各オクテットの長さは、正確に 2 文字です。コロンとダッシュを混在させることはできません。先頭の 6 オクテットが MAC アドレスを表し、末尾の 6 オクテットが MAC アドレスのマスクを表します。	00:01:02:03:04:05:06:07:08:09:0A:0B または 00-01-02-03-04-05-06-07-08-09-0A-0B
NVTASCII	ASCII 文字列です。符号化された文字列に NULL ターミネータは含まれません。	This is an ASCII string
OID	SNMP OID 文字列です。	sysinfo.0
OIDCF	SNMP OID 文字列と、カンマで区切られた符号なし整数（0 または 1）です。	sysinfo.0,1
OUI	コロン（:）またはダッシュ（-）で区切られた 3 つの 16 進オクテットです。各オクテットの長さは、正確に 2 文字です。	00-00-0C
SNMPVarBind	SNMP OID 文字列、タイプ、および値です。それぞれがカンマで区切られます。有効なタイプは次のとおりです。 BITS Counter Counter32 Counter64 Gauge Gauge32 INTEGER Integer32 IpAddress OCTETSTRING OBJECTIDENTIFIER Opaque TimeTicks Unsigned32 OCTETSTRING は、末尾に NULL を含まない 16 進表記に変換される文字列（オクテット文字列など）または一重引用符で囲まれた 16 進表記（'aa:bb:cc' など）です。	.experimental.docsDev.docsDevMIBObjects. docsDevNmAccessTable.docsDevNmAccessEntry.docsDevNmAccessStatus.1, INTEGER, 4
サブ タイプ	カンマで区切られた、1 つまたは 2 つの 8 ビット符号なし整数です。	12 または 12,14
8 ビット符号なし整数	0 〜 255。	14
16 ビット符号なし整数	0 〜 65535。	1244
32 ビット符号なし整数	0 〜 4294967295。	3455335
8 ビット符号なし整数および 16 ビット符号なし整数	カンマで区切られた、1 つの 8 ビット符号なし整数と 1 つの 16 ビット符号なし整数です。	3,12324
8 ビット符号なし整数のペア	カンマで区切られた 2 つの 8 ビット符号なし整数です。	1,3
3 ビット バイトの 8 ビット符号なし整数	カンマで区切られた 3 つの 8 ビット符号なし整数です。	1,2,3
ZTASCII	ASCII 文字列です。符号化された文字列に NULL ターミネータが含まれます。	This is an ASCII string

BITS 値の構文

BITS 型を使用する場合は、ラベル（「interval1 interval2 interval3」）または数値によるビット位置（「0 1 2」）を指定する必要があります。ラベル値は 1 ベースで、ビット値は 0 ベースであることに注意してください。

ビット番号を使用する構文の例を示します。

option 11 .pktcSigDevR0Cadence.0,STRING,"0 1 2 3 4 5 6 7 8 9 10 11 12 13 14"

OCTETSTRING の構文

OCTETSTRING は、末尾に NULL を含まない 16 進表記に変換される文字列（オクテット文字列など）または一重引用符で囲まれた 16 進表記（'aa:bb:cc' など）です。

ラベルを使用するカスタマー オクテット文字列（FFFE000000000000）の構文を示します。

option 11 .pktcSigDevR0Cadence.0,STRING,"interval1 interval2 interval3

interval4 interval5 interval6 interval7 interval8 interval9 interval10

interval11 interval12 interval13 interval14 interval15"

構成ファイル ユーティリティ

構成ファイル ユーティリティを使用して、PacketCable 1.0、DOCSIS 1.0/1.1、および CableHome のテンプレート ファイルおよび構成ファイルをテスト、検証、および表示できます。 これらの作業は、独自の構成ファイルを正常に展開するために重要です。テンプレートの 詳細については、 テンプレート ファイルの作成 を参照してください。

このツールを実行するには、root 特権が必要です。

構成ファイル ユーティリティは、RDU をインストールし、ユーティリティを <BPR_HOME>/rdu/bin ディレクトリにインストールしたときにのみ利用可能です。

符号化するテンプレート ファイルとデコードする バイナリ ファイルの両方が、構成ファイル ユーティリティを起動するディレクトリに存在する必要があります。

この項のすべての例では、RDU が運用中で、次の条件が適用されていることを前提にしています。

• BACC アプリケーションは、ホームディレクトリ（/opt/CSCObpr）にインストールされています。
• RDU ログイン名は admin です。
• RDU ログイン パスワードは changeme です。

この項の例では、一部が出力例にとって重要でない場合に、その部分を省略して切り詰めていることがあります。その場合は、例中のサマリーの直前に連続したピリオド（...）で示してあります。

この項では、次のトピックについて取り上げます。

• ローカル テンプレート ファイルの解析
• 外部テンプレート ファイルの解析
• コマンドラインでのマクロ変数の指定
• マクロ変数用のデバイスの指定
• バイナリ ファイルへの出力の指定
• ローカル バイナリ ファイルの表示
• 外部バイナリ ファイルの表示
• バイナリ ファイルからテンプレートへの変換

構成ファイル ユーティリティの実行

次の手順と例で、「構成ファイル ユーティリティを実行する」というフレーズは、指定されたディレクトリから runCfgUtil.sh コマンドを入力することを意味します。構成ファイル ユーティリティを実行するには、ホーム ディレクトリから次のコマンドを実行します。

runCfgUtil.sh ( options)

利用可能な (options) は、次のとおりです。

• -c <secret>：DOCSIS テンプレート ファイルを解析するときの CMTS 共有秘密情報を指定します。デフォルトの共有秘密情報を指定するには、- c cisco と入力します。
• -cablehome：入力ファイルが CableHome ポータル サービス設定ファイルであることを示します。-docsis または -pkt オプションと同時に使用することはできません。
• -d：バイナリ入力ファイルをデコードします。-e オプションと同時に使用することはできません。
• -docsis：入力ファイルが DOCSIS 設定ファイルであると指定します。このデフォルトを -pkt または -cablehome オプションと同時に使用することはできません。
• -e：テンプレート入力ファイルを符号化します。このデフォルトを -d オプションと同時に使用することはできません。
• -g：docsis、packet cable、または cablehome バイナリ ファイルからテンプレート ファイルを生成します。
• -h<host:port>：ホストとポート番号を指定します。デフォルトのポート番号は 49187 です。
• -i <device id>：マクロ変数を解析するときに使用するデバイスを指定します。たとえば、デバイス ID が 1,6,00:00:00:00:00:01 の場合は、 -i 1,6,00:00:00:00:00:01 と入力します。このオプションを使用するときは、-u および -p オプションを使用して、それぞれユーザ名とパスワードを指定する必要もあります。-m オプションと同時に使用することはできません。
• -l <filename>：入力ファイルがローカル ファイル システムにあることを示します。たとえば、入力ファイルの名前が any_file の場合は、-l any_file と入力します。-r オプションと同時に使用することはできません。
• -m <macros> ：マクロ変数のキーと値のペアを指定します。形式は key=value です。複数のマクロ変数が必要な場合は、key_1=value_1,,key_2=value_2 のように、キーと値のペアを 2 つのカンマで区切ります。-i オプションと同時に使用することはできません。
• -p <password>：RDU に接続するときに使用するパスワードを指定します。たとえば、パスワードが 123456 の場合は、 -p 123456 と入力します。
• -o <filename>：解析したテンプレート ファイルをバイナリ ファイルとして保存します。たとえば、出力をファイル op_file に保存するには、 -o op_file と入力します。
• -pkt：入力ファイルが PacketCable MTA 設定ファイルであることを示します。-docsis または -cablehome オプションと同時に使用することはできません。
• -r <filename>：入力ファイルが RDU に追加した外部ファイルであることを示します。たとえば、ファイル名が file25 の場合は、- r file25 と入力します。このオプションを使用するときは、-u および -p オプションを使用して、それぞれユーザ名とパスワードを指定する必要もあります。-l オプションと同時に使用することはできません。
• -s：解析されたテンプレートまたはバイナリ ファイルの内容を人間が読める形式で表示します。
• -u <username>：RDU に接続するときに使用するユーザ名を指定します。たとえば、ユーザ名が admin の場合は、 -u admin と入力します。

設定ファイル ユーティリティが生成する出力に、option 19（TFTP サーバ タイムスタンプ）と option 20（TFTP サーバのプロビジョニングされたモデム アドレス）は含まれません。ただし、これらは BACC TFTP 混合に含まれます。

構成ファイル ユーティリティの使用方法

設定ファイル ユーティリティを使用して、BACC テンプレートをテストするには、次の手順に従います。

テンプレート ファイルの作成 の説明に従い、テンプレートを作成します。

1. ローカル ファイル システムで設定ファイル ユーティリティを実行します。テンプレートにマクロ変数が含まれている場合は、次の操作を順に実行する必要があります。
2. コマンドライン代入でテストします。
3. RDU に追加したデバイスでテストします。
4. テンプレート（および、そのテンプレートにインクルードするテンプレート）を RDU に追加します。
5. 外部ファイルとして設定ファイル ユーティリティを実行します。テンプレートにマクロ変数が含まれている場合は、次の操作を順に実行する必要があります。
6. コマンドライン代入でテストします。
7. RDU に追加したデバイスでテストします。
8. テンプレートを使用するサービス クラスを構成します。

ローカル テンプレート ファイルの解析

# /opt/CSCObpr/rdu/bin/runCfgUtil.sh -pkt -l unprov_packet_cable.tmpl Broadband Provisioning Registrar Configuration Utility Version: 2.5.1.15
Off	File Bytes	Option	Description	Value
0	FE0101	254	Telephony Config File Start/End	1
3	0B153013060E 2B06010401A30B0202010101 0700020102	11	SNMP MIB Object	.iso.org.dod.internet.private.enterprises.cableLabs.clabProject.clabProjPacketCable.pktcMtaMib.pktcMtaMibObjects .pktcMtaDevBase. pktcMtaDevEnable d.0,INTEGER,false(2)
....................................... 0 error(s), 0 warning(s) detected. Parsing of unprov_packet_cable.tmpl was successful. The file unprov_packet_cable.tmpl was parsed successfully in 434 ms. The parser initialization time was 92 ms. The parser parse time was 342 ms.

外部テンプレート ファイルの解析

Off	File Bytes	Option	Description	Value
0	030100	3	Network Access Control	Off
3	041F	4	Class of Service
5	010101	4.1	Class ID	1
8	02040001F400	4.2	Maximum Downstream Rate	128000 bits/sec
14	03040000FA00	4.3	Maximum Upstream Rate	64000 bits/sec
20	040101	4.4	Upstream Channel Priority	1
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
252	06108506547F C9152B44DB95 5420843EF6FE	6	CM MIC Configuration Setting	8506547FC9152B44 DB955420843EF6FE
270	0710644B675B 70B7BD3E09AC 210F794A1E8F	7	CMTS MIC Configuration Setting	644B675B70B7BD3E 09AC210F794A1E8F
288	FF	255	End-of-Data Marker
289	00	0	PAD
290	00	0	PAD
291	00	0	PAD
0 error(s), 0 warning(s) detected. Parsing of unprov.tmpl was successful. The file unprov.tmpl was parsed successfully in 375 ms. The parser initialization time was 63 ms. The parser parse time was 312 ms.

テンプレート ファイルの解析とユーザ指定の共有秘密情報の追加

# /opt/CSCObpr/rdu/bin/runCfgUtil.sh -l macro.tmpl -i "1,6,00:01:02:03:04:05" -u admin -p changeme Broadband Provisioning Registrar Configuration Utility Version: 2.5.1.15
Off	File Bytes	Option	Description	Value
0	030101	3	Network Access Control	On
3	041F	4	Class of Service
5	010101	4.1	Class ID	1
8	02040000FA00	4.2	Maximum Downstream Rate	64000 bits/sec
14	03040000FA00	4.3	Maximum Upstream Rate	64000 bits/sec
20	040101	4.4	Upstream Channel Priority	1
....................................... 0 error(s), 0 warning(s) detected. Parsing of macro.tmpl was successful. The file macro.tmpl was parsed successfully in 823 ms. The parser initialization time was 102 ms. The parser parse time was 803 ms.

バイナリ ファイルへの出力の指定

# /opt/CSCObpr/rdu/bin/runCfgUtil.sh -l unprov.tmpl -o unprov.cm Broadband Provisioning Registrar Configuration Utility Version: 2.5.1.15

0 error(s), 0 warning(s) detected. Parsing of unprov.tmpl was successful. The file unprov.tmpl was parsed successfully in 595 ms. The parser initialization time was 262 ms. The parser parse time was 333 ms.

ローカル バイナリ ファイルの表示

# /opt/CSCObpr/rdu/bin/runCfgUtil.sh -d -l unprov_packet_cable.bin Broadband Provisioning Registrar Configuration Utility Version: 2.5.1.15
Off	File Bytes	Option	Description	Value
0	FE0101	254	Telephony Config File Start/End	1
3	0B153013060E 2B06010401A30B02020101010700020102	11	SNMP MIB Object	.iso.org.dod.internet.private.enterprises.cableLabs.clabProject. clabProjPacketCa ble.pktcMtaMib.pktcMtaMibObjects .pktcMtaDevBase. pktcMtaDevEnable d.0,INTEGER,fals e(2)
. . . . . . . . . . . . . . . .

外部バイナリ ファイルの表示

ロギング レベル

ログ レベル	説明
緊急	システムが不安定です。
アラート	すぐに対応が必要です。
クリティカル	クリティカルな状態が存在します。
エラー	エラー状態が存在します。
警告	警告状態が存在します。
通知	正常ですが重要な状態です。
情報	情報メッセージのみに使用されます。

安定した動作状態を維持するためには、RDU ロギング レベルを通知レベルのままにすることをお勧めします。通知は、このツールのデフォルト値にもなっています。

デバッグ動作中に安定した状態パフォーマンスを維持する必要がある場合は、情報レベルをお勧めします。ただし、情報レベルに設定して実行すると大量のログ エントリが作成され、このことがパフォーマンスに悪影響を与える可能性があるため、注意が必要です。

RDU ログ レベル ツールの使用方法

すべての例では、RDU のユーザ名は admin、RDU のパスワードは changeme とし、RDU が実行中であることを前提にしています。

次のコマンドを入力して、RDU ログ レベル ツールを実行します。

setLogLevel.sh [0..6] [-help] [-show] [-default] [-debug]

入力する内容は次のとおりです。

• -[0..6] ：使用するログ レベルを示します。利用可能なレベルは、次のとおりです。
• 0：緊急レベルです。すべての緊急メッセージを保存するように、ロギング機能を設定します。
• 1：アラート レベルです。すぐに対応が必要なすべてのアクティビティ、およびさらに深刻な活動を保存するように、ロギング機能を設定します。
• 2：クリティカル レベルです。すべての異常な状態、およびさらに深刻な状態を保存するように、ロギング機能を設定します。
• 3：エラー レベルです。すべてのエラー メッセージ、およびさらに深刻なメッセージを保存するように、ロギング機能を設定します。
• 4：警告レベルです。すべての警告メッセージ、およびさらに深刻なメッセージを保存するように、ロギング機能を設定します。
• 5：通知レベルです。すべての通知レベル メッセージ、およびさらに深刻なメッセージを保存するように、ロギング機能を設定します。
• 6：情報レベルです。利用可能なすべてのロギング メッセージを保存するように、ロギング機能を設定します。
• -help ：ツールのヘルプを表示します。
• -show ：RDU サーバの現在のログ レベル設定を表示します。
• -default ：RDU をインストール デフォルト レベルの 5（通知）に設定します。
• -debug ：RDU サーバのカテゴリのトレースをイネーブルまたはディセーブルにするように、対話モードを設定します。

シスコのサポート スタッフの指示があった場合にのみ、デバッグ設定をイネーブルにしてください。

このツールを使用して、次の機能も実行できます。

• RDU ログ レベルの設定
• RDU の現在のログ レベルの表示

RDU ログ レベルの設定

このツールを使用して、ロギング レベルをある値から別の値に変更できます。次の例では、RDU ロギング レベルを警告レベル（ setLogLevel.sh コマンドでは数値 4 で示されるレベル）に設定する方法を示します。実際のログ レベル設定は手順にとって重要ではないので、必要に応じて読み替えてください。

RDU ロギング レベルを設定するには、次の手順に従います。

<BPR_HOME>/rdu/bin にディレクトリを変更します。

1. 次のコマンドを使用して、RDU ログ レベル ツールを実行します。

setLogLevel.sh 4

次のプロンプトが表示されます。

Please enter RDU username:

1. プロンプトに対して、RDU ユーザ名を入力します。この例では、デフォルト ユーザ名（admin）を使用します。

Please enter RDU username: admin

次のプロンプトが表示されます。

Please enter RDU password:

1. プロンプトに対して、RDU のパスワードを入力します。

この画面プロンプトで入力するパスワードは、画面に表示されません。

次のメッセージが表示され、ログ レベルが変更されたことが通知されます。この例では、レベル 5（通知）から 4（警告）に変更されました。

RDU Log level was changed from 5 (notification) to 4 (warning).

RDU の現在のログ レベルの表示

このツールを使用して、ロギング レベルの値を変更する前に、設定されている値を判別できます。この手順では、ツールを使用して RDU の現在のロギング レベルを表示する方法を示します。

RDU の現在のロギング レベルを表示するには、次の手順に従います。

<BPR_HOME>/rdu/bin にディレクトリを変更します。

1. 次のコマンドを実行します。

setLogLevel.sh -show

次のプロンプトが表示されます。

Please enter RDU username:

1. RDU ユーザ名（admin）を入力し、 Enter キーを押します。

Please enter RDU username: admin

次のプロンプトが表示されます。

Please enter RDU password:

1. RDU パスワード（changeme）を入力し、 Enter キーを押します。

Please enter RDU password: changeme

この画面プロンプトで入力するパスワードは、画面に表示されません。

次のメッセージが表示されます。

The logging is currently set at level: 4 (warning)

All tracing is currently disabled.

PKCert ツールによる KDC 証明書の管理

PKCert ツールを使用して、KDC のオペレーションに必要な KDC 証明書をインストールし、管理できます。このツールは、獲得した CableLabs サービス プロバイダー証明書を取得し、KDC のオペレーションに必要な次のような一連の証明書ファイルに変換します。

• Cablelabs_Service_Provider_Root.cer
• Service_Provider.cer
• Local_System.cer
• KDC.cer

このツールで、証明書チェーンの検証や、KDC が要求する名前へのコピーおよび名前の変更もできます。

このツールは、KDC コンポーネントをインストールした場合にのみ利用可能です。

PKCert ツールの実行

次のコマンドを実行して、デフォルト位置の <BPR_HOME>/kdc ディレクトリで PKCert ツールを実行します。

PKCert.sh [function] [option]

入力する内容は次のとおりです。

• [function] ：実行する機能を示します。たとえば、適切な機能を選択する次のスイッチのいずれかを入力します。
• -c：KDC 証明書を作成します。詳細については、 KDC 証明書の作成 を参照してください。
• -v：PacketCable 証明書セットを検証し、標準化します。詳細については、 KDC 証明書の検証 を参照してください。

これらのオプションの使用方法がわからない場合は、-? オプションを指定すると、利用可能なすべてのヘルプ情報がコンピュータの画面に表示されます。

• [option] ：上で選択した機能に依存するオプション機能を実装します。利用可能なオプションについては、 KDC 証明書の作成 および KDC 証明書の検証 を参照してください。

PKCert コマンドを実行すると、要求された動作の実行中に発生したすべてのエラーのリストが出力されます。このプリントアウトを使用して、発生した可能性があるすべての問題をトラブルシューティングできます。

KDC 証明書の作成

/opt/CSCObpr/kdc ディレクトリから次のコマンドを入力して、KDC 証明書を作成します。

PKCert.sh -c -s <dir> -d <dir> -c <cert> -r <realm> -a <name> -k <keyFile> [-n <serial>] [-o]

入力する内容は次のとおりです。

• -c ：作成機能を使用することを示します。
• -a <name>：KDC の DNS 名を指定します。
• -c <Cert File>：サービス プロバイダー証明書を使用します（DER 符号化）。
• -d <directory>：作成先ディレクトリを指定します。
• -k <Key File>：サービス プロバイダー秘密鍵を使用します（DER 符号化）。
• -n <Serial#>：証明書のシリアル番号を設定します。
• -o：既存のファイルを上書きします。
• -r <Realm>：KDC 証明書の Kerberos 領域を指定します。
• -s <directory>：作成元ディレクトリを指定します。

新しい証明書を作成してインストールするとき、新しい証明書は、subject alternate name フィールドで領域を識別します。新しい証明書は現在の環境に対して、次の項目において一意です。

• KDC 領域。
• MTA が使用する、この KDC に関連付けられた DNS 名。次に例を示します。

PKCert.sh -c "-s . \

-d /opt/CSCObpr/kdc/solaris/packetcable/certificates \

-k CLCerts/Test_LSCA_privkey.der \

-c CLCerts/Test_LSCA.cer \

-r PCTEST.CISCO.COM \

-n 100 \

-a kdc.pctest.cisco.com \

-o"

このコマンドを使用して、ファイル /opt/CSCObpr/kdc/solaris/packetcable/certificates/KDC.cer と /opt/CSCObpr/kdc/solaris/packetcable/certificates/KDC_private_key.pkcs8 を作成します。この KDC 証明書では、realm は PCTEST.CISCO.COM、シリアル番号は 100、KDC サーバの FQDN は kdc.pctest.cisco.com に設定されます。

正常にコマンドが終了すると、ファイル
/opt/CSCObpr/kdc/solaris/packetcable/certificates/KDC_private_key.pkcs8 を
/opt/CSCObpr/kdc/solaris/KDC_private_key.pkcs8 にコピーする必要があることを示すコンソール メッセージが表示されます。コマンドライン オプション -o を使用すると、ユーティリティは既存のファイルを上書きします。

KDC 証明書の検証

このコマンドで、指定した作成元ディレクトリのすべてのファイルを検査し、X.509 証明書として識別します。正規の X.509 証明書が見つかった場合、ファイルは適切な名前に変更され、宛先ディレクトリにコピーされます。特定の目的（サービス プロバイダーまたはデバイス）で、正規の証明書チェーンが複数確認された場合は、エラーが生成されます。この場合は、余分な証明書を作成元ディレクトリから削除し、コマンドを再度実行する必要があります。

PKCert.sh -v -? コマンドを入力すると、PKCert の使用方法が画面に表示されます。

BPR_HOME /kdc ディレクトリから次のコマンドを入力して、KDC 証明書を検証します。

PKCert.sh -v -s <dir> -d <dir> -o -r <dir>

入力する内容は次のとおりです。

• -v ：検証機能を使用することを示します。
• -s <directory>：作成元ディレクトリを指定します。
• -d <directory>：作成先ディレクトリを指定します。
• -o：既存のファイルを上書きします。
• -r <directory>：参照証明書ディレクトリを指定します。

検証は、このパッケージに組み込まれた参照証明書を対象に実行されます。'-d' オプションを指定すると、名前が正規化されて、証明書がターゲット ディレクトリにインストールされます。次に例を示します。

PKCert.sh -v \

"-s . \

-d BPR_HOME /kdc/solaris/packetcable/certificates \

-o"

ChangeNRProperties.sh ツールの使用

BACC インストール プログラムは、Network Registrar DHCP サーバに組み込まれる BACC 拡張で使用する設定プロパティの値を設定します。キー設定プロパティを変更するには、<BPR_HOME>/
cnr_ep/bin ディレクトリにある changeNRProperties.sh コマンドを使用します。

パラメータを付けずにスクリプトを起動すると、設定できるプロパティのリストを示すヘルプ メッセージが表示されます。

コマンドを実行するには、次の手順に従います。

<BPR_HOME>/cnr_ep/bin にディレクトリを変更します。

1. changeNRProperties.sh コマンドを実行します。

changeNRProperties.sh <options>

<options> には、次のものを指定できます。

• -help：このヘルプ メッセージを表示します。-help オプションは、排他的に使用する必要があります。その他のオプションと同時に使用することはできません。
• -e <enable|disable>：PacketCable enable プロパティを設定します。たとえば、 -e enable はプロパティをイネーブルにし、 -e disable はディセーブルにします。
• -d：現在のプロパティを表示します。-d オプションは、排他的に使用する必要があります。その他のオプションと同時に使用することはできません。
• -s <secret>：BACC 共有秘密情報を示します。たとえば、共有秘密情報が単語 secret の場合は、 -s secret と入力します。
• -f <fqdn>：RDU の FQDN を示します。たとえば、完全修飾ドメイン名として rdu.cisco.com を使用する場合は、 -f rdu.cisco.com と入力します。
• -p <port>：使用する RDU ポートを示します。たとえば、ポート番号 49187 を使用する場合は、 -p 49187 と入力します。
• -r <realm>：PacketCable 領域を示します。たとえば、PacketCable realm が CISCO.COM の場合は、 -r CISCO.COM と入力します。

領域は大文字で入力する必要があります。

• -g <prov group>：プロビジョニング グループを示します。たとえば、プロビジョニング グループが group1 の場合は、 -g group1 と入力します。
• -t <00|01>：PacketCable TGT をオフまたはオンに設定することを示します。たとえば、オフに設定する場合は -t 00 と入力し、オンに設定する場合は -t 01 と入力します。
• -a <ip>：PacketCable のプライマリ DHCP サーバ アドレスを示します。たとえば、プライマリ DHCP サーバの IP アドレスが 10.10.10.2 の場合は、 -a 10.10.10.2 と入力します。
• -b <ip>：PacketCable のセカンダリ DHCP サーバ アドレスを示します。たとえば、セカンダリ DHCP サーバの IP アドレスが 10.10.10.4 の場合は、 -b 10.10.10.4 と入力します。必要な場合は、 -b null と入力して、ヌル値を設定することもできます。
• -y <ip>：PacketCable のプライマリ DNS サーバ アドレスを示します。たとえば、PacketCable プライマリ DNS サーバの IP アドレスが 10.10.10.6 の場合は、 -y 10.10.10.6 と入力します。
• -z <ip>：PacketCable のセカンダリ DNS サーバ アドレスを示します。たとえば、セカンダリ DNS サーバの IP アドレスが 10.10.10.8 の場合は、 -z 10.10.10.8 と入力します。必要な場合は、 -z null と入力して、ヌル値を設定することもできます。
• DHCP サーバを再起動します。