Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA

Cisco TEO—Process Automation Guide for
Automation for SAP BW and BWA
Release 2.2
September 2011
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
Text Part Number: OL-24784-01
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.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT
SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE
OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public
domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH
ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF
DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING,
WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO
OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
CCDE, CCENT, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco SensorBase, Cisco StackPower,
Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra,
Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital,
Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, Flip Gift Card, and One Million Acts of Green are service marks; and Access Registrar, Aironet, AllTouch,
AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo,
Cisco IOS, Cisco Lumin, Cisco Nexus, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation,
Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Follow Me Browsing, GainMaker, iLYNX, IOS, iPhone, IronPort, the IronPort logo, Laser Link, LightStream,
Linksys, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design),
PowerVu, Prisma, ProConnect, ROSA, SenderBase, SMARTnet, Spectrum Expert, StackWise, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc.
and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website are the property of their respective owners. The use of the word partner does not imply a partnership relationship
between Cisco and any other company. (0910R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display
output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in
illustrative content is unintentional and coincidental.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
© 2010—2011 Cisco Systems, Inc. All rights reserved.
CONTENTS
New and Changed Information
Preface
vii
ix
Organization
ix
Conventions
x
Product Documentation xi
Documentation Formats xi
Guides and Release Notes xi
Online Help xi
Open Source License Acknowledgements
xi
Obtaining Documentation and Submitting a Service Request
CHAPTER
1
Importing Automation Packs
xii
1-1
Accessing the Automation Pack Import Wizard 1-2
Opening the Import Wizard After Running Setup Wizard
Opening the Import Wizard in Console 1-3
1-2
Importing the Core Automation for SAP BW, BWA and BOBJ.tap
Importing the Automation for SAP BW and BWA.tap
1-7
Importing the Cisco Add-On Into SAP Systems 1-10
Error Handling, Logging and Tracing for ABAP Add-on
Support desk management for ABAP Add-on 1-11
Installing TREX Script Files
CHAPTER
2
1-4
1-10
1-11
Understanding Automation Pack Objects
Accessing Automation Pack Properties
2-1
2-1
Viewing Automation Pack Content and Dependencies 2-3
Viewing Automation Pack Content 2-3
Automation for SAP BW and BWA Processes 2-4
Automation for SAP BW and BWA Extended Target Properties 2-6
Automation for SAP BW and BWA Global Variables 2-8
Automation for SAP BW and BWA Knowledge Base Articles 2-8
Viewing Automation Pack Dependencies 2-10
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
iii
Contents
CHAPTER
3
Getting Started Using the Automation Pack
Creating an SAP User Account
3-1
3-2
Creating Targets 3-3
Creating SAP System Targets 3-3
Creating BWA Unix/Linux Target 3-5
Creating Reference to BWA Unix/Linux Target
3-9
Using Task Rules for Assignments and Notifications 3-10
Accessing Task Rules View 3-10
Configuring Task Rules 3-11
SAP Default Assignment 3-11
Creating a New Task Rule 3-13
Managing Task Rule Definitions 3-21
Enabling a Task Rule 3-21
Disabling a Task Rule 3-21
Creating a Copy of a Task Rule 3-22
Sorting Task Rules 3-22
Deleting a Task Rule 3-22
Enabling Notification Based on Assignment Processes
3-23
Managing Extended Target Properties 3-24
Accessing Extended Target Properties 3-24
Configuring Extended Target Properties 3-25
CHAPTER
4
Managing Automation for SAP BW and BWA Processes
Accessing Automation for SAP BW and BWA Processes
Filtering Processes by Category 4-3
Managing SAP Processes 4-3
Enabling a Process 4-3
Disabling a Process 4-4
Modifying Process Instance Archival
Modifying a Process Schedule 4-6
Running Processes 4-9
Starting a Process 4-9
Viewing Running Process
4-1
4-2
4-4
4-11
Viewing Process Results 4-13
Accessing Process View 4-13
Viewing Activity Results 4-14
Viewing Incidents 4-15
Viewing Automation Summary
4-17
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
iv
OL-24784-01
Contents
APPENDIX
A
Installing TEO SAP Monitoring Management Pack In SCOM
Prerequisites
A-1
A-1
Configuring the SCOM Environment A-2
Configuring Security Settings A-2
Creating A Run As Account A-2
Distributing Run As Account A-7
Importing Management Pack A-9
Creating a Profile for TEOProcess Database Run As Account
Enabling SAP Alerts on Windows Event Log Process
APPENDIX
B
Installing the SPI for HP OpenView
Prerequisites
A-12
A-16
B-1
B-1
Installing TEO HP OpenView SPI
B-2
Configuring HP OpenView B-5
Configuring Services B-5
Deploying TEO Policies B-8
Enabling SAP Alerts on Windows Event Log Process
APPENDIX
C
B-9
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Automation Pack Content C-1
Core Automation for SAP BW, BWA and BOBJ Processes C-1
Core Automation for SAP BW, BWA and BOBJ Atomic Processes C-2
Core Automation for SAP BW, BWA and BOBJ Extended Target Properties
Core Automation for SAP BW, BWA and BOBJ Global Variables C-2
Core Automation for SAP BW, BWA and BOBJ Target Groups C-3
Automation Pack Dependencies
C-1
C-2
C-3
Core Automation for SAP BW, BWA and BOBJ Activities
Defining an Activity C-6
Viewing Activity Results C-9
C-4
Defining the BWA TREX Activities C-9
BWA TREX—Cancel Running Reorganization Activity C-9
BWA TREX—Continue Reorganization Activity C-11
BWA TREX—Delete All Indexes Activity C-13
BWA TREX—Delete Index Activity C-14
BWA TREX—Execute Query Activity C-15
BWA TREX—Get Alert Details Activity C-17
BWA TREX—Get Alerts Activity C-18
BWA TREX—Get Index Usage Activity C-20
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
v
Contents
BWA TREX—Get Indexes Activity C-21
BWA TREX—Get Landscape Summary Activity C-23
BWA TREX—Get Last Reorganization Plan Activity C-24
BWA TREX—Get Load Metrics Activity C-26
BWA TREX—Get Loaded Indexes Activity C-27
BWA TREX—Get Long Running Threads Activity C-29
BWA TREX—Get Next Reorganization Plan Activity C-30
BWA TREX—Get Reorganization Summary Activity C-32
BWA TREX—Get Service Statistics Activity C-34
BWA TREX—Preload Index Activity C-36
BWA TREX—Restart Service Activity C-37
BWA TREX— Start Reorganization Activity C-39
BWA TREX—Test HTTP Status Activity C-40
BWA TREX—Unload Index Activity C-42
INDEX
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
vi
OL-24784-01
New and Changed Information
The following table describes new and changed information in this guide for the Cisco TEO Automation
Pack for Automation for SAP BW and BWA 2.2.
Table 1
Cisco TEO Automation Pack for Automation for SAP BW and BWA 2.2 Feature
Changes
Feature
Location
Updated guide name, automation pack name, and
added Text Part Number to document.
All
•
Updates to the importing the automation
packs:
Chapter 1, “Importing Automation Packs”
– Disable all imported processes during
import feature.
– New section for importing Core
Automation for SAP BW, BWA and
BOBJ.tap (dependency).
•
New procedure for install TREX Script Files.
Updated to automation pack content:
•
New processes
•
New extended target properties
•
Task Rules
•
Automation Pack Dependencies
•
Moved reports to this chapter
Chapter 2, “Understanding Automation Pack
Objects”
New chapter on getting started using the
automation pack; includes information about
runtime users, targets, task rules, and extended
target properties.
Chapter 3, “Getting Started Using the
Automation Pack”
Removed Managing Global Variables chapter.
NA
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
vii
New and Changed Information
Table 1
Cisco TEO Automation Pack for Automation for SAP BW and BWA 2.2 Feature
Changes
Feature
Location
Removed section on Creating Automation Pack for Chapter 4, “Managing Automation for SAP BW
New Processes section. See the Tidal Enterprise
and BWA Processes”
Orchestrator Reference Guide for information on
this feature.
Added appendix that includes information on the
content in the Core Automation for SAP BW,
BWA and BOBJ automation pack.
Chapter C, “Core Automation for SAP BW, BWA
and BOBJ Automation Pack Content”
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
viii
OL-24784-01
Preface
Cisco TEO automation pack files are a collection of Tidal Enterprise Orchestrator (TEO) processes
(workflows) authored by subject matter experts that work out-of-the-box to automate best practices for
a particular technology. The automation pack files also include configuration objects that are used in the
processes, such as variables, categories, target groups and knowledge base articles.
The Cisco TEO Automation Pack for Automation for SAP BW and BWA includes the content used to
automate best practices for monitoring SAP BW availability, operations and performance. TEO provides
event correlation and root cause analysis capabilities, and intelligently manages the flood of incoming
incidents by analyzing them in the context of the other incidents, events and metrics. When critical
problems are detected, you are notified with a thorough description of the problem and recommendations
for resolving it using language approproate for both administrators and operators.
This guide is intended to provide information on importing and using the Automation for SAP BW and
BWA automation pack in TEO.
Organization
This guide includes the following sections:
Chapter 1
Importing Automation Packs
Provides instructions for installing the automation
pack during or after the initial installation of TEO.
Chapter 2
Understanding Automation Pack
Objects
Provides information on the objects included in the
automation pack.
Chapter 3
Getting Started Using the
Automation Pack
Provides information on configuring the objects in
TEO that are referenced by the content in the
automation pack—runtime users, targets, task
rules, and extended target properties.
Chapter 4
Managing Automation for SAP
BW and BWA Processes
Provides information on using and managing the
SAP BW and BWA processes.
Appendix A
Installing TEO SAP Monitoring
Management Pack In SCOM
Provides instructions for setting up your SCOM
environment, and installing and configuring the
management pack.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
ix
Preface
Appendix B
Installing the SPI for HP
OpenView
Provides instructions for installing the TEO
modules for HPOV, configuring HPOV services
and deploying the policies.
Appendix C
Core Automation for SAP BW,
Provides information on the content included in
BWA and BOBJ Automation Pack the Core Automation for SAP BW, BWA and
BOBJ automation pack.
Content
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.
[x|y|z]
Optional alternative keywords are grouped in brackets and separated by
vertical bars.
string
A nonquoted set of characters. Do not use quotation marks around the string or
the string will include the quotation marks.
courier
font
Terminal sessions and information the system displays appear in courier font.
< >
Nonprinting characters such as passwords are in angle brackets.
[ ]
Default responses to system prompts are in square brackets.
!, #
An exclamation point (!) or a pound sign (#) at the beginning of a line of code
indicates a comment line.
Note
Means reader take note.
Tip
Means the following information will help you solve a problem.
Caution
Timesaver
Means reader be careful. In this situation, you might perform an action that could result in equipment
damage or loss of data.
Means the described action saves time. You can save time by performing the action described in
the paragraph.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
x
OL-24784-01
Preface
Warning
Means reader be warned. In this situation, you might perform an action that could result in
bodily injury.
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 product documentation in PDF format from the product CD.
Online Help
Online help is available and can be accessed using the following methods:
•
Click the Help button on any dialog box in the application to open the help topic in a pane to the
right of the dialog box.
•
In the Tidal Enterprise Orchestrator console:
– Click the Help Pane
tool on the toolbar to open the help topic in a pane to the right of the
console results pane.
– Click Help on the menu bar.
Open Source License Acknowledgements
Licenses and notices for open source software used in Tidal Enterprise Orchestrator 2.2 can be found in
the Open Source Licensing Acknowledgements document on the product CD. If you have any questions
about the open source contained in this product, please email external-opensource-requests@cisco.com.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
xi
Preface
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly What’s New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What’s New in Cisco Product Documentation as a RSS feed and set content to be delivered
directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently
supports RSS Version 2.0.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
xii
OL-24784-01
CH A P T E R
1
Importing Automation Packs
The Tidal Enterprise Orchestrator Installation and Reference Guide provides instructions for installing
Tidal Enterprise Orchestrator (TEO) and the core components. During the initial installation of TEO,
you can choose to import the automation packs, or import them later from within the Console.
The Cisco TEO Automation Pack for Automation for SAP BW and BWA has a dependency on other
automation packs so these must be imported prior to importing the Automation for SAP BW and BWA
automation pack.
This chapter guides you through importing the automation packs, which contain the content for
automating processes to manage and monitor your SAP environment. It contains the following sections:
Note
•
Accessing the Automation Pack Import Wizard, page 1-2
•
Importing the Core Automation for SAP BW, BWA and BOBJ.tap, page 1-4
•
Importing the Automation for SAP BW and BWA.tap, page 1-7
•
Importing the Cisco Add-On Into SAP Systems, page 1-10
•
Installing TREX Script Files, page 1-11
It is recommended that you review the system requirements and prerequisites before importing
automation packs. See the Cisco TEO Getting Started Guide for SAP.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
1-1
Chapter 1
Importing Automation Packs
Accessing the Automation Pack Import Wizard
Accessing the Automation Pack Import Wizard
You use the Automation Pack Import Wizard to import the automation packs (tap files). You can either
open the wizard immediately after installing TEO or from within the Console.
Opening the Import Wizard After Running Setup Wizard
Step 1
After running the Setup wizard to install the product, ensure that the Launch automation pack import
wizard now check box is checked before closing the wizard.
The Select Automation Packs dialog box displays the available automation packs. All automation packs
are checked by default.
Step 2
Ensure that the following check boxes are checked and then click OK to launch the Automation Pack
Import Wizard:
•
Assessment for SAP BWA (dependency)
•
Automation for SAP BW and BWA
•
Core Automation for SAP (dependency)
•
Core Automation for SAP BW, BWA and BOBJ (dependency)
Note
See the TEO Cisco Process Automation Guide for Assessment for SAP BWA for instructions on importing
the Core Automation for SAP and Assessment for SAP BWA automation packs.
Note
See the Tidal Enterprise Orchestrator Installation and Administration Guide for instructions on
importing and configuring the Core components for the product.
Proceed to Importing the Core Automation for SAP BW, BWA and BOBJ.tap, page 1-4.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
1-2
OL-24784-01
Chapter 1
Importing Automation Packs
Accessing the Automation Pack Import Wizard
Opening the Import Wizard in Console
You can open the Automation Pack Import Wizard from within the Console after installing the product.
When importing automation packs from within the Console, you must re-open the Automation Pack
Import Wizard for each automation pack that you are importing.
Because the Automation for SAP BW and BWA automation pack has dependencies on the Core
Automation for SAP BW, BWA and BOBJ automation pack, you must first import this automation pack.
Note
Step 1
The following instructions assume you have already imported the Core Automation for SAP and the
Assessment for SAP BWA automation packs.
In the Administration workspace on the Console, click Automation Packs in the navigation pane.
Figure 1-1
Step 2
Step 3
Automation Packs View—Import Menu
Use one of the following methods to open the Automation Pack Import Wizard:
•
In the navigation pane, right-click Automation Packs and choose Import.
•
On the Menu bar, choose Actions > Import.
On the Windows Open dialog box, select the Core Automation for SAP BW, BWA and BOBJ.tap file
and click Open to open the Automation Pack Import Wizard.
Proceed to Importing the Core Automation for SAP BW, BWA and BOBJ.tap, page 1-4.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
1-3
Chapter 1
Importing Automation Packs
Importing the Core Automation for SAP BW, BWA and BOBJ.tap
Importing the Core Automation for SAP BW, BWA and BOBJ.tap
You must first import the Core Automation for SAP BW, BWA and BOBJ automation pack (Core
Automationf or SAP BW, BWA and BOBJ.tap). If you opened the Automation Pack Import Wizard from
the Setup Completed panel, the wizard will guide you through importing each automation pack.
Step 1
On the Automation Pack Import Wizard Welcome panel, click Next.
Figure 1-2
Note
Welcome to the Automation Pack Import Wizard
If you do not want to display the Welcome panel the next time the wizard is opened, check the Do not
show this page next time check box.
Figure 1-3
General Information—Core Automation for SAP BW, BWA and BOBJ
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
1-4
OL-24784-01
Chapter 1
Importing Automation Packs
Importing the Core Automation for SAP BW, BWA and BOBJ.tap
Step 2
On the General Information panel, review the information about the automation pack.
Step 3
If you want to disable all the processes that are imported with the automation pack, check the Disable
all imported processes check box.
Note
Step 4
If you disable the imported processes, you will need to manually enable the processes in the
Console before they can execute.
Click Next to continue.
Figure 1-4
Data Extraction—Automation for SAP BW, BWA and BOBJ
The Data Extraction panel is used to specify the destination where the BWA Script files will be extracted.
The script files are used in the direct TREX monitoring processes and must be copied to the TREX
server.
Note
Step 5
If you uncheck the BWA Scripts check box, the files will not be extracted.
Accept the default location or click the Browse
and then click Next.
tool to specify a different location to extract the files
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
1-5
Chapter 1
Importing Automation Packs
Importing the Core Automation for SAP BW, BWA and BOBJ.tap
Figure 1-5
Review Prerequisites—Core Automation for SAP BW, BWA and BOBJ
The Review Prerequisites panel displays the prerequisites for the automation pack being imported. The
green check mark indicates that the prerequisite was found on the computer.
The red X indicates that the prerequisite was not found on the computer. When this occurs, the import
process is stopped and cannot continue until all prerequisites have been met.
If all prerequisites are passed, the wizard automatically continues to the next panel.
Note
If you opened the Automation Pack Import Wizard from the Setup Completed panel, the wizard
displays the General Information panel (Figure 1-8 on page 1-8) for the next automation pack.
Figure 1-6
Completing the Automation Pack Import Wizard—Core Automation for SAP BW, BWA
and BOBJ
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
1-6
OL-24784-01
Chapter 1
Importing Automation Packs
Importing the Automation for SAP BW and BWA.tap
Step 6
After the objects have been imported, review the information on the Completing the Automation Pack
Import Wizard panel to verify that it is correct and then click Close to exit the wizard.
Importing the Automation for SAP BW and BWA.tap
If you are importing the automation packs from within the Console, you must re-open the Automation
Pack Import Wizard to import the Automation for SAP BW and BWA automation pack.
Step 1
Step 2
Use one of the following methods to open the Import Automation Pack Wizard:
•
In the navigation pane, right-click Automation Packs and choose Import.
•
On the Menu bar, choose Actions > Import.
On the Windows Open dialog box, select the Automation for SAP BW and BWA.tap file and click
Open to launch the Automation Pack Import Wizard.
Figure 1-7
Step 3
Welcome to the Automation Pack Import Wizard
On the Welcome panel, click Next.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
1-7
Chapter 1
Importing Automation Packs
Importing the Automation for SAP BW and BWA.tap
Figure 1-8
General Information—Automation for SAP BW and BWA
Step 4
On the General Information panel, review the information about the automation pack.
Step 5
If you want to disable all the processes that are imported with the automation pack, check the Disable
all imported processes check box.
Note
Step 6
If you disable the imported processes, you will need to manually enable the processes in the
Console before they can execute.
Click Next to continue.
Figure 1-9
Data Extraction—Automation for SAP BW and BWA
The Data Extraction panel is used to specify the destination where the ABAP Transport files will be
extracted. The ABAP Transport files must be installed on the SAP systems on which some remote
function calls that are used in this automation pack will be executed.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
1-8
OL-24784-01
Chapter 1
Importing Automation Packs
Importing the Automation for SAP BW and BWA.tap
Note
Step 7
If you uncheck the ABAP Transport check box, the files will not be extracted.
Accept the default location or click the Browse
and then click Next.
Figure 1-10
tool to specify a different location to extract the files
Review Prerequisites—Automation for SAP BW and BWA
If all prerequisites are passed, the wizard automatically continues to the next panel.
Figure 1-11
Step 8
Completing the Automation Pack Import Wizard
After the objects have been imported, review the information on the Completing the Automation Pack
Import Wizard panel to verify that it is correct and then click Close to exit the wizard.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
1-9
Chapter 1
Importing Automation Packs
Importing the Cisco Add-On Into SAP Systems
Importing the Cisco Add-On Into SAP Systems
The Automation for SAP BW and BWA automation pack contains RFC calls that require the Cisco
add-on for SAP to be installed on the SAP target system. The Cisco software add-on must be available
on all of the SAP systems where the RFCs will be used.
Note
Step 1
The Cisco Add-On for SAP BW supports only SAP BW v7.01 SP8.
Navigate to the location where the ABAP Transport data was extracted. The default location is:
C:\Documents and Settings\user\My Documents\Cisco\Tidal Enterprise Orchestrator\Extracted
Data\ABAP Transports\SAP BW
Step 2
Copy the SAP Add-On Package file(s) to the following location on the SAP server:
usr\sap\trans\EPS\in
Step 3
Log onto client 000 of the SAP system using an administrator account (DDIC or SAP* are not valid
accounts) and run the SAP transaction code SAINT.
Step 4
Follow the standard SAP procedures for performing an add-on product installation using SAINT.
Note
To verify whether the add-on is on the SAP system, use the SAP menu path System > Status and review
the software component versions for the Cisco software component add-on.
Error Handling, Logging and Tracing for ABAP Add-on
The ABAP Add-On contains API enabled ABAP function modules (RFC's) that are called by the Cisco
TEO application. This is performed in TEO by defining an ABAP adapter step and specifying a method
for the SAP Target system in a process. Cisco TEO ABAP custom methods perform individual tasks such
as updating RFC Destinations, configuring printers, and so on.
In the event the method encounters an error, such as attempting to modify an RFC destination that does
not exist, an error result is returned to the TEO process. This can then be modeled as an outcome to the
activity, and then subsequent actions based on the error returned may be performed.
All RFC activity performed by TEO may be traced through SAP Standard RFC tracing functionality.
Refer to SAP online help for enabling the trace level for RFC communication on the SAP target system
using SAP transaction SM59. The SAP methods that are called may either write log entries to the SAP
System Log (SAP Transaction SM21) or to the Application log (SAP Transaction SLG1) depending on
the SAP standard application functionality. For instance, the SAP Application log is updated during the
BDLS process scenario as this part of the SAP standard application functionality.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
1-10
OL-24784-01
Chapter 1
Importing Automation Packs
Installing TREX Script Files
Support desk management for ABAP Add-on
SAP Root Cause Analysis ABAP tools can be used to review the performance and execution of the RFC
calls performed by the TEO system. A read-only SAP Administrator user is used to review the
functionality performed by the ABAP methods. The following roles are to be the basis for a composite
role that can be adapted to the customer environment:
•
SAP_BC_BASIS_MONITORING,
•
SAP_BC_SEC_USER_DISPLAY,
•
SAP_BC_BTC_DISPLAY,
•
SAP_BC_MID_ALE_DISPLAY
Installing TREX Script Files
After you have completed importing the automation packs, you must install the script files to the TREX
server. These script files are used in the direct TREX monitoring and corrective actions processes.
Note
SAP BWA TREX Scripting is supported only on SAP BWA v7.20, Release 8 or later.
The script files are imported to the following location on the TEO server by default:
Microsoft Windows Server 2003:
C:\Documents and Settings\local_user\My Documents\Cisco\Tidal Enterprise Orchestrator\Extracted
Data\BWA Scripts
Microsoft Windows Server 2008:
C:\Users\local_user\Documents\Cisco\Tidal Enterprise Orchestrator\Extracted Data\BWA Scripts
Copy the BWA Scripts folder to the BWA host filesystem and run the install.sh command from the Bash
shell to install the script files.
Note
Both the install.sh and cisco_teo_python.tar files need to be copied to the server prior to running the
install.sh command.
The script files are copied to the $DIR_INSTANCE\exe\python_support directory.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
1-11
Chapter 1
Importing Automation Packs
Installing TREX Script Files
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
1-12
OL-24784-01
CH A P T E R
2
Understanding Automation Pack Objects
The Automation for SAP BW and BWA automation pack includes the content used to automate best
practices for monitoring SAP BW availability, operations and performance. This chapter provides
information on the content included in the Automation for SAP BW and BWA automation pack. It
contains the following sections:
•
Accessing Automation Pack Properties, page 2-1
•
Viewing Automation Pack Content and Dependencies, page 2-3
Accessing Automation Pack Properties
You can access the automation pack properties from the Administration—Automation Packs view in the
console. The automation pack properties dialog box displays general information about the content
provided by the automation pack, version number, publish date, the provided objects, the dependencies
of the automation pack, and the history of changes made to the automation pack.
Step 1
On the Administration workspace, click Automation Packs in the navigation pane to display the
installed automation packs in the Automation Packs pane.
Figure 2-1
Accessing the Automation Packs
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
2-1
Chapter 2
Understanding Automation Pack Objects
Accessing Automation Pack Properties
Information about the automation packs display in the following columns:
Column
Description
Company Name
Name of the company that released the automation
pack.
Publish Date
Date the automation pack was created or exported to a
file.
Version
Version number of the automation pack.
Display Name
Name of the automation pack.
ID
Identification number of the automation pack.
Import Date
Date the automation pack was imported into the
product.
Licensed
Indicates whether the automation is a licensed product
in TEO.
Description
Text description of the automation pack.
Step 2
Select the automation pack in the Automation Packs pane, right-click and choose Properties.
Step 3
On the Properties dialog box, click the appropriate tab to view the automation pack properties:
Step 4
Tab
Description
General
Displays general information about the automation
pack.
Objects
Display a list of objects contained in the automation
pack.
Dependencies
Display a list of automation packs and adapters
referenced by the objects in the automation pack.
History
Displays when the automation pack was created or
modified, and audit log entries that are relevant to the
automation pack.
Click Close to close the dialog box.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
2-2
OL-24784-01
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Viewing Automation Pack Content and Dependencies
Use the automation pack Properties dialog box to view the objects contained in the automation packs
and the dependencies associated with the automation pack.
Note
See Appendix C, “Core Automation for SAP BW, BWA and BOBJ Automation Pack Content” for
information on the content included in the dependent automation pack.
Viewing Automation Pack Content
Step 1
On the Administration—Automation Packs view, select Automation for SAP BW and BWA, right-click
and choose Properties.
Step 2
On the Automation for SAP BW and BWA Properties dialog box, click the Objects tab.
Figure 2-2
Automation for SAP BW and BWA Properties—Objects Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
2-3
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Step 3
On the Objects tab, review the information about the objects provided by the Automation for SAP BW
and BWA automation pack.
Columns
Description
Display Name
Name of the object (processes, global variables,
knowledge base).
Type
Object type.
Action Required
Action required to successfully import or export the
objects.
Description
Text description of the object.
Version
Object version.
Automation for SAP BW and BWA Processes
The following table contains the processes that are imported by the Automation for SAP BW and BWA
automation pack.
Note
The BWA Status Check and BWA Checklist processes execute the custom method BW– TREX Get
Landscape Status Summary that shows the status based on SAP thresholds. Alert server thresholds can
be changed using the standalone TREX Admin Tool run directly from Linux shell.
For instructions on using the TREX Admin Tool, refer to the SAP article.
Process Name
Description
Adhoc – BWA Create and Fill Indexes – List Used to create and fill BWA indexes. The input variable
Input
is a list of InfoCubes (one per line).
Adhoc – BWA Create and Fill Indexes –
Wildcard Input
Used to create and fill BWA indexes. The input variable
can be a wildcard.
Adhoc – BWA Index Reorganization
Executes reorganization plan to distribute the indexes
in a TREX system landscape to achieve a balanced
memory and CPU load.
BW Accelerator Status – CCMS
Monitors BW Accelerator status based on CCMS.
BW Checklist
Automates the most important and frequent
administration tasks for monitoring BW system health.
This process detects and analyzes common error
conditions that typically need to be addressed by system
administrators.
BW FTP Source Availability
Proactively checks connectivity of selected FTP
Destinations.
BW Infocube Dimension Ratio
Proactively monitors BW infocube dimension table size
for performance impact and alerts when the dimension
to fact table size ratio is too large.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
2-4
OL-24784-01
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Process Name
Description
BW OLAP Connectivity
Proactively monitors OLAP interface connectivity.
BW Query Response Time
Monitors the query execution response time. This
process does not use BWA index for the query
execution.
BW Report Performance Monitoring
Samples report query response time for a custom
defined set of reports.
BW SAP Source System Extraction Error
Detects and analyzes the cause of aborted BW source
system extraction jobs. This process examines the job
log to accurately identify the cause of the aborted
extraction job.
BW tRFC Source System Availability
Proactively checks connectivity of selected BW Source
System RFC Destinations. This process issues an RFC
connection test and identifies which RFC destinations
have lost connectivity.
BWA Alert Monitoring
Proactively monitors BWA status.
BWA Alerts – Automate Actions
Automates the execution of recommended BWA
actions.
BWA Checklist
Automates administration tasks for monitoring BWA
system health.
BWA Create and Fill Indexes (InfoCubes
List from Excel)
The Assessment for SAP BWA process creates an Excel
spreadsheet in each execution and the results can be
used by this process.
BWA Create and Fill Indexes (InfoCubes
List from Global Variable)
Used to create and fill BWA indexes from a list of
infocubes in a global variable.
BWA Delete Indexes
Used to delete BWA indexes.
BWA Index Reorganization
Executes reorganization plan to distribute the indexes
in a TREX system landscape to achieve a balanced
memory and CPU load. The process is triggered by a
BWA Index Reorganization Required incident.
BWA Index Reorganization Required
Checks the BWA system for a reorganization
recommendation.
BWA Query Response Time
Monitors the query execution response time. This
process uses BWA index for the query execution.
BWA Services Statistics Monitoring
Proactively monitors BWA services statistics based on
thresholds defined in the BW– BWA Service Statistics
Thresholds global variable.
BWA Status Check
Proactively monitors BWA status.
BWA TREX Monitor Load Statistics
Monitors BWA TREX load statistics.
BWA TREX Status Check
Monitors BWA TREX status.
Create RSDDTREX_AGGREGATES_FILL
Variant
Automates the creation of variant master data required
to execute the ABAP fill program
RSDDTREX_AGGREGATES_FILL.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
2-5
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Process Name
Description
HTTP BEx URL Test
Proactively checks connectivity of the BW BEx HTTP
interface. This process issues a connection test and
identifies if the interface is functioning.
InfoPackage Failed
Analyzes InfoPackage data transfer requests that have
not completed processing or failed in the last hour.
Process Chain Errors
Analyzes process chains that have run since the last
start of the BW system. This process detects process
chain errors and retrieves log file.
Search BWA Trace Logs
Searches the BWA TREX trace logs for selected
keywords.
Automation for SAP BW and BWA Extended Target Properties
The following table contains the extended target properties that are imported by the Automation for SAP
BW and BWA automation pack. The extended target properties that do not have a value defined must
be configured by the user prior to using them in processes.
Value
Defined?
Variable Name
Description
BW – BEx URL Test
Monitors the availability of specific BW BEx HTTP No
URLs.
Enter a list of destinations to be monitored by TEO.
The entries are similar to SM59 for HTTP
destinations.
Destination: BEx URL
Host:
Port:
Path: sap/bw/bex
Pattern: status_code200
Pattern can be a regular expression or a substring
that you are looking for in the report result. Note
that it will strip off all the white spaces (blank, tab,
new line) and the "|" character from the report
before matching it against the pattern. Pattern
example: status_code200
BW – BWA Checklist RSRV
Checks Enabled
Indicates if RSRV checks should be performed
during BWA checklist process execution.
Yes
BW – BWA Delay to Check Jobs Contains the delay in minutes to check the
Filling Indexes
background job that is filling indexes.
Yes
BW – BWA InfoCube List for
Index (variable list)
Contains a list of InfoCubes to index and fill.
No
BW – BWA Service Statistics
Threshold
Contains the threshold values to be used for
monitoring BWA Services.
No
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
2-6
OL-24784-01
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Value
Defined?
Variable Name
Description
BW – BWA Top InfoCubes to
Monitor Status
Contains a list of InfoCubes to be used in the BWA No
Checklist process to monitor InfoCube status.
BW– BWA Top Queries to
Monitor Response Time
Contains a list of the most important queries for
No
detail analysis (RSRT). This global variable is used
in the BWA Checklist and BWA Query Response
Time processes to monitor query response time. The
query response time will also be published as TEO
metrics.
BW – BWA TREX Destination
Contains the BWA TREX Destination.
No
BW – BWA Unix Target
Contains a reference to the BWA Unix target.
No
BW – Infocube Dimension Ratio Recommended BW Infocube dimension to fact
table size ratios.
No
Wildcard is accepted (for example, if you want to
match all infocubes starting with 0D_SD, enter
0D_SD*).
Note
BW – Report Threshold
The BW Infocube Dimension Ratio process
is supported to run in the BW operating
client only.
Enter the list of BW Reports and average response
time thresholds (seconds).
No
Wildcards are accepted (for example, if you want to
match all reports starting with 0D_SD, enter
0D_SD*).
BW – Source Systems
SAP Systems that are sources for BW data
extraction.
No
BW – Top Queries to Monitor
Response Time
Contains a list of the most important queries for
No
detail analysis (RSRT). It is used in the BW Query
Response Time processes to monitor query
response time. The query response time will also be
published as TEO metrics.
BW FTP Source Availability
Monitors the availability of a BW FTP sources.
No
Enter the FTP sources to be monitored by TEO for
availability.
The source is the IP address of the FTP server.
BW tRFC Source Availability
Monitors the availability of specific BW source
system RFC destinations.
No
Enter a list of destinations to be monitored by TEO
for availability.
BWA Alert Monitoring Actions
Used for BWA alert monitoring problem resolution. Yes
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
2-7
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Automation for SAP BW and BWA Global Variables
The following table contains the global variable imported by the Automation for SAP BW and BWA
automation pack.
Value
Defined?
Global Variable Name
Description
BW – BWA InfoCube List for
Index (lock selection)
Select if the index fill should be done with lock or
no lock. Enter true or false.
Yes
BW – RSRT List of Events
Contains a list of RSRT events. It is updated by
Cisco with all the available events.
Yes
Automation for SAP BW and BWA Knowledge Base Articles
The knowledge base articles provide information to help understand the results of an activity or process,
including a summary of what has occurred, the possible cause of the results, and suggested actions to
take to resolve issues with an activity. The Automation for SAP BW and BWA automation pack contains
the Knowledge Base articles that are included in the SAP activities.
Knowledge Base Article
Summary
BEx HTTP Interface Unavailable
TEO could not connect to the BEx HTTP interface.
BW Accelerator Status
TEO detected a BW Accelerator status alert in CCMS.
BW Checklist
The BW Checklist process automates the most
important and frequent administration tasks for
monitoring BW system health.
BW FTP Source Unavailable
FTP Source could not be reached.
BW InfoCube Dimension Ratio is Low
TEO has detected BW infocubes whose dimension to
fact table size ratio is below threshold.
BW OLAP Unavailable
Connection to the OLAP interface in the BW system
failed.
BW Process Chain Logs
TEO has detected a process chain error or termination.
A process chain is a sequence of processes that wait in
the background for an event. Some of these processes
trigger a separate event that can start other processes.
BW Query Over Threshold
TEO detected BW queries over the response time
threshold.
BW Report Performance
TEO detected BW reports response time is above the
average and/or maximum threshold.
BW Source System Extraction Error
TEO has detected an error in the processing of the BW
source system extraction job.
BW Source System RFC Destination
Unavailable
RFC Destination could not connect.
BW System Check
Confirms that system has Business Warehouse
components installed.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
2-8
OL-24784-01
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Knowledge Base Article
Summary
BWA Checklist
The BWA Checklist process checks BWA system
health.
BWA Index Created and Filled
The selected infocube indexes were successfully
created and filled.
BWA Index Creation or Fill Error
An error occurred when indexing the selected infocube.
BWA Index Status
The BWA Index Status activity provides the current
BWA index status and version.
BWA Query Over Threshold
TEO detected BWA queries over the response time
threshold.
BWA Status
TEO detected BWA status different than green.
BWA TREX Alerts
TEO detected BWA TREX alerts.
BWA TREX Service Statistics Over
Threshold
TEO detected TREX service statistics over threshold.
HTTP BExURL Test Failed
BEx URL Failed HTTP destination test executed by
TEO.
InfoPackage Request Failures
TEO has detected BW InfoPackage requests in failed
status.
InfoPackage Request Failures w/Error
Messages
TEO has detected BW InfoPackage requests in failed
status.
Process Chain Error
TEO has detected a process chain error.
RSMO - InfoPackage Request Failures
TEO monitors BW InfoPackage requests table
RSREQDONE for requests that failed or are in
incompleted status.
An infopackage request is generated at the runtime of
the data transfer process. The request is processed in
the steps that have been defined for the data transfer
process (extraction, transformation, filter). The
monitor for the data transfer process request shows the
header information, request status, and the status and
messages for the individual processing steps.
RSRT - Execute Query with BWA Index
This activity runs a BW query with BWA index and
returns debugging and performance information.
RSRT - Execute Query
This activity runs a BW query and returns debugging
and performance information.
Top Response Time Components Over
Threshold
The longest running components of the queries over
runtime threshold are sorted and listed.
TREX Index List
The TREX List Indexes activity displays technical
information on BWA indexes, such as the number of
searchable documents, and the memory and disk space
used per index.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
2-9
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Knowledge Base Article
Summary
TREX Landscape Summary
The TREX Landscape Summary activity provides an
overview of the TREX status with information on the
TREX version, operating system, and current error
messages.
TREX Service Statistics
The TREX Services Statistics activity displays the
system load on the TREX servers listed by each service
type.
Viewing Automation Pack Dependencies
Step 1
On the Administration—Automation Packs view, select Automation for SAP BW and BWA, right-click
and choose Properties.
Step 2
On the Automation for SAP BW and BWA Properties dialog box, click the Dependencies tab.
Figure 2-3
Automation for SAP BW and BWA Properties—Dependencies Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
2-10
OL-24784-01
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Step 3
Review the list of automation packs and adapters referenced by the Automation for SAP BW and BWA
automation pack:
Object Type
Dependency
Automation Packs
Adapters
Step 4
•
Core Automation for SAP
•
Core
•
Assessment for SAP BWA
•
Core Automation for SAP BW, BWA and BOBJ
•
Core Functions Adapter
•
SAP ABAP Adapter
•
Generic (Microsoft OLEDB) Database Adapter
•
Microsoft Windows Adapter
•
Oracle Database Adapter
•
IBM DB2 Database Adapter
•
Microsoft SQL Server Database Adapter
Click Close to close the dialog box.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
2-11
Chapter 2
Understanding Automation Pack Objects
Viewing Automation Pack Content and Dependencies
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
2-12
OL-24784-01
CH A P T E R
3
Getting Started Using the Automation Pack
Before you begin using the content that ships with the automation pack, you must create the objects in
TEO that are referenced in the processes. These objects include targets, runtime users, task rules for
assignments and notifications, and extended target properties.
This chapter provides basic information on defining the objects. It includes the following sections:
•
Creating an SAP User Account, page 3-2
•
Creating Targets, page 3-3
•
Using Task Rules for Assignments and Notifications, page 3-10
•
Managing Extended Target Properties, page 3-24
For additional information about the objects discussed in this chapter, refer to the following
documentation:
Document
Description
Tidal Enterprise Orchestrator Reference
Guide
General information about Core product features.
Cisco TEO Adapter Guide for SAP ABAP Information about the objects specific to SAP ABAP
Adapter (runtime user, target, and activities).
Cisco TEO Getting Started Guide for SAP Information about configuring and managing the objects in
TEO specific to SAP.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-1
Chapter 3
Getting Started Using the Automation Pack
Creating an SAP User Account
Creating an SAP User Account
The runtime user account is used to connect to the targets on which the processes will execute. You use
the SAP User runtime user account to connect to the SAP System target.
Step 1
In the Definitions workspace, right-click Runtime Users and choose New > SAP User to open the New
SAP User Properties dialog box.
Step 2
On the General tab, specify the following information:
Note
The Required Field
missing a value.
icon displayed on a tab or page indicates that the field is required and is
Field
Description
Display name
Name for the user account.
User name
User name assigned to the SAP user account that
connects to the SAP system or ABAP application
server.
Password
Password assigned to the SAP user account that
connects to the SAP system or ABAP application
server.
Client
SAP client number assigned to the user account.
Description
A description of the user account.
Note
The Used By tab displays objects used by the runtime user and will remain blank until used by
an object.
The History tab displays the history of actions taken against the runtime user and will remain
blank until after the initial creation.
Step 3
Note
Click OK to close the dialog box.
For additional information on creating and managing runtime users, see the Tidal Enterprise
Orchestrator Reference Guide.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-2
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Creating Targets
Creating Targets
Before you can create or run processes, you must create the targets on which the processes will run. This
section guides you through creating SAP System targets using the New SAP System Wizard.
In addition, you must create a BWA Unix/Linux target if you want to use the BWA TREX atomic
processes that are included in the Core Automation for SAP BW, BWA and BOBJ automation pack.
This section guides you through creating the targets and then configuring the references to the targets.
Creating SAP System Targets
Use the New SAP System Wizard to create the SAP System targets.
Step 1
In the Definitions view, right-click Targets and choose New > SAP System from the submenus to open
the New SAP System Wizard Welcome panel.
The Required Field
missing a value.
Note
Step 2
icon displayed on a tab or page indicates that the field is required and is
Click Next and specify the following information on the System Setup panel:
Field
Description
Display name
Enter a name for the SAP system. This is the name that will
be displayed in the Targets pane.
System Components
ABAP application servers
Check this check box if the SAP system uses an ABAP
connection to the application servers.
Java application servers
This option is not used for this automation pack.
SAP database
This option is not used for this automation pack.
Monitor as production system
The check box is checked by default. Certain processes
will run only on production systems. If you want to
monitor the system as a non-production system
(development or sandbox), uncheck the check box.
Step 3
Click Next.
Step 4
On the ABAP Connection panel, specify the connection information for connecting to the SAP ABAP
application server.
Note
The system information entered on this panel must be unique. Otherwise, an error message
displays informing you that the wizard detected another system already registered with the same
information.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-3
Chapter 3
Getting Started Using the Automation Pack
Creating Targets
Field
Description
Connect using:
Application server
Choose this option to connect to the SAP system using
the SAP application server connection information.
Server name
Name of the SAP application server.
System number
SAP system number.
Logon group
Choose this option to establish a connection using a
logon group, which contains a group of SAP system
instances. When a user logs on to a logon group, the
mesage server directs the users to the server of this
group that currently has the lightest load.
System ID
SAP system ID (SID).
Message server
Determines which server a user logs on to and handles
the communication between the application servers. For
example, transport of update requests and lock requests.
Group name
Name of the Logon Group to be accessed. The name
entered in this field is case-sensitive.
Router string (optional)
Enter the router string for accessing the SAP systems
via SAPRouter. If you do not specify a router string,
TEO accesses the SAP system directly.
The router string must be formatted as:
/H/host01/H/host02/H/
where host01 and host02 are the SAP systems that you
want to access through the SAPRouter.
Default runtime user
Step 5
Choose the user account that contains the credentials to
connect to the target from the drop-down list.
•
To view the properties for the selected runtime user,
click the Properties
icon.
•
To create a new SAP User, click New > SAP User.
See Creating an SAP User Account, page 3-2 for
instructions.
Click Next.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-4
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Creating Targets
Step 6
On the Server Availability panel, specify the ABAP application servers that you want to monitor for
availability and the ability to log in a user:
Field
Description
Servers available for monitoring
All detected servers are selected by default. Verify that the
check box next to each server that you want to monitor is
checked.
Add
If a server is offline during configuration, it will not be
displayed in the list of available servers. To manually add
the server, click Add and enter the name of the server.
Remove
If you want to remove a server from the list, select the
server and click Remove.
Select All
If the check boxes have been unchecked and you want all
servers to be monitored, click Select All.
Deselect All
If all the check boxes are checked and you want to uncheck
all of them, click Deselect All.
Step 7
Click Next.
Step 8
On the Completing the New SAP System Wizard panel, verify that the information is correct and click
Finish to complete the procedure.
Creating BWA Unix/Linux Target
If you want to run the BWA TREX atomic processes that are included in the Core Automation for SAP
BW, BWA and BOBJ automation pack, you must create the BWA Unix/Linux System target.
Note
For additional information on creating and managing Unix/Linux System targets, see the Cisco TEO
Adapter Guide for Terminal Adapter.
Step 1
On the Definitions workspace, right-click Targets and choose New > Unix/Linux System to open the
New Unix/Linux System Properties dialog box.
Step 2
On the General tab, specify the following information:
Field
Description
Display name
Enter a name for the Database target. This is the name that
will display in the Targets pane.
Type
Display only. Type of target.
Owner
User name of the owner of the target. This is typically the
person who created the target. Click the Browse
tool
to change the owner.
Status
Display only. Status of the target.
Status information
Display only. Detailed information regarding the target
status.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-5
Chapter 3
Getting Started Using the Automation Pack
Creating Targets
Step 3
Field
Description
Organization
Name of the company or business unit that supports the
target.
Description
Optional field to enter a description for the target.
Enabled
Check or uncheck the check box to enable or disable the
target. The check box is checked by default.
Click the Connection tab.
Note
Step 4
The Required Value
is missing a value.
icon displayed on a tab or page indicates that the field is required and
On the Connection tab, specify the connection information to connect to the Unix/Linux server:
Field
Description
Host name
Host name or IP address of server.
Port
Port number used to access the server.
Prompt prefix
Enter the command prompt prefix that will be used by the
device type configurations and expects when issuing
commands and connecting to the device.
Adding a regex character, such as $, >, and #, at the end of
a prompt in the Prompt Prefix field invalidates the
command prompt prefix.
Regular expressions should be placed in the appropriate
Terminal Interaction Pattern fields. See Step 9 to customize
the interaction patterns on the Advanced tab.
Example:
Unix system prompt prefix is defined by the user default
login script. it usually contains username, node name or
current directory name. If the user does not define
anything, the prompt prefix is empty.
If you connect to the terminal, and the prompt is
jsmith@TBD-SH03-IT ~$, enter the regular
expression that will match the entire prefix (before #) using
any of the following expressions:
Default runtime user
•
.*TBD-SH03-IT.*
•
\[\w+@TBD-SH03-IT.*\]
Choose the default runtime user account that contains the
credentials to connect to the target from the drop-down list.
To view the properties for the selected runtime user, click
the Properties
tool.
To create a new runtime user account, click New >
[Runtime User Type] to create a new Runtime User
account.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-6
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Creating Targets
Field
Description
Enable code injection prevention
Check this check box to enable the protection which
prevents code that is injected to exploit the security
vulnerability.
Maximum allowed concurrent sessions
Enter the maximum allowed open sessions to run
concurrently (default value is 3).
If the user tries to open new session via Open Session
activity, it will wait in a queue until there is a session
available to open.
Step 5
Click the Authentication tab to indicate whether the target should allow authentication based on the host
system.
Users can define default host public and private keys on the Terminal Adapter settings. This tab allows
users to select a specific private key for the target. The private key will be used for host-based
authentication if a target does not specify its own keys.
Step 6
On the Authentication tab, specify the following information:
Field
Description
Use host-based authentication
Check this check box to indicate that host-based
authentication will be used with this target.
If this check box is unchecked, then host-based
authentication will not be used.
Use the default host keys
This check box becomes enabled after the Use host-based
authentication check box is checked.
Check this check box to indicate the host keys defined on
the Terminal Adapter property page will be used for this
target.
If this check box is unchecked, then the user will need to
load the appropriate private key to be used to validate this
target.
Private key
This box becomes enabled only if the Use the default host
keys check box is unchecked.
To the right of the display-only field, click the Browse
tool to launch the Load Private Key dialog box and select
a private key.
Step 7
Click the Advanced tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-7
Chapter 3
Getting Started Using the Automation Pack
Creating Targets
Step 8
On the Advanced tab, configure the interaction patterns for the target.
Field
Description
Use patterns common for the following
device
Click the radio button one of the pre-defined device
targets from the drop-down list.
•
Cisco IOS Device—Select this option to use the
default pattern values used by the device during the
completion of a session command.
•
Unix/Linux System—Select this option to use the
default pattern values indicated for a Unix or Linux
system during the completion of a session
command.
To view the properties for the selected device, click the
Properties
tool.
To create a new device, click New > Expect Template
to create a new expect template.
Customize patterns for this target
Step 9
To customize the interaction patterns, complete the following fields, as necessary.
Note
Click the Reference
tool to select a defined variable or reference an object within the process
from the Insert Variable Reference dialog box.
Field
Description
Prompt
Enter the system prompt pattern in regular expression.
Error
Enter the error message pattern in regular expression.
Admin prompt
Enter the admin prompt pattern in regular expression.
Note
Step 10
Select this radio button to enable the display-only
sections in order to customize the default values for the
selected device type.
Click the Expression
the field.
arrow to the right of the Reference icon to add a regular expression
To modify the list of login expects, click the following buttons, as necessary.
Button
Description
Add
Click Add to launch the Expect dialog box to configure
the expect parameters to be added to the list.
Edit
Highlight the appropriate item and click Remove to
remove the item from the list.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-8
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Creating Targets
Step 11
Step 12
Button
Description
Remove
Highlight the appropriate item and click Edit to launch
the Expect dialog box to modify the expect parameters
in the list.
Up and Down Arrows
Highlight the appropriate item and then click the up or
down arrow to move the item up or down in the list.
To elevate the privilege command for login expects:
Field
Description
Elevating Privilege command
Check this check box and in the text field, enter the
command or select the reference variable containing the
command to elevate the privilege for the expect.
Elevating Privilege expects
Use this section to view and/or define the login expect
sequence for the elevating privilege command expects.
Click OK to close the dialog box.
The new target displays in the list of targets on the Definitions—Targets view.
Creating Reference to BWA Unix/Linux Target
You must now configure the BW—BWA Unix Target target reference to include the BWA Unix/Linux
System target. Use the Extended Target Properties feature to reference the targets.
Step 1
On the Definitions workspace, click Extended Target Properties.
Step 2
Navigate to the BW–BWA Unix Target target reference, right-click and choose Properties.
Step 3
On the Unix/Linux System Target Properties dialog box, click the Browse
field.
Step 4
On the Select Target dialog box, select the BWA Unix/Linux System target and click OK.
Step 5
Click OK to close the Unix/Linux System Target Properties dialog box.
tool next to the Value
For additional information on using Extended Target Properties, see Managing Extended Target
Properties, page 3-24.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-9
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Using Task Rules for Assignments and Notifications
Task rules are used to manage task assignments and notifications for tasks, such as incidents and alerts,
that are generated from processes. When you import the Core Automation for SAP automation pack, you
are prompted to specify the default user or group who should be assigned SAP incidents. By default, this
person will receive all assignments unless task rules are created to specify alternate users or groups for
specific tasks.
This section guides your through configuring the task rule that ships with the Core Automation for SAP
automation pack and provides instructions for creating and managing task rules.
Note
If you do not want to create task rules for email notifications, you can use the default notification based
on assignment processes that ship with the Core automation pack. These processes are disabled by
default and must be enabled if you want notifications to be sent (see Enabling Notification Based on
Assignment Processes, page 3-23).
Accessing Task Rules View
The task rule that ships with the Core Automation for SAP automation pack can be accessed from the
Definitions—Task Rules view.
Step 1
On the Console, select the Definitions workspace and click Task Rules in the navigation pane. By
default, all the rules display in the Task Rules pane.
Step 2
Click the Filter by link and choose Automation Pack > [Automation Pack Name] to filter for only the
task rules that ship with the specific automation pack.
Figure 3-1
Definitions—Task Rules View
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-10
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
The following information about the task rules displays by default:
Column
Description
Display Name
The name assigned to the task rule.
Enabled
Indicates whether the task rule is enabled (True) or
disabled (False). A disabled task rule is unavailable for
execution.
Type
Type of task.
Owner
User name of the person or group who assigned the task
rule.
Last Modified Time
The date and time the task rule was last modified.
Last Modified By
The object or user name that last modified the task rule.
Id
Unique ID of the task rule.
Description
Brief description of the task rule.
Type Description
Brief overview of the task rule type.
Created Time
Time at which the task rule was created.
Created Date
Date the task rule was created.
Automation Pack
Name of the automation pack associated with the task rule.
Configuring Task Rules
Use the Task Rules view to configure the task rule that ships with the Core Automation for SAP
automation pack.
SAP Default Assignment
The Core Automation for SAP automation pack ships with the Default SAP Assignment task rule, which
is used to specify the default user or group who will be assigned all SAP-related incidents unless
otherwise specified in task rules. This task rule can be configured during the import process on the
Default Incidents Assignee Setup panel or from the Task Rules view in the Console.
Step 1
In the Definitions workspace, click Task Rules in the navigation pane to display the task rules in the
results pane.
Step 2
Click the Filter by link and choose Automation Pack, and then choose Core Automation for SAP from
the drop-down list to display the task rules that ship with the automation pack.
Step 3
Right-click the SAP Default Assignment task rule and choose Properties to open the SAP Default
Assignment Properties dialog box.
Step 4
Click the Assign tab to specify the user or group that should receive assignments for incidents and alerts
generated by the processes.
Step 5
On the Assign tab, click Add to open the Select Assignee to Add dialog box.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-11
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Figure 3-2
Step 6
Adding Assignees to Task Rule
On the Select Assignee to Add dialog box, specify the assignees using one of the following methods:
•
Click the Reference
tool to select the appropriate variable reference containing the assignee or
list of assignees from the Insert Variable Reference dialog box.
•
Click the Browse
assignees.
tool to launch the Select User or Group dialog box to add user to the list of
Step 7
Click OK to add the assignee to the task rule.
Step 8
When you have completed adding assignees to the task rule, click OK to close the dialog box.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-12
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Creating a New Task Rule
Use the Task Rules view to create a new task rule. The procedure is the same for all types of task rules
with the exception of the task-specific tab (Assign, Notify, Update) for the type of task rule you are
creating.
Note
Only users with administrative rights can create task rules in TEO.
You can create the following types of task rules:
Step 1
Task Rules
Description
Assign Task Rule
Assigns users to a task.
Notify Task Rule
Notifies users that a task has been created.
Update Task Rule
Specifies the properties to be updated in a task..
In the Definitions workspace, right-click Task Rules and choose New > [Task Rule Type] to open the
New Rule Properties dialog box.
Figure 3-3
New Rule Properties Dialog Box—General Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-13
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Step 2
On the General tab, enter the following information:
Field
Description
Display Name
Name of the task.
Type
Display only. Shows the type of object.
Trigger
Display only. Type of trigger associated with the task
rule.
Owner
User name of the owner of the task rule. This is
typically the person who created the task rule.
Click the Browse
tool to launch the Select User or
Group dialog box to change the owner.
Description
A brief description of the task rule.
Enabled
The check box is checked by default to indicate that the
task rule is available for execution.
Uncheck the check box to disable the task rule. If the
check box is unchecked, the task rule is disabled and
will be unavailable for execution.
Step 3
Click the Task Types tab to specify the types of tasks to be executed by the rule.
Figure 3-4
New Rule Properties Dialog Box—Task Types Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-14
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Step 4
Step 5
Check the check box for the type of task that will execute the rule.
Task Type
Description
Alert
Alerts reflect potential problems that a user may want to
investigate and possibly diagnose the problem.
Approval Request
Specifies the message and choices for the assignee who is
approving the task.
Guided Operation
Details the steps a user takes to complete an assigned task.
Incident
Task requires an operator to take action in order to resolve
an issue.
Input Request
Task requires input from an individual or group.
Review
Task assigns a document for review.
Click the Conditions tab to specify the conditions of when the task rule action is to be taken based on
an evaluation of the defined conditions.
Note
The Required Value
is missing a value.
Figure 3-5
Step 6
icon displayed on a tab or page indicates that the field is required and
New Rule Properties Dialog Box—Conditions Tab
On the Conditions tab, define the conditions that must be met for the rule to execute.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-15
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Defining a Basic Condition:
a.
On the Basic page, click New to add a new property for the condition that must be met.
Figure 3-6
New Rule Properties Dialog Box—Basic Condition
b.
In the Property text field, click the Reference
tool to choose a defined variable or reference an
object on the Insert Variable Reference dialog box.
c.
Choose the condition expression from the drop-down list.
d.
Enter the condition description in the text box or click the Reference
tool to choose a defined
variable or reference an object on the Insert Variable Reference dialog box.
e.
Click New to define additional properties, if necessary.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-16
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Defining an Advanced Condition:
a.
Click the Advanced tab to define a specific type of condition (Compound, Prior Process Instance,
Time, or Variable).
Figure 3-7
b.
New Rule Properties Dialog Box—Advanced Condition
Click the link to modify the option for the condition equation.
Option
Description
AND condition (all conditions must be
met)
Click this option if an action is to be taken only when all
conditions in the list are true.
OR condition (one condition must be met) Click this option if an action is to be taken when one
condition in the list is true.
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.
Note
e.
Step 7
Click NewClick the Reference
tool to choose a defined variable or reference an object
on the Insert Variable Reference dialog box.
Click New to define additional properties, if necessary.
Click the task rule specific tab (Assign, Notify, or Update) and specify the relevant information for the
specific type of rule.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-17
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Assign Task Rule
If you are creating an Assign Task Rule, the Assign tab displays on the New Rule Properties dialog box.
Figure 3-8
New Rule Properties Dialog Box—Assign Tab
On the Assign tab, specify the assignees for task rule.
Field
Description
Add
Click this button to launch the Select Assignee to Add
dialog box to specify the assignees.
On the Select Assignee to Add dialog box, use one of
the following methods to specify the assignee:
•
Click the Reference
tool to select the
appropriate variable reference containing the
assignee or list of assignees from the Insert
Variable Reference dialog box.
•
Click the Browse
tool to launch the Select User
or Group dialog box and add user to the list of
assignees.
Edit
Select the appropriate assignee in the list and click this
button to view or modify the assignee of the task rule.
Remove
Select the appropriate assignee and click this button to
remove the assignee from the list.
Remove All
Click this button to remove all specified assignees from
the list.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-18
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Notify Task Rule
If you are creating a Notify Task Rule, the Notify tab displays on the New Rule Properties dialog box.
Figure 3-9
New Rule Properties Dialog Box—Notify Tab
On the Notify tab, specify the recipients of the notification that the task rule has executed. You can add
individual recipients or include a notification recipient list.
Field
Description
Add notification recipients
Displays list of users to be notified by the task rule.
•
Add—Click this button to launch the Select
Notification Recipient to Add dialog box to specify
the recipients.
On the dialog box, enter the email address for the
recipient or click the Reference
tool to select the
appropriate variable reference containing the recipient
or list of recipients from the Insert Variable Reference
dialog box and then click OK.
Add notification recipient list
•
Edit—Select the appropriate recipient in the list and
click this button to view or modify the recipient of the
task rule.
•
Remove—Select the appropriate recipient in the list
and click this button to remove the recipient from the
list.
•
Remove All—Click this button to remove all specified
recipients from the list.
Click the Reference
tool to select the appropriate
variable reference containing list of recipients from the
Insert Variable Reference dialog box.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-19
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Update Task Rule
If you are creating an Update Task Rule, the Update tab displays on the New Rule Properties dialog box.
Figure 3-10
New Rule Properties Dialog Box—Update Tab
On the Update tab, specify the properties to be updated after the task rule has executed.
Field
Description
Add
Click this button to add a new property to the Properties
to update area.
Remove
Click this button to remove the last property added to
the Properties to update area.
Property
From the Property drop-down list, choose the item to
update within the task. The properties displayed depend
on the selected item.
List action
Choose the appropriate item from the drop-down list to
determine which action to take with the selected
property:
Value
Step 8
•
Add Item—Adds item to task.
•
Remove item—Removes item from task.
•
Clear—Removes property value from task.
Enter new value for the property.
Click OK to save the task rule definition and close the dialog box.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-20
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Managing Task Rule Definitions
This section provides instructions on modifying task rules in the Definitions—Task Rule view. Only
users with administrative rights or authoring rights can modify task rules in TEO.
Note
For additional information on managing task rules, see the Tidal Enterprise Orchestrator Reference
Guide.
Enabling a Task Rule
A task rule is enabled by default. If a task rule is manually disabled, the task rule must be enabled before
it is available for execution.
On the Definitions—Task Rules view, select the task rule and then use one of the following methods to
enable it:
•
On the Results pane, right-click and choose Enable.
-or-
•
On the Details pane, select Click here to enable.
The Enabled column on the Results pane changes to True. If necessary, click the Refresh
update the view.
tool to
Disabling a Task Rule
Disabling a task rule prevents the item from being available for execution. The disabled task rule is not
removed from the list of task rules on the Definitions—Task Rules Results pane.
On the Definitions—Task Rule view, select the task rule and then use one of the following methods to
disable it:
•
On the Results pane, right-click and choose Disable.
-or-
•
On the Details pane, select Click here to disable.
The Enabled column on the results pane changes to False. If necessary, click the Refresh
update the view.
tool to
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-21
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Creating a Copy of a Task Rule
The copy option is used when the user wants to leverage an existing task rule to define a new task rule
using existing properties.
Step 1
On the Definitions—Task Rules view, select the appropriate task rule, right-click and choose Copy.
Step 2
On the Results pane, right-click and choose Paste.
A copy of the defined task rule is pasted onto the Results pane.
Step 3
To rename the copied task rule or other properties, right-click and choose Properties.
Step 4
Modify the task rule name, as appropriate, and click OK to close the dialog box.
Sorting Task Rules
The task rules are executed according to the order they are listed on the Definitions—Task Rules view.
You should sort the task rules based on the order in which you want them to execute.
Note
All task rules will execute even if there is more than one task rule assigned for the same condition. For
example, if you have two assignment rules for the same incident, both rules will be executed in the order
listed in the Task Rules view.
On the Definitions—Task Rules view, select the task rule and use one of the following methods to move
it to the desired position in the list:
•
Drag and drop the task rule into the appropriate position in the list.
•
On the Actions toolbar, click Move Up or Move Down.
•
Click the Actions menu and choose Move Up or Move Down.
•
Right-click and choose Move Up or Move Down.
The list of task rules are sorted according to the selected action.
Deleting a Task Rule
Use the Definitions—Task Rules view to delete task rules that are no longer used.
Step 1
On the Definitions—Task Rules view, select the task rule, right-click and choose Delete.
Step 2
On the Confirm Delete dialog box, click Yes to confirm the deletion.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-22
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Using Task Rules for Assignments and Notifications
Enabling Notification Based on Assignment Processes
If you want to have emails sent to whoever is assigned to a task but do not want to create notification
task rules, you can enable the processes that ship with the Core automation pack that send emails based
on assignment.
When these processes are enabled, the user or user group who was assigned to tasks will receive the
email notification.
Step 1
In the Definitions workspace, click Processes.
Step 2
Click the Filter by link and choose Automation Pack > Core to filter for the processes that ship with
the Core automation pack.
Step 3
Right-click the appropriate Notification Based on Assignment process and choose Enable.
The following processes are for notification based on assignment:
Process Name
Description
Default Alert Notification Based on
Assignment
Sends email when an alert gets assigned.
Default Approval Request Notification
Based on Assignment
Sends email when an approval request gets assigned.
Default Change Request Notification
Based on Assignment
Sends email when an change requests gets assigned.
Default Guided Operation Request
Notification Based on Assignment
Sends email when a guide operation request gets assigned.
Default Incident Notification Based on
Assignment
Sends email when an incident gets assigned.
Default Input Request Notification Based Sends email when an input request gets assigned.
on Assignment
Default Review Request Notification
Based on Assignment
Send email when a review request gets assigned.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-23
Chapter 3
Getting Started Using the Automation Pack
Managing Extended Target Properties
Managing Extended Target Properties
The Automation for SAP BW and BWA processes use extended target properties to override certain
variable properties assigned to targets. For example, extended target properties can be used to specify a
different target when certain conditions occur.
This section provides information on configuring extended target properties.
Accessing Extended Target Properties
The extended target properties that ship with the Automation for SAP BW and BWA automation pack
can be accessed from the Definitions—Extended Target Properties view.
Step 1
On the Console, select the Definitions workspace and click Extended Target Properties in the
navigation pane. By default, all the properties display in the Extended Target Properties pane.
Figure 3-11
Definitions—Extended Target Properties View
The following information about the extended target properties displays by default:
Column
Description
Display Name
Name of the target property.
Description
Text description of the target property.
Value
Value assigned to the target property.
Data Type
Type of value being used for the target property
(Boolean, Encrypted String, Identity, Numeric, String,
Table).
Automation Pack
Name of the automation pack that provides the target
property.
Customizable
Indicates the customization setting for the target
property in the automation pack.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-24
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Managing Extended Target Properties
Step 2
Column
Description
Target Types
Indicates the targets associated with the target property.
Last Modified Time
Date and time the variable was last modified.
Last Modified By
Name of the user who last modified the target property.
Id
Unique ID of the target property.
Owner
User name of the owner of the target property. This is
typically the person who created the target property.
Created Time
Date and time the target property was created.
Created By
User name of the person who created the target
property.
Click the Filter by link and choose Automation Pack > Automation for SAP BW and BWA to filter
for only the extended target properties that ship with the specific automation pack.
Configuring Extended Target Properties
You use the Extended Target Properties Properties dialog box to view or modify the target property. You
access the properties from the Definitions—Extended Target Properties view.
The following section provides information on configuring extended target properties that ship with the
Automation for SAP BW and BWA automation pack.
Step 1
On the Extended Target Properties pane, right-click [Extended Target Property] and choose
Properties.
Figure 3-12
Step 2
Extended Target Properties—General Tab
On the General tab, review the information in the Description field to determine the values that need to
be specified for the target property.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-25
Chapter 3
Getting Started Using the Automation Pack
Managing Extended Target Properties
Step 3
Click the Value tab to view or modify the default value for all targets.
Note
The tab in the second position will depend on the variable type. See the Tidal Enterprise
Orchestrator Reference Guide for instructions on configuring the different types of target
properties.
Figure 3-13
Extended Target Properties—Value Tab
Step 4
Click in the cell to specify the default value or change the default value for all SAP targets.
Step 5
Click the Target Values tab to specify the targets that should be used to override the default value.
Figure 3-14
Step 6
Extended Target Properties—Target Values Tab
Click New to add a new target override.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-26
OL-24784-01
Chapter 3
Getting Started Using the Automation Pack
Managing Extended Target Properties
Figure 3-15
Step 7
Target Property Value Dialog Box
On the Target Property Value dialog box, click Add to choose the target (SAP system) to be used for the
override value. This is the SAP system that will be monitored for a value other than the default value.
Figure 3-16
Select Target(s) Value Dialog Box
Step 8
Select the SAP system and click OK.
Step 9
On the Target Property Value dialog box, enter the information in the Value area to be used for the
specified target and then click OK.
The target override displays on the Target Values tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
3-27
Chapter 3
Getting Started Using the Automation Pack
Managing Extended Target Properties
Figure 3-17
Step 10
Extended Target Properties—Target Values Tab with Override
Click OK to close the dialog box and save your changes.
Note
The Target Types tab is only available if you have explicit rights to the object. See the Tidal
Enterprise Orchestrator Reference Guide for information on using this property page.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
3-28
OL-24784-01
CH A P T E R
4
Managing Automation for SAP BW and BWA
Processes
This chapter provides information on using the product, specific to the Automation for SAP BW and
BWA automation pack. It includes information on accessing the Automation for SAP BW and BWA
processes and filtering for specific processes, managing the SAP BW and BWA processes, starting a
process, and viewing a running process, its results, and the automation summary generated by the
process.
It includes the following sections:
Note
•
Accessing Automation for SAP BW and BWA Processes, page 4-2
•
Managing SAP Processes, page 4-3
•
Running Processes, page 4-9
•
Viewing Process Results, page 4-13
•
Viewing Automation Summary, page 4-17
Before you can run the Automation for SAP BW processes, you must configure the objects that are
referenced by the processes and activities. See the Cisco TEO Getting Started Guide for SAP for
information on configuring the SAP-related objects in TEO.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-1
Chapter 4
Managing Automation for SAP BW and BWA Processes
Accessing Automation for SAP BW and BWA Processes
Accessing Automation for SAP BW and BWA Processes
The processes that ship with the product can be accessed from the Definitions—Processes view.
Step 1
On the Console, select the Definitions workspace and click Processes in the navigation pane. By default,
all the processes display in the Processes pane.
Figure 4-1
Processes View
If you have multiple automation packs installed, you can filter the processes to display the processes
specific to the automation pack.
Step 2
In the upper portion of the Processes pane, click the Filter by link and choose Automation Pack.
Step 3
In the drop-down list, choose Automation for SAP BW and BWA.
Figure 4-2
Filtering Processes by Automation Pack
The processes display in the Processes pane.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-2
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Managing SAP Processes
Filtering Processes by Category
You can also filter the processes by category to find a specific process.
Step 1
In the upper portion of the Processes pane, click the Filter by link and choose Category.
Step 2
In the drop-down list, choose SAP BW.
Step 3
Scroll to the process.
Managing SAP Processes
This section provides information on managing the SAP BW and BWA processes, including:
•
Enabling and disabling processes
•
Enabling and disabling the process archival feature
•
Modifying a process schedule
Enabling a Process
Some of the processes that ship with the automation packs are disabled by default to reduce the load on
the server. These processes must be enabled before the other processes can be successfully executed.
Perform the following steps to enable a process.
Step 1
In the Processes view, navigate to the process that you want to enable (disabled processes appear
dimmed).
Step 2
Use one of the following methods to enable the process:
•
Right-click the process and choose Enable from the submenu.
•
In the Process Editor, click the General tab and then check the Enabled check box. Click the Save
tool to save your changes to the process and close the Process Editor.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-3
Chapter 4
Managing Automation for SAP BW and BWA Processes
Managing SAP Processes
Disabling a Process
Disabling a process prevents the process from executing. You may want to disable some processes to
reduce the load on your server or while you are modifying the process definition.
Perform the following steps to disable a process.
Step 1
In the Processes view, navigate to the process that you want to disable.
Step 2
Use one of the following methods to disable the process:
•
Right-click the process and choose Disable from the submenu.
•
In the Process Editor, click the General tab and then uncheck the Enabled check box. Click the
Save
tool to save your changes to the process and close the Process Editor.
Modifying Process Instance Archival
TEO provides an option in the process definition that allows you to choose whether or not to archive
process and activity execution in the TEOProcess database. Disabling the Archive completed instances
option helps improve performance and minimizes the size of the database. It is also useful when
debugging the execution of processes.
The automation packs shipped by Cisco normally have the archival functionality disabled by default for
the SAP processes. If you want to view the execution of a process and its activities, or view the process
instances after a process has completed, you must enable the archival functionality in the process
definition.
Perform the following steps to enable or disable the archival feature.
Step 1
In the Processes view, navigate to the process you want to flag for archival.
Step 2
Right-click the process and choose Edit from the submenu.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-4
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Managing SAP Processes
Figure 4-3
Step 3
On the process Properties dialog box, click the Options tab.
Figure 4-4
Step 4
Opening a Process to Edit Properties
Process Properties—Options Tab
On the Options tab, check the Archive completed instances check box to enable process instance
archival.
If the process is already flagged for archival and you no longer want to save the process instances for
this process, uncheck the check box.
Step 5
Click the Save
tool to save your changes to the process and close the process Editor.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-5
Chapter 4
Managing Automation for SAP BW and BWA Processes
Managing SAP Processes
Modifying a Process Schedule
Many of the processes that ship with the automation packs are triggered by a schedule. You can modify
when the process will be executed by disabling the existing schedule and then creating a new schedule
for the process. You use the process Properties dialog box to modify the process schedule.
Perform the following steps to assign a new schedule to a process.
Step 1
In the Processes view, navigate to the process that you want to modify.
Step 2
Right-click the process and choose Edit from the submenu (see Figure 4-3 on page 4-5).
Step 3
On the process Properties dialog box, click the Triggers tab.
Figure 4-5
Process Properties—Triggers Tab
Step 4
On the Triggers tab, right-click the current Schedule and choose Disable from the submenu.
Step 5
Click New > Schedule to open the Schedule Properties dialog box to create a new schedule for this
process.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-6
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Managing SAP Processes
Figure 4-6
Step 6
Schedule Properties
On the Schedule Properties dialog box, specify the criteria for the new schedule and click OK.
Note
For information on creating schedules, see “Managing Triggers” in the Tidal Enterprise
Orchestrator Reference Guide.
The newly created schedule displays on the Triggers tab and is enabled.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-7
Chapter 4
Managing Automation for SAP BW and BWA Processes
Managing SAP Processes
Figure 4-7
Step 7
Click the Save
Process Properties—Triggers Tab with Newly Created Schedule
tool to save your changes to the process and close the Process Editor.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-8
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Running Processes
Running Processes
The processes that ship with the product will run based on the trigger that was defined in the process
definition. For processes that are triggered by a schedule, you can also manually start the process at any
time (adhoc). This section guides you through starting the BW Checklist process and viewing its
progress as it runs.
Note
You can only view a running process and the process instances for processes that have the Archive
completed instances feature enabled. See Modifying Process Instance Archival, page 4-4 for
information on enabling the archival feature on a specific process.
Starting a Process
Step 1
In the Processes view, right-click the BW Checklist process and choose Start Process.
Figure 4-8
Starting a Process
The Confirm Start Process dialog box displays.
Figure 4-9
Confirm Start Process
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-9
Chapter 4
Managing Automation for SAP BW and BWA Processes
Running Processes
This process is defined to run on systems in the All SAP ABAP target group. In this example, we will
override the default target and select a specific system on which to run the process.
Step 2
On the Confirm Start Process dialog box, check the Override target (All SAP ABAP) check box to
expand the fields on the dialog box.
Figure 4-10
Specifying Target Override
Step 3
Click the Target radio button and then click the Browse
tool to open the Select Target dialog box.
Step 4
Select the target in the list and then click OK.
Step 5
On the Confirm Start Process dialog box, click OK to start the process.
The Start Process Results dialog box displays. Proceed to Viewing Running Process, page 4-11.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-10
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Running Processes
Viewing Running Process
After starting the process, you can use the Process Viewer to view the process as it runs through each
activity.
Note
Step 1
You can only view a running process and the process instances for processes that have the Archive
completed instances feature enabled. See Modifying Process Instance Archival, page 4-4 for
information on enabling the archival feature on a specific process.
On the Start Process Results dialog box, right-click the process and choose Observe.
Figure 4-11
Start Process Results—Observe Menu
The Process Viewer displays the process workflow.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-11
Chapter 4
Managing Automation for SAP BW and BWA Processes
Running Processes
Figure 4-12
Step 2
Process Viewer—Viewing BW Checklist Process Running
View the process as it proceeds through the workflow.
The activities within the process workflow will change to green as they complete (succeed). If an activity
fails, an incident is created.
Step 3
When the process completes, close the Process Viewer and proceed to Viewing Process Results,
page 4-13.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-12
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Viewing Process Results
Viewing Process Results
After a process completes, you can view the results in the Operations workspace. This section guides
you through viewing the results from running the BW Checklist process.
Note
You can only view a running process and the process instances for processes that have the Archive
completed instances feature enabled. See Modifying Process Instance Archival, page 4-4 for
information on enabling the archival feature on a specific process.
Accessing Process View
Step 1
On the Console, select the Operations workspace.
Step 2
In the navigation pane, expand Process Views and click View Adhoc (since the BW Checklist process
was manually executed).
Step 3
Using the Filter by link, choose Category and then choose SAP BW from the drop-down list.
Step 4
Scroll to the BW Checklist process and select it.
Step 5
In the View Results pane, expand the BW Checklist process to view each activity in the process
workflow.
Figure 4-13
Step 6
Operations Workspace—Viewing Process Results
Review the status of the process and each activity within the process to verify that it has succeeded.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-13
Chapter 4
Managing Automation for SAP BW and BWA Processes
Viewing Process Results
Viewing Activity Results
You can view the results of a specific activity within the process using the Activity Instance Properties
dialog box. In this example, we will view the results of the Get Database Type activity, which retrieves
information about the SAP database associated with the SAP system.
Step 1
In the View Results pane, scroll to the Get Database Type activity.
Step 2
Right-click Get Database Type and choose Properties.
Figure 4-14
Step 3
On the Get Database Type Properties dialog box, click the Values tab.
Figure 4-15
Step 4
Activity Properties Submenu
Get Database Type Properties—Values Tab
When you have completed reviewing the results, click Close to close the dialog box.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-14
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Viewing Process Results
Viewing Incidents
When a process detects an issue that requires action, an incident is generated. If you have configured the
product to send notifications to a specific person in your organization, that person will receive an email
notification whenever an incident is generated. You can also view these incidents in the Task Views on
the Operations workspace.
In this example, we will view the incidents that were generated from the BW Checklist process.
Step 1
On the Operations workspace, expand Task Views in the navigation pane and click View Incidents.
Step 2
In the View Incidents pane, click the View all tasks from the Task Assignee drop-down list to display
all the incidents in the View Results pane.
Figure 4-16
Step 3
Viewing Incidents
To view a specific incident, right-click the incident and choose Open.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-15
Chapter 4
Managing Automation for SAP BW and BWA Processes
Viewing Process Results
Figure 4-17
Incident Open Submenu
The Incident Report displays in your web browser.
Figure 4-18
Tidal Enterprise Orchestrator Incident Report
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-16
OL-24784-01
Chapter 4
Managing Automation for SAP BW and BWA Processes
Viewing Automation Summary
Viewing Automation Summary
When incidents are generated, TEO delivers an online Automation Summary that details the analysis that
was performed to identify a situation that may require action. It also shows relevant diagnostic and state
information captured while performing the situation analysis, and provides a recommended resolution
for the situation.
You can access the Automation Summary from the Tasks View on the Operations workspace.
Step 1
On the Operations workspace, expand Task Views in the navigation pane and click View Incidents.
Step 2
In the View Incidents pane, click the View all tasks radio button to display the incidents in the View
Results pane.
Step 3
Right-click BW Checklist and choose View Automation Summary.
Figure 4-19
View Automation Summary Submenu
The Automation Summary displays in your web browser.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
4-17
Chapter 4
Managing Automation for SAP BW and BWA Processes
Viewing Automation Summary
Figure 4-20
Automation Summary
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
4-18
OL-24784-01
A P P E N D I X
A
Installing TEO SAP Monitoring Management
Pack In SCOM
Tidal Enterprise Orchestrator (TEO) can be installed on the Microsoft System Center Operations
Manager 2007 (SCOM) management framework if you are using this framework to monitor all incidents
from a central location in your environment.
This appendix guides you through configuring your SCOM environment and importing the TEO SAP
Monitoring management pack. It includes the following sections:
•
Prerequisites, page A-1
•
Configuring the SCOM Environment, page A-2
•
Importing Management Pack, page A-9
•
Enabling SAP Alerts on Windows Event Log Process, page A-16
Prerequisites
The following prerequisites should be met to successfully run TEO automation packs with the SCOM
management framework:
Prerequisite
Description
Software Requirements
Microsoft System Center Operations A SCOM agent should be installed on the TEO server prior
Manager 2007 SP1 or R2
to importing the management packs.
Windows Powershell v1.0 or later
Must be installed on the TEO server
SCOM Server Requirements
Note
Security settings
The SCOM agent on the TEO server must be configured to
allow the agent to act as a proxy.
Run As Account
A Run As Account should be created for the server where
the TEO Process database resides and then distributed to
the TEO server.
The procedures in this chapter are for System Center Operations Manager 2007 R2. If you have an earlier
version (OM 2007 SP1) installed, the procedures and screenshots will be slightly different.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-1
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Configuring the SCOM Environment
Configuring the SCOM Environment
It is recommended that you perform some setup tasks prior to importing the management packs. This
section guides you through configuring the security settings to allow the agent to act as a proxy, creating
a Run As Account for the TEO Process database, and associating the Run As Account with a Run As
Profile in the SCOM Administration view.
Configuring Security Settings
When TEO is installed on a SCOM agent, the agent security settings need to be configured to allow the
agent to act as a proxy so that the SAP class instances can be discovered.
Step 1
In the Operations Console Administration view, navigate to Device Management and click the Agent
Managed node.
Step 2
In the results pane pane, right-click the management server and choose Properties.
Step 3
On the Agent Managed Server Properties dialog box, click the Security tab.
Step 4
Under Server Proxy, check the check box to allow this server to act as a proxy.
Step 5
Click OK to close the dialog box.
Step 6
Restart the agent HealthService to implement the changes.
Creating A Run As Account
It is recommended that you create a Run As Account for the server where the TEO Process database
resides prior to installing the management pack. The account must have Read permissions on the TEO
Process database.
Step 1
In the Administration view, navigate to the Run As Configuration node.
Step 2
Right-click Accounts and choose Create Run As Account.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-2
OL-24784-01
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Configuring the SCOM Environment
Figure A-1
Create Run As Account Submenu
The Create Run As Account wizard Introduction panel displays.
Figure A-2
Step 3
Create Run As Account—Introduction
Click Next to display the General Properties panel.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-3
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Configuring the SCOM Environment
Figure A-3
Create Run As Account—General Properties
Use this panel to specify the Run As Account type, name for the account and an optional description for
the account.
Step 4
Step 5
Specify the information in the following fields:
Field
Description
Run As Account type
Indicates the type of authentication that the account
provides. Choose Windows from the drop-down list.
Display name
Enter a name for the account.
Description
Optional. Enter a text description of the account.
Click Next to display the Credentials panel.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-4
OL-24784-01
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Configuring the SCOM Environment
Figure A-4
Step 6
Step 7
Create Run As Account—Credentials
Use the Credentials panel to specify attributes of the account that you are creating:
Field
Description
User name
Enter the name of the domain or local user account.
Password
Enter the password for the user account.
Confirm password
Re-enter the user account password to confirm it.
Domain
Choose the domain of the user account from the drop-down
list.
Click Next to display the Distribution Security panel.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-5
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Configuring the SCOM Environment
Figure A-5
Step 8
Click the More secure radio button and then click Create.
Figure A-6
Step 9
Create Run As Account—Distribution Security
Create Run As Account—Completion
On the Completion panel, click Close to exit the wizard.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-6
OL-24784-01
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Configuring the SCOM Environment
Distributing Run As Account
You must now distribute the Run As Account to the TEO server.
Step 1
In the Administration view, expand the Run As Configuration node and click Accounts.
Step 2
In the Accounts pane, right-click TEOProcess Database Access Account and choose Properties.
Figure A-7
Step 3
Run As Account Properties Submenu
On the Run As Account Properties dialog box, click the Distribution tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-7
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Configuring the SCOM Environment
Figure A-8
Step 4
Click Add to add the computer where the TEOProcess database resides.
Figure A-9
Step 5
Run As Account Properties—Distribution Tab
Computer Search
Enter the appropriate search options and then click Search to find the computer where the TEO service
is installed.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-8
OL-24784-01
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Importing Management Pack
Step 6
In the Available items pane, select the computer that you want to add to the Selected objects list and then
click OK.
The computer displays on the Distribution tab of the Run As Account Properties dialog box.
Step 7
Click OK to complete the procedure.
Importing Management Pack
You are now ready to import the management pack for SAP monitoring.
Step 1
In the Administration view, right-click Management Packs and choose Import Management Packs.
Figure A-10
Import Management Packs Submenu
The Import Management Packs wizard opens.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-9
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Importing Management Pack
Figure A-11
Step 2
On the Select Management Packs panel, click Add and choose Add from disk.
Figure A-12
Step 3
Import Management Packs—Select Management Packs
Select Management Packs to Import
On the Select Management Packs to import dialog box, navigate to the folder where the managment
packs were extracted during the Automation Pack Import process. By default, the files are stored in the
following directory:
C:\Documents and Settings\User\My Documents\Cisco\Tidal Enterprise Orchestrator\Management
Packs
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-10
OL-24784-01
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Importing Management Pack
Step 4
Select the following management pack files and click Open:
•
Cisco.TEO.Library.mp
•
Cisco.TEO.Monitoring.SAP.mp
Note
Step 5
The wizard will inform you if additional management packs are required to complete the import.
Locate these management packs on your SCOM installation media or SCOM install directory
(%ProgramFiles%\System Center Operations Manager 2007).
On the Import Management Packs panel, click Install.
Figure A-13
Step 6
Import Management Packs—Import Management Packs
Once the management packs are imported and the Status column displays Imported, click Close to exit
the wizard.
You must now configure the profile for the TEOProcess Database Access Account. Proceed to Creating
a Profile for TEOProcess Database Run As Account, page A-12.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-11
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Importing Management Pack
Creating a Profile for TEOProcess Database Run As Account
After the management packs are imported, you must associate the Run As Profile with the Run As
Account created earlier for the TEOProcess database.
Step 1
In the Administration view, expand the Run As Configuration node and click Profiles.
Step 2
In the Profiles pane, right-click the profile for the TEOProcess Database (TEOProcess Database Access
Account) and choose Properties.
Figure A-14
Accessing TEOProcess Database Profile Properties
The Run As Profile wizard opens. You use this wizard to assign a Run As Account that has the necessary
privileges for the Run As Profile.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-12
OL-24784-01
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Importing Management Pack
Figure A-15
Step 3
On the Introduction panel, click Next.
Figure A-16
Step 4
Run As Profile—Introduction
Run As Profile—General Properties
On the General Properties panel, click Next.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-13
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Importing Management Pack
The Run As Accounts panel displays. Use this panel to add the TEO Process Database Run As Account
to this Run As Profile.
Step 5
Click Add to open the Add a Run As Account dialog box.
Figure A-17
Run As Profile—Run As Accounts—Adding a Run As Account
Step 6
On the Add a Run As Account dialog box, choose TEO Process Database Access Account from the
drop-down list.
Step 7
Click the All targeted objects radio button and then click OK.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-14
OL-24784-01
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Importing Management Pack
Figure A-18
Step 8
Run As Profile—Run As Accounts with Account Added
On the Run As Accounts panel, click Save.
Figure A-19
Run As Profile—Completion
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
A-15
Appendix A
Installing TEO SAP Monitoring Management Pack In SCOM
Enabling SAP Alerts on Windows Event Log Process
Step 9
On the Completion panel, click the TEO Process Database Access Account link in the More-secure
Run As accounts pane to update the distribution of the credentials. When distribution has been verified,
the warning symbol changes to a green checkmark.
Step 10
Click Close to exit the wizard and complete the procedure.
Enabling SAP Alerts on Windows Event Log Process
The SAP Alerts on Windows Event Log process is disabled by default in TEO. To receive alerts in
SCOM, you must enable this process in TEO.
Step 1
On the Console Definitions workspace, click Processes in the navigation pane.
Step 2
Click the Filter by link and choose Automation Pack > Core SAP Automation to display the
processes.
Step 3
Right-click the Publish SAP Alerts on Windows Event Log process and choose Enable.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
A-16
OL-24784-01
A P P E N D I X
B
Installing the SPI for HP OpenView
Tidal Enterprise Orchestrator (TEO) can be integrated with HP Openview (HPOV) if you are using this
framework to monitor all alerts from a central location in your environment.
This appendix guides you through installing the TEO modules for HPOV, configuring the HPOV services
and deploying the policies. It includes the following sections:
•
Prerequisites, page B-1
•
Installing TEO HP OpenView SPI, page B-2
•
Configuring HP OpenView, page B-5
•
Enabling SAP Alerts on Windows Event Log Process, page B-9
Prerequisites
The following prerequisites should be met to successfully run TEO automation packs with the HPOV
management framework:
Prerequisite
Description
HP OpenView Operations for Windows® To integrate with HP Open View, you must have the HP
Version 7.x or later
OpenView agent installed and configured prior to installing
TEO.
For information on installing HP OpenView, refer to the
documentation that shipped with the product or visit the
HP web site at www.hp.com. A should be installed on the
TEO server prior to importing the management packs.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
B-1
Appendix B
Installing the SPI for HP OpenView
Installing TEO HP OpenView SPI
Installing TEO HP OpenView SPI
Note
The procedures in this chapter are for HP OpenView v7.2. If you have an earlier version installed, the
procedures and screenshots may be different.
If you are using HP OpenView to monitor alerts in your environment, you must install the SPI for TEO
Incident Analysis for SAP on the HP OpenView management framework using the SPI for TEO Incident
Analysis Setup wizard.
Step 1
On the Tidal Enterprise Orchestrator installation CD, navigate to the ManagementFramework >
HPOV folder and double-click TEASAPSPI.msi to open the SPI for TEO Incident Analysis for SAP
Setup wizard.
Figure B-1
Step 2
Welcome to the SPI for TEO Incident Analysis for SAP Setup Wizard
On the Welcome panel, click Next.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
B-2
OL-24784-01
Appendix B
Installing the SPI for HP OpenView
Installing TEO HP OpenView SPI
Figure B-2
Step 3
On the End-User License Agreement panel, click the I accept the terms in the License Agreement
radio button and then click Next.
Figure B-3
Step 4
End-User License Agreement
Choose Setup Type
On the Choose Setup Type panel, click one of the following setup options:
•
Typical—Installs the most common program features (recommended for most users).
•
Custom—Allows you to choose which program features will be installed and where they will be
installed (recommended for advanced users.
•
Complete—All program features will be installed (requires the most disk space).
Note
The following steps are for a Typical setup.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
B-3
Appendix B
Installing the SPI for HP OpenView
Installing TEO HP OpenView SPI
Figure B-4
Step 5
On the Ready to Install panel, click Install to begin the installation.
Figure B-5
Step 6
Ready to Install
Completing SPI for TEO Incident Analysis for SAP Setup Wizard
On the Completing panel, click Finish.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
B-4
OL-24784-01
Appendix B
Installing the SPI for HP OpenView
Configuring HP OpenView
Configuring HP OpenView
You must now configure the services and deploy the policies in HP OpenView.
Configuring Services
You must configure the Services in the HP OpenView Operations Console with your system information.
This enables you to view incidents for individual systems instead of a combined view of all incidents.
Step 1
Open the HP OpenView Operations Console and navigate to the Services > Applications container.
Step 2
Right-click TEO for SAP and choose Configure > Services from the submenus.
Figure B-6
Step 3
Configure Services Submenus
On the Configure Services dialog box, expand the Applications > TEO for SAP > SAP Systems
containers.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
B-5
Appendix B
Installing the SPI for HP OpenView
Configuring HP OpenView
Figure B-7
Step 4
Configure Services
Click the Alerts container and then click Add Component.
Figure B-8
New Component Service
Step 5
From the Service Type drop-down list, choose Application Services.
Step 6
In the Display Name text field, enter the name of the system.
Step 7
In the ServiceID text field, enter TEOSAPAlerts<space>SAP system name (for example, enter
TEOSAPAlerts R47) and then click OK.
The newly added component displays on the Configure Services dialog box under Alerts.
Step 8
Click Apply.
Step 9
On the Configure Services dialog box, click Reports.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
B-6
OL-24784-01
Appendix B
Installing the SPI for HP OpenView
Configuring HP OpenView
Figure B-9
Step 10
Configure Services—Reports
Click Add Component.
Figure B-10
New Component Service
Step 11
On the New Component Service dialog box, choose Application Services from the Service Type
drop-down list.
Step 12
In the Display Name text field, enter the name of the system.
Step 13
In the ServiceID text field, enter TEOSAPReports<space>SAP system name (for example, enter
TEOSAPReports R47) and then click OK.
The newly added component displays on the Configure Services dialog box under Reports.
Step 14
Click Apply.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
B-7
Appendix B
Installing the SPI for HP OpenView
Configuring HP OpenView
Step 15
Click OK to to close the dialog box and complete the procedure.
Deploying TEO Policies
You must now deploy the TEO policies on the node where TEO is installed.
Step 1
In the HP OpenView Operator Console, navigate to the Policy management node and click Policy
groups.
Step 2
In the details pane, right-click SPI for TEO Incident Analysis for SAP and choose All Tasks > Deploy
on.
Figure B-11
Deploying Policies
The Deploy policies on dialog box displays.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
B-8
OL-24784-01
Appendix B
Installing the SPI for HP OpenView
Enabling SAP Alerts on Windows Event Log Process
Figure B-12
Deploy Policies On
Step 3
Check the checkbox for the HPOV agent that is installed on the TEO server.
Step 4
Under Deployment Options, check the deploy policy only if version is newer check box and click OK
to complete the procedure.
Enabling SAP Alerts on Windows Event Log Process
The SAP Alerts on Windows Event Log process is disabled by default in TEO. To receive alerts in HPOV,
you must enable this process in TEO.
Step 1
On the TEO Console Definition workspace, click Processes in the navigation pane.
Step 2
Using the Filter by link, choose Automation Pack > Core SAP Automation to display the processes.
Step 3
Right-click the Publish SAP Alerts on Windows Event Log process and choose Enable.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
B-9
Appendix B
Installing the SPI for HP OpenView
Enabling SAP Alerts on Windows Event Log Process
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
B-10
OL-24784-01
A P P E N D I X
C
Core Automation for SAP BW, BWA and BOBJ
Automation Pack Content
The Core Automation for SAP BW, BWA and BOBJ automation pack contains content that is used in
the other automation packs for SAP BW and BWA, BOBJ and other non-SAP applications. This
appendix describes the content included in the Core Automation for SAP BW, BWA and BOBJ
automation pack. It includes the following sections:
•
Automation Pack Content, page C-1
•
Automation Pack Dependencies, page C-3
•
Core Automation for SAP BW, BWA and BOBJ Activities, page C-4
•
Defining the BWA TREX Activities, page C-9
Automation Pack Content
Use the automation pack Properties dialog box to view the content (objects) included in the automation
pack. For instructions on accessing the automation pack properties, see Accessing Automation Pack
Properties, page 2-1.
Core Automation for SAP BW, BWA and BOBJ Processes
The following table contains the process that is imported by the Core Automation for SAP BW, BWA
and BOBJ automation pack.
Process Name
Description
BOBJ Process Execution Error
Raises an incident when there are errors in the execution
of process activities contained in the BOBJ automation
packs.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-1
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Automation Pack Content
Core Automation for SAP BW, BWA and BOBJ Atomic Processes
The Core Automation for SAP BW, BWA and BOBJ automation pack contains additional activities
(atomic processes) for use in the SAP BW, BWA and BOBJ processes. These are additional activities
that display in the Process Editor toolbox after the user has imported the automation packs.
See the “Core Automation for SAP BW, BWA and BOBJ Activities” section on page C-4 for information
on the activities and how to use them.
Core Automation for SAP BW, BWA and BOBJ Extended Target Properties
The following table contains the extended target properties that are imported by the Core Automation
for SAP BW, BWA and BOBJ automation pack.
Extended Target Property
Description
BWA.Direct TREX.Path to Scripts
Contains the path to the TEO scripts that were installed
to the TREX servers.
BWA.TREX.Index Query
Contains the custom defined TREX and the response
time threshold values to be used for monitoring TREX
in a non-SAP environment.
BWA.TREX.Load Metrics
Contains the thresholds for system workload metrics.
BWA.TREX.Long Running Threads – Types Contains the thread types that should not be monitored
to Exclude
for long running threads.
BWA.TREX.Long Running Threads
Thresholds
Contains the thresholds for long running threads.
BWA.TREX.Service Statistics Threshold
Contains the threshold values to be used for monitoring
TREX Service Statistics in a non-SAP environment.
Thread types can be excluded from monitoring using
the extended target property BWA.TREX.Long
Running Threads – Types to Exclude.
For instructions on configuring extended target properties , see Managing Extended Target Properties,
page 3-24.
Core Automation for SAP BW, BWA and BOBJ Global Variables
The following table contains the global variables that are imported by the Core Automation for SAP BW,
BWA and BOBJ automation pack.
Global Variable Name
Description
BOBJ – Alert Suppression Time
Contains the duration that duplicate TEO BOBJ alerts
will be suppressed. After this time, a new alert and
incident will be created.
For instructions on configuring global variables, see the Tidal Enterprise Orchestrator Reference Guide.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-2
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Automation Pack Dependencies
Core Automation for SAP BW, BWA and BOBJ Target Groups
The Core Automation for SAP BW, BWA and BOBJ automation pack provides the target groups that are
used by the processes. Most of the target groups are automatically populated with members when the
targets are configured. For those that are not automatically populated, you must manually add the
members.
The following table contains the target groups that are imported by the Core Automation for SAP BW,
BWA and BOBJ automation pack.
Target Group Name
Description
Automatically
Populated with
Members
Direct TREX Servers
All terminal targets for TREX Servers.
No
For information on adding members to target groups, see the Tidal Enterprise Orchestrator Reference
Guide.
Automation Pack Dependencies
Use the Dependencies tab on the automation pack Properties dialog box to view the automation packs
and adapters referenced by the objects in the automation pack. These objects must be installed prior to
importing the Core Automation for SAP BW, BWA and BOBJ automation pack.
For instructions on accessing the automation pack properties, see Accessing Automation Pack
Properties, page 2-1.
Object Type
Dependency
Automation Packs
•
Core
Adapters
•
Core Functions Adapter
•
Terminal Adapter
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-3
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Core Automation for SAP BW, BWA and BOBJ Activities
Core Automation for SAP BW, BWA and BOBJ Activities
The following table contains the atomic processes (activities) that are imported by the Core Automation
for SAP BW, BWA and BOBJ automation pack.
Process Name
Description
BWA TREX – Cancel Running
Reorganization
Stops the index reorganization process.
BWA TREX – Continue Reorganization
Continues a stopped index reorganization process.
See BWA TREX—Cancel Running Reorganization
Activity, page C-9.
See BWA TREX—Continue Reorganization Activity,
page C-11.
BWA TREX – Delete All Indexes
Deletes all indexes from the BWA instance.
See BWA TREX—Delete All Indexes Activity,
page C-13.
BWA TREX – Delete Index
Deletes a specific index from the BWA instance.
See BWA TREX—Delete Index Activity, page C-14.
BWA TREX – Execute Query
Executes a TREX query against a specified index to
return query response time.
See BWA TREX—Execute Query Activity, page C-15.
BWA TREX – Get Alert Details
Displays current alert details.
See BWA TREX—Get Alert Details Activity,
page C-17.
BWA TREX – Get Alerts
Displays current alert summary.
See BWA TREX—Get Alerts Activity, page C-18.
BWA TREX – Get Index Usage
Returns index usage and statistical data.
See BWA TREX—Get Index Usage Activity,
page C-20.
BWA TREX – Get Indexes
Retrieves technical data for all indexes for a TREX
system.
See BWA TREX—Get Indexes Activity, page C-21.
BWA TREX – Get Landscape Summary
Retrieves a summary of the overall BWA landscape
system health.
See BWA TREX—Get Landscape Summary Activity,
page C-23.
BWA TREX – Get Last Reorganization Plan Displays details of the last index reorganization plan.
See BWA TREX—Get Last Reorganization Plan
Activity, page C-24.
BWA TREX – Get Load Metrics
Retrieves current TREX system workload metrics.
See BWA TREX—Get Load Metrics Activity,
page C-26.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-4
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Core Automation for SAP BW, BWA and BOBJ Activities
Process Name
Description
BWA TREX – Get Loaded Indexes
Displays the indexes that are currently online in the
BWA instance.
See BWA TREX—Get Loaded Indexes Activity,
page C-27.
BWA TREX – Get Long Running Threads
Retrieves a list of currently active long running TREX
engine threads.
See BWA TREX—Get Long Running Threads Activity,
page C-29.
BWA TREX – Get Next Reorganization Plan Displays details of the next index reorganization plan.
See BWA TREX—Get Next Reorganization Plan
Activity, page C-30.
BWA TREX – Get Reorganization Summary Displays current state of index reorganization
requirements and suggested plan.
See BWA TREX—Get Reorganization Summary
Activity, page C-32.
BWA TREX – Get Service Statistics
Retrieves current TREX engine service runtime
statistics, such as CPU, memory and response time.
See BWA TREX—Get Service Statistics Activity,
page C-34.
BWA TREX – Preload Index
Preloads an index into the instance array memory.
See BWA TREX—Get Service Statistics Activity,
page C-34.
BWA TREX – Restart Service
Restarts individual TREX service processes.
See BWA TREX—Restart Service Activity, page C-37.
BWA TREX – Start Reorganization
Starts the execution of the index reorganization.
See BWA TREX— Start Reorganization Activity,
page C-39.
BWA TREX – Test HTTP Status
Checks the TREX http server status.
See BWA TREX—Test HTTP Status Activity,
page C-40.
BWA TREX – Unload Index
Unloads an index from the BWA instance.
See BWA TREX—Unload Index Activity, page C-42.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-5
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Core Automation for SAP BW, BWA and BOBJ Activities
Defining an Activity
Use the following steps to define an 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.
Step 1
On the Toolbox pane, navigate to the appropriate section, click the activity and drag it onto the
Workflow pane.
The Activity Properties dialog box displays.
Note
The Required Field
missing a value.
icon displayed on a tab or page indicates that the field is required and is
Click the Reference
tool to select a defined variable or reference an object within the
process. For additional information, see the Tidal Enterprise Orchestrator Reference Guide.
Step 2
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Step 3
Click the Activity-specific tab (typically, Inputs) and enter the required information. See the appropriate
section in this chapter for instructions on completing the fields on the activity-specific tab.
Step 4
Click the Target tab to specify the process target. You can use the process target or override it and
specify a different target for the specific activity.
Field
Description
Execute on the process target
Click this radio button to use the same target that was
specified for the process.
Execute on activity target
Click this radio button to indicate that the activity
should execute against a target selected in an activity
within the process. Choose the activity from the
drop-down list.
Execute on this target
Click this radio button and choose a specific target from
the drop-down list.
•
To view the properties for the selected target, click
the Properties
tool.
•
To create a new target for this process, click New.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-6
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Core Automation for SAP BW, BWA and BOBJ Activities
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.
Execute on the target selected by this
algorithm
Click this radio button to execute the target selected by
one of the target algorithms displayed in the drop-down
menu.
Note
Execute on this target group
The available algorithms that display depend on
the selected activity.
Click this radio button to choose a target group from the
drop-down list.
•
To view the properties for the selected target group,
click the Properties
tool.
•
To create a new target group for this process, click
New.
Use the Choose a target using this algorithm
drop-down list to choose the algorithm that will
determine the target to execute from the eligible target
group.
Note
Step 5
The available algorithms that display depend on
the selected activity.
Click the Credentials tab to specify the runtime user whose credentials should be used for process
execution:
Field
Description
Use target's default runtime user
Click this radio button to use the default runtime user for
the target that is specified in the activity.
Use Process runtime user
Click this radio button to use the credentials for the runtime
user that was specified for the process.
Override process runtime user
Click this radio button to specify different credentials than
what are used for the process. The selected runtime user
overrides the runtime user that was specified for the
process.
•
To view the properties for the selected runtime user,
click the Properties
tool.
•
To create a runtime user record for the process, click
New.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-7
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Core Automation for SAP BW, BWA and BOBJ Activities
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.
Possible resolution
List of actions that can be performed to attempt to
resolve the issue.
Related information
Additional information related to the issue.
Step 7
If the knowledge base article is not displayed by default, click the Browse
Base field.
Step 8
On the Select Knowledge Base dialog box, select the appropriate knowledge base article in the list and
click OK.
Note
Step 9
Step 10
tool in the Knowledge
Click New to create a new knowledge base article. For additional information on knowledge
base articles, see the Tidal Enterprise Orchestrator Reference Guide.
Click the Result Handlers tab to specify condition branches for the activity.
Button
Description
Add
Adds a condition branch.
Remove
Removes the condition branch from the activity.
Move Up
Moves the condition up one position in the list of
conditions.
Move Down
Moves the condition down one position in the list of
conditions.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-8
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Viewing Activity Results
When an 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 click the view that represents how
the process was executed (for example, View Adhoc, if the process was manually executed).
Step 2
In the View Results pane, expand the process, and double-click the activity instance or right-click and
choose Observe.
Step 3
On the Process Viewer, ensure that Properties is enabled in the View menu, and then click the activity
in the workflow to display the activity instance properties.
Step 4
If the activity required input values, click the Inputs tab to view the display-only properties of the
activity.
Step 5
Click the Outputs tab to view the results of the activity.
Step 6
When you have completed viewing the properties, close the Process Viewer.
Defining the BWA TREX Activities
This section provides instructions for defining the BWA TREX activities.
BWA TREX—Cancel Running Reorganization Activity
Use the BWA TREX—Cancel Running Reorganization activity to stop an index reorganization process.
Step 1
On the Toolbox pane, click the BWA TREX—Cancel Running Reorganization activity and drag it
onto the Workflow pane.
Figure C-1
BWA TREX—Cancel Running Reorganization Properties—General Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-9
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 2
Step 3
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-2
BWA TREX—Cancel Running Reorganization Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, specify the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-10
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Continue Reorganization Activity
Use the BWA TREX—Continue Reorganization activity to continue an index reorganization process
that has been stopped.
Step 1
On the Toolbox pane, click the BWA TREX—Continue Reorganization activity and drag it onto the
Workflow pane.
Figure C-3
Step 2
Step 3
BWA TREX—Continue Reorganization Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-11
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Figure C-4
BWA TREX—Continue Reorganization Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, specify the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-12
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Delete All Indexes Activity
Use the BWA TREX—Delete All Indexes activity to delete all indexes from the BWA instance.
Step 1
On the Toolbox pane, click the BWA TREX—Delete All Indexes activity and drag it onto the
Workflow pane.
Figure C-5
Step 2
Step 3
Step 4
BWA TREX—Delete All Indexes Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-13
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Delete Index Activity
Use the BWA TREX—Delete Index activity to delete a specific index from the BWA instance.
Step 1
On the Toolbox pane, click the BWA TREX—Delete Index activity and drag it onto the Workflow
pane.
Figure C-6
Step 2
Step 3
BWA TREX—Delete Index Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-7
BWA TREX—Delete Index Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-14
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
Step 5
Step 6
On the Inputs tab, enter the following information:
Field
Description
Index ID
Index technical name for the index to be deleted.
Timeout (sec)
Number of seconds to allow for the SSH call to complete
its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Execute Query Activity
Use the BWA TREX—Execute Query activity to execute a TREX query against a specific index. This
activity returns the query response time.
Step 1
On the Toolbox pane, click the BWA TREX—Execute Query activity and drag it onto the Workflow
pane.
Figure C-8
Step 2
BWA TREX—Execute Query Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-15
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 3
Click the Inputs tab.
Figure C-9
Step 4
Step 5
Step 6
BWA TREX—Execute Query Properties—Inputs Tab
On the Inputs tab, enter the following information:
Field
Description
Options
Options to designate the TREX query and index to be
executed.
Timeout (sec)
Number of seconds to allow for the SSH call to
complete its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-16
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Get Alert Details Activity
Use the BWA TREX—Get Alert Details activity to retrieve current alert details.
Step 1
On the Toolbox pane, click the BWA TREX—Get Alert Details activity and drag it onto the Workflow
pane.
Figure C-10
Step 2
Step 3
BWA TREX—Get Alert Details Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-11
BWA TREX—Get Alert Details Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-17
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
In the Timeout (secs) text field, specify the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Get Alerts Activity
Use the BWA TREX—Get Alerts activity to retrieve a list of alerts.
Step 1
On the Toolbox pane, click the BWA TREX—Get Alerts activity and drag it onto the Workflow pane.
Figure C-12
Step 2
Step 3
BWA TREX—Get Alerts Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-18
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Figure C-13
Step 4
Step 5
Step 6
BWA TREX—Get Alerts Properties—Inputs Tab
On the Inputs tab, enter the following information:
Field
Description
Age (minutes)
Retrieve alerts that have occured within the last X minutes
indicated in this field.
Severity
Severity level of alerts to be retrieved (Red, Yellow,
Green, Grey, All).
Timeout (sec)
Number of seconds to allow for the SSH call to complete
its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-19
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Get Index Usage Activity
Use the BWA TREX—Get Index Usage activity to return index usage and statistical data.
Step 1
On the Toolbox pane, click the BWA TREX—Get Index Usage activity and drag it onto the Workflow
pane.
Figure C-14
Step 2
Step 3
BWA TREX—Get Index Usage Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-15
BWA TREX—Get Index Usage Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-20
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
Step 5
Step 6
Specify the following information:
Field Name
Description
Start Date
Date from which to begin collecting index usage data.
Start Time
Time from which to begin collecting for the index usage
data.
Index Name(s)
Complete index name of the index or enter * to retreive
usage data from all indexes.
Timeout (secs)
Number of seconds to allow for the SSH call to
complete its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Get Indexes Activity
Use the BWA TREX—Get Indexes activity to retrieve a list of the loaded indexes.
Step 1
On the Toolbox pane, click the BWA TREX—Get Indexes activity and drag it onto the Workflow pane.
Figure C-16
BWA TREX—Get Indexes Properties—General Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-21
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 2
Step 3
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-17
Step 4
Step 5
Step 6
BWA TREX—Get Indexes Properties—Inputs Tab
Specify the following information:
Field Name
Description
Index Name
Complete name of the index or enter * to retrieve all
indexes.
Timeout (secs)
Number of seconds to allow for the SSH call to
complete its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-22
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Get Landscape Summary Activity
Use the BWA TREX—Get Landscape Summary activity to retrieve a summary of the overall BWA
landscape system health.
Step 1
On the Toolbox pane, click the BWA TREX—Get Landscape Summary activity and drag it onto the
Workflow pane.
Figure C-18
Step 2
Step 3
BWA TREX—Get Landscape Summary Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-19
BWA TREX—Get Landscape Summary Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-23
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Get Last Reorganization Plan Activity
Use the BWA TREX—Get Last Reorganization Plan activity to retrieve the current state of index
reorganization requirements and suggested plan.
Step 1
On the Toolbox pane, click the BWA TREX—Get Last Reorganization Plan activity and drag it onto
the Workflow pane.
Figure C-20
Step 2
Step 3
BWA TREX—Get Last Reorganization Plan Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-24
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Figure C-21
BWA TREX—Get Last Reorganization Plan Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-25
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Get Load Metrics Activity
Use the BWA TREX—Get Load Metrics activity to retrieve current TREX system workload metrics.
Step 1
On the Toolbox pane, click the BWA TREX—Get Load Metrics activity and drag it onto the Workflow
pane.
Figure C-22
Step 2
Step 3
BWA TREX—Get Load Metrics Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-23
BWA TREX—Get Load Metrics Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-26
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
Step 5
Step 6
Specify the following information:
Field Name
Description
Host
TREX host name to return metrics.
Minutes
Retrieve metrics within the past X minutes specified in this
field.
Metric Names
Comma separated list of metric names to return.
Timeout (secs)
Number of seconds to allow for the SSH call to complete
its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Get Loaded Indexes Activity
Use the BWA TREX—Get Loaded Indexes activity to retrieve the indexes that are currently online in
the BWA instance.
Step 1
On the Toolbox pane, click the BWA TREX—Get Loaded Indexes activity and drag it onto the
Workflow pane.
Figure C-24
BWA TREX—Get Loaded Indexes Properties—General Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-27
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 2
Step 3
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-25
BWA TREX—Get Loaded Indexes Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-28
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Get Long Running Threads Activity
Use the BWA TREX—Get Long Running Threads activity to retrieve a list of currently active long
running TREX engine threads.
Step 1
On the Toolbox pane, click the BWA TREX—Get Long Running Threads activity and drag it onto
the Workflow pane.
Figure C-26
Step 2
Step 3
BWA TREX—Get Long Running Threads Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-27
BWA TREX—Get Long Running Threads Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-29
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
Step 5
Step 6
Specify the following information:
Field Name
Description
Warning Threshold
Enter the value for the amount of time before a thread
reaches the Warning threshold (default is “5sec”).
Error Threshold
Enter the value for the amount of time before a thread
reaches the Error threshold (default is “10sec”).
Timeout (secs)
Number of seconds to allow for the SSH call to
complete its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Get Next Reorganization Plan Activity
Use the BWA TREX—Get Next Reorganization Plan activity to retrieve details of the next index
reorganization plan.
Step 1
On the Toolbox pane, click the BWA TREX—Get Next Reorganization Plan activity and drag it onto
the Workflow pane.
Figure C-28
BWA TREX—Get Next Reorganization Plan Properties—General Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-30
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 2
Step 3
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-29
BWA TREX—Get Next Reorganization Plan Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-31
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Get Reorganization Summary Activity
Use the BWA TREX—Get Reorganization Summary activity to retrieve current state of index
reorganization requirements and suggested plan.
Step 1
On the Toolbox pane, click the BWA TREX—Get Reorganization Summary activity and drag it onto
the Workflow pane.
Figure C-30
Step 2
Step 3
BWA TREX—Get Reorganization Summary Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-32
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Figure C-31
BWA TREX—Get Reorganization Summary Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-33
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Get Service Statistics Activity
Use the BWA TREX—Get Service Statistics activity to retrieve current TREX engine service runtime
statistics, such as CPU, memory and response time.
Step 1
On the Toolbox pane, click the BWA TREX—Get Service Statistics activity and drag it onto the
Workflow pane.
Figure C-32
Step 2
Step 3
BWA TREX—Get Service Statistics Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-34
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Figure C-33
BWA TREX—Get Service Statistics Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-35
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Preload Index Activity
Use the BWA TREX—Preload Index activity to preload an index into the instance array memory.
Step 1
On the Toolbox pane, click the BWA TREX—Preload Index activity and drag it onto the Workflow
pane.
Figure C-34
Step 2
Step 3
BWA TREX—Preload Index Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-35
BWA TREX—Preload Indexes Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-36
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
Step 5
Step 6
Specify the following information:
Field Name
Description
Index ID
Index technical name for the index.
Timeout (secs)
Number of seconds to allow for the SSH call to complete
its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Restart Service Activity
Use the BWA TREX—Restart Service activity to restart individual TREX service processes.
Step 1
On the Toolbox pane, click the BWA TREX—Restart Service activity and drag it onto the Workflow
pane.
Figure C-36
Step 2
BWA TREX—Restart Service Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-37
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 3
Click the Inputs tab.
Figure C-37
Step 4
Step 5
Step 6
BWA TREX—Restart Service Properties—Inputs Tab
Specify the following information:
Field Name
Description
Service
TREX service to restart (Index Server, Name Server,
etc.).
Host
Blade host name.
Port
TREX service port.
Timeout (secs)
Number of seconds to allow for the SSH call to
complete its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-38
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX— Start Reorganization Activity
Use the BWA TREX—Start Reorganization activity to start the execution of the index reorganization.
Step 1
On the Toolbox pane, click the BWA TREX—Start Reorganization Plan activity and drag it onto the
Workflow pane.
Figure C-38
Step 2
Step 3
BWA TREX—Start Reorganization Plan Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-39
BWA TREX—Start Reorganization Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-39
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
BWA TREX—Test HTTP Status Activity
Use the BWA TREX—Test HTTP Status activity to check the status of the TREX http server.
Step 1
On the Toolbox pane, click the BWA TREX—Test HTTP Status activity and drag it onto the
Workflow pane.
Figure C-40
Step 2
Step 3
BWA TREX—Test HTTP Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-40
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Figure C-41
BWA TREX—Test HTTP Status Properties—Inputs Tab
Step 4
In the Timeout (secs) text field, enter the number of seconds to allow for the SSH call to complete its
operation on BWA.
Step 5
Complete the appropriate information in the following tabs:
Step 6
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-41
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
BWA TREX—Unload Index Activity
Use the BWA TREX—Unload Index activity to unload an index from the BWA instance.
Step 1
On the Toolbox pane, click the BWA TREX—Unload Index activity and drag it onto the Workflow
pane.
Figure C-42
Step 2
Step 3
BWA TREX—Unload Index Properties—General Tab
On the General tab, enter the following information:
Field
Description
Name
Name of the activity.
Type
Display only. Displays the type of activity.
Description
Text description of the activity.
Click the Inputs tab.
Figure C-43
BWA TREX—Unload Index Properties—Inputs Tab
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-42
OL-24784-01
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Step 4
Step 5
Step 6
Specify the following information:
Field Name
Description
Index ID
Index technical name for the index.
Timeout (secs)
Number of seconds to allow for the SSH call to complete
its operation on BWA.
Complete the appropriate information in the following tabs:
•
Target—Specify whether the defined process target should be used or overridden.
•
Credentials—Specify the runtime user whose credentials should be used for process execution.
•
Knowledge Base—Select the appropriate knowledge base article to associate with the activity.
•
Result Handlers—Click the appropriate buttons to manage the condition branches on the workflow.
Click the Save
tool to save the activity definition.
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
C-43
Appendix C
Core Automation for SAP BW, BWA and BOBJ Automation Pack Content
Defining the BWA TREX Activities
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
C-44
OL-24784-01
INDEX
BWA TREX - Continue Reorganization activity
A
C-11
BWA TREX - Continue Reorganization properties
ABAP application server
3-3
BWA TREX - Delete All Indexes activity
ABAP system connection information
3-3
BWA TREX - Delete Index activity
about
Automation for SAP BW and BWA knowledge base
articles 2-8
installing TEO on SCOM
A-1
accessing
automation pack properties
4-2
2-1
extended target properties
task rules
BWA TREX - Delete Index properties
C-14
BWA TREX - Execute Query activity
C-15
BWA TREX - Execute Query properties
C-16
BWA TREX - Get Alert Details activity
C-17
adding assignees
C-18
C-21
C-22
BWA TREX - Get Index Usage activity
4-14, C-9
C-17
C-18
BWA TREX - Get Indexes properties
C-20
BWA TREX - Get Index Usage properties
3-12
C-20
BWA TREX - Get Landscape Summary activity
Advanced properties, Unix/Linux System
assignments and notifications
Assign Task Rule, creating
3-7
C-23
BWA TREX - Get Last Reorganization Plan activity
3-13, 3-18
1-7
BWA TREX - Get Loaded Indexes activity
C-27
BWA TREX - Get Loaded Indexes properties
2-3, C-1
BWA TREX - Get Load Metrics activity
Automation Pack Import Wizard
C-28
C-26
BWA TREX - Get Load Metrics properties
1-2
C-26
BWA TREX - Get Long Running Threads activity
automation pack properties, accessing
2-1
4-17
C-24
BWA TREX - Get Last Reorganization Plan
properties C-24
3-7
Automation for SAP BW and BWA automation pack
automation pack content
C-23
BWA TREX - Get Landscape Summary properties
3-10
Authentication properties, Unix/Linux System
automation summary
BWA TREX - Get Alerts activity
BWA TREX - Get Indexes activity
C-6
activity results, viewing
launching
C-14
BWA TREX - Get Alerts properties
3-24
3-10
activities, defining
importing
C-13
BWA TREX - Get Alert Details properties
Automation for SAP BW and BWA processes
C-11
C-29
BWA TREX - Get Long Running Threads properties
C-29
BWA TREX - Get Next Reorganization Plan activity
C-30
BWA TREX - Get Next Reorganization Plan
properties C-31, C-32
B
BWA TREX - Get Reorganization Summary activity
BWA TREX - Cancel Running Reorganization
activity C-9
BWA TREX - Cancel Running Reorganization
properties C-10
BWA TREX - Get Service Statistics activity
BWA TREX - Get Service Statistics properties
BWA TREX - Preload Index activity
BWA TREX - Preload Index properties
C-32
C-34
C-34
C-36
C-36
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
IN-1
Index
BWA TREX - Restart Service activity
activities, general
C-37
BWA TREX - Start Reorganization activity
BWA TREX - Test HTTP Status activity
C-39
BWA TREX - Continue Reorganization activity
C-40
BWA TREX - Test HTTP Status properties
BWA TREX - Unload Index activity
BWA TREX - Cancel Running Reorganization
activity C-9
C-39
BWA TREX - Start Reorganization properties
BWA TREX - Delete All Indexes activity
C-40
BWA TREX - Delete Index activity
C-42
BWA TREX - Unload Index properties
C-6
C-15
BWA TREX - Get Alert Details activity
BWA TREX - Get Alerts activity
C
HP OpenView
B-2
HP OpenView Services
security settings, SCOM
configuring task rules
A-2
BWA TREX - Get Index Usage Indexes activity
C-20
BWA TREX - Get Landscape Summary activity
C-23
BWA TREX - Get Loaded Indexes activity
3-11
BWA TREX - Get Load Metrics activity
SAP ABAP system, specifying
Connection interaction patterns
3-8
Connection properties, Unix/Linux System
C-27
C-26
BWA TREX - Get Long Running Threads
activity C-29
3-3
Connection interaction patterns, Unix/Linux System
3-6
C-11
3-8
BWA TREX - Get Next Reorganization Plan
activity C-30
BWA TREX - Get Reorganization Summary
activity C-32
BWA TREX - Get Service Statistics activity
copying task rules
3-22
BWA TREX - Preload Index activity
Core Automation for SAP BW, BWA and BOBJ
automation pack
importing
C-21
BWA TREX - Get Last Reorganization Plan
activity C-24
B-5
connection information
Continue
C-17
C-18
BWA TREX - Get Indexes activity
configuring
C-13
C-14
BWA TREX - Execute Query activity
C-42
BWA TREX - Restart Service activity
C-37
BWA TREX - Test HTTP Status activity
creating
3-13, 3-18
Notify Task Rule
3-19
runtime user
BWA TREX - Unload Index activity
deleting task rules
C-39
C-40
C-42
3-22
dependencies
3-2
Update Task Rule
C-34
C-36
BWA TREX - Start Reorganization activity
1-4
Assign Task Rule
Automation for SAP BW and BWA, viewing
3-20
2-11
Core Automation for SAP BW, BWA and BOBJ
credentials
SAP ABAP system, specifying
SAP User
C-11
3-3
deploy
TEO policies in HP OpenView
3-2
C-3
disabling task rule
B-8
3-21
distributing Run As account in SCOM
A-7
D
default
runtime user, specifying
3-4
defining
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
IN-2
OL-24784-01
Index
TEO modules in HP OpenView
E
incidents
B-2
4-15
Elevate the privilege command, Network Device Module
target 3-9
email notifications
K
3-10
enabling
notification based on assignment processes
task rule
knowledge base articles
3-23
Automation for SAP BW and BWA
2-8
3-21
extended target properties
accessing
L
3-24
Core Automation for SAP BW, BWA and BOBJ
managing
C-2
3-24
Login expect properties, Unix/Linux System
3-8
M
F
filtering processes
management framework
4-2
HP OpenView, configuring
B-2
management server
G
properties, SCOM
A-2
managing
global variables
Automation for SAP BW and BWA
extended target properties
2-8
Core Automation for SAP BW, BWA and BOBJ
task rules
C-2
3-24
3-21
monitoring
SAP ABAP application server
server availability
H
3-3
3-5
HP OpenView
configuring
N
B-2
operations console
B-5
services, configuring
specifying service
Network Device Module target, Elevate the privilege
command 3-9
B-5
B-6
New SAP System Wizard
3-3
Notify Task Rule, creating
3-19
I
O
importing
Automation for SAP BW and BWA
automation pack
1-7
objects
1-1
Automation for SAP BW and BWA, viewing
Core Automation for SAP BW, BWA and BOBJ
Core SAP Automation
1-4
override process target
2-3, 2-10
4-10
1-2
SAP management pack in SCOM
A-9
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
IN-3
Index
P
R
policies, deploy in HP OpenView
policy management node
Restart Service properties
B-8
Run As account, creating in SCOM
B-8
processes
A-2
runtime user
accessing
creating
4-2
activity results, viewing
2-4
Core Automation for SAP BW, BWA and BOBJ
C-4
4-2
S
SAP User
notification based on assignment
override target
4-10
starting process
4-9
viewing execution
viewing results
3-2
4-14
Automation for SAP BW and BWA
filtering
C-38
3-23
credentials, specifying
3-2
SCOM
creating profile for TEOProcess database
4-11
creating Run As account
4-13
A-2
distributing Run As account
properties
A-7
importing management packs
BWA TREX - Cancel Running Reorganization
BWA TREX - Continue Reorganization
BWA TREX - Delete Index
installing TEO
C-11
setup tasks
C-17
3-5
server proxy, configuring in SCOM
C-20
services, HP Openview
BWA TREX - Get Landscape Summary
C-23
BWA TREX - Get Last Reorganization Plan
BWA TREX - Get Loaded Indexes
BWA TREX - Get Load Metrics
A-2
A-2
specifying servers
C-22
BWA TREX - Get Index Usage
A-1, B-1
server availability
C-18
BWA TREX - Get Indexes
A-1
security settings, configuring
C-16
BWA TREX - Get Alert Details
A-9
prerequisites for management pack
C-14
BWA TREX - Execute Query
BWA TREX - Get Alerts
C-10
A-12
sorting task rules
C-24
B-5
3-22
specifying
C-28
availability monitoring
C-26
BWA TREX - Get Long Running Threads
default runtime user
C-29
BWA TREX - Get Next Reorganization Plan
C-31,
A-2
SAP User credentials
starting processes
3-5
3-4
3-2
4-9
C-32
BWA TREX - Get Service Statistics
BWA TREX - Preload Index
T
C-36
BWA TREX - Start Reorganization
BWA TREX - Test HTTP Status
BWA TREX - Unload Index
Restart Service
C-38
C-34
C-42
C-39
C-40
target groups
Core Automation for SAP BW, BWA and BOBJ
task rules
3-10, 3-12
accessing
assign
C-3
3-10
3-13
conditions
3-15
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
IN-4
OL-24784-01
Index
configuring
incidents
3-11
4-15
copying
3-22
process activity results
deleting
3-22
process results
4-13
disabling
3-21
running process
enabling
3-21
target groups
General properties
managing
sorting
4-14
4-11
C-3
3-14
3-21
3-22
task types
3-14
TEO
modules, importing in HP OpenView
B-2
policies, deploying in HP OpenView
B-8
Unix/Linux System Advanced properties
3-7
U
Unix/Linux System Authentication properties
3-7
Unix/Linux System Connection interaction patterns
properties 3-8
Unix/Linux System Connection properties
Unix/Linux System Login Expect properties
Update Task Rule, creating
3-6
3-8
3-20
V
viewing
activity results
C-9
Automation for SAP BW and BWA
dependencies 2-11
Automation for SAP BW and BWA global
variables 2-8
Automation for SAP BW and BWA objects
Automation for SAP BW and BWA processes
automation pack content
2-4
2-3, C-1
automation pack dependencies
automation summary
2-3, 2-10
C-3
4-17
Core Automation for SAP BW, BWA and BOBJ
processes C-4
extended target properties
global variables
C-2
C-2
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
OL-24784-01
IN-5
Index
Cisco TEO—Process Automation Guide for Automation for SAP BW and BWA
IN-6
OL-24784-01