Cisco IOS Software Command Reference—Cisco ISR G2

This appendix provides the new Cisco IOS commands that were introduced for the E-Series Servers and NCE installed in the Cisco ISR G2.


Note

The Cisco IOS commands are sometimes updated after original publication; therefore, for updated content, review the Cisco IOS Interface and Hardware Component Command Reference at http://www.cisco.com/en/US/docs/ios-xml/ios/interface/command/ir-cr-book.html.

This appendix includes the following sections:

imc ip address default-gateway

To configure a static IP address for CIMC and the IP address of the default gateway router that CIMC must use, use the imc ip address default-gateway command in interface configuration mode. To remove the static IP address, use the no form of this command.

imc ip address ip-address subnet-mask default-gateway gateway-address

no imc ip address ip-address subnet-mask default-gateway gateway-address

Syntax Description

ip-address

IP address of CIMC.

subnet-mask

Subnet mask to append to the IP address; must be in the same subnet as the host router.

gateway-address

IP address of the default gateway router.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

15.2(4)M

This command was introduced.

Usage Guidelines

If you do not enable DHCP, you must specify a static IP address and subnet mask.

The following example shows how to configure a static IP address for CIMC: 


Router(config)# interface ucse 2/0
Router(config-if)# imc ip address 10.0.0.2 255.0.0.0 default-gateway 10.0.0.1

imc ip address dhcp

To configure a DHCP IP address for CIMC, use the imc ip address dhcp command in interface configuration mode. To remove the DHCP IP address, use the no form of the this command.

imc ip address dhcp

no imc ip address dhcp

Syntax Description

This command has no arguments or keywords.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

15.2(4)M

This command was introduced.

The following example shows how to configure a DHCP IP address for CIMC: 


Router(config)# interface ucse 2/0
Router(config-if)# imc ip address dhcp

imc vlan

To enter VLAN configuration mode for the specified VLAN number, use the imc vlan command in interface configuration mode. To remove the VLAN configuration, use the no form of this command.

imc vlan vlan-number

no imc vlan vlan-number

Syntax Description

vlan-number

IP address of the remote manager.

Command Modes


Interface configuration (config-if)

Command History

Release

Modification

15.2(4)M

This command was introduced.

The following example shows how to enter VLAN configuration mode in CIMC for a specified VLAN: 


Router(config)# interface ucse 2/0
Router(config-if)# interface vlan 40

ucse cmos-reset

To reset the BIOS CMOS, use the ucse cmos-reset command in privileged EXEC mode.

E-Series Servers Installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T

ucse slot cmos-reset

E-Series Servers and EHWIC E-Series NCE Installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M

ucse subslot slot/subslot cmos-reset

Syntax Description

slot/

Number of the router slot in which the server module is installed.

Note

 

For the EHWIC E-Series NCE, the slot number is 0.

subslot

Number of the subslot in which the server module is installed.

Note

 

For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number is 0.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

15.2(4)M

This command was introduced.

This command was supported on Cisco UCS E-Series Servers (E-Series Server) installed in an ISR G2.

15.4(3)M

This command was modified to include the subslot keyword.

This command was supported on an additional platform: the EHWIC E-Series Network Compute Engine (EHWIC E-Series NCE) installed in an ISR G2.

Usage Guidelines

This command sets the BIOS CMOS back to the factory defaults. User changes made in the BIOS will be lost.

The following example shows how to reset the BIOS CMOS in an E-Series Server installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T: 


Router# ucse 2 cmos-reset

The following example shows how to reset the BIOS CMOS in an E-Series Server or EHWIC E-Series NCE installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M: 


Router# ucse subslot 0/3 cmos-reset

ucse password-reset

To reset the BIOS, CIMC, or RAID password, use the ucse password-reset command in privileged EXEC mode.

E-Series Servers Installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T

ucse slot password-reset {BIOS | BMC | RAID}

E-Series Servers and EHWIC E-Series NCE Installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M

ucse subslot slot/subslot password-reset {BIOS | BMC | RAID}

Syntax Description

