Configuring Email Alerts

This chapter provides information about performing general administration tasks. It contains the following sections:

• About Email Alerts
• Creating an Email Alert
• Changing Email Alert Events for a Recipient
• Deleting an Email Alert

About Email Alerts

Email alerts are available only to servers that have the SUNWsamfsr and SUNWsamfsu packages installed locally.

The Email Alerts system informs a user of certain events or conditions by generating a message and sending it to the user's email address.

You can configure the File System Manager software to automatically send email notifications to recipients when certain events occur. When you create a notification, you must provide an email address for the intended recipient of the notification. Every event that triggers a notification, except for the file system overflow event, applies to archiving file systems.

The 'root' user is the default subscriber for all email alerts.

If the error condition persists, a repeat email is sent every two hours. This prevents flooding the recipient's mailbox with emails sent repeatedly for the same error condition.

You can set up the system so that one or more of the events described in the following table triggers a notification.

TABLE 9-1 Events

Event	Description
Library or Drive is Down	One or more devices are unusable by the file system.
Archiving is Interrupted	The software is unable to complete archiving operations. An email message is sent if the archiver is interrupted for any of the following reasons: No volumes that are associated with the policy are available. A file being archived is too large for volume overflow on the remaining volumes that are associated with the policy. A file being archived is too large for any remaining volume that is associated with the policy. Joined files being archived are too large for any remaining volume that is associated with the policy.
Requested Volume is Unavailable	Media devices need to be imported or manually loaded to support archiving or staging.
Recycling is Complete	The recycler has identified one or more tape volumes that contain large proportions of expired archive copies. The recycler has finished removing the expired copies from the volumes. You can now either export or relabel the tape volume.
Recovery Points Error Recovery Points Warning	The creation of a recovery point for a file system was interrupted. An email message is sent if the recovery point fails or if the software attempts to run a disaster recovery script before creating the recovery point and the software encounters any of the following conditions: It cannot find the specified script. The script does not contain any content. The script does not have root executable permissions. The file system for which a recovery point is scheduled is not mounted. The recovery point file itself does not contain any content. The recovery point file size is truncated. This occurs when the percentage of content change in the current recovery point is less than 10 percent, when compared against the three previous recovery points. The compression or indexing of the recovery point file fails.
No Space Available on File System	The file system is full. There is no space available for storage use.
File System Exceeds its High Water Mark	The software has detected that the space consumed by the file system exceeds the high water mark setting.

Note: If you have the SUNWsamfsr and SUNWsamfsu packages installed locally on a server, and you wish to enable notifications through the browser interface, be aware that the software automatically defines the following value in the notify=filename directive of the archiver.cmd file:

/etc/opt/SUNWsamfs/scripts/archiver.sh

If you manually change this value, the browser interface cannot send archiver-related notifications.

Creating an Email Alert

To create an email alert:

1. From the Servers menu or the Servers page, choose the name of the server for which you want to create a notification.

2. From the navigation tree, choose Email Alerts under System Administration

The Email Alert Summary page is displayed.

3. In the Subscribers field, type the email address of the recipient that you want notified.

4. Select the check boxes next to the events that you want to trigger notifications.

For information about these events, see About Email Alerts.

5. Click Submit.

Changing Email Alert Events for a Recipient

You can change the types of events that will send notifications to a specific recipient.

Note: If you want to change the recipient who receives the notifications, you must create a new notification and specify the new recipient's email address.

To change notification events for a recipient:

1. From the Servers menu or the Servers page, choose the name of the server on which you want to change notification events.

2. From the navigation tree, choose Email Alerts under System Administration

The Email Alert Summary page is displayed.

3. Choose the recipient for whom you want to change events from the Subscribers menu.

4. Select or deselect the check boxes next to the events that you want to automatically trigger notifications to this recipient.

5. Click Submit.

Deleting an Email Alert

To delete an email alert:

1. From the Servers menu or the Servers page, choose the name of the server from which you want to delete a notification.

2. From the navigation tree, choose Email Alerts under System Administration.

The Email Alert Summary page is displayed.

3. Choose the recipient notification that you want to delete from the Subscribers menu.

4. Click Deselect All to deselect all of the notification events.

5. Click Submit.

A message box prompts you to confirm the deletion.

6. Click OK.