This document provides guidance on customizing SAP Landscape Virtualization Management (LVM) to manage custom instance types. It describes how to configure generic operations like detect, monitor, start, and stop by creating scripts referenced in configuration files. An example is provided for managing SAP Replication Server (SRS) instances, with configuration files and sample scripting code shown.

1. SAP
LVM
Custom
Instances

2. • This is the first in a series of presenta/ons dedicated to SAP
Landscape Virtualiza/on Management (LVM)
• This document provides a quick overview of how you can
customize LVM to operate custom instances
• This document describes how this can be achieved in a UNIX
environment but can be easily adapted for the Windows
plaKorm
• The document is aimed at system administrators responsible
for configuring and opera/ng SAP LVM
Introduc5on

3. Overview
• SAP LVM can manage SAP instances and databases using the
SAP Host Agent
• SAP LVM can be extended to manage custom instances such as
SAP Replica/on Server (SRS) via the SAP Host Agent
• Custom instances are managed using SAP Host Agent registered
scripts

4. Generic
Opera5ons
• For each custom instance type that you want to manage within
SAP LVM you create a set of generic opera/ons as follows:
Ø Detect
Ø Monitor
Ø Start/Stop
Ø Validate
Ø ATach/Detach
Ø Getproper/es

5. Generic
Opera5on
Scripts
• The generic opera/ons are defined in configura/on files stored in the
exe/pera/ons.d subdirectory of the host agent file system on the
managed host
• Each generic opera/on configura/on file must use the following
naming conven/on
o Detect – acc_<custominstance-­‐type>_list
o Monitor – acc_<custominstance-­‐type>_monitor
o Start/Stop – acc_<custominstance-­‐type>_start/stop
o Validate – acc_<custominstance-­‐type>_validate
o ATach/Detach – acc_<custominstance-­‐type>_aTach/detach
o Getproper/es – acc_<custominstance-­‐type>_getproper/es
• To operate a custom instance the minimum requirement is to
configure the detect, monitor and start/stop opera/ons

6. Example
for
SRS
-­‐
Overview
• Each configura/on file should reference an opera/ng system script that
performs the corresponding opera/on
• Posi/ve responses are reported to SAP LVM by echoing a string star/ng with
[RESULT]
• Nega/ve responses are reported to SAP LVM by echoing a string star/ng
with [ERROR]
• Responses returned by the opera/ng system scripts are visible in the SAP
LVM log
• For this example we will configure the following files:
1 Detect – acc_SRS_list.conf
2 Monitor – acc_SRS_monitor.conf
3 Start – acc_SRS_start.conf
4 Stop – acc_SRS_stp.conf

7. Example
for
SRS
-­‐
Configura5on
File
Content
acc_SRS_list.conf Name:
acc_SRS_list
Command:
/sap/Scripts/Custom_Instance_SRS_Detect.ksh
Workdir:
$[DIR_HOME:#sapparam]
Username:
sapadm
ResultConverter:
hook
acc_SRS_monitor.conf Name:
acc_SRS_monitor
Command:
/sap/Scripts/Custom_Instance_SRS_Monitor.ksh
Workdir:
$[DIR_HOME:#sapparam]
Username:
sapadm
ResultConverter:
flat
acc_SRS_start.conf Name:
acc_SRS_start
Command:
/sap/Scripts/Custom_Instance_SRS_Operate.ksh
START
Workdir:
$[DIR_HOME:#sapparam]
Username:
sapadm
ResultConverter:
hook
acc_SRS_stop.conf Name:
acc_SRS_stop
Command:
/sap/Scripts/Custom_Instance_SRS_Operate.ksh
STOP
Workdir:
$[DIR_HOME:#sapparam]
Username:
sapadm
ResultConverter:
hook

8. Example
for
SRS
-­‐
Scrip5ng
File
Sample
Coding
(perform
any
site
specific
checks
beforehand)
Custom_Instance_SRS_Detect.ksh
echo "[RESULT]: SAP Replication Server host detected”
echo "service_name="${SID}"_REP;service_caption=SAP Replication
Server;system_sid="${SID}
Custom_Instance_SRS_Monitor.ksh
/usr/sap/hostctrl/exe/saphostctrl -function GetDatabaseStatus -dbname ${SID}_REP
-dbtype syb >> /tmp/log
STATUS_DB=`grep "Database Status" /tmp/log | awk '{print $3}'`
STATUS_RS=`grep "Replication" /tmp/log | awk '{print $10}'`
STATUS_DR=`grep "Agent" /tmp/log | awk '{print $10}'`
echo "service_name="${SID}"_REP;service_status="${STATUS_DB}
echo "process_name=DRA;process_description=DR Agent;process_status="${STATUS_DR}
echo "process_name=SRS;process_description=Replication Server;process_status="$
{STATUS_RS}
Custom_Instance_SRS_Operate.ksh OPERATION=$1
case $OPERATION in
START) echo "[RESULT]: Start operation request detected"
host_oper="StartDatabase";;
STOP) echo "[RESULT]: Stop operation request detected"
host_oper="StopDatabase";;
esac
/usr/sap/hostctrl/exe/saphostctrl -function ${host_oper} -dbname ${SID}_REP -
dbtype syb

9. Thank-­‐you