A P P E N D I X A |
Troubleshooting |
This chapter consists of tables of the most common issues you may experience with ALOM, shell error messages you see in ALOM, common scadm error messages, and troubleshooting suggestions. It contains the following sections:
TABLE A-1 provides solutions for common modem configuration problems.
Verify that cabling is set up correctly.See the if_modem variable for additional information |
|
TABLE A-2 provides a list of common ALOM difficulties and their solutions.
Perform the following actions to troubleshoot ALOM log-in problems:
|
|
ALOM supports a total of four concurrent Telnet sessions per server. When the maximum number of Telnet sessions are active, further attempts to connect using the telnet command will receive a connection closed error. The following example shows system messages for the UNIX operating environment: |
|
First, log in to the server as root and check whether the scadm version command succeeds. If it does, ALOM is working and there is an Ethernet configuration problem. Use the scadm show command to check whether Ethernet configuration variables are set correctly. You can also perform the following actions to troubleshoot Ethernet problems:
|
|
Check the setting of the sys_eventlevel variable for syslog, the sc_clieventlevel variable for the ALOM 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. Make sure that if_emailalerts is set to true, and that mgt_mailhost is set correctly for email alerts. Refer to sc_clieventlevel and mgt_mailalert. |
|
If users have forgotten ALOM passwords or passwords are not working, log in to the server as root and use the scadm userpassword command to assign new passwords. Inform ALOM users of the new passwords. Refer to scadm userpassword. |
|
Specific user permissions are required to perform functions. Check your permission level. Refer to userperm. In addition, the following problems might exist:
|
ALOM 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, and OpenBoot Diagnostics.
If the server is not responding, log in to your ALOM account and do the following:
Although multiple users can connect to the system console from ALOM, 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 has a "watchdog" feature that senses when the host server's operating system might be frozen. The watchdog function periodically checks whether the host server's operating system is running. If the host server does not respond, the watchdog times out after a specified period of time. You can either use the reset command from the ALOM command shell to manually reset the server, or you can configure the sys_autorestart variable to automatically reset the host server when the watchdog detects a timeout. Refer to reset, and sys_autorestart for further information.
This section contains information about certain types of error messages you might see when using the ALOM command shell:
These messages appear in response to a command you typed at the sc> prompt.
This list describes usage error messages that are displayed when you typed the command using improper command syntax. Refer to the description of the command for the correct syntax.
ALOM reports the following general errors.
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. |
||
You tried to delete the admin user account from ALOM. ALOM does not allow you to delete this account. |
||
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. |
||
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. |
||
Error: invalid password entered. 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. |
|
Error: invalid username string. Please re-enter username or type 'usershow' to see a list of existing users. |
You tried to specify an ALOM user account that is not on the list of user accounts. To see a list of valid user accounts, use the usershow command. |
|
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. |
||
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. Refer to netsc_ipaddr,netsc_ipgateway, setupsc, or setsc. |
|
Error: Invalid IP netmask for 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. |
|
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 |
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. |
|
The front panel rotary switch on the host server is in the Locked position. Change the position of the rotary switch and retype the break command. |
||
During execution of the console command, ALOM could not allocate enough memory to connect to the console. |
||
During execution of the userpassword command, a SEEPROM error occurred. Try executing the command again. |
||
During execution of the setsc command, ALOM encountered a SEEPROM error. |
||
Login attempt failed. This message appears at the login prompt. |
||
You entered an invalid password with the userpassword command. |
||
This error occurs if you try to add a user account when ALOM already has the maximum of 16 accounts configured. You must delete an account before you can add another. |
||
The two entries for a new password did not match. Enter the password again. |
||
You attempted to execute a shell command for which you do not have the proper user permission level. |
||
You entered an incorrect password. Enter the password again. |
||
The user you are trying to add already has an ALOM account on this server. |
The following error messages appear when ALOM detects problems with FRUs (field-replaceable units).
The following table lists common scadm error messages and their causes. These messages appear in alphabetical order.
When you execute the userpassword command, you need to enter the password twice. If the two passwords you enter do not match, this error appears. Execute the userpassword command again.Refer to userpassword. |
|
This error occurs when you try to add a user account after ALOM already has the maximum of 16 accounts configured. You must delete an existing account before you can add a new one. Refer to userdel. |
|
You may have typed too many characters on the command line. Make sure that the command you used is valid, and execute the command again using fewer characters. |
|
The command you used is invalid for scadm. If the command is a valid ALOM command but does not exist as an scadm command, you must execute the command from ALOM. Refer to List of scadm Commands, and ALOM Shell Commands. |
|
An undefined error in the ALOM firmware occurred while scadm tried to obtain the current date and time from ALOM. Execute the command again, or run the command from ALOM. |
|
While executing the send_event command, ALOM firmware could not log an event or send an alert message. Refer to scadm send_event. |
|
An undefined error in the ALOM firmware occurred while scadm tried to set the current date and time in ALOM. Execute the command again, or run the command from ALOM. Refer to scadm date. |
|
scadm encountered an internal error while trying to add a user account. This may be due to a faulty SEEPROM. Refer to scadm useradd |
|
scadm encountered an internal error while trying to change a user password. This may be due to a faulty SEEPROM. Refer to scadm userpassword. |
|
scadm encountered an internal error while trying to change user permissions. This may be due to a faulty SEEPROM. |
|
scadm encountered an internal error while trying to delete a user account. This may be due to a faulty SEEPROM. Refer to scadm userdel. |
|
scadm encountered an internal error while trying to execute the usershow command. This may be due to a faulty SEEPROM. Refer to usershow. |
|
ALOM reported a hardware problem while executing the flashupdate command. There may be a problem with the SEEPROM. Refer to scadm download. |
|
ALOM reported a hardware problem while executing the flashupdate command. There may be a problem with the SEEPROM. Refer to scadm download. |
|
ALOM reported a hardware problem while executing the flashupdate command. There may be a problem with the SEEPROM. Refer to scadm download. |
|
ALOM reported a hardware problem while executing the flashupdate command. There may be a problem with the SEEPROM. Refer to scadm download. |
|
ALOM reported a hardware problem while executing the flashupdate command. There may be a problem with the SEEPROM.Refer to scadm download. |
|
ALOM reported a hardware problem while executing the flashupdate command. There may be a problem with the SEEPROM. Refer to scadm download. |
|
You cannot execute the flashupdate command while the server rotary switch is in the Locked position. Check the rotary switch position and execute the command again. Refer to scadm download. |
|
An internal error occurred during execution of the flashupdate command. Run the command again. Refer to scadm download. |
|
An internal error occurred during execution of the flashupdate command. Run the command again. Refer to scadm download. |
|
You specified an incorrect value for the configuration variable specified in param. Check the configuration variable you want to use and retype the command. Refer to Configuration Worksheet. |
|
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. Refer to setsc, or showsc, and Configuration Worksheet. |
|
When you execute the userpassword command, you need to enter the password twice. If the two passwords you enter do not match, this error appears. Execute the command again. Refer to userpassword. |
|
An internal error occurred during execution of the download command. Run the command again. Refer to scadm download. |
|
The message you enter for the send_event command must contain fewer than 80 characters. Refer to scadm send_event. |
|
An error occurred during execution of the download command; scadm could not open the file specified on the command line. Check that you specified the correct file and run the command again. Refer to scadm download. |
|
An error occurred during execution of the flashupdate command; the file you specified for downloading is not a valid srecord file. Check the file name and run the command again. Refer to scadm download. |
|
An internal error occurred during execution of the date command. Run the command again. Refer to scadm date. |
|
An internal error occurred during execution of the flashupdate command. Run the command again. Refer to scadm download. |
|
You entered an invalid variable while executing the set command. Check the list of configuration variables and execute the command again. Refer to scadm set. |
|
You entered an invalid variable or value while executing the set command. Check the list of configuration variables and execute the command again. Refer to scadm set. |
|
You entered an invalid password. A valid password has between six and eight characters, at least two of which are letters, and at least one of which is a digit or special character. |
|
You entered invalid characters in a user name. scadm: maximum username length is 16 The user name you entered exceeded the maximum of 16 characters. Enter the user name again using 16 or fewer characters. |
|
An internal error occurred during execution of the flashupdate command. Run the command again. Refer to scadm download. |
|
During execution of the flashupdate command, ALOM did not enter boot mode correctly. Refer to scadm download. |
|
The main ALOM firmware is not responding. This can happen when ALOM is booting, or because the main firmware is corrupt, or ALOM has a hardware problem. Wait a few minutes, and then execute the command again. |
|
ALOM did not send a response that scadm was expecting. Check that ALOM is working. |
|
During execution of the flashupdate command, ALOM returned an undocumented error. Run the command again. Refer to scadm download. |
|
This error can occur in various situations. Run the command again. |
|
During execution of the download command, ALOM returned undocumented status (neither success nor failure). Run the command again. Refer to scadm download. |
|
ALOM returned an invalid response during a user command. This is considered an internal error in ALOM or the scadm utility. Refer to Overview of the scadm Utility. |
|
This message can occur in various situations. The scadm utility was unable to free the received message from the ALOM firmware. |
|
During execution of the resetsc command, an attempt to hard reset ALOM failed. Refer to resetsc. |
|
ALOM did not acknowledge data sent to it. Check that ALOM is working. |
|
The user you are trying to add already has an ALOM account on this server. |
|
scadm: username did not start with letter or did not contain lowercase letter |
You used an invalid user name format when trying to add an ALOM user account. Refer to the useradd command and try running it again. Refer to useradd. |
The user name you specified is not associated with an ALOM account on this server. |
|
You entered an incorrect value for scadm date. Refer to the date command for proper syntax and run the scadm date command again. Refer to scadm date. |
|
You entered an incorrect value for scadm download. Refer to the download command for proper syntax and run the scadm download command again. Refer to scadm download. |
|
You entered an incorrect value for scadm loghistory. Refer to the loghistory command for proper syntax and run the scadm showlogs command again. Refer to scadm loghistory. |
|
You entered an incorrect value for scadm resetrsc. Refer to the resetrsc command for proper syntax and run the scadm resetrsc command again. Refer to scadm resetrsc. |
|
You entered an incorrect value for scadm set. Refer to the set command for proper syntax and run the scadm set command again. Refer to scadm set. |
|
You entered an incorrect value for scadm show. Refer to scadm show for proper syntax and run the scadm show command again. |
|
You entered an incorrect value for scadm shownetwork. Refer to scadm shownetwork for proper syntax and run the scadm shownetwork command again. |
|
You entered an incorrect value for scadm useradd. Refer to the useradd command for proper syntax and run the scadm useradd command again. Refer to scadm useradd. |
|
You entered an incorrect value for scadm userdel. Refer toscadm userdel for proper syntax and run the scadm userdel command again. |
|
You entered an incorrect value for scadm userpassword. Refer to scadm userpassword for proper syntax and run the scadm userpassword command again. |
|
You entered an incorrect value for scadm userperm. Refer to scadm userperm for proper syntax and run the scadm userperm command again. |
|
You entered an incorrect value for scadm usershow. Refer to scadm usershow for proper syntax and run the scadm usershow command again. |
Copyright © 2004, Sun Microsystems, Inc. All rights reserved.