This chapter describes how to use the ILOM's Command Line Interface (CLI). The sections include:
You can access the command line through the serial port or over the Ethernet.
The ILOM supports a maximum of 10 active sessions, including serial, SSH, and web interface sessions. You can view active sessions by entering the command show /SP/sessions.
1. Start your SSH client
2. To log in to the ILOM, type:
$ ssh root@SPipaddress
3. Type your password when prompted.
For example:
4. To log out, type exit.
1. Configure your terminal device or the terminal emulation software running on a laptop or PC to the following settings:
2. Connect a serial cable from the ILOM RJ-45 Serial Mgt port to a terminal device.
3. Press ENTER on the terminal device to establish a connection between that terminal device and the ILOM.
You should see the following prompt:
SUNSP0003BA84D777 login:
4. Log in to the ILOM and type the user name and password.
The default user name is root, and the default password is changeme.
5. To log out, type exit.
This section describes how to use CLI commands..
The CLI provides two privilege levels: Administrator and Operator. Administrators have full access to ILOM functionality and Operators have read-only access to ILOM information.
CLI commands are case-sensitive.
The syntax of a command is: <verb><options><target><properties>
The following sections describe each of these.
The CLI supports the following command verbs.
The CLI supports the following options. All options are not supported for all commands. See a specific command section for the options that are valid with that command. The help and examine options can be used with any command.
Every object in your namespace is a target. All targets are.
You can display or configure HTTP, HTTPS, and Secure Shell (SSH) services from the CLI. By default, HTTPS access is enabled.
ILOM is managed through the /SP namespace.
TABLE 3-3 shows the commands used to display access settings.
Use the set command to change properties and values for HTTP and HTTPS services.
set target [propertyname=value]
TABLE 3-3 shows the valid targets, properties, and values for HTTP, HTTPS, and SSH services.
To configure automatic redirection from HTTP to HTTPS, type:
set /SP/services/http secureredirect=true
To change the HTTPS port to 445 type:
set /SP/services/https port=445
You can use the ILOM to change the host's state and to access the host console.
To send a break to the host, type:
Escape + B (press the Escape key and type upper case B).
To power on the host, type:
start /SYS
To power off the host, type:
stop /SYS
To reset the host, type:
reset /SYS
Type the following command to start a session to the server console:
start /SP/console
Type the following command to terminate a server console session started by another user:
stop /SP/console
Host systems are equipped with sensors that show the state of critical components. For example, they record things like temperatures, voltages and fan speeds. The show command can be used to show the state of sensors. Use the command:
show /SYS/sensor
where sensor is a particular sensor. For example, the following command shows the state of sensor /PROC/P0:
For more information about sensors, including how to view them using the WebGUI, see Section 5.5, Viewing Temperature, Voltage, and Fan Sensor Readings
For details on individual sensors, see your platform supplement.
You can display or configure the ILOM network settings from the CLI.
Type the following command to display network settings:
show /SP/network
Use the set command to change properties and values for network settings.
Network settings have two sets of properties: pending and active. The active settings are the settings currently in use by the ILOM. These settings are read-only. If you want to change settings, enter the updated settings as the pending settings (pendingipaddress or pendingipgateway), then set the commitpending property to true. This prevents accidental disconnections for both port and network settings.
set target [propertyname=value]
The following targets, properties, and values are valid for ILOM network settings.
To change the IP address for the ILOM, type:
-> set /SP/network ipaddress=nnn.nn.nn.nn commitpending=true
To change the network settings from DHCP to static assigned settings, type:
-> set /SP/network pendingipdiscovery=static pendingipaddress=nnn.nn.nn.nn pendingipgateway=nnn.nn.nn.nn pendingipnetmask=nnn.nn.nn.nn commitpending=true
You can display or configure the ILOM serial port settings from the CLI. The ILOM has two serial ports: an internal host port that interfaces directly with the host server using the start /SP/console command, and an external port that is exposed on back of the server.
Type the following command to display settings for the external serial port:
show /SP/serial/external
Type the following command to display settings for the host serial port:
show /SP/serial/host
Use the set command to change properties and values for serial port settings. Port settings have two sets of properties: pending and active. The active settings are the settings currently in use by the ILOM. These settings are read-only. If you want to change settings, enter the updated settings as the pending settings, then set the commitpending property to true. This prevents accidental disconnections for both port and network settings.
set target [propertyname=value]
The following targets, properties, and values are valid for ILOM serial ports.
To change the speed (baud rate) for the host serial port from 9600 to 57600, type:
-> set /SP/serial/host pendingspeed=56000 commitpending=true
This section explains how to add, modify and delete ILOM user accounts.
The ILOM supports up to 10 user accounts, Two of those, root and anonymous, are set by default and cannot be removed. Therefore, you can configure eight additional accounts.
Each user account consists of a user name, a password, and a role.
The roles include:
Operators cannot:
Type the following command to add a local user account:
create /SP/users/username password=password role=administrator|operator
Type the following command to delete a local user account:
delete /SP/users/username
Type the following command to display information about all local user accounts:
show /SP/users
Use the set command to change passwords and roles for configured user accounts.
set target [propertyname=value]
The following targets, properties, and values are valid for local user accounts.
When changing the role for user1 from Administrator to Operator type:
-> set /SP/users/user1 role=operator
To change user1's password type:
-> set /SP/users/user1 password
Changing password for user /SP/users/user1/password...
Enter new password:********
Enter new password again:********
New password was successfully set for user /SP/users/user1.
Type the following command to display alerts:
show /SP/alert/rules
You can display clock settings or configure your clock to synchronize with one or two Network Time Protocol (NTP) servers. If you do not configure an NTP server, the time is set by the system BIOS.
Type the following command to display clock settings:
show /SP/clock
Use the set command to change properties and values for NTP servers.
set target [propertyname=value]
The following targets, properties, and values are valid for NTP servers.
To configure your clock to synchronize with an NTP server, type:
-> set /SP/clients/ntp/server/1 address=125.128.84.20
Then enable the NTP service by typing:
-> set /SP/clock/usentpserver=enabled
You can display active session, current versions, and other information about the ILOM using the CLI. TABLE 3-11 shows the commands and the information they display.
Type the following command to display the current ILOM version:
Type the following command to display the available valid targets:
help targets
You can use CLI to update the ILOM firmware. Updating the ILOM from the command line enables you to update both the ILOM firmware and the BIOS at the same time. See Section A.2.6, Using the load Command for more information.
1. If the server OS is running, perform a clean shutdown.
2. Type the following command to update the ILOM firmware:
load -source URL