| Advanced Lights Out Management (ALOM) CMT v1.3 Guide
|
   
|
Using the ALOM CMT Command Shell
|
This chapter contains the following sections:
Overview of the ALOM CMT Command Shell
The ALOM CMT command shell is a simple command-line interface (CLI). Through the ALOM CMT command shell, you can administer, diagnose, or control the host server, and you can configure and manage ALOM CMT.
You are in the ALOM CMT command shell when you see the sc> prompt. ALOM CMT supports a total of eight concurrent Telnet sessions and one serial session per server. This means that you can run nine command shell operations at once.
After you log in to your ALOM CMT account, the system controller shell prompt (sc>) appears, and you can enter ALOM CMT shell commands. See Logging In To ALOM CMT Accounts and ALOM CMT Shell Commands for assistance.
 Entering Command Options
|
If the command you want to use has multiple options, you can either enter the options individually or grouped together, as shown in this example. These two commands are identical.
sc> poweroff -f -y
sc> poweroff -fy
|
Related Information
ALOM CMT Shell Commands
The following table lists the ALOM CMT shell commands and briefly describes what these commands do.
FIGURE 6-1 List of ALOM CMT Shell Commands by Function
|
CLI Command
|
Summary
|
Full Description
|
|
Configuration Commands
|
|
password
|
Changes the login password of the current user.
|
password.
|
|
restartssh [-y]
|
Restarts the SSH server so that new host keys generated by the ssh-keygen command are reloaded.
|
restartssh
|
|
setdate [[mmdd]HHMM |mmddHHMM[cc]yy][.SS]
|
Sets ALOM CMT date and time.
|
restartssh
|
|
setdefaults [-y] [-a]
|
Resets all ALOM CMT configuration parameters to their default values. The -y option enables you to skip the confirmation question. The -a option resets the user information to the factory default (one admin account only).
|
setdefaults
|
|
setkeyswitch [normal|stby|diag|
locked] [-y]
|
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. The -y flag answers yes to the confirmation.
|
setkeyswitch
|
|
setsc [param] [value]
|
Sets the specified ALOM CMT parameter to the assigned value.
|
setsc
|
|
setupsc
|
Runs the interactive configuration script. This script configures the ALOM CMT configuration variables.
|
setupsc
|
|
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.
|
showplatform
|
|
showfru [-g lines]
[-s|-d] [FRU]
|
Displays information about the field-replaceable units (FRUs) in a host server.
|
showfru
|
|
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.
|
showusers
|
|
showhost [version]
|
Displays version information for host-side components
|
showhost
|
|
showkeyswitch
|
Display status of virtual keyswitch.
|
showkeyswitch
|
|
showsc [-v] [param]
|
Displays the current non-volatile read-only memory (NVRAM) configuration parameters. The -v option is needed for full version information.
|
showsc
|
|
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.
|
showdate
|
|
ssh-keygen [-l | -r] -t {rsa|dsa}
|
Generates Secure Shell (SSH) host keys and displays the host key fingerprint on the SC.
|
ssh-keygen
|
|
usershow [username]
|
Displays a list of all user accounts, permission levels, and whether passwords are assigned.
|
usershow
|
|
useradd [username]
|
Adds a user account to ALOM CMT.
|
useradd
|
|
userdel [-y] [username]
|
Deletes a user account from ALOM CMT. The -y option enables you to skip the confirmation question.
|
userdel
|
|
userpassword [username]
|
Sets or changes a user password.
|
userpassword
|
|
userperm [username] [c] [u] [a] [r]
|
Sets the permission level for a user account.
|
userperm
|
|
Log Commands
|
|
|
|
showlogs
[-b lines|-e lines|-v]
[-g lines] [-p logtype [r|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).
|
showlogs
|
|
consolehistory
[-b lines|-e lines|-v]
[-g lines] [boot|run]
|
Displays the host server console output buffers. The -v option displays the entire contents of the specified log.
|
consolehistory
|
|
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.
|
showenvironment
|
|
shownetwork [-v]
|
Displays the current network configuration information. The -v option shows additional information about your network, including information about your DHCP server.
|
shownetwork
|
|
console [-f]
|
Connects to the host system console. The -f option forces the console write lock from one user to another.
|
console
|
|
break [-D] [-y] [-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.
|
break
|
|
bootmode [normal] [reset_nvram] [bootscript=string]
|
Controls the host server OpenBoot PROM firmware method of booting.
|
bootmode
|
|
flashupdate -s IPaddr -f pathname [-v]
|
Downloads and updates system firmware (both host firmware and ALOM CMT firmware).
|
flashupdate
|
|
reset [-y] [-c]
|
Generates a hardware reset on the host server. The -y option enables you to skip the confirmation question.
|
reset
|
|
powercycle [-y][-f]
|
poweroff followed by poweron. The -f option forces an immediate poweroff, otherwise the command attempts a graceful shutdown.
|
powercycle
|
|
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.
|
poweroff
|
|
poweron [-c] [FRU]
|
Applies the main power to the host server or FRU.
|
poweron
|
|
setlocator [on/off]
|
Turns the Locator LED on the server on or off.
|
setlocator
|
|
showfaults [-v]
|
Displays current valid system faults.
|
showfaults
|
|
clearfault UUID
|
Manually repair system faults.
|
clearfault
|
|
showlocator
|
Displays the current state of the Locator LED as either on or off.
|
showlocator
|
|
FRU Commands
|
|
|
|
setfru -c data
|
The -c option enables you to store information (such as inventory codes) on all FRUs in a system.
|
setfru
|
|
showfru [-g lines]
[-s|-d] [FRU]
|
Displays information about the FRUs in a host server.
|
showfru
|
|
removefru [-y] [FRU]
|
Prepares a FRU (for example, a power supply) for removal. The -y option enables you to skip the confirmation question.
|
removefru
|
|
Automatic System Recovery (ASR) Commands
|
|
|
|
enablecomponent
asr-key
|
Removes a component from the asr-db blacklist.
|
enablecomponent
|
|
disablecomponent
asr-key
|
Adds a component to the asr-db blacklist.
|
disablecomponent
|
|
showcomponent asr-key
|
Displays system components and their test status (ASR state).
|
showcomponent
|
|
clearasrdb
|
Removes all entries from the asr-db blacklist.
|
clearasrdb
|
|
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.
|
resetsc
|
|
showlogs
[-b lines|-e lines|-v]
[-g lines] [-p logtype [r|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).
|
showlogs
|
|
usershow [username]
|
Displays a list of all user accounts, permission levels, and whether passwords are assigned.
|
usershow
|
|
useradd username
|
Adds a user account to ALOM CMT.
|
useradd
|
|
userdel [-y] username
|
Deletes a user account from ALOM CMT. The -y option enables you to skip the confirmation question.
|
userdel
|
|
userpassword username
|
Sets or changes a user password.
|
userpassword
|
|
userperm username [c] [u] [a] [r]
|
Sets the permission level for a user account.
|
userperm
|
|
logout
|
Logs out from an ALOM CMT shell session.
|
logout
|
Related Information
ALOM CMT Shell Command Descriptions
The following pages provide full descriptions of the ALOM CMT shell commands in alphabetical order.
bootmode
Use the bootmode command to control the behavior of the host server's firmware while the host server is initializing or after you reset the server.
The bootmode normal command option prepares the system controller firmware for reset, retaining the current settings of OpenBoot non-volatile read-only memory (NVRAM) variables
The bootmode reset_nvram command option sets the OpenBoot NVRAM variables to default settings.
|
To Use the bootmode Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for more information.
|
The bootmode command requires that you reset the host server within 10 minutes after issuing the command. If you do not issue the poweroff and poweron commands or the reset command within 10 minutes, the host server ignores the bootmode command. Refer to powercycle, poweron, and reset for more information.
At the sc> prompt, type the following command:
sc> bootmode reset_nvram
sc> reset
|
|
To View bootmode Settings
|
At the sc> prompt, type the following command:
sc> bootmode
sc> reset
Bootmode: reset_nvram
Expires WED MAR 05 21:18:33 2003
bootscript="setenv diagswitch? true"
|
bootmode Command Options
The bootmode command uses the following options.
TABLE 6-1 bootmode Command Options
|
Option
|
Description
|
|
normal
|
At next reset, retains current NVRAM variable settings
|
|
reset_nvram
|
At next reset, returns NVRAM variables to default settings
|
|
bootscript
= string
|
Controls the host server OpenBoot PROM firmware method of booting. It does not affect the current bootmode setting. string can be up to 64 bytes in length. You can specify a bootmode setting and set the bootscript within the same command.
For example:
sc> bootmode reset_nvram bootscript = "setenv diag-switch? true"
SC Alert: SC set bootmode to reset_nvram, will expire
20030305211833
SC Alert: SC set bootscript to "setenv diag-switch? true"
After the server resets and OpenBoot PROM reads the values stored in the bootscript, it sets the OpenBoot PROM variable diag-switch? to the user requested value of true.
Note: If you set bootmode bootscript = "", ALOM CMT sets the bootscript to empty.
|
If you use the bootmode command with the reset_nvram option, it resets all of the parameters in the host system's OpenBoot PROM NVRAM settings to the factory default values. You must reset the server within 10 minutes. Refer to reset.
If you use the bootmode command without specifying any option, ALOM CMT displays the currently selected mode and the time when it will expire.
Related Information
break
Use the break command to bring the server to the OpenBoot PROM prompt (ok). If you have configured the kmdb debugger, then the break command brings the server into debug mode.
This command can also be used to force a panic core dump of the Solaris OS, if the server is running a version of Solaris which supports this feature.
Make sure that the system console is directed to ALOM CMT. SeePlatform-Specific Information for further information.
To Use the break Command
|
|
Note - You must have c level user permission to use this command. Refer to userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
Where option is -D, -y, -c, or no option. These options can be combined in any way, none are mutually exclusive.
After you type the break command, the server returns the ok prompt.
break Command Options
The break command can have the following options:
TABLE 6-2 break Command Options
|
Option
|
Description
|
|
-D
|
Forces a panic coredump of the managed system OS (not supported by all OS versions).
|
|
-y
|
Instructs ALOM CMT to proceed without first asking the confirmation question: Are you sure you want to send a break to the system [y/n]?
|
|
-c
|
Instructs ALOM CMT to connect to the system console after performing the operation.
|
Related Information
clearasrdb
Use the clearasrdb command to remove all entries from the Automatic System Recovery database (asr-db) blacklist, thereby re-enabling all devices regardless of whether they have been disabled manually or disabled through POST.
|
To Use the clearasrdb Command
|
At the sc> prompt, type the following command:
clearfault
The clearfault command enables the system administrator to repair a host-reported fault manually so that it is not displayed by the showfaults command.
In this example, the showfaults command identifies a host-detected fault:
sc> showfaults
ID FRU Fault
0 MB/CMP0/CH0/R0/D0 Host detected fault, MSGID: SUN4U-8000-2S
|
Including the -v (verbose) option to the showfaults command,
sc> showfaults -v
ID Time FRU Fault
0 SEP 09 11:09:26 MB/CMP0/CH0/R0/D0 Host detected fault, MSGID:
SUN4U-8000-2S UUID: 7ee0e46b-ea64-6565-e684-e996963f7b86
|
Issuing the clearfault command without an argument causes ALOM CMT to display command usage information:
sc> clearfault
Error: Invalid command option
Usage: clearfault <UUID>
|
The clearfault command takes one argument, the universal unique identifier (UUID), a numerical string (displayed in the previous example). In this example, the UUID is supplied as an argument to the clearfault command:
sc> clearfault 7ee0e46b-ea64-6565-e684-e996963f7b86
Clearing fault from all indicted FRUs...
Fault cleared.
|
As a result of the successful use of the clearfault command, the showfault command no longer displays the host-detected fault:
sc> showfaults
No failures found in System
|
|
Note - Faults can be reported indirectly, by way of a FRU that acts as a proxy.
|
In this example, the showfru command indicates that a faulty component, HDD0 (shown initially in showfaults output), is proxied on SASBP.SEEPROM
sc> showfaults
ID FRU Fault
9 HDD0 Host detected fault, MSGID: SUNW-TEST07
|
Use the showfru command to display the event status information.
sc> showfru SASBP.SEEPROM
...
/Status_EventsR (1 iterations)
/Status_EventsR[0]
/Status_EventsR[0]/UNIX_Timestamp32: FRI MAY 20 12:16:02 2005
/Status_EventsR[0]/Old_Status: 0x00 (OK)
/Status_EventsR[0]/New_Status: 0x10 (PROXIED FAULT)
/Status_EventsR[0]/Initiator: 0xE0 (FM)
/Status_EventsR[0]/Component: 0x20
/Status_EventsR[0]/Message (FM)
/Status_EventsR[0]/FM/fault_diag_time: 0x0000000000000000
/Status_EventsR[0]/FM/diagcode: SUNW-TEST07
/Status_EventsR[0]/FM/uuid:
66616b65-7575-6964-0000-000000000000
/Status_EventsR[0]/FM/DE_Name: ALOM-DE
/Status_EventsR[0]/FM/DE_Version: v1.0
...
SEGMENT: ST
/Status_Proxy1R/
/Status_Proxy1R/UNIX_Timestamp32: FRI MAY 20 12:16:02 2005
/Status_Proxy1R/version: 0x01
/Status_Proxy1R/StatusMap31:
0x07000000000000000000000000000000000000000000000000000000000000
/Status_CurrentR/
/Status_CurrentR/UNIX_Timestamp32: FRI MAY 20 12:16:02 2005
/Status_CurrentR/status: 0x10 (PROXIED FAULT)
|
Once the faulty component (HDD0 in this example) has been replaced, you can run the clearfaults UUID command to remove the fault from the proxied SEEPROM.
console
Use the console command to enter console mode and to connect to the system console from the ALOM CMT command shell. To exit the system console and return to the ALOM CMT command shell, type #. (Hash-Period).
Although multiple users can connect to the system console from ALOM CMT, only one user at a time has write access to the console. Any characters that other users type are ignored. This is referred to as a write lock, and the other user sessions view the console session in read-only mode. If no other users have access to the system console, then the user entering the console session first obtains the write lock automatically by executing the console command. If another user has the write lock, you can use the -f option to force the console to give you the write lock. This forces the other user's connection into read-only mode.
ALOM CMT controls the flow rate of the system console to match the flow rate of the user session holding the write lock. This ensures that the user session with the write lock does not lose data. However, this arrangement can cause data loss for user sessions with read-only console access. For example, if the user session with the write lock is connected over the fast NET MGT port and a session with reader is connected over the slow SER MGT port, the console can produce output at a rate that could overrun the capacity of the reader session. To reduce the likelihood of such console data loss, each console reader session is allocated 65535 characters of buffer space.
|
To Use the console Command
|
|
Note - You must have c level user permission to use this command. Refer to userperm for information on setting user permissions.
|
1. At the sc> prompt, type the following command:
Where option is the option you want to use, if any.
|
Note - The Solaris system prompt that appears depends on the default Solaris shell on the host server. Refer to Shell Prompts
|
2. To return to the sc> prompt from the Solaris system prompt, type the escape character sequence.
The default sequence is #. (Hash-Period).
If no session has the console in use, ALOM CMT displays the following information:
sc> showusers
Username Connection Login Time Client IP Addr Console
-------------------------------------------------------------
admin serial Nov 13 6:19 system
jeff net-1 Nov 13 6:20 xxx.xxx.xxx.xxx
sc> console
Enter #. to return to ALOM.
%
|
If another session already has the write lock, ALOM CMT returns a different message at the console command as shown in this example:
sc> console
Console session already in use. [view mode]
Enter #. to return to ALOM.
%
|
If another session already has the write lock and you use -f option with the console command, ALOM CMT returns a message at the console command that is similar to the following:
sc> console -f
Warning: User <admin> currently has write permission to this
console and forcibly removing them will terminate any current write
actions and all work will be lost. Would you like to continue?
[y/n]
|
console Command Option
The console command uses one option, -f. This option forces ALOM CMT to release the write lock from another user and assign it to your console session. This places the other user's console session in read-only mode. Using this option returns the following message:.
Warning: User username currently has write permission to this
console and forcibly removing them will terminate any current write
actions and all work will be lost. Would you like to continue
[y/n]?
|
At the same time, the user who has the write lock receives the following message:
Warning: Console connection forced into read-only mode.
|
Related Information
consolehistory
Use the consolehistory command to display system console messages logged in ALOM CMT buffers. You can read the following system console logs:
- boot log - Contains POST, OpenBoot PROM, and Solaris boot messages received from the host server from the most recent reset.
- run log - Contains the most recent console output from POST, OpenBoot PROM, and Solaris boot messages. In addition, this log records output from the host server's operating system.
Each buffer can contain up to 64 Kbytes of information.
If ALOM CMT senses a host server reset, it writes boot information and initialization data into the boot log buffer. until ALOM CMT is notified by the server that the Solaris OS is up and running.
|
To Use the consolehistory Command
|
|
Note - You must have c level user permission to use this command. See userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
sc> consolehistory logname options
|
Where logname is the name of the log you want to display (boot or run). If you type the consolehistory command without an option, ALOM CMT returns the last 20 lines of the run log.
|
Note - Timestamps recorded in console logs reflect server time. These timestamps reflect local time, and ALOM CMT event logs use UTC (Coordinated Universal Time). The Solaris OS system time is completely independent of the ALOM CMT time.
|
consolehistory Command Options
The consolehistory command uses the following options for both logs. You can use the -g option in combination with the -b, -e, or -v options. If you do not specify the -g option, the screen output will not pause.:
TABLE 6-3 consolehistory Command Options
|
Option
|
Description
|
|
-b lines
|
Specifies the number of lines to display from the beginning of the log buffer. For example:
consolehistory boot -b 10
|
|
-e lines
|
Specifies the number of lines to display from the end of the log buffer. If new data appears in the log while you are executing this command, the new data is appended to the screen output. For example:
consolehistory run -e 15
|
|
-g lines
|
Specifies the number of lines to display before pausing the output to the screen. After each pause, ALOM CMT shows the following message: Paused: Press 'q' to quit, any other key to continue. For example:
consolehistory run -v -g 5
|
|
-v
|
Displays the entire contents of the specified log.
|
|
boot
|
Specifies the boot log.
|
|
run
|
Specifies the run log.
|
Related Information
disablecomponent
Use the disablecomponent command to add a component to the asr-db blacklist, thereby removing it from the system configuration. Using the disablecomponent command without any parameters causes ALOM CMT to display all asr-keys.
|
Note - The server continues to use the blacklisted component until the next server power cycle or reset.
|
|
To Use the disablecomponent Command
|
At the sc> prompt, type the following command:
sc> disablecomponent asr-device
|
For example,
sc> disablecomponent MB/CMP0/CH3/R0/D1
sc> showcomponent
Keys:
MB/CMP0/CORE0
...
MB/CMP0/P0
...
MB/CMP0/CH0/R0/D0
MB/CMP0/CH0/R0/D1
MB/CMP0/CH0/R1/D0
MB/CMP0/CH0/R1/D1
MB/CMP0/CH1/R0/D0
MB/CMP0/CH1/R0/D1
MB/CMP0/CH1/R1/D0
MB/CMP0/CH1/R1/D1
MB/CMP0/CH2/R0/D0
MB/CMP0/CH2/R0/D1
MB/CMP0/CH2/R1/D0
MB/CMP0/CH2/R1/D1
MB/CMP0/CH3/R0/D0
MB/CMP0/CH3/R0/D1
MB/CMP0/CH3/R1/D0
MB/CMP0/CH3/R1/D1
IOBD/PCIEa
IOBD/PCIEb
PCIX1
PCIX0
PCIE2
PCIE1
PCIE0
TTYA
ASR state: Disabled Devices
MB/CMP0/CH3/R0/D1 : <no reason>
|
enablecomponent
Use the enablecomponent command to remove a component from the asr-db blacklist, thereby adding the component back into the system configuration. Using the enablecomponent command without any parameters causes ALOM CMT to display all asr-keys currently blacklisted.
|
Note - The component does not return to use until the next server power cycle or reset.
|
|
To Use the enablecomponent Command
|
At the sc> prompt, type the following command:
sc> enablecomponent asr-device
|
For example,
sc> enablecomponent MB/CMP0/CH3/R0/D1
sc> showcomponent
Keys:
MB/CMP0/CORE0
...
MB/CMP0/P0
...
MB/CMP0/CH0/R0/D0
MB/CMP0/CH0/R0/D1
MB/CMP0/CH0/R1/D0
MB/CMP0/CH0/R1/D1
MB/CMP0/CH1/R0/D0
MB/CMP0/CH1/R0/D1
MB/CMP0/CH1/R1/D0
MB/CMP0/CH1/R1/D1
MB/CMP0/CH2/R0/D0
MB/CMP0/CH2/R0/D1
MB/CMP0/CH2/R1/D0
MB/CMP0/CH2/R1/D1
MB/CMP0/CH3/R0/D0
MB/CMP0/CH3/R0/D1
MB/CMP0/CH3/R1/D0
MB/CMP0/CH3/R1/D1
IOBD/PCIEa
IOBD/PCIEb
PCIX1
PCIX0
PCIE2
PCIE1
PCIE0
TTYA
ASR state: clean
|
flashupdate
Use the flashupdate command to update all system firmware from a location that you specify. The values you enter for command options specify the IP address of the site from which you download and the path at which the firmware image is located.
|
To Use the flashupdate Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.
|
To use this command, you need to know the following:
- IP address of the FTP server from which you want to download the firmware image
- Path at which the image is stored
- Username and password to enter at the prompts
If you do not have this information, ask your network administrator. Before you start, make sure that your virtual keyswitch setting is not in the LOCKED position. For more information about the virtual keyswitch, see setkeyswitch.
1. At the sc> prompt, type the flashupdate command.
Substitute the IP address of the server where the firmware image is stored for ipaddr, and the path name for pathname.
sc> flashupdate -s ipaddr -f pathname
|
2. When prompted, type your username and password.
The username and password are based on your UNIX or LDAP user name and password, and not your ALOM CMT username and password.
After you type your user name and password, the download process continues. As the download process progresses, a series of periods appear across your screen.
When the download process is finished, ALOM CMT displays the message:
Update complete. Reset device to use new image.
3. Type the resetsc command to reboot ALOM CMT.
See resetsc for details.
For example, (replace 123.45.67.89 with a valid IP address):
sc> flashupdate -s 123.45.67.89 -f filename
SC Alert: System poweron is disabled.
Username: username
Password: *******
...........................................................
...........................................................
...............................
Update complete. Reset device to use new software.
SC Alert: SC firmware was reloaded
|
flashupdate Command Options
The flashupdate command uses the following options.
TABLE 6-4 flashupdate Command Options
|
Option
|
Description
|
|
-s ipaddr
|
Directs ALOM CMT to download the firmware image from a server located at ipaddr. ipaddr describes an IP address in standard dot notation, such as 123.456.789.012.
|
|
-f pathname
|
Directs ALOM CMT to the location of the image file. pathname is a full directory path, including the name of the image file.
|
|
-v
|
Displays verbose output. This option provides detailed information about the progress of the download process as it occurs.
|
Related Information
help
Use the help command to display a list of all ALOM CMT commands and the syntax for each.
|
To Use the help Command
|
|
Note - You do not need user permissions to use this command.
|
Take one of the following actions:
- To display help for all available commands, at the sc> prompt type the following command:
- To display help for a specific command, at the sc> prompt type help and the name of the command:
Where command-name is the name of the specific command. For example:
sc> help poweroff
This command shuts down the managed system to the powered off state.
sc>
|
- To display help for a system controller parameter, at the sc> prompt type
help setsc and the name of the parameter:
Where parameter is the system controller parameter. For example:
sc> help setsc if_network
if_network
Enables or disables the SC network interface. The default is true.
sc>
|
The following example shows the output you see when you type help without specifying a command
CODE EXAMPLE 6-1 Example of the help Command Output
sc> help
Available commands
------------------
Power and Reset control commands:
powercycle [-y] [-f]
poweroff [-y] [-f]
poweron [-c] [FRU]
reset [-y] [-c]
Console commands:
break [-D] [-y] [-c]
console [-f]
consolehistory [-b lines|-e lines|-v] [-g lines] [boot|run]
Boot control commands:
bootmode [normal|reset_nvram|bootscript="string"]
setkeyswitch [-y] <normal|stby|diag|locked>
showkeyswitch
Locator LED commands:
setlocator [on|off]
showlocator
Status and Fault commands:
clearasrdb
clearfault <UUID>
disablecomponent [asr-key]
enablecomponent [asr-key]
removefru [-y] <FRU>
setfru -c [data]
showcomponent [asr-key]
showenvironment
showfaults [-v]
showfru [-g lines] [-s|-d] [FRU]
showlogs [-b lines|-e lines|-v] [-g lines] [-p logtype[r|p]]
shownetwork [-v]
showplatform [-v]
ALOM Configuration commands:
setdate <[mmdd]HHMM | mmddHHMM[cc]yy][.SS]>
setsc [param] [value]
setupsc
showdate
showhost [version]
showsc [-v] [param]
ALOM Administrative commands:
flashupdate <-s IPaddr -f pathname> [-v]
help [command]
logout
password
resetsc [-y]
restartssh [-y]
setdefaults [-y] [-a]
ssh-keygen [-l|-r] <-t {rsa|dsa}>
showusers [-g lines]
useradd <username>
userdel [-y] <username>
userpassword <username>
userperm <username> [c][u][a][r]
usershow [username]
|
Related Information
logout
Use the logout command to end your ALOM CMT session, and close your serial or network connection.
|
To Use the logout Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
Related Information
password
Use the password command to change the ALOM CMT password for the account to which you are currently logged in. This command works like the UNIX passwd(1) command.
|
To Use the password Command
|
|
Note - This command enables you to change the password for your own ALOM CMT account. You do not need user permissions to use this command. If you are an administrator and want to change a user account's password, use the userpassword command. See userpassword for more information.
|
At the sc> prompt, type password.
When you use this command, ALOM CMT prompts you for your current password. If you enter the password correctly, it prompts you twice to enter the new password.
For example:
sc> password
password: Changing password for username
Enter current password: ******
Enter new password: ******
Re-enter new password: ******
sc>
|
Password Restrictions
Passwords have the following restrictions:
- They must be between six and eight characters.
- They must contain at least two alphabetic characters (uppercase or lowercase letters) and at least one numeric or special character.
- They must differ from your login name and any reverse or circular shift of your login name. For comparison purposes, uppercase and lowercase letters are equivalent.
- They must differ from the old password by at least three characters. For comparison purposes, uppercase and lowercase letters are equivalent.
Related Information
powercycle
Performs a powercycle on the host system, where powercycle is defined as a poweroff followed by a poweron. ALOM CMT executes the poweroff command on the host system and waits for a specified number of seconds, then executes the poweron command.
|
To Use the powercycle Command
|
|
Note - You must have r level user permission to use this command. See userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
TABLE 6-5 powercycle Command Options
|
Option
|
Description
|
|
-y
|
InstructsALOM CMT to proceed without prompting.
|
|
-f
|
Forces an immediate shutdown regardless of the state of the host. If the Solaris OS shutdown fails for any reason, use this option to force the system to be powered off immediately. This command does not perform a graceful shutdown of the system or synchronize the file systems, work may be lost. It does not perform a graceful shutdown of the system or synchronize the file systems.
|
poweroff
Use the poweroff command to power off the host server to standby mode. If the server is already powered off, this command has no effect. However, ALOM CMT is still available when the server is powered off, since ALOM CMT uses the server's standby power. Some environmental information is not available when the server is in standby mode.
|
To Use the poweroff Command
|
|
Note - You must have r level user permission to use this command. See userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
Where option is the desired option, if any.
If you type the poweroff command without any options, the command initiates a graceful shutdown of the Solaris OS, similar to one of the Solaris commands shutdown, init, or uadmin.
It can take up to 65 seconds for the poweroff command to completely shut down the system. This is because ALOM CMT attempts to wait for a graceful shutdown to complete before the system is powered off.
|
Note - After the poweroff command shuts down the system, ALOM CMT issues the following message:
|
SC Alert: Host system has shut down.
|
Wait until you see this message before powering the system back on.
poweroff Command Options
The poweroff command uses the following options. You can use these two options together. Refer to Entering Command Options.
TABLE 6-6 poweroff Command Options
|
Option
|
Description
|
|
-y
|
Instructs ALOM CMT to proceed without prompting.
|
|
-f
|
Forces an immediate shutdown regardless of the state of the host. If the Solaris OS shutdown fails for any reason, use this option to force the system to be powered off immediately. This command does not perform a graceful shutdown of the system or synchronize the file systems, work may be lost. It does not perform a graceful shutdown of the system or synchronize the file systems.
|
Related Information
poweron
Use the poweron command to power on the server. If the host server is already powered on, this command has no effect.
|
To Use the poweron Command
|
|
Note - You must have r level user permission to use this command. Refer to userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
|
Note - If you have just used the poweroff command to power off the host server, ALOM CMT issues the following message:
|
SC Alert: Host system has shut down.
|
Wait until you see the message before powering the system back on.
poweron Command Options
The poweron command uses the following options.
TABLE 6-7 poweron Command Options
|
Option
|
Description
|
|
fru
|
No FRUs can be powered on independently. This option is reserved for future use.
|
|
-c
|
Instructs ALOM CMT to connect to the system console after performing the operation.
|
Related Information
removefru
Use the removefru command to prepare a FRU (field-replaceable unit) for removal.
|
To Use the removefru Command
|
At the sc> prompt, type the following command:
Where fru is the name of the FRU you want to prepare for removal.
For example, to prepare Power Supply 0 for removal, type:
|
Note - On Sun SPARC Enterprise T1000 servers, attempting to use the removefru command on PS0 generates the following error message:
|
sc> removefru PS0
Could not remove <PS0>.
System only has one power supply.
|
removefru Command Options
The removefru command uses the following options.
TABLE 6-8 removefru Command Options
|
Option
|
Description
|
|
fru
|
The name of the FRU you want to prepare for removal
|
|
-y
|
Instructs ALOM CMT to proceed without prompting with a confirmation question.
|
Specifying the fru option prepares the specified FRU for removal. ALOM CMT responds with a message indicating whether the FRU is ready for removal.
TABLE 6-9 removefru FRU Values
|
Value
|
Description
|
|
PS0
|
Prepares Power Supply 0 in the host server for removal.
|
|
PS1
|
Prepares Power Supply 1 in the host server for removal.
|
reset
Use the reset command to force the host server to reset immediately. The server reboots using the options you specified (if any) in the bootmode command. Refer to bootmode. Note that reset does not perform a graceful shutdown of the system, and you might lose data. When possible, reset the server through the Solaris OS instead.
If the OpenBoot PROM variable auto-boot? is set to false, you might need to boot the server into the Solaris OS to resume operation.
To Use the reset Command
|
|
Note - You must have r level user permission to use this command. Refer to userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
reset Command Options
The reset command uses the following two options. You can use these two options together. Refer to Overview of the ALOM CMT Command Shell.
TABLE 6-10 reset Command Options
|
Option
|
Description
|
|
-c
|
Instructs ALOM CMT to connect to the system console after performing the operation.
|
|
-y
|
Instructs ALOM CMT to proceed without prompting.
|
For example,
sc> reset -c
Are you sure you want to reset the system [y/n]? n
|
sc> reset -yc
Enter #. to return to ALOM.
SC Alert: SC Request to Reset Host.
|
sc> reset -c
Are you sure you want to reset the system [y/n]? y
Enter #. to return to ALOM.
SC Alert: SC Request to Reset Host.
|
Related Information
resetsc
Use the resetsc command to perform a hard reset of the system controller. This terminates all current ALOM CMT sessions.
|
To Use the resetsc Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.
|
1. To perform a reset, type the following command:
Where option is -y, if desired.
ALOM CMT responds with the following message:
Are you sure you want to reset the SC [y/n]?
|
2. Type y to proceed, or n to exit without resetting the system controller.
resetsc Command Options
The resetsc command uses one option: -y
If you use the -y option, the reset proceeds without first asking you to confirm the reset.
Related Information
restartssh
Use the restartssh command to restart the SSH server after you have generated new hosts keys using the ssh-keygen command. This reloads the keys into the server's dedicated data structure in memory.
To Use the restartssh Command
|
At the sc> prompt, type the following command:
Where option is the option shown in TABLE 6-11.
Command Options
The restartssh command uses the following options.
TABLE 6-11 restartssh Command Options
|
Option
|
Description
|
|
-y
|
Do not prompt for confirmation.
|
Related Information
setdate
Use the setdate command to set the current ALOM CMT date and time.
If you use the setdate command while the server is starting or running, ALOM CMT returns the following error message:
sc> setdate 1200
Error: Unable to set clock while managed system is running.
|
|
Note - The setdate command works only when the server is powered off.
|
|
To Use the setdate Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
sc> setdate mmddHHMMccyy.SS
|
This command accepts settings for the month, day, hour, minute, century, year, and second. If you omit the month, day, and year, ALOM CMT applies the current values as defaults. You can also omit the century value and the value for seconds in the time.
|
Note - Your server uses local time, but ALOM CMT uses Coordinated Universal Time (UTC). ALOM CMT does not accept time zone conversions or daylight time changes. Note that the Solaris OS and ALOM CMT time are not synchronized.
|
This example sets the time to September 12, at 9:45 PM of the current year (Coordinated Universal Time).
sc> setdate 09122145
MON SEP 12 21:45:00 2005 UTC
|
This example sets the time to 9:45 PM of the current month, day, and year (Coordinated Universal Time).
sc> setdate 2145
MON SEP 12 21:45:00 2005 UTC
|
setdate Command Options
The setdate command uses the following options.
TABLE 6-12 setdate Command Options
|
Option
|
Description
|
|
mm
|
Month
|
|
dd
|
Day
|
|
HH
|
Hour (24-hour system)
|
|
MM
|
Minutes
|
|
.SS
|
Seconds
|
|
cc
|
Century (first two digits of the year)
|
|
yy
|
Year (last two digits of the year)
|
Related Information
setdefaults
Use the setdefaults command to set all ALOM CMT configuration variables back to their factory default values. The -a option sets the ALOM CMT configuration and all user information back to the factory default values.
To Use the setdefaults Command
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions. You need to set the password to execute permission-level commands.
|
1. At the sc> prompt, type the following command:
Where options are the desired options, if any.
For example:
sc> setdefaults
Are you sure you want to reset the SC configuration [y/n]? y
|
sc> setdefaults -a
Are you sure you want to reset the SC configuration and users [y/n]? y
|
2. Type the resetsc command to reboot ALOM.
When ALOM CMT reboots, it uses the factory default values.
setdefaults Command Options
The setdefaults command uses the following options.
TABLE 6-13 setdefaults Command Options
|
Option
|
Description
|
|
-a
|
Sets all ALOM CMT configuration variables to their factory defaults and clears the user account and configuration information as well. The only account that remains on the system is the admin user account with no password.
|
|
-y
|
Instructs ALOM CMT to proceed without first asking the confirmation question: Are you sure you want to reset the SC configuration?
|
Related Information
setfru
Use the setfru command to store information in all FRU PROMs.
|
To Use the setfru Command
|
At the sc> prompt, type the following command:
Using the -c option alone clears old data from all FRU PROMs. This information can be displayed using the showfru command. See showfru
setkeyswitch
Use the setkeyswitch command to control the virtual keyswitch position of the system.
|
To Use the setkeyswitch Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions. You need to set the password to execute permission-level commands.
|
At the sc> prompt, type the following command:
setkeyswitch Command Options
The setkeyswitch command uses the following options:
TABLE 6-14 setkeyswitch Command Options
|
Option
|
Description
|
|
normal
|
The system can power itself on and start the boot process.
|
|
stby
|
The system cannot power itself on.
|
|
diag
|
The system can power itself on using the preset values of diagnostic variables to provide thorough fault coverage (see Descriptions of Configuration Variables). This option overrides the values of diagnostic variables that you might have set. For information about user-configurable diagnostic control variables, see Diagnostic Control Variables.
|
|
locked
|
The system can power itself on, however you are prohibited from updating any of the flash devices or using the break command.
|
|
-y
|
Setting the virtual keyswitch to standby (stby) powers off the server. Before powering off the host server, ALOM CMT asks for a confirmation. The -y flag answers yes to the confirmation.
|
setlocator
Use the setlocator command to turn the host server's Locator LED on or off. For more information about the Locator LEDs, refer to your system administration guide.
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
Where option is either on or off.
For example:
sc> setlocator on
sc> setlocator off
|
To show the state of the Locator LED, use the showlocator command. Refer to showlocator for more information.
setlocator Command Options
This setlocator command has two options: on and off.
Related Information
setsc
The ALOM CMT software comes preinstalled on your host server, and is ready to run as soon as you apply power to the server. If you want to customize the ALOM CMT configuration, you set up the initial configuration with the setupsc command. If you need to update a setting after your initial ALOM CMT configuration, use the setsc command. For information about your configuration, see ALOM CMT Configuration Steps. For more about the setupsc command, see setupsc.
|
To Use the setsc Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.
|
Make sure that you have your configuration table with you as you run the command, and that it includes your planned values for each of the configuration variables you plan to change. See Configuration Worksheet and Using ALOM CMT Configuration Variables for more information.
At the sc> prompt, type the following command:
Substitute the configuration variable and the variable's value for variable and value.
For example:
sc> setsc netsc_ipaddr xxx.xxx.xxx.xxx
|
Where xxx.xxx.xxx.xxx is a valid IP address.
If the variable you are configuring requires more than one value, type the values, using spaces to separate them. Because the setsc command can be used in scripts as well as at the command prompt, it does not return any information after you enter a value for a variable.
If you type setsc without including a configuration variable, ALOM CMT returns a list of the variables you can configure.
Related Information
setupsc
Use the setupsc command to customize ALOM CMT.
Ensure that you have your configuration worksheet with you as you run the command, and that the worksheet includes your planned values for each of the configuration variables you plan to change. See Configuration Worksheet and Using ALOM CMT Configuration Variables for more information.
|
To Use the setupsc Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.
|
1. At the sc> prompt, type the following command:
The setup script starts.
2. To exit the script, take one of the following actions:
- To exit the script and save the changes you have made, type Control-Z.
- To exit the script without saving any changes, type Control-C.
For example, the script starts as follows:
sc> setupsc
Entering interactive script mode. To exit and discard changes to
that point, use Ctrl-C or to exit and save changes to that point,
use Ctrl-Z.
|
3. Answer the interactive questions to customize ALOM CMT.
The script asks you whether you want to enable each set of configuration variables. See Using ALOM CMT Configuration Variables for help.
- To enable a set of variables so that you can configure their settings, type y.
- To accept a default value shown in parentheses, press Return.
- To disable a set of variables and proceed to the next, type n.
For example:
Should the SC network interface be enabled [y]?
|
If you type y or press Return to accept the default, the setupsc script then prompts you to enter values for the variables. The script helps you set up the following types of variables:
|
Note - You do not need to set or adjust the serial interface variables. These variables are automatically set for you by the host server.
|
Related Information
showcomponent
Use the showcomponent command to display system components and their test status. If you specify an asr-key, ALOM CMT displays only information for that key, otherwise ALOM CMT displays the entire asr database. The -h (Help) option lists all valid asr-keys as well as usage information.
|
To Use the showcomponent Command
|
|
Note - You must have a level user permission to use this command. Refer to userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
For example,
sc> showcomponent
Keys:
MB/CMP0/P0
...
MB/CMP0/CH0/R0/D0
MB/CMP0/CH0/R0/D1
MB/CMP0/CH0/R1/D0
MB/CMP0/CH0/R1/D1
MB/CMP0/CH1/R0/D0
MB/CMP0/CH1/R0/D1
MB/CMP0/CH1/R1/D0
MB/CMP0/CH1/R1/D1
MB/CMP0/CH2/R0/D0
MB/CMP0/CH2/R0/D1
MB/CMP0/CH2/R1/D0
MB/CMP0/CH2/R1/D1
MB/CMP0/CH3/R0/D0
MB/CMP0/CH3/R0/D1
MB/CMP0/CH3/R1/D0
MB/CMP0/CH3/R1/D1
IOBD/PCIEa
IOBD/PCIEb
PCIX1
PCIX0
PCIE2
PCIE1
PCIE0
TTYA
ASR state: clean
|
showdate
Use the showdate command to show the current ALOM CMT date and time.
ALOM CMT time is expressed in Coordinated Universal Time (UTC) rather than local time. Note that the Solaris OS and ALOM CMT time are not synchronized.
|
To Use the showdate Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt type the following command:
For example:
sc> showdate
MON SEP 16 21:45:00 2002 UTC
|
To change the ALOM CMT date and time, use the setdate command. See setdate.
Related Information
showenvironment
Use the showenvironment command to display a snapshot of the server's environmental status.The information this command can display includes system temperatures, hard drive status, power supply and fan status, front panel LED status, voltage and current sensors, and so on. The output uses a format similar to the UNIX command prtdiag (1m).
|
To Use the showenvironment Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
Some environmental information might not be available when the server is in standby mode.
The following example shows sample output when the host server is powered on. Note that some information shown in the following example may be different for your system, such as the number of power supplies and hard drives
CODE EXAMPLE 6-2 Example of showenvironment Command Output for Sun SPARC Enterprise T2000 Server (Power On)
sc> showenvironment
=============== Environmental Status ===============
------------------------------------------------------------------------------
System Temperatures (Temperatures in Celsius):
------------------------------------------------------------------------------
Sensor Status Temp LowHard LowSoft LowWarn HighWarn HighSoft HighHard
------------------------------------------------------------------------------
PDB/T_AMB OK 24 -10 -5 0 45 50 55
MB/T_AMB OK 28 -10 -5 0 45 50 55
MB/CMP0/T_TCORE OK 44 -10 -5 0 95 100 105
MB/CMP0/T_BCORE OK 44 -10 -5 0 95 100 105
IOBD/IOB/TCORE OK 43 -10 -5 0 95 100 105
IOBD/T_AMB OK 29 -10 -5 0 45 50 55
--------------------------------------------------------
System Indicator Status:
--------------------------------------------------------
SYS/LOCATE SYS/SERVICE SYS/ACT
OFF OFF ON
--------------------------------------------------------
SYS/REAR_FAULT SYS/TEMP_FAULT SYS/TOP_FAN_FAULT
OFF OFF OFF
--------------------------------------------------------
--------------------------------------------
System Disks:
--------------------------------------------
Disk Status Service OK2RM
--------------------------------------------
HDD0 OK OFF OFF
HDD1 NOT PRESENT OFF OFF
HDD2 NOT PRESENT OFF OFF
HDD3 NOT PRESENT OFF OFF
---------------------------------------------------
Fans Status:
---------------------------------------------------
Fans (Speeds Revolution Per Minute):
Sensor Status Speed Warn Low
----------------------------------------------------------
FT0/FM0 OK 3586 -- 1920
FT0/FM1 OK 3525 -- 1920
FT0/FM2 OK 3650 -- 1920
FT2 OK 2455 -- 1920
----------------------------------------------------------
------------------------------------------------------------------------------
Voltage sensors (in Volts):
------------------------------------------------------------------------------
Sensor Status Voltage LowSoft LowWarn HighWarn HighSoft
------------------------------------------------------------------------------
MB/V_+1V5 OK 1.48 1.27 1.35 1.65 1.72
MB/V_VMEML OK 1.79 1.53 1.62 1.98 2.07
MB/V_VMEMR OK 1.78 1.53 1.62 1.98 2.07
MB/V_VTTL OK 0.89 0.76 0.81 0.99 1.03
MB/V_VTTR OK 0.89 0.76 0.81 0.99 1.03
MB/V_+3V3STBY OK 3.39 2.80 2.97 3.63 3.79
MB/V_VCORE OK 1.31 1.18 1.20 1.39 1.41
IOBD/V_+1V5 OK 1.48 1.27 1.35 1.65 1.72
IOBD/V_+1V8 OK 1.79 1.53 1.62 1.98 2.07
IOBD/V_+3V3MAIN OK 3.36 2.80 2.97 3.63 3.79
IOBD/V_+3V3STBY OK 3.41 2.80 2.97 3.63 3.79
IOBD/V_+1V OK 1.11 0.93 0.99 1.21 1.26
IOBD/V_+1V2 OK 1.17 1.02 1.08 1.32 1.38
IOBD/V_+5V OK 5.15 4.25 4.50 5.50 5.75
IOBD/V_-12V OK -12.04 -13.80 -13.20 -10.80 -10.20
IOBD/V_+12V OK 12.18 10.20 10.80 13.20 13.80
SC/BAT/V_BAT OK 3.04 -- 2.25 -- --
-----------------------------------------------------------
System Load (in amps):
-----------------------------------------------------------
Sensor Status Load Warn Shutdown
-----------------------------------------------------------
MB/I_VCORE OK 34.640 80.000 88.000
MB/I_VMEML OK 7.560 60.000 66.000
MB/I_VMEMR OK 6.420 60.000 66.000
-----------------------------------------------------------
----------------------
Current sensors:
----------------------
Sensor Status
----------------------
IOBD/I_USB0 OK
IOBD/I_USB1 OK
FIOBD/I_USB OK
------------------------------------------------------------------------------
Power Supplies:
------------------------------------------------------------------------------
Supply Status Underspeed Overtemp Overvolt Undervolt Overcurrent
------------------------------------------------------------------------------
PS0 OK OFF OFF OFF OFF OFF
PS1 OK OFF OFF OFF OFF OFF
|
The following example shows sample output when the host server, a Sun SPARC Enterprise T1000, is powered on:
CODE EXAMPLE 6-3 Example of showenvironment Command Output for Sun SPARC Enterprise T1000 Server (Power On)
sc> showenvironment
=============== Environmental Status ===============
--------------- System Temperatures (Temperatures in Celsius):
------------------------------------------------------------------------------
Sensor Status Temp LowHard LowSoft LowWarn HighWarn HighSoft HighHard
------------------------------------------------------------------------------
MB/T_AMB OK 26 -10 -5 0 45 50 55
MB/CMP0/T_TCORE OK 42 -10 -5 0 85 90 95
MB/CMP0/T_BCORE OK 42 -10 -5 0 85 90 95
MB/IOB/T_CORE OK 36 -10 -5 0 95 100 105
--------------------------------------------------------
System Indicator Status:
--------------------------------------------------------
SYS/LOCATE SYS/SERVICE SYS/ACT
OFF OFF ON
--------------------------------------------------------
----------------------------------------------------------
Fans (Speeds Revolution Per Minute):
----------------------------------------------------------
Sensor Status Speed Warn Low
----------------------------------------------------------
FT0/F0 OK 6653 2240 1920
FT0/F1 OK 6653 2240 1920
FT0/F2 OK 6653 2240 1920
FT0/F3 OK 6547 2240 1920
--------------------------------------------------------------------
Voltage sensors (in Volts):
--------------------------------------------------------------------
Sensor Status Voltage LowSoft LowWarn HighWarn HighSoft
--------------------------------------------------------------------
MB/V_VCORE OK 1.31 1.20 1.24 1.36 1.39
MB/V_VMEM OK 1.78 1.69 1.72 1.87 1.90
MB/V_VTT OK 0.89 0.84 0.86 0.93 0.95
MB/V_+1V2 OK 1.19 1.09 1.11 1.28 1.30
MB/V_+1V5 OK 1.49 1.36 1.39 1.60 1.63
MB/V_+2V5 OK 2.50 2.27 2.32 2.67 2.72
MB/V_+3V3 OK 3.29 3.06 3.10 3.49 3.53
MB/V_+5V OK 5.02 4.55 4.65 5.35 5.45
MB/V_+12V OK 12.18 10.92 11.16 12.84 13.08
MB/V_+3V3STBY OK 3.31 3.13 3.16 3.53 3.59
-----------------------------------------------------------
System Load (in amps):
-----------------------------------------------------------
Sensor Status Load Warn Shutdown
-----------------------------------------------------------
MB/I_VCORE OK 21.520 80.000 88.000
MB/I_VMEM OK 1.740 60.000 66.000
-----------------------------------------------------------
----------------------
Current sensors:
----------------------
Sensor Status
----------------------
MB/BAT/V_BAT OK
----------------------------------------------------------------------
Power Supplies:
------------------------------------------------------------------------------
Supply Status Underspeed Overtemp Overvolt Undervolt Overcurrent
------------------------------------------------------------------------------
PS0 OK OFF OFF OFF OFF OFF
|
The following example shows sample output when the host server is powered off
CODE EXAMPLE 6-4 Example of showenvironment Command Output (Power Off)
sc> showenvironment
=============== Environmental Status ===============
------------------------------------------------------------------------------
System Temperatures (Temperatures in Celsius):
------------------------------------------------------------------------------
Sensor Status Temp LowHard LowSoft LowWarn HighWarn HighSoft HighHard
------------------------------------------------------------------------------
CPU temperature information cannot be displayed when System power is off.
PDB/T_AMB OK 24 -10 -5 0 45 50 55
--------------------------------------------------------
System Indicator Status:
--------------------------------------------------------
SYS/LOCATE SYS/SERVICE SYS/ACT
OFF OFF STANDBY BLINK
--------------------------------------------------------
SYS/REAR_FAULT SYS/TEMP_FAULT SYS/TOP_FAN_FAULT
OFF OFF OFF
--------------------------------------------------------
Disk Status information cannot be displayed when System power is off.
Fan Status information cannot be displayed when System power is off.
Voltage Rail Status information cannot be displayed when System power is off.
System Load information cannot be displayed when System power is off.
Current sensor information cannot be displayed when System power is off.
------------------------------------------------------------------------------
Power Supplies:
------------------------------------------------------------------------------
Supply Status Underspeed Overtemp Overvolt Undervolt Overcurrent
------------------------------------------------------------------------------
PS0 OK OFF OFF OFF OFF OFF
PS1 OK OFF OFF OFF OFF OFF
|
Related Information
showfaults
Use the showfaults command to display current valid system faults. The standard output displays the fault ID, the faulted FRU device, and the fault message. This command also displays POST results.
The showfaults command uses the -v argument to supply more verbose output.
|
To Use the showfaults Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
sc> showfaults
ID FRU Fault
0 MB/CMP0/CH0/R0/D0 Host detected fault, MSGID: SUN4U-8000-2S
|
Adding the -v argument,
sc> showfaults -v
ID Time FRU Fault
0 SEP 09 11:02:09 MB/CMP0/CH0/R0/D0 Host detected fault, MSGID:
SUN4U-8000-2S UUID: 7ee0e46b-ea64-6565-e684-e996963f7b86
|
Using the FRU ID reported in the showfaults output, you can get more information using the showfru command,
sc> showfru MB/CMP0/CH0/R0/D0
/SPD/Timestamp: MON JUN 27 12:00:00 2005
/SPD/Description: DDR2 SDRAM, 512 MB
/SPD/Manufacture Location:
/SPD/Vendor: Micron Technology
/SPD/Vendor Part No: 18HTF6472Y-53EB2
/SPD/Vendor Serial No: 751d9239
SEGMENT: ST
/Platform_Name: platform_name-T1000
/Status_CurrentR/
/Status_CurrentR/UNIX_Timestamp32: FRI SEP 09 10:28:08 2005
/Status_CurrentR/status: 0x64 (MAINTENANCE REQUIRED, SUSPECT,
DEEMED FAULTY)
/Event_DataR/
/Event_DataR/Initiator: FM
/Event_DataR/Diagcode: SUN4U-8000-2S
/Event_DataR/UUID: 7ee0e46b-ea64-6565-e684-e996963f7b86
|
Using the diagnostic code reported by the showfaults and showfru commands, (for example: SUN4U-8000-2S) you can go to
http://www.sun.com/msg/SUN4U-8000-2S
for more information about the fault. You can also navigate to
http://www.sun.com/msg
then enter SUN4U-8000-2S in the SUNW-MSG-ID: window.
For further information about the showfru command see showfru. For further information about fault management tasks, see Chapter 5.
showfru
Use the showfru command to display the current status and fault history of all field-replaceable units programmable read-only memory (FRU PROMs) in the host server. The output uses a format similar to that of the Solaris OS prtfru command.
showfru Command Options
The showfru command uses the following options:
TABLE 6-15 showfru Command Options
|
Option
|
Description
|
|
-g lines
|
Specifies the number of lines to display before pausing the output to the screen. After each pause, ALOM CMT shows the following message: Paused: Press 'q' to quit, any other key to continue.
|
|
-s
|
Displays static information about system FRUs (defaults to all FRUs, unless one is specified).
|
|
-d
|
Displays dynamic information about system FRUs (defaults to all FRUs, unless one is specified).
|
|
FRU
|
Individual FRUs.
|
|
To Use the showfru Command
|
|
Note - You do not need user permission to use this command.
|
At the sc> prompt, type the following command:
The following example shows sample output for the showfru command on a Sun SPARC Enterprise T2000 server, supplying an invalid argument
CODE EXAMPLE 6-5 Example of showfru Command Output On a Sun SPARC Enterprise T2000 Server, Displaying Valid Arguments
sc> showfru x
No such FRU_PROM. Valid arguments are:
SC/SEEPROM
IOBD/SEEPROM
MB/SEEPROM
PDB/SEEPROM
FIOBD/SEEPROM
SASBP/SEEPROM
PS0/SEEPROM
PS1/SEEPROM
MB/CMP0/CH0/R0/D0/SEEPROM
MB/CMP0/CH0/R0/D1/SEEPROM
MB/CMP0/CH0/R1/D0/SEEPROM
MB/CMP0/CH0/R1/D1/SEEPROM
MB/CMP0/CH1/R0/D0/SEEPROM
MB/CMP0/CH1/R0/D1/SEEPROM
MB/CMP0/CH1/R1/D0/SEEPROM
MB/CMP0/CH1/R1/D1/SEEPROM
MB/CMP0/CH2/R0/D0/SEEPROM
MB/CMP0/CH2/R0/D1/SEEPROM
MB/CMP0/CH2/R1/D0/SEEPROM
MB/CMP0/CH2/R1/D1/SEEPROM
MB/CMP0/CH3/R0/D0/SEEPROM
MB/CMP0/CH3/R0/D1/SEEPROM
MB/CMP0/CH3/R1/D0/SEEPROM
MB/CMP0/CH3/R1/D1/SEEPROM
|
The following example shows sample output for the showfru command on a Sun SPARC Enterprise T1000 server, supplying an invalid argument:
CODE EXAMPLE 6-6 Example of showfru Command Output On a Sun SPARC Enterprise T1000 Server, Displaying Valid Arguments
sc> showfru x
No such FRU_PROM. Valid arguments are:
MB/SEEPROM
PS0/SEEPROM
MB/CMP0/CH0/R0/D0/SEEPROM
MB/CMP0/CH0/R0/D1/SEEPROM
MB/CMP0/CH0/R1/D0/SEEPROM
MB/CMP0/CH0/R1/D1/SEEPROM
MB/CMP0/CH3/R0/D0/SEEPROM
MB/CMP0/CH3/R0/D1/SEEPROM
MB/CMP0/CH3/R1/D0/SEEPROM
MB/CMP0/CH3/R1/D1/SEEPROM
|
The following example shows sample output for the showfru command, supplying a valid FRU name and -s as arguments
CODE EXAMPLE 6-7 Example of showfru Command Output, Using a Valid Argument
sc> showfru -s MB
SEGMENT: SD
/ManR
/ManR/UNIX_Timestamp32: THU OCT 06 14:47:58 2005
/ManR/Description: ASSY,platform_name-T1000,Motherboard
/ManR/Manufacture Location: Sriracha,Chonburi,Thailand
/ManR/Sun Part No: 5017302
/ManR/Sun Serial No: 000854
/ManR/Vendor: Celestica
/ManR/Initial HW Dash Level: 01
/ManR/Initial HW Rev Level: 01
/ManR/Shortname: T1000_MB
/SpecPartNo: 885-0504-03
|
By default, the output of the showfru command can be very voluminous. For example:
sc> showfru MB
...
/Status_EventsR[2]
/Status_EventsR[2]/UNIX_Timestamp32: FRI MAR 03 18:31:06 2006
/Status_EventsR[2]/Old_Status: 0x00 (OK)
/Status_EventsR[2]/New_Status: 0x64 (MAINTENANCE
REQUIRED, SUSPECT, DEEMED FAULTY)
/Status_EventsR[2]/Initiator: 0xD3 (FM)
/Status_EventsR[2]/Component: 0x00
/Status_EventsR[2]/Message (FM)
/Status_EventsR[2]/FM/fault_diag_time: 0x0000000044088B69
/Status_EventsR[2]/FM/diagcode: SUN4V-8000-8Q
/Status_EventsR[2]/FM/UUID: 61b9738d-2761-c3f6-a2ae-
fcf11e99681c
/Status_EventsR[2]/FM/DE_Name: cpumem-diagnosis
/Status_EventsR[2]/FM/DE_Version: 1.5
...
/Status_CurrentR/
/Status_CurrentR/UNIX_Timestamp32: FRI MAR 03 18:31:06 2006
/Status_CurrentR/status: 0x64 (MAINTENANCE REQUIRED,
SUSPECT, DEEMED FAULTY)
|
Related Information
showhost
Use the showhost command to display version information about firmware supporting the host configuration.
|
To Use the showhost Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command
sc> showhost
Host flash versions:
Reset V1.0.0
Hypervisor 1.0.0 2005/09/28 18:56
OBP 4.19.0 2005/09/28 12:34
MPT SAS FCode Version 1.00.37 (2005.06.13)>R
Integrated POST 4.19.0 2005/09/28 12:52
|
showkeyswitch
Use the showkeyswitch command to display the current virtual keyswitch position of the system.
|
To Use the showkeyswitch Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
sc> showkeyswitch
Keyswitch is in the NORMAL position.
sc>
|
showlocator
Use the showlocator command to view the state of the host server's Locator LED (on or off). For more information about the Locator LED, refer to your system administration guide.
|
Note - This command works only with servers that have the front panel Locator LED.
|
|
To Use the showlocator Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
- If the Locator LED is on, ALOM CMT returns the following result:
sc> showlocator
Locator LED is ON
|
- If the Locator LED is off, ALOM CMT returns the following result:
sc> showlocator
Locator LED is OFF
|
To change the state of the Locator LED, use the setlocator command. Refer to setlocator.
Related Information
showlogs
Use the showlogs command to display the history of events logged in the ALOM CMT event buffer. These events include server reset events and all ALOM CMT commands that change the state of the system (such as reset, poweroff, and poweron). See reset, poweroff, and poweron.
Each event recorded in the log has the following format:
date ID: message
Where:
- date - the time at which the event occurred, as recorded by ALOM CMT
- ID - a numerical identifier for the message type.
- message - a short description of the event
If you use the showlogs command without any option, ALOM CMT displays the last 20 lines of the RAM event log.
|
To Use the showlogs Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
Where options are the desired options, if any.
The command returns information similar to the following:
sc> showlogs
Log entries since AUG 27 03:35:12
----------------------------------
AUG 27 03:35:12: 00060003: "SC System booted."
AUG 27 03:37:01: 00060000: "SC Login: User admin Logged on."
|
|
Note - Timestamps shown in the ALOM CMT event log reflect UTC.
|
This example shows the output of the showlogs command with the -p p option. The -p p option displays the persistent event log. The persistent event log is comprised of only Major and Critical severity events.
CODE EXAMPLE 6-8 Example of showlogs -p p Command Output
sc> showlogs -p p
Persistent event log
--------------------
JUN 07 04:16:44: 00060003: "SC System booted."
JUN 07 04:17:12: 00040002: "Host System has Reset"
JUN 07 04:48:03: 00040081: "Input power unavailable for PSU at PS1.
|
showlogs Command Options
The showlogs command uses five options. You can use the -g and -p options in combination with the -b, -e, or -v options. If you do not specify the -g option, the screen output will not pause unless you have specified the -v option together with the -p p option (persistent log, in which case the display pauses after every 25 lines).
TABLE 6-16 showlogs Command Options
|
Option
|
Description
|
|
-v
|
Displays the entire contents of the specified log. If the persistent log is requested, the display will automatically pause every 25 events.
|
|
-b lines
|
Displays the events from the beginning of the buffer, where lines is the number of lines that you specify. For example, the following command displays the first 100 lines in the buffer:
showlogs -b 100
|
|
-e lines
|
Displays the events from the end of the buffer file, where lines is the number of lines that you specify. If new data appears in the log while you are executing this command, the new data is appended to the screen output. For example:
showlogs -e 10
|
|
-g lines
|
Controls the number of lines displayed on the screen at a given time, where lines is the number of lines that you specify.
After each pause, ALOM CMT shows the following message:
--pause-- Press 'q' to quit, any other key to continue.
If -g is set to 0 (zero), display does not pause.
|
|
-p logtype [r|p]
|
Controls whether to display entries only from the RAM event log (logtype r) or from the persistent event log (logtype p). The default option (if -p has not been specified) is to display entries only from the RAM log.
|
Related Information
shownetwork
Use the shownetwork command to display the current ALOM CMT network configuration.
|
Note - If you changed the ALOM CMT network configuration since the last time you booted ALOM CMT, the output from this command might not show the updated configuration information. Reboot ALOM CMT to see the changed configuration. See Redirecting the System Console to Other Devices for information on rebooting ALOM CMT.
|
|
To Use the shownetwork Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
Where option is -v, if desired.
The command output appears similar to the following example, with the actual IP addresses, netmask, and Ethernet addresses in your network configuration in place of xxx.xxx.xxx.xxx.
sc> shownetwork
SC network configuration is:
IP Address: XXX.XXX.XXX.XXX
Gateway address: XXX.XXX.XXX.XXX
Netmask: XXX.XXX.XXX.XXX
Ethernet Address: XX:XX:XX:XX:XX:XX
|
|
Note - If networking is misconfigured, the shownetwork command shows 0.0.0.0 for the addresses.
|
shownetwork Command Option
The shownetwork command uses one option: -v.
If you type shownetwork -v, ALOM CMT returns additional information about your network, including information about your DHCP (Dynamic Host Configuration Protocol) server, if you have one configured. See Configuring Your Network Using DHCP.
Related Information
showplatform
Use the showplatform command to display information about the host server's platform ID and status.
|
To Use the showplatform Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type showplatform.
The command returns information similar to the following:
sc> showplatform
SUNW,platform_name-T1000
Chassis Serial Number: 0529AP000882
Domain Status
------ ------
S0 OS Standby
sc>
|
Related Information
ALOM CMT Shell Commands
showsc
Use the showsc command to display information about the ALOM CMT software configuration and firmware version.
|
To Use the showsc Command
|
|
Note - You do not need user permissions to use this command.
|
Take one of the following actions:
- To display all configuration information for ALOM CMT, type the following command at the sc> prompt:
For example
CODE EXAMPLE 6-9 Example of showsc Display of Configuration Information
sc> showsc
Advanced Lights Out Manager CMT v1.3
parameter value
--------- -----
if_network true
if_connection ssh
if_emailalerts false
netsc_dhcp false
netsc_ipaddr 129.148.57.109
netsc_ipnetmask 255.255.255.0
netsc_ipgateway 129.148.57.254
mgt_mailhost
mgt_mailalert
sc_customerinfo
sc_escapechars #.
sc_powerondelay false
sc_powerstatememory false
sc_clipasswdecho true
sc_cliprompt sc
sc_clitimeout 0
sc_clieventlevel 3
sc_backupuserdata true
diag_trigger power-on-reset error-reset
diag_verbosity normal
diag_level min
diag_mode off
sys_autorunonerror false
sys_autorestart none
sys_eventlevel 3
ser_baudrate 9600
ser_parity none
ser_stopbits 1
ser_data 8
netsc_enetaddr 00:03:ba:d8:b2:ac
sys_enetaddr 00:03:ba:d8:b2:a4
|
To display the values for a particular firmware version, type the following command at the sc> prompt.
For example
CODE EXAMPLE 6-10 Example of showsc -v Display of Configuration Information
sc> showsc version -v
Advanced Lights Out Manager CMT v1.3
SC Firmware version: CMT 1.3.0
SC Bootmon version: CMT 1.3.0
VBSC 1.3.0
VBSC firmware built Oct 25 2006, 23:10:58
SC Bootmon Build Release: 01
SC bootmon checksum: B4314B90
SC Bootmon built Sep 27 2006, 14:09:06
SC Build Release: 01
SC firmware checksum: 2BEE8286
SC firmware built Oct 25 2006, 23:12:54
SC firmware flashupdate THU OCT 26 03:17:50 2006
SC System Memory Size: 32 MB
SC NVRAM Version = 12
SC hardware type: 4
FPGA Version: 4.2.2.7
|
To display the values for a particular configuration variable, type the following command at the sc> prompt:
Where param is the param option. For example,
sc> showsc if_network
true
sc>
|
See Using ALOM CMT Configuration Variables for further information.
showsc Command Options
The showsc command uses the following options. If you type showsc without using any options, ALOM CMT displays all of its configuration variables.
TABLE 6-17 showsc Command Options
|
Option
|
Description
|
|
-v
|
When used with the param option, the -v option might display more detailed information about the specified configuration variables (depending on the variable). When used with the version option, the -v option might display more detailed information about the specified firmware version.
|
|
version
|
Directs the showsc command to display the version of the configuration variable or parameter you specified.
|
|
param
|
Directs the showsc command to display the value of the configuration variable or parameter you specified.
|
|
if_connection
|
Displays the remote connection type: none, telnet, or ssh.
|
Related Information
showusers
Use the showusers command to display the list of users currently logged in to ALOM CMT. The list includes details such as the type of connection, the duration of each user's session, the IP address of the client (if the user is using a network connection), and whether the user has the host system console's write lock (this determines whether the user can type input in a console session, or just monitor the console stream in read-only mode).
|
To Use the showusers Command
|
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
Where option is -g lines, if desired.
For example:
sc> showusers
username connection login time client IP addr console
--------------------------------------------------------------
admin serial Sep 16 10:30
joeuser ssh-1 Sep 14 17:24 123.123.123.123
sueuser ssh-2 Sep 15 12:55 123.223.123.223
|
If a user has more than one session running, each session is listed.
showusers Command Option
The showusers command uses one option: -g lines.
This option pauses the display after the number of lines you specify for lines. After each pause, ALOM CMT returns the message:
--pause-- Press 'q' to quit, any other key to continue
|
If ALOM CMT encounters an alert condition or an event, it displays the information after this message. Press any key to continue, or press q to exit the display and return to the sc> prompt.
ssh-keygen
Use the ssh-keygen command to generate a new set of Secure Shell (SSH) host keys and display the host key fingerprint on the system controller. The default format (rsa) of the fingerprint is as follows:
md5 1024 a3:28:0d:45:01:e4:ba:21:c8:13:90:df:4e:69:7a.5e
To Use the ssh-keygen Command
|
At the sc> prompt, type the following command:
Where options are any of the options listed in TABLE 6-18.
Command Options
The ssh-keygen command uses the following options.
TABLE 6-18 ssh-keygen Command Options
|
Option
|
Description
|
|
-l
|
Shows the fingerprint of the host key.
|
|
-t type
|
Displays or generates the type of key: dsa or rsa. This argument is required. RSA is the public-key crypotosystem, and DSA is the Digital Signature Algorithm, the standard for the U.S. government.
|
|
-r
|
Regenerates the host key. This option is required if the host key already exists.
|
Related Information
useradd
Use the useradd command to add a user account to ALOM CMT.
|
To Use the useradd Command
|
|
Note - You must have u level user permission to use this command. Refer to userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
Where username is the name of the user whose account you want to add to ALOM CMT.
username has the following restrictions:
- Valid characters include alphabetic (letter) and numeric characters, period (.), underscore (_), and hyphen (-).
- The name can have a maximum length of 16 characters, at least one of which must be a lowercase alphabetic character.
- The first character must be alphabetic.
You can add a maximum of 15 unique user accounts to ALOM CMT.
To assign a password to a user name, use the userpassword command. See userpassword.
To set permission levels for a user name, use the userperm command. See userperm.
Related Information
userdel
Use the userdel command to delete an ALOM CMT user account. Once the account is deleted, the deleted user's configuration information can never be recovered.
If the user name you specify is not on the list of ALOM CMT users, ALOM CMT returns an error message. Likewise, if there is only one user on the list, ALOM CMT will not delete that user account.
|
Note - ALOM CMT will not delete the default admin user account.
|
|
To Use the userdel Command
|
|
Note - You must have u level user permission to use this command. Refer to userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
Where useracct is the name of the user account you want to delete.
userdel Command Option
The userdel command uses one option: -y.
If you specify the -y option, userdel deletes the account without prompting the following confirmation question:
Are you sure you want to delete user username [y/n]?
|
Related Information
userpassword
Use the userpassword command to change the password for the specified user account. This command is for administrators who need to change user passwords on ALOM CMT, but who might not know what the user account passwords are. If you are trying to change the password on your own ALOM CMT account, use the password command. See password.
|
To Use the userpassword Command
|
|
Note - You must have u level user permission to use this command. See userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
sc> userpassword username
|
Where username is the name of the user account for which you want to change the password.
When you use this command, ALOM CMT does not prompt you for the existing password.
For example:
sc> userpassword username
New password:
Re-enter new password:
sc>
|
Password Restrictions
Passwords have the following restrictions:
- They must contain between six and eight characters.
- They must contain at least two alphabetic characters (uppercase or lowercase letters) and at least one numeric or special character.
- They must differ from your login name and any reverse or circular shift of your login name. For comparison purposes, uppercase and lowercase letters are equivalent.
- They must differ from the old password by at least three characters. For comparison purposes, uppercase and lowercase letters are equivalent.
|
Note - Passwords that do not pass the restrictions are accepted with a warning that such passwords do not meet the recommended guidelines for security.
|
Related Information
ALOM CMT Shell Commands
userperm
Use the userperm command to set or change permission levels for a specified user account. By default, the initial setup procedure creates the ALOM CMT admin account. This account cannot be deleted, nor can you change the user permissions for the account.
Permission Levels
All users can read ALOM CMT information, but you need authorization to perform ALOM CMT functions or change settings.
If you do not assign a permission level to the specified user (that is, you assign zero permission levels), then that user has read-only permission. This is the default level for a new ALOM CMT user account.
There are four permission levels that increase a user's authorization. You can specify zero through four permission levels.
TABLE 6-19 userperm Permission Levels
|
Permission Level
|
Description
|
|
a
|
Administrative. This user is authorized to change the state of ALOM CMT configuration variables and reboot ALOM CMT. Refer to Using ALOM CMT Configuration Variables and resetsc.
|
|
u
|
User administration. This user is authorized to add users and delete users, change user permissions, and change the authorization level of other users. Refer to useradd and userdel.
|
|
c
|
Console permission. This user is authorized to connect to the host server system console. Refer to console.
|
|
r
|
Reset and power permission. This user is authorized to reset the host server, and power the server on and off.
Refer to reset, poweron, and poweroff.
|
|
Note - The default user permission for the account that you use when you start ALOM CMT for the first time is read-only. After you set a password for the default admin account, the permissions change to cuar (full authorization).
|
To see a user's permission levels, use the usershow command. See usershow.
|
To Use the userperm Command
|
|
Note - You must have u level user permission to use this command
|
At the sc> prompt, type the following command:
sc> userperm username permissions
|
Where username is the name of the user to whom you want to assign permissions, and permissions are the permissions you want to assign to that user.
For example, to assign c and r user permissions to user msmith, type the following at the ALOM CMT command prompt:
To see a user's permission levels, use the usershow command.
A user with no permissions (read-only) can use only the following commands:
A user who has read-only permissions would appear similar to the user jeremy in the following example:
sc> usershow
Username Permissions Password
--------------- ----------------- ------------
admin cuar Assigned
jeremy ---- Assigned
|
Related Information
usershow
Use the usershow command to display a specified user's ALOM CMT account, along with each user's permissions and whether a password has been assigned. Refer to userperm and userpassword.
If you do not enter a username, usershow displays all of the ALOM CMT accounts.
|
To Use the usershow Command
|
|
Note - You must have u level user permission to use this command. See userperm for information on setting user permissions.
|
At the sc> prompt, type the following command:
Where username is the name of the specified user.
For example:
sc> usershow
Username Permissions Password?
admin cuar Assigned
wwilson cuar Assigned
jadams --cr None
|
sc> usershow wwilson
Username Permissions Password?
wwilson cuar Assigned
|
Related Information