Sun IB Switch 9P Administration Guide
|
|
This chapter describes how to use the command-line interface (CLI).
This chapter contains the following sections:
Overview of the Command Shell
The command shell is a simple command-line interface. Through the command shell, you can administer your Sun IB switch.
After you log in to your account, the shell prompt (sc>) appears, and you can enter shell commands. See CLI Shell Commands for more information.
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
|
CLI Shell Commands
The following table lists the CLI shell commands and briefly describes what these commands do.
TABLE 3-1 List of CLI Shell Commands by Function
CLI Command
|
Summary Description
|
Full Description
|
password
|
Changes the login password of the current user.
|
password
|
setdate
|
Sets the date and time.
|
setdate
|
setdefaults
|
Resets all ALOM configuration parameters to their default values.
|
setdefaults
|
setupsc
|
Runs the interactive configuration command. It configures NVRAM parameters
|
setupsc
|
showplatform
|
Displays information about the hardware configuration, and whether the hardware is providing service.
|
showplatform
|
showfru
|
Displays FRUID PROM contents for two PSUs (PSU0 and PSU1) and the switch itself (SSC0).
|
showfru
|
showusers
|
Displays a list of users currently logged in to ALOM. 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
|
showsc
|
Displays the current nonvolatile random access memory (NVRAM) configuration parameters.
|
showsc
|
showdate
|
Displays the ALOM date.
|
showdate
|
usershow [username]
|
Displays a list of all user accounts, permission levels, and whether passwords are assigned.
|
usershow
|
useradd
|
Adds a user account to ALOM.
|
useradd
|
userdel
|
Deletes a user account from ALOM.
|
userdel
|
userpassword
|
Sets or changes a user password.
|
userpassword
|
userperm
|
Sets the permission level for a user account.
|
userperm
|
showlogs
|
Displays the history of all events logged in the ALOM event buffer.
|
showlogs
|
showenvironment
|
Displays the environmental status of the switch
|
showenvironment
|
flashupdate
|
Updates the ALOM firmware. This command downloads main and bootmonitor firmware images to ALOM.
|
flashupdate
|
poweroff
|
Removes the main power from the PSU.
|
poweroff
|
poweron
|
Applies the main power to the PSU.
|
poweron
|
showlocator
|
Displays the current state of the Locator LED as either on or off.
|
showlocator
|
setlocator
|
Turns the locator LED on or off.
|
setlocator
|
removefru
|
Prepares a FRU (for example, a power supply) for removal, and illuminates the management system's OK-to-Remove indicator light.
|
removefru
|
help
|
Displays a list of all ALOM commands with their syntax and a brief description of how each command works.
|
help
|
resetsc
|
Reboots ALOM.
|
resetsc
|
logout
|
Logs out from an ALOM shell session.
|
logout
|
setbp
|
Sets the Blueprint of the switch. (See Appendix D for more information about Blueprints)
|
setbp
|
showbp
|
Displays the running and stored Blueprints of the switch. (See Appendix D for more information about Blueprints)
|
showbp
|
showib
|
Displays InfiniBand switch status.
|
showib
|
Descriptions of CLI Commands
The following pages provide full descriptions of the shell commands in alphabetical order.
flashupdate
Use the flashupdate command to install a new version of the 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.
|
Caution - Do not use the resetsccommand while a firmware update is in progress. If you need to reset, wait until after the update is complete. Otherwise, you could corrupt the firmware and render it unusable.
|
To Use the flashupdate Command
|
To use this command, you must know the following:
- IP address of the server from which you want to download the firmware image
- Path at which the image is stored
1. At the sc> prompt, type the following command for the main firmware image.
sc> flashupdate -s ipaddr -f /tftpboot/ibswitch-sc.flash
|
Substitute the IP address of the server where the firmware image is stored for ipaddr, and the path name for pathname.
2. Type the resetsc command to load the new image:
sc> resetsc -y
sc> Connection closed by foreign host.
|
flashupdate Command Options
The flashupdate command uses the following options.
TABLE 3-2 flashupdate Command Options
Option
|
Description
|
-s ipaddr
|
Directs ALOM to download the firmware image from a server located at ipaddr. ipaddr describes an IP address in standard dot notation, such as 123.145.167.189
|
-f pathname
|
Directs ALOM to the location of the image file. pathname is a full directory path, including the name of the image file, such as /tftp/X3152A_1.0.0.flash or /tftp/ibswitch-sc.flash.
|
-v
|
Displays verbose output. This option provides detailed information about the progress of the download process as it occurs.
|
help
Use the help command to display a list of all ALOM commands and the syntax for each.
To Use the help Command
|
Note - You do not need user permissions to use this command.
|
Do one of the following:
- To display help for all available commands, at the sc> prompt type the following command:
The following example shows the output you see when you type help without specifying a command.
sc> help
flashupdate [-v] [-y] [-F] -s IPaddress -f pathname
help [command]
logout
password
poweroff [-y] [-f] [-r] [-F] {frulist}
poweron [-F] {frulist}
removefru [-y] [-f] [-F] {frulist}
resetsc [-y][-F]
setbp [-i]
setdate [mmdd]HHMM[.SS] | mmddHHMM[cc]yy[.SS]
setdefaults [-y]
setlocator {on|off}
setupsc
showbp [-r]
showdate
showenvironment [-v] [{frulist}]
showfru {frulist}
showib [-v]
showlocator
showlogs [-b lines | -e lines | -v] [-g lines] [-t] {frulist}
showplatform [-v] [{frulist}]
showsc
showusers
useradd username
userdel username
userpassword username
userperm username [a] [u] [c] [r]
usershow [username]
|
- 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 poweron
poweron [-F] {frulist}
sc>
|
logout
Use the logout command to end your session and close your serial or Telnet 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:
password
Use the password command to change the 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 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 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
Enter current password:
Enter new password:
Enter new password again:
New password set for user admin successfully
sc>
|
Password Restrictions
Passwords have the following restrictions:
- They must be between six and eight characters in length.
- 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 - These password restrictions do not apply to a user with u permission.
|
poweroff
Use the poweroff command to power off one of the two power supply units (PSU) to standby mode. If the PSU is already powered off, this command has no effect.
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:
sc> poweroff PS0
Are you sure you want to power off FRU PS0 (y/n)?: y
PS0: Powered off.
sc>
|
poweroff Command Options
The poweroff command uses the following options. See Entering Command Options.
TABLE 3-3 poweroff Command Options
Option
|
Description
|
-y
|
Proceeds without prompting the following confirmation question:
Are you sure you want to power off FRU PS{0|1} (y/n)?
|
-f
|
Forces the poweroff regardless of the presence/availability of the other PSU. (Without this option the command will refuse to poweroff the PSU if the other one is missing or failed.)
|
-r
|
This option is equivalent to the removefru command
|
-F
|
Forces the poweroff regardless of the state of the switch. (For example, without this option powering off would not be permitted while ALOM is logging to a PSU's FRUID.)
|
{frulist}
|
List FRUs to be powered off.
|
poweron
Use the poweron command to power on one of the two power supply units (PSUs).
To Use the poweron 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:
To turn on power to a specific FRU (field-replaceable unit) in the switch, type the following command:
Where frulist is the name of the FRU you want to power on.
For example, to turn power on to power supply 0, type:
sc> poweron PS0
PS0: Powered on.
sc>
|
poweron Command Option
The poweron command uses one parameter: frulist.
Specifying the frulist option powers on the specified PSU.
TABLE 3-4 poweron frulist Values
Value
|
Description
|
PS0
|
Powers on power supply 0 in the switch.
|
PS1
|
Powers on power supply 1 in the switch.
|
removefru
Use the removefru command to prepare a field-replaceable unit (FRU) for removal and to illuminate the corresponding OK-to-Remove LED on the switch.
Note - The software uses the same terms to refer to both FRUs and customer-replaceable units (CRUs). The power supply units (PSUs) are the only field or customer replaceable units.
|
To Use the removefru Command
|
At the sc> prompt, type the following command:
where fru is the name of the FRU or CRU you want to prepare for removal.
For example, to prepare power supply 0 for removal, type:
sc> removefru PS0
Are you sure you want to remove PS0 (y/n)?: y
Mar 03 22:10:22: CRITICAL: PS0 removed - replace within 10 minutes of removal
|
|
Caution - Removing one of the PSUs leaves the switch without a failover power supply. Be sure to replace the PSU as soon as possible to ensure failover capability.
|
removefru Command Option
The removefru command has one parameter: fru.
Specifying the fru parameter prepares the specified FRU for removal.
TABLE 3-5 removefru FRU Values
Value
|
Description
|
PS0
|
Prepares power supply 0 in the switch for removal.
|
PS1
|
Prepares power supply 1 in the switch for removal.
|
resetsc
Use the resetsc command to perform a hard reset of the switch. This terminates all current switch sessions.
To Use the resetsc Command
|
Note - You must have r level user permission to use this command. See userperm for information on setting user permissions.
|
1. To perform a reset, type the following command:
where options are -y or -F, if desired.
The system 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 switch.
resetsc Command Options
The resetsc command uses two options: -y or -F
If you use the -y option, the reset proceeds without first asking you to confirm the reset.
If you use the -F option, the reset command forces a reset. Forces the reset regardless of the state of the switch. (For example, without this option resetting the switch would not be permitted while ALOM is logging to a PSU's FRUID.)
setbp
Use the setbp command to set a Blueprint of the switch. The switch is shipped with Blueprint set to a managed single switch configuration using the IP address of the switch as basic for the subnet prefix. See Appendix D for more information about Blueprints.
To Use the setbp Command
|
1. At the sc> prompt, type the following command:
CODE EXAMPLE 3-1 shows a sample of the setbp command for a 9-node configuration.
CODE EXAMPLE 3-1 Sample of the setbp Command for 9 Nodes
sc> setbp
Entering Interactive mode.
Use Ctrl-z to exit & save. Use Ctrl-c to abort.
Should this switch run IB management software [y/n]: y
What is max number of hosts in the configuration [0/9/12/18]: 9
Which subnet number is this switch part of [value]: 1
The new blueprint setting is saved
The system must be reset (using resetsc) for the new setting to become active
|
CODE EXAMPLE 3-2 shows a sample of the setbp command for an 18-node configuration.
CODE EXAMPLE 3-2 Sample of the setbp Command for 18 Nodes
sc> setbp
Entering Interactive mode.
Use Ctrl-z to exit & save. Use Ctrl-c to abort.
Should this switch run IB management software [y/n]: y
What is max number of hosts in the configuration [0/9/12/18]: 18
Which subnet number is this switch part of [value]: 1
Is this switch a top switch [y/n]: y
The new blueprint setting is saved
The system must be reset (using resetsc) for the new setting to become active
|
CODE EXAMPLE 3-3 shows a sample of the setbp command for a 9-node configuration with IP-based subnet prefix.
CODE EXAMPLE 3-3 Sample of the setbp Command for 9 Nodes With IP Prefix
sc> setbp -i
Entering Interactive mode.
Use Ctrl-z to exit & save. Use Ctrl-c to abort.
Should this switch run IB management software [y/n]: y
What is max number of hosts in the configuration [0/9/12/18]: 9
Which IP address should be used as subnet number [a.b.c.d]: 129.159.145.11
The new blueprint setting is saved
The system must be reset (using resetsc) for the new setting to become active
|
setbp Command Options
The setbp command uses one command option, -i. This is used for cases where the subnet prefix is based upon an IP address. If no command option is specified, the user will set the subnet prefix value in the interactive mode.
TABLE 3-6 setbp Command Options
Option
|
Description
|
-i
|
IP address used as subnet prefix
|
setdate
Use the setdate command to set the current date and time to that of your local site.
sc> setdate
Usage: setdate [mmdd]HHMM[.SS] | mmddHHMM[cc]yy[.SS]
sc>
|
To Use the setdate Command
|
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 applies the current values as defaults. You can also omit the century value and the value for seconds in the time.
Note - ALOM uses Coordinated Universal Time (UTC). ALOM does not accept time zone conversions or daylight time changes.
|
This example sets the time to August 30, 2005, at 11:28 (11:28 AM) (Coordinated Universal Time).
sc> setdate 083011282005
Tue Aug 30 11:28:03 UTC 2005
|
This example sets the time to August 30 at 11:28 (11:28 AM) of the current year (Coordinated Universal Time).
sc> setdate 08301128
Tue Aug 30 11:28:03 UTC 2005
|
This example sets the time to 11:28 (11:28 AM) of the current month, day, and year (Coordinated Universal Time).
sc> setdate 1128
Tue Aug 30 11:28:03 UTC 2005
|
setdate Command Options
The setdate command uses the following options.
TABLE 3-7 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)
|
setdefaults
Use the setdefaults command to set all configuration variables back to their factory default values.
To Use the setdefaults Command
|
Note - You must have a level user permission to use this command. See userperm for information on setting user permissions. You must set the password to execute permission-level commands.
|
1. At the sc> prompt, type the following command:
sc> setdefaults
Are you sure you want to reset the SC configuration (y/n)? y
Note: Please reset your ALOM to make the new configuration active.
|
2. Type the resetsc command to reset ALOM:
This completes returning the variables back to the factory default values.
setdefaults Command Options
The setdefaults command uses the following option.
TABLE 3-8 setdefaults Command Options
Option
|
Description
|
-y
|
Proceeds without first asking the confirmation question: Are you sure you want to reset the SC configuration?
|
setlocator
Use the setlocator command to turn the switch's Locator LED on or off.
To Use the setlocator Command
|
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
Mar 03 22:07:43: MINOR: SSC0: Locator LED state changed to FLASHING
|
To show the state of the Locator LED, use the showlocator command.
setlocator Command Options
The setlocator command has two options: on and off.
setupsc
Use the setupsc command to customize ALOM.
To Use the setupsc Command
|
Note - You must have a level user permission to use this command. See userperm for information on setting user permissions.
|
1. At the sc> prompt, type the following command:
The setupsc command is interactive. It prompts you to change the values of configuration variables, as in the following example:
sc> setupsc
Entering Interactive setup mode.
Use Ctrl-z to exit & save. Use Ctrl-c to abort.
Do you want to configure the enabled interfaces [y]?
Should the SC network interface be enabled [y]?
Should the SC telnet interface be enabled for new connections [y]?
Do you want to configure the network interface [y]?
Enter the SC IP address [10.4.124.79]:
Enter the SC IP netmask [255.255.255.0]:
Enter the SC IP gateway [10.4.124.1]:
Do you want to configure the System Controller parameters [y]?
Do you want to enable CLI event reporting via the telnet interface [y]?
Enter the level of events to be displayed over the CLI.
(0 = critical, 1 = major, 2 = minor) [2]:
Enter type of CLI prompt generation for SC and switch.
(0 = none, 1 = manual, 2 = auto) [0]:
Enter the prompt string [P1_L_79a>]:
Enter the CLI timeout (0, 60 - 9999 seconds) [0]:
Should the password entry echo *'s [y]?
|
2. Answer the questions to customize ALOM.
The command asks whether you want to enable each set of configuration variables.
- 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]?
|
3. To exit the command, do one of the following:
- To exit and save the changes you made, type Ctrl-Z.
- To exit without saving any changes, type Ctrl-C.
showbp
Use the showbp command to get the running and stored Blueprint which is set to the switch (and the remote switch if using the -r option) See Appendix D for more information about Blueprints.
To Use the showbp Command
|
At the sc> prompt, type the following command:
CODE EXAMPLE 3-3 shows a sample output for showbp command.
CODE EXAMPLE 3-4 Sample Output of the showbp Command
sc> showbp
Blueprint parameter Running value
--------------------------------------------------------
Config (max number of hosts) : 9 (single switch)
Subnet number : 1 (0x1)
Switch level : Bottom
Blueprint parameter Stored value
--------------------------------------------------------
Config (max number of hosts) : 9 (single switch)
Subnet number : 1 (0x1)
Switch level : Bottom
|
showbp Command Options
The showbp command has a single option, -r. This command prints the blueprint of the remote device.
TABLE 3-9 showbp Command Options
Option
|
Description
|
-r
|
Prints the blueprint of the remote device.
|
showdate
Use the showdate command to show the current ALOM date and time.
Note that the time shown is Coordinated Universal Time (UTC). Use the setdate command to synchronize the time with your site.
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
Thu Mar 03 22:06:43 UTC 2005
|
To change the ALOM date and time, use the setdate command. See setdate.
showenvironment
Use the showenvironment command to display a snapshot of the switch's environmental status.
To Use the showenvironment Command
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
The following example shows sample output when no options are specified.
CODE EXAMPLE 3-5 Sample Output of showenvironment Command
sc> showenvironment
============ Environmental Status ============
System Temperatures (Celsius) Current Status
----------------------------------------------------------------
SSC0 /TSensor/ambient 27 OK
SSC0 /TSensor/assp 35 OK
SSC0 /TSensor/air 37 OK
PS0 /TSensor/ambient 21 OK
PS0 /TSensor/Ext1 20 OK
PS0 /TSensor/Ext2 21 OK
PS1 /TSensor/ambient 24 OK
PS1 /TSensor/Ext1 24 OK
PS1 /TSensor/Ext2 29 OK
System Voltages (Volts) Current Status
----------------------------------------------------------------
SSC0 /VSensor/12VInput 12.19 OK
SSC0 /VSensor/5V 5.03 OK
SSC0 /VSensor/stby/3V3 3.30 OK
SSC0 /VSensor/1V2 1.18 OK
SSC0 /VSensor/1V8 1.79 OK
SSC0 /VSensor/2V5 2.50 OK
SSC0 /VSensor/ref/2V5 2.50 OK
SSC0 /VSensor/sis/5V 5.06 OK
PS0 /VSensor/V1anode 12.48 OK
PS0 /VSensor/V1catode 12.30 OK
PS0 /VSensor/PS/main/3V3 3.32 OK
PS1 /VSensor/V1anode 12.42 OK
PS1 /VSensor/V1catode 12.30 OK
PS1 /VSensor/PS/main/3V3 3.32 OK
System Fans (RPM) Current Status
----------------------------------------------------------------
PS0 /Tacho/Fan0 10714 OK
PS0 /Tacho/Fan1 9642 OK
PS1 /Tacho/Fan0 10714 OK
PS1 /Tacho/Fan1 10887 OK
|
The following example shows the environmental information you might see when when you use the -v option.
CODE EXAMPLE 3-6 Sample Output of showenvironment Command Using -v Option
sc> showenvironment -v
============ Environmental Status ============
System Temperatures (Celsius) Current Status Warning Shutdown
Lo/Hi
------------------------------------------------------------------------------
SSC0 /TSensor/ambient 27 OK N/A 0/68
SSC0 /TSensor/assp 35 OK N/A 0/99
SSC0 /TSensor/air 37 OK N/A 0/68
PS0 /TSensor/ambient 21 OK 55 0/64
PS0 /TSensor/Ext1 20 OK 55 0/50
PS0 /TSensor/Ext2 20 OK 55 0/110
PS1 /TSensor/ambient 24 OK 55 0/64
PS1 /TSensor/Ext1 24 OK 55 0/50
PS1 /TSensor/Ext2 29 OK 55 0/110
System Voltages (Volts) Current Status Warning Shutdown
Lo/Hi Lo/Hi
------------------------------------------------------------------------------
SSC0 /VSensor/12VInput 12.25 OK N/A 09.31/13.75
SSC0 /VSensor/5V 5.03 OK N/A 04.48/05.49
SSC0 /VSensor/stby/3V3 3.30 OK N/A 02.96/03.62
SSC0 /VSensor/1V2 1.18 OK N/A 01.08/01.31
SSC0 /VSensor/1V8 1.79 OK N/A 01.62/01.97
SSC0 /VSensor/2V5 2.50 OK N/A 02.24/02.74
SSC0 /VSensor/ref/2V5 2.50 OK N/A 02.24/02.74
SSC0 /VSensor/sis/5V 5.04 OK N/A 04.48/05.48
PS0 /VSensor/V1anode 12.48 OK N/A 10.19/13.81
PS0 /VSensor/V1catode 12.24 OK N/A 09.95/13.51
PS0 /VSensor/PS/main/3V3 3.32 OK N/A 02.96/03.62
PS1 /VSensor/V1anode 12.48 OK N/A 10.19/13.81
PS1 /VSensor/V1catode 12.36 OK N/A 09.95/13.51
PS1 /VSensor/PS/main/3V3 3.32 OK N/A 02.96/03.62
System Fans (RPM) Current Status Warning
------------------------------------------------------------------------------
PS0 /Tacho/Fan0 10546 OK 5000
PS0 /Tacho/Fan1 9782 OK 5000
PS1 /Tacho/Fan0 10546 OK 5000
PS1 /Tacho/Fan1 10887 OK 5000
|
showfru
Use the showfru command to display the contents of all FRU PROMs (field- replaceable units with programmable read-only memory) in the switch.
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 single parameter of the command is a FRU list, that is, any combination of PS0, PS1 and SSC0.
The following example shows sample output for the showfru command. This example displays information about power supply unit 0.
CODE EXAMPLE 3-7 Sample of the showfru Command
sc> showfru ps0
SEGMENT: SD
/ManR/UNIX_Timestamp32: Sat Jan 15 09:22:45 UTC 2005
/ManR/Fru_Description: POWER SUPPLY, A188
/ManR/Manufacture_Loc: BAO'AN,CHINA
/ManR/Sun_Part_No: 3001650
/ManR/Sun_Serial_No: 000013
/ManR/Vendor_Name: Astec Intl
/ManR/Initial_HW_Dash_Level: 02
/ManR/Initial_HW_Rev_Level: 01
/ManR/Fru_Shortname: A188 PSU
/SpecPartNo: 885-0250-02
/Configured_LevelR/Configured_Serial_No:
SEGMENT: FD
/InstallationR(2 iterations)
/InstallationR/UNIX_Timestamp32[0]: Sat Jan 01 00:00:12 UTC 2000
/InstallationR/Fru_Path[0]: SSC0/PS0
/InstallationR/Parent_Part_Number[0]: 5405185
/InstallationR/Parent_Serial_Number[0]: 000003
/InstallationR/Parent_Dash_Level[0]: 01
/InstallationR/System_Id[0]: 000003
/InstallationR/System_Tz[0]: 0
/InstallationR/Geo_North[0]: 0
/InstallationR/Geo_East[0]: 0
/InstallationR/Geo_Alt[0]: 0
/InstallationR/Geo_Location[0]:
/InstallationR/UNIX_Timestamp32[1]: Sat Jan 01 00:00:06 UTC 2000
/InstallationR/Fru_Path[1]: SSC0/PS0
/InstallationR/Parent_Part_Number[1]: 5406193
/InstallationR/Parent_Serial_Number[1]: NNS009
/InstallationR/Parent_Dash_Level[1]: 01
/InstallationR/System_Id[1]: NNS009
/InstallationR/System_Tz[1]: 0
/InstallationR/Geo_North[1]: 0
/InstallationR/Geo_East[1]: 0
/InstallationR/Geo_Alt[1]: 0
/InstallationR/Geo_Location[1]:
/Status_EventsR(4 iterations)
/Status_EventsR/UNIX_Timestamp32[0]: Sat Jan 01 01:43:01 UTC 2000
/Status_EventsR/Old_Status[0]: 0x0
/Status_EventsR/New_Status[0]: 0x0
/Status_EventsR/Initiator[0]: SCAPP
/Status_EventsR/Component[0]: 0x0
/Status_EventsR/Event_Code[0]:
/Status_EventsR/Message[0]: PS0: V1 anode voltage fault recovered.
/Status_EventsR/UNIX_Timestamp32[1]: Sat Jan 01 01:43:01 UTC 2000
/Status_EventsR/Old_Status[1]: 0x0
/Status_EventsR/New_Status[1]: 0x0
/Status_EventsR/Initiator[1]: SCAPP
/Status_EventsR/Component[1]: 0x0
/Status_EventsR/Event_Code[1]:
/Status_EventsR/Message[1]: PS0: DC output fault recovered.
/Status_EventsR/UNIX_Timestamp32[2]: Mon Feb 14 21:50:27 UTC 2005
/Status_EventsR/Old_Status[2]: 0x0
/Status_EventsR/New_Status[2]: 0x0
/Status_EventsR/Initiator[2]: SCAPP
/Status_EventsR/Component[2]: 0x0
/Status_EventsR/Event_Code[2]:
/Status_EventsR/Message[2]: PS0: V1 anode voltage fault recovered.
/Status_EventsR/UNIX_Timestamp32[3]: Mon Feb 14 21:50:27 UTC 2005
/Status_EventsR/Old_Status[3]: 0x0
/Status_EventsR/New_Status[3]: 0x0
/Status_EventsR/Initiator[3]: SCAPP
/Status_EventsR/Component[3]: 0x0
/Status_EventsR/Event_Code[3]:
/Status_EventsR/Message[3]: PS0: DC output fault recovered.
/Soft_ErrorsR(0 iterations)
SEGMENT: PE
SEGMENT: PS
/Power_SummaryR/UNIX_Timestamp32: Thu Mar 03 20:40:35 UTC 2005
/Power_SummaryR/Total_Time_On: 29992
/Power_SummaryR/Total_Power_Ons: 38
/Power_SummaryR/Total_Power_Offs: 0
SEGMENT: TH
/Temperature_HistoryR/UNIX_Timestamp32: Thu Mar 03 21:40:45 UTC 2005
/Temperature_HistoryR/Sensor: 0x0
/Temperature_HistoryR/Lowest: 19
/Temperature_HistoryR/Highest: 24
/Temperature_HistoryR/Latest: 20
/Temperature_HistoryR/Histogram(10 iterations)
/Temperature_HistoryR/Histogram[0]: 0
/Temperature_HistoryR/Histogram[1]: 524
/Temperature_HistoryR/Histogram[2]: 0
/Temperature_HistoryR/Histogram[3]: 0
/Temperature_HistoryR/Histogram[4]: 0
/Temperature_HistoryR/Histogram[5]: 0
/Temperature_HistoryR/Histogram[6]: 0
/Temperature_HistoryR/Histogram[7]: 0
/Temperature_HistoryR/Histogram[8]: 0
/Temperature_HistoryR/Histogram[9]: 0
SEGMENT: ST
/Status_CurrentR/UNIX_Timestamp32: Mon Feb 14 21:50:27 UTC 2005
/Status_CurrentR/Status: 0x0
|
showib
Use the showib command to display InfiniBand switch status. Two sections of information are displayed. The first section contains the InfiniBand topology information, that is, which host channel adapter (HCA) is connected to the various switch ports. The second section contains information related to the local switch ports.
In a multi-switch topology, only the switch controlling the IB setup will display the first section
To Use the showib Command
|
At the sc> prompt, type the following command:
The command returns output similar to the following:
CODE EXAMPLE 3-8 Sample Output for showib Command
sc> showib
Local switch GUID is 0x0003ba0000b0b875
Topology and connection information:
Device PortGUID LID IBport/Conn# Device PortGUID LID IBport/Conn#
------------------------------------------------------------------------------
HCA 0x0002c90108cd70f1 0x0002 1 / 1 <-> Switch 0x0003ba0000b0b875 0x0001 4 / 1
HCA 0x0002c901097687a1 0x0003 1 / 1 <-> Switch 0x0003ba0000b0b875 0x0001 6 / 3
HCA 0x0002c901097687a2 0x0004 2 / 2 <-> Switch 0x0003ba0000b0b875 0x0001 8 / 7
HCA 0x0002c90108cd9a12 0x0005 2 / 2 <-> Switch 0x0003ba0000b0b875 0x0001 1 / 5
HCA 0x0002c90108cd9a11 0x0006 1 / 1 <-> Switch 0x0003ba0000b0b875 0x0001 2 / 6
Information for each local switch port:
Switch connector 0:
PortPhysicalState = Polling
LinkWidthActive = 12X
PortXmitPkts = 0x0000000000000000
PortRcvPkts = 0x0000000000000000
Switch connector 1:
PortPhysicalState = LinkUp
LinkWidthActive = 4X
PortXmitPkts = 0x0000000000000717
PortRcvPkts = 0x0000000000000718
Switch connector 2:
PortPhysicalState = Polling
LinkWidthActive = 12X
PortXmitPkts = 0x0000000000000000
PortRcvPkts = 0x0000000000000000
Switch connector 3:
PortPhysicalState = LinkUp
LinkWidthActive = 4X
PortXmitPkts = 0x0000000000000717
PortRcvPkts = 0x0000000000000718
Switch connector 4:
PortPhysicalState = Polling
LinkWidthActive = unknown
PortXmitPkts = 0x0000000000000000
PortRcvPkts = 0x0000000000000000
Switch connector 5:
PortPhysicalState = LinkUp
LinkWidthActive = 4X
PortXmitPkts = 0x0000000000000714
PortRcvPkts = 0x0000000000000714
Switch connector 6:
PortPhysicalState = LinkUp
LinkWidthActive = 4X
PortXmitPkts = 0x0000000000000715
PortRcvPkts = 0x0000000000000715
Switch connector 7:
PortPhysicalState = LinkUp
LinkWidthActive = 4X
PortXmitPkts = 0x0000000000000716
PortRcvPkts = 0x0000000000000717
Switch connector 8:
PortPhysicalState = Polling
LinkWidthActive = unknown
PortXmitPkts = 0x0000000000000000
PortRcvPkts = 0x0000000000000000
|
showib Command Options
The showib command uses a single option, -v. This verbose option shows the error counters of the switch ports in addition to the information shown in CODE EXAMPLE 3-8.
TABLE 3-10 showib Command Options
Option
|
Description
|
-v
|
Shows the error counters of the switch ports in as well as the information shown by the command without the option.
|
showlocator
Use the showlocator command to view the state of the switch's Locator LED (on or off).
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 returns the following result:
sc> showlocator
showlocator: Locator indicator is ON (flashing)
|
- If the Locator LED is off, ALOM returns the following result:
sc> showlocator
showlocator: Locator indicator is OFF
|
To change the state of the Locator LED, use the setlocator command.
showlogs
Use the showlogs command to display the history of all events logged in the ALOM event buffer. These events include switch reset events and all ALOM commands that change the state of the system (such as reset, poweroff, and poweron).
Each event recorded in the log has the following format:
date: severity: FRU: message
Where date signifies the time at which the event occurred, as recorded by ALOM, severity is the seriousness of the event, FRU says where the event occurred (on PS0, PS1 or SSC0), and message is a short description of the event.
If you use the showlogs command without any option, ALOM displays the last 20 lines of the 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 option(s) is the desired option(s), if any.
The following example shows an event log entry:
NOV 15 11:12:25: MAJOR: PS1: Fan0 fan speed fault.
|
Note - Timestamps shown in the ALOM event log reflect UTC (Coordinated Universal Time).
|
This example shows the output of the showlogs command for PS0 and PS1.
CODE EXAMPLE 3-9 Sample of showlogs Command
sc> showlogs PS0 PS1
----------------------------------------------------------------
PS0
----------------------------------------------------------------
Jan 01 00:00:04: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:04: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:04: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:10: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:04: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
Jan 01 00:00:05: MINOR: PS0: Environmental monitoring enabled.
----------------------------------------------------------------
PS1
----------------------------------------------------------------
Jan 01 00:00:07: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:07: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:07: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:07: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:07: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:12: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: PS1: Environmental monitoring enabled.
Jan 01 00:00:07: MINOR: PS1: Environmental monitoring enabled.
Jan 04 16:32:18: MAJOR: PS1: Fan0 fan speed fault.
Jan 04 16:32:19: MAJOR: PS1: Fan1 fan speed fault.
Jan 04 16:32:34: MAJOR: PS1: V1 catode voltage fault.
Jan 04 16:32:35: MAJOR: PS1: Fan0 fan speed fault recovered.
Jan 04 16:32:35: MAJOR: PS1: Fan1 fan speed fault recovered.
Jan 04 16:32:36: CRITICAL: PS1: DC output fault recovered.
sc>
|
CODE EXAMPLE 3-10 Sample of showlogs command for SSC0
sc> showlogs SSC0
Jan 01 00:00:14: MINOR: SSC0: Service Required LED state changed to OFF.
Jan 01 00:00:14: MINOR: SSC0: Locator LED state changed to OFF.
Jan 01 00:00:31: MAJOR: Factory commands Enabled
Jan 01 00:00:03: MINOR: SSC0: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: SSC0: Active LED state changed to ON.
Jan 01 00:00:06: MINOR: SSC0: Service Required LED state changed to OFF.
Jan 01 00:00:06: MINOR: SSC0: Locator LED state changed to OFF.
Jan 01 00:00:03: MINOR: SSC0: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: SSC0: Active LED state changed to ON.
Jan 01 00:00:06: MINOR: SSC0: Service Required LED state changed to OFF.
Jan 01 00:00:06: MINOR: SSC0: Locator LED state changed to OFF.
Jan 01 00:01:58: MAJOR: Factory commands Enabled
Jan 01 00:00:03: MINOR: SSC0: Environmental monitoring enabled.
Jan 01 00:00:06: MINOR: SSC0: Active LED state changed to ON.
Jan 01 00:00:06: MINOR: SSC0: Service Required LED state changed to OFF.
Jan 01 00:00:06: MINOR: SSC0: Locator LED state changed to OFF.
Jan 04 16:32:22: MINOR: SSC0: Service Required LED state changed to ON.
Jan 04 16:32:39: MINOR: SSC0: Service Required LED state changed to OFF.
Nov 30 11:28:42: MINOR: SSC0: Locator LED state changed to FLASHING.
Nov 30 11:28:54: MINOR: SSC0: Locator LED state changed to OFF.
sc>
|
showlogs Command Options
The showlogs command uses six options. 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 does not pause.
TABLE 3-11 showlogs Command Options
Option
|
Description
|
-v
|
Displays the entire contents of the buffer file and the contents of NVRAM (the persistent event log).
|
-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 shows the following message:
- -pause-- Press 'q' to quit, any other key to continue.
|
-t
|
Displays boot and loopback test errors log (available only for SSC0).
|
frulist
|
Displays logs for the FRUs you list.
|
showplatform
Use the showplatform command to display information about the switch'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 switch returns information similar to the following:
sc> showplatform
FRU Status Type
-------- ------------- --------------------
SSC0 OK Sun IB Switch 9P
PS0 OK POWER SUPPLY, A188
PS1 OK POWER SUPPLY, A188
|
Using the -v option returns information similar to the following:
sc> showplatform -v
FRU Status Type Part No. Serial No.
-------- ------------- -------------------- -------- ----------
SSC0 OK Sun IB Switch 9P 5957467 000011
PS0 OK POWER SUPPLY, A188 3001650 000031
PS1 OK POWER SUPPLY, A188 3001650 000044
Domain Status MAC Address Hostname
-------- ------------------- ----------------- ---------------
SSC0/SC OS Running (Active) 00:03:ba:7a:a1:76
sc>
|
showplatform Command Options
The showplatform command uses three options.
TABLE 3-12 showplatform Command Options
Option
|
Description
|
-v
|
Displays the part and serial numbers as well as status and type.
|
frulist
|
Displays information for the given FRUs.
|
showsc
Use the showsc command to display information about the software configuration and firmware version.
To Use the showsc Command
|
Note - You do not need user permissions to use this command.
|
Do one of the following:
- To display the switch configuration information, type the following command at the sc> prompt:
sc> showsc
Sun Advanced Lights Out Manager for Sun IB Switch 9P
Copyright 2003-2005 Sun Microsystems, Inc. All Rights Reserved.
ALOM-B 1.2
Release: 0.3.19, Created: 2005.02.24.09.27 (astec_debug) for Astec PSU
Parameter Running Value Stored Value
------------------------------------------------------------------------------
Bootable Image : 0.3.19 (Feb 24 05)
Current Running Image : 0.3.19 (Feb 24 05)
SC IP address: 10.4.124.79 10.4.124.79
SC IP netmask address: 255.255.255.0 255.255.255.0
SC IP gateway address: 10.4.124.1 10.4.124.1
SC Network interface is: Enabled Enabled
SC Telnet interface is: Enabled Enabled
The CLI prompt generation is set as: none none
The CLI prompt is set as: P1_L_79a> P1_L_79a>
Event Reporting via telnet interface: Enabled Enabled
The CLI event level is set as: MINOR MINOR
The CLI timeout (seconds) is set at: 0 0
Mask password with *'s: Enabled Enabled
sc>
|
showusers
Use the showusers command to display the list of users currently logged-in to ALOM. The list includes details such as the type of connection, the duration of each user's session, and the IP address of the client (if the user is using a network connection).
To Use the showusers Command
|
Note - You do not need user permissions to use this command.
|
At the sc> prompt, type the following command:
The system displays user information similar to the following example:
sc> showusers
username connection login time IP address
-------- ---------- ---------- ----------
admin net-1 Mar 03 16:42 UTC 129.149.2.17
admin net-2 Mar 03 22:04 UTC 129.150.25.245
|
Note - The switch allows a maximum of four Telnet sessions and one serial session for all users, at any time.
|
useradd
Use the useradd command to add a user account.
To Use the useradd 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 user whose account you want to add to ALOM.
username has the following restrictions:
- Valid characters include alphabetic (letter) and numeric characters, period (.), underscore (_), and hyphen (-).
- Maximum length is 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 50 unique user accounts to ALOM.
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.
userdel
Use the userdel command to delete a 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 users, the system returns an error message. Likewise, if there is only one user on the list, you cannot delete that user account.
Note - You cannot delete the default admin user account.
|
To Use the userdel 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 user account you want to delete.
userpassword
Use the userpassword command to change the password for the specified user account. This command is for administrators who must change user passwords, but who might not know what the user account passwords are. If you are trying to change the password on your own 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 does not prompt you for the existing password.
For example:
sc> userpassword msmith
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 the user's login name, and any reverse or circular shift of the user's 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 - These password restrictions do not apply to a user with u permission.
|
userperm
Use the userperm command to set or change permission levels for a specified user account. By default, the initial setup procedure creates the admin account. This account cannot be deleted, nor can you change the user permissions for the account.
Permission Levels
All users can read ALOM information, but authorization is required to perform ALOM functions or change settings. There are four permission levels that increase a user's authorization. You can specify zero through four permission levels.
TABLE 3-13 userperm Permission Levels
Permission Level
|
Description
|
a
|
Administrative. This user is authorized to change the state of ALOM configuration variables and perform flashupdate command.
|
u
|
User administration. This user is authorized to add users and delete users, change user permissions, and change the authorization level of other users. See useradd and userdel.
|
c
|
Console permission. (Not used, preserved for compatibility.)
|
r
|
Reset/power permission. This user is authorized to reset the switch, and power the FRUs on and off. See poweron, and poweroff.
|
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 user account.
Note - The default user permission for the account that you use when you start ALOM 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 view 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 permission(s)
|
where username is the name of the user to whom you want to assign permissions, and permission(s) is the permission(s) 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 command prompt:
To see a user's permission levels, use the usershow command.
A user with read-only permission can use only the following commands:
A user who has read-only permissions would appear similar to the user mike in the following example:
sc> usershow mike
username permissions password?
-------- ----------- ---------
mike ---- Assigned
|
usershow
Use the usershow command to display a specified user's ALOM account, along with each user's permissions and whether a password has been assigned. See userperm and userpassword.
If you do not enter a username, usershow displays all of the user 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, Mike is the specified user in the following example.
For example:
sc> usershow mike
username permissions password?
-------- ----------- ---------
mike auc- Assigned
|
Sun IB Switch 9P Administration Guide
|
819-7247-10
|
|
Copyright © 2004, Sun Microsystems, Inc. All Rights Reserved.