A P P E N D I X A

Troubleshooting

This chapter consists of tables of the most common issues you might experience with ALOM CMT, shell error messages you see in ALOM CMT, and troubleshooting suggestions. This chapter contains the following sections:

Troubleshooting ALOM CMT Problems

Using ALOM CMT to Troubleshoot Server Problems

ALOM CMT Shell Error Messages

Recovering ALOM CMT Passwords

Troubleshooting ALOM CMT Problems

TABLE A-1 provides a list of common ALOM CMT difficulties and their solutions.

TABLE A-1 ALOM CMT Diagnostics
Problem	Description
Can't log in to ALOM CMT	Perform the following actions to troubleshoot ALOM CMT login problems: Check the ALOM CMT device name you are connecting to: (for example, `bert-sc`). Ensure that you have the correct ALOM CMT name for the corresponding server. Check that you are using your correct ALOM CMT username. The name might not be the same as your system user name. Check that you are using your correct ALOM CMT password.
Can't connect to ALOM CMT using the `telnet` or `ssh` command	ALOM CMT supports a total of eight Telnet or SSH sessions per server. When the maximum number of Telnet or SSH sessions are active, further attempts to connect using the `telnet` or `ssh` commands will receive a `connection closed` error. The following example shows system messages for the UNIX operating environment: % `ssh 129.148.49.120` Trying 129.148.49.120... ssh_exchange_identification: Connection closed by remote host
Can't connect to ALOM CMT through the Ethernet connection	First, check whether ALOM CMT is working or there is an Ethernet configuration problem. You can also perform the following actions to troubleshoot Ethernet problems: Log in to ALOM CMT through the serial management port (SER MGT) and use the `shownetwork` command to see the current settings. Refer to shownetwork. Log in to another machine on the network and use the `ping` command to see whether ALOM CMT is operating. Be sure to use the ALOM CMT device's name (for example, `servername-sc`), not the host server's name, as the argument to the `ping` command. Run ALOM CMT VxDiags by using the `resetsc` command. Observe the output on the SER MGT connection. ALOM CMT automatically tests the Ethernet hardware after each reset and prints the results on the serial management (SER MGT) port.
No alerts received from ALOM CMT	Check the setting of the `sc_clieventlevel` variable for the ALOM CMT command shell, and the `mgt_mailalert` variable for email alerts to make sure that you are receiving the proper levels of events in the specified places. Ensure that `if_emailalerts` is set to `true`, and that `mgt_mailhost` is set correctly for email alerts. Refer to sc_clieventlevel and mgt_mailalert.
ALOM CMT passwords are unknown	If users have forgotten ALOM CMT passwords or passwords are not working, re-create the passwords. Use the `userpassword` command (see userpassword). If no user passwords are known, see Recovering ALOM CMT Passwords.
You can perform some ALOM CMT functions, but not others	Specific user permissions are required to perform functions. Check your permission level. Refer to userperm. In addition, the following problems might exist: Cannot see console logs or access the server console using ALOM CMT. Cannot put the server into debug mode or use the ALOM CMT `break` command. The server virtual keyswitch status is `locked`. The `poweroff` command has no effect. The server is already powered off. The `poweron` command has no effect. The server is already powered on, or the virtual keyswitch is in the Standby status.

Using ALOM CMT to Troubleshoot Server Problems

ALOM CMT is useful for troubleshooting a server that is not responding. If the server is responsive, connect to it and use standard troubleshooting tools such as Sun Management Center, SunVTS software, and OpenBoot firmware.

If the server is not responding, log in to your ALOM CMT account and do the following:

Check the ALOM CMT event log and server environmental status for problems. Refer to showfaults, showlogs, and showenvironment for more information.

Check console logs for recent error messages. Refer to consolehistory.

Try connecting to the system console to reboot the system. Refer to console.

System Console Write Lock

Although multiple users can connect to the system console from ALOM CMT, only one user at a time has write access to the console (that is, only one user can type commands into the system console). Any characters that other users type are ignored. This is referred to as a write lock, and the other user sessions are in read-only mode. If no other users are currently logged in to the system console, then you obtain the write lock automatically when you execute the console command. To see which user has the write lock, use the showusers command. Refer to showusers for more information.

