Cisco TEO Adapter Guide for SAP Solution Manager (Beta) Release 2.3 April 2012 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
CONTENTS Preface v Organization v Conventions vi Product Documentation vii Documentation Formats vii Guides and Release Notes vii Online Help vii Open Source License Acknowledgements vii Obtaining Documentation and Submitting a Service Request CHAPTER 1 Understanding the Adapter Objects 1-1 Accessing the SAP Solution Manager Adapter Properties Viewing SAP Solution Manager Adapter Properties Viewing General Information 1-2 Configuring Adapter Options 1-3 Viewing Adapter Prerequisites 1-4 Install
Contents Viewing Target History CHAPTER 3 Managing Triggers 2-15 3-1 Accessing Trigger Properties 3-1 Creating Solution Manager Alert Trigger Managing Triggers 3-7 Enabling a Trigger Disabling a Trigger Modifying a Trigger Deleting a Trigger CHAPTER 4 3-3 3-7 3-7 3-8 3-8 Using the SAP Solution Manager Activities SAP Solution Manager Activities 4-1 4-1 Defining an SAP Solution Manager Activity 4-2 Defining Correlate Solution Manager Alerts Activity 4-5 Viewing Correlate Solution Manager Al
Preface The Cisco TEO Adapter for SAP Solution Manager provides the functionality in Tidal Enterprise Orchestrator (TEO) to manage alerts triggered by the alert management solution on SAP Solution Manager 7.1 systems. The Cisco add-on that is installed on the SAP Solution Manager provides the functionality in TEO to retrieve and close the open alerts in the SAP Solution Manager interface. This guide provides information on the objects provided by the SAP Solution Manager Adapter in TEO.
Preface Conventions This guide uses the following conventions: Convention Indication bold font Commands and keywords and user-entered text appear in bold font. italic font Document titles, new or emphasized terms, and arguments for which you supply values are in italic font. [ ] Elements in square brackets are optional. {x | y | z } Required alternative keywords are grouped in braces and separated by vertical bars.
Preface Product Documentation Documentation Formats Documentation is provided in the following electronic formats: • Adobe® Acrobat® PDF files • Online help You must have Adobe® Reader® installed to read the PDF files. Adobe Reader installation programs for common operating systems are available for free download from the Adobe Web site at www.adobe.com. Guides and Release Notes You can download the TEO product documentation from Cisco.com. Release Notes can be found on Cisco.com and the product CD.
Preface Cisco TEO Adapter Guide for SAP Solution Manager viii OL-25939-01
CH A P T E R 1 Understanding the Adapter Objects The Cisco TEO Adapter for SAP Solution Manager provides the functionality in Tidal Enterprise Orchestrator (TEO) to support task automation and manage alerts triggered by an SAP Solution Manager system. This chapter provides information on accessing and viewing the objects provided by the SAP Solution Manager Adapter.
Chapter 1 Understanding the Adapter Objects Viewing SAP Solution Manager Adapter Properties Step 2 Select SAP Solution Manager Adapter and use one of the following methods to open the SAP Solution Manager Properties dialog box: • Right-click and choose Properties. • In the Details pane, click any of the hyperlinks on the General tab. Viewing SAP Solution Manager Adapter Properties You use the SAP Solution Manager Adapter properties dialog box to view the functionality provided by the adapter.
Chapter 1 Understanding the Adapter Objects Viewing SAP Solution Manager Adapter Properties Field Description Release date Date and time the adapter was available in the product. Install date Date and time the adapter was installed. Configuring Adapter Options Use the Options tab to configure archiving Solution Manager alerts as Reporting Database events. Step 1 On the SAP Solution Manager Adapter Properties dialog box, click the Options tab.
Chapter 1 Understanding the Adapter Objects Viewing SAP Solution Manager Adapter Properties Viewing Adapter Prerequisites Use the Prerequisites tab to view the objects that are required by the adapter on the automation server. Note The SAP Solution Manager Adapter requires SAP .NET 3.0 Connector for .NET 4.0 on x64 version 3.0.6.4 or higher. The following dll files must be copied to the TEO server: • sapnco.dll • sapnco_utils.
Chapter 1 Understanding the Adapter Objects Viewing SAP Solution Manager Adapter Properties Step 2 Review the following information about the adapter prerequisites: Column Description Name Name of the required hardware or software for the supported adapter. Importance Indicates whether the item is Required or Optional for the adapter. State Indicates whether the system has the required hardware or software installed (Satisfied or Not satisfied).
Chapter 1 Understanding the Adapter Objects Viewing SAP Solution Manager Adapter Properties Viewing Adapter-Supported Objects Use the Provides tab to view the name and type of object provided by the adapter. Step 1 On the SAP Solution Manager Adapter Properties dialog box, click the Provides tab.
Chapter 1 Understanding the Adapter Objects Viewing SAP Solution Manager Adapter Properties Viewing Adapter History Use the History tab to view a history of changes that have been made to the adapter. Step 1 On the SAP Solution Manager Adapter Properties dialog box, click the History tab. Figure 1-6 Step 2 SAP Solution Manager Adapter Properties—History Tab View the following information: Field Description Created by Display only. User name of the person who created the object.
Chapter 1 Understanding the Adapter Objects Viewing SAP Solution Manager Adapter Properties Cisco TEO Adapter Guide for SAP Solution Manager 1-8 OL-25939-01
CH A P T E R 2 Managing SAP Solution Manager Targets The SAP Solution Manager target enables you to run processes on a specific SAP Solution Manager system. The target can be defined once and reused in several processes. This chapter guides you through accessing, creating and managing SAP Solution Manager targets.
Chapter 2 Managing SAP Solution Manager Targets Creating SAP Solution Manager Targets Creating SAP Solution Manager Targets Before you can create or run processes in your SAP Solution Manager environment, you must create the targets on which the processes will run. You use the New SAP Solution Manager wizard to create SAP Solution Manager targets. Note The SAP Solution Manager Adapter requires the dll files for SAP .NET 3.0 Connector for .NET 4.0 on x64 version 3.0.6.4 or higher.
Chapter 2 Managing SAP Solution Manager Targets Creating SAP Solution Manager Targets Figure 2-3 Step 3 Step 4 System Setup Specify the following information to connect to the SAP Solution Manager system: Field Description Display name Enter a name for the SAP Solution Manager system. This is the name that will display in the Targets pane. Organization Enter the group or organization within the company that owns the target. Click Next.
Chapter 2 Managing SAP Solution Manager Targets Creating SAP Solution Manager Targets Step 5 Specify the following information to connect to the SAP Solution Manager target: Field Description Connect using Choose the connection method from the drop-down list. The fields that display on the panel depend on the connection method selected. Application server Choose this option to connect to the SAP Solution Manager target using the SAP application server connection information.
Chapter 2 Managing SAP Solution Manager Targets Creating SAP Solution Manager Targets Figure 2-5 Options The Options panel is used to map the systems that are being monitored by the Solution Manager target to the SAP System targets configured in TEO. The list box displays the systems that are mapped. Note Step 7 Step 8 The matching SAP System targets must already be created in TEO.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Figure 2-6 Step 9 Completing the SAP Solution Manager Wizard Verify that the information is correct and click Finish to complete the procedure. The SAP Solution Manager target displays in the Targets pane. Managing SAP Solution Manager Targets Use the Definitions—Targets view to manage the SAP Solution Manager targets.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Disabling a Target Disabling a target prevents it from being available for execution. However, a disabled target is not removed from the list of targets in the Targets pane. Step 1 Step 2 On the Definitions—Targets view, use one of the following methods to disable the target: • In the Targets pane, right-click the target and choose Disable.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Modifying Solution Manager Targets Use the Definitions—Targets view to display and modify the Solution Manager target properties. Modifying Display Name and Description Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the Solution Manager target, or right-click and choose Properties.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Step 4 Field Description Description Text description of the target. Enabled Check or uncheck the check box to enable or disable the target. The check box is checked by default to indicate the target is enabled. Click OK to save your changes and close the dialog box.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Step 4 Modify any of the following information to connect to the Solution Manager system: Field Description Connect using Choose the connection method from the drop-down list. The fields that display on the panel depend on the connection method selected. Application server Choose this option to connect to the SAP Solution Manager system using the SAP application server connection information.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Modifying Polling and Mapping Information You can modify the interval in which the Solution Manager target is polled for alerts using the Options tab on the Solution Manager Target Properties dialog box. You can also view the mappings between systems being monitored by Solution Manager and the SAP systems configured in TEO. You can add or remove systems to be monitored.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Add Systems Specify the following information: Step 6 Field Description Select a system monitored by Solution Manager Choose the SAP system that is monitored by Solution Manager from the drop-down list. Select a matching system montored by TEO Choose the SAP system target that is configured in TEO from the drop-down list. This target must already be defined in TEO.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Step 4 In the list box, view the target groups that the target is a member. Step 5 To view the properties of a specific target group, right-click and choose Properties. Step 6 Click OK to close the dialog box. Viewing Extended Properties You can view the list of extended target properties defined for a specific target type using the Extended Properties tab on the Solution Manager Target Properties dialog box.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Viewing Used By Properties You can view the objects that are directly associated with the selected target (for example, an SAP system or process) using the Used By tab on the Solution Manager Target Properties dialog box. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the Solution Manager target, or right-click and choose Properties.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Viewing Target History You can view the history of changes that have been made to the target using the History tab on the Solution Manager Target Properties dialog box. Step 1 In the Definitions view, click Targets to display the defined targets in the Targets pane. Step 2 Double-click the Solution Manager target, or right-click and choose Properties.
Chapter 2 Managing SAP Solution Manager Targets Managing SAP Solution Manager Targets Cisco TEO Adapter Guide for SAP Solution Manager 2-16 OL-25939-01
CH A P T E R 3 Managing Triggers Triggers are used to determine how or when the process will be executed. The SAP Solution Manager Adapter provides the Solution Manager Alert, which is used to trigger a process. This chapter guides you through accessing, creating and managing triggers.
Chapter 3 Managing Triggers Accessing Trigger Properties Figure 3-1 Process Properties—Triggers Tab Information about the triggers display in the following columns: Column Description Display name Name assigned to the trigger. Target Name of the target that is executed by the trigger. Step 3 On the Triggers tab, select the trigger and click Properties. Step 4 The Properties dialog box for the trigger displays.
Chapter 3 Managing Triggers Creating Solution Manager Alert Trigger Creating Solution Manager Alert Trigger Use the Solution Manager Alert trigger to specify the properties in the monitoring tree element (MTE) that must be matched before an alert is generated. When the specified alert is generated, the process is executed. Step 1 On the Definitions—Processes view, use one of the following methods to open the Process Editor: • Select an existing process, right-click and choose Edit.
Chapter 3 Managing Triggers Creating Solution Manager Alert Trigger Figure 3-3 Step 6 Solution Manager Alert Properties—Alert Tab On the Alert tab, check the check box for the criteria to match and then specify the relevant information: Field Description Category Specify the category in Solution Manager to be matched. Monitored object name Specify the monitored object name in Solution Manager to be matched. System ID Specify the SAP system ID for the system that generated the alert.
Chapter 3 Managing Triggers Creating Solution Manager Alert Trigger Note Click the Reference tool to to choose a defined variable or reference an object on the Insert Variable Reference dialog box. Click the Insert Wildcard Step 7 Click the Targets tab. Figure 3-4 Step 8 tool to choose a wildcard.
Chapter 3 Managing Triggers Creating Solution Manager Alert Trigger Field Description Monitor on this target group Click this radio button and then click the Browse tool to launch the Select Target Group dialog box and select a specific target group to be monitored for the alert. To view the properties for the target group, click the Properties tool.
Chapter 3 Managing Triggers Managing Triggers Defining an Advanced Condition: a. Click the Advanced tab to define a specific type of condition (Compound, Prior Process Instance, Time, or Variable). b. Click the AND/OR link to modify the option for the condition equation. c. Click New and choose the type of condition from the drop-down list. d. Specify the relevant information for the type of condition selected.
Chapter 3 Managing Triggers Managing Triggers Modifying a Trigger You can modify the properties of a Solution Manager alert trigger from the Triggers tab on the process Properties dialog box. Step 1 On the process Properties dialog box, click the Triggers tab. Step 2 Select the trigger in the list, right-click and choose Properties. Step 3 Click the Alerts tab to modify the alert criteria. Step 4 Click OK to save your changes and close the dialog box.
CH A P T E R 4 Using the SAP Solution Manager Activities The SAP Solution Manager activities enable you to create processes specific to your SAP Solution Manager environment. When defining an activity in the process workflow, the properties pane contains property pages that are specific to the selected activity.
Chapter 4 Using the SAP Solution Manager Activities Defining an SAP Solution Manager Activity Defining an SAP Solution Manager Activity Use the following steps to define an SAP Solution Manager activity in the Process Editor. The property pages that display depend on the activity. Refer to the appropriate section for instructions on completing the activity property pages.
Chapter 4 Using the SAP Solution Manager Activities Defining an SAP Solution Manager Activity Field Description Execute on this target reference Click this radio button and then click the Reference tool to select the target reference property on which to execute the activity. On the Insert Variable Reference dialog box, expand Process > Target > Properties, select the appropriate target reference property, and click OK. The selected target reference property displays in the text field.
Chapter 4 Using the SAP Solution Manager Activities Defining an SAP Solution Manager Activity Step 6 Click the Knowledge Base tab to specify a knowledge base article for the activity. The following information displays: Field Description Knowledge base Knowledge base article associated with the activity. Summary Brief description of the issue. Possible Cause Explanation of the condition that may be causing the issue.
Chapter 4 Using the SAP Solution Manager Activities Defining Correlate Solution Manager Alerts Activity Defining Correlate Solution Manager Alerts Activity Use the Correlate Solution Manager Alerts activity to specify the properties of alerts that should be correlated. Step 1 On the Toolbox, click the Correlate Solution Manager Alerts activity and drag it onto the Workflow pane.
Chapter 4 Using the SAP Solution Manager Activities Defining Correlate Solution Manager Alerts Activity Figure 4-2 Step 4 Correlate Solution Manager Alerts Properties—Solution Manager Alert Criteria Tab Specify the following information: Field Description Correlate Solution Manager alerts that occur Enter a value and select the time unit to indicate the within length of time to wait before or after the process start time.
Chapter 4 Using the SAP Solution Manager Activities Defining Correlate Solution Manager Alerts Activity Field Description Solution Manager Alert criteria Check the check box for the criteria to be matched and the specify the relevant information in the corresponding text field. Category Application server for the SAP system that will be monitored by this process. Enter the (*) wildcard to monitor all servers.
Chapter 4 Using the SAP Solution Manager Activities Defining Update Solution Manager Alert Activity The following information displays for each alert: Step 5 Column Description Name Name of the alert. Occurred Time the alert occurred. Type Type of alert (Information, Warning, Error, Success audit, or Failure audit). Click Close to close the dialog box.
Chapter 4 Using the SAP Solution Manager Activities Defining Update Solution Manager Alert Activity Figure 4-4 Step 4 Specify the information in the following fields: Field Description Alert id Unique number of the alert within the SAP system. Complete alert Check the check box to acknowledge the alert. Comment Text information about the alert and the acknowledgement. Note Step 5 Step 6 Update Solution Manager Alert Properties—Update Alert Tab Click the Reference process.
Chapter 4 Using the SAP Solution Manager Activities Defining Update Solution Manager Alert Activity Viewing Update Solution Manager Alert Activity Results When the Update Solution Manager Alert activity is executed, results are displayed in the Operations workspace activity instance view. Step 1 In the Operations workspace, expand the Activity Views folder and then click the view that represents how the process was executed (for example, View Adhoc if the process was manually executed).
INDEX deleting A SAP Solution Manager targets about SAP Solution Manager triggers SAP Solution Manager activities 4-1 SAP Solution Manager targets SAP Solution Manager Adapter properties Targets view 1-1 2-7 SAP Solution Manager triggers 3-7 2-1 3-1 E activities defining 3-8 disabling accessing triggers 2-7 4-2 enabling SAP Solution Manager 4-1 SAP Solution Manager targets adapter 2-6 SAP Solution Manager triggers 3-7 accessing SAP Solution Manager Adapter properties 1-1 archi
Index S V SAP Solution Manager activities, defining viewing 4-2 SAP Solution Manager targets adapter history 1-7 accessing 2-1 Correlate Solution Manager Alerts results disabling 2-7 objects using target enabling 2-6 target history managing 2-14 2-15 Update Solution Manager Alert results 2-6 4-7 4-10 SAP Solution Manager triggers accessing 3-1 disabling 3-7 enabling 3-7 SAP system number 2-4, 2-10 server availability specifying servers 2-5 Solution Manager alerts, archivin
