How-to guide: SNMP Trap Adapter



Similar documents
How-to guide: Monitoring of standalone Hosts. This guide explains how you can enable monitoring for standalone hosts in SAP Solution Manager

SAP BW on HANA & HANA Smart Data Access Setup

Open Items Analytics Dashboard System Configuration

LVS Troubleshooting Common issues and solutions

Set Up Hortonworks Hadoop with SQL Anywhere

Configuring Java IDoc Adapter (IDoc_AAE) in Process Integration. : SAP Labs India Pvt.Ltd

Extend the SAP FIORI app HCM Timesheet Approval

Sybase ASE Linux Installation Guide Installation and getting started guide for SAP Sybase ASE on Linux

SAP PartnerEdge Program: Opportunities for SAP-Authorized Resellers

SAP Landscape Transformation (SLT) Replication Server User Guide

Compare & Adjust How to Guide for Compare & Adjust in SAP Solution Manager Application Lifecycle Management

SAP Solution Manager - Content Transfer This document provides information on architectural and design questions, such as which SAP Solution Manager

BW Source System: Troubleshooting Guide

How to Extend a Fiori Application: Purchase Order Approval

SAP BusinessObjects Business Intelligence 4 Innovation and Implementation

Creating a Fiori Starter Application for sales order tracking

Agentry and SMP Metadata Performance Testing Guidelines for executing performance testing with Agentry and SAP Mobile Platform Metadata based

Memory Management simplifications in ABAP Kernel 7.4*

Installing and Configuring the HANA Cloud Connector for On-premise OData Access

Consumption of OData Services of Open Items Analytics Dashboard using SAP Predictive Analysis

Using SAP Crystal Reports with SAP Sybase SQL Anywhere

How to Implement a SAP HANA Database Procedure and consume it from an ABAP Program Step-by-Step Tutorial

Create and run apps on HANA Cloud in SAP Web IDE

Setting up Single Sign-On (SSO) with SAP HANA and SAP BusinessObjects XI 4.0

Using Database Performance Warehouse to Monitor Microsoft SQL Server Report Content

What's New in SAP BusinessObjects XI 3.1 Service Pack 5

Cloud Single Sign-On and On-Premise Identity Federation with SAP NetWeaver Cloud White Paper

SAP CRM Service Manager 3.1 Mobile App Extended Feature List An extended list of all the features included in the default delivery of the SAP CRM

SAP White Paper Enterprise Information Management

Five Strategies Small and Medium Enterprises Can Use to Successfully Implement High Value Business Mobility

Training.sap.com User Guide

Setting up Single Sign-On (SSO) with SAP HANA and SAP BusinessObjects XI 4.0

Implementing an Enterprise Information Management Strategy An Approach That Mitigates Risk and Drives Down Costs

Active Quality Management

Upgrade: SAP Mobile Platform Server for Windows SAP Mobile Platform 3.0 SP02

Migration Guide Remote Support Component 1.0 to SAP Solution Manager 7.1. Target Audience System Administrators Technology Consultants

SAP HANA Client Installation and Update Guide

Learning Series: SAP NetWeaver Process Orchestration, secure connectivity add-on 1c SFTP Adapter

SAP Work Manager 6.0 Mobile App Extended Feature List

Additional Guide to Implementing the SAP CRM Service Management rapiddeployment

SAP BusinessObjects Business Intelligence Suite Document Version: 4.1 Support Package Patch 3.x Update Guide

SAP Business ByDesign and SAP ERP. SAP Business ByDesign for Subsidiaries Overview of Functional and Technical Integration with Headquarters SAP ERP

Availability Monitoring using Http Ping

How to... Master Data Governance for Material: Use the Data Import Framework for Material. Applicable Releases: EhP6, MDG 6.1, MDG 7.

How To... Master Data Governance for Material: Maintenance for multiple Materials in one Change Request. Applicable Releases: all

LHI Leasing Simplifying and Automating the IT Landscape with SAP Software. SAP Customer Success Story Financial Services Provider LHI Leasing

Certification Guide Network Connectivity for SAP on Premise and Cloud Solutions Integration

SAP Operational Process Intelligence Security Guide

HP Data Protector Integration with Autonomy IDOL Server

Nine Reasons Why SAP Rapid Deployment Solutions Can Make Your Life Easier Get Where You Want to Be, One Step at a Time

SAP BusinessObjects Query as a Web Service Designer SAP BusinessObjects Business Intelligence platform 4.0

How to Configure an Example SAP Cloud Applications Studio (PDI) Solution for SAP Cloud for Customer

Setting up Visual Enterprise Integration (WM6)

SAP Sybase Adaptive Server Enterprise Shrinking a Database for Storage Optimization 2013

