Unix Quick Reference : ILOM ( Integrated Lights out Manager) Command Line

The X4000 Family implements the ILOM – Integrated Lights Out Manager.  This is a combination of dedicated hardware and supporting software.

The Sun Fire X64 family of servers implement a technology called ILOM – Integrated Lights Out Manager where available. This is a combination of dedicated hardware and supporting software built on a service processor, integral to the platform.

Introduction

ILOM uses a hierarchical namespace.
It contains a predefined tree /SP namespace manages the ILOM. e.g. to manage users and clock settings. The SP namespace is generic over all platforms using the ILOM. /SYS namespace manages the host system. e.g. change the host state, read sensor information, and access other information for managed system hardware. The SYS namespace is unique to each platform.

 

 

Command Syntax

Command syntax can be separate or in combination:

Individually:

-> cd /SP/services/http
-> set port=80

Single combined command:

-> set /SP/services/http port=80

Useful ILOM CLI Commands:

Display SP firmware version:

-> version

Show available CLI commands:

-> show /SP/cli/commands

Display help information about commands and targets

-> help

For help specific to a command, use help followed by the command of interest, for example:

-> help start

Display status information about the controller board in your server (the command path to the board will vary within the X4000 family):

-> show /SYS/MB/P0

Connect to host serial console (host COM0):

-> start /SP/console

Power on host:

-> start /SYS

Power off host:

-> stop /SYS

Reset host:

-> reset /SYS

Reset ILOM:

-> reset /SP

Resetting the ILOM and BIOS Passwords:

Requires changing a hardware jumper within the server enclosure

Exit the ILOM CLI:

-> exit

Send break to the host:

Escape + B (press the Escape key and type upper case B)

Start the server console:

-> start /SP/console

Exit the server console   (   type ESC  –  to exit the console (usually for x86)    or     #.     –   usually for SPARC )

-> show /SP/faultmgmt

/SP/faultmgmt

Targets:
shell
0 (/SYS)
1 (/SYS/BL1)
2 (/SYS/BL2)

Properties:

Commands:
cd
show

 

> show faulty

Target               | Property                | Value
——————–+————————+———————————
/SP/faultmgmt/0      | fru                     | /SYS
/SP/faultmgmt/0/    | class                   | fault.chassis.device.missing
faults/0                          |                         |
/SP/faultmgmt/0/     | sunw-msg-id             | SPX86-8000-4S
faults/0                           |                         |
/SP/faultmgmt/0/     | uuid                    | 8acb45f9-fb70-e5d0-b73c-f8e5ea32
faults/0                           |                         | c52a
/SP/faultmgmt/0/     | timestamp               | 2010-02-19/02:58:20
faults/0                           |                         |
/SP/faultmgmt/0/     | product_serial_number | 12345678-abcdefghi
faults/0                           |                         |
/SP/faultmgmt/0/     | chassis_serial_number | 12345678-abcdefghi
faults/0                           |                         |
/SP/faultmgmt/0/     | power_supply            | 2
faults/0                           |                         |
/SP/faultmgmt/0/     | event_key               | 2
faults/0                           |                         |

The show faulty command is a shortcut for the following Oracle ILOM CLI command string: -> show -o table -level all /SP/faultmgmt.  It shows you all active faults in the system in a concise, tabular form. For example, it produces output similar to the following:

 

-> (

List users with open sessions to the system console (who is using the console?):

-> show /SP/sessions

Terminate a server console session started by another user:

-> stop /SP/console

Display SEL (System Event Log)

-> show /SP/logs/event/list

Clear all System Event logs:

-> set /SP/logs/event clear=true

Locate LED – a white LED to help find a server.

Enable locate LED:

-> set /SYS LOCATE=on

Disable locate LED:

-> set /SYS LOCATE=off

Configuring a Static IP Address

Set the working directory:

-> cd /SP/network

Specify a static Ethernet configuration:

-> set pendingipdiscovery=static

-> set pendingipaddress=xxx.xxx.xx.xx

-> set pendingipnetmask=yyy.yyy.yyy.y

-> set pendingipgateway=zzz.zzz.zz.zzz

-> set commitpending=true

Display the targets in SYS:

-> show /SYS /SYS

Targets: INTSW BIOS SP REAR_SVC TOP_SVC TEMP_FAULT POWER LOCATE SERVICE V_+12V V_+1V2

Display the targets with the /SYS/SASBP ? disk backplane:

-> show /SYS/SASBP /SYS/SASBP

Targets: ID0 ID1 T_AMB HDD0 HDD1 HDD2 HDD3 Properties: type = Disk Backplane Commands: cd show

Add a local user account:

-> create /SP/users/username password=password role=[administrator|operator]

Delete a User:

-> delete /SP/users/username

Displaying Users:

-> show /SP/users

Change the role of user1 to operator

-> set /SP/users/user1 role=operator

Display the role of username ‘user1’ (the role will clearly impact which command functionality is available for a user):

-> show /SP/users/user1

Change user1’s password:

-> 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

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.

Display serial port settings (on back of server):

-> show /SP/serial/external

Display settings for the host serial port (internal):

-> show /SP/serial/host

Change speed (baud rate) for host serial port:

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

Display network settings:

-> show /SP/network

Change the IP address of ILOM:

-> set /SP/network ipaddress=nnn.nn.nn.nn commitpending=true

Change HTTPS settings:

-> set /SP/services/https port=portnumber servicestate=[enabled|disabled]

Change HTTP settings, such as enabling automatic redirection to HTTPS:

-> set /SP/services/http port=portnumber secureredirect=[enabled|disabled] servicestate=[enabled|disabled]

Display clock settings:

-> show /SP/clock

Configure clock to synchronize with NTP server:

-> set /SP/clients/ntp/server/1 address=125.128.84.20

To disable use of NTP set the NTP-server IP address to none as show below:

-> set /SP/clients/ntp/server/1 address=none

Enable NTP service:

-> cd /SP/clock -> set usentpserver=enabled

Upgrade ILOM Firmware:

-> 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.

Display configured alerts:

-> show /SP/alert/rules

Display alert configuration rule in detail:

-> show /SP/alert/rules/N (where N is 1 to 15)

Configure an alert:

-> set /SP/alert/rules/1 destination=128.145.77.21 level=critical

Change an alert level to critical:

-> set /SP/alert/rules/1 level=critical

Disable an alert:

-> set /SP/alert/rules/1 level=disable

Send a test alert for all enabled rules:

-> set /SP/alert/rules testalert=true

Ramdev

Ramdev

I have started unixadminschool.com ( aka gurkulindia.com) in 2009 as my own personal reference blog, and later sometime i have realized that my leanings might be helpful for other unixadmins if I manage my knowledge-base in more user friendly format. And the result is today's' unixadminschool.com. You can connect me at - https://www.linkedin.com/in/unixadminschool/

10 Responses

  1. bitlord says:

    You have an error under the “Useful ILOM CLI Commands:” section.
    -> start /SP/console
    Power on host:

    This gives console, not power on the host. You mention this in the following section.
    Otherwise this page is very useful.
    Thank you for writing this.

  2. Ramdev Ramdev says:

    Hello,  I have added extra line breaks to avoid your confusion :). Please check now. Thanks for the feedback.

  3. bitlord says:

    Looks good. I usually use the ILOM web GUI but, sometimes you can’t do everything from the GUI. I will use your page as a guide when I use the CLI for the ILOM.

  4. inmyhead says:

    Im I the only one who can’t seem to see the various entries?
    I think its a nifty guide but most of the the supposed attached commands are missing.
    Admin,pls review the document.
    tnx

  5. bitlord says:

    Hey
    add this one.
    show /SP/faultmgmt
    It shows all the faults on the system. Can be run on chassis or the blade.

    You should also change this. You have “Exit the server console (escape key plus an opening bracket ‘(‘ ): -> (:”.
    It should be “type ESC ( to exit the console (usually for x86) or #. (usually for SPARC)

    I hope this is useful for you.

  6. bitlord says:

    You should also add this one
    show faulty
    It also shows faults on the system. You have an example on how to use this command on anther page on your site.

  7. Ramdev Ramdev says:

    Hi Anton, How are you? Thank you. I will update it for the post.

  1. September 16, 2015

    […] Read – ILOM ( Integrated Lights out Manager) Command Line […]

What is in your mind, about this post ? Leave a Reply

Close
  Our next learning article is ready, subscribe it in your email

What is your Learning Goal for Next Six Months ? Talk to us