A P P E N D I X  B

ALOM CMT Compatibility Shell

Oracle’s Sun Integrated Lights Out Manager (ILOM) for Oracle’s Sun Netra T5440 server supports some of the features of the ALOM CMT command-line interface by means of a compatiblity shell. There are significant differences between ILOM and ALOM CMT. This appendix describes those differences.

Backward Compatibility Limits

The backward compatibility shell supports some, but not all features of ALOM CMT. Some of the more significant differences between ILOM and ALOM CMT are described here or in the product notes for your server.

Adding a Commit Step to Procedures That Configure ILOM Network Configuration Properties

When changing the values of some ALOM CMT variables (such as network and serial port configuration variables), it was necessary to reset the system controller before the changes took effect. By comparison, in ILOM it is not necessary to reset the service processor after changing the values of comparable properties. In ILOM, if you change the value of the property and then reset the SP, you will lose the new property setting.

Instead, change the network configuration property then commit it using setsc netsc_commit in the the ALOM compatibility CLI or set /SP/network commitpending using the ILOM CLI. To change the serial port configuration property then commit it using setsc ser_commit in the the ALOM compatibility CLI or set /SP/serial/external commitpending using the ILOM CLI..

For example, set a static IP address using the ALOM compatiblitiy CLI:

sc> setsc netsc_ipaddr xxx.xxx.xxx.xxx
sc> setsc netsc_commit

To set the same property using the ILOM CLI:

-> set /SP/network pendingipaddress=xxx.xxx.xxx.xxx
Set ’pendingipaddress’ to ’xxx.xxx.xxx.xxx’
-> set /SP/network commitpending=true
Set ’commitpending’ to ’true’

In summary, you must commit the changes before they can take effect.

TABLE B-1   ALOM CMT commit Variables and Comparable ILOM Properties  
ALOM CMT Variable Comparable ILOM Property
netsc_commit /SP/network commitpending
ser_commit /SP/serial/external commitpending

Creating an ALOM CMT Shell

Your server is configured to operate under an ILOM shell, by default. You can create an ALOM compatibility shell if you prefer to use commands that resemble ALOM CMT commands to administer your server.

procedure icon  To Create an ALOM CMT Compatibility Shell

  1. Log onto the service processor with the username: root.

    When powered on, the SP boots to the ILOM login prompt. The factory default password is changeme.

    SUNSPxxxxxxxxxxxx login: root
    Waiting for daemons to initialize...
    Daemons ready
    Sun(TM) Integrated Lights Out Manager
    Copyright 2007 Sun Microsystems, Inc. All rights reserved.
    Use is subject to license terms.
    Warning: password is set to factory default.

  2. Create a user named admin, and set the admin account role to Administrator and the CLI mode to alom.

    -> create /SP/users/admin Enter new password: ********
    Creating user...-> set /SP/users/admin role=Administrator
    Set 'role' to 'Administrator'-> set /SP/users/admin cli_mode=alomSet 'cli_mode' to 'alom'
    Enter new password again: ********
    Created /SP/users/admin

    Note - The asterisks in the example will not appear when you enter your password.

    You can combine the create and set commands on a single line:

    -> create /SP/users/admin role=Administrator cli_mode=alomEnter new password: ********
    Creating user...
    Creating user...
    Enter new password again: ********
    Created /SP/users/admin

  3. Log out of the root account after you have finished creating the admin account.

    -> exit

  4. Log in to the ALOM CLI shell (indicated by the sc> prompt) from the ILOM login prompt

    SUNSPxxxxxxxxxxxx login: admin
    Waiting for daemons to initialize...
    Daemons ready
    Sun(TM) Integrated Lights Out Manager
    Copyright 2007 Sun Microsystems, Inc. All rights reserved.
    Use is subject to license terms.

    Using the ALOM CMT compatibility shell (with few exceptions) you can use commands that resemble the commands of ALOM CMT. Remember that the ALOM CMT compatibility shell is an ILOM interface. The comparisons between the ILOM CLI and ALOM CMT compatibility CLI are described in ILOM and ALOM CMT Command Comparison.

ILOM and ALOM CMT Command Comparison

The following table provides a command-by-command comparison between the command sets of ALOM CMT and the default ILOM CLI command set. Only the supported ALOM CMT command options are listed in TABLE B-2. Where there are ALOM CMT command-line arguments that have no corresponding ILOM properties, those ALOM CMT arguments have been omitted. The command set of the ALOM compatibility shell provides a close approximation of the equivalent commands and arguments (where supported) in ALOM CMT.


TABLE B-2   ALOM CMT Shell Commands by Function 
ALOM CMT Command Summary Comparable ILOM Command
Configuration Commands

