You are on page 1of 19

E-mail Alarm Forwarding v. 3.1.

1
Interface Description

DN70136073 Issue 3-1-1 en

© Nokia Siemens Networks

1 (19)

BUSINESS INTERRUPTION. IN NO EVENT WILL NOKIA SIEMENS NETWORKS BE LIABLE FOR ERRORS IN THIS DOCUMENTATION OR FOR ANY DAMAGES. Nokia Siemens Networks will correct errors in this documentation as soon as possible. REVENUE.Table of Contents The information in this document is subject to change without notice and describes only the product defined in the introduction of this documentation. DIRECT. However. Other product names mentioned in this document may be trademarks of their respective owners. DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 2 (19) . All rights reserved. or performance of the mentioned hardware or software products are given “as is” and all liability arising in connection with such hardware or software products shall be defined conclusively and finally in a separate agreement between Nokia Siemens Networks and the customer. The documentation has been prepared to be used by professional and properly trained personnel. INDIRECT. reproduced. SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT. The wave logo is a trademark of Nokia Siemens Networks Oy. INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES. This documentation and the product it describes are considered protected by copyrights and other intellectual property rights according to the applicable laws. This documentation is intended for the use of Nokia Siemens Networks customers only for the purposes of the agreement under which the document is submitted. The information or statements given in this documentation concerning the suitability. BUSINESS OPPORTUNITY OR DATA. Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. and no part of it may be used. INCLUDING BUT NOT LIMITED TO SPECIAL.THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT. and they are mentioned for identification purposes only. Nokia is a registered trademark of Nokia Corporation. and the customer assumes full responsibility when using it. explain issues which may not be covered by the document. Siemens is a registered trademark of Siemens AG. modified or transmitted in any form or means without the prior written permission of Nokia Siemens Networks. Nokia Siemens Networks welcomes customer comments as part of the process of continuous development and improvement of the documentation. if deemed necessary by Nokia Siemens Networks. Nokia Siemens Networks will. Copyright © Nokia Siemens Networks 2012. capacity.

...................................... 7 Information model ............................. 10 Alarm description ..................................................................................................... 8 Description of the interface ......... 15 E-mail format ...................................................................................... 10 Alarm attributes ..............................................2 2............... 15 Semantics.................................1 4.............................. 16 Example(s) ...... 4 Overview ..............................................................3 3 3.......1 4.........................................................................................................5 5 About this document ...... 19 DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 3 (19) ..........3 4......................................................................................... 14 User comments .............. 10 Syntax of the interface ...............................................2 4. 5 Context of the interface..............Table of Contents 1 2 2..............2................................................................................2 4..............................1 4 4.....................................................................................4 4................2.. 16 Where to find more information................................ 8 Interface concepts .................................................................................................1 2..................................... 15 Configuring NetAct for using the interface.......................................................2.............. 5 Introduction...........................................................................3 4....................... 5 Features ...................................................................

DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 4 (19) . This document describes the alarm format for e-mail and also provides references for creating e-mail forwarding rules using the Rule Editor User interface. Configuring external e-mail forwarding clients and servers is outside the scope of this document.About this document 1 About this document The E-mail Alarm Forwarding Interface is designed to send e-mails for multiple e-mail recipients using external e-mail sender programs.

NetAct sends each alarm notification in a separate mail. This interface does not address the configuration of external mail servers.1 Introduction Alarm formats for e-mail described in Section Semantics are used for sending alarms from NetAct. This document is intended for • • • NetAct architects NetAct designers Developers and testers.Overview 2 Overview This chapter provides an overview of the alarm format in e-mails. The e-mail alarm format specified in this interface is the same to all the recipients. This interface sends e-mails directly using an external mail server configured via the preferences. You must be familiar with NetAct FM.2 Context of the interface The E-mail Alarm Forwarding Interface is part of NetAct. 2. The alarm forwarding system in NetAct forwards alarms to e-mail accounts using a specific e-mail format. This interface does not specify how NetAct fetches event information and does not describe the format of e-mail rules. the Open Fault Standard Interface (OFaS) and the NetAct alarm structure. 2. DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 5 (19) . NetAct uses this interface to notify operators through e-mail by sending the alarm details to their e-mail address.

