Nexus Dashboard : Tech Support ファイルの取得方法 ND version 2.x

kaihosok · ‎2022-04-19

はじめに
GUI で取得する
CLI で Local techsupport を作成する
CLI で作成した Local techsupport を SCP で取得する
CLI で作成した Local techsupport を Web Access で取得する
CLI で作成した Local TechSupport を削除する
参考情報

はじめに

Nexus Dashboard を使用している上で、障害が発生した際に取得する代表的なログとして Tech Support があります。
本ドキュメントでは、GUI から取得する方法と、CLI から個別に取得する方法について紹介します。

GUI で取得する

各バージョンの Cisco Nexus Dashboard User Guide にも記載がありますが、以下の手順により Tech Support が取得可能です。

ND ( top page ) > Admin Console > Operations > Tech Support > 右上の Collect Tech Support

Collect Tech Support を押すと以下のように、Tech Support のファイル名を入力できます。
また、Tech Support ログの範囲を Scope で決めることができます。基本的には system で問題ないと思いますが、Cisco TAC エンジニアの指示に従って他の Scope のログを取得する場合があります。

Tech support ファイルの生成後は、Download ボタンから Download できます。
Nexus Dashboard は複数台で Cluster を組むことが前提ですが、Download ファイルの中には個々の Cluster Node の Local Tech Support が纏められています。
つまり、３台で構成している Nexus Dashboard Cluster の場合は、3台分の Local Tech Support ファイルが纏められています。
なお、障害が発生して、一部 Node の Tech Support が取得できない場合があります。
また、不要となった Tech Support ファイルは、右端の … より Delete Tech Support から削除が可能です。

CLI で Local techsupport を作成する

何らかの理由で、GUI から取得できない場合は、CLI にて Tech Support を作成する必要があります。
rescue-user でログイン後、下記コマンドで Local Tech Support を作成します。
なお、CLI での取得の場合は GUI とは異なり、各 Node で作成する必要があります。

各種ガイドにもありますが、techsupport ~~ collect を使用します。

[rescue-user@ND-1 ~]$ acs techsupport -s system collect
Started: TS collection may take 15-20 minutes to complete. Monitor /techsupport/ for the file
[rescue-user@ND-1 ~]$ ls /techsupport/
lost+found  tsboltdb                 <<<  最初はありません
[rescue-user@ND-1 ~]$ ls /techsupport/
2022-01-25T07-31-52Z-ts-ND-1.cluster_name.case.local.tgz  lost+found  tsboltdb
[rescue-user@vNDapp-1 ~]$

コマンド実行後15分程度で、/techsupport 配下に tgz ファイルが生成されます。

こちらをダウンロードするためには、以下の手段が有効です。
1. SCP
2. Web Access

CLI で作成した Local techsupport を SCP で取得する

1 つ目の SCP を使用する場合は、WinSCP などのソフトを使用し、rescue-user でログインした上でダウンロードが可能です。
ログイン後の dirctory には techsupport は存在しないため、root へ移動し、techsupport dirctory に移動します。

root から techsupport を選択します。

tgz ファイルをダウンロードします。

これで 1 つの Node 分が終了です。Nexus Dashboard は Cluster を組み動作しているので、必要に応じで他の Node でも取得する必要があります。

CLI で作成した Local techsupport を Web Access で取得する

2つ目は、Web 上からダウンロードする方法です。
Nexus dashboardでログイン後に下記リンク先にアクセスすると、各 Node の Local techsupport が取得可能です。

https://<Management IP>/api/downloads/techsupport/<Data network IP>/

例としては以下のようになります。

CLI で作成した Local TechSupport を削除する

ダウンロードが終了したあと、ファイルを削除するためには、下記のコマンドを使用します。

[rescue-user@vNDapp-1 techsupport]$ acs techsupport -s system clean
Local TS cleanup complete
[rescue-user@vNDapp-1 techsupport]$ ls
lost+found	tsboltdb
[rescue-user@vNDapp-1 techsupport]$

-s の後ろは、どの techsupport 種類を削除するかによって変化します。

参考情報

PDF: Cisco Nexus Dashboard User Guide, Release 2.1.x
Nexus Dashboard:Tech Support ファイルの取得方法 ND version 3.x

Keito Kajiura · ‎2023-11-29

Nexus Dashboard Ver 3.0.1i にてログ取得を検証しました。

・GUI の見栄え等の変化はありますが、問題なく当手順でログ取得は可能でした。CLI の実行に関しても、オプション等に変更はありませんでした。

・下記のセクションの方法に関しては、動作しない可能性もあるかもしれません。

> CLI で作成した Local techsupport を Web Access で取得する

・App Store のログは GUI から取得項目がありませんでした。下記コマンドで CLI から App Store のログは取得可能のように見えましたが、中身を解凍すると App Store 関連のログアーカイブは含まれていませんでした。

acs techsupport collect -s cisco-appcenter

・ログ取得の際に、「Tech Support for the last 24 hours」のチェックボックスが実装されています。
チェックを入れると、Tech Support 内部に含まれている zip ファイルの世代の対象が24時間以内のものに限定されます。これにより Tech Support のログサイズを削減することが出来ます。