SAP LVM Add custom instance

LVM custom instance is a set of configuration files and scripts located under /usr/sap/hostctrl/exe/operations.d (complete configuration guide can be found in OSS Note 1396981).

As per OSS note 1396981 here is the naming convention for the configuration files:

acc_<instance Name>_list.conf – describes instance Name and SID

acc_<instance Name>_monitor.conf – describes how the instance is monitored (Stopped/Running)

acc_<instance Name>_start.conf – describes how to start the instance, e.g. points to a start-up shell script

acc_<instance Name>_stop.conf – describes how to stop the instance

Format of the instance description files

The format of each custom instance description files is described in OSS note 1396981. Below is a working example for custom instance of SOLR for BCM:

1). root@HOSTNAME:/usr/sap/hostctrl/exe/operations.d# cat acc_custom_apps_list.conf

Name: acc_custom_apps_list

Command: $[DIR_EXECUTABLE:#sapparam]/operations.d/custom_apps_List.sh

Description: list custom_apps services

Username: sidadm

ResultConverter: flat

Platform: Unix

2). root@HOSTNAME:/usr/sap/hostctrl/exe/operations.d # cat acc_CUSTOM_APPS_monitor.conf

Name: acc_CUSTOM_APPS_monitor

Command: $[DIR_EXECUTABLE:#sapparam]/operations.d/CUSTOM_APPS_Monitor.sh $[service_name]

Description: monitor BCM Solr

Username: solradm

ResultConverter: flat

Platform: Unix

3). root@HOSTNAME:/usr/sap/hostctrl/exe/operations.d # cat acc_CUSTOM_APPS_start.conf

Name: acc_CUSTOM_APPS_start

Command: /solr/bin/solr start

Description: Starts BCM Solr

Username: solradm

ResultConverter: hook

Platform: Unix

4).root@HOSTNAME:/usr/sap/hostctrl/exe/operations.d # cat acc_CUSTOM_APPS_stop.conf

Name: acc_CUSTOM_APPS_stop

Command: /solr/bin/solr stop

Description: Stops BCM Solr

Username: solradm

ResultConverter: hook

Platform: Unix

Below is an example of the scripts configured to be executed as configured in the above 4 files:

1). root@HOSTNAME:/usr/sap/hostctrl/exe/operations.d # cat CUSTOM_APPS_List.sh

#!/bin/bash

echo "service_name=Custom_apps;"

echo "system_sid=SID;"

2). root@HOSTNAME:/usr/sap/hostctrl/exe/operations.d # cat CUSTOM_APPS_Monitor.sh

#!/bin/bash

SERVICE=$1

proc=`ps -ef | grep server | grep solradm | grep -v grep | wc -l`

if [ $proc -eq "0" ];

then

echo "service_name=$SERVICE;service_status=Stopped"

else

echo "service_name=$SERVICE;service_status=Running"

fi

Once the files are created and placed under /usr/sap/hostctrl/exe/operations.d the custom instance needs to be detected from LVM:

Detect custom instance in LVM

Hit “Detect”, make sure that “Ignore Custom Instances” is unchecked.

Highlight only the relevant line (more than 1 custom instance may show up), and assign the right pool from the drop down box:

Hit “Next”

Validate that the system has been detected and status determined correctly: