C H A P T E R  5

Using Lights Out Management and the System Controller From the Solaris OS

This chapter explains how to use the LOM-specific commands available in the Solaris OS for monitoring and managing a Sun Fire entry-level midrange system. To use these commands, you should install the Lights Out Management 2.0 packages (SUNWlomr, SUNWlomu and SUNWlomm) from the Solaris Supplemental CD. See Installing the Lights Out Management Packages for a description of how to install the LOM packages.



Note - The latest patches to these packages is available from SunSolve in patch 110208. It is strongly advised that the latest version of patch 110208 be obtained from SunSolve and be installed on the Sun Fire entry-level midrange system to make use of the latest LOM utility updates.



This chapter includes the following topics:


LOM Command Syntax

lom [-c] [-l] [-f] [-v] [-t] [-a] [-G] [-X]
lom -e
<n>, [x]
lom -A on|off <n>
lom -E on|off

where:

-c displays LOM configuration.

-l displays the status of the Fault and Alarms LEDs.

-e displays the event log.

-f displays fan status. This information is also displayed in the output from the Solaris prtdiag -v command.

-v displays the status of the voltage sensors. This information is also displayed in the output from the Solaris prtdiag -v command.

-t displays temperature information. This information is also displayed in the output from the Solaris prtdiag -v command.

-a displays all component status data.

-A turns alarms on and off.

-X changes the escape sequence.

-E switches event logging to the console on and off.

-G upgrades the firmware.


Monitoring the System From the Solaris OS

There are two ways of interrogating the LOM device (SC) or of sending it commands to perform:

The Solaris commands described in this section, which are all available from the UNIX # prompt, run the /usr/sbin/lom utility.

Where appropriate, the command lines given in this section are accompanied by typical output from the commands.

Viewing Online LOM Documentation

single-step bulletTo view the manual pages for the LOM utility, type:


# man lom

Viewing the LOM Configuration (lom -c)

single-step bulletTo view the current LOM configuration, type:


CODE EXAMPLE 5-1 Sample Output from the lom -c Command
# lom -c
LOM configuration settings:
serial escape sequence=#.
serial event reporting=default
Event reporting level=fatal, warning & information
firmware version=5.17.0, build 5.0
product ID=Netra T12

Checking the Status of the Fault LED and Alarms (lom -l)

single-step bulletTo check whether the System Fault LED and alarms are on or off, type:


CODE EXAMPLE 5-2 Sample Output from the lom -l Command
# lom -l
LOM alarm states:
Alarm1=off
Alarm2=off
Alarm3=on
Fault LED=off
# 

Alarms 1 and 2 are software flags. They are associated with no specific conditions but are available to be set by your own processes or from the command line (see Turning Alarms On and Off (lom -A)). Alarm 3 is UNIX Running and is not user-configurable.

Viewing the Event Log (lom -e)

single-step bulletTo see the event log, type:


# lom -e n,[x]

where n is the number of reports (up to 128) that you want to see and x specifies the level of reports you are interested in. There are four levels of event:

1. Fatal events

2. Warning events

3. Information events

4. User events (not used on Sun Fire entry-level midrange systems systems)

If you specify a level, you will see reports for that level and above. For example, if you specify level 2, you will see reports of level 2 and level 1 events. If you specify level 3, you will see reports of level 3, level 2, and level 1 events.

If you do not specify a level, you will see reports of level 3, level 2, and level 1 events.

CODE EXAMPLE 5-3 shows a sample event log display.


CODE EXAMPLE 5-3 Sample LOM Event Log (Oldest Event Reported First)
# lom -e 11
LOMlite Event Log:
 Fri Jul 19 15:16:00 commando-sc lom: Boot: ScApp 5.13.0007, RTOS 23
 Fri Jul 19 15:16:06 commando-sc lom: Caching ID information
 Fri Jul 19 15:16:08 commando-sc lom: Clock Source: 75MHz
 Fri Jul 19 15:16:10 commando-sc lom: /N0/PS0: Status is OK
 Fri Jul 19 15:16:11 commando-sc lom: /N0/PS1: Status is OK
 Fri Jul 19 15:16:11 commando-sc lom: Chassis is in single partition mode.
 Fri Jul 19 15:27:29 commando-sc lom: Locator OFF
 Fri Jul 19 15:27:46 commando-sc lom: Alarm 1 ON
 Fri Jul 19 15:27:52 commando-sc lom: Alarm 2 ON
 Fri Jul 19 15:28:03 commando-sc lom: Alarm 1 OFF
 Fri Jul 19 15:28:08 commando-sc lom: Alarm 2 OFF

Checking the Fans (lom -f)

single-step bulletTo check status of the fans, type:


CODE EXAMPLE 5-4 Sample Output From the lom -f Command
# lom -f
Fans:
1 OK speed self-regulating
2 OK speed self-regulating
3 OK speed self-regulating
4 OK speed self-regulating
5 OK speed self-regulating
6 OK speed self-regulating
7 OK speed self-regulating
8 OK speed self-regulating
9 OK speed 100 %
10 OK speed 100 %
#

If you need to replace a fan, contact your local Sun sales representative and quote the part number of the component you need. For information, see the Sun Fire V1280/Netra 1280 Service Manual or Sun Fire E2900 System Service Manual.

The information output from this command is also contained in the output from the Solaris prtdiag -v command.

Checking the Internal Voltage Sensors (lom -v)

The -v option displays the status of the Sun Fire entry-level midrange system internal voltage sensors.

single-step bulletTo check the status of the supply rails and internal voltage sensors, type:


CODE EXAMPLE 5-5 Sample Output From the lom -v Command
# lom -v
Supply voltages:
 1 SSC1       v_1.5vdc0   status=ok
 2 SSC1       v_3.3vdc0   status=ok
 3 SSC1       v_5vdc0     status=ok
 4 RP0        v_1.5vdc0   status=ok
 5 RP0        v_3.3vdc0   status=ok
 6 RP2        v_1.5vdc0   status=ok
 7 RP2        v_3.3vdc0   status=ok
 8 SB0        v_1.5vdc0   status=ok
 9 SB0        v_3.3vdc0   status=ok
10 SB0/P0     v_cheetah0  status=ok
11 SB0/P1     v_cheetah1  status=ok
12 SB0/P2     v_cheetah2  status=ok
13 SB0/P3     v_cheetah3  status=ok
14 SB2        v_1.5vdc0   status=ok
15 SB2        v_3.3vdc0   status=ok
16 SB2/P0     v_cheetah0  status=ok
17 SB2/P1     v_cheetah1  status=ok
18 SB2/P2     v_cheetah2  status=ok
19 SB2/P3     v_cheetah3  status=ok
20 IB6        v_1.5vdc0   status=ok
21 IB6        v_3.3vdc0   status=ok
22 IB6        v_5vdc0     status=ok
23 IB6        v_12vdc0    status=ok
24 IB6        v_3.3vdc1   status=ok
25 IB6        v_3.3vdc2   status=ok
26 IB6        v_1.8vdc0   status=ok
27 IB6        v_2.4vdc0   status=ok
System status flags:
 1 PS0        status=okay
 2 PS1        status=okay
 3 FT0        status=okay
 4 FT0/FAN0   status=okay
 5 FT0/FAN1   status=okay
 6 FT0/FAN2   status=okay
 7 FT0/FAN3   status=okay
 8 FT0/FAN4   status=okay
 9 FT0/FAN5   status=okay
10 FT0/FAN6   status=okay
11 FT0/FAN7   status=okay
12 RP0        status=okay
13 RP2        status=okay
14 SB0        status=ok
15 SB0/P0     status=online
16 SB0/P0/B0/D0 status=okay
17 SB0/P0/B0/D1 status=okay
18 SB0/P0/B0/D2 status=okay
19 SB0/P0/B0/D3 status=okay
20 SB0/P1     status=online
21 SB0/P1/B0/D0 status=okay
22 SB0/P1/B0/D1 status=okay
23 SB0/P1/B0/D2 status=okay
24 SB0/P1/B0/D3 status=okay
25 SB0/P2     status=online
26 SB0/P2/B0/D0 status=okay
27 SB0/P2/B0/D1 status=okay
28 SB0/P2/B0/D2 status=okay
29 SB0/P2/B0/D3 status=okay
30 SB0/P3     status=online
31 SB0/P3/B0/D0 status=okay
32 SB0/P3/B0/D1 status=okay
33 SB0/P3/B0/D2 status=okay
34 SB0/P3/B0/D3 status=okay
35 SB2        status=ok
36 SB2/P0     status=online
37 SB2/P0/B0/D0 status=okay
38 SB2/P0/B0/D1 status=okay
39 SB2/P0/B0/D2 status=okay
40 SB2/P0/B0/D3 status=okay
41 SB2/P1     status=online
42 SB2/P1/B0/D0 status=okay
43 SB2/P1/B0/D1 status=okay
44 SB2/P1/B0/D2 status=okay
45 SB2/P1/B0/D3 status=okay
46 SB2/P2     status=online
47 SB2/P2/B0/D0 status=okay
48 SB2/P2/B0/D1 status=okay
49 SB2/P2/B0/D2 status=okay
50 SB2/P2/B0/D3 status=okay
51 SB2/P3     status=online
52 SB2/P3/B0/D0 status=okay
53 SB2/P3/B0/D1 status=okay
54 SB2/P3/B0/D2 status=okay
55 SB2/P3/B0/D3 status=okay
56 IB6        status=ok
57 IB6/FAN0   status=okay
58 IB6/FAN1   status=okay
# 

The information output from this command is also contained in the output from the Solaris prtdiag -v command.

Checking the Internal Temperature (lom -t)

single-step bulletTo check the internal temperature of the system and also the system's warning and shutdown threshold temperatures, type:


CODE EXAMPLE 5-6 Sample Output from the lom -t Command
# lom -t
System Temperature Sensors:
 1 SSC1       t_sbbc0       36 degC : warning 102 degC : shutdown 107 degC
 2 SSC1       t_cbh0        45 degC : warning 102 degC : shutdown 107 degC
 3 SSC1       t_ambient0    23 degC : warning 82 degC : shutdown 87 degC
 4 SSC1       t_ambient1    21 degC : warning 82 degC : shutdown 87 degC
 5 SSC1       t_ambient2    28 degC : warning 82 degC : shutdown 87 degC
 6 RP0        t_ambient0    22 degC : warning 82 degC : shutdown 87 degC
 7 RP0        t_ambient1    22 degC : warning 53 degC : shutdown 63 degC
 8 RP0        t_sdc0        62 degC : warning 102 degC : shutdown 107 degC
 9 RP0        t_ar0         47 degC : warning 102 degC : shutdown 107 degC
10 RP0        t_dx0         62 degC : warning 102 degC : shutdown 107 degC
11 RP0        t_dx1         65 degC : warning 102 degC : shutdown 107 degC
12 RP2        t_ambient0    23 degC : warning 82 degC : shutdown 87 degC
13 RP2        t_ambient1    22 degC : warning 53 degC : shutdown 63 degC
14 RP2        t_sdc0        57 degC : warning 102 degC : shutdown 107 degC
15 RP2        t_ar0         42 degC : warning 102 degC : shutdown 107 degC
16 RP2        t_dx0         53 degC : warning 102 degC : shutdown 107 degC
17 RP2        t_dx1         56 degC : warning 102 degC : shutdown 107 degC
18 SB0        t_sdc0        48 degC : warning 102 degC : shutdown 107 degC
19 SB0        t_ar0         39 degC : warning 102 degC : shutdown 107 degC
20 SB0        t_dx0         49 degC : warning 102 degC : shutdown 107 degC
21 SB0        t_dx1         54 degC : warning 102 degC : shutdown 107 degC
22 SB0        t_dx2         57 degC : warning 102 degC : shutdown 107 degC
23 SB0        t_dx3         53 degC : warning 102 degC : shutdown 107 degC
24 SB0        t_sbbc0       53 degC : warning 102 degC : shutdown 107 degC
25 SB0        t_sbbc1       40 degC : warning 102 degC : shutdown 107 degC
26 SB0/P0     Ambient       29 degC : warning 82 degC : shutdown 87 degC
27 SB0/P0     Die           57 degC : warning 92 degC : shutdown 97 degC
28 SB0/P1     Ambient       27 degC : warning 82 degC : shutdown 87 degC
29 SB0/P1     Die           51 degC : warning 92 degC : shutdown 97 degC
30 SB0/P2     Ambient       27 degC : warning 82 degC : shutdown 87 degC
31 SB0/P2     Die           53 degC : warning 92 degC : shutdown 97 degC
32 SB0/P3     Ambient       29 degC : warning 82 degC : shutdown 87 degC
33 SB0/P3     Die           50 degC : warning 92 degC : shutdown 97 degC
34 SB2        t_sdc0        51 degC : warning 102 degC : shutdown 107 degC
35 SB2        t_ar0         40 degC : warning 102 degC : shutdown 107 degC
36 SB2        t_dx0         52 degC : warning 102 degC : shutdown 107 degC
37 SB2        t_dx1         54 degC : warning 102 degC : shutdown 107 degC
38 SB2        t_dx2         61 degC : warning 102 degC : shutdown 107 degC
39 SB2        t_dx3         53 degC : warning 102 degC : shutdown 107 degC
40 SB2        t_sbbc0       52 degC : warning 102 degC : shutdown 107 degC
41 SB2        t_sbbc1       42 degC : warning 102 degC : shutdown 107 degC
42 SB2/P0     Ambient       27 degC : warning 82 degC : shutdown 87 degC
43 SB2/P0     Die           54 degC : warning 92 degC : shutdown 97 degC
44 SB2/P1     Ambient       26 degC : warning 82 degC : shutdown 87 degC
45 SB2/P1     Die           53 degC : warning 92 degC : shutdown 97 degC
46 SB2/P2     Ambient       27 degC : warning 82 degC : shutdown 87 degC
47 SB2/P2     Die           51 degC : warning 92 degC : shutdown 97 degC
48 SB2/P3     Ambient       27 degC : warning 82 degC : shutdown 87 degC
49 SB2/P3     Die           51 degC : warning 92 degC : shutdown 97 degC
50 IB6        t_ambient0    29 degC : warning 82 degC : shutdown 87 degC
51 IB6        t_ambient1    29 degC : warning 82 degC : shutdown 87 degC
52 IB6        t_sdc0        68 degC : warning 102 degC : shutdown 107 degC
53 IB6        t_ar0         77 degC : warning 102 degC : shutdown 107 degC
54 IB6        t_dx0         76 degC : warning 102 degC : shutdown 107 degC
55 IB6        t_dx1         78 degC : warning 102 degC : shutdown 107 degC
56 IB6        t_sbbc0       51 degC : warning 102 degC : shutdown 107 degC
57 IB6        t_schizo0     48 degC : warning 102 degC : shutdown 107 degC
58 IB6        t_schizo1     53 degC : warning 102 degC : shutdown 107 degC

The information output from this command is also contained in the output from the Solaris prtdiag -v command.

Viewing all Component Status Data and the LOM Configuration Data (lom -a)

single-step bulletTo view all LOM status and configuration data, type:


# lom -a


Other LOM Tasks Performed From Solaris

This section explains how to:

Turning Alarms On and Off (lom -A)

There are two alarms associated with the LOM. They are associated with no specific conditions but are software flags available to be set by your own processes or from the command line.

1. To turn an alarm on from the command line, type:


# lom -A on,n

where n is the number of the alarm you want to set: 1 or 2.

2. To turn the alarm off, type:


# lom -A off,n

where n is the number of the alarm you want to turn off: 1 or 2.

Changing the lom> Prompt Escape Sequence
(lom -X)

The character sequence #. (hash, dot) enables you to escape from the Solaris OS to the lom> prompt.

single-step bulletTo change the default escape sequence, type:


# lom -X xy

where xy are the alpha-numeric characters you want to use.



Note - Quotes may be required for special characters to be interpreted by the shell.



If you are typing at the console and type the first character of the escape sequence, there is a one-second delay before the character appears on the screen. This is because the system waits to see if the next character in the escape sequence is about to be typed. If all the characters in the escape sequence are typed then the lom> prompt appears. If the next character to be typed is not the next character in the escape sequence, then the characters belonging to the escape sequence that were typed are output to the screen.

Stopping LOM From Sending Reports to the Console When at the LOM Prompt (lom -E off)

LOM event reports can interfere with information you are attempting to send or receive on the console.

To prevent LOM messages displaying when you are at the LOM prompt, turn off serial event reporting. This is equivalent to the seteventreporting command described in the Sun Fire Entry-Level Midrange System Controller Command Reference Manual.

1. To stop the LOM from sending reports to the console, type:


# lom -E off

2. To turn serial event reporting on, type:


# lom -E on

Upgrading the Firmware (lom -G filename)

For a full description, see Chapter 11.