Notification Settings

You can configure RealServer to send e-mail messages that alert you to important RealServer events. You can specify the following aspects of e-mail operation:

Configuring Basic E-mail Operation

The following configuration settings control RealServer notification:

Setting

Description

MailMessageLevel Minimum severity level for e-mail messages sent by RealServer
MailMessageLimit Maximum number of e-mail messages to sends about a particular event.
MailMessageSMTPHost The mail server that RealServer uses to send e-mail messages.
MailMessageUser E-mail address of the primary contact for RealServer e-mail messages.
MailUsageCC E-mail address of the secondary contact for RealServer e-mail messages

MailMessageLevel

Specifies the severity of messages that are e-mailed to the system administrator. Specifying a level prevents RealServer from sending messages with a lower severity. The default value, which is no value, prevents RealServer from sending e-mail messages.
Default value (none)
Range of values INFO, WARNING, ERROR

Syntax

MailMessageLevel <level>

Example

MailMessageLevel WARNING

Sends e-mail about WARNING and ERROR messages, but not INFORMATION messages.

 

MailMessageLimit

The number of times that RealServer sends a specific e-mail message. Limits the number of times RealServer notifies the system administrator of the same problem. You can disable RealServer e-mail messaging by setting MailMessageLimit to 0.
Default value 5
Range of values Integers greater than or equal to 0

Syntax

MailMessageLimit <number>

Example

MailMessageLimit 3

MailMessageSMTPHost

The e-mail server that RealServer uses to send e-mail messages.
Default value (none)
Range of values Valid Domain Name System (DNS) name or IP address

Syntax

MailMessageSMTPHost <address>

Example

MailMessageSMTPHost mail.mycorp.com

MailMessageUser

The e-mail address of the primary contact, or system administrator, to which the e-mail messages will be sent. You can use a group email ID to broadcast the message to several addresses.
Default value (none)
Range of values Valid e-mail address

Syntax

MailMessageUser <address>

Example

MailMessageUser sysadmin@mycorp.com

MailUsageCC

The secondary e-mail address to receive e-mail from RealServer.
Default value sales@real.com
Range of values Valid e-mail address

Syntax

MailUsageCC <address>

Example

MailUsageCC support@corp.com


Configuring Threshold E-mail

RealServer can send notification messages when a percentage of RealServer's bandwidth or connection limits is exceeded. These two thresholds are set with MaxBandwidth setting (see page 86) and ClientConnections setting (see page 85).

Setting

Description

MailUsagePeriod Specifies the time period over which MailUsageThreshold is calculated.
MailUsageThreshold Specifies the server usage level that causes RealServer to send a usage e-mail message.

The notification e-mail lists the number of licensed streams, the threshold exceeded, and the time for which the threshold was exceeded. A sample email message that is sent when bandwidth threshold is exceeded:

In last 89 hours, server usage exceeded 92% for a total of 5342 seconds
Licensed Streams: 812
>--- BANDWIDTH THRESHOLD exceeded ---<
Maximum Bandwidth: 413
Bandwidth Used: 398
Maximum Audio Connections: 750
Number of Connections Used: 732

 

MailUsagePeriod

Specifies the time period over which MailUsageThreshold is calculated. At the end of each MailUsagePeriod, the server resets the statistics used to calculate MailUsageThreshold. RealServer resets the MailUsageThreshold statistics every week.
Default value 24
Range of values Positive Integers

Syntax

MailUsagePeriod <hours>

Example

MailUsagePeriod 168

MailUsageThreshold

Percentage of maximum bandwidth (if specified) or total license streams that will generate a usage threshold e-mail.

If MaxBandwidth is set to a value, MailUsageThreshold is a percentage of the MaxBandwidth value.

If no maximum bandwidth is specified, MailUsageThreshold is a percentage of the ClientConnections value.

If ClientConnections is not set, MailUsageThreshold is a percentage of RealServer's licensed streams.
Default value 80
Range of values 1 to 100

Syntax

MailUsageThreshold <percent>

Example

MailUsageThreshold 85

© 1997 RealNetworks, Inc.