Dell Networking SONiC OS 3.Xリリースでテクニカル サポートを生成する方法

目次

• Tech-support Fileとは何ですか?
• テクニカルサポートファイルを生成する方法
• テクニカル サポート ファイルの場所
• スイッチからテクニカルサポート ファイルを取得する方法
  • USB
  • リモートSCPサーバー
  • SCPクライアント アプリケーション
• テクニカルサポートファイル名の形式
• 古いエントリーを制限し、テクニカルサポートファイルのサイズを小さくする方法
• スペースを節約するために古いテクニカル サポート ファイルを削除する

テクニカルサポートファイルとは

テクニカルサポート ファイルは圧縮されたアーカイブ ファイルで、Syslogやデータベースの状態など、スイッチの状態に関する情報で構成されています。Dellテクニカル サポート エージェントは、詳細な分析のためにテクニカル サポート ファイルが必要です。

• 問題のある状態でテクニカル サポート ファイルの生成を試みます
• テクニカルサポートファイルは圧縮ファイルで、/var/dumpに保存されます
• テクニカルサポートファイルの拡張子は「.tar.gz」です
• テクニカルサポート ファイルの生成には、ログ期間に応じて15分から30分以上かかる場合があります

テクニカルサポートファイルを生成する方法

コマンド構文

出力例

admin@DELLSONiC:~$ sonic-cli
DELLSONiC#
DELLSONiC# show tech-support
Output stored in:  /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz
DELLSONiC#

Dell SONiCコマンドライン インターフェイスを終了して、生成されたテクニカル サポート ファイルを確認し、古いテクニカル サポート ファイルを削除します。

DELLSONiC#
DELLSONiC# exit
admin@DELLSONiC:~$

テクニカル サポート ファイルの場所

tech-supportファイルは/var/dumpに保存されます。

admin@DELLSONiC:~$ dir /var/dump/
sonic_dump_DELLSONiC_20230419_043803.tar.gz
admin@DELLSONiC:~$ 

スイッチからテクニカルサポート ファイルを取得する方法

テクニカルサポート ファイルは、リモートSFTP/SCPサーバー、WINSCPなどのSCPアプリケーション、またはスイッチに挿入されたUSBにコピーできます。以下に3つの方法を紹介します。

USB
FAT32フォーマットのUSBを使用してください。
出力例

admin@DELLSONiC:~$sudo mkdir /mnt/usb
admin@DELLSONiC:~$sudo mount /dev/sdb1 /mnt/usb
admin@DELLSONiC:~$sudo cp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz /mnt/usb/sonic_dump_DELLSONiC_20230419_043803.tar.gz

コマンド構文

リモートSCPサーバー
リモートSCPサーバーにコピーするには、次の構文を使用します。

scp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz username@<Ip address or hostname of scp server>:/<path>

admin@DELLSONiC:~$ scp /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz username@10.0.0.1:/home/admin/                       
username@10.0.0.1's password:

SCPクライアント アプリケーション
任意のSCPクライアント アプリケーションを使用して、スイッチ内のテクニカル サポート ファイルを抽出できます。
SCPクライアント アプリケーションでスイッチのログイン認証情報を使用してスイッチにログインします。テクニカル サポート ファイルは、/var/dump/ディレクトリー内にあります。
一部のSCPクライアント アプリケーションにはグラフィカル インターフェイスがあり、スイッチ上の/var/dump/からローカル マシンの場所にファイルをコピーするのがさらに簡単になります。

テクニカルサポートファイル名の形式

テクニカルサポートファイルには、形式の名前が付けられます。

sonic_dump_<Hostname>_ _YYYYMMDD_HHMMSS.tar.gz

たとえば、 sonic_dump_DELLSONiC_20230419_043803.tar.gz は生成されたテクニカル サポート ファイルで、YYYYMMDD_HHMMSSは 20230419_043803 で、 DELLSONiC はスイッチのホスト名です。

古いエントリーを制限し、テクニカルサポートファイルのサイズを小さくする方法

テクニカル サポート ファイルは、スイッチのアップタイムによっては大きくなる場合があります。sinceオプションを使用してSyslogの量を減らすことで、テクニカルサポートのサイズを縮小できます。

show tech-support since <date/time>

日付と時刻の形式
"YYYY-MM-DDTHH:MM:SS[.ddd...]Z" または
"YYYY-MM-DDTHH:MM:SS[.ddd...]+hh:mm" または
"YYYY-MM-DDTHH:MM:SS[.ddd...]-hh:mm" ここで、

YYYY = 年、MM = 月、DD = 日、
T (時刻の前に必須)、
HH = 時間、MM = 分、SS = 秒、
(オプション) .ddd...= 秒の小数部 (例: ".323")
Z は、現地時間からの 0 オフセットを示します
+/- hh:mm は、ローカル時間からの時:分のオフセットを示します。

例えば

DELLSONiC# show tech-support since "2023-04-18T19:31:00Z"
Output stored in: /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz

イベントの前に可能な予防措置に備えて、前日の最大0時間をキャプチャすることをお勧めします。

DELLSONiC# show tech-support since "2023-04-18T00:00:00Z"

スペースを節約するために古いテクニカル サポート ファイルを削除する

スイッチからファイルを抽出した後、テクニカルサポート ファイルまたはダンプ フォルダーを安全に削除できます。新しいテクニカル サポート ファイルを生成する必要がある場合は、var内に新しいダンプ フォルダーが作成されます。

特定のファイルを削除するには、次を使用します。

sudo rm /var/dump/<techsupportfile>.tar.gz

出力例

admin@DELLSONiC:~$ ^C
admin@DELLSONiC:~$ sudo rm -r /var/dump/sonic_dump_DELLSONiC_20230419_043803.tar.gz
admin@DELLSONiC:~$

/var/dumpフォルダーを削除するには、次の手順を実行します。

sudo rm -r /var/dump

出力例

admin@DELLSONiC:~$ sudo rm -r /var/dump
admin@DELLSONiC:~$

Checking
admin@DELLSONiC:~$ ls /var/dump
ls: cannot access '/var/dump': No such file or directory
admin@DELLSONiC:~$