password Changes the login password of the current user. set /SP/users/username password
restartssh Restarts the SSH server so that new host keys generated by the ssh-keygen command are reloaded. set /SP/services/ssh restart_sshd_action=true
setalarm critical| major|minor|user on|off Turns the alarm and associated LED on and off. set /SYS/MINOR_ALARM value=on
setdate [[mmdd]HHMM |mmddHHMM[cc]yy][.SS] Sets ALOM CMT date and time. set /SP/clock datetime=value
setdefaults [–a] Resets all ALOM CMT configuration parameters to their default values. The –a option resets the user information to the factory default (one admin account only). set /SP reset_to_defaults=all
setkeyswitch [normal|stby|diag| locked] Set the status of the virtual keyswitch. Setting the virtual keyswitch to standby (stby) powers off the server. Before powering off the host server, ALOM CMT asks for a confirmation. set /SYS keyswitch_state=value
setsc [param] [value] Sets the specified ALOM CMT parameter to the assigned value. set target property=value

setupsc Runs the interactive configuration script. This script configures the ALOM CMT configuration variables. No equivalent in ILOM

showplatform [–v] Displays information about the host system’s hardware configuration, and whether the hardware is providing service. The –v option displays verbose information about the displayed components. show /HOST

showfru Displays information about the field-replaceable units (FRUs) in a host server. No equivalent in ILOM

showusers [–g lines] Displays a list of users currently logged in to ALOM CMT. The display for this command has a similar format to that of the UNIX command who. The –g option pauses the display after the number of lines you specify for lines. show /SP/sessions

showhost [version] Displays version information for host-side components show /HOST

showkeyswitch Displays status of virtual keyswitch. show /SYS keyswitch_state

showsc [param] Displays the current non-volatile read-only memory (NVRAM) configuration parameters. show target property

showdate Displays the ALOM CMT date. ALOM CMT time is expressed in Coordinated Universal Time (UTC) rather than local time. The Solaris OS and ALOM CMT time are not synchronized. show /SP/clock datetime

ssh-keygen –l -t (rsa|dsa) Generates Secure Shell (SSH) host keys and displays the host key fingerprint on the SC. show /SP/services/ssh/keys/dsa

show /SP/services/ssh/keys/rsa

usershow [username] Displays a list of all user accounts, permission levels, and whether passwords are assigned. show /SP/users

useradd username Adds a user account to ALOM CMT. create /SP/users/username

userdel username

userdel –y username

Deletes a user account from ALOM CMT. The –y option enables you to skip the confirmation question. delete /SP/users/username

delete –script /SP/users/username

userpassword [username] Sets or changes a user password. set /SP/users/username password

userperm [username] [c] [u] [a] [r] Sets the permission level for a user account. set /SP/users/username role=permissions

(where permissions are Administrator or Operator)

Log Commands    
showlogs [–p logtype [p]] Displays the history of all events logged in the ALOM CMT RAM event log, or major and critical events in the persistent log. The –p option selects whether to display entries only from the RAM event log (logtype r) or the persistent event log (logtype p). show /SP/logs/event/list

consolehistory [–b lines|–e lines|–v] [–g lines] [boot|run] Displays the host server console output buffers. No equivalent in ILOM

Status and Control Commands

showenvironment Displays the environmental status of the host server. This information includes system temperatures, power supply status, front panel LED status, hard disk drive status, fan status, voltage, and current sensor status. show –o table –level all /SYS

shownetwork [–v] Displays the current network configuration information. The –v option shows additional information about your network, including information about your DHCP server. show /SP/network

console [–f] Connects to the host system console. The –f option forces the console write lock from one user to another. start /SP/console

break [–c]

break [–D]

Drops the host server from running the Solaris OS software into OpenBoot PROM or kmdb, depending upon the mode in which the Solaris software was booted. set /HOST send_break_action=break

set /HOST send_break_action=dumpcore

bootmode [normal] [reset_nvram] [config=configname] [bootscript=string] Controls the host server OpenBoot PROM firmware method of booting. set /HOST/bootmode property=value

(where property is state, config, or script)

flashupdate –s IPaddr –f pathname [–v] Downloads and updates system firmware (both host firmware and ALOM CMT firmware). For ILOM, ipaddr must be a TFTP server. If DHCP is used, ipaddr can be replaced by the name of the TFTP host. load –source tftp://ipaddr/pathname

reset [–c]

reset [–y] [–c]

Attempts to gracefully reset the system. If that fails this option forcefully resets the system. reset /SYS

reset –script /SYS

