How to generate and collect Support bundles in DELL EMC Networking OS10 Switches

Contents:

What is a Support Bundle?
How to Generate a Support Bundle.
Where is the Support Bundle Stored?
How to Verify the Support Bundle Generation has Started.
How to Verify the Support Bundle Generation is Complete.
How to Retrieve the Support Bundle from the Switch.
Delete an Existing Support Bundle.
 

What is a Support Bundle?

Support bundle is based on sosreport tool. The support bundle generates a tar file that includes the Linux system configuration and diagnostics information, and show command outputs. Dell Technical support agents need a support bundle for detailed analysis.

How to Generate a Support Bundle.

Run the following command in EXEC mode:

• Use the following command for OS10 version 10.5.2.0 and later: 

OS10# generate support-bundle

• Any OS10 version before 10.5.2.0, use the following command:

OS10# generate support-bundle enable-all-plugin-options

Do not try to generate another support bundle if you did not see the bundle generated immediately after the command execution. Support bundle generation takes some time (may be more than 15 Minutes). 
 

Where is the Support Bundle Stored?

Support bundle is stored in supportbundle directory. To view the contents, use the following command:

OS10# dir supportbundle

Sample output:
OS10# dir supportbundle
Directory contents for folder: supportbundle
Date (modified)        Size (bytes)  Name
---------------------  ------------  ------------------------------------------
2020-01-12T19:34:21Z   8070044       sosreport-OS10-20200112193142.tar.xz
2020-01-12T19:34:27Z   33            sosreport-OS10-20200112193142.tar.xz.md5
 

How to Verify the Support Bundle Generation has Started.

During support bundle generation, we see a random file that is generated in supportbundle directory. You must wait until the generation process is complete. 

Sample output
OS10# dir supportbundle
Directory contents for folder: supportbundle
Date (modified)        Size (bytes)  Name
---------------------  ------------  ------------------------------------------ 
2020-01-13T09:17:12Z   3932160       _proc_sys.tar     <<<This is not the complete file. This files size increases during support bundle generation.

Logging
When support bundle generation starts, it is logged.

Sample output
OS10# show logging log-file | grep "SUPPORT_BUNDLE_STARTED"
<165>1 2020-01-12T19:31:11.808623+00:00 OS10 dn_svc_sw 832 - - Node.1-Unit.1:PRI [event], Dell EMC (OS10) %SUPPORT_BUNDLE_STARTED: generate support-bundle execution has started successfully:All Plugin options enabled
 

How to Verify the Support Bundle Generation is Complete.

After support bundle generation, there are two files in support bundle directory; one is the support bundle file and the other is a file with md5 extension. The md5 file is a checksum file that is used to verify the integrity of bundle file. Send both of the files to Technical Support.

Sample output
OS10# dir supportbundle
Directory contents for folder: supportbundle
Date (modified)        Size (bytes)  Name
---------------------  ------------  ------------------------------------------
2020-01-12T19:34:21Z   8070044       sosreport-OS10-20200112193142.tar.xz     <<<Support bundle file
2020-01-12T19:34:27Z   33            sosreport-OS10-20200112193142.tar.xz.md5     <<<Md5 checksum file

In the above example, sosreport-OS10-20200112193142.tar.xz is the support bundle file and sosreport-OS10-20200112193142.tar.xz.md5 is its md5 checksum file. 

Logging
When support bundle generation is complete, it is logged.

Sample output
OS10# show logging log-file | grep "BUNDLE_COMPLETED"
<165>1 2020-01-12T19:34:27.831211+00:00 OS10 dn_svc_sw 832 - - Node.1-Unit.1:PRI [event], Dell EMC (OS10) %SUPPORT_BUNDLE_COMPLETED: generate support-bundle execution has completed successfully:All Plugin options enabled
 

How to Retrieve Support Bundle from the Switch.

You can use ftp, http, https, scp, sftp, tftp, or usb to collect the support-bundle. Use the following command:

OS10# copy supportbundle://sosreport-OS10- file-number.tar.xz XXXX://server-address/path commands

Where XXXX = ftp, http, https, scp, sftp, or tftp. If you are using USB, format it in FAT32.

Sample output
OS10#copy supportbundle://sosreport-OS10-20200112193142.tar.xz tftp://10.0.0.0.1/sosreport-OS10-20200112193142.tar.xz
 

Delete an Existing Support Bundle.

Support bundle may consume some space from your switch storage. Hence, after retrieving the bundle, you can delete it. Use the following command:
OS10# delete supportbundle://sosreport- filename.tar.extention

Sample output
OS10#delete supportbundle://sosreport-OS10-20200112193142.tar.xz