SAP LVM Customer Instances
0 likes170 views
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.
![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](https://image.slidesharecdn.com/saplvmcustominstances-160226115127-160905183655/85/SAP-LVM-Customer-Instances-6-320.jpg)
![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](https://image.slidesharecdn.com/saplvmcustominstances-160226115127-160905183655/85/SAP-LVM-Customer-Instances-7-320.jpg)
![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](https://image.slidesharecdn.com/saplvmcustominstances-160226115127-160905183655/85/SAP-LVM-Customer-Instances-8-320.jpg)
SAP LVM Customer Instances
- 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