Collect Tech Support Files for Hyperflex UI and CLI

Introduction

This document describes how to collect tech support files for the Hyperflex UI and CLI.

Prerequisites

Requirements

There are no specific requirements for this document.

Components Used

This document is not restricted to specific hardware and software versions.

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.

Background Information

When you contact Cisco TAC, tech support files are a critical part of the troubleshooting process.

Note: For customers who use Cisco Intersight and have UCS Manager and HyperFlex Connect connected to Intersight, Cisco TAC can collect UCS Hardware or Storage Controller (storfs-support) files without them being manually uploaded.

Contents

HX 4.0 Onwards : HyperFlex Data Platform Support Bundle

From HX Connect UI

Step 1. Log in to HX Connect and click Settings and then Support Bundle.

Step 2. Under Support Bundle, you can now see three options- Basic, Detailed and Extended.

Basic - Cisco HX Data Platform logs.

Detailed - Gathers Hyper-V logs and performance data for the environment in addition to the Basic support bundle. This is the default Support bundle as generated by storfs-support command.

Extended - When generated with just Extended support bundle option alone, then it only contains core files. When generated with the Recommended Support bundle and Extended Support bundle option, then it includes core files and detailed support bundles.

Step 3. Click Generate. This can give you a pop up to select the node and generate different types of support bundles for download.

• The default option is to generate Recommended Support Bundle.
• Recommended Support Bundle triggers creation of both Basic Support Bundle and Detailed Support Bundle from the same option.
• All the nodes are selected by default. Uncheck the Nodes which are not required manually.

Click Generate to start the support bundle creation.

Once done, the Generate option can be greyed out and it can show you Basic support bundle generation in process.

Once the basic support bundle generation is completed, it can start to generate the detailed support bundle. You can confirm this when you browse to the Basic tab.

The Generate option can be greyed out and it can show you Detailed support bundle generation in process.

You can now open TAC cases that use Basic Supported bundle. Detailed supported bundles are required if the case needs to be escalated to Engineering.

Step 4. Once both the support bundles are generated, you see a prompt that says Support Bundle Generation Completed. Next, you can download Basic or Detailed support bundle as needed.

HyperFlex Data Platform Support Bundle: Hyperflex Cluster UI Method (HX Version 2.5 ~ 3.5)

Warning: Due to Cisco bug ID CSCvp58804 Cisco TAC strongly recommends to avoid this method of log collection unless you run a fixed release for the defect, such as Hyperflex 3.5(2c) or later.

To access this UI, navigate tohttps://{stctlvm mgmt ip}

stctlvm = Storage Controller VM

HyperFlex Data Platform Support Bundle: Hyperflex Cluster UI Method (Pre version 2.5)

To access this UI, navigate to https://{stctlvm mgmt ip}/ui 

stctlvm = Storage Controller VM

HyperFlex Data Platform Support Bundle: Hyperflex Cluster CLI Method

Step 1.  Use the storfs-support command.

Once you log into a storage controller with SSH client, you can run the given command to generate a tech support file. Later, it can be copied with SFTP client.

Detailed Support Bundle

Use the old method and run the CLI command storfs-support to generate the default (or detailed support bundle).

root@SpringpathController0FDF9RNMJK:~# storfs-support
2017-04-28 05:24:18,505 - Storfs-Support - INFO -
2017-04-28 05:24:18,505 - Storfs-Support - INFO -
2017-04-28 05:24:18,505 - Storfs-Support - INFO - Initiating support generation...
2017-04-28 05:24:18,506 - Storfs-Support - INFO -
2017-04-28 05:24:18,506 - Storfs-Support - INFO -
2017-04-28 05:24:18,506 - Storfs-Support - INFO - Generating support archive. This can take some time...
2017-04-28 05:24:18,506 - Storfs-Support - INFO -
2017-04-28 05:31:57,692 - Storfs-Support - INFO - Support archive generated at:
/var/support/storfs-support_2017-04-28--05-24-18_SpringpathController0FDF9RNMJK.tar.gz
2017-04-28 05:31:57,692 - Storfs-Support - INFO - Removing directory... /var/support/cmds_output