ALOM CMT controls the flow rate of the system console to match the flowrate 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.

ALOM CMT Shell Error Messages

This section contains information about certain types of error messages you might see when using the ALOM CMT command shell:

Usage Errors

General Errors

CLI Messages Regarding FRU State

These messages appear in response to a command you typed at the sc> prompt.

Usage Errors

This table describes usage error messages that are displayed when you type the command using improper command syntax. Refer to the description of the command for the correct syntax.

TABLE A-2 Usage Error Messages
Error Message	Command/Description	Section
Error: Invalid commandoption. Type `help` to listcommands.	`Help`.	help
Error: Invalid commandoptions Usage: usage string	You typed the shell command correctly, but used an incorrect option for that command. usage string describes the proper syntax for command options. Check the command options and retype the command.
Error: Invalidconfiguration parameter.	You specified a nonexistent configuration variable when using the `setsc` or `showsc` command. Check the configuration variables and their values in your configuration table and retype the command.	setsc, showsc, Configuration Worksheet.
Error: Invalid image.Please check fileintegrity and specified path.	An error occurred when you tried to execute the `flashupdate` command. Ensure that the path you specified is correct for the firmware image you want to download. If the path is correct, contact the administrator for the server where the image is located.
Error: Invalid settingfor parameter param.	You specified an incorrect value for the configuration variable specified in param. Check the configuration variable you want to use and retype the command.	Configuration Worksheet.
Error: Unable to programflash SC because keyswitch is in LOCKED position.	Your host server's virtual keyswitch has the LOCKED status. Set the keyswitch to the NORMAL status, then execute the `flashupdate` command again.
Error: Unable to set clock while managed system is running.	You tried to set the ALOM CMT date and time while the host server was running. If you need to set the ALOM CMT date and time, ensure that the system is powered off first.

General Errors

ALOM CMT reports the following general errors.

TABLE A-3 General Error Messages
Error Message	Command/Description	Section
Error adding user username	An error occurred during execution of the `useradd` command. This message is followed by a more detailed message that explains the nature of the error.	useradd
Error: Cannot delete `admin`user	You tried to delete the `admin` user account from ALOM CMT. ALOM CMT does not permit you to delete this account.
Error changing password forusername	An error occurred during execution of the `userpassword` command. This message is followed by a more detailed message that explains the nature of the error.	userpassword
Error: Inconsistent passwordsentered.	During execution of the `userpassword` command, you typed the password differently the second time than you did the first time you were prompted. Execute the command again.	userpassword
Error: invalid passwordentered. Password must be 6-8 characters, differ from the previous by at least 3 characters and contain at least two alphabetic characters and at least one numeric or special character.	You entered an invalid password. Refer to the password restrictions and then enter the password again.	userpassword
Error: invalid username string. Please re-enter username or type 'usershow' to see a list of existing users.	You tried to specify an ALOM CMT user account that is not on the list of user accounts. To see a list of valid user accounts, use the `usershow` command.	usershow
Error displaying userusername	An error occurred during execution of the `usershow` command. This message is followed by a more detailed message that explains the nature of the error.	usershow
Error: Invalid IP address for gateway address netsc_ipgateway and IP netmask netsc_ipnetmask.	You entered a value for the netsc_ipaddr variable that does not work with the values you specified for the netsc_ipgateway and netsc_ipnetmask variables. Check that the addresses are correct, and then run `setupsc` or `setsc` again.	netsc_ipaddr,netsc_ipgateway, setupsc, or setsc
Error: Invalid IP netmaskfor IP address netsc_ipaddr and IP gateway netsc_ipgateway.	You entered a value for the netsc_ipnetmask variable that does not work with the values you specified for the netsc_ipgateway and netsc_ipaddr variables. Check that the addresses are correct, and then run `setupsc` or `setsc` again.	netsc_ipgateway, netsc_ipnetmask, setupsc, or setsc
Error: Invalid IP gateway for IP address netsc_ipaddr and IP netmask netsc_ipnetmask.	You entered a value for the netsc_ipgateway variable that does not work with the values you specified for the netsc_ipnetmask and netsc_ipaddr variables. Check that the addresses are correct, and then run `setupsc` or `setsc` again.	netsc_ipgateway, netsc_ipnetmask, netsc_ipaddr, setupsc, or setsc
Error setting permission for username	An error occurred during execution of the `userperm` command. This message is followed by a more detailed message that explains the nature of the error.	Refer to userperm
Error: Invalid username string. Please re-enter a username of no more than 16 bytes consisting of characters from the set of alphabetic characters, numeric characters, period (.), underscore (_), and hyphen (-). The first character should be alphabetic and the field should contain at least one lower case alphabetic character.	You entered an invalid username. Review the proper syntax for user names and try again.	useradd
Error: Unable to execute break because keyswitch is in LOCKED position.	Change the status of the keyswitch and retype the `break` command.	break
Failed to get password for username	During execution of the `userpassword` command, a SEEPROM error occurred. Try executing the command again.	userpassword
Failed to set variable to value	During execution of the `setsc` command, ALOM CMT encountered a SEEPROM error.	setsc
Invalid login	Login attempt failed. This message appears at the login prompt.
Invalid password	You entered an invalid password with the `userpassword` command.	userpassword
Invalid permission: permission	You entered an invalid user permission.	userperm
Error: Maximum number of users already configured.	This error occurs if you try to add a user account when ALOM CMT already has the maximum of 16 accounts configured. You must delete an account before you can add another.	userdel
Passwords don't match	The two entries for a new password did not match. Enter the password again.
Permission denied	You attempted to execute a shell command for which you do not have the proper user permission level.	userperm
Sorry, wrong password	You entered an incorrect password. Enter the password again.
Error: User username already exists.	The user you are trying to add already has an ALOM CMT account on this server.

