cl-support script generates a compressed archive file of useful information for troubleshooting. The system either creates the archive file automatically or you can create the archive file manually.
The system creates the
cl-support archive file automatically for the following reasons:
When there is a core file dump of any application (not specific to Cumulus Linux, but something all Linux distributions support), located in
- After the first failure of one of the following monitored services since the switch was rebooted or power cycled:
When the system creates the
cl-support archive automatically due to a failure, the archive contains a file called
Control that provides the reason why the script was executed. For example:
To create the
cl-support archive file manually, run the
If the Cumulus Networks support team requests that you submit the output from
cl-support to help with the investigation of issues you might experience with Cumulus Linux and you need to include security-sensitive information, such as the
sudoers file, use the
For information on the directories included in the
cl-support archive, see:
- Troubleshooting the etc Directory — In terms of the sheer number of files,
/etccontains the largest number of files to send to Cumulus Networks. However, log files might be significantly larger in file size.
- Troubleshooting Log Files — This guide highlights the most important log files to inspect. Keep in mind,
cl-supportincludes all of the log files.