Server Utilities

Exporting Technical Support Data to a Remote Server

Perform this task when requested by the Cisco Technical Assistance Center (TAC). This utility creates a summary report containing configuration information, logs, and diagnostic data that will help TAC in troubleshooting and resolving a technical issue.

Procedure

  Command or Action Purpose

Step 1

Server # scope cimc

Enters CIMC command mode.

Step 2

Server /cimc # scope tech-support

Enters 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 support data file should be stored.

Step 4

Server /cimc/tech-support # set remote-path path/filename

Specifies the filename for the support data to be stored on the server. When you enter this name, include the relative path for the file from the top of the server tree to the desired location.

Step 5

Server /cimc/tech-support # set remote-protocol protocol-type

Specifies the remote server protocol. The remote server protocol can be one of the following:

  • tftp

  • ftp

  • sftp

  • scp

  • http

Step 6

Server /cimc/tech-support # set remote-username username

(Optional) The username that the system should use to log in to the remote server.

Note

 

The username is not applicable if the remote server is TFTP or HTTP.

Step 7

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

(Optional) The password for the remote username.

Note

 

The password is not applicable if the remote server 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 support data file to the remote server.

Step 10

Server /cimc/tech-support # show detail

Displays the status of the file upload.

Step 11

Server /cimc/tech-support # cancel

(Optional) Cancels the transfer of the support data file to the remote server.

Example

This example creates a support data file and transfers the file to a TFTP server:

Server# scope cimc
Server /cimc # scope tech-support
Server /cimc/tech-support # set remote-ip 10.20.30.41
Server /cimc/tech-support *# set remote-path /user/user1/supportfile
Server /cimc/tech-support *# set remote-protocol tftp
Server /cimc/tech-support *# commit
Server /cimc/tech-support # start
 Tech Support upload started.
Server /cimc/tech-support # show detail
Tech Support:
    Server Address: 10.20.30.41 
    Path: /user/user1/supportfile Protocol: tftp
    Username:
    Password: ****** 
    Progress(%): 0 
    Status: COLLECTING

Server /cimc/tech-support # show detail
Tech Support:
    Server Address: 10.20.30.41 
    Path: /user/user1/supportfile 
    Protocol: tftp
    Username:
    Password: ****** 
    Progress(%): 85 
    Status: COLLECTING

Server /cimc/tech-support # show detail
Tech Support:
    Server Address: 10.20.30.41 
    Path: /user/user1/supportfile 
    Protocol: tftp
    Username:
    Password: ****** 
    Progress(%): 100 
    Status: COMPLETED

What to do next

Provide the generated report file to Cisco TAC.

Rebooting the CIMC

On rare occasions, such as an issue with the current running firmware, troubleshooting a server may require you to reboot the CIMC. This procedure is not part of the normal maintenance of a server. After you reboot the CIMC, you are logged off and the CIMC will be unavailable for a few minutes.


Note


If you reboot the CIMC while the server is performing power-on self test (POST) or is operating in the Extensible Firmware Interface (EFI) shell, the server will be powered down until the CIMC reboot is complete.


Procedure

  Command or Action Purpose

Step 1

Server# scope cimc

Enters CIMC command mode.

Step 2

Server /cimc # reboot

After the prompt to confirm, reboots the CIMC.

Example

This example reboots the CIMC:

Server# scope cimc
Server /cimc # reboot
This operation will reboot the CIMC.
Continue?[y|N]y
 

Resetting the CIMC to Factory Defaults

On rare occasions, such as an issue with the current running firmware, troubleshooting a server may require you to reset the CIMC to the factory default. When this happens, all user-configurable settings are reset.

This procedure is not part of the normal server maintenance. After you reset the CIMC, you are logged off and must log in again. You may also lose connectivity and may need to reconfigure the network settings.

Procedure

  Command or Action Purpose

Step 1

Server # scope cimc

Enters CIMC command mode.

Step 2

Server /cimc # factory-default

After a prompt to confirm, the CIMC resets to factory defaults.