Overview NetAct-based System FM Platform Email Mediation E-mail Alarm Forwarding interface external email server e-mails Figure 1. Context of the E-mail Alarm Forwarding Interface DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 6 (19) .

Technology ASCII Feature send alarm to email recipients include alarm description in email ASCII include user comments in e-mail ASCII DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 7 (19) . When forwarding an alarm to the e-mail system. NetAct also sends an alarm description in the e-mail. Table 1: E-mail Alarm Forwarding features Description NetAct sends fault management events to e-mail recipients using the format specified in the interface. NetAct also sends user comments associated with the alarm. When forwarding an alarm to the e-mail system.Overview 2.3 Features The following table lists the E-mail Alarm Forwarding features.

Textual description of the fault Time the event was generated Notification id of the fault Time the event was acknowledged The acknowledge user Time the event was cancelled The cancel user Additional information on the fault DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 8 (19) . see Open Fault Standard (OfaS) Interface Description. 3. For more information on the OFaS attributes.Information model 3 Information model This chapter describes the information model of the interface. Table 2. Alarm attributes Source Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm Alarm Supported in the current version Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Attribute name specificProblem perceivedSeverity maintenanceRegion siteName siteAddress distinguishedName alarmText eventTime notificationId ackTime ackedBy cancelTime cancelledBy additionalText1 Description Qualification of the fault Severity of the alarm Name of the maintenance region Name of the site Address information of the site Distinguished name of the alarming object.1 Interface concepts Table Alarm attributes lists the attribute names used in this interface.

Information model Attribute name additionalText2 additionalText3 additionalText4 eventType additionalText5 additionalText6 additionalText7 Description Additional information on the fault Further additional information on the fault Further additional information on the fault Type of the event Additional information on the fault Additional information on the fault Further additional information on the fault Source Alarm Alarm Alarm Alarm Alarm Alarm Alarm Supported in the current version Yes Yes Yes Yes Yes Yes Yes DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 9 (19) .

1 Syntax of the interface The interface contains three parts: • • • Alarm attributes Alarm description User comments The following sub-sections define the syntax of each part of the interface.Description of the interface 4 Description of the interface This section describes the individual components of the e-mail format. DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 10 (19) . 4. 4. Active alarm The figure 1 describes the representation of various alarm attributes in the email for an active alarm.2 Alarm attributes This section describes the format of the alarm information for different types of alarms.

The distinguishing fields for this alarm are ‘CANCELLED’ and ‘CANCELLED By’ which is the cancel time and cancel user information for a cancelled alarm. Cleared alarm The figure 3 describes the representation of various alarm attributes in the email for a cleared alarm. The distinguishing fields for this alarm are ‘ACKED’ and ‘ACKED By’ which are the ack time and ack user information for an acked alarm respectively.Description of the interface Acknowledged alarm The figure 2 describes the representation of various alarm attributes in the email for an acknowledged alarm. 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 Data “\n” Column Number Line 1 Line 2 Line 3 Line 4 Line 5 Line 6 Line 7 Line 8 Line 9 Line 10 Line 11 Line 12 Line 13 Line 14 = A S M S S D S N E A A A A = L E A I I I T O V L D D D = A V I T T S A T E A D D D = R E N E E T R I N R I I I = M R T = = N = U Y A M D U N E R I M = B = E = R = = = = = = = = = = : : “\n” “\n” “\n” “\n” “\n” “\n” “\n” “\n” “\n” “\n” “\n” “\n” “\n” “\n” I E N A T N A D G D C T T C E R E G I O N : : E S S H S E D N A M E : : : I T F T M T T T N E I A Y E N N N T P X A A A I E T L L L O N I D : : : I I I O O O T T T E E E X X X T T T 1 2 3 : : : DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 11 (19) .