SAP Security Recommendations December Secure Software Development at SAP Embedding Security in the Product Innovation Lifecycle Version 1.

Integration of SAP Netweaver User Management with LDAP

Quick Guide to the SAP Customer Relationship Management Rapid- Deployment Solution (based on EhP1) Demo/Evaluation Appliance

Process Archiving using NetWeaver Business Process Management

SAP HANA Big Data Intelligence rapiddeployment

Storage Health and Event Monitoring

SAP BusinessObjects Dashboarding Strategy and Statement of Direction

Landscape Design and Integration. SAP Mobile Platform 3.0 SP02

How-to-Guide: SAP Web Dispatcher for Fiori Applications

Getting Started with the License Administration Workbench 2.0 (LAW 2.0)

SAP Business Intelligence Suite Patch 10.x Update Guide

SAP BusinessObjects Enterprise Software Inventory Tool User's Guide

SAP Project Portfolio Monitoring Rapid- Deployment Solution: Software Requirements

SAP PartnerEdge Program Guide for Language Services Partners

AC 10.0 Customizing Workflows for Access Management

How-To Guide SAP NetWeaver Document Version: How To Guide - Configure SSL in ABAP System

HP OpenView Internet Services. SNMP Integration with HP Operations Manager for Windows White Paper

SAP ERP E-Commerce and SAP CRM Web Channel Enablement versions available on the market

HR400 SAP ERP HCM Payroll Configuration

SAP Sourcing OnDemand Wave 8 Solution Guide

How to Configure Access Control for Exchange using PowerShell Cmdlets A Step-by-Step guide

SAP BusinessObjects Edge BI, Standard Package Preferred Business Intelligence Choice for Growing Companies

How to Implement Mash Up to Show ECC Screen in SAP Cloud for Customer

Integration Option for Microsoft SharePoint Software Getting Started Guide SAP BusinessObjects 4.0 Support Package 4

Fiori Frequently Asked Technical Questions

Software and Delivery Requirements

SAP Briefing Brochure. Solutions. October 2010

HP LeftHand SAN Solutions

Guide to the SAP Extended Business Program

How To... Master Data Governance for Material: Create Custom Print forms. Applicable Releases: MDG 7

SAP Business Intelligence Adoption V6.41: Software and Delivery Requirements. SAP Business Intelligence Adoption February 2015 English

Secure MobiLink Synchronization using Microsoft IIS and the MobiLink Redirector

Business Intelligence Platform Installation Guide for Windows

AC200. Basics of Customizing for Financial Accounting: General Ledger, Accounts Receivable, Accounts Payable COURSE OUTLINE

Single Sign-On between SAP Portal and SuccessFactors

SAP BUSINESS PLANNING AND CONSOLIDATION 10.0, VERSION FOR SAP NETWEAVER, POWERED BY SAP HANA STARTER KIT FOR USGAAP

TM111. ERP Integration for Order Management (Shipper Specific) COURSE OUTLINE. Course Version: 15 Course Duration: 2 Day(s)

CRM WebClient UI & Netweaver Enterprise Portal Integration

SAP BusinessObjects Edge BI, Preferred Business Intelligence. SAP BusinessObjects Portfolio SAP Solutions for Small Businesses and Midsize Companies

SAP NetWeaver Identity Management Identity Services Configuration Guide

How-To Guide SAP Cloud for Customer Document Version: How to replicate marketing attributes from SAP CRM to SAP Cloud for Customer

Application Lifecycle Management

Learning Series: SAP NetWeaver Process Orchestration, business to business add-on EDI Separator Adapter

Transcription:

How-to guide: SNMP Trap Adapter This guide explains how you can forward alerts in SAP Solution Manager 7.10 by sending SNMP Traps Version 2.20 (March 2015) SAP Active Global Support

TABLE OF CONTENT 1 PREREQUISITES... 5 1.1 SAP Solution Manager 7.10... 5 1.2 SAP Notes... 5 1.3 System Monitoring Setup... 5 2 INSTALLING THE SNMP LIBRARY... 6 2.1 Download... 6 2.2 Installation... 6 3 SNMP ADAPTER FLAVORS... 8 3.1 Overall mechanism... 8 3.2 [SAP-Standard] usage... 9 3.3 [Custom] usage...11 3.3.1 Custom BAdI implementation overview...11 3.3.2 Steps to create the Implementing Class...12 3.3.3 Steps to create the BAdI entities...13 4 [SAP-STANDARD] SNMP CONFIGURATION...16 4.1 User Interface...16 4.1.1 SNMP Fields Mapping...17 4.1.2 SNMP Server Configuration...19 5 [CUSTOM] SNMP CONFIGURATION...20 5.1 User Interface...20 5.1.1 SNMP Server Configuration...20 5.1.2 SNMP Fields Mapping...21 6 MAI CONFIGURATION TO FORWARD ALERTS VIA SNMP TRAPS...22 6.1 Enabling the Third-Party Component at Global Level...22 6.2 Enabling the Third-Party Component at Template Level...23 6.3 Enabling the Third-Party Component at Alert Level...23 7 TROUBLESHOOTING...24 8 APPENDIX...25 8.1 MIB File extract : [SAP-Standard] SNMP Trap definition...25 8.2 MIB File extract : [Custom] SNMP Trap skeleton definition...28 2

