SAP LVM Integration with SAP BPA

• This is the fourth in a series of presentations dedicated to SAPLandscape Virtualization Management (LVM)

• This document provides a quick overview of how to integratean SAP Business Process Automation (BPA) web service in SAPLVM

• The document is aimed at system administrators responsiblefor configuring SAP LVM and are familiar with LVM CustomOperations (see SlideShare presentation)

• The document assumes the reader has a knowledge of SAP BPAand associated terminology

Introduction

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

Process Definition in BPA

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

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 thequeue i.e. HOLD (hold, closed) or RELE (release, open)

Web Service Definition in BPA

• Publish the process definition as a web service to be referencedin the host agent script later e.g. WS_Custom_Set_Queue

Configuration in LVM

• Provider implementation for the BPA queue custom operations• SetupèExtensibilityèProvider Implementation Definitions

Configuration in LVM• Custom operation “Hold” using the defined provider implementation

with the Operation parameter set to ”HOLD”• SetupèExtensibilityèCustom Operation

Configuration in LVM• Custom operation “Release” using the defined provider

implementation with the Operation parameter set to ”RELE”• SetupèExtensibilityèCustom Operation

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

Operation in LVM

• Once the configuration is complete, the custom operationgroup “BPA Queue Operation” and ”Custom Operation”selections will be visible for the chosen instance(s)

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 ContentClusterAdm.conf Name: LVM_CustomOperation_BPAQueueAdm

Command: /sap/Scripts/SetQueue.ksh $[PARAM-OPERATION]Workdir: $[DIR_HOME:#sapparam]Username: rootResultConverter: flat

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

Reference Material• Further details are available on request

– mailto:[email protected]

Thank-‐you

SAP LVM Integration with SAP BPA

Technology

Transcript of SAP LVM Integration with SAP BPA