Dell Networking SONiC OS 如何在 3.X 版本中生成技术支持

目录

• 什么是技术支持文件？
• 如何生成技术支持文件
• 技术支持文件的位置
• 如何从交换机检索技术支持文件
  • USB
  • 远程 SCP 服务器
  • SCP 客户端应用程序
• 技术支持文件名格式
• 如何限制旧条目并减小技术支持文件的大小
• 删除旧的技术支持文件以节省空间

什么是技术支持文件

技术支持文件是一个压缩的归档文件，其中包含有关交换机状态的信息，如系统日志、数据库状态等。戴尔技术支持工程师需要技术支持文件进行详细分析。

• 尝试生成处于问题状态的技术支持文件
• 技术支持文件是压缩文件，保存在 /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:~$

技术支持文件的位置

技术支持文件保存在 /var/dump 中。

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

如何从交换机检索技术支持文件

您可以将技术支持文件复制到远程 SFTP/SCP 服务器、任何 SCP 应用程序（如 WINSCP）或插入交换机中的 USB。我们在下面提到了三种方法。

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 选项减少系统日志量来减小技术支持的大小。

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表示与本地时间的零偏移。
+/- 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:~$