Oracle Integrated Lights Out Manager (ILOM) 3.0Table Of Contents Previous ChapterNext ChapterBook Index



A P P E N D I X  B

ALOM CMT Compatibility Shell

ILOM supports some of the features of the ALOM CMT command-line interface by means of a compatibility shell. There are significant differences between ILOM and ALOM CMT. This chapter describes those differences. This chapter includes the following topics:

Limits to Backward Compatibility

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 in this section or in the product notes for your server.

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

In the original ALOM CMT environment, when changing the values of some ALOM CMT variables (such as network and serial port configuration variables), it was necessary to reset the service processor (called the system controller in ALOM CMT) before the changes took effect. By comparison, in ILOM (and the ALOM CMT compatibility shell) you must commit the changed values rather than resetting the service processor.


caution icon

Caution - In ILOM, if you change the value of the property and reset the SP without committing the change, the new property setting will not be retained.


procedure icon  Commit a Change to a Network Configuration Property

  1. Change the value of the target network configuration property.

  2. Commit the change.

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


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

    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’

procedure icon  Commit a Change to a Serial Port Configuration Property

  1. Change the value of the target serial port configuration property.

  2. Use either the ALOM CMT command setsc ser_commit true or the ILOM command set /SP/serial/external commitpending=true to commit the change.

    Refer to Comparing ILOM and ALOM CMT Command for a list of variables and corresponding properties.


    ALOM CMT Variable Comparable ILOM Property
    netsc_commit /SP/network commitpending
    ser_commit /SP/serial/external commitpending

Creating an ALOM CMT Compatibility 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.


Note - If you have performed an upgrade of the firmware from an earlier version and selected the option to preserve the settings of your earlier version of ILOM, you can continue to use your prior settings (including the username admin and password) without recreating the admin username, described in this section. If you use the original password for the username root supplied with ILOM firmware, ILOM warns you that the password is still set to the factory default.


procedure icon  Create an ALOM CMT Compatibility Shell

  1. Log onto the service processor with a username that has been assigned the user management (u) role.

    When powered on, the SP boots to the ILOM login prompt.


    XXXXXXXXXXXXXXXXXX login: username
Password:
Waiting for daemons to initialize...
Daemons ready
 
Integrated Lights Out Manager
 
Version 3.0.x.x
 
Copyright 2008 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 roles to aucro 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=aucro
Set 'role' to 'aucro'
 
->set /SP/users/admin cli_mode=alom
Set 'cli_mode' to 'alom'
 


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


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


    -> create /SP/users/admin role=aucro cli_mode=alom
Creating 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.


    XXXXXXXXXXXXXXXXX login: admin
Password:
Waiting for daemons to initialize...
 
Daemons ready
 
Integrated Lights Out Manager
 
Version 3.0.x.x
 
Copyright 2008 Sun Microsystems, Inc. All rights reserved.
Use is subject to license terms.
 
sc>

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

Comparing ILOM and ALOM CMT Command

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 the tables. ALOM CMT command-line arguments that have no corresponding ILOM properties 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.


Note - By default, when displaying information ALOM CMT commands limit their output to a terse format, offering more verbose output if a –v flag is supplied with the command. ILOM’s show commands do not have a terse output format. These commands al ways provide verbose output.


ALOM CMT Shell Configuration Commands 


TABLE B-1   ALOM CMT Shell Configuration Commands
ALOM CMT Command Summary Comparable ILOM Command
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
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=[none]

setkeyswitch [normal|stby|diag| locked] Sets 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. Use the ILOM show [FRU] command to display static FRU information. (For dynamic FRU information, use the ALOM CMT showfru command.)
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 –level all –o table /SP/sessions

No equivalent in ILOM for –g option
showhost version

Displays version information for host-side components. The version option displays the same information as the showhost command with no option. show /HOST

showkeyswitch Displays status of virtual keyswitch. show /SYS keyswitch_state

showsc [param] Displays the current nonvolatile random access 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

ssh-keygen –r

ssh-keygen –t {rsa|dsa}

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

set /SP/services/ssh generate_new_key_action=true

set /SP/services/ssh generate_new_key_type=[rsa|dsa]
usershow [username] Displays a list of all user accounts and permission levels, and whether passwords are assigned. show /SP/users

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

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

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

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

ALOM CMT Shell Log Commands 


