ALOM CMT Compatibility Shell

A P P E N D I X B

ILOM 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. This appendix includes the following topics:

Backward Compatibility Limits

Creating an ALOM CMT Shell

ILOM and ALOM CMT Command Comparison

ALOM CMT Variable Comparison

Note - The ALOM compatibility CLI has been provided to aid the transition to ILOM. ILOM is a superset of the features available through the ALOM compatibility CLI.

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.

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: rootPassword:
Waiting for daemons to initialize...
 
Daemons ready
 
Sun(TM) Integrated Lights Out Manager
 
Version 2.0.0.0
 
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 Creating user...Enter new password: ********Enter new password again: ********Created /SP/users/admin
-> set /SP/users/admin role=Administrator
Set 'role' to 'Administrator'-> set /SP/users/admin cli_mode=alomSet 'cli_mode' to 'alom'

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=alomCreating user...Enter new password: ********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
Password:
Waiting for daemons to initialize...
 
Daemons ready
 
Sun(TM) Integrated Lights Out Manager
 
Version 2.0.0.0
 
Copyright 2007 Sun Microsystems, Inc. All rights reserved.
Use is subject to license terms.
 
sc>

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/ALARM/MINOR 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 Oracle 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 Oracle Solaris OS software into OpenBoot PROM or `kmdb`, depending upon the mode in which the Oracle 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 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 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`