This CLI scrolls until all files are gathered.

CLI shows the output like this when the tech support bundle is finished:

2017-04-28 05:31:57,692 - Storfs-Support - INFO - Support archive generated at:
/var/support/storfs-support_2017-04-28--05-24-18_SpringpathController0FDF9RNMJK.tar.gz
2017-04-28 05:31:57,692 - Storfs-Support - INFO - Removing directory...         /var/support/cmds_output
2017-04-28 05:31:57,694 - Storfs-Support - INFO -
2017-04-28 05:31:57,694 - Storfs-Support - INFO -
2017-04-28 05:31:57,694 - Storfs-Support - INFO - Adding file...   
             /var/support/storfs_support-20170428-052418.out
2017-04-28 05:31:57,698 - Storfs-Support - INFO - Removing file... 
             /var/support/storfs_support-20170428-052418.out
root@SpringpathController0FDF9RNMJK:~#

Support bundle is saved to /var/support.

root@SpringpathController0FDF9RNMJK:~# ls -lh /var/support
total 398M
drwxrwxrwx+ 3 root root 4.0K Apr 28 05:19 asup
-rw-rw-rw-  1 root root 398M Apr 28 05:31
storfs-support_2017-04-28--05-24-18_SpringpathController0FDF9RNMJK.tar.gz
root@SpringpathController0FDF9RNMJK:~#

Note: With the CLI method, only a bundle for the local storage controller, is generated. If environment logs are required, this must run manually on individual storage controllers.

These are other options also available to use with the storfs-support command: 

storfs-support --perf
storfs-support --extended

--perf

Gathers performance data for the environment.

--extended

It includes core files that are located in the /var/core directory in the support bundle.

New : Basic Support Bundle

Note: storfs-support DOES have the option for the basic support bundle but DOES NOT have the capability to append the file name (basic vs detailed) to the support bundle file name.

As you can see below, the file name for basic bundle is the same as the one generated for detailed storfs-support without any apend.

root@hx-02-scvm-03:~# storfs-support --basic
/var/support
2020-02-19 12:33:01,315 - Storfs-Support - INFO -
2020-02-19 12:33:01,315 - Storfs-Support - INFO -
2020-02-19 12:33:01,315 - Storfs-Support - INFO - Initiating support generation...
2020-02-19 12:33:01,317 - Storfs-Support - INFO -
2020-02-19 12:33:01,317 - Storfs-Support - INFO -
2020-02-19 12:33:01,317 - Storfs-Support - INFO - Generating support archive. This can take some time...
2020-02-19 12:33:01,317 - Storfs-Support - INFO -
2020-02-19 12:33:01,317 - Storfs-Support - INFO -
2020-02-19 12:33:01,318 - Storfs-Support - INFO - STORFS_RUNTIMEDIR: /tmp
2020-02-19 12:33:01,318 - Storfs-Support - INFO - STORFS_SOURCEDIR:

2020-02-19 12:35:34,446 - Storfs-Support - INFO -
2020-02-19 12:35:34,446 - Storfs-Support - INFO - Support archive generated at:
/var/support/storfs-support_2020-02-19--12-33-01_hx-02-scvm-03.rchs.local.tar.gz
2020-02-19 12:35:34,446 - Storfs-Support - INFO - Removing directory... /var/support/cmds_output

Step 2. Use the asupcli command.

Run the command asupclie generate. You can run asupcli generate--help to get the list of options.

Generate Default/Detailed Support Bundle

Generate Basic Support Bundle

The logs are saved under /var/support.

Capturing Hyperflex Installer Logs: Hyperflex Platform Installer UI Method

To access this UI, navigate tohttps://{HX Installer ip}.

Log in with credentials:

Username: root

Password: Cisco123

Capturing Hyperflex Installer Logs: Hyperflex Platform Installer CLI Method

