Skip to main content

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

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

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

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?

The support bundle is based on the 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 that 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 the 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 the 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 the 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, or you can use system bash to scp the support bundle to a local node in the rack to download over WinSCP.

Use the following command from the switch prompt:

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

Use the following commands for system bash:

  • system bash
  • ls -ltrh /var/opt/dell/os10/support_bundle/bundle/
  • sudo scp /var/opt/dell/os10/support_bundle/bundle/sosreport* <user>@<node IP>:/target/dir
    • Then enter correct passwords when prompted

Sample output

OS10# system bash
admin@OS10:~$ ls -ltrh /var/opt/dell/os10/support_bundle/bundle/
total 12M
-rw------- 1 root root 12M Nov  6 19:47 sosreport-os10-20241106194507.tar.xz
-rw-r--r-- 1 root root  33 Nov  6 19:47 sosreport-os10-20241106194507.tar.xz.md5
admin@OS10:~$ sudo scp /var/opt/dell/os10/support_bundle/bundle/sosreport* admin@192.168.219.5:/home/admin
[sudo] password for admin:
The authenticity of host '192.168.219.5 (192.168.219.5)' can't be established.
ED25519 key fingerprint is SHA256:SObGGFqgOZ4nY8np1sYvobZAHw2F96Goi7rdzHS+jQU.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.219.5' (ED25519) to the list of known hosts.
Password:
sosreport-os10-20241106194507.tar.xz                                                                                                      100%   12MB   1.6MB/s   00:07
sosreport-os10-20241106194507.tar.xz.md5                                                                                                  100%   33     4.1KB/s   00:00

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

 

Affected Products

PowerSwitch S3048-ON, PowerSwitch S4048-ON, Dell EMC Networking MX5108n, Dell EMC Networking MX9116n, PowerSwitch S4048T-ON, PowerSwitch S4112F-ON/S4112T-ON, PowerSwitch S4128F-ON/S4128T-ON, PowerSwitch S4148F-ON/S4148T-ON/S4148FE-ON , PowerSwitch S4148U-ON, PowerSwitch S4248FB-ON /S4248FBL-ON, PowerSwitch S5212F-ON, PowerSwitch S5224F-ON, PowerSwitch S5232F-ON, PowerSwitch S5248F-ON, PowerSwitch S5296F-ON, PowerSwitch S6100-ON, PowerSwitch Z9100-ON, PowerSwitch Z9264F-ON ...
Article Properties
Article Number: 000132936
Article Type: How To
Last Modified: 06 Dec 2024
Version:  6
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.