一般的なトラブルシューティング手法
-
トラブルシューティングの調査を開始する前に、システム プロセスに関連付けられているすべてのポッドが実行されていることを確認します。
ポッドが実行されているかどうかを確認するには、次の手順を実行します。
-
サーバーの認証情報を使用して、Paragon Automationのプライマリノードにログインします。
-
プライマリノードから、次のコマンドを使用して、システムプロセスに関連付けられているポッドが実行されているかどうかを確認します。
kubectl -n northstar get pod
出力には、ポッドのリストとその詳細が表示されます。実行中のポッドごとに、そのポッドに対応する [状態] 列に RUNNING という単語が表示されます。実行が停止したポッドは、自動的に再起動します。
-
-
ポッドが Running 状態でない場合は、次のコマンドを使用して、ポッドに関連付けられているイベントを表示します。イベントは、問題の特定に役立ちます。
kubectl -n northstar describe pod pod-name
コマンドでは、 pod-name はイベントを表示するポッドの名前です。
-
プロセスに関連付けられているポッドにログインして、システムプロセスが実行されているかどうかを確認し、ログを表示します。詳細については、「 ログの表示」 を参照してください。
-
CLI コマンドの実行 - デバイスに手動でログインしなくても、以下のネットワーク要素に対して CLI コマンド(ping、traceroute、およびベンダー固有のコマンド セット)を実行できます。このタスクは、GUI の [診断] ページから実行できます。
メモ:SSH経由でデバイスに接続できる必要があります。そうしないと、CLI コマンドを実行できません。
-
ノード—ノードでCLIコマンドを実行する方法の詳細については、 Paragon Automationユーザーガイドの「 ノードタブについて 」を参照してください。
-
リンク—リンクでCLIコマンドを実行する方法の詳細については、 Paragon Automationユーザーガイドの「 リンクについて」タブを参照してください 。
-
トンネル—トンネルでのCLIコマンドの実行の詳細については、 Paragon Automationユーザーガイドの[ トンネル]タブについて を参照してください。
-
インターフェイス—インターフェイスでCLIコマンドを実行する方法の詳細については、 Paragon Automationユーザーガイドの[ インターフェイス]タブについて を参照してください。
ノード、リンク、トンネル、インターフェイスのCLIコマンドは、それぞれのポッドにある対応する構成ファイルに存在します。これらの構成ファイルは、任意のテキスト エディターを使用して変更できます。
例えば、CLI コマンド構成ファイル(clicommands.json)には、ベンダー固有のコマンド セットが含まれています。デフォルトでは、ファイル内のコマンドは、アカウンティング情報、シャーシ、ファイル操作などのカテゴリに分類されています。GUI から CLI コマンドを実行すると、同じカテゴリが [診断(Diagnostics)] リストに表示されます。これらのカテゴリはベンダー固有です。CLIコマンドを実行するノードを選択すると、Paragon Pathfinderはそのノードのベンダータイプを収集します。次に、Paragon Pathfinderは、該当するカテゴリとコマンドセットを表示します。カテゴリ名と、カテゴリ内のコマンドの構成を変更できます。コマンドを追加することもできます。ping および traceroute カテゴリについても同様です。
次の例は、 clicommands.json ファイル内のエントリの構造を示しています。
{ "cmd": "show config | display inheritance|no-more", "displayName": "Show configuration", "cmdId": 380 }, { "cmd": "show config logical (LR) | display inheritance|no-more", "displayName": "Show configuration (LR)", "cmdId": 1571 },
構成ファイルを変更するには、次の手順を実行します。
-
サーバーの認証情報を使用して、Paragon Automationのプライマリノードにログインします。
-
プライマリノードから、次のコマンドを使用して、ns-web プロセスに関連付けられているポッドの名前を取得します。
.
kubectl -n northstar get pod | grep ns-web
ns-web プロセスのログ ファイルには、GUI からの REST API リクエストのログ エントリーが含まれています
-
次のコマンドを使用して、ns-web プロセスに関連付けられているポッドにログインします。
kubectl -n northstar exec -it ns-web-pod-name -c ns-web -- bash
コマンドの ns-web-pod-name は、 ステップ 2 で取得したポッドの名前です。
-
ポッドに存在する構成ファイルの一覧を表示するには、次のコマンドを使用します。
ls /opt/pcs/db/diagnostic/
出力には、ping()、traceroute()、およびCLI(
pingcommands.json
traceroutecommands.json
clicommands.json
)の設定ファイルが表示されます。
-
-
ログの表示-GUIの[ログ]ページ(>ログの監視)で、すべてのParagon Automationコンポーネントのログを表示できます。
または、CLI を使用してログを表示することもできます。
次の例では、CLI を使用して Config Server プロセスに関連付けられたログを表示する手順について説明します。同じ手順を使用して、他のプロセスのログを表示できます。
-
サーバーの認証情報を使用して、Paragon Automationのプライマリノードにログインします。
-
プライマリ ノードから、次のコマンドを使用して、Config Server プロセスに関連付けられているポッドの名前を取得します。
kubectl -n northstar get pod | grep configserver
-
次のコマンドを使用して、Config Server プロセスに関連付けられているログを表示します。
kubectl -n northstar logs -f ns-configserver-pod-name -c syslog
コマンドの ns-configserver-pod-name は、 ステップ 2 で取得したポッドの名前です。
出力には、構成サーバー・プロセスに関連したログが表示されます。
表1 は、Paragon Pathfinderのトラブルシューティングに最もよく使用されるログファイルに関する情報を示しています。
表1:一般的に使用されるParagon Pathfinderのログファイル ログ ファイル
説明
NS-PCESERVER
ログ ファイルには、パス計算要素(PCE)サーバーに関連するログ エントリが含まれています。PCE サーバーは、PCEP(Path Computation Element Protocol)セッションを維持します。ログには、パス計算クライアント(PCC)と PCE 間の双方向の通信に関する情報が含まれています。
NS-PCSr
ログ ファイルには、パス計算サーバー (PCS) に関連するログ エントリが含まれています。PCS はパスの計算を担当します。ログには、プロビジョニング命令など、PCS が Toposerver から受信するイベントが含まれます。ログには、PCSの正常な起動を妨げる通信エラーや問題の通知も含まれています。
NS-toposerver
ログ・ファイルには、トポロジー・サーバー(Paragon Pathfinderではトポサーバーとも呼ばれる)に関連するログ・エントリーが含まれています。トポロジーは、トポロジーを維持する役割を担います。ログには、PCS とトポサーバ、トポサーバと BGP モニタリング プロトコル(BMP)、およびトポサーバと PCE サーバ間のイベントの記録が含まれます。
NS-ウェブ
ログファイルには、Paragon Pathfinder GUIからのREST APIリクエストに関連するログエントリーが含まれています。
-
-
リンクとトンネルの履歴イベントの表示:GUI の [イベント(Events)] ページでは、リンクとトンネルに関連付けられた履歴イベントを表示できます。タイムラインビューのグラフには、選択した時間範囲のイベントが表示されます。ページの下部にある [イベント] テーブルには、これらのイベントの詳細が表示されます。
メモ:[イベント] ページに表示されるイベントは、PCE との間の外部通信にのみ関係します。PCE 内部通信のほとんどは、ログ ファイルでのみキャプチャされます。
-
リンクの [イベント(Events)] ページにアクセスするには、ネットワーク情報テーブル(ネットワーク > トポロジ)の [リンク(Link)] タブに移動します。イベントを表示するリンクを選択し、[ イベントの表示] > [リンク] を選択します。[イベント] ページが表示されます。詳細については、『Paragon Automationユーザーガイド』の「 リンク」タブについて を参照してください。
-
トンネルの [イベント(Events)] ページにアクセスするには、ネットワーク情報テーブル(ネットワーク > トポロジ)の [トンネル(Tunnel)] タブに移動します。イベントを表示するトンネルを選択し、[ > イベントの表示(View )] を選択します。[イベント] ページが表示されます。詳細については、『Paragon Automationユーザーガイド』の「 トンネル タブについて」を参照してください 。
-
Paragon Pathfinderが制御するネットワークで問題が発生した場合、ネットワーク内のさまざまな要素に対してCLIコマンドを実行し、問題の原因を特定することができます。詳細については、「 CLI コマンドの実行」 を参照してください。