Overview

This chapter includes the following sections:

• Overview of the Cisco UCS C-Series Rack-Mount Servers, page 1

• Overview of the Server Software, page 1
• Cisco Integrated Management Controller, page 2
• CIMC CLI, page 3

Overview of the Cisco UCS C-Series Rack-Mount Servers

The Cisco UCS C-Series rack-mount servers include the following models:
• Cisco UCS C200 Rack-Mount Server
• Cisco UCS C210 Rack-Mount Server
• Cisco UCS C220 Rack-Mount Server
• Cisco UCS C240 Rack-Mount Server
• Cisco UCS C250 Rack-Mount Server
• Cisco UCS C260 Rack-Mount Server
• Cisco UCS C460 Rack-Mount Server

Note To determine which Cisco UCS C-Series rack-mount servers are supported by this firmware release, see
the associated Release Notes. The C-Series release notes are available at the following URL: http://
www.cisco.com/en/US/products/ps10739/prod_release_notes_list.html

Overview of the Server Software

The Cisco UCS C-Series Rack-Mount Server ships with the CIMC firmware.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
OL-28993-03 1
 Overview
Cisco Integrated Management Controller

CIMC Firmware
CIMC is a separate management module built into the motherboard. A dedicated ARM-based processor,
separate from the main server CPU, runs the CIMC firmware. The system ships with a running version of the
CIMC firmware. You can update the CIMC firmware, but no initial installation is needed.

Server OS
The Cisco UCS C-Series rack servers support operating systems such as Windows, Linux, Oracle and so on.
For more information on supported operating systems, see the Hardware and Software Interoperability for
Standalone C-series servers at http://www.cisco.com/en/US/products/ps10477/prod_technical_reference_
list.html. You can use CIMC to install an OS on the server using the KVM console and vMedia.

Note You can access the available OS installation documentation from the Cisco UCS C-Series Servers
Documentation Roadmap at http://www.cisco.com/go/unifiedcomputing/c-series-doc.

Cisco Integrated Management Controller

The CIMC is the management service for the C-Series servers. CIMC runs within the server.

Note The CIMC management service is used only when the server is operating in Standalone Mode. If your
C-Series server is integrated into a UCS system, you must manage it using UCS Manager. For information
about using UCS Manager, see the configuration guides listed in the Cisco UCS B-Series Servers
Documentation Roadmap at http://www.cisco.com/go/unifiedcomputing/b-series-doc.

Management Interfaces
You can use a web-based GUI or SSH-based CLI to access, configure, administer, and monitor the server.
Almost all tasks can be performed in either interface, and the results of tasks performed in one interface are
displayed in another. However, you cannot do the following:
• Use CIMC GUI to invoke CIMC CLI
• View a command that has been invoked through CIMC CLI in CIMC GUI
• Generate CIMC CLI output from CIMC GUI

Tasks You Can Perform in CIMC

You can use CIMC to perform the following server management tasks:
• Power on, power off, power cycle, reset and shut down the server
• Toggle the locator LED
• Configure the server boot order
• View server properties and sensors
• Manage remote presence

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
2 OL-28993-03
 Overview
CIMC CLI

• Create and manage local user accounts, and enable remote user authentication through Active Directory
• Configure network-related settings, including NIC properties, IPv4, VLANs, and network security
• Configure communication services, including HTTP, SSH, and IPMI Over LAN
• Manage certificates
• Configure platform event filters
• Update CIMC firmware
• Monitor faults, alarms, and server status

No Operating System or Application Provisioning or Management

CIMC provisions servers, and as a result, exists below the operating system on a server. Therefore, you cannot
use it to provision or manage operating systems or applications on servers. For example, you cannot do the
following:
• Deploy an OS, such as Windows or Linux
• Deploy patches for software, such as an OS or an application
• Install base software components, such as anti-virus software, monitoring agents, or backup clients
• Install software applications, such as databases, application server software, or web servers
• Perform operator actions, including restarting an Oracle database, restarting printer queues, or handling
non-CIMC user accounts
• Configure or manage external storage on the SAN or NAS storage

