Unified Platform Alarm Forwarding via Mail

Configuration Examples

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Document version: 5W100-20250606

Product Version: E7101

 

 

Contents

Introduction· 1

Prerequisites· 1

Configuration examples· 1

Network configuration· 1

Analysis· 1

Software versions used· 2

Procedures· 2

Configuring the DNS server 2

Configuring the mail server information· 2

Adding an alarm forwarding rule· 4

FAQ: Mail server configuration example· 6

Verifying the configuration· 10

 

Introduction

The system allows you to forward alarm messages to the specified email addresses, which helps you to learn the service and device messages through mails during the routine network and service management process.

Prerequisites

·     Only a user with the administrator permissions can configure the mail server and alarm forwarding rules.

·     Make sure the mail server has been set up successfully and can access the mail sending ports, such as POP and SMTP.

·     Make sure the mail client can send and receive mails normally through the mail server.

Configuration examples

Network configuration

Service personnel at Company A frequently travel for work, causing system alarms to go unresolved in time. To address this issue, Company A requested sending alarm emails to the mailboxes of service personnel. Service personnel receive immediate alerts whenever the system triggers an alarm, enabling prompt action from any location.

Figure 1 Schematic diagram of alarm forwarding via email

 

Analysis

1)     Adding a mail account on the mail server.

2)     Configuring the mail server information.

3)     Configuring alarm forwarding rules.

4)     Verifying the configuration.

Software versions used

This configuration example was created and verified on Unified Platform E71xx.

Procedures

Configuring the DNS server

1.     Log in to Matrix at https://Matrix_ip_address:8443/matrix/ui.

2.     Navigate to the Deploy > Clusters page.

3.     Click the Cluster Parameters tab, as shown in the following figure.

Figure 2 Cluster parameters

 

4.     To edit cluster parameters, click Modify.

5.     Select External DNS Server, and click Add DNS Server. In the Add DNS Server dialog box that opens, enter a DNS server IP address and a port number (53 by default), as shown in the following figure.

Figure 3 Adding a DNS server

 

6.     Click Apply to configure the DNS server.

Configuring the mail server information

To send mail notifications, you must first configure the mail server correctly.

1.     Log in to Unified Platform. On the top navigation bar, click System. From the navigation pane, select System Settings > Remote Notifications > Notification Settings.

2.     On the Notification Settings page, click the Mail Server Settings tab. Then, click Modify, and configure the following parameters:

¡     Server Address: Enter the domain name or IP address of the mail server.

¡     Server Port: Enter the port number of the mail server. The default is 25.

¡     Secure Connection (SSL/TLS): Select None to specify that secure connections are not used when the mail server is connected.

¡     Client Authentication: Specify the same client authentication state as that on the server. If client authentication is enabled on the mail server, you must also enable client authentication for the mail server in the system, and enter the sender's username and password. Otherwise, you do not need to select client authentication. Typically, the server does not need client authentication.

¡     Sender’s Email Address: Enter the mail address of the sender.

Figure 4 Mail server settings

 

3.     Click Send Test Mail to identify whether the mail server is reachable and whether the specified username and password are  correct, as shown in the following figure.

NOTE: If the mail server cannot be accessed, the system continuously tries to connect to the mail server for a long time when you send a test mail. Then, the system prompts that it failed to send the test mail.

 

Figure 5 Sent the test mail successfully

 

4.     Click OK to complete configuring the mail server.

Adding an alarm forwarding rule

1.     On the top navigation bar, click Alarm. From the navigation pane, select Alarm Config > Alarm Forwarding Rules to access the alarm forwarding rule page.

2.     Click Add to enter the page for adding an alarm forwarding rule, as shown in the following figure.

Figure 6 Basic info and alarm settings

 

3.     Configure the following parameters:

¡     Rule Name: Assign a name to the mail alarm forwarding rule.

¡     Forward Type: Select a forward type. If you select Forward Matching Alarms, alarms that match the forwarding rule are forwarded. If you select Forward Unmatching Alarms, alarms that do not match the forwarding rule are forwarded.

¡     Enable Duration-Triggered Notifications: Select whether to enable the Duration-Triggered Notifications feature. If you enable this feature, alarms that exist for the specified duration are forwarded.

¡     Alarm Severity Levels to be Concerned: Select one or multiple alarm severity levels to be concerned. Use the default settings in this example.

¡     Resources to be Concerned:

