A P P E N D I X B |
Error Messages |
This section discusses user-visible error messages for SMS. The types of errors and the numerical ranges are listed. To view individual errors, you must install the SMSHelp software package (SUNWSMSjh). This section contains installation instructions for SUNWSMSjh, if it was not already installed during the SMS software installation.
Each error in SMSHelp contains the error ID, the text of the message, the meaning of the message, references for further information if applicable, and recovery action to take or suggested steps for further analysis.
This chapter includes the following sections:
This section explains how to manually install the SUNWSMSjh package using the standard installation utility, pkgadd.
To Install theSUNWSMSjh Package |
1. Log in to the SC as superuser.
2. Load the SUNWSMSjh package on the server:
The software briefly displays copyright, trademark, and license information for each package. Then it displays messages about pkgadd(1M) actions taken to install the package, including a list of the files and directories being installed. Depending on your configuration, the following messages might be displayed:
This package contains scripts which will be executed with superuser permission during the process of installing this package. Do you want to continue with the installation of this package [y,n,?] |
3. Type y at each successive prompt to continue.
When this portion of the installation is complete, the SUNWSMSjh package has been installed and the superuser prompt is displayed.
To Start smshelp |
1. Log in to the SC as a user with platform or domain group privileges.
2. In any terminal window, type:
The smshelp browser appears. You can resize the panes if necessary, by placing your cursor to the right of the vertical scroll bar, pressing the left mouse button, and dragging the cursor to the right.
Error messages are recorded in the platform and domain logs.
The message format follows the syslog(3) convention:
timestamp host process_name [pid]: [message_code hight_res_timestamp level source_code_file_name source_code_line_num] message_text |
Feb 2 18:36:14 2002 xc17-sc0 dsmd[117469]-B(): [2517 16955334989087 WARNING EventHandler.cc 121] Record stop has been detected in domain B. |
Using the message_code, you can either do a quick search using the magnifying glass at the top of the browser, or you can scroll through the Table of Contents.
To do a quick search, click on the magnifying glass, enter the error message number, and press Return as shown in the following example.
Screen capture of the SMS help browser displaying information for DSMD error 2517.
4. To scroll the Table of Contents, left-click on the message folder containing your error message, in this case DSMD Error Messages, 2500 through 2599, then left- click on error 2517 as shown in the following example.
Screen capture of the SMS help browser, showing selection of DSMD error message 2517.
This section describes the six types of errors reflected in the error messages in smshelp (TABLE B-1).
The following table shows the different error categories in SMS. Nonsequential numbering is due to error messages reserved for internal or service use.
Copyright © 2005, Sun Microsystems, Inc. All Rights Reserved.