|C H A P T E R 3|
ILOM Command-Line Interface and Log In
The ILOM command-line interface (CLI) enables you to use keyboard commands to configure and manage many ILOM features and functions. Any task that you can perform using the ILOM web interface has an equivalent ILOM CLI command.
This chapter includes the following sections:
|Note - Syntax examples in this chapter use the target starting with /SP/, which could be interchanged with the target starting with /CMM/ depending on your Sun server platform. Subtargets are common across all Sun server platforms.|
The ILOM command-line interface (CLI) is based on the Distributed Management Task Force specification, Server Management Command-Line Protocol Specification, version 11.0a.8 Draft (DMTF CLP). You can view the entire specification at the following site:
The DMTF CLP provides a management interface for one or more servers regardless of server state, method of access, or installed operating system.
The DMTF CLP architecture models a hierarchical namespace, a predefined tree that contains every managed object in the system. In this model, a small number of commands operate on a large namespace of targets, which can be modified by options and properties. This namespace defines the targets for each command verb.
The following table lists the various hierarchy methods you can use with the ILOM CLI, depending on the particular Sun server platform that you are using.
The targets and properties below this target type provide inventory, environmentals, and hardware management. The targets directly correspond to nomenclature for all hardware components, some of which are printed onto the physical hardware.
On blade platforms, this target type replaces /SYS and provides inventory, environmentals, and hardware management at the chassis level. The target types directly correspond to nomenclature names for all hardware components, some of which are printed onto the the physical hardware.
|Note - Your access to some of these subtrees within the hierarchy is dependent on the Sun server platform you are using.|
Service processors can access two namespaces: the /SP namespace and the overall system namespace /SYS or /HOST for SPARC-based systems. In the /SP namespace, you can manage and configure the service processor. In the /SYS or /HOST namespace you can access other information for managed system hardware.
FIGURE 3-1 /SP Example of the ILOM CLI Target Tree
For information about user privilege levels, see Roles for ILOM User Accounts.
When using the ILOM CLI, information is entered in the following order:
Command syntax: <command> <options> <target> <properties>
The following sections include more information about each part of the syntax.
The ILOM CLI supports the DMTF CLP commands listed in the following table.
CLI commands are case-sensitive.
The ILOM CLI supports the following options, but note that not every command supports every option. The help option can be used with any command.
Every object in your namespace is a target.
Properties are the configurable attributes specific to each object.
To execute most commands, specify the location of the target and then enter the command. You can perform these actions individually, or you can combine them on the same command line.
1. Navigate to the namespace using the cd command.
2. Enter the command, target, and value.
Using the syntax <command><target>=value, enter the command on a single command line.
set /SP/services/http port=80
set /SP/services/http prop1=x prop2=y
The following table provides an example and description of the individual and combined command execution methods..
This section describes how to log in to and log out of ILOM. You should first refer to Assign IP Addresses to the Sun Server Platform SP Interfaces to configure ILOM before logging in to the ILOM CLI.
ILOM supports from 5 to 10 active sessions depending on your platform, including serial, SSH, and web interface sessions. Telnet connections to ILOM are not supported.
You can access the ILOM CLI remotely through a Secure Shell (SSH) or serial connection. Secure Shell connections are enabled by default.
The following procedure shows an example using an SSH client on a UNIX system. Use an appropriate SSH client for your operating system. The default user name is root and default password is changeme.
Follow these steps to log in to ILOM using the default enabled SSH connection:
1. Type this command to log in to ILOM:
$ ssh root@ipaddress
where ipaddress is the IP address of the server SP.
2. Type this password when prompted:
After you log in to ILOM using the default user name and password, you should change the the ILOM root account password (changeme). For information about changing the root account password, see Change ILOM Root Account Password Using the CLI.
Follow this step to log out of ILOM:
Type this command to log out of ILOM: