XSCF Mail Function

C H A P T E R 6

XSCF Mail Function

This chapter describes the XSCF mail function.

6.1 Overview of XSCF Mail Function

The mail report function, used by XSCF firmware to send messages to the administrator, has the following features:

Notification by email of faults in system components monitored by the XSCF

Even if a system failure or a serious error that disables reboot occurs, an email message is guaranteed to be sent.

POP authentication facility and SMTP authentication at email sendings are possible

To prevent illegal Mail Sending, POP Authentication (POP before SMTP) or SMTP Authentication (SMTP-AUTH) can be done before mail sending is accepted with a SMTP server.

FIGURE 6-1 outlines the XSCF mail function.

FIGURE 6-1 XSCF Mail Function

Figure showing the XSCF mail function.

XSCF Email Notification Path

The email notification path is described below. The setting for notification is made with the XSCF Shell.

Sending an email message through the SMTP server

The host name or IP address of the SMTP server must be set.

Sending an email with POP authentication or SMTP authentication

It is necessary to specify whether to do the authentication. And the POP authentication or the SMTP authentication must be selected. Then, ID and password for the authentication is required.

Parts Fault Notification

XSCF monitors components (such as CPU modules, fan units, CPU/Memory Board unit) in the server. XSCF can notify the system administrator by email of any fault that occurs in these devices.

FIGURE 6-2 shows mail being sent for parts fault notification to the system administrator.

FIGURE 6-2 XSCF Fault Notification

Figure showing the XSCF fault notification.

6.2 Setting Up the Mail Function

This section explains how to set up the XSCF mail function.

The workflow is as described below. Perform each step for setup with the XSCF Shell command line. For details on setup, see Chapter 2.

1. Log in to XSCF.

2. Make the following settings for the XSCF mail function:

Host name or IP address of the SMTP server--(See setsmtp(8))

Select POP authentication or SMTP authentication--(See setsmtp(8))

Reply address (from specification)--(See setsmtp(8))

Recipient address for mail for the system administrator--(See setemailreport(8))

3. Enable the XSCF mail function. (See setemailreport(8))

4. Send test mail.

Test mail is automatically sent when the work for these mail settings is completed. If the email message sent as test mail is confirmed to have been received by the system administrator, it means that the correct settings have been made. If the email massage is not received, error mail is sent to the reply mail address (From:) or a record is made in an error log. In this event, identify the cause of the error, correct it, and start from step 1 again.

Once the test is completed normally, the mail report function is enabled. Use the showemailreport(8) command to check whether the test is completed.

For details on making settings for the SMTP server and name server, see Chapter 2.

6.3 Contents of Parts Fault Notification

This section explains the contents of the email messages sent for parts faults that occur.

FIGURE 6-3 shows the contents of mail sent for a parts fault that occurred.

FIGURE 6-3 Mail Sent for an XSCF Parts Fault That Occurred

Figure showing the mail sent for an XSCF parts fault that occurs.

1. Reply address set with Mail Administration

2. Recipient address set with Mail Administration

3. Mail title

Note - The contents may be changed as a result of a function improvement without notice. For details on the settings, see Chapter 2.

The following items are displayed in the mail example of FIGURE 6-3 (No.1 to 3 in the figure are excluded):

MSG-ID: Message ID. Use the message ID for accessing the specified URL to acquire detailed information on this problem. For the specified URL, see the Web site information about messages described in the Product Notes for your server. For the message ID, the following information can be confirmed at the Web site:

Message type (Type)

Fault level (Severity)

Outline of fault (Description)

Machine operation after failure (Automated Response)

Influence (Impact)

Action to be taken (Action)

Detailed information (Details)

TYPE, SEVERITY, DESC, AUTO-RESPONSE, IMPACT, and REQ-ACTION, these are the same items that the web site information in MSG-ID corresponds.

VER: Version

EVENT-TIME: Time of fault occurrence (indicated in local time)

FLATFORM: Target architecture

CSN: Chassis serial number

DOMAIN-ID: Domain ID

SERVER-ID: ID of this system

EVENT-ID: Number used to uniquely identify the problem in an arbitrary system set

DIAGCODE: Field engineers and authorized service personnel use this code for troubleshooting. The user is requested to inform the field engineer and authorized service personnel of this code, which is useful in resolving problems at an early stage.

Msg: Message to show summary of problem

6.4 Test Mail

After XSCF mail function settings are made, a test mail can be sent to verify the settings. The send time of the test mail (the local time is displayed) and the information about the mail sender are displayed. Also, the "Test Mail:" characters are included in the subject of the test mail.