Alarm format for an active alarm 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 Data “\n” Column Number Line 1 Line 2 Line 3 Line 4 Line 5 Line 6 Line 7 = A S M S S D = L E A I I I = A V I T T S = R E N E E T = M R T = = N = U Y A M D U = M = B = E = R = = = = = = = = = = : : “\n” “\n” “\n” “\n” “\n” “\n” “\n” I E N A T N A D G N E R I C E R E G I O N : : E S S H S E D N A M E : : I N DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 12 (19) .Description of the interface A A A A “\n” M D D D D D D D D I I I I T T T T I I I I O O O O N N N N A A A A L L L L T T T T E E E E X X X X T T T T 4 5 6 7 : : : : “\n” “\n” “\n” “\n” Line 15 Line 16 Line 17 Line 18 Line 19 << Intentionally Left Blank>> A N P A G E : << Manual Multi Line D A T A M A X O F 5 0 0 C H A R S “\n” U << Intentionally Left Blank>> S E R C O M M E N T S : << User Multi Line C O M M E N T S D A T A M A X O F 5 0 0 CHARS = = = = = = = = = = = = = = = = = = = = = = Figure 1.

Alarm format for a cancelled alarm 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 Data “\n” Column Number Line 1 Line 2 Line 3 Line 4 Line 5 = A S M S = L E A I = A V I T = R E N E = M R T = = N = U Y A M = M = B = E = R = = = = = = = = = = : : “\n” “\n” “\n” “\n” “\n” I E N T N A N E C E R E G I O N : : DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 13 (19) .Description of the interface S N A A E A “\n” M T O C C V L A T K K E A R I E E N R T F D D T M E I D C A T I O N I D : : : “\n” “\n” “\n” “\n” “\n” “\n” Line 8 Line 9 Line 10 Line 11 Line 12 Line 13 Line 14 B T T Y Y E P X E T : : : << Intentionally Left Blank>> A N P A G E : << Manual Multi Line D A T A M A X O F 5 0 0 C H A R S “\n” U << Intentionally Left Blank>> S E R C O M M E N T S : << User Multi Line C O M M E N T S D A T A M A X O F 5 0 0 CHARS = = = = = = = = = = = = = = = = = = = = = = = = = Figure 3.

1 Alarm description NetAct retrieves the alarm description (man-page) for an alarm as described in FM Basic O&M Metamodel Interface Description. The following is the format for the alarm description. Alarm description in the e-mail is an optional component and an option to select the alarm description is provided in Rule Editor DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 14 (19) .Description of the interface S D S N C C E A “\n” M I I T O A A V L T S A T N N E A E T R I C C N R I T F E E T M A N E I L L D G D C L L T T D U R I E S S H S E D N A M E : : : “\n” “\n” “\n” “\n” “\n” “\n’ “\n” “\n” Line 6 Line 7 Line 8 Line 9 Line 10 Line 11 Line 12 Line 13 Line 14 A E E Y E T D D P X I O N I D : : B E T Y : : : << Intentionally Left Blank>> A N P A G E : << Manual Multi Line D A T A M A X O F 5 0 0 C H A R S “\n” U << Intentionally Left Blank>> S E R C O M M E N T S : << User Multi Line C O M M E N T S D A T A M A X O F 5 0 0 CHARS = = = = = = = = = = = = = = = = = = = = = = = = = 4.2.

see Chapter Alarm attributes> ALARM DESCRIPTION FOR THIS ALARM: <alarm Description. see Chapter User comments> 4. Rule matching: Upon receiving an alarm which matches the e-mailforwarding rule.3 Semantics The installation of NetAct configures the email-sending related commands and information in the preferences. Create rules using Rule Editor. see Chapter Alarm description> USER COMMENTS FOR THIS ALARM DESCRIPTION: <user comments. text indicating the same will be present. The option to select user comments is provided in Rule Editor. 4.2 User comments The user comments component in the e-mail is optional.2.Description of the interface 4. NetAct fetches all required information for creating the e-mail.3 E-mail format This section describes the format for the e-mail. DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 15 (19) . In case user comments are not available for the alarm. There are two steps of e-mail-sending: 1.2. ALARM ATTRIBUTES: <alarm format.

