This document describes how to collect tech-support files from the Network Functions Virtualization Infrastructure Software (NFVIS) and Enterprise Network Compute System (ENCS) through both GUI and CLI.
Tech-support files contain configuration information, logs and diagnostic data that will help TAC in troubleshooting and resolving a technical issue.
There are no specific requirements for this document.
The information in this document is based on Cisco Enterprise NFVIS 3.7.1 or newer.
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.
NFVIS Tech-Support Bundle: WebUI Method
In the new releases of NFVIS you can download the logs as shown here.
Step 1. Log in to NFVIS and browse to Diagnostics (2) under Host (1) as shown in the image.
Step 2. Click on Download Tech Support (3). After a few minutes of wait, a popup will appear that will ask you where to save the file.
Download Pre-Generated Tech-Support:
If you need to redownload the previously generated tech-support file, browse to Image Repository (2) under the Virtual Machine (VM) Lifecycle (1). Select Browse Datastore (3). You can find previously generated tech-supports in tech-support directory of intdatastore. Click on the blue arrow icon (4) in order to download the file as shown in the image.
NFVIS Tech-Support Bundle: CLI Method
In order to generate tech-support, connect to NFVIS with Secure Shell (SSH) client of your choice.
Command or Action
Starts NFVIS tech-support collection
nfvis# show system file-list disk local path /data/intdatastore/tech-support
Displays all existing tech-support files
nfvis# system file-copy source source-path destination target-path
Move file to another directory
If you run NFVIS 3.9.1 or lower, secure copy can be performed only to/from 'intdatastore:', 'extdatastore1:', 'extdatastore2:', 'usb:' and 'nfs:'. In NFVIS 3.9.1 and newer secure copy can also be performed from 'logs:' and 'techsupport:'.
This is an example of how to create a technical support file and transfer the file to an SCP server:
encs01# show system file-list disk local path /data/intdatastore/tech-support SI NO NAME PATH SIZE TYPE DATE MODIFIED ------------------------------------------------------------------------------------------------------------------------------------- 388 NFVIS_encs01_2018-12-28T08-32-47.tar.gz /data/intdatastore/tech-support 737K VM Package 2018-12-28 08:32:47
The USB drive must be formatted with FAT32 of exFAT file system prior to connected to NFVIS.
1. Mount the USB drive:
BXB5406-NFVIS(config)# system usb-mount mount ACTIVE
BXB5406-NFVIS(config)# end 2. Generate the tech-support bundle with the “tech-support” command.
3. Get the name of the tech-support file:
BXB5406-NFVIS# show system file-list disk local path /data/intdatastore/tech-support system file-list disk local 1
type "VM Package"
date-modified "2020-01-21 15:53:23"
4. Copy the file to the USB drive using the SCP command:
BXB5406-NFVIS# scp techsupport:NFVIS_BXB5406-NFVIS_2020-01-21T15-53-23.tar.gz usb:usb3/BXB5406-NFVIS_2020-01-21T15-53-23.tar.gz
5. Confirm the tech-support file is now on the USB drive:
BXB5406-NFVIS # show system file-list disk usb name
SI NO NAME
6. Un-mount the USB drive and remove it
BXB5406-NFVIS (config)# no system usb-mount mount ACTIVE
BXB5406-NFVIS (config)# commit
BXB5406-NFVIS (config)# end
CIMC Tech-Support Bundle: WebUI Method
This method is applicable to Cisco UCS-E Series, UCS-C Series, Cisco Cloud Services Platform (CSP) and ENCS (except ENCS 5104).
Step 1. Log in to CIMC, open left side menu (1) and browse to Utilities (3) under Admin (2).
Step 2. Under Utilities, there are two options - Export Technical Support Data to remote (1) or Download Technical Support Data for Local download (2). It also shows the status of Last Technical Support Data Export (3). Click on Download Technical Support Data for Local Download(2) as shown in the image.
Step 3. In the pop-up message click on Generate and Download Technical Support Data (1). It will take a few minutes to generate tech-support bundle as shown in the image.
CIMC Tech-Support Bundle: CLI Method
This method is applicable to Cisco UCS-E Series, UCS-C Series, CSP and ENCS (except ENCS 5104).
In order to generate tech-support, connect to Cisco Integrated Management Controller (CIMC) with SSH client of your choice.
Note: To use this method you need to have a host in local network configured as TFTP/FTP/SFTP/SCP/HTTP server.
Command or Action
Enters the CIMC command mode.
Server /cimc # scopetech-support
Enters the tech-support command mode.
Server /cimc/tech-support # setremote-ipip-address
Specifies the IP address of the remote server on which the technical support data file should be stored.
Server /cimc/tech-support # setremote-pathpath/filename
Specifies the file name in which the support data should be stored on the remote server. When you enter this name, include the relative path for the file from the top of the server tree to the desired location.
To have the system auto-generate the file name, enter the file name as default.tar.gz.
Server /cimc/tech-support # setremote-protocolprotocol
Specifies the protocol to connect to the remote server. It can be of the following types:
Server /cimc/tech-support # setremote-usernamename
Specifies the user name on the remote server on which the technical support data file should be stored. This field does not apply if the protocol is TFTP or HTTP.
Server /cimc/tech-support # setremote-passwordpassword
Specifies the password on the remote server on which the technical support data file should be stored. This field does not apply if the protocol is TFTP or HTTP.
Server /cimc/tech-support # commit
Commits the transaction to the system configuration.
Server /cimc/tech-support # start
Begins the transfer of the data file to the remote server.
Server /cimc/tech-support # showdetail
Displays the progress of the transfer of the data file to the remote server.
Server /cimc/tech-support # cancel
Cancels the transfer of the data file to the remote server.
This example creates a technical support data file and transfers the file to an SCP server:
encs01 /cimc/tech-support # scope cimc encs01 /cimc/tech-support # scope tech-support encs01 /cimc/tech-support # set remote-ip 172.16.0.1 encs01 /cimc/tech-support *# set remote-path techsupport.tar.gz encs01 /cimc/tech-support *# set remote-protocol scp encs01 /cimc/tech-support *# set remote-username root encs01 /cimc/tech-support *# set remote-password Please enter remote-password: Please confirm remote-password: encs01 /cimc/tech-support *# commit encs01 /cimc/tech-support # encs01 /cimc/tech-support # start Server (RSA) key fingerprint is 4b:b9:a5:14:d0:c3:64:14:54:00:b9:d7:aa:47:1d:6d Do you wish to continue? [y/N]y Tech Support upload started.