slot/

Number of the router slot in which the server module is installed.

Note

 

For the EHWIC E-Series NCE, the slot number is 0.

subslot

Number of the subslot in which the server module is installed.

Note

 

For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number is 0.

BIOS

Resets the BIOS password.

BMC

Resets the CIMC password.

RAID

Resets the RAID password.

Note

 
RAID is not applicable for the EHWIC E-Series Network Compute Engine (EHWIC E-Series NCE).

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

15.2(4)M

This command was introduced.

This command was supported on Cisco UCS E-Series Servers (E-Series Server) installed in an ISR G2.

15.4(3)M

This command was modified to include the subslot keyword.

This command was supported on an additional platform: the EHWIC E-Series NCE installed in an ISR G2.

Usage Guidelines

After this command has been entered, the system requests that a new password be set when accessing the BIOS or BMC.

RAID is not applicable for the EHWIC E-Series NCE.

The following example shows how to reset the BIOS password in an E-Series Server installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T: 


Router# ucse 2 password-reset BIOS

Reset command sent

The following example shows how to reset the BIOS password in an E-Series Server or EHWIC E-Series NCE installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M: 


Router# ucse subslot 0/3 password-reset BIOS

Reset command sent

ucse session

To start or close a host or CIMC session, use the ucse session command in privileged EXEC mode.

E-Series Servers Installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T

ucse slot session {imc [clear] | host [clear]}

E-Series Servers and EHWIC E-Series NCE Installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M

ucse subslot slot/subslot session {imc [clear] | host [clear]}


Note

The ucse slot session imc command will work only if you have configured a router-side IP address (for instance, ip unnumbered GigabitEthernet0/0) on the interface.

Syntax Description

slot/

Number of the router slot in which the server module is installed.

Note

 

For the EHWIC E-Series NCE, the slot number is 0.

subslot

Number of the subslot in which the server module is installed.

Note

 

For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number is 0.

imc

Starts a session with CIMC.

imc clear

Closes the existing CIMC session.

host

Starts a session with the host Cisco E-Series Server.

host clear

Closes the host Cisco E-Series Server session.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

15.2(4)M

This command was introduced.

This command was supported on Cisco UCS E-Series Servers (E-Series Server) installed in an ISR G2.

15.4(3)M

This command was modified to include the subslot keyword.

This command was supported on an additional platform: the EHWIC E-Series Network Compute Engine (EHWIC E-Series NCE) installed in an ISR G2.

Usage Guidelines

The imc clear and host clear commands close the active session of the CIMC or the host. As a result, the system closes the sessions of any other users currently logged in.

Only one active session is allowed in the CIMC or host at any time. If you receive a “connection refused” message when sessioning in, close the current active session by entering the imc clear or host clear commands.

The following example shows how to clear the CIMC session in an E-Series Server installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T: 


Router# ucse 2 session imc clear

The following example shows how to clear the CIMC session in an E-Series Server or EHWIC E-Series NCE installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M: 


Router# ucse subslot 0/3 session imc clear

ucse shutdown

To shut down the system gracefully, use the ucse shutdown command in privileged EXEC mode.

E-Series Servers Installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T

ucse slot shutdown

E-Series Servers and EHWIC E-Series NCE Installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M

ucse subslot slot/subslot shutdown

Syntax Description

slot/

Number of the router slot in which the server module is installed.

Note

 

For the EHWIC E-Series NCE, the slot number is 0.

subslot

Number of the subslot in which the server module is installed.

Note

 

For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number is 0.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

15.2(4)M

This command was introduced.

This command was supported on Cisco UCS E-Series Servers (E-Series Server) installed in an ISR G2.

15.4(3)M

This command was modified to include the subslot keyword.

This command was supported on an additional platform: the EHWIC E-Series Network Compute Engine (EHWIC E-Series NCE) installed in an ISR G2.

Usage Guidelines

Use this command when removing or replacing a hot-swappable module during online insertion and removal (OIR).

The following example shows how to gracefully shut down an E-Series Server installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T: 

Router# ucse 2 shutdown

The following example shows how to gracefully shut down an E-Series Server or EHWIC E-Series NCE installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M: 

Router# ucse subslot 0/3 shutdown

ucse statistics

To display or clear the reset and reload server information, use the ucse statistics command in privileged EXEC mode.

E-Series Servers Installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T

ucse slot statistics [clear]

E-Series Servers and EHWIC E-Series NCE Installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M

ucse subslot slot/subslot statistics [clear]

Syntax Description

slot/

Number of the router slot in which the server module is installed.

Note

 

For the EHWIC E-Series NCE, the slot number is 0.

subslot

Number of the subslot in which the server module is installed.

Note

 

For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number is 0.

clear

(Optional) Clears the E-Series Server’s reset and reload information.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

15.2(4)M

This command was introduced.

This command was supported on Cisco UCS E-Series Servers (E-Series Server) installed in an ISR G2.

15.4(3)M

This command was modified to include the subslot keyword.

This command was supported on an additional platform: the EHWIC E-Series Network Compute Engine (EHWIC E-Series NCE) installed in an ISR G2.

The following example shows how to display the server statistics in an E-Series Server installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T: 


Router# ucse 2 statistics

Module Reset Statistics:
  CLI reset count = 0
  CLI reload count = 0
  Registration request timeout reset count = 0
  Error recovery timeout reset count = 0
  Module registration count = 1

The following example shows how to display the server statistics in an E-Series Server or EHWIC E-Series NCE installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M: 


Router# ucse subslot 0/3 statistics

Module Reset Statistics:
  CLI reset count = 0
  CLI reload count = 0
  Registration request timeout reset count = 0
  Error recovery timeout reset count = 0
  Module registration count = 1

ucse status

To display configuration information related to the hardware and software of a server, use the ucse status command in privileged EXEC mode.

E-Series Servers Installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T

ucse slot status [detailed]

E-Series Servers and EHWIC E-Series NCE Installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M

ucse subslot slot/subslot status [detailed]

Syntax Description

slot/

Number of the router slot in which the server module is installed.

Note

 

For the EHWIC E-Series NCE, the slot number is 0.

subslot

Number of the subslot in which the server module is installed.

Note

 

For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number is 0.

detailed

(Optional) Displays detail information about the Cisco E-Series Server such as the status of the service module and settings of the reset and heartbeat-reset flags.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

15.2(4)M

This command was introduced.

This command was supported on Cisco UCS E-Series Servers (E-Series Server) installed in an ISR G2.

15.4(3)M

This command was modified to include the subslot keyword.

This command was supported on an additional platform: the EHWIC E-Series Network Compute Engine (EHWIC E-Series NCE) installed in an ISR G2.

The following example shows how to display server status in an E-Series Server installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T: 


Router# ucse 2 status

Service Module is Cisco ucse 2/0
Service Module supports session via TTY line 131
Service Module is in Steady state
Service Module reset on error is disabled
Service Module heartbeat-reset is enabled

The following example shows how to display server status in an E-Series Server or EHWIC E-Series NCE installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M: 


Router# ucse subslot 0/3 status

Service Module is Cisco ucse 0/3
Service Module supports session via TTY line 131
Service Module is in Steady state
Service Module reset on error is disabled
Service Module heartbeat-reset is enabled

ucse stop

To immediately power down the server, use the ucse stop command in privileged EXEC mode.

E-Series Servers Installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T

ucse slot stop

E-Series Servers and EHWIC E-Series NCE Installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M

ucse subslot slot/subslot stop

Syntax Description

slot/

Number of the router slot in which the server module is installed.

Note

 

For the EHWIC E-Series NCE, the slot number is 0.

subslot

Number of the subslot in which the server module is installed.

Note

 

For Cisco UCS E-Series Servers and the SM E-Series NCE, the subslot number is 0.

Command Modes


Privileged EXEC (#)

Command History

Release

Modification

15.2(4)M

This command was introduced.

This command was supported on Cisco UCS E-Series Servers (E-Series Server) installed in an ISR G2.

15.4(3)M

This command was modified to include the subslot keyword.

This command was supported on an additional platform: the EHWIC E-Series Network Compute Engine (EHWIC E-Series NCE) installed in an ISR G2.

The following example shows how to power down an E-Series Server installed in an ISR G2—Applicable from Cisco IOS Release 15.2(4)M to 15.4(2)T: 



Router# ucse 2 stop

Send server stop command

The following example shows how to power down an E-Series Server or EHWIC E-Series NCE installed in an ISR G2—Applicable in Cisco IOS Release 15.4(3)M: 



Router# ucse subslot 0/3 stop

Send server stop command

Installation Commands

Commands

Description

ucse slot imc config {restore | save} url

Saves the CIMC configuration to a file on the router’s flash drive or restores the CIMC configuration from a file on the router’s flash drive.

  • slot—Router slot number in which the E-Series Server is installed.

  • restore—Restores the CIMC configuration from a file.
  • save—Saves the CIMC configuration to a file.

  • url—The url where the configuration file is located.

ucse slot imc file delete file_name

Deletes the CIMC image file. The file must have .iso as the file extension.

  • slot—Router slot number in which the E-Series Server is installed.

  • file_name—Name of the CIMC image file to delete.

    Note

     

    The name of the file must exactly match the name of the file as displayed by the output of the show ucse slot imc files command.

ucse slot imc file download {URLurl | abort}

Downloads the CIMC image file in the background to an internal storage device. The file must have .iso as the file extension.

  • slot—Router slot number in which the E-Series Server is installed.

  • url—Downloads the file from the specified location.

  • abort—Aborts the file download operation.

imc config file file_name

Stores the CIMC configuration file into the running configuration.

  • file_name—The name of the CIMC configuration file that you want to store.

show ucse slot imc download progress

Displays the status of the CIMC firmware download.

  • slot—Router slot number in which the E-Series Server is installed.

show ucse slot imc files

Displays the CIMC installable images that are available on the local file system.

  • slot—Router slot number in which the E-Series Server is installed.

Password Reset Command

Session Command

IP Address Configuration Commands

Commands

Description

CIMC Access Commands

VLAN Command

Commands

Description

imc vlan vlan_number

no imc vlan

Enters VLAN configuration mode for the specified VLAN.

The no command removes the configuration.

Reload, Reset, Start, Stop, Shutdown Commands

RAID Commands

Commands

Description

ucse slot server raid level {0 | 1 | 5 | NONE} [use hard_drive_list}

Configures the specified RAID level on the E-Series Server.

  • slot—Router slot number in which the E-Series Server is installed.

  • 0—Data is stored evenly in stripe blocks across two or more disks without redundancy (mirroring).

    1—Data is stored in mirrored set of disk drives with an optional hot spare disk drive.

    5—Data is stored in stripe blocks with parity data staggered across all disk drives.

    NONE—Disk drives of a computer are not configured as RAID and are put in a JBOD configuration.

  • use hard_drive_list— Allows you to specify the hard disk drives (HDD) on which you want to configure RAID. Enter the list of HDDs in a comma-separated list, such as HDD1, HDD2, HDD3. This command only applies to the internal hard drives, which are named according to their physical location.

    If you do not use the use hard_drive_list command, the system combines all of the drives into a RAID array.

    Note

     

    The names of the hard drives must exactly match the names displayed by the output of the show ucse slot server boot devices command.

show ucse slot server raid level

Displays the current RAID configuration.

Statistics and Status Commands

Boot Commands

Erase Hard Drive Commands

Commands

Description

ucse slot server erase device hdd {ALL | use hard_drive_list}

Erases all existing data from the E-Series Server's hard disk drives.

  • slot—Router slot number in which the E-Series Server is installed.

  • hard_drive_list—Erases the data from the specified hard disk drives.

    Note

     

    The names of the hard disk drives must exactly match the names displayed by the output of the show ucse slot server boot devices command.

show ucse slot server erase device status

Displays the status of devices that are erased.