E2E Monitoring and Alerting Infrastructure (E2E MAI): E2E MAI is a unique and centralized alerting approach retrieving metrics and simple events from different data providers as CCMS at managed system or Wily Introscope via push or pull mechanism. It includes: An Event Calculation Engine to calculate complex events and end-user alerts out of the retrieved metrics and simple events to avoid alert flooding A centralized directory for metrics, events and alerts including SAP and customer template knowledge and context information as system landscape, business process or interface information Then end-user alerts are forwarded to several alert consumers as Alert Inbox, Incident Management and Notification Engine provided by SAP Solution Manager. In order to forward those events to third party tool an Alert Consumer Connector allows implementing standard forwarding protocols. In this context, a consumer is implemented to forward Alert data to third party using SNMP trap protocol. 3

4

1 PREREQUISITES 1.1 SAP Solution Manager 7.10 The SNMP Adapter is available standard with SP06 and upper releases. 1.2 SAP Notes Some additional corrections need to be applied: For SP06 : https://service.sap.com/sap/support/notes/1752573 https://service.sap.com/sap/support/notes/1754559 https://service.sap.com/sap/support/notes/1754295 https://service.sap.com/sap/support/notes/1779366 For SP07 : https://service.sap.com/sap/support/notes/1779140 https://service.sap.com/sap/support/notes/1820724 https://service.sap.com/sap/support/notes/1779366 For SP08 : https://service.sap.com/sap/support/notes/1959978 https://service.sap.com/sap/support/notes/1820727 For SP10 : https://service.sap.com/sap/support/notes/1965064 For SP11 : https://service.sap.com/sap/support/notes/2009733 For SP12 : https://service.sap.com/sap/support/notes/2134843 For SP13 : https://service.sap.com/sap/support/notes/2134848 1.3 System Monitoring Setup The System Monitoring setup (transaction solman_setup) must have been successfully completed. 5

2 INSTALLING THE SNMP LIBRARY 2.1 Download You need the SNMPLIB package to send SNMP traps. This package is available on the SAP Service Marketplace: - Use your SAP Service Marketplace ID to log on the Software Catalog of the SAP Service Marketplace (http://service.sap.com/patches). - SAP Software Download Center > Support Packages and Patches > Search for Support Packages and Patches > Search Term = SNMPLIB* According to SAPNote 585110 (https://service.sap.com/sap/support/notes/585110) : Regardless of the kernel version you use (Unicode or non-unicode), install the non-unicode version of the SNMPLIB archive. - Download the archive for your Operating System and SAP Kernel 7.20. 2.2 Installation Decompress the archive with the following command: sapcar xvf SNMPLIB_<version>.sar And copy the for_central_system content into the Installation directory which should be /sapmnt/<solmansid>/exe (or /usr/sap/<solmansid>/sys/exe/run) (or <Drive>:\usr\sap\<SolManSID>\DVEBMGS<xx>\ exe) for both MIBS folder and trapsend executable. Deployed files and directories must have the following properties: Group: sapsys Owner: <SolManSID>adm Permissions: 776 The installation can be tested with transaction sm49 à SEND_SNMP_TRAP. Set the following line as Additional parameters : Unix SolutionManager: -v 1 -m MIB:SAP-MIB -M DIR:/sapmnt/<SolManSID>/exe/MIBS -c public UDP:localhost:162 SAP- MIB::r3maiTrap localhost 6 60 '' Windows SolutionManager: -v 1 -m MIB:SAP-MIB -M DIR:<Drive>:\usr\sap\<SolManSID>\DVEBMGS<xx>\exe\MIBS -c public UDP:localhost:162 SAP-MIB::r3maiTrap localhost 6 60 '' and the result should be an empty bottom window: 6

7

3 SNMP ADAPTER FLAVORS The SNMP Adapter implementation is providing two flavors usage: [SAP-Standard] or [Custom]. 3.1 Overall mechanism 1. The ACC is configured to send 3rd Party Alert Information to the BAdI Implementation (à see configuration details). 2. All the necessary data to be forwarded to the 3 rd party is bundled in a table and passed to the SNMP Adapter. a. Instantiate the SNMP Adapter and pass the AlertInfo Bundle (key-value table) b. Call : SNMPAdapteràsend_trap() c. This will trigger the steps 3, 4 and 5. 3. Based on the SNMP Configuration, the SNMP Executable options and parameters are built (à see configuration details). 4. The configured SEND_SNMP_TRAP command is called (à see configuration details). 5. The SNMP Trap is sent to the 3rd Party Tool. 8

3.2 [SAP-Standard] usage Starting with Solution Manager 7.10 SP06, a [SAP-Standard] BAdI implementation is shipped: Implementing Class is: CL_ALERT_REACT_SNMP_TRAP (package AI_SOLMAN_ALRT_AL_REACTION_IMP) Filter Value is: ALERT_REACTION_OPTION = SNMP_TRAP The provided implementation is bundling the following MAI Alert Information: Name Value Type Length r3maialertmoname Name of the ManagedObject reporting the Alert Char 128 r3maialertmotype T_SYSTEM, INSTANCE, HOST, DBMS Char 10 r3maialertid Unique ID that identifies the Alert in MAI Char 32 r3maialertdate UTC Date (YYYYMMDD) Char 8 r3maialerttime UTC Time (hhmmss) Char 6 r3maialertname Human readable short name of the Alert Char 128 r3maialerttechnicalname Technical ID of the Alert Char 60 r3maialertdescription Alert Description (or Custom Description) Char 128 r3maialertcategory AVAIL, PERFORM, EXCEPTION, CONFIGURE Char 10 r3maialertrating 0:Unknown, 1:Normal, 2:Warning, 3:Critical Integer 1 r3maialertseverity 0:Low 5:Medium 9:Critical Integer 1 r3maialertmetricname Metric Name (or Metric Path for grouped metric) Char 128 r3maialertmetricvalue Metric Value and Unit (or Metric TextValue) Char 128 r3maialertmoid Unique ID that identifies the ManagedObject Char 32 r3maialertstatus O:Open, I:In process, T:Transferred, C:Confirmed Char 4 r3maialertreasonclosure 1:Re-configuration, 2:Work mode change, 3:Green alert Integer 1 r3maialertpriority 1:Low, 2:Medium, 3:High, 4:Very high Integer 1 9

Here are the corresponding Value Ranges: r3maialertmotype : r3maialertcategory : r3maialertstatus : r3maialertrating : r3maialertreasonclosure : r3maialertseverity : r3maialertpriority : The SNMP configuration SNMP Fields Mapping is delivered standard as well (à see configuration details ) 10

3.3 [Custom] usage The SNMP Adapter can also be used directly in a custom BAdI Implementation. User can bundle its own Information with dedicated Trap Field Keys that have to be properly configured in the SNMP Configuration UI (SNMP Fields Mapping). Be aware that the MIB File describing the SNMP Trap Format must also reflect the custom format. SAP delivered MIB File contains a skeleton for such custom traps. The overall process remains unchanged. 3.3.1 Custom BAdI implementation overview Any listener of the Alert Inbox must implement the BAdI Definition BADI_ALERT_REACTION from the Enhancement Spot ALERT_REACTION (package AI_SOLMAN_ALRT_AL_REACTION_ENH): BAdI filter is: - ALERT_REACTION_OPTION (Character-Type) The Implementing Class defines the SNMP Fields that will be forwarded to the Third-Party tool. 11

3.3.2 Steps to create the Implementing Class a) Create an Implementing Class, e.g. Z_CL_ALERT_REACT_CUST_SNMP b) The Implementing Class must Interface IF_BADI_INTERFACE and IF_ALERT_REACTION. c) Implement the following methods: a. REACT_TO_ALERTS ( IPT_ALERTS : E2EA_T_ALERT_CONSM_OBJECT IP_XML : AC_XSTRING IP_FILTER_VAL : AC_REACTION_ID ) i. Called when a given Alert Type is triggered (once per Alert Group, when the Group is first created), and not on each update of a Group. In case where you need to react for each occurrence of an Alert, the attribute Do not group individual occurrences for the Alert Type has to be considered. ii. A set of Alerts, each with contributing Event / Metrics under it, is fed inside this method (ABAP Object and XML) b. REACT_TO_CLOSED_ALERT ( IO_ALERT : IF_ALERT_CONSM_OBJECT IV_XML : AC_XSTRING IV_FILTER_VAL : AC_REACTION_ID ) i. Called when a given Alert is closed, ie when its rating has changed, when its work-mode has changed, or when its managed object is re-configured. c. IS_AUTO_REACTION ( CV_FLAG: ABAP_BOOL ) i. True à an AUTO-REACTION (ie effecting some actions within Solution Manager only). ii. False à a THIRD-PARTY COMPONENT (ie forwarding the Alerts to an external application). iii. Technically there is no difference between how ACC enables those 2 flavors, it is just called by MAI configuration to lisi down active implementations, each under Auto-Reaction (if true) or Third-Party Component (if false) sections. 12