0"> <root type="system"> <map /> <node name="fmcore"> <map /> <!-. Sending to e-mail accounts by forwarding to an external mail server: external mail server details configured in preference data will be used for sending e-mails to specified recipients. When From Address is ‘Admin@titans.com" /> <!-.E.5 Example(s) MAIL FOR AN ACTIVE ALARM: ============================================================ ALARM_NUMBER : 2815 SEVERITY : CRITICAL Maintenance Region : MRName Site Name : SiteName Site Address : H1 DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 16 (19) .xml file.g. username = Admin and domainName = titans.Description of the interface 2.The configuration related to alarm forwarding to email feature--> <node name="emailClient"> <map> <!-. <preferences EXTERNAL_XML_VERSION="1.com --> </map> </node> </node> </map> </root> </preferences> 4.4 Configuring NetAct for using the interface You can configure the mail server you want to use in NetAct in preferences.com’.Domain name of From Account --> <entry key="domainName" value="titans.Name of the Mail Server --> <entry key="mailServerName" value="localhost" /> <!-. 4. The preferences to be configured for external mail server are explained below and are present in Pref_system_fmcore.User name of From Account --> <entry key="userName" value="Admin" /> <!-.

No Supp. The system cancels the alarm automatically when the alarm uploading has been finished. The alarm requires no actionsDo not cancel the alarm. To assure the correct alarm situation in the RNC. No Supp. To assure the correct alarm situation in the RNC.The alarm requires no actionsDo not cancel the alarm. the system is uploading active alarms from every BTS in the network. To assure the correct alarm situation in the RNC. User Comments : No User Comments For This Alarm Number----------============================================================ MAIL FOR CANCELLED ALARM: ============================================================ ALARM_NUMBER : 2815 SEVERITY : ALARM_CLEARED Maintenance Region : MRName Site Name : SiteName Site Address : H1 Distinguished Name : PLMN-PLMN/BSC-1 Started : 2008-10-10 17:50:56 Notification Id : 4 Cancelled : 2008-10-10 17:52:44 Cancelled by : omc Event Type : PROCESSING Alarm Text : Alarm Text Man Page : RNW ALARM UPLOAD ONGOING18A disturbance has occurred in the radio network alarm system.Description of the interface Distinguished Name Started Notification Id Event Type Alarm Text : : : : : PLMN-PLMN/BSC-1 2008-10-10 17:50:56 4 PROCESSING Alarm Text Man Page : RNW ALARM UPLOAD ONGOING18A disturbance has occurred in the radio network alarm system. the system is uploading active alarms from every BTS in the network.The alarm requires no actionsDo not cancel the alarm. The system cancels the alarm automatically when the alarm uploading has been finished. User Comments : No User Comments For This Alarm Number ============================================================ MAIL FOR ACKNOWLEDGED ALARM: ============================================================ ALARM_NUMBER : 2815 SEVERITY : ALARM_ACKED Maintenance Region : MRName Site Name : SiteName Site Address : H1 Distinguished Name : PLMN-PLMN/BSC-1 Started : 2008-10-10 17:50:56 Notification Id : 4 Acked : 2008-10-10 17:51:43 Acked By : omc Event Type : PROCESSING Alarm Text : Alarm Text Man Page : RNW ALARM UPLOAD ONGOING18A disturbance has occurred in the radio network alarm system. the system is ploading active alarms from every BTS in the network. The system cancels the alarm automatically when the alarm uploading has been finished. DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 17 (19) . No Supp.

Description of the interface User Comments : No User Comments For This Alarm Number ============================================================ DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 18 (19) .

Where to find more information 5 Where to find more information See the following documentation for more information: • • • FM Basic: O&M Metamodel Interface Description Rule Editor help Open Fault Standard (OFaS) Interface Description DN70136073 Issue 3-1-1 en © Nokia Siemens Networks 19 (19) .