Once you log in to the platform installer with either with an SSH client or via console, you can run the given command to generate a tech support file. Later, it can be copied with SFTP client.

root@Cisco-HX-Data-Platform-Installer:/var/support# deployment-support
/var/support
2012-12-07 19:59:52,857 - Storfs-Support - INFO -
2012-12-07 19:59:52,858 - Storfs-Support - INFO -
2012-12-07 19:59:52,858 - Storfs-Support - INFO - Initiating support generation...
2012-12-07 19:59:52,860 - Storfs-Support - INFO -
2012-12-07 19:59:52,860 - Storfs-Support - INFO -
2012-12-07 19:59:52,860 - Storfs-Support - INFO - Generating support archive. This can take some time...
2012-12-07 19:59:52,860 - Storfs-Support - INFO -
2012-12-07 19:59:52,860 - Storfs-Support - INFO -
2012-12-07 19:59:52,860 - Storfs-Support - INFO - STORFS_RUNTIMEDIR:             /tmp
2012-12-07 19:59:52,860 - Storfs-Support - INFO - STORFS_SOURCEDIR:
2012-12-07 19:59:52,860 - Storfs-Support - INFO - STORFS_SUPPORT_TARGETDIR:      /var/support
2012-12-07 19:59:52,860 - Storfs-Support - INFO - STORFS_INSTALLDIR:             /opt/springpath/storfs-support
2012-12-07 19:59:52,860 - Storfs-Support - INFO - STORFS_LOGDIR:                 /var/log
2012-12-07 19:59:52,860 - Storfs-Support - INFO - STORFS_ASUPDIR:                /var/log/asup
2012-12-07 19:59:52,861 - Storfs-Support - INFO - STORFS_COREDIR:                /var/core

This CLI scrolls until all files are gathered.

CLI shows the output like this when the tech support bundle is finished:

2012-12-07 19:59:52,994 - Storfs-Support - INFO - Support archive generated at:
/var/support/storfs-support_2012-12-07--19-59-52_Cisco-HX-Data-Platform-Installer.tar.gz
2012-12-07 19:59:52,994 - Storfs-Support - INFO - Removing directory...         /var/support/cmds_output
2012-12-07 19:59:52,994 - Storfs-Support - INFO -
2012-12-07 19:59:52,994 - Storfs-Support - INFO -
2012-12-07 19:59:52,995 - Storfs-Support - INFO - Adding file...  
              /var/support/storfs_support-20121207-195952.out
2012-12-07 19:59:52,996 - Storfs-Support - INFO - Removing file...  
            /var/support/storfs_support-20121207-195952.out
root@Cisco-HX-Data-Platform-Installer:/var/support#

Support bundle is saved to /var/support.

root@Cisco-HX-Data-Platform-Installer:~# ls -lh /var/support/
total 204K
-rw-rw-rw- 1 root root 203K Dec 7 19:59
storfs-support_2012-12-07--19-59-52_Cisco-HX-Data-Platform-Installer.tar.gz
root@Cisco-HX-Data-Platform-Installer:~#

Capturing VMware ESXi Logs

To collect VMware ESXi related logs, reference the VMware Knowledge Base articles:

Via GUI client: https://kb.vmware.com/kb/653

Via CLI session: https://kb.vmware.com/kb/1010705

Capturing VMware vCenter Logs

Full bundle: https://kb.vmware.com/s/article/2032892

Virgo logs: https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.monitoring.doc/GUID-7E10C58F-16EA-44AB-8AA0-8D4A66399879.html

EAM logs: https://kb.vmware.com/s/article/2110014

Capturing UCS Logs

Visual Guide to Collect UCS Tech Support Files - B, C and S Series: https://www.cisco.com/c/en/us/support/docs/servers-unified-computing/ucs-infrastructure-ucs-manager-software/211587-Visual-Guide-to-collect-UCS-Tech-Support.html

Bias-Free Language

The documentation set for this product strives to use bias-free language. For purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions can be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on standards documentation, or language that is used by a referenced third-party product.