The CIMC factory defaults include the following conditions:

  • SSH is enabled for access to the CIMC CLI.

  • HTTPS is enabled for access to the CIMC GUI.

  • A single user account exists (username is admin, and the password is password).

  • DHCP is enabled on the management port.

  • The boot order is CDROM, PXE (using LoM), FDD, HDD.

  • KVM and vMedia are enabled.

  • USB is enabled.

  • SoL is disabled.

Example

This example resets the CIMC to factory defaults:

Server# scope cimc
Server /cimc # factory-default
This operation will reset the CIMC configuration to factory default. 
All your configuration will be lost.
Continue?[y|N]

Exporting and Importing the CIMC Configuration

Exporting and Importing the CIMC Configuration

To perform a backup of the CIMC configuration, you can take a snapshot of the system configuration and export the resulting CIMC configuration file to a location on your network. The export operation saves information from the management plane only; it does not back up data on the servers. Sensitive configuration information such as user accounts and the server certificate are not exported.

You can restore an exported CIMC configuration file to the same system or you can import it to another CIMC system, provided that the software version of the importing system is the same as or is configuration-compatible with the software version of the exporting system. When you import a configuration file to another system as a configuration template, you must modify system-specific settings such as IP addresses and host names. An import operation modifies information on the management plane only.

The CIMC configuration file is an XML text file whose structure and elements correspond to the CIMC command modes.

When performing an export or import operation, consider these guidelines:

  • You can perform an export or an import while the system is up and running. While an export operation has no impact on the server or network traffic, some modifications caused by an import operation, such as IP address changes, can disrupt traffic or cause a server reboot.

  • You cannot execute an export and an import simultaneously.

Exporting the CIMC Configuration


Note


For security reasons, this operation does not export user accounts or the server certificate.


Before you begin

  • Obtain the backup TFTP server IP address.

  • If you want the option to restore the SNMP configuration information when you import the configuration file, make sure thatSNMP is enabled on this server before you create the configuration file. If SNMP is disabled when you export the configuration, the CIMC will not apply the SNMP values when the file is imported.

Procedure

  Command or Action Purpose

Step 1

Server # scope cimc

Enters CIMC command mode.

Step 2

Server /cimc # scope import-export

Enters import-export command mode.

Step 3

Server /cimc/import-export # export-config tftp-ip-address path-and-filename

Starts the backup operation. The configuration file will be stored at the specified path and file name on the TFTP server at the specified IP address.

To determine whether the export operation has completed successfully, use the show detail command. To abort the operation, type CTRL+C.

Example

This example shows how to back up the CIMC configuration:

Server# scope cimc
Server /cimc # scope import-export
Server /cimc/import-export # export-config 192.0.2.34 /ucs/backups/cimc5.xml
Export config started. Please check the status using "show detail". 
Server /cimc/import-export # show detail
Import Export: Operation: EXPORT Status: COMPLETED
Error Code: 100 (No Error) Diagnostic Message: NONE

Server /cimc/import-export #

Importing a CIMC Configuration

Before you begin

If you want to restore the SNMP configuration information when you import the configuration file, make sure that SNMP is disabled on this server before you do the import. If SNMP is enabled when you perform the import, the CIMC does not overwrite the current values with those saved in the configuration file.

Procedure

  Command or Action Purpose

Step 1

Server # scope cimc

Enters CIMC command mode.

Step 2

Server /cimc # scope import-export

Enters import-export command mode.

Step 3

Server /cimc/import-export # import-config tftp-ip-address path-and-filename

Starts the import operation. The configuration file at the specified path and file name on the TFTP server at the specified IP address will be imported.

To determine whether the import operation has completed successfully, use the show detail command. To abort the operation, type CTRL+C.

Example

This example shows how to import a CIMC configuration:

Server /cimc/import-export # import-config tftp 192.0.2.34 /ucs/backups/cimc5.xml
Passphrase:
Import config started. Please check the status using "show detail".

Server /cimc/import-export # show detail
Import Export:
Operation: IMPORT
Status: TRANSFERING
Error Code: 0 (No Error)
Diagnostic Message: NONE
Server /cimc/import-export #