CLI Messages Regarding FRU State

The following error messages appear when ALOM CMT detects problems with field-replaceable units (FRUs).

TABLE A-4 FRU Error Messages
Error Message	Command/Description	Refer to:
Error: xxx is currently powered off.	xxx is the name of the FRU to which you tried to send a command. The FRU is currently powered off. You need to turn it back on using the `poweron` command before it will accept commands.	poweron
Error: xxx is currently powered on.	xxx is the name of the FRU to which you tried to send a `poweron` command. The FRU is already powered on.	poweron
Error: xxx is currently prepared for removal.	xxx is the name of the FRU to which you tried to send a `removefru` command. The FRU is already powered off and ready for removal.	removefru
Error: Invalid FRU name.	You entered a FRU command without specifying an option, or you specified an invalid FRU name with the command. Check that you have a valid FRU name and retype the command.	showfru

Related Information

ALOM CMT Shell Commands

Recovering ALOM CMT Passwords

For security reasons, this procedure is available only while accessing the system directly through the serial port. The procedure resets all ALOM CMT NVRAM settings.

To Recover Your ALOM CMT Passwords:

1. Connect to the system controller's serial port.

2. Power down the server.

Remove the power cords from both power supplies. Wait several seconds for power to discharge before reinserting the cords.

3. Press the Escape key during ALOM CMT boot when the following text is displayed on the console:

Boot Sector FLASH CRC Test
Boot Sector FLASH CRC Test, PASSED.
 
 
 
Return to Boot Monitor for Handshake

After pressing the Escape key, the ALOM CMT boot escape menu is printed:

ALOM <ESC> Menu
 
e - Erase ALOM NVRAM.
m - Run POST Menu.
R - Reset ALOM.
r - Return to bootmon.
Your selection:

4. Enter e to erase the ALOM CMT NVRAM.

Your selection: e
ALOM NVRAM erased.
 
ALOM <ESC> Menu
 
e - Erase ALOM NVRAM.
m - Run POST Menu.
R - Reset ALOM.
r - Return to bootmon.
Your selection:

5. Enter r to return to the ALOM CMT boot process.

Your selection: r
 
ALOM POST 1.0
    Status = 00007fff

ALOM CMT then boots and resets all NVRAM settings. You are automatically logged on as user admin with no password and no permissions. All ALOM CMT NVRAM settings are reset to the factory defaults.