Understanding the cl-support Output File

The 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 /var/support/core

• After the first failure of one of the following monitored services since the switch was rebooted or power cycled:

  • clagd
  • frr
  • openvswitch-vtep
  • portwd
  • ptmd
  • rdnbrd
  • switchd
  • vxrd
  • vxsnd

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:

Reason: switchd first heartbeat miss

To create the cl-support archive file manually, run the cl-support command:

cumulus@switch:~$ sudo cl-support

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 -s option:

cumulus@switch:~$ sudo cl-support -s

For information on the directories included in the cl-support archive, see:

• Troubleshooting the etc Directory
  • In terms of the sheer number of files, /etc contains 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-support includes all of the log files.