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.
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.
Run the following command in EXEC mode:
OS10# generate support-bundle
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).
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
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
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
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
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