3.3.3 Steps to create the BAdI entities a) With transaction se19, create a new Enhancement Implementation, e.g. Z_ALERT_REACTION_IMPL based on the existing Enhacement Spot ALERT_REACTION: 13

If you want to configure this new BAdI Implementation to re-use the [SAP-Standard] SNMP Implementing Class in order to forward the same SNMP Trap to multiple targets, you can set as Implementing Class CL_ALERT_REACT_SNMP_TRAP. Here is the detailed view of the newly created BAdI Implementation: 14

Then set a dedicated BAdI Filter Value that will be used to differentiate Configurations. After activating the implementing class and the BAdI implementation, it will be registered when the next Alert Notification is triggered by the ACC. 15

4 [SAP-STANDARD] SNMP CONFIGURATION As of Solution Manager 7.10 SP06, a dedicated User Interface has been implemented to configure the SNMP Traps. Make sure in transaction SICF that the service mai_snmp_trap_config is active. 4.1 User Interface http://<solutionmanagerhost>:<port>/sap/bc/webdynpro/sap/mai_snmp_trap_config?sap-language=en If this is the first time you are accessing the Configuration UI, you ll need to create a new Configuration. 1. Expand the Panel Create a Configuration 2. Set Filter Value to SNMP_TRAP_REACT (corresponding to the [SAP-Standard] BAdI Implementation filter concatenated with _REACT ) 3. Check the SAP-Standard Trap Format checkbox. 4. Press Create 5. Set Filter Value to SNMP_TRAP_REACT_CLOSE (corresponding to the [SAP-Standard] BAdI Implementation filter concatenated with _REACT_CLOSE ) 6. Check the SAP-Standard Trap Format checkbox. 7. Press Create 16

This will create 2 Configuration Entries for each type of forwarding (AlertChange & AlertClosure): - one describing the SNMP Fields Mapping, - one describing the SNMP Server Configuration. It is mandatory to create those 2 configurations to react differently: - Reacting on Alert Change à Configuration SNMP_TRAP_REACT - Reacting on Alert Closure à Configuration SNMP_TRAP_REACT_CLOSE 4.1.1 SNMP Fields Mapping The parameter name describes the SNMP Fields mapping corresponding to the MIB Definition of the Trap. The format is the following: <FieldIndex>;<FieldName>;<FieldType> (<FieldType> = s(tring) or i(nteger) ). The parameter value is a key used for mapping with the MAI Alert information. As we are in the [SAP-Standard] flavor of the SNMP Adapter, nothing has to be configured for this Configuration ID Entry. 17

Fields mapping slightly differ from SNMP_TRAP_REACT and SNMP_TRAP_REACT_CLOSE due to not relevant MAI Fields: - r3maialertreasonclosure is not relevant for SNMP_TRAP_REACT - r3maialertmetricname andr3maialertmetricvalue are not relevant for SNMP_TRAP_REACT_CLOSE The OS Command is limiting the concatenated length of all SNMP Trap FieldNames + FieldTypes + FieldValues to maximum 1024 chars. Please adjust your configuration accordingly to the following Table: SNMP FieldName FieldName length FieldValue max-length Total max-length r3maialertmoname 20 128 20à148 r3maialertmotype 20 10 30 (fixed) r3maialertid 16 32 48 (fixed) r3maialertdate 18 8 26 (fixed) r3maialerttime 18 6 24 (fixed) r3maialertname 18 128 18à146 r3maialerttechnicalname 27 60 27à87 r3maialertdescription 25 128 25à153 r3maialertcategory 22 10 22à32 r3maialertrating 20 1 21 (fixed) r3maialertseverity 22 1 23 (fixed) r3maialertmetricname 24 128 24à152 r3maialertmetricvalue 25 128 25à153 r3maialertmoid 18 32 50 (fixed) r3maialertstatus 20 4 20à24 r3maialertreasonclosure 27 1 28 (fixed) r3maialertpriority 22 1 23 (fixed) 18

4.1.2 SNMP Server Configuration Some configuration fields are already pre-filled and should not be modified: - COMMUNITY - MIB_NAME - RETRIES - TIMEOUT - TRANSPORT You ll need to set values to: - HOSTNAME : Target hostname of the SNMP Trap - MIB_DIR : the deployed MIB directory on Solution Manager system - MIB_TRAP_NAME : set to r3maitrap because it is the [SAP-Standard] flavor - PORT : provide an available UDP port - VERSION: supported SNMP versions are 1 and 2c The 2 mandatory configurations are aimed to eventually react differently between an Alert Change (SNMP_TRAP_REACT) and an Alert Closure (SNMP_TRAP_REACT_CLOSE). It is however possible to deactivate one of them by setting the value <SKIP> to the HOSTNAME parameter. You can specifically skip some ratings by adding the Parameter Name RATINGS_TO_SKIP and set the values of the ratings you want to skip, separated by the separator ;. For example, to skip Grey and Green Alert Ratings, the value has to contain : 0;1 19

5 [CUSTOM] SNMP CONFIGURATION 5.1 User Interface The setup of a new [Custom] SNMP Configuration is also done in the User Interface as described in previous chapter. The filter value must me identical to the [Custom] BAdI Implementation Filter Value concatenated with _REACT and _REACT_CLOSE, and the checkbox must remain unchecked. In the described procedure to create the custom BAdI Implementation (chapter 3.3.3), we have set the BAdI Filter Value to SNMP_TRAP_CUST, therefore the 2 configurations to create are : - SNMP_TRAP_CUST_REACT - SNMP_TRAP_CUST_REACT_CLOSE 5.1.1 SNMP Server Configuration The SNMP Server Configuration has to be configured similarly to the previous [SAP-Standard] chapter (à see configuration details) 20

Some configuration fields are already pre-filled and should not be modified: - COMMUNITY - MIB_NAME - RETRIES - TIMEOUT - TRANSPORT You ll need to set values to: - HOSTNAME : Target hostname of the SNMP Trap. Set it to <SKIP> if your implementing class has not implementing the method REACT_TO_ALERTS (resp. REACT_TO_CLOSED_ALERT ) - MIB_DIR : the deployed MIB directory on Solution Manager system - MIB_TRAP_NAME : set to r3customtrap and must reflect the new [Custom] Trap name defined in the MIB File. - PORT : provide an available UDP port - VERSION: supported SNMP versions are 1 and 2c 5.1.2 SNMP Fields Mapping The Fields Mapping has to be fully described and must strictly reflect the new [Custom] Format defined in the MIB File. The parameter name describes the SNMP Fields mapping corresponding to the MIB Definition of the Trap. The format is the following: <FieldIndex>;<FieldName>;<FieldType> (<FieldType> = s(tring) or i(nteger) ). The parameter value is a key used for mapping with the MAI Alert information. The OS Command is limiting the concatenated length of all FieldNames + FieldTypes + FieldValues to maximum 1024 chars. 21

6 MAI CONFIGURATION TO FORWARD ALERTS VIA SNMP TRAPS You need to enable the 3rd Party forwarding and this can be done at different levels: - Global - and/or Template - and/or Alert. 6.1 Enabling the Third-Party Component at Global Level Call transaction solman_setup Select Technical Monitoring > System Monitoring Select Step 2: Configure Infrastructure > Step 2.4: Default Settings Select Third-Party Components tab Add Entry: React to Alerts by sending an SNMP Trap with scope = All Alerts Save Jump to Step 5: Define Scope Select the Managed Object to configure Jump to Step 6: Setup Monitoring Eventually assign the template and always press Apply and Activate 22

6.2 Enabling the Third-Party Component at Template Level Call transaction solman_setup Select Technical Monitoring > System Monitoring Select Step 4: Template Maintenance Select the Template and switch to Expert Mode Select the Tab Third-Party Components Set Dropdown to active and add Entry: React to Alerts by sending an SNMP Trap with scope = All Alerts Save Jump to Step 5: Define Scope Select the Managed Object to configure Jump to Step 6: Setup Monitoring Eventually assign the template and always press Apply and Activate 6.3 Enabling the Third-Party Component at Alert Level Call transaction solman_setup Select Technical Monitoring > System Monitoring Select Step 4: Template Maintenance Select the Template and switch to Expert Mode Select the Tab Alerts Select the specific alert you want to configure and go to the Tab Third-Party Components Set Dropdown to active and add Entry: React to Alerts by sending an SNMP Trap with scope = All Alerts Save Jump to Step 5: Define Scope Select the Managed Object to configure Jump to Step 6: Setup Monitoring Eventually assign the template and always press Apply and Activate 23

7 TROUBLESHOOTING Logs are available using the standard SLG1 transaction: External ID has the following structure: <ConfigurationFilterValue> _ SNMP_<ManagedObject Name> _ <Alert Category> _ <AlertName> Here are some Log extracts: 24

8 APPENDIX 8.1 MIB File extract : [SAP-Standard] SNMP Trap definition [ ] r3maialert OBJECT IDENTIFIER ::= { r3objects 6 } [ ] -- #========================================================================== -- # SAP SolutionManager MAI Alert Traps -- #========================================================================== r3maialerttable OBJECT-TYPE SYNTAX SEQUENCE OF R3maiAlertEntry MAX-ACCESS not-accessible "A list of Solution Manager MAI Alert entries " ::= { r3maialert 1 } r3maialertentry OBJECT-TYPE SYNTAX R3maiAlertEntry MAX-ACCESS not-accessible "The table-entries are the MAI Alerts which occured. An alert is identified by a r3maialertmoid, r3maialertid, r3maialertdate, r3maialerttime." INDEX { r3maialertmoid,r3maialertid,r3maialertdate,r3maialerttime } ::= { r3maialerttable 1 } R3maiAlertEntry ::= SEQUENCE { r3maialertmoname DisplayString, r3maialertmotype DisplayString, r3maialertid DisplayString, r3maialertdate DisplayString, r3maialerttime DisplayString, r3maialertname DisplayString, r3maialerttechnicalname DisplayString, r3maialertdescription DisplayString, r3maialertcategory DisplayString, r3maialertrating INTEGER, r3maialertseverity INTEGER, r3maialertmetricname DisplayString, r3maialertmetricvalue DisplayString, r3maialertmoid DisplayString, r3maialertstatus DisplayString, r3maialertreasonclosure INTEGER, r3maialertpriority INTEGER } r3maialertmoname OBJECT-TYPE SYNTAX DisplayString(SIZE (0..128)) "Represents the ManagedObject Name that raised the MAI Alert." ::= { r3maialertentry 1 } r3maialertmotype OBJECT-TYPE SYNTAX DisplayString(SIZE (0..10)) "Represents the ManagedObject Type that raised the MAI Alert: Value - Comment ----------------------------------------------------------------- CONNECTION Connection DBMS Database HOST Host (Server) INSTANCE Technical Instance PI_DOMAIN Process Integration (PI / XI) Domain SCENARIO Generic Managed Object type SCR Script SCR_ROB Script on Robot SCR_ST_ROB Script Step on Robot TECHN_COMP Technical Component T_SYSTEM Technical System ROB Robot NW_DEVICE Active Network Device PRINTER Printer or Fax STORAGE Storage System UNSPECIFIC Unspecified Managed Object MOBILE Mobile Device IFCHANNEL Interface Channel BPMON_OBJ Business Process Monitoring Object 25

JOB ::= { r3maialertentry 2 } Job" r3maialertid OBJECT-TYPE SYNTAX DisplayString(SIZE (0..32)) "Represents the ID of the MAI Alert." ::= { r3maialertentry 3 } r3maialertdate OBJECT-TYPE SYNTAX DisplayString(SIZE (0..8)) "Represents the UTC Date of the MAI Alert." ::= { r3maialertentry 4 } r3maialerttime OBJECT-TYPE SYNTAX DisplayString(SIZE (0..6)) "Represents the UTC Time of the MAI Alert." ::= { r3maialertentry 5 } r3maialertname OBJECT-TYPE SYNTAX DisplayString(SIZE (0..128)) "Represents the human readable Name of the MAI Alert." ::= { r3maialertentry 6 } r3maialerttechnicalname OBJECT-TYPE SYNTAX DisplayString(SIZE (0..60)) "Represents the Technical Name of the MAI Alert." ::= { r3maialertentry 7 } r3maialertdescription OBJECT-TYPE SYNTAX DisplayString(SIZE (0..128)) "Represents the Description of the MAI Alert." ::= { r3maialertentry 8 } r3maialertcategory OBJECT-TYPE SYNTAX DisplayString(SIZE (0..10)) "Represents the Category of the MAI Alert. Value - Comment ----------------------------------------------------------------- AVAIL Availability PERFORM Performance EXCEPTION Exceptions CONFIGURE Configuration" ::= { r3maialertentry 9 } r3maialertrating OBJECT-TYPE SYNTAX INTEGER { valueunknown(0), valuenormal(1), valuewarning(2), valuecritical(3) } "Represents the MAI Alert Rating: Value - Comment ----------------------------------------------------------------- valueunknown Unknown status valuenormal Normal operation state, green valuewarning Warning, yellow valuecritical Problem occurred, red" ::= { r3maialertentry 10 } r3maialertseverity OBJECT-TYPE SYNTAX INTEGER (0..9) "Represents the MAI Alert Severity: 26

Value - Comment ----------------------------------------------------------------- 0 Low 1 2 3 4 5 Medium 6 7 8 9 Critical" ::= { r3maialertentry 11 } r3maialertmetricname OBJECT-TYPE SYNTAX DisplayString(SIZE (0..128)) "Represents the Name or Path of the MAI Metric." ::= { r3maialertentry 12 } r3maialertmetricvalue OBJECT-TYPE SYNTAX DisplayString(SIZE (0..128)) "Represents the Value (and eventual Unit) of the MAI Metric." ::= { r3maialertentry 13 } r3maialertmoid OBJECT-TYPE SYNTAX DisplayString(SIZE (0..32)) "Represents the ManagedObject Id that raised the MAI Alert." ::= { r3maialertentry 14 } r3maialertstatus OBJECT-TYPE SYNTAX DisplayString(SIZE (0..4)) "Represents the Status of the MAI Alert. Value - Comment ----------------------------------------------------------------- O Open I In process T Transferred E Externally Processed C Confirmed" ::= { r3maialertentry 15 } r3maialertreasonclosure OBJECT-TYPE SYNTAX INTEGER (0..9) "Represents the the MAI Alert: Value - Comment ----------------------------------------------------------------- 1 Re-configuration 2 Work mode change 3 Green alert 4 Grey alert 5 Yellow alert 6 Red alert" ::= { r3maialertentry 16 } r3maialertpriority OBJECT-TYPE SYNTAX INTEGER { valuelow(1), valuemedium(2), valuehigh(3), valueveryhigh(4) } "Represents the MAI Alert Priority: Value - Comment ----------------------------------------------------------------- valuelow Low valuemedium Medium valuehigh High valueveryhigh Very High" ::= { r3maialertentry 17 } 27

r3maialerttraps OBJECT IDENTIFIER ::= { r3maialert 2 } r3maitrap NOTIFICATION-TYPE OBJECTS { r3maialertmoname, r3maialertmotype, r3maialertid, r3maialertdate, r3maialerttime, r3maialertname, r3maialerttechnicalname, r3maialertdescription, r3maialertcategory, r3maialertrating, r3maialertseverity, r3maialertmetricname, r3maialertmetricvalue, r3maialertmoid, r3maialertstatus, r3maialertreasonclosure, r3maialertpriority } "Generic SAP Solution Manager MAI Alert" ::= { r3maialerttraps 60 } [ ] 8.2 MIB File extract : [Custom] SNMP Trap skeleton definition [ ] r3customalert OBJECT IDENTIFIER ::= { r3objects 7 } [ ] -- #========================================================================== -- # SAP SolutionManager Custom Alert Traps -- #========================================================================== r3customalerttable OBJECT-TYPE SYNTAX SEQUENCE OF R3customAlertEntry MAX-ACCESS not-accessible "A list of Solution Manager Custom Alert entries " ::= { r3customalert 1 } r3customalertentry OBJECT-TYPE SYNTAX R3customAlertEntry MAX-ACCESS not-accessible "The table-entries are the Custom Alerts which occured. An alert is identified by a r3customalertxxx, r3customalertyyy." INDEX { r3customalertxxx,r3customalertyyy } ::= { r3customalerttable 1 } R3customAlertEntry ::= SEQUENCE { r3customalertxxx r3customalertyyy } DisplayString, INTEGER r3customalertxxx OBJECT-TYPE SYNTAX DisplayString(SIZE (0..512)) "Represents XXX that raised the Custom Alert." ::= { r3customalertentry 1 } r3customalertyyy OBJECT-TYPE SYNTAX INTEGER (0..2147483647) "Represents YYY that raised the Custom Alert." ::= { r3customalertentry 2 } r3customalerttraps OBJECT IDENTIFIER ::= { r3customalert 2 } r3customtrap NOTIFICATION-TYPE OBJECTS { r3customalertxxx, r3customalertyyy } "Generic SAP Solution Manager Custom Alert" ::= { r3customalerttraps 60 } [ ] 28

www.sap.com 2012 SAP AG. All rights reserved. SAP, R/3, SAP NetWeaver, Duet, PartnerEdge, ByDesign, SAP BusinessObjects Explorer, StreamWork, SAP HANA, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and other countries. Business Objects and the Business Objects logo, BusinessObjects, Crystal Reports, Crystal Decisions, Web Intelligence, Xcelsius, and other Business Objects products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Business Objects Software Ltd. Business Objects is an SAP company. Sybase and Adaptive Server, ianywhere, Sybase 365, SQL Anywhere, and other Sybase products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of Sybase, Inc. Sybase is an SAP company. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves informational purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies ("SAP Group") for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.