This knowledge base has moved to the documentation site. Please visit the knowledge base here for the most up to date content. This site is no longer maintained.

Cumulus Linux Support File


Cumulus Linux generates support files called cl-support whenever issues are detected. 

This file is used to aid in troubleshooting customer issues. The Cumulus Networks global support staff often requests customers to provide this file when they open support tickets. 

The cl-support file is located in the /var/support directory and is named cl_support_xxx.txz.

There are three ways cl-support is generated:

  • If switchd or any other process generates a core file (located in /var/support/core), then the cl-support file is generated.
  • After the first failure of one of the following monitored services since the switch was rebooted or power cycled:
    • clagd
    • frr/quagga
    • openvswitch-vtep
    • portwd
    • ptmd
    • rdnbrd
    • switchd
    • vxrd
    • vxsnd
  • A cl-support file can be triggered by issuing the cl-support command. 
    Note: You should only run this command at the direction of a member of the Cumulus Networks support staff. 

If you need to copy the cl-support file off of the switch to a remote host for collection, use scp:

cumulus@switch:~$ scp /var/support/ username@myserver:/path/


  • Avatar
    Nicolas Piatto

    Is there an better way ( than a dirty cron job ) to exec cl-support every N hour ? ( a bit like what Arista is doing by default
    During tshoot, there is often a miss in collecting a show tech-support prior to take action like power cycle ( :p ) and you loose the ability to dig deeper afterward. Getting at least N hour old show-tech could help

  • Avatar
    Dave Olson

    Nicolas; it's a bad idea to run cl-support when it's not needed, because it can cause problems just by being run.

    There are many ways to monitor CL on a switch, that don't involve running cl-support. And of course, there's netq.

This support portal has moved

Cumulus Networks is now part of the NVIDIA Networking Business Unit! The NVIDIA Cumulus Global Support Services (GSS) team has merged its operations with the NVIDIA Mellanox support services team.

You can access NVIDIA Cumulus support content from the Mellanox support portal.

You open and update new cases on the Mellanox support portal. Any previous cases that have been closed have been migrated to the Mellanox support portal.

Cases that are still open on the Cumulus portal will continue to be managed on the Cumulus portal. Once these cases close, they will be moved to the Mellanox support portal.

Powered by Zendesk