Learn how to control BPA queues from LVM.

1. SAP
LVM
Integration
with
SAP
BPA

2. • This is the fourth in a series of presentations dedicated to SAP
Landscape Virtualization Management (LVM)
• This document provides a quick overview of how to integrate
an SAP Business Process Automation (BPA) web service in SAP
LVM
• The document is aimed at system administrators responsible
for configuring SAP LVM and are familiar with LVM Custom
Operations (see SlideShare presentation)
• The document assumes the reader has a knowledge of SAP BPA
and associated terminology
Introduction

3. Overview
• This
custom
operation
controls
BPA
queues
from
LVM
• The
custom
operation
for
LVM
is
based
on
creation
of
the
following
LVM
elements:
– Provider
Implementation
– Custom
Operation
• The
custom
operation
for
LVM
is
based
on
creation
of
the
following
BPA
objects:
– Process
Definition
– Web
Service
• The
custom
operation
also
requires
a
script
registered
with
the
Host
Agent

4. Process
Definition
in
BPA
• Define the RedwoodScript process definition in BPA – e.g.
Custom_Set_Queue

5. Process
Definition
in
BPA
• Give the process definition two output string parameters e.g. QN and
QA to represent the queue name and action to be carried out on the
queue i.e. HOLD (hold, closed) or RELE (release, open)

6. Web
Service
Definition
in
BPA
• Publish the process definition as a web service to be referenced
in the host agent script later e.g. WS_Custom_Set_Queue

7. Configuration
in
LVM
• Provider implementation for the BPA queue custom operations
• SetupèExtensibilityèProvider Implementation Definitions

8. Configuration
in
LVM
• Custom operation “Hold” using the defined provider implementation
with the Operation parameter set to ”HOLD”
• SetupèExtensibilityèCustom Operation

9. Configuration
in
LVM
• Custom operation “Release” using the defined provider
implementation with the Operation parameter set to ”RELE”
• SetupèExtensibilityèCustom Operation

10. Configuration
in
LVM
• Characteristic ”Job Managed by BPA”used to indicate to LVM if the system is
managed by BPA – controls if the operation button is shown for the instance
• ConfigurationèCharacteristics

11. Operation
in
LVM
• Once the configuration is complete, the custom operation
group “BPA Queue Operation” and ”Custom Operation”
selections will be visible for the chosen instance(s)

12. Host
Agent
Registered
Script
• The
configuration
in
LVM
and
BPA
are
hooked
together
with
the
host
agent
registered
script
• The
$[PARAM-­‐OPERATION]
can
be
seen
being
passed
as
the
first
parameter
to
the
Korn script,
indicating
the
custom
operation
being
requested
by
LVM
• The
queue
name
to
be
manipulated
is
automatically
calculated
by
the
script
based
on
the
SID
File Content
ClusterAdm.conf Name: LVM_CustomOperation_BPAQueueAdm
Command: /sap/Scripts/SetQueue.ksh $[PARAM-OPERATION]
Workdir: $[DIR_HOME:#sapparam]
Username: root
ResultConverter: flat

13. Example
Script
– SetQueue.ksh
Sample Coding
###################################################################################
# #
# Perform operation (call web service) #
# #
###################################################################################
echo "[RESULT]: ${OPERATION} issued for queue ${QUEUE}"
curl -L -S -H 'SOAPAction: "'${bpa_wsdl}'"' -H "Content-Type: application/xml;
charset=utf-8" –H "Authorization:Basic ${bpa_user}" --data @- "${bpa_wurl}"<<EOF
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:red="Redwood.customer.redwood.com">
<soapenv:Header/>
<soapenv:Body>
<red:SubmitJobParameters>
<red:QN>${QUEUE}</red:QN>
<red:QA>${OPERATION}</red:QA>
</red:SubmitJobParameters>
</soapenv:Body>
</soapenv:Envelope>
EOF

14. Reference
Material
• Further
details
are
available
on
request
– mailto:info@aliterconsulting.co.uk

15. Thank-­‐you