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:
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 |
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 |
MailMessageLevel <level>
MailMessageLevel WARNING
Sends e-mail about WARNING and ERROR messages, but not INFORMATION messages.
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 |
MailMessageLimit <number>
MailMessageLimit 3
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 |
MailMessageSMTPHost <address>
MailMessageSMTPHost mail.mycorp.com
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 |
MailMessageUser <address>
MailMessageUser sysadmin@mycorp.com
The secondary e-mail address to receive e-mail from RealServer.
Default value | sales@real.com |
Range of values | Valid e-mail address |
MailUsageCC <address>
MailUsageCC support@corp.com
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
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 |
MailUsagePeriod <hours>
MailUsagePeriod 168
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 |
MailUsageThreshold <percent>
MailUsageThreshold 85