The ILOM command-line interface (CLI) is based on the Distributed Management Task Force, Inc. (http://www.dmtf.org/standards) Server Management Command-Line Protocol Specification, version 11.0a.8 Draft. The DMTF CLP model offers a management interface for one or many servers regardless of server state, method of access, or installed operating system. The basic concept of this model is that a small number of command verbs operate on a large namespace of targets, which can be modified by options and properties.
There are two ways to manage your system using the ILOM CLI: using the Chassis Monitoring Module, or accessing the blades directly. This section addresses how to use the CLI from an SP.
Using the Chassis Monitoring Module (CMM)
Managing your system from the CMM provides you the advantage of aggregated control of the blades, and control of other chassis-level components like system fans, power supplies, and the CMM itself. Additionally from the CMM, you have the ability to drill down and manage any individual blade through its service processor (SP).
Using the SPs on the blades directly
Managing the blades directly mimics the experience of managing the blade as a stand-alone server. This approach may be useful in troubleshooting a service processor or controlling access to specific blades if you have a multi-tenant system.
You can access the ILOM command line through the serial port or remotely through a Secure Shell (SSH) connection.
Serial port – The serial port provides access to the ILOM CLI. IPMI terminal mode and PPP mode are not available on the serial port.
SSH – Secure Shell connections are enabled by default.
The ILOM supports a maximum of 10 active sessions, including SSH, and web interface sessions. Telnet connections to ILOM are not supported.
There are two privilege levels available for service processor users: Administrator and Operator. Administrators have full access to service processor functionality and Operators cannot change any ILOM configuration information.
The service processor CLI supports the following DMTF CLP command verbs.
Command |
Description |
---|---|
cd |
Navigates the object namespace. |
create |
Sets up an object in the namespace. |
delete |
Removes an object from the namespace. |
exit |
Terminates a session to the CLI. |
help |
Displays Help information about commands and targets. |
load |
Transfers a file from an indicated source to an indicated target. |
reset |
Resets the state of the target. |
set |
Sets target properties to the specified value. |
show |
Displays information about targets and properties. |
start |
Starts the target. |
stop |
Stops the target. |
version |
Displays the version of service processor firmware running. |
The DMTF CLP model focuses on a hierarchical namespace, which is a predefined tree that contains every managed object in the system. This namespace defines the targets for each command verb.
The service processors can access two namespaces: the /SP
namespace and the overall system namespace
/SYS
. In the /SP
namespace you manage and configure the service processor. In the
/SYS
namespace you access sensors and other information for managed system hardware.
Below is a diagram of the
/SP
namespace. Your
/SYS
namespace diagram is determined by the managed hardware devices in your server. You can view your /SYS
namespace by
entering the
show /SYS
command from the service processor command line.
The service processor CLI supports the following options. All options are not supported for all commands. See a specific command topic for the options that are valid
with that command. The
help
and
examine
options can be used with any command.
Option Long Form |
Short Form |
Description |
---|---|---|
-default |
Causes the verb to perform only its default functions. |
|
-display |
-d |
Shows the data the user wants to display. |
-examine |
-x |
Examines the command but does not execute it. |
-force |
-f |
Causes an immediate action instead of an orderly shutdown. |
-help |
-h |
Displays Help information. |
-level |
-l |
Executes the command for the current target and all targets contained through the level specified. |
-output |
-o |
Specifies the content and form of command output. |
-script |
Skips warnings or prompts normally associated with the command. |
|
-source |
Indicates the location of a source image. |
Every object in your namespace is a target. All targets are not supported for all commands. Each command topic lists the valid targets for that command.