Cisco Enterprise Network Functions Virtualization Tech-Support Generation

Available Languages

Download Options

  • PDF     (861.1 KB)
    View with Adobe Reader on a variety of devices
  • ePub     (1.0 MB)
    View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
  • Mobi (Kindle)     (581.9 KB)
    View on Kindle device or Kindle app on multiple devices
Updated:July 15, 2021
Document ID:215170

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the 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 may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

    Introduction

    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.

    Prerequisites

    Requirements

    There are no specific requirements for this document.

    Components Used

    The information in this document is based on Cisco Enterprise NFVIS 3.7.1 and later..

    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 the NFVIS web interface, you can download the tech-support bundle log bundle 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 pop-up will appear to download the file. If this does not appear, make sure your web browser is set up to allow pop-ups from the NFVIS server you are connected to.

    Download Previously Generated Tech-Support files: If you need to re-download a previously generated tech-support file, navigate to the Image Repository (2) page, located under the VM Lifecycle (1) and select Browse Datastore (3). You can find previously generated tech-supports under the tech-support sub-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

    From the NFVIS Command Line Interface (CLI), you can generate a tech-support bundle and transfer it either by uploading to an SCP server or copying to a USB drive. To access the CLI, connect to NFVIS via Secure shell (SSH) or the console.

    Upload to SCP server

    Use the following steps to generate a tech-support bundle and transfer it via SCP to a remote server:

    Command or Action Purpose
    Step 1 nfvis# tech-support

    Starts NFVIS tech-support collection

     
    Step 2 nfvis# show system file-list disk local path /data/intdatastore/tech-support

    This will return a list of all tech-support bundles. Be sure to identify the filename of the bundle created in the previous step, as it will be needed in the following steps.

     
    Step 3

    nfvis# system file-copy source source-path destination target-path

    (Optional)

    Move file to another directory

    Tip   

    With NFVIS versions prior to 3.9.1, secure copy can be performed only to/from the 'intdatastore:', 'extdatastore1:', 'extdatastore2:', 'usb:' and 'nfs:' path prefixes, none of which include the default path where tech-support bundles are stored, so you must manually copy the file to one of these paths in order to be able to SCP it in the next step.


    In NFVIS 3.9.1 and later, a new path-prefix, 'techsupport:', was added for the path where tech-support bundles are stored, allowing secure copy to be peformed directly, so this additional step is not required.
     
    Step 4
    		 nfvis# scp <path prefix>:<filename> <remote user>@<remote host>:<path>

    Transfers the file to the remote SCP server, using the path and filename identified in the previous steps.

    Note: You can also download the file from the NFVIS with Secure Copy Protocol (SCP) client. You need to allow incoming SCP connections to NFVIS first. For more details, see Cisco Enterprise Network Function Virtualization Infrastructure Software Configuration Guide.

    This is an example of how to generate a tech-support bundle with NFVIS 3.9.1 or later and transfer it to an SCP server:

    encs01# tech-support

    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 

    encs01# scp techsupport:NFVIS_encs01_2018-12-28T08-42-35.tar.gz root@192.168.0.1:/tmp
    root@192.168.0.1's password: 
    NFVIS_encs01_2018-12-28T08-42-35.tar.gz 
    encs01#

    Copy to USB Drive:

    Use the steps in the following example to generate a tech-support bundle and copy it to a USB drive.

    Note: The USB drive must be formatted with FAT32 of exFAT file system prior to being connected to NFVIS.

    1. Mount the connected USB drive:
     BXB5406-NFVIS(config)# system usb-mount mount ACTIVE
     BXB5406-NFVIS(config)# commit
     Commit complete.
     BXB5406-NFVIS(config)# end

    2. Generate the tech-support bundle with the “tech-support” command.
     BXB5406-NFVIS# tech-support

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
      name          NFVIS_BXB5406-NFVIS-401_2020-01-21T15-53-23.tar.gz
      path          /data/intdatastore/tech-support
      size          21K
      type          "VM Package"
      date-modified "2020-01-21 15:53:23"

4. Use the filename learned above to copy that file to the USB drive using the SCP command (note that here the 'scp' command used allows 
       for making a simple local file copy by specifying a local source and destination, there is no actual scp transfer).
     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
     -------------------------------------------------------
     1      Cisco_NFVIS_BRANCH_Upgrade-3.12.3-RC4.nfvispkg
     2      Logs-for-pahayes.zip   
     3      NFVIS_BXB5406-NFVIS_2020-01-21T15-53-23.tar.gz

6. Un-mount the USB drive and remove it
     BXB5406-NFVIS (config)# no system usb-mount mount ACTIVE
     BXB5406-NFVIS (config)# commit
     Commit complete.
     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 Purpose
    Step 1 Server# scope cimc

    Enters the CIMC command mode.

     
    Step 2 Server /cimc # scope tech-support

    Enters the tech-support command mode.

     
    Step 3 Server /cimc/tech-support # set remote-ip ip-address

    Specifies the IP address of the remote server on which the technical support data file should be stored.

     
    Step 4 Server /cimc/tech-support # set remote-path path/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.

    Tip   

    To have the system auto-generate the file name, enter the file name as default.tar.gz.
     
    Step 5 Server /cimc/tech-support # set remote-protocol protocol
    Specifies the protocol to connect to the remote server. It can be of the following types:
    • tftp
    • ftp
    • sftp
    • scp
    • http
     
    Step 6 Server /cimc/tech-support # set remote-username name

    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.

     
    Step 7 Server /cimc/tech-support # set remote-password password

    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.

     
    Step 8 Server /cimc/tech-support # commit

    Commits the transaction to the system configuration.

     
    Step 9 Server /cimc/tech-support # start

    Begins the transfer of the data file to the remote server.

     
    Step 10 Server /cimc/tech-support # show detail (Optional)

    Displays the progress of the transfer of the data file to the remote server.

     
    Step 11 Server /cimc/tech-support # cancel (Optional)

    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.

    encs01 /cimc/tech-support # show detail

      Tech Support:
      Server Address: 172.16.0.1
      Path: techsupport.tar.gz
      Protocol: scp
      Username: root
      Password: ******
      Progress(%): 20
      Status: COLLECTING

    Revision History

    Revision Publish Date Comments
    1.0
    02-Feb-2020
    Initial Release
    TAC Authored

    Contributed by Cisco Engineers

    • Attila Sovak
      Cisco TAC Engineer
    • Patrick Hayes
      Cisco TAC Engineer
    • Konstantin Batrakov
      Cisco TAC Engineer

    Was this Document Helpful?

    FeedbackFeedback

    Contact Cisco

    This Document Applies to These Products