-     If you select the All Resources option, alarms generated by all resources are forwarded.

-     If you select the Selected Resources option, only alarms generated by the selected resources are forwarded. The following methods are available:

Select resources that have been added to the system.

Select resource groups. Selecting a resource group selects all resources in the group.

¡     Alarms to be Concerned:

-     If you select the All Alarms option, all alarms are forwarded.

-     If you select the Selected Alarms option, click Select. In the dialog box that opens, select alarms. Only the selected alarms are forwarded.

Figure 7 Configuring forwarding via email

 

4.     In the Action Settings area, click Email Forwarding. The Mail Forward window opens. Configure the following parameters:

¡     Alarm Time: Select the All or Absolute Time Span option.

-     Absolute Time Span: The system will forward only alarms generated within the selected time span. For example, if you set the time span to 00:00-23:59 for a day, all alarms generated on this day are forwarded. Use the default settings in this example.

¡     Alarm Duration: Set the alarm duration in minutes. The minimum value is 2. This parameter is required if you enable the Duration-Triggered Notifications feature. In this example, set the duration to 2 minutes.

¡     Mail Address: Specify the mail addresses for receiving alarm mails. You can specify one or multiple mail addresses, but you cannot add duplicate mail addresses. The mail address format is login_username@host_name.domain_name.

5.     Click OK to complete adding the alarm forwarding rule.

Figure 8 Added successfully

 

	CAUTION: If an alarm matches multiple alarm forwarding rules, the alarm is forwarded by each matching rule. If the alarm forwarding rules matching an alarm contain the same mail address, cellphone number, or message template, the alarm information is sent for only once.

 

FAQ: Mail server configuration example

The mail server configuration in this example is only for reference.

1.     Confirm the mail account information added on the mail server. Typically, basic account settings include username, password, mail address, and enabling the account, as shown in the following figure. The extended account settings vary by mail server.

Figure 9 Confirming mail account information

 

2.     Verify that related ports have been enabled on the mail server, as shown in the following figures.

Figure 10 Confirming the port connection-My computer

 

Figure 11 Confirming the port connection-Internet

 

3.     Verify that SSL/TLS settings are not enabled on the mail server, because Unified Platform does not support SSL or TLS in the current software version. Typically, SSL/TLS is configured in advanced settings or in a separate configuration item. To enable SSL/TLS, you must first import the corresponding certificate.

Verifying that no SSL certificate is imported, as shown in the following figure.

Figure 12 Verifying that no SSL certificates

 

When multiple SSL certificates have been imported, you must cancel the certificates used as follows: cancel remote server SSL/TLS certificate verification, unselect multiple protocols, and unselect SSL usage for ports.

Figure 13 Clearing options in the red box if certificates exist

 

Figure 14 Verifying that each port does not use SSL(1)

 

Figure 15 Verifying that each port does not use SSL(2)

 

Figure 16 Verifying that each port does not use SSL(3)

 

Verifying the configuration

Viewing the mail box

After the configuration is completed, the recipient's mailbox will receive alarm messages matching the alarm conditions pushed by Unified Platform, as shown in the following figure. After receiving the pushed alarm messages, you can log in to the platform to process the alarms.

Figure 17 Received an alarm mail

 

Processing alarms

The platform displays the received alarm messages in a bar chart and on a list. The active alarm list displays all uncleared alarms and alarms cleared today. By default, the list displays alarms in the Active state.

1.     Log in to Unified Platform. On the top navigation bar, click Alarm. From the navigation pane, select Active Alarms to access the active alarms page.

2.     Find the alarm in the mail.

¡     If an alarm can be ignored or the failure represented by the alarm has been resolved, you can clear the alarm to change the alarm state from Active to Recovered.

¡     Acknowledge an alarm to record whether the alarm has been processed by the system or operator.

Figure 18 Viewing alarms

 

3.     To view all alarms generated by an alarm source, click the link in the Alarm Source column for an alarm to enter the resource details page. Select All for the Status field to view all alarms generated by the specified alarm source on the list. On this page, you can acknowledge and clear alarms.

Figure 19 Viewing all alarms generated by an alarm source

 

4.     To view details of an alarm, click the link in the Alarm Info column for the alarm to enter the alarm details page. On this page, you can view the name, severity, alarming time, alarm cause, alarm OID, and alarm parameters of the alarm.

Figure 20 Viewing alarm details