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 been 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 in the System Management Services (SMS) 1.4.1 Administrator Guide if applicable, and recovery action to take or suggested steps for further analysis.

This chapter includes the following sections:

• Installing smshelp

• Types of Errors

• Error Categories

This section explains how to manually install the SUNWSMSjh package using the standard installation utility, pkgadd.

1. Log in to the SC as superuser.

2. Load the SUNWSMSjh package on the server:

# pkgadd -d . SUNWSMSjh 

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 may 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.

4. Remove the Sun Computer Systems Supplements CD from the CD-ROM drive, if applicable:

# cd /

# eject cdrom

5. Log out as superuser.

1. Log in to the SC as a user with platform or domain group privileges.

2. In any terminal window, type:

 sc0:sms-user:> smshelp &

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.

3. Choose an error message.

Error messages are recorded in the platform and domain logs.

The message format follows the syslog(3) convention: (relevant parts of the message are in bold)

timestamp  host process_name  [pid]: [message_code 

hight_res_timestamp level source_code_file_name  

source_code_line_num] message_text

For example:

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 and enter the error message number and press Return as shown in the follow example.

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.

This section describes the six types of errors reflected in the error messages in smshelp.

The following table shows the different error categories in SMS. Nonsequential numbering is due to error messages reserved for internal or service use.

System Management Services (SMS) 1.4.1 Administrator Guide

817-5410-10

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.