About the ILOM CLI on the Sun Blade 8000 Series Systems

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.

About the ILOM CLI on the Sun Blade 8000

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.

Connecting to the CLI

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.

Using the CLI

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.

Syntax

The syntax of a command is: <verb><options><target><properties>

Command Verbs

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.

Object Namespace

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.

Options

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.

Targets

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.

Properties

Properties are the configurable attributes specific to each target. A target can have one or more properties. Each command topic lists the valid properties for each target.