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