TABLE B-2   ALOM CMT Shell Log Commands
ALOM CMT Command Summary Comparable ILOM Command
showlogs -p [r|p] [–b lines|–e lines|–v] [–g lines] Displays the history of all events logged in the event log, or major and critical events in the event log. The –p option selects whether to display only major and critical events from the event log (r) or to display all of the events from the event log (p).

–g lines specifies the number of lines to display before pausing.

–e lines displays n lines from the end of the buffer.

–b lines displays n lines from the beginning of the buffer.

–v displays the entire buffer.

 show /SP/logs/event/list

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

–g lines specifies the number of lines to display before pausing.

–e lines displays n lines from the end of the buffer.

–b lines displays n lines from the beginning of the buffer.

–v displays the entire buffer.

 set /SP/console/history property=value

[set /SP/console/history property=value][set /SP/console/history property=value]

show /SP/console/history

where property can be:

line_count=[lines] default value is "" (none), meaning there is no limit to the total number of lines retrieved from the buffer.

pause_count=[count] default value is "" (none), meaning there is no limit to the count of lines displayed per pause.

start_from=[end|beginning] default value is end.

ALOM CMT Shell Status and Control Commands 


TABLE B-3   ALOM CMT Shell Status and Control Commands
ALOM CMT Command Summary Comparable ILOM Command
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

showpower [–v] Displays power metrics for the host server. show /SP/powermgmt
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.

In ILOM, the –force option terminates the console, permitting you to start a new console.

 start [–force] /SP/console

break [–D|–c]

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

[start /SP/console]
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 you use DHCP, you can replace ipaddr with the name of the TFTP host.The -y option enables you to skip the confirmation question.

The -c option enables you to update system firmware on your server without preserving configuration information.After configuration information has been deleted (by having used the -c option or the set /SP reset_to_defaults=factory command), you must use the -c option when replacing system firmware that includes ILOM 3.0 with firmware that includes ILOM 2.0. If you omit the -c option, the flashupdate command attempts to restore preserved configuration information, halting the firmware downgrade because that configuration information is absent.

 load –source tftp://ipaddr/pathname

reset [–y] [–f] [–c]

reset –d [–n] [–y] [–f] [–c]

 Generates a hardware reset on the host server.

The –y option enables you to skip the confirmation question.

The –f option forces a hardware reset.The –c option starts the console.

The –d option gracefully resets the control domain.The –n option sets the auto-boot variable to disable (lasts for one reset).The –y option enables you to skip the confirmation question.The –f option forces a hardware reset.The –c option starts the console.

 reset [-script][–force] /SYS

[start /SP/console]

[set /HOST/domain/control auto-boot=disable]

reset [–script] [–force] /HOST/domain/control

[start /SP/console]
powercycle [–y] [–f] poweroff followed by poweron. The –f option forces an immediate poweroff, otherwise the command attempts a graceful shutdown. stop [–script] [–force] /SYS

start [–script] [–force] /SYS
poweroff [–y][–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 [–script][–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 faulty

clearfault UUID Manually repairs system faults. Use the ILOM show faulty command to identify faulted components. set /SYS/component clear_fault_action=true

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


ALOM CMT Shell FRU Commands 


TABLE B-4   ALOM CMT Shell FRU Commands
ALOM CMT Command Summary Comparable ILOM Command
setfru –c data The –c option enables you to store information (such as inventory codes) on all FRUs in a system. set /SYS customer_frudata=data

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

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


ALOM CMT Shell Automatic System Recovery Commands 


TABLE B-5   ALOM CMT Shell Automatic System Recovery (ASR) Commands
ALOM CMT Command Summary Comparable ILOM Command
enablecomponent component Re-enables a component that has been disabled using the disablecomponent command. set /SYS/component component_state=enabled

disablecomponent component Disables a component. set /SYS/component component_state=disabled

showcomponent component Displays system components and their test status. show /SYS/component component_state

clearasrdb Removes all entries from the the list of disabled components. No equivalent in ILOM


ALOM CMT Shell Miscellaneous Commands


TABLE B-6   ALOM CMT Shell Miscellaneous Commands
ALOM CMT Command Summary Comparable ILOM Command
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 [–script] /SP

userclimode username shelltype 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
setsc sys_ioreconfigure value Sets the ioreconfiguration parameter to value, where value is true, false, or next-boot. set /HOST ioreconfigure=value



Oracle Integrated Lights Out Manager (ILOM) 3.0820-6892-12Table Of Contents Previous ChapterNext ChapterBook Index

Copyright © 2010, Oracle and/or its affiliates. All rights reserved.