- このマニュアルについて
- 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）の保守、および製品のインストール、配備、使用の高速化と改善に役立つツールとその使用方法について説明します。
•
「changeNRProperties.sh ツールの使用方法」
（注） この項では、ツールの使用方法の例をいくつか示します。多くの場合、ツールのファイル名には BPR_HOME と指定されたパスが含まれます。これは、デフォルトのホーム ディレクトリ位置を示しています。
BAC ツール
BAC には、特定の機能をより効率的に実行するための自動ツールが用意されています。 表14-1 に、この BAC リリースでサポートされている各種ツールを示します。
PKCert.sh ツールの使用方法
PKCert ツールにより、KDC 証明書とそれに対応する秘密鍵を作成します。また、証明書チェーンを検証し、コピーして、名前を KDC で要求される名前に変更することもできます。
（注） このツールは、KDC コンポーネントがインストールされている場合にのみ使用可能です。
PKCert ツールの実行
PKCert ツールを動作させるには PKCert.sh コマンドを実行します。このコマンドは、デフォルトで BPR_HOME/kdc ディレクトリにあります。
シンタックスの説明
• function ：実行する関数を指定します。次のオプションを選択できます。
– -c ：KDC 証明書を作成します。「KDC 証明書の作成」を参照してください。
– -v ：PacketCable 証明書セットを検証および正規化します。「KDC 証明書の検証」を参照してください。
– -z ： pkcert.log ファイルに保存されるデバッグ出力のログ レベルを設定します。「デバッグ出力のログ レベルの設定」を参照してください。
（注） これらのオプションの使用方法が不明な場合は、-? と指定してヘルプ情報を表示できます。
KDC 証明書の作成
ステップ 1 /opt/CSCObac/kdc にディレクトリを変更します。
ステップ 2 次の構文を使用して PKCert.sh ツールを実行します。
PKCert.sh -s dir -d dir -c cert -e -r realm -a name -k keyFile [ -n serial# ] [ -o ]
• -c cert ：サービス プロバイダーの証明書（DER 暗号化）を使用します
• -e ：証明書を Euro-PacketCable 証明書として指定します
• -r realm ：KDC 証明書の Kerberos レルムを指定します
• -k keyFile ：サービス プロバイダーの秘密鍵（DER 暗号化）を使用します
• -n serial# ：証明書のシリアル番号を設定します
新しい証明書が作成およびインストールされると、その新しい証明書により、サブジェクトの代替名フィールドのレルムが指定されます。新しい証明書は現在の環境に対して固有であり、その環境には次の要素が含まれます。
• マルチメディア ターミナル アダプタ（MTA）が使用する KDC に関連付けられた DNS 名。
例
-k CLCerts/Test_LSCA_privkey.der -c CLCerts/Test_LSCA.cer -r PCTEST.CISCO.COM -n 100
-a kdc.pctest.cisco.com -o"
このコマンドを使用すると、 /opt/CSCObac/kdc/solaris/packetcable/certificates/KDC.cer ファイルと /opt/CSCObac/kdc/solaris/packetcable/certificates/KDC_private_key.pkcs8 ファイルが作成されます。この KDC 証明書では、レルムが PCTEST.CISCO.COM に、シリアル番号が 100 に、KDC サーバの Fully Qualified Domain Name（FQDN; 完全修飾ドメイン名）が kdc.pctest.cisco.com に設定されます。
KDC 証明書の検証
このコマンドにより、指定された作成元ディレクトリのすべてのファイルを調べ、X.509 証明書としての識別を試みます。正規の X.509 証明書が見つかると、ファイルの名前が適正に変更され、作成先ディレクトリにコピーされます。特定の目的（サービス プロバイダーまたはデバイス）での正規の証明書チェーンが複数特定されると、エラーが生成されます。この場合は、作成元ディレクトリから余分な証明書を削除し、もう一度コマンドを実行する必要があります。
（注） PKCert.sh -v -? コマンドを入力すると、PKCert ツールを使用した KDC 証明書の検証方法の指示が表示されます。
ステップ 1 /opt/CSCObac/kdc にディレクトリを変更します。
ステップ 2 次の構文を使用して PKCert.sh ツールを実行します。
PKCert.sh -v -s dir -d dir -r dir
検証は、このパッケージに組み込まれた参照証明書に対して実行されます。 -d オプションを指定する場合、証明書は名前を正規化して作成先ディレクトリにインストールされます。
例
デバッグ出力のログ レベルの設定
このコマンドにより、 BPR_HOME/kdc ディレクトリの pkcert.log に記録されるデバッグ出力のログ レベルを設定できます。ログ ファイルのデータを使用して、要求されたタスクの実行中に発生した問題のトラブルシューティングを行うことができます。
デバッグ出力のログ レベルを設定するには、次の手順に従います。
ステップ 1 /opt/CSCObac/kdc にディレクトリを変更します。
ステップ 2 次の構文を使用して PKCert.sh ツールを実行します。
PKCert.sh -s dir -d dir -k keyFile -c cert -r realm -a name -n serial# -o { -z error | info | debug}
• -k keyFile ：サービス プロバイダーの秘密鍵（DER 暗号化）を使用します
• -c cert ：サービス プロバイダーの証明書（DER 暗号化）を使用します
• -r realm ：KDC 証明書の Kerberos レルムを指定します
• -n serial# ：証明書のシリアル番号を設定します
• -z ： pkcert.log ファイルに保存されるデバッグ出力のログ レベルを設定します。次の値を選択できます。
– error ：エラー メッセージのロギングを指定します。
– debug ：デバッグ メッセージのロギングを指定します。これはデフォルト設定です。
例
この例では、ログ レベルがエラー メッセージの収集に設定されています。
この例では、ログ レベルが情報メッセージの収集に設定されています。
KeyGen ツールの使用方法
KeyGen ツールを使用して PacketCable サービス キーを生成します。サービス キーは、KDC 通信で必要な Triple Data Encryption Standard（triple DES または 3DES）対称キー（共有秘密情報）です。KDC サーバでは、DPE のプロビジョニング FQDN ごとにサービス キーを必要とします。DPE コマンドライン インターフェイス（CLI）から DPE プロビジョニング FQDN に変更を加えるには、対応する変更を KDC サービス キーのファイル名でも行う必要があります。この変更が必要なのは、KDC サービス キーではそのファイル名の一部として DPE プロビジョニング FQDN が使用されるからです。
KeyGen ツールは、 BPR_HOME/kdc ディレクトリにあり、DPE プロビジョニング FQDN、レルム名、およびパスワードのコマンドライン引数を使用し、サービス キー ファイルを生成します。
（注） このツールを実行する場合は、DPE で（DPE CLI から service packetCable 1..1 registration kdc-service-key コマンドを使用して）サービス キーを生成するために使用したのと同じパスワードを入力してください。このパスワードの設定方法の詳細については、『Cisco Broadband Access Center DPE CLI Reference 4.0』を参照してください。
KDC サーバは起動時にサービス キーを読み取ります。サービス キーを修正するには、どんな場合でも KDC サーバを再起動する必要があります。
シンタックスの説明
keygen options fqdn realm password
– -? ：この使用方法メッセージを表示してコマンドを終了します。
– -v または -version ：このツールのバージョンを表示してコマンドを終了します。
– -q または -quiet ：出力が何も作成されないクワイエット モードを実装します。
– -c または -cms ：CMS システムのサービス キーを作成します。
• fqdn ：DPE の FQDN を指定します。必須の入力項目です。
• realm ：Kerberos レルムを指定します。必須の入力項目です。
• password ：使用するパスワードを指定します。これも必須のフィールドです。パスワードの長さは 6 ～ 20 文字にする必要があります。
例
このコマンドを実行すると、これらの KDC サービス キーが BPR_HOME/kdc/solaris/keys ディレクトリに書き込まれます。
KDC を再起動し、新しいキーが認識されるようにします。次の BAC プロセス ウォッチドッグ コマンドを使用して KDC を再起動します。
このコマンドを実行すると、この CMS サービス キーが BPR_HOME/kdc/solaris/keys ディレクトリに書き込まれます。
KDC と DPE でサービス キーを生成したら、両方のコンポーネントでサービス キーが一致するかどうかを検証します。
KeyGen ツールでは、 service packetCable 1..1 registration kdc-service-key コマンドによって DPE でサービス キーを生成するために使用したのと同じパスワードを入力する必要があります。DPE でこのパスワードを設定した後は、 BPR_HOME/dpe/conf ディレクトリにある dpe.properties ファイルからサービス キーを表示できます。 /pktcbl/regsvr/KDCServiceKey= プロパティに対する値を見つけてください。
KDC で生成されたサービス キーを表示するには、 BPR_HOME/kdc/solaris/keys ディレクトリから次のコマンドを実行します。
od -Ax -tx1 mtaprovsrvr , fqdn @ REALM
このコマンドによって生成される出力は、 dpe.properties ファイルの /pktcbl/regsvr/KDCServiceKey= プロパティの値と一致します。
changeNRProperties.sh ツールの使用方法
BAC インストール プログラムは、Network Registrar DHCP サーバに組み込まれる BAC 拡張によって使用される、設定プロパティの値を確立します。キー設定プロパティを変更するには、
BPR_HOME/cnr_ep/bin ディレクトリの changeNRProperties.sh コマンドを使用します。
パラメータを何も指定せずにスクリプトを呼び出すと、設定可能なプロパティの一覧を示したヘルプ メッセージが表示されます。
ステップ 1 BPR_HOME/cnr_ep/bin にディレクトリを変更します。
ステップ 2 次の構文を使用して changeNRProperties.sh コマンドを実行します。
• -help ：ヘルプ メッセージを表示します。 -help オプションは排他的に使用する必要があります。他のオプションと一緒に使用しないでください。
• -ep enabled | disabled ：PacketCable プロパティをイネーブルまたはディセーブルにします。プロパティをイネーブルにするには -ep enabled と入力し、ディセーブルにするには -ep disabled と入力します。
• -ec enabled | disabled ：CableHome プロパティをイネーブルまたはディセーブルにします。プロパティをイネーブルにするには -ec enabled と入力し、ディセーブルにするには -ec disabled と入力します。
• -d ：現在のプロパティを表示します。 -d オプションは排他的に使用する必要があります。他のオプションと一緒に使用しないでください。
• -s secret ：BAC 共有秘密情報を指定します。たとえば、共有秘密情報がワード secret である場合は、 -s secret と入力します。
• -f fqdn ：RDU FQDN を指定します。たとえば、完全修飾ドメイン名として rdu.example.com を使用する場合は、 -f rdu.example.com と入力します。
• -p port ：使用する RDU ポートを指定します。たとえば、ポート番号 49187 を使用する場合は、 -p 49187 と入力します。
• -r realm ：PacketCable レルムを指定します。たとえば PacketCable レルムが EXAMPLE.COM の場合は、 -r EXAMPLE.COM と入力します。
• -g prov_group ：プロビジョニング グループを指定します。たとえば group1 というプロビジョニング グループを使用する場合は、 -g group1 と入力します。
• -t 00 | 01 ：PacketCable TGT をオフまたはオンに設定するかどうかを指定します。たとえば、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 と入力して 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 と入力して NULL 値に設定することもできます。
• -o prov_ip man_ip ：指定されたプロビジョニング アドレスによって識別される DPE との通信で使用する管理アドレスを設定します。たとえば、プロビジョニング グループの IP アドレスが 10.10.10.7 の場合は -o 10.10.10.7 10.14.0.4 と入力します。必要に応じて NULL 値を入力することもでき、たとえば -o 10.10.10.7 null のように指定します。
例
NR 拡張プロパティ ツールを使用することによって Network Registrar 拡張を変更する例を次に示します。
（注） 変更を有効にするには、NR DHCP サーバを再起動する必要があります。
disk_monitor.sh ツールの使用方法
利用可能なディスク領域を監視することは、重要なシステム管理作業です。多数のカスタム スクリプトまたは市販のツールを使用して、この作業を実行できます。
disk_monitor.sh コマンドは、 BPR_HOME/rdu/samples/tools ディレクトリにあり、1 つ以上のファイル システムのしきい値を設定します。これらのしきい値を超えると、追加のディスク領域が利用可能になるまで、60 秒ごとに Solaris の syslog 機能によってアラートが生成されます。
（注） 少なくとも、disk_monitor.sh スクリプトを使用して BPR_DATA および BPR_DBLOG ディレクトリを監視することをお勧めします。
シンタックスの説明
disk_monitor.sh filesystem-directory x [filesystem-directory* x*]
• filesystem-directory ：監視するファイル システムのディレクトリを示します。
• x：指定したファイル システムに適用するしきい値をパーセントで示します。
例
この例では、 /var/CSCObac ファイル システムの利用率が 80 パーセントに到達した場合に通知が送信されるように指定しています。
データベース ログのディスク領域の利用率が 80 パーセントに達すると、次のようなアラートが syslog ファイルに送信されます。
この例では、disk_monitor.sh ツールをバックグラウンド プロセスとして実行する方法を示しています。コマンドの終わりにアンパサンド（&）を指定すると、バックグラウンドでのプロセスの実行中に出力がただちに返されます。
フィードバック