ジュニパー BNG CUPS コントローラ ユーティリティと CLI コマンドの使用方法

BNG CUPS Controller ユーティリティ スクリプト(dbng)を使用して、アプリケーションを管理し、操作の設定に使用する CLI にアクセスします。BNG CUPS コントローラのインストールでは、ユーティリティ スクリプトが /usr/local/bin に配置されます。

ユーティリティ スクリプトは dbng 、BNG CUPS の管理に必要なタスクを実行しますが、コマンドの kubectl 複雑さを隠します。このコマンドのマスクにより kubectl 、管理業務が簡素化されます。

ユーティリティ スクリプトは dbng 、Kubernetes kubectl ユーティリティ コマンドを使用して以下を実行します。

• オブジェクトの作成と削除。
• ログへのアクセスを提供します。
• ポッドコンテナでインタラクティブセッションを実施します。
• BNG CUPS コントローラ オブジェクトのステータスを表示します。

表 1 は、ユーティリティー・スクリプトで呼び出すことができるコマンドを dbng リストし、各コマンドが開始するアクションを示しています。

表 1:BNG CUPS コントローラ ユーティリティ スクリプト コマンド

コマンド名	アクション
cli	BNG CUPS コントローラ機能の設定に使用できる CLI へのアクセスを提供します。
ip	BNG CUPS コントローラに到達するために必要な IP アドレスを示しています。
logs	BNG CUPS コントローラ のログを表示します。
restart	特定の BNG CUPS コントローラ サービスを再起動します。このコマンドは、以下のオプションを提供します。 cp—BNG CUPSコントローラインスタンスサービス scache — ステート キャッシュ サービス
setup	インストール プロセスの一環として BNG CUPS コントローラ アプリケーションを設定します。このコマンドを実行するには、root権限が必要です。
shell	BNG CUPS コントローラのシェル プロンプトに接続します。
start	特定の BNG CUPS コントローラ サービスまたはすべての BNG CUPS コントローラ サービスを開始します。
status	BNG CUPS コントローラ サービスの現在のステータスを表示します。
stop	すべての BNG CUPS コントローラ サービスを停止します。
uninstall	ローカル システムから BNG CUPS コントローラ アプリケーションを削除します。このコマンドを実行するには、root 権限が必要 sudo です。
version	インストールされた BNG CUPS コントローラ アプリケーションのバージョン番号を表示します。

コマンドを発行するには、次の一般的な構文を使用します。

• 短いオプションの場合:

• 長いオプションの場合:

簡単な説明を含む利用可能なコマンドのリストを表示するには、 または help オプションのいずれかをh使用します。

特定のコマンドのオプションを表示するには、

ユーティリティ スクリプトを使用して、 dbng すべての BNG CUPS コントローラ サービスを開始または停止します。サービスは依存順に開始されます。重要なサービス(db および cmgd)が最初に開始され、その後に他のサービスが続きます。サービスは依存関係の逆の順序で停止します。

• このコマンドを実行して、すべての BNG CUPS コントローラ サービスを開始します。

  メモ：

  ジュニパーネットワークスのサポート担当者の ––services 指示に基づく場合にのみ、トラブルシューティングの目的でのみ、このオプションを使用して個々のサービスまたは一連のサービスを開始することをお勧めします。

• このコマンドを実行して、すべての BNG CUPS コントローラ サービスを停止します。

ユーティリティ スクリプトを dbng status 使用して、表 2 に示す各 BNG CUPS コントローラ サービス(機能コンポーネント)のステータスを確認します。ステータスは、サービスが実行中か、終了しているか、開始されていないかを示します。

表 2: Status コマンドで表示されるサービス

サービス	説明
Cp	BNG CUPSコントローラインスタンスサービス:コントロールプレーンプロトコルを含む加入者管理コントロールプレーンを実装します。AAA(認証、許可、アカウンティング)、サポートインフラストラクチャについてお知りします
キャッシュ	状態キャッシュ サービス — サービスによって生成された加入者サービスの状態に対して、オンクラスター バッキング ストレージを cp 提供します。このサービスは、サービス再起動時の状態回復に cp 使用します。

コントローラサービスのステータスを確認するには、サービスステータスを表示します。

ユーティリティ スクリプトを dbng logs 使用して、BNG CUPS コントローラの実行中に発生するさまざまなイベントのログを表示します。

BNG CUPS コントローラ のログを表示するには、このコマンドを実行して、すべてのサービスのログを報告します。

標準の Ubuntu 規則を使用して、ログをファイルまたはターミナルとファイルにリダイレクトできます。詳細については Ubuntu のマニュアル一式を参照してくださいが、開始点として以下の例を使用できます。

• すべてのログをファイルのみにリダイレクトします。

• すべてのログを画面とファイルの両方にリダイレクトします。

ベスト プラクティス:

このオプションは ––services 、ジュニパーネットワークスのサポート担当者の指示に基づくトラブルシューティングのみを対象としています。

ログには以下の重大度レベルのいずれかを指定し、重大度を上げる順に以下に示します。

表 3:重大度レベル

重大度レベルの	説明
debug	問題を診断しようとしている場合にのみ、通常は関心のある詳細情報を提供します。多くの場合、これらのログは頻繁に使用されます。
info	対象のイベントまたはエラー以外の状態をログに記録します。このレベルのログは、すべてが期待どおりに機能していることを確認します。これらのログは通常、あまり頻繁ではありません。
warning	予期しない事象が発生した、または近い将来に何らかの問題が発生する可能性があることを示します。後者の簡単な例は、 あなたがすぐにディスク容量 を使い切る可能性があることを示す低い警告ディスク領域です。いずれの場合も、ソフトウェアは想定通りに動作していますが、より詳細に監視したい場合があります。これらのログは通常、あまり頻繁ではありません。
error	ソフトウェアが何らかの機能を実行できなかった深刻な問題を示します。ソフトウェアは、可能な限り問題を適切に処理して機能を継続しています。
critical	プログラムの実行を継続させない重大なエラーを警告します。

ユーティリティ スクリプトを dbng 使用して、BNG CUPS コントローラ設定をアンインストールします。コマンドは uninstall 、BNG CUPS コントローラの設定時に実行したアクションを取り消します。このスクリプトは、アプリケーションをインストールした直後に設定設定を行う前の BNG CUPS コントローラの状態に戻します。

BNG CUPS コントローラをアンインストールするには、次の手順に従います。