- このマニュアルについて
- Broadband Access Center の概要
- Broadband Access Center のアーキ テクチャ
- 設定のワークフロー
- CPE プロビジョニングの概要
- 設定テンプレートの管理
- DOCSIS 設定
- PacketCable 音声設定
- CableHome の設定
- Broadband Access Center の管理
- Broadband Access Center の監視
- 管理者のユーザ インターフェイスに ついて
- 管理者のユーザ インターフェイスの使 用方法
- Broadband Access Center の設定
- サポートするツールと高度な概念
- データベースの管理
- Broadband Access Center のトラブル シューティング
- アラートとエラー メッセージ
- オプションのサポート
- PacketCable DHCP オプションと BAC プロパティのマッピング
- プロビジョニング API の使用例
- Broadband Access Center のプロビ ジョニングに関する FAQ
- 用語集
- 索引
Cisco Broadband Access Center アドミニストレータ ガイド Release 4.0
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2017年5月30日
章のタイトル： 設定テンプレートの管理
設定テンプレートの管理
この章では、Broadband Access Center（BAC）でサポートされる、デバイス構成およびデバイス管理用のテンプレートについて説明します。この章は、次の項で構成されています。
テンプレート ファイル：概要
BAC が使用するテンプレートは、動的 PacketCable、DOCSIS、および CableHome ファイルを配備するときに役立ちます。テンプレートを使用して、読みやすい形式のテンプレート ファイルを作成し、迅速かつ簡単に編集することができます。テンプレートは、有効な PacketCable、DOCSIS、または CableHome ファイルを生成するときに使用する PacketCable、DOCSIS、または CableHome のオプションおよび値を表す ASCII テキスト ファイルです。BAC は .tmpl 拡張子を使用してテンプレート ファイルを識別します。サービス クラスでテンプレート ファイルを参照する前に、管理者のユーザ インターフェイスまたは Application Programming Interface（API; アプリケーション プログラミング インターフェイス）を使用して、ファイルとしてそのテンプレート ファイルを RDU に追加する必要があります。
BAC RDU コンポーネントをインストールするときに、いくつかのサンプル テンプレート ファイルが BPR_HOME/rdu/templates ディレクトリにコピーされます。
テンプレートを作成または編集するために必要なツールは単純なテキスト エディタだけですが、独自のテンプレート ファイルを作成する前に、次の情報を十分に理解しておく必要があります。
•
DOCSIS 1.0、1.1、2.0、および 3.0 RFI の仕様
• DOCSIS レイヤ 2 バーチャル プライベート ネットワークの仕様
• PacketCable 1.0、1.1、および 1.5 の仕様
• Multimedia Terminal Adapter（MTA; マルチメディア ターミナル アダプタ）デバイスのプロビジョニングの仕様
• ケーブル デバイス用の SNMP MIB（DOCS-CABLE-DEVICE-MIB など）
テンプレート文法
• 「コメント」
• 「インクルード」
• 「オプション」
comment 文で、テンプレートに説明を入れることができます。include 文で、他のテンプレートで使用するビルディング ブロック テンプレートを作成できます。オプションを使用して、説明のために PacketCable、DOCSIS、または CableHome の Type Length Value（TLV）を指定します。インスタンス修飾子を使用して、複合オプションを特定の個別 TLV にグループ化できます。OUI 修飾子を使用すると、ベンダー固有の情報を含めることができます。 表5-1 に、利用可能なテンプレート文法のオプションを示します。
|
|
|
|---|---|
::= option <option-num> [instance <instance-num>] [oui <oui>] <option-value> |
|
コメント
コメントは情報のみを提供し、常にシャープ記号（#）から行末までの間に配置されます。例5-1 に、コメントの使用方法の例を示します。
インクルード
インクルード ファイルを使用すると、似ているが少し異なるテンプレートの階層を構築できます。これは、多くのサービス クラスで共通のオプションを定義する場合に、複数のテンプレートでオプションを重複させる必要がなくなり、とても便利です。
単一のテンプレートで複数の include 文を使用できますが、テンプレートの中での include 文の位置は重要です。インクルード ファイルの内容は、テンプレートの中に include 文が見つかった場所で読み込まれます。インクルードするテンプレートは、使用する前にファイルとして RDU に追加する必要があります。テンプレートは RDU データベースにパス情報がない状態で格納されるため、インクルードするファイルには ../.. などの位置修飾子を含めることができません。例5-2 と例5-3 は、それぞれ、インクルード オプションの正しい使用方法と誤った使用方法を示しています。
オプション
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 に符号化されます。
• SNMPVarBind：SNMP OID 文字列、タイプ、および値。これらはそれぞれカンマで区切られます。
1 行に複数の値があるオプションでは、カンマを使用して値を区切ります。それぞれの値は別個に扱われるので、場合によっては値の 1 つを二重引用符で囲む必要がありますが、他の値を囲む必要はありません。複数の値を持つオプションの例として、Option 11（SNMP VarBind）があります。詳細については、「SNMP VarBind」を参照してください。
複合オプションを指定するときは、トップ レベル オプション（Option 4.1 を指定するときの Option 4 など）を指定する必要がありません。例5-4 と例5-5 は、それぞれ option 文の正しい使用方法と誤った使用方法を示しています。
インスタンス修飾子
インスタンス修飾子は、複合オプションを特定の個別 TLV にグループ化するために使用します。例5-6 と例5-7 は、それぞれ、個別の TLV を作成する正しい方式と誤った方式を示しています。IOS コマンドを 2 つの個別のコマンドとして解釈するために、IOS DOCSIS モデムをイネーブルにする必要があります。
（注） Option 43.8 の符号化タイプは、Organizationally Unique Identifier（OUI）です。例5-4 に示されている例とは異なり、このタイプは 00-00-0C 形式のみ受け入れます。
OUI 修飾子
OUI 修飾子は、Option 43 とそのサブオプションを使用して、マルチベンダーのサポートを強化します。
BAC 4.0 では、単一のテンプレートを使用して、多くのベンダーのさまざまな TLV 43 を指定できます。 例5-8 は、OUI 形式を XX-XX-XX として指定します。
• FF-FF-FF：DOCSIS 一般拡張の符号化を指定するベンダー ID を示します。
• 00-00-0C：シスコ固有のケーブル モデム Option 43 とそのサブオプションを指定するシスコ ベンダー ID を示します。
例5-8 は、L2VPN のアップストリーム トラフィックを分類するためにケーブル モデム設定ファイルを使用する、L2VPN の BAC サポートを示しています。このテンプレートの内容を使用して、次のサブ TLV を生成できます。
• OUI=FF-FF-FF を使用する、DOCSIS 一般拡張の符号化の 43.5.1 と 43.5.2.2。
• OUI=00-00-0C を使用する、シスコ固有の Option 43 の 43.1。
ただし、DOCSIS の仕様に準拠するために、TLV 43 の最初の サブ TLV として次のいずれかを挿入する必要があります。
• 一般拡張情報を符号化するために DOSCIS 拡張フィールドを使用する場合は、0xFFFFFF。
• シスコ固有の subTLV を生成する場合は、0x00000C。
例5-9 と例5-10 は、OUI 修飾子の誤った使用方法を示しています。
SNMP VarBind
DOCSIS Option 11、PacketCable Option 64、または CableHome Option 28 を指定するときは、Object Identifier（OID）を使用する必要があります。OID を含む MIB は、RDU がロードする次の MIB のいずれかに存在する必要があります。オブジェクトを一意に識別するために必要な数の OID を指定する必要があります。OID の名前または番号を使用できます。RDU は、次の MIB を自動的にロードします。
DOCSIS MIB
これらの DOCSIS MIB は、次の RDU にロードされます。
• DOCS-CABLE-DEVICE-MIB-OBSOLETE
RDU にロードされる DOCS-CABLE-DEVICE MIB には、2 つのバージョンがあります。
• DOCS-CABLE-DEVICE-MIB-OBSOLETE（実験的ブランチ）
• DOCS-CABLE-DEVICE-MIB（mib2 ブランチ）
完全修飾された MIB OID（.experimental...）は常に、MIB OID を一意に識別します。
DOCS-CABLE-DEVICE-MIB のうち、完全修飾されていない MIB OID を使用する場合、MIB OID は常に、デフォルトで DOCS-CABLE-DEVICE-MIB に設定されます（DOCS-CABLE-DEVICE-MIB-OBSOLETE には設定されません）。
例5-11 と例5-12 は、それぞれ、完全修飾された MIB OID と完全修飾されていない MIB OID の使用方法を示しています。
Entry.docsDevNmAccessStatus.1, Integer, 4
例5-12 完全修飾されていない MIB OID（デフォルトで DOCS-CABLE-DEVICE-MIB に設定される）
配備中の DOCSIS CM が DOCS-CABLE-DEVICE-MIB-OBSOLETE を要求しない場合は、常に短縮形の MIB OID を使用できます。
PacketCable MIB
CableHome MIB
次の CableHome MIB が RDU にロードされます。
次の追加 MIB が必要ですが、BAC 製品の一部ではありません。
マクロ変数
マクロ変数はテンプレートで値として指定され、これを使用してデバイス固有のオプション値を指定できます。マクロ変数がテンプレートにあると、プロパティ階層でマクロ変数名が検索され、変数の値が代入されます。変数名はカスタム プロパティで、事前に RDU に定義します。スペースは使用できません。
（注） マクロ変数のカスタム プロパティを使用する場合は、DataType.STRING を使用する必要があります。
カスタム プロパティを定義すると、次のプロパティ階層で使用できるようになります。
• テクノロジー デフォルト（PacketCable、DOCSIS、CableHome など）
テンプレート パーサーは、階層の下から上にプロパティを検索し（最初はデバイス、次にサービス クラス）、テンプレート オプション構文に変換します。マクロ変数をサポートする構文は次のとおりです。
• ${var-name}：この構文は、単純な代入です。変数が見つからない場合、パーサーはエラーを生成します。
• ${var-name, ignore}：この構文では、変数値がプロパティ階層で見つからなかった場合、テンプレート パーサーはこのオプションを無視します。
• ${var-name, default-value}：この構文では、変数がプロパティ階層で見つからなかった場合に、デフォルト値が使用されます。
例5-13 と例5-14 は、それぞれ Option 11 の正しい使用方法と誤った使用方法を示しています。
SNMP TLV
BAC は、Option 11 および 64 を使用して、動的テンプレート ファイルの SNMP TLV をサポートします。次のものが対象です。
• DOCSIS：Broadband Access Center for Cable（BACC）バージョン 2.0 以降。
• PacketCable：BACC バージョン 2.5 以降。
• CableHome：BACC バージョン 2.6 以降。
これらのテンプレート ファイルの SNMP TLV の構文を検証する場合、BAC は SNMP TLV で参照される対応する SNMP OID を含む MIB ファイルを必要とします。テンプレートに、MIB で検出できない SNMP OID を備えた SNMP TLV が含まれている場合、SNMP TLV は構文エラーを生成します。
次の各項では、MIB を使用しない SNMP TLV、またはベンダー固有の MIB を使用した SNMP TLV の追加方法について説明します。
MIB を使用しない SNMP TLV の追加
RDU で MIB をロードしなくても、動的設定ファイル（DOCSIS、PacketCable、CableHome）に SNMP TLV を追加できます。次の方法を使用すると、RDU 設定の拡張から、DOCSISOptionFactory インターフェイスを使用して機能にアクセスできます。
上記の方法では、public OptionSyntax.SNMP 列挙値を、OID、Type、Value という値のセットを含む optionValueList と組み合せて使用できます。
RDU 動的設定テンプレートから、次の構文を使用して、RDU MIB に対して検証されていない SNMP TLV を指定します。
表5-2 は、利用可能な SNMP 変数タイプの名前です。
|
|
|
|---|---|
たとえば、SMI Integer32 タイプを指定する場合は、Integer32 および INTEGER タイプが利用可能です（大文字と小文字は区別されません）。
OCTET STRING タイプの場合は、OCTET STRING、OCTETSTRING、または STRING タイプがすべて利用可能です。
カスタム SNMP TLV テンプレート オプションを使用して、任意の SNMP TLV（RDU MIB に存在するものを含む）を指定することができます。カスタム SNMP TLV エラー チェックはあまり厳しくないため、誤ったスカラー/テーブルの参照は検出されません（たとえば、OID 名における .0 と .n の区別）。
ベンダー固有の MIB を使用した SNMP TLV の追加
MIB を RDU に追加すると、テンプレートで人間が判読可能な SNMP OID を使用できるようになり、さらに、マクロ変数に SNMP TLV 値を使用できるようになります。
使用する SNMP OID に対応する MIB を保持している場合、MIB ファイルを BAC RDU に追加できます。MIB を追加後、新しい MIB で参照される SNMP OID を使用する SNMP TLV が認識されます。
新しい MIB を RDU に追加するには、次の手順に従います。
ステップ 1 新しい MIB ファイルを BPR_HOME/rdu/mibs ディレクトリにコピーします。
ステップ 2 /docsis/mibs/custom/mibList プロパティを次の場所にコピーします。このプロパティ値には、MIB ファイル名のカンマ区切りリストが含まれます。
a. rdu.properties ファイル。このファイルは、RDU と管理者のユーザ インターフェイスが使用します。このファイルは BPR_HOME/rdu/conf ディレクトリにあります。
b. api.properties ファイル。このファイルは設定ファイル ユーティリティ（runCfgUtil.sh ツール）が使用します。
（注） api.properties ファイルは、BAC のインストール処理では作成されません。このファイルは、初めて使用するときに任意のテキスト エディタを使用して手動で作成する必要があります。このファイルは BPR_HOME/rdu/conf ディレクトリに置いてください。
api.properties ファイルには、/docsis/mibs/custom/mibList が含まれます。これは、Arris embedded MTA（eMTA）で使用できる MIB のセット用に設定されます。
ステップ 3 /etc/init.d/bprAgent restart rdu コマンドを使用して、BAC プロセス ウォッチドッグ経由で RDU を再起動します。
次の例では、ARRIS MTA を設定するためにテンプレートで使用する追加の ARRIS MIB について説明しています。
Arris ベンダー固有の SNMP TLV 使用すると仮定します。
option 11 .ppCfgMtaCountryTemplate.0, INTEGER, 9
MIB ファイルを BPR_HOME/rdu/mibs ディレクトリにコピーし、次のプロパティを api.properties ファイルと rdu.properties ファイルに挿入する必要があります。
/docsis/mibs/custom/mibList=ARRIS-MIB,ARRIS-CM-CAPABILITY-MIB,ARRIS-CM-DEVICE-MIB,ARRIS-MTA-DEVICE-MIB,PACKETPORT-MIB
（注） BACC 2.7 以降では、/docsis/mibs/custom/mibList プロパティは、/snmp/mibs/mibList に名前が変更されています。
使用する SNMP OID に対応する MIB を保持している場合、MIB ファイルを BAC RDU に追加できます。MIB を追加後、新しい MIB で参照される SNMP OID を使用する SNMP TLV が認識されます。
新しい MIB を BAC RDU に追加するには、次の手順に従います。
ステップ 1 BAC 管理者のユーザ インターフェイスを起動します。
ステップ 2 ナビゲーション バーで、 Configuration > Defaults をクリックします。
ステップ 3 表示される Configure Defaults ページの左ペインにある System Defaults リンクをクリックします。
ステップ 4 MIB List フィールドの末尾に新しい MIB の内容を貼り付けます。
（注） バージョン 2.7 以降では、MIB の解析ツールは強化されています。その結果、以前はエラーなしで解析されていた MIB のバージョンで時々エラーが返されるようになりました。エラーが発生し、新しい MIB を編集することで解決できない場合は、Cisco Technical Assistance Center にお問い合せください。
一般に、ベンダーが提供するさまざまな MIB は、MIB 間の依存関係を満たすために特定の順番でロードする必要があります。ただし、多くの場合、ベンダーは正しいロード順を提供しないので、ユーザ自身が正しいロード順を決定する必要があります。この項では、BAC のデバッグ情報を使用して、MIB のロード順の問題を解決する方法について説明します。
（注） BAC 内の MIB のロード順は、次のプロパティにリストされている MIB の順番で設定されます。
• /docsis/mibs/custom/mibList プロパティ（BACC 2.6.x 以前のリリースを使用している場合）。
• /snmp/mibs/MibList プロパティ（BACC 2.7.x 以降のリリースを使用している場合）。
runCfgUtil.sh ツールを使用して、 api.properties ファイルで指定されているプロパティの正しいロード順を判断できます。runCfgUtil.sh ツールは、 BPR_HOME/rdu/bin ディレクトリにあります。
（注） この手順では、BACC 2.7.x 以降のリリースで使用する /snmp/mibs/MibList プロパティを参照します。2.6.x 以前のリリースを実行している場合は、 /docsis/mibs/custom/mibList プロパティを使用してください。
ステップ 1 api.properties ファイルを使用して Configure runCfgUtil.sh を設定し、このステップで説明されているのと同様の設定内容を使用します。 api.properties ファイルは、BAC トレースをイネーブルにし、MIB デバッグ情報をユーザ コンソールに送信します。
ステップ 2 runCfgUtil.sh をこのように設定し、ツールを実行して、Option 11 または Option 64（SNMP 符号化）を含んでいる任意のテンプレートを符号化します。ツールは、/snmp/mibs/MibList 内で指定されている MIB のロードを試み、MIB のロード エラーとともに完全なデバッグ情報をユーザ コンソールに送信します。
ステップ 3 エラー情報を使用して、MIB の全セットがエラーなしでロードされ、ファイルの符号化が成功するまで、/snmp/mibs/MibList 内で指定されている MIB の順番を変更します。
ステップ 4 正常なロード順を決定したら、使用している BACC のバージョンに基づき、このステップで説明されている手順を実行します。
a. 管理者のユーザ インターフェイスから、 Configuration > Defaults をクリックして、System Defaults リンクをクリックします。
b. MIB List フィールドに、ロード順の情報をコピーします。
これで、RDU はベンダー提供の MIB を使用してテンプレートを符号化するように設定されます。
（注） RDU を再起動する必要はありません。
api.properties ファイルと MIB List フィールドでは、/snmp/mibs/mibList 文字列を使用してください。
a. rdu.properties ファイルの /docsis/mibs/custom/mibList プロパティにロード順の情報をコピーします。このファイルは BPR_HOME/rdu/conf ディレクトリにあります。
b. /etc/init.d/bprAgent restart rdu コマンドを使用して、BAC プロセス ウォッチドッグ経由で RDU を再起動します。
これで、RDU はベンダー提供の MIB を使用してテンプレートを符号化するように設定されます。
定義済みオプションの符号化タイプ
表5-3 に、定義済み符号化タイプを持つオプションを示します。
BITS 値の構文
BITS 型を使用する場合は、ラベル（「interval1 interval2 interval3」）または数値による位置（「0 1 2」）を指定する必要があります。ラベル値は 1 ベースで、ビット値は 0 ベースであることに注意してください。
ラベルを使用するカスタマー オクテット文字列（FFFE000000000000）の構文を示します。
OCTETSTRING の構文
OCTETSTRING は、末尾に NULL を含まない 16 進表記に変換される文字列（オクテット文字列など）または一重引用符で囲まれた 16 進表記（'aa:bb:cc' など）です。
設定ファイル ユーティリティの使用方法
設定ファイル ユーティリティを使用して、PacketCable 1.0/1.1/1.5、DOCSIS 1.0/1.1/2.0/3.0、および CableHome のテンプレート ファイルと設定ファイルをテスト、検証、および表示できます。これらの作業は、独自の設定ファイルを正常に展開するために重要です。テンプレートの詳細については、「テンプレート ファイル：概要」を参照してください。
設定ファイル ユーティリティは、RDU をインストールしたときにのみ利用可能です。このユーティリティは BPR_HOME/rdu/bin ディレクトリにインストールされます。
符号化するテンプレート ファイルとデコードするバイナリ ファイルの両方が、設定ファイル ユーティリティを起動するディレクトリに存在する必要があります。
この項のすべての例では、RDU が運用中で、次の条件が適用されていることを前提にしています。
• BAC アプリケーションは、デフォルトのホームディレクトリ（ /opt/CSCObac ）にインストールされています。
• RDU ログイン パスワードは changeme です。
（注） この項の例では、一部が出力例にとって重要でない場合に、その部分を省略していることがあります。その場合は、例中のサマリーの直前に省略記号（...）を示しています。
• 「ローカル テンプレート ファイルのテンプレート処理のテスト」
• 「外部テンプレート ファイルのテンプレート処理のテスト」
• 「マルチベンダーをサポートするための TLV 43 の生成」
設定ファイル ユーティリティの実行
次の手順と例で、「設定ファイル ユーティリティを実行する」というフレーズは、指定されたディレクトリから runCfgUtil.sh コマンドを入力することを意味します。設定ファイル ユーティリティを実行するには、 BPR_HOME/rdu/bin ディレクトリから次のコマンドを実行します。
• -c secret ：DOCSIS テンプレート ファイルを解析するときの CMTS 共有秘密情報を指定します。デフォルトの共有秘密情報を指定するには、- c cisco と入力します。
• -cablehome ：入力ファイルが CableHome ポータル サービス設定ファイルであることを示します。 -docsis または -pkt オプションと同時に使用することはできません。
• -d ：バイナリ入力ファイルをデコードします。 -e オプションと同時に使用することはできません。
• -docsis ：入力ファイルが DOCSIS 設定ファイルであることを指定します。このデフォルトを -pkt オプションと同時に使用することはできません。
• -v version ：使用している DOCSIS のバージョンを指定します。たとえば、DOCSIS 1.1 を使用している場合は、 -v 1.1 と入力します。バージョン番号を指定しない場合、コマンドはデフォルトで DOCSIS 2.0 を使用します。BAC がサポートする値は 1.0、1.1、2.0、および 3.0 です。
• -e ：テンプレート入力ファイルを符号化します。このデフォルトを -d オプションと同時に使用することはできません。
• -g ：DOCSIS、PacketCable、または CableHome バイナリ ファイルからテンプレート ファイルを生成します。
• -h host:port ：ホストとポート番号を指定します。デフォルトのポート番号は 49187 です。
• -i device-id ：テンプレート解析中にマクロ変数を代入するときに使用するデバイスを示します。たとえば、デバイス MAC アドレスが 1,6,00:00:00:00:00:01 の場合は、 -i 1,6,00:00:00:00:00:01 と入力し、デバイス DUID が 00:03:00:01:00:18:68:52:75:c0 の場合は、
-i 00:03:00:01:00:18:68:52:75:c0 と入力します。このオプションを使用するときは、 -u および -p オプションを使用して、それぞれユーザ名とパスワードを指定する必要もあります。 -m オプションと同時に使用することはできません。
• -l filename ：入力ファイルがローカル ファイル システムにあることを示します。たとえば、入力ファイルの名前が any_file の場合、 -l any_file と入力します。 -r オプションと同時に使用することはできません。
• -loc ：PacketCable のロケールを na （北アメリカ）または euro （ヨーロッパ）に指定します。デフォルトは na です。MTA が euro-MTA の場合は、ロケールを euro に設定する必要があります。
• -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 オプションと同時に使用することはできません。
• -r filename ：入力ファイルが RDU に追加したリモート ファイルであることを示します。たとえば、ファイル名が file25 の場合は、- r file25 と入力します。このオプションを使用するときは、 -u および -p オプションを使用して、それぞれユーザ名とパスワードを指定する必要もあります。 -l オプションと同時に使用することはできません。
• -s ：解析されたテンプレートまたはバイナリ ファイルの内容を人間が判読可能な形式で表示します。
• -t ：PacketCable 符号化タイプを Secure または Basic に指定します（デフォルトは Secure）。
• -u username ：RDU に接続するときに使用するユーザ名を指定します。たとえば、ユーザ名が admin の場合、 -u admin と入力します。
（注） 設定ファイル ユーティリティでは、テンプレート ファイルに Option 19（TFTP サーバ タイムスタンプ）と Option 20（TFTP サーバのプロビジョニングされたモデム アドレス）は含まれません。ただし、BAC TFTP 混在では含まれます。また、options 6（CM MIC）および 7（CMTS MIC）はどちらも、符号化されたテンプレート ファイルに自動的に挿入されます。そのため、これらの Message Integrity Check（MIC; メッセージ完全性チェック）を指定する必要はありません。
BAC へのテンプレートの追加
設定ファイル ユーティリティを使用して、BAC テンプレートをテストするには、次の手順に従います。
ステップ 1 「テンプレート ファイル：概要」の説明に従い、テンプレートを作成します。テンプレートに他のテンプレートを含める場合は、参照されるテンプレートすべてが同一のディレクトリにあることを確認します。
ステップ 2 ローカル ファイル システムで設定ファイル ユーティリティを実行します。テンプレートの構文をチェックするか、または CRS と同じ方法で設定ファイル ユーティリティにテンプレートを処理させた後、出力を返すことができます。
テンプレートにマクロ変数が含まれる場合、指定された順番で次の操作を実行します。
ステップ 3 テンプレート（および、そのテンプレートにインクルードするテンプレート）を RDU に追加します。
ステップ 4 設定ファイル ユーティリティを実行して、ファイルを解析します。「外部テンプレート ファイルのテンプレート処理のテスト」を参照してください。
テンプレートにマクロ変数が含まれる場合、指定された順番で次の操作を実行します。
ステップ 5 テストが成功したら、そのテンプレートを使用するサービス クラスを設定します。
テンプレート ファイルへのバイナリ ファイルの変換
runCfgUtil.sh コマンドを使用して、バイナリ設定メモリ ファイルをテンプレート ファイルに変換します。BAC の動的構成生成は、作成されるテンプレートに基づきます。既存のテスト済みバイナリ ファイルをテンプレート ファイルに自動的に変換すると、プロセスの速度が向上し、エラーが発生する可能性は低下します。
シンタックスの説明
runCfgUtil.sh -g -l binary_file -o template_file
• -g ：入力バイナリ ファイルからテンプレート ファイルを生成する必要があることを指定します。
• -l binary_file ：ローカル入力ファイル（パス名を含む）を指定します。すべての場合において、入力バイナリ ファイルの名前には .cm ファイル拡張子が割り当てられます（たとえば、 bronze.cm ）。
• -o template_file ：出力テンプレート ファイル（パス名を含む）を指定します。すべての場合において、出力テンプレート ファイルの名前には .tmpl ファイル拡張子が割り当てられます（たとえば、 test.tmpl ）。
バイナリ ファイルをテンプレート ファイルに変換するには、次の手順に従います。
ステップ 1 /opt/CSCObac/rdu/samples/docsis にディレクトリを変更します。
ステップ 2 使用するテンプレート ファイルを選択します。この例では、既存のバイナリ ファイル unprov.cm を使用します。
ステップ 3 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -g -l unprov.cm -o test.tmpl -docsis
-docsis ：入力ファイルを DOCSIS 設定ファイルにすることを指定します。
ローカル テンプレート ファイルのテンプレート処理のテスト
runCfgUtil.sh コマンドを使用して、ローカル ファイル システムに格納されているテンプレート ファイルの処理をテストします。
シンタックスの説明
• -pkt ：入力ファイルが PacketCable MTA ファイルであることを示します。
• -l ：入力ファイルがローカル ファイル システムにあることを指定します。
• file ：解析する入力テンプレート ファイルを示します。
ローカル ファイル システムにあるテンプレート ファイルを解析するには、次の手順に従います。
ステップ 1 /opt/CSCObac/rdu/samples/packet_cable にディレクトリを変更します。
ステップ 2 使用するテンプレート ファイルを選択します。この例では、既存のテンプレート ファイル unprov_packet_cable.tmpl を使用します。これは PacketCable MTA テンプレートであるため、 -pkt オプションを使用します。
ステップ 3 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -pkt -l unprov_packet_cable.tmpl
unprov_packet_cable.tmpl ：解析する入力テンプレート ファイルを示します。
外部テンプレート ファイルのテンプレート処理のテスト
シンタックスの説明
runCfgUtil.sh -docsis -r file -u username -p password
• -r ：入力ファイルが RDU に追加したファイルであることを示します。
• file ：解析する入力テンプレート ファイルを示します。
• -u username ：RDU に接続するときに使用するユーザ名を指定します。
• -p password ：RDU に接続するときに使用するパスワードを指定します。
• -docsis ：ファイルが DOCSIS テンプレートであることを示します。
RDU に追加したテンプレート ファイルを解析するには、次の手順に従います。
ステップ 1 使用するテンプレート ファイルを選択します。この例では、既存のテンプレート ファイル
unprov.tmpl を使用します。DOCSIS テンプレートを使用するため、 -docsis オプションを使用します。
ステップ 2 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -docsis -r unprov.tmpl -u admin -p changeme
（注） ここに表示されている結果は説明のためだけのものであり、簡潔にするために省略されています。
ローカル テンプレート ファイルのテンプレート処理のテストと共有秘密情報の追加
runCfgUtil.sh コマンドを使用して、テンプレート ファイルの処理をテストし、指定する共有秘密情報を追加します。
シンタックスの説明
runCfgUtil.sh -e -docsis -l file -c secret
• -docsis ：入力ファイルが DOCSIS テンプレート ファイルであることを示します。
• -l ：入力ファイルがローカル ファイル システムにあることを指定します。
• file ：解析する入力テンプレート ファイルを示します。
• -c ：DOCSIS テンプレート ファイルを解析するときの CMTS 共有秘密情報を指定します。
• secret ：新しい共有秘密情報を示します。デフォルトの共有秘密情報は cisco です。
ローカルに保存したテンプレート ファイルを解析し、ユーザ固有の共有秘密情報を設定するには、次の手順に従います。
ステップ 1 /opt/CSCObac/rdu/templates にディレクトリを変更します。
ステップ 2 解析するテンプレート ファイルを選択します。この例では、既存のテンプレート ファイル unprov.tmpl を使用します。これは DOCSIS テンプレートであるため、 -docsis オプションを使用します。
ステップ 3 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -e -docsis -l unprov.tmpl -c shared
• unprov.tmpl ：ローカル ファイル システムの入力ファイルを示します。
コマンドラインでのマクロ変数の指定
シンタックスの説明
runCfgUtil.sh -e -l file -m "macros"
• -l ：入力ファイルがローカル ファイル システムにあることを指定します。
• file ：解析する入力テンプレート ファイルを示します。
• -m ：テンプレートを解析するときに代入するマクロ変数を指定します。
• "macros" ：目的のマクロを示します。複数のマクロ変数が必要な場合は、各マクロの間に 2 つのカンマを挿入します。
コマンドラインでマクロ変数の値を指定するには、次の手順に従います。
ステップ 1 /opt/CSCObac/rdu/templates にディレクトリを変更します。
ステップ 3 テンプレートのマクロ変数を特定します。この例のマクロ変数は、macro1（option 3）と macro11（option 4.2）です。
ステップ 4 マクロ変数の値を特定します。macro1 の値を 1 に設定し、macro11 の値を 64000 に設定します。
ステップ 5 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -e -l macro.tmpl -m "macro1=1,,macro11=64000"
• macro1=1,,macro11=64000 ：マクロ変数のキーと値のペアを示します。複数のマクロ変数が必要なため、キーと値のペアの間に 2 つのカンマを挿入して区切ります。
マクロ変数のデバイスの指定
シンタックスの説明
runCfgUtil.sh -e -r file -i MAC -u username -p password
• -r ：入力ファイルが RDU に追加したファイルであることを示します。
• file ：解析する入力テンプレート ファイルを示します。
• -i ：マクロ変数を解析するときに使用するデバイスを指定します。
• -u username ：RDU に接続するときに使用するユーザ名を指定します。
• -p password ：RDU に接続するときに使用するパスワードを指定します。
マクロ変数の代入に使用するデバイスを指定するには、次の手順に従います。
ステップ 1 使用するテンプレート ファイルを選択します。この例では、既存のテンプレート ファイル macro.tmpl を使用します。
ステップ 2 テンプレートのマクロ変数を特定します。この例のマクロ変数は、macro1（option 3）と macro11（option 4.2）です。
ステップ 3 使用するデバイスを調べます。この例では、デバイスが RDU に存在し、マクロ変数がプロパティとして設定されているものとします。macro1 の値を 1 に設定し、macro11 の値を 64000 に設定します。
ステップ 4 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -e -r macro.tmpl -i "1,6,00:01:02:03:04:05" -u admin -p changeme
• 1,6,00:01:02:03:04:05 ：デバイスの MAC アドレスを示します。この MAC アドレスは、例として示す目的でのみ使用しています。
バイナリ ファイルへの出力の指定
シンタックスの説明
runCfgUtil.sh -l input_file -o output_file
• -l ：入力ファイルがローカル ファイル システムにあることを指定します。
• input_file ：解析する入力テンプレート ファイルを示します。
• -o ：解析するテンプレート ファイルをバイナリ ファイルとして保存することを指定します。
• output_file ：解析するテンプレート ファイルのバイナリ コンテンツを格納するファイル名を示します。
テンプレートを解析してバイナリ ファイルに出力するように指定するには、次の手順に従います。
ステップ 1 /opt/CSCObac/rdu/templates にディレクトリを変更します。
ステップ 3 出力ファイルの名前を指定します。この例では unprov.cm を使用します。
ステップ 4 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -l unprov.tmpl -o unprov.cm
• unprov.tmpl ：バイナリ ファイルに解析結果を出力する、既存のテンプレート ファイルを示します。
• unprov.cm ：使用する出力ファイル名を示します。
ローカル バイナリ ファイルの表示
シンタックスの説明
• -d ：このコマンドでバイナリ入力ファイルを表示するためにデコードすることを指定します。
• -l ：入力ファイルがローカル ファイル システムにあることを示します。
• file ：表示する既存のバイナリ入力ファイルを示します。
ローカル ファイル システムにあるバイナリ ファイルを表示するには、次の手順に従います。
ステップ 1 /opt/CSCObac/rdu/samples/packet_cable にディレクトリを変更します。
ステップ 3 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -d -l unprov_packet_cable.bin
unprov_packet_cable.bin ：表示する既存のバイナリ入力ファイルを示します。
外部バイナリ ファイルの表示
シンタックスの説明
runCfgUtil.sh -d -r file -u username -p password
• -d ：このコマンドでバイナリ入力ファイルを表示するためにデコードすることを指定します。
• -r ：入力ファイルが RDU に追加したファイルであることを示します。
• file ：RDU にある既存のバイナリ ファイルを示します。
• -u username ：RDU に接続するときに使用するユーザ名を指定します。
• -p password ：RDU に接続するときに使用するパスワードを指定します。
RDU に追加したバイナリ ファイルを表示するには、次の手順に従います。
ステップ 1 表示するバイナリ ファイルを選択します。この例では、既存のバイナリ ファイル unprov.cm を使用し、RDU が localhost:49187 であることを前提にしています。
ステップ 2 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -d -r unprov.cm -u admin -p changeme
• unprov.cm ：RDU にある既存のバイナリ ファイルを示します。
PacketCable Basic フローの有効化
runCfgUtil.sh コマンドを使用して、PacketCable Basic フローの完全性ハッシュを生成し、BASIC フローの静的設定ファイルに挿入することをサポートします。
シンタックスの説明
runCfgUtil.sh -t { basic | secure } -pkt -r filename -u username -p password
• basic ：PacketCable Basic フローの完全性ハッシュを計算し、MTA 静的設定ファイルに挿入します。
• secure ：PacketCable Basic フローの完全性ハッシュを MTA 静的設定ファイルに挿入しません。これはデフォルト設定です。
• -r ：入力ファイルが RDU に追加したファイルであることを示します。
• -u username ：RDU に接続するときに使用するユーザ名を指定します。
• -p password ：RDU に接続するときに使用するパスワードを指定します。
• -pkt ：入力ファイルが PacketCable MTA 設定ファイルであることを示します。
PacketCable Basic フローの完全性ハッシュを生成し、Basic フローの静的設定ファイルに挿入することをサポートするには、次の手順に従います。
ステップ 1 PacketCable Basic フローの完全性ハッシュを挿入する Basic フローの静的設定ファイルを選択します。この例では example_mta_config.tmpl を使用します。
ステップ 2 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -t basic -pkt -r example_mta_config.tmpl -u admin -p changeme
• example_mta_config.tmpl ：Basic フローの静的設定ファイルを示します。
.tmpl 拡張子付きのファイルは、動的設定テンプレートであると見なされます。このテンプレートに対し、テンプレート処理中に Basic ハッシュの計算と挿入が透過的に発生します。その結果、同じテンプレートを Secure モードと Basic モードのプロビジョニングで使用できます。
ただし、ハッシュを挿入する前に、Secure 静的バイナリ設定ファイルを Basic 静的設定ファイルに変換する場合は、次の手順に従います。
a. 次のコマンドを使用して、Secure 静的ファイルをテンプレートに変換します。
# runCfgUtil -l input_static_filename -pkt -g -o output_template_filename
b. 次のコマンドを使用して、Secure 静的テンプレートを Basic 静的設定ファイルに変換します。
# runCfgUtil -t basic -l input_template_name -pkt -o output_Basic_static_filename
このコマンドは、Basic の完全性ハッシュを計算して、Basic 静的設定ファイルに挿入します。
マルチベンダーをサポートするための TLV 43 の生成
シンタックスの説明
runCfgUtil.sh -docsis -r filename -u username -p password
• -docsis ：入力ファイルが DOCSIS テンプレート ファイルであることを示します。
• filename ：解析する入力テンプレート ファイルを示します。
• -r ：入力ファイルが RDU に追加したファイルであることを示します。
• -u username ：RDU に接続するときに使用するユーザ名を指定します。
• -p password ：RDU に接続するときに使用するパスワードを指定します。
RDU に追加したテンプレート ファイルを使用して TLV 43 を生成するには、次の手順に従います。
ステップ 1 使用するテンプレート ファイルを選択します。この例では、既存のテンプレート ファイル test.tmpl を使用します。DOCSIS テンプレートを使用するため、 -docsis オプションを使用します。
ステップ 2 次のコマンドを使用して、設定ファイル ユーティリティを実行します。
/opt/CSCObac/rdu/bin# runCfgUtil.sh -docsis -r test.tmpl -u admin -p changeme
• test.tmpl ：DOCSIS 設定ファイルを示します。
フィードバック