reset -f Forcefully resets the system reset -f /SYS
reset -d Attempts to gracefully reset the control domain. If that fails, this option forcefully resets the control domain. reset /HOST/domain/control
reset [-d][-f] Forcefully resets the control domain. reset -f /HOST/domain/control
reset [-d][-n] When resetting the control domain, this option may automatically boot, this is default behavior when the auto-boot option is not specified. set /HOST/domain/control auto-boot=disable reset /HOST/domain/control
reset [-d][-f][-n] When resetting the control domain, this option does not automatically boot and stays at the OpenBoot ok prompt. This option overrides all reboot variables and stops the control domain at the OpenBoot ok prompt after host reset. The auto-boot? option remains unchanged, thus subsequent reset commands automatically reboot host if the auto-boot? option is set to true. set /HOST/domain/control auto-boot=disable reset -f /HOST/domain/control
powercycle [–y][–f]

powercycle –y

powercycle -f

poweroff followed by poweron. The –f option forces an immediate poweroff, otherwise the command attempts a graceful shutdown. stop /SYS

start /SYS

stop –script /SYS

start –script /SYS

stop –force /SYS

start –force /SYS


poweroff –y

poweroff –f

Removes the main power from the host server. The –y option enables you to skip the confirmation question. ALOM CMT attempts to shut the server down gracefully. The –f option forces an immediate shutdown. stop /SYS

stop –script /SYS

stop –force /SYS

poweron Applies the main power to the host server or FRU. start /SYS

setlocator [on/off] Turns the Locator LED on the server on or off. set /SYS/LOCATE value=value

showfaults [–v] Displays current valid system faults. show /SP/faultmgmt

clearfault UUID Manually repairs system faults. set /SYS/component clear_fault_action=true

showlocator Displays the current state of the Locator LED as either on or off. show /SYS/LOCATE

FRU Commands    
setfru –c data The –c option enables you to store information (such as inventory codes) on all FRUs in a system. set /SP customer_frudata=data

showfru [–g lines] [–s|–d] [FRU] Displays information about the FRUs in a host server. No equivalent in ILOM

removefru [–y] [FRU] Prepares a FRU (for example, a power supply) for removal. The –y option enables you to skip the confirmation question. set /SYS/PS0 prepare_to_remove_action=true

Automatic System Recovery (ASR) Commands    
enablecomponent asr-key Removes a component from the asr-db blacklist. set /SYS/component component_state=enabled

disablecomponent asr-key Adds a component to the asr-db blacklist. set /SYS/component component_state=disabled

showcomponent asr-key Displays system components and their test status (ASR state). show /SYS/component component_state

clearasrdb Removes all entries from the asr-db blacklist. No equivalent in ILOM

Other Commands    
help [command] Displays a list of all ALOM CMT commands with their syntax and a brief description of how each command works. Specifying a command name as an option enables you to view the help for that command. help

resetsc –y

Reboots ALOM CMT. The –y option enables you to skip the confirmation question. reset /SP

reset –script /SP

userclimode Sets the type of shell to shelltype, where shelltype is default or alom. set /SP/users/username cli_mode=shelltype
logout Logs out from an ALOM CMT shell session. exit

ALOM CMT Variable Comparison

The following table displays ALOM CMT variables and the ILOM properties to which they can be compared. The comparison does not imply a one-to-one mapping. To understand the ILOM properties it is necessary to view them in their own context, ILOM.

TABLE B-3   ALOM CMT Variables and Comparable ILOM Properties  
ALOM CMT Variable Comparable ILOM Property
diag_level /HOST/diag level
diag_mode /HOST/diag mode
diag_trigger /HOST/diag trigger
diag_verbosity /HOST/diag verbosity
if_connection /SP/services/ssh state
if_emailalerts /SP/clients/smtp state
if_network /SP/network state
if_snmp /SP/services/snmp
mgt_mailalert /SP/alertmgmt/rules
mgt_mailhost /SP/clients/smtp address
mgt_snmptraps /SP/services/snmp v1|v2c|v3
mgt_traphost /SP/alertmgmt/rules

/SP/services/snmp port

netsc_dhcp /SP/network pendingipdiscovery
netsc_commit /SP/network commitpending
netsc_enetaddr /SP/network macaddress
netsc_ipaddr /SP/network pendingipaddress
netsc_ipgateway /SP/network pendingipgateway
netsc_ipnetmask /SP/network pendingipnetmask
sc_backupuserdata /SP/policy BACKUP_USER_DATA
sc_clieventlevel N/A
sc_cliprompt N/A
sc_clitimeout N/A
sc_clipasswdecho N/A
sc_customerinfo /SP system_identifier
sc_escapechars /SP/console escapechars
sc_powerondelay /SP/policy HOST_POWER_ON_DELAY
sc_powerstatememory /SP/policy HOST_LAST_POWER_STATE
ser_baudrate /SP/serial/external pendingspeed
ser_data N/A
ser_parity /SP/serial/external pendingparity
ser_stopbits /SP/serial/external pendingstopbits
sys_autorestart /SP autorestart
sys_autorunonerror /SP autorunonerror
sys_eventlevel N/A
sys_enetaddr /HOST macaddress