Skip to main content
Version: v2.6

Supportconfig bundle

After installing the CSP adapter, you will have the ability to generate a supportconfig bundle. This bundle is a tar file which can be used to quickly provide information to support.

These bundles can be created through Rancher or through direct access to the cluster that Rancher is installed on. Note that accessing through Rancher is preferred.

Note: Only admin users can generate/download supportconfig bundles, regardless of method.

Accessing through Rancher

First, click on the hamburger menu. Then click the Get Support button.

Get Support

In the next page, click on the Generate Support Config button.

Note: If the adapter is not installed, the option to generate the supportconfig bundle will not be present. You must install the CSP adapter to generate a supportconfig bundle.

Get Support

Accessing without rancher

First, generate a kubeconfig for the cluster that Rancher is installed on.

Note: If Rancher is down, you will not be able to use a kubeconfig token generated by Rancher to access the cluster.

Configure your shell environment to use this kubeconfig token:

export KUBECONFIG=$MY_KUBECONFIG_PATH

It is recommended to create a temporary working directory while running this command, like below:

mkdir temp && cd temp

Then, retrieve the supportconfig bundle:

mkdir rancher && kubectl get configmap csp-config -n cattle-csp-adapter-system -o=jsonpath='{.data.data}' >> rancher/config.json && tar -c -f supportconfig_rancher.tar rancher && rm -rf rancher

This will create a supportconfig_rancher.tar file in your current directory.

Users who run these commands on Mac may experience issues due to incompatibilities between gnu-tar and bsd-tar. If support has issues reading a supportconfig that you produce, try using the below command after making gnu-tar accessible as gtar on your path:

mkdir rancher && kubectl get configmap csp-config -n cattle-csp-adapter-system -o=jsonpath='{.data.data}' >> rancher/config.json && gtar -c -f supportconfig_rancher.tar rancher && rm -rf rancher