了解 cl-support 输出文件
cl-support 脚本生成一个压缩的归档文件，其中包含用于故障排除的有用信息。系统会自动创建该文件，或者您可以手动创建该文件。
自动 cl-support 文件
系统会自动创建 cl-support 文件
- 当任何应用程序（不特定于 Cumulus Linux，而是所有 Linux 发行版都支持的）存在 core dump 文件 时，该文件位于
/var/support/core中。 - 当您重启或断电并重新启动交换机后，首次发生受监控服务之一失败时。
手动 cl-support 文件
要手动创建 cl-support 文件，请运行 nv action generate system tech-support 命令
cumulus@switch:~$ nv action generate system tech-support
Action executing ...
Generating system tech-support file, it might take a few minutes...
Action executing ...
Generated tech-support
Action succeeded
Cumulus Linux 将 cl-support 文件保存在 /var/support 目录中。文件名以 cl_support 开头，并以创建日期和时间结尾。
用于生成 cl-support 文件的 Linux 命令包含更多选项；例如，您可以包含安全敏感信息、包含调试信息、仅运行某些模块，并在文件中提供运行脚本的原因。
要手动创建 cl-support 文件，请运行 cl-support 命令
cumulus@switch:~$ sudo cl-support
如果 Cumulus Linux 支持团队要求您提交 cl-support 的输出以调查您遇到的问题，并且您需要包含安全敏感信息（例如 sudoers 文件），请使用 -s 选项
cumulus@switch:~$ sudo cl-support -s
cl-support 脚本选项
| 选项 | 描述 |
|---|---|
-h: | 显示可用的 cl-support 脚本选项及其描述。 |
-c: | 仅运行与 core 文件匹配的模块（如果没有 -e 模块）。 |
-D: | 显示调试信息。 |
-d: | 不运行提供的逗号分隔列表中的模块。 |
-e: | 仅运行提供的逗号分隔列表中的模块。-e all 运行所有模块和子模块，包括所有可选模块。 |
-j: | 为支持的模块创建 json 输出文件。 |
-l: | 列出可用的模块，然后退出。 |
-M: | 不为模块设置超时。将此选项与 -T 一起使用。 |
-m: | 串行运行模块并设置模块内存限制（以 MB 为单位）；-m 0 串行运行，没有限制。 |
-p: | 向 cl-support 归档文件名添加前缀。 |
-r: | 提供运行 cl-support 脚本的原因。您必须将原因用引号括起来。 |
-S: | 使用与默认 /var/support 不同的输出目录。 |
-s: | 包含安全敏感信息，例如 sudoers 文件。 |
-T: | 设置创建 cl-support 文件的超时时间（以秒为单位）。0 禁用超时。 |
-t: | 提供标签字符串作为 cl-support 文件名的一部分。 |
-v: | 以详细模式运行以显示状态消息。 |
cl-support 示例
以下示例不针对 ptp4l.ptp4l 和 what-just-happened.wjh 模块运行 cl-support 脚本。
cumulus@switch:~$ sudo cl-support -d ptp4l.ptp4l,what-just-happened.wjh
cl-support: cl-support is running without memory limits
Please send /var/support/cl_support_leaf01_20240214_183635.txz to Cumulus support.
以下示例运行 cl-support 脚本并显示调试信息
cumulus@switch:~$ sudo cl-support -D
DEBUG: Memory headroom set as 256MB
DEBUG: Available memory 576MB
DEBUG: Allowed memory consumption calculated at 320MB
DEBUG: Using calculated memory limit
DEBUG: Last parallel mode archive creation used 4MB
DEBUG: /usr/bin/systemd-run -q -P -G -p MemoryMax=320M /usr/bin/time -v -o /tmp/tmp.f8L5l6odWn /usr/lib/cumulus/cl-support -D
DEBUG: run_timeout 90 synced
...
以下示例运行 cl-support 脚本，列出可用模块，然后退出。
cumulus@switch:~$ sudo cl-support -l
Default modules: synced.synced ptp4l.ptp4l what-just-happened.wjh
gdb.coreinfo openvswitch.dump ptmd.ptm switchd.mlx switchd.stack
switchd.fuse clag.clag network.kernel network.ifquery network.sfp
network.sfphex network.net_use network.ifupdown2_policy dot1x.config
system.versions system.logs system.systemd system.dmesg system.hwinfo
system.memory_use system.configs system.pkg system.misc system.uefi
system.time frr.frr neighmgr.neighmgr nvue.config lldp.lldp
Optional modules: switchd.verbose clag.clagkerneldB system.pkgverify
frr.ospftable frr.ospf6table frr.evpntable frr.bgptable nclu.config
以下示例向生成的 cl-support 文件名添加前缀
cumulus@switch:~$ sudo cl-support -p myprefix
Please send /var/support/myprefix_support_leaf01_20240214_184135.txz to Cumulus support.
以下示例提供运行 cl-support 脚本的原因
cumulus@switch:~$ sudo cl-support -r "switchd crash"
Please send /var/support/cl_support_leaf01_20240214_184806.txz to Cumulus support.
删除 cl-support 文件
要从交换机删除 cl-support 文件，请运行 NVUE nv action delete system tech-support files <file-name> 命令。您还可以使用 Linux sudo rm /var/support/<file-name> 命令。
cumulus@switch:~$ nv action delete system tech-support files /var/support/cl_support_leaf01_20240725_221237.txz
Action executing ...
File Delete Succeeded
Action succeeded
显示 cl-support 文件
要显示交换机上的 cl-support 文件，请运行 nv show system tech-support files 命令。您还可以在 /var/support 目录上运行 Linux ls 命令 (ls /var/support)。
cumulus@switch:~$ nv show system tech-support files
File name File path
------------------------------------- --------------------------------------------------
cl_support_leaf01_20240725_225811.txz /var/support/cl_support_leaf01_20240725_225811.txz
上传 cl-support 文件
要将 cl-support 文件从交换机上传到外部位置，请运行 nv action upload system tech-support files <file-name> <remote-url> 命令。
相关信息
有关 cl-support 归档中包含的目录的信息，请参阅
- etc 目录故障排除。
/etc目录包含的文件数量最多。 - 故障排除日志文件。本指南重点介绍了要检查的最重要的日志文件。请记住，
cl-support包含所有日志文件。