SlideShare a Scribd company logo
SAP	
  LVM	
  Integration	
  with	
  SAP	
  BPA
• 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
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 the
queue i.e. HOLD (hold, closed) or RELE (release, open)
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
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 operation
group “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 Content
ClusterAdm.conf Name: LVM_CustomOperation_BPAQueueAdm
Command: /sap/Scripts/SetQueue.ksh $[PARAM-OPERATION]
Workdir: $[DIR_HOME:#sapparam]
Username: root
ResultConverter: 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:info@aliterconsulting.co.uk
Thank-­‐you

More Related Content

SAP LVM Integration with SAP BPA

  • 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