Integrated Lights Out Manager (ILOM) Administration Guide for ILOM 1.1.1

This chapter describes how to use the ILOM's Command-Line Interface (CLI). The sections include:

• Section 6.1, Configuring the Serial Port
• Section 6.2, Configuring ILOM Network Settings
• Section 6.3, Setting the ILOM Clock
• Section 6.4, Resetting the ILOM
• Section 6.5, Resetting the ILOM and BIOS Passwords
• Section 6.6, Updating the ILOM Firmware
• Section 6.7, Enabling HTTP or HTTPS Web Access
• Section 6.8, Viewing ssh Settings
• Section 6.9, Displaying ILOM Information

---

6.1 Configuring the Serial Port

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 the back of the server.

6.1.1 Displaying Serial Port Settings

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

6.1.2 Configuring Serial Port Settings

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.

6.1.2.1 Syntax

set target [propertyname=value]

6.1.2.2 Targets, Properties, and Values

The following targets, properties, and values are valid for ILOM serial ports.

Example

To change the speed (baud rate) for the host serial port from 9600 to 57600, type:

-> set /SP/serial/host pendingspeed=57600 commitpending=true

---

6.2 Configuring ILOM Network Settings

You can display or configure the ILOM network settings from the CLI.

6.2.1 Displaying Network Settings

Type the following command to display network settings:

show /SP/network

6.2.2 Configuring Network Settings

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.

6.2.2.1 Syntax

set target [propertyname=value]

6.2.2.2 Targets, Properties, and Values

The following targets, properties, and values are valid for ILOM network settings.

Examples

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

---

6.3 Setting the ILOM Clock

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.

6.3.1 Displaying Clock Settings

Type the following command to display clock settings:

show /SP/clock

6.3.2 Configuring the Clock to Use NTP Servers

Use the set command to change properties and values for NTP servers.

6.3.2.1 Syntax

set target [propertyname=value]

6.3.2.2 Targets, Properties, and Values

The following targets, properties, and values are valid for NTP servers.

Example

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

6.3.3 Interpreting ILOM Clock Settings

When the ILOM reboots, the ILOM clock is set to Thu Jan 1 00:00:00 UTC 1970. The ILOM reboots as a result of the following:

• A complete system unplug/replug power cycle
• An IPMI command; for example, mc reset cold
• A command-line interface (CLI) command; for example, reset /SP
• WebGUI operation; for example, from the Maintenance tab, select Reset SP
• An ILOM firmware upgrade

After an ILOM reboot, the ILOM clock is changed by the following:

• When the host is booted - The host's BIOS unconditionally sets the ILOM time to that indicated by the host's RTC. The host's RTC is set by the following operations:
• When the host's CMOS is cleared as a result of changing the host's RTC battery or inserting the CMOS-clear jumper on the motherboard. The host's RTC starts at Jan 1 00:01:00 2002.
• When the host's operating system sets the host's RTC. The BIOS does not consider time zones. Solaris and Linux software respect time zones and will set the system clock to UTC. Therefore, after the OS adjusts the RTC, the time set by the BIOS will be UTC. Microsoft Windows software does not respect time zones and sets the system clock to local time. Therefore, after the OS adjusts the RTC, the time set by the BIOS will be local time.
• When the user sets the RTC using the host BIOS Setup screen.

• Continuously through NTP if NTP is enabled on the ILOM - NTP jumping is enabled, to recover quickly from an erroneous update from the BIOS or user. NTP servers provide UTC time. Therefore, if NTP is enabled on the ILOM, the ILOM clock is in UTC.
• Through the CLI, WebGUI, and IPMI

---

6.4 Resetting the ILOM

To reset the ILOM using the CLI, type reset /SP.

---

6.5 Resetting the ILOM and BIOS Passwords

This procedure causes the ILOM to reset the administration password and to clear the BIOS password.

• The administration (root) password becomes changeme.
• The BIOS password is cleared, so that when you attempt to access the BIOS, it does not prompt for a password.

This procedure requires changing a hardware jumper in your server enclosure. See your service manual for details.

---

6.6 Updating the ILOM Firmware

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

Example:

 -> load -source tftp://archive/newmainimage

Are you sure you want to load the specified file (y/n)? y

File upload is complete.

Firmware image verification is complete.

Do you want to preserve the configuration (y/n)? n

Updating firmware in flash RAM: 

.

Firmware update is complete.

ILOM will not be restarted with the new firmware.

---

6.7 Enabling HTTP or HTTPS Web Access

The ILOM allows you to enable HTTP or HTTPS, and it allows you to automatically redirect HTTP access to HTTPS. It also allows you to set the HTTP and HTTPS ports.

The properties are located in /SP/services/http and /SP/services/https.

Use the set command to change properties and values as follows:

6.7.0.1 Targets, Properties, and Values

The following table shows the properties and values for HTTP and HTTPS.

---

6.8 Viewing ssh Settings

Use the show command to view ssh settings. These are read-only values that you can display but not write.

TABLE 6-6 shows the valid targets and properties for ssh values.

Use the show command to enter dsa or rsa values.

Example:

 -> show /SP/services/ssh/keys/dsa

 /SP/services/ssh/keys/dsa

    Targets:

    Properties:

        fingerprint = f7:49:85:b0:e3:65:c0:d0:96:48:06:f5:8c:b7:9c:6b

        length = 1024

        publickey = AAAAB3NzaC1kc3MAAACBAKh+LPnkehPiIou96JraqiZ7qjJ4KTc4DdNJ3ZkBZ94XKrz2B5BNROCL7h4Gb7uAaMZEgtpPqefKy5awEvkA8jNyL5P=

    Commands:

        cd

        show

-> 

---

6.9 Displaying ILOM Information

You can display active sessions, current versions, and other information about the ILOM using the CLI. TABLE 6-7 shows the commands and the information they display.

6.9.1 Displaying Version Information

Type the following command to display the current ILOM version:

version

For example:

-> version

SP firmware 1.1.1

SP firmware build number: r14021

SP firmware date: Fri Oct 13 21:18:44 PDT 2006

SP filesystem version: 0.1.14

-> 

6.9.2 Displaying Available Targets

Type the following command to display the available valid targets:

help targets

Integrated Lights Out Manager (ILOM) Administration Guide for ILOM 1.1.1

820-0280-12

Copyright © 2007, Sun Microsystems, Inc. All Rights Reserved.