CIMC CLI
The CIMC CLI is a command-line management interface for Cisco UCS C-Series servers. You can launch
the CIMC CLI and manage the server over the network by SSH or Telnet. By default, Telnet access is disabled.
A user of the CLI will be one of three roles: admin, user (can control, cannot configure), and read-only.

Note To recover from a lost admin password, see the Cisco UCS C-Series server installation and service guide
for your platform.

Command Modes
The CLI is organized into a hierarchy of command modes, with the EXEC mode being the highest-level mode
of the hierarchy. Higher-level modes branch into lower-level modes. You use the scope command to move
from higher-level modes to modes in the next lower level , and the exit command to move up one level in the
mode hierarchy. The top command returns to the EXEC mode.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
OL-28993-03 3
 Overview
Command Modes

Note Most command modes are associated with managed objects. The scope command does not create managed
objects and can only access modes for which managed objects already exist.

Each mode contains a set of commands that can be entered in that mode. Most of the commands available in
each mode pertain to the associated managed object. Depending on your assigned role, you may have access
to only a subset of the commands available in a mode; commands to which you do not have access are hidden.
The CLI prompt for each mode shows the full path down the mode hierarchy to the current mode. This helps
you to determine where you are in the command mode hierarchy and can be an invaluable tool when you need
to navigate through the hierarchy.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
4 OL-28993-03
 Overview
Command Modes

Command Mode Table

The following table lists the first four levels of command modes, the commands used to access each mode,
and the CLI prompt associated with each mode.

Mode Name Command to Access Mode Prompt

EXEC top command from any mode #

bios scope bios command from EXEC /bios #

mode

advanced scope advanced command from /bios/advanced #

bios mode

main scope main command from bios /bios/main #

mode

server-management scope server-management /bios/server-management #

command from bios mode

certificate scope certificate command from /certificate #

EXEC mode

chassis scope chassis command from /chassis #

EXEC mode

adapter scope adapter index command /chassis/adapter #

from chassis mode

host-eth-if scope host-eth-if command from /chassis/adapter/host-eth-if #

adapter mode

host-fc-if scope host-fc-if command from /chassis/adapter/host-fc-if #

adapter mode

port-profiles scope port-profiles command from /chassis/adapter/port-profiles #

adapter mode

vmfex scope vmfex index command from /chassis/adapter/vmfex #

adapter mode

dimm-summary scope dimm-summary index /chassis/dimm-summary #

command from chassis mode

flexflash scope flexflash index command /chassis/flexflash #

from chassis mode

operational-profiles scope operational-profile /chassis/flexflash/operational-profile

command from flexflash mode #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
OL-28993-03 5
 Overview
Command Modes

Mode Name Command to Access Mode Prompt

storageadapter scope storageadapter slot /chassis/storageadapter #
command from chassis mode

physical-drive scope physical-drive command /chassis/storageadapter/physical-drive

from storageadapter mode #

virtual-drive scope virtual-drive command /chassis/storageadapter/virtual-drive

from storageadapter mode #

cimc scope cimc command from EXEC /cimc #

mode

firmware scope firmware command from /cimc/firmware #

cimc mode

import-export scope import-export command /cimc/import-export #

from cimc mode

log scope log command from cimc /cimc/log #

mode

server scope server index command from /cimc/log/server #

log mode

network scope network command from /cimc/network #

cimc mode

ipblocking scope ipblocking command from /cimc/network/ipblocking #

network mode

tech-support scope tech-support command /cimc/tech-support #

from cimc mode

fault scope fault command from EXEC /fault #

mode

pef scope pef command from fault /fault/pef #

mode

http scope http command from EXEC /http #

mode

ipmi scope ipmi command from EXEC /ipmi #

mode

kvm scope kvm command from EXEC /kvm #

mode

ldap /ldap #

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
6 OL-28993-03
 Overview
Command Modes

Mode Name Command to Access Mode Prompt

scope ldap command from EXEC
mode

role-group scope role-group command from /ldap/role-group #

ldap mode

power-cap scope power-cap command from /power-cap #

EXEC mode

sel scope sel command from EXEC /sel #

mode

sensor scope sensor command from /sensor #

EXEC mode

snmp scope snmp command from EXEC /snmp #

mode

trap-destinations scope trap-destinations command /snmp/trap-destinations #

from snmp mode

v3users scope v3users command from /snmp/v3users #

snmp mode

sol scope sol command from EXEC /sol #

mode

ssh scope ssh command from EXEC /ssh #

mode

user scope user user-number command /user #

from EXEC mode

user-session scope user-session session-number /user-session #

command from EXEC mode

vmedia scope vmedia command from /vmedia #

EXEC mode

xmlapi scope xmlapi command from /xmlapi #

EXEC mode

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
OL-28993-03 7
 Overview
Complete a Command

Complete a Command
You can use the Tab key in any mode to complete a command. Partially typing a command name and pressing
Tab causes the command to be displayed in full or to the point where another keyword must be chosen or an
argument value must be entered.

Command History
The CLI stores all commands used in the current session. You can step through the previously used commands
by using the Up Arrow or Down Arrow keys. The Up Arrow key steps to the previous command in the history,
and the Down Arrow key steps to the next command in the history. If you get to the end of the history, pressing
the Down Arrow key does nothing.
All commands in the history can be entered again by simply stepping through the history to recall the desired
command and pressing Enter. The command is entered as if you had manually typed it. You can also recall
a command and change it before you press Enter.

Committing, Discarding, and Viewing Pending Commands

When you enter a configuration command in the CLI, the command is not applied until you enter the commit
command. Until committed, a configuration command is pending and can be discarded by entering a discard
command. When any command is pending, an asterisk (*) appears before the command prompt. The asterisk
disappears when you enter the commit command, as shown in this example:
Server# scope chassis
Server /chassis # set locator-led off
Server /chassis *# commit
Server /chassis #

You can accumulate pending changes in multiple command modes and apply them together with a single
commit command. You can view the pending commands by entering the show configuration pending
command in any command mode.

Note Committing multiple commands together is not an atomic operation. If any command fails, the successful
commands are applied despite the failure. Failed commands are reported in an error message.

Command Output Formats

Most CLI show commands accept an optional detail keyword that causes the output information to be displayed
as a list rather than a table. You can configure either of two presentation formats for displaying the output
information when the detail keyword is used. The format choices are as follows:
• Default—For easy viewing, the command output is presented in a compact list.
This example shows command output in the default format:
Server /chassis # set cli output default
Server /chassis # show hdd detail
Name HDD_01_STATUS:
Status : present

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
8 OL-28993-03
 Overview
Online Help for the CLI

Name HDD_02_STATUS:
Status : present
Name HDD_03_STATUS:
Status : present
Name HDD_04_STATUS:
Status : present

Server /chassis #

• YAML—For easy parsing by scripts, the command output is presented in the YAML (YAML Ain't
Markup Language) data serialization language, delimited by defined character strings.
This example shows command output in the YAML format:
Server /chassis # set cli output yaml
Server /chassis # show hdd detail
---
name: HDD_01_STATUS
hdd-status: present

---
name: HDD_02_STATUS
hdd-status: present

---
name: HDD_03_STATUS
hdd-status: present

---
name: HDD_04_STATUS
hdd-status: present

...

Server /chassis #

For detailed information about YAML, see http://www.yaml.org/about.html.

In most CLI command modes, you can enter set cli output default to configure the default format, or set cli
output yaml to configure the YAML format.

Online Help for the CLI

At any time, you can type the ? character to display the options available at the current state of the command
syntax.
If you have not typed anything at the prompt, typing ? lists all available commands for the mode you are in.
If you have partially typed a command, typing ? lists all available keywords and arguments available at your
current position in the command syntax.

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
OL-28993-03 9
 Overview
Online Help for the CLI

Cisco UCS C-Series Servers Integrated Management Controller CLI Configuration Guide, Release 1.5
10 OL-28993-03