LOMlite on the Sun Fire V120
                     ----------------------------
                       last updated 2003-09-25


what is LOMlite, and how is it useful?
--------------------------------------
LOMlite is a stripped-down version of the Lights-Out Management suite of
hardware, software, and firmware enabling such features as being able -
remotely - to power a system up and down, monitor temperature and hardware
status, reset boot parameters, and some other low-level functions. LOMlite is
always running, even when the system itself is powered-off (provided the
connection to the power source itself is live). Access to LOMlite is through:

V120 ports
----------
  2 ethernet ports (not discussed in this document)
  2 serial ports   (connect to these ports through SCS (cf. ./SCS.txt)):
    port A (ASCII)  - LOM is always connected to this port. By default, LOM
                      shares this port with the console (OpenBoot or Solaris).
    port B (Binary) - Sun recommends setting up port B for dedicated access to
                      the console, and dedicating port A to LOM.

setting up port A
-----------------
To lockdown port A (requiring passwords to log in), you must create a
passworded user account. Up to four such accounts may be created, each of
which may be given one or more of the four privilege levels:

  c - Console permission: needed to toggle between LOM and console (possible
      only when LOM and console share port A).
  u - User accounts permission: needed to create/manage LOM user accounts.
  a - Administrative permission: needed to re/set LOM config variables.
  r - Reset permission: needed to reset/power-cycle LOM.

Note that by default there are neither user accounts nor passwords, and that
all privileges are available at the LOM prompt.

- creating a (privileged) user (example):

  lom>useradd root
  lom>userpassword root
  lom>userperm root cuar
  lom>usershow # Check your work.

Once a user account has been created, a login is required to access LOM.

setting up port B - separating LOM and console
----------------------------------------------
Connect to port A, then:

  # eeprom input-device=ttyb
  # eeprom output-device=ttyb
  # init 6

You should now be able to get the console on port B, and LOM on port A.

rejoining LOM and console (default arrangement)
-----------------------------------------------
Connect to port B, then:

  # eeprom input-device=ttya
  # eeprom output-device=ttya
  # init 6

You should now be able to get either the console or LOM on shared port A only.

general notes on sharing/separating ports
-----------------------------------------
The procedures shown above have been tested to work if followed exactly. Note
that each requires access to multi-user followed by a reboot. Experiment has
shown that alternate procedures, not involving multi-user, can also work
(although in every case a firmware reset is still required). Unless the
procedures shown above are followed, however, it is possible to reach a
confused state where the console becomes unavailable in either the shared or
separated state. To recover from this situation, issue:

  lom>poweroff
  lom>bootmode forth
  lom>reset
  lom>poweron
  ok boot
  # eeprom input-device=  # Enter here the desired input port.
  # eeprom output-device= # Enter here the desired output port.
  # init 6

switching between LOM and console on shared port
------------------------------------------------
From LOM to console (OpenBoot or Solaris):

  lom>console

From console to LOM:

  ok #.     # From OpenBoot.
  # #.      # From Solaris.

Notes:
 - The (default) escape sequence to return to LOM is '#.'.
 - Return to the console requires 'console' followed by TWO carriage returns.
 - 'console' appears to be functionally equivalent to 'break'.
 - Toggling between LOM and the console is only possible when port A is shared
   between them, and also requires 'c' permissions (if LOM is locked down).

commands
--------
alarmoff
alarmon
bootmode        # Enables Stop-[DFN] keyboard functionality.
break           # Functionally equivalent to 'console'.
check
chist
console         # Functionally equivalent to 'break'.
consolehistory
date
environment
faultoff
faulton
help
loghistory
logout
password
poweroff
poweron
reset
set
show
showdate
showlogs
shutdown
useradd
userdel
userpassword
userperm
usershow
version

reference and further information
---------------------------------
_Sun Fire V120 and Netra 120 Server User's Guide_ (Sun, 2001-A)