SAP NW740 SLE12 SetupGuide en
SAP NW740 SLE12 SetupGuide en
SAP NW740 SLE12 SetupGuide en
SAP
1 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver
7.40 and 7.50
Date: 2020-04-03
SUSE® Linux Enterprise Server for SAP Applications is optimized in various ways
for SAP* applications. This document explains how to deploy an SAP NetWeaver
Enqueue Replication 1 High Availability Cluster solution. It is based on SUSE Linux
Enterprise Server for SAP Applications 12 and related service packs.
Disclaimer: Documents published as part of the SUSE Best Practices series have
been contributed voluntarily by SUSE employees and third parties. They are meant
to serve as examples of how particular actions can be performed. They have been
compiled with utmost attention to detail. However, this does not guarantee com-
plete accuracy. SUSE cannot verify that actions described in these documents do
what is claimed or whether actions described have unintended consequences. SUSE
LLC, its a#liates, the authors, and the translators may not be held liable for possible
errors or the consequences thereof.
2 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Contents
1 About this guide 4
3 Overview 6
4 SAP installation 17
6 Administration 30
7 References 34
8 Appendix 38
9 Legal notice 40
3 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
1 About this guide
1.1 Introduction
SUSE® Linux Enterprise Server for SAP Applications is the optimal platform to run SAP* ap-
plications with high availability (HA). Together with a redundant layout of the technical infra-
structure, single points of failure can be eliminated.
SAP* Business Suite is a sophisticated application platform for large enterprises and mid-size
companies. Many critical business environments require the highest possible SAP* application
availability.
The described cluster solution can be used for SAP* S/4 HANA and for SAP* SAP NetWeaver.
SAP NetWeaver is a common stack of middleware functionality used to support the SAP busi-
ness applications. The SAP Enqueue Replication Server constitutes application level redundan-
cy for one of the most crucial components of the SAP NetWeaver stack, the enqueue service.
An optimal effect of the enqueue replication mechanism can be achieved when combining the
application level redundancy with a high availability cluster solution as provided with SUSE
Linux Enterprise Server for SAP Applications. The described concept has proven its maturity
over several years of productive operations for customers of different sizes and branches.
4 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
1.3 Feedback
Several feedback channels are available:
Mail
For feedback on the documentation of this product, you can send a mail to doc-
team@suse.com (mailto:doc-team@suse.com) . Make sure to include the document title,
the product version and the publication date of the documentation. To report errors or
suggest enhancements, provide a concise description of the problem and refer to the re-
spective section number and page (or URL).
Plan a SUSE Linux Enterprise High Availability platform for SAP NetWeaver, including
SAP Enqueue Replication Server.
Set up a Linux high availability platform and perform a basic SAP NetWeaver installation
including SAP Enqueue Replication Server on SUSE Linux Enterprise.
Integrate the high availability cluster with the SAP control framework via sap-suse-clus-
ter-connector, as certified by SAP.
5 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
3 Overview
This guide describes how to set up a pacemaker cluster using SUSE Linux Enterprise Server for
SAP Applications 12 for the Enqueue Replication scenario. The goal is to match the SAP NW-
HA-CLU 7.40 certification specifications and goals.
These goals include:
Integration of the cluster with the SAP start framework sapstartsrv to ensure that mainte-
nance procedures do not break the cluster stability
The updated certification SAP NW-HA-CLU 7.40 has redefined some of the test procedures and
described new expectations how the cluster should behave in special conditions. These changes
allowed us to improve the cluster architecture and to design it for easier usage and setup.
Shared SAP resources are on a central NFS server.
The SAP instances themselves are installed on a shared disk to allow switching over the le
systems for proper functionality. The second need for a shared disk is that we are using the SBD
for the cluster fencing mechanism STONITH.
3.2 Three systems for ASCS, ERS, database and additional SAP
instances
This guide describes the installation of a distributed SAP system on three systems. In this setup,
only two systems are in the cluster. The database and SAP dialog instances could also be added
to the cluster by either adding the third node to the cluster or by installing the database on
either of the nodes. However we recommend to install the database on a separate cluster.
6 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Note
The cluster in this guide only manages the SAP instances ASCS and ERS, because of the
focus of the SAP NW-HA-CLU 7.40 certification.
If your database is SAP HANA, we recommend to set up the performance optimized system
replication scenario using our automation solution SAPHanaSR. The SAPHanaSR automation
should be set up in an own two node cluster. The setup is described in a separate best practices
document available at http://documentation.suse.com/sbp/sap .
active/active
VIP
aas AAS
VIP
pas PAS
ASCS VIP
ascs
VIP
ers ERS VIP
db DB
enqueue
replication
SAP (HA1)
SAP (HA1) SAP (HA1)
Database
ASCS ERS
PAS, AAS
CLUSTERED MACHINES
Hostname: sapha1as
Hostname: sapha1er
NON-CLUSTERED MACHINE
7 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Hostname: sapha1db
Hostname: sapha1d1
Hostname: sapha1d2
A perfect enhancement of the three node scenario described in this document is to implement
an SAP HANA system replication (SR) automation.
active/active active/active
VIP
pas PAS VIP
aas AAS
ASCS VIP
ascs
VIP
ers ERS VIP
db HANA HANA
enqueue system
replication replication
FIGURE 2: ONE CLUSTER FOR CENTRAL SERVICES, ONE FOR SAP HANA SR
8 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
3.3.2 Simple stack
Another option is to implement a second cluster for a database without SR aka "ANYDB". The
cluster resource agent SAPDatabase uses the SAPHOSTAGENT to control and monitor the data-
base.
active/active active/active
VIP
pas PAS
ASCS VIP
ascs
VIP
ers ERS VIP
db DB VIP
aas AAS
enqueue
replication
FIGURE 3: ONE CLUSTER FOR THE CENTRAL SERVICES AND ONE CLUSTER FOR THE ANY DATABASE
TABLE 1: THE FOLLOWING OS / DATABASES COMBINATION ARE EXAMPLES FOR THIS SCENARIO
MaxDB 7.9
ORACLE 12.1
9 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Note
First version for SAP NetWeaver on Power Little Endian is 7.50. More information about
supported combination of OS and Databases for SAP NetWeaver can be found at the SAP
Product Availability Matrix. (SAP PAM (https://apps.support.sap.com/sap/support/pam) )
3.4 Integration of SAP NetWeaver into the cluster using the Cluster
Connector
The integration of the HA cluster through the SAP control framework using the sap_suse_clus-
ter_connector is of special interest. The sapstartsrv controls SAP instances since SAP Kernel
versions 6.40. One of the classical problems running SAP instances in a highly available en-
vironment is the following: If an SAP administrator changes the status (start/stop) of an SAP
instance without using the interfaces provided by the cluster software, the cluster framework
will detect that as an error status and will bring the SAP instance into the old status by either
starting or stopping the SAP instance. This can result in very dangerous situations if the clus-
ter changes the status of an SAP instance during some SAP maintenance tasks. This new up-
dated solution enables the central component sapstartsrv to report state changes to the cluster
software, and therefore avoids the previously described dangerous situations. (See also blog
article "Using sap_vendor_cluster_connector for interaction between cluster framework and sap-
startsrv") (https://blogs.sap.com/2014/05/08/using-sapvendorclusterconnector-for-interaction-be-
tween-cluster-framework-and-sapstartsrv/comment-page-1/ ).
10 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
SAP Instance SUSE Linux Enterprise
Resource Agent3 High Availability Extension3
sapstartsrv
Web-Service Interface
sapcontrol
... 1
Provided by SAP
2
Legacy HA Solution Interface
3
Included in SLES for SAP Applications
FIGURE 4: CLUSTER CONNECTOR TO INTEGRATE THE CLUSTER WITH THE SAP START FRAMEWORK
Note
For this scenario we are using an updated version of the sap-suse-cluster-connector. This
version implements the API version 3 for the communication between the cluster frame-
work and the sapstartsrv.
The new version of the sap-suse-cluster-connector now allows to start, stop and 'move' an SAP
instance. The integration between the cluster software and the sapstartsrv also implements the
option to run checks of the HA setup using either the command line tool sapcontrol or the SAP
management consoles (SAP MMC or SAP MC).
11 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
3.5.1 Shared disk for cluster ASCS and ERS
The disk for the ASCS and ERS instances need to be shared and assigned to the cluster nodes
hacert01 and hacert02. Beside the partitions for the le systems for the SAP instances the disk
also provides the partition to be used as SBD.
On hacert01 prepare the le systems for the shared disk. Create three partitions on the shared
drive /dev/sdb:
partition two (/dev/sdb2) for the rst le system (10GB) formatted with XFS
partition three (/dev/sdb3) for the second le system (10GB) formatted with XFS
You could either use YaST to create partitions or using available command line tools. The fol-
lowing script could be used for non-interactive setups.
For these le systems we recommend to use plain partitions to keep the cluster configuration
as easy as possible. However you could also place these le systems in separate volume groups.
In that case you need to add further cluster resources to control the logical volume groups. This
is out of the scope of this setup guide.
After we have partitioned the shared disk on hacert01 we need to request a partition table rescan
on hacert02.
12 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
3.5.2 Disk for DB and cialog instances (MaxDB Example)
The disk for the database and primary application server is assigned to hacert03. In an advanced
setup this disk should be shared between hacert03 and an optional additional node building
an own cluster.
partition one (/dev/sdb1) for SBD (7M) - not used here but a reservation for an optional
second cluster
partition two (/dev/sdb2) for the Database (60GB) formatted with XFS
partition three (/dev/sdb3) for the second le system (10GB) formatted with XFS
partition four (/dev/sdb4) for the third le system (10GB) formatted with XFS
You could either use YaST to create partitions or using available command line tools. The fol-
lowing script could be used for non-interactive setups.
Note
D01 ⇒ Since NetWeaver 7.5, the primary application server instance directory has been
renamed. (D<Instance_Number>)
13 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
NFS SERVER
nfs1:/data/nfs/suseEnqReplNW7x/HA1/sapmnt /sapmnt
nfs1:/data/nfs/suseEnqReplNW7x/HA1/usrsapsys /usr/sap/HA1/SYS
MEDIA
nfs1:/data/SCT/media/SAP-MEDIA/NW74 /sapcd
or
nfs1:/data/SCT/media/SAP-MEDIA/NW75 /sapcd
192.168.201.111 hacert01
192.168.201.112 hacert02
192.168.201.113 hacert03
192.168.201.115 sapha1as
192.168.201.116 sapha1er
192.168.201.117 sapha1db
192.168.201.118 sapha1d1
192.168.201.119 sapha1d2
# mkdir -p /sapcd
14 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
# mkdir -p /sapmnt
# mkdir -p /usr/sap/HA1/{ASCS00,D02,DVEBMGS01,ERS10,SYS}
# mount -t nfs nfs1:/data/nfs/suseEnqReplNW7x/HA1/sapmnt /sapmnt
# mount -t nfs nfs1:/data/nfs/suseEnqReplNW7x/HA1/usrsapsys /usr/sap/HA1/SYS
# mount -t nfs nfs1:/data/SCT/media/SAP-MEDIA/NW74 /sapcd
# mkdir -p /sapcd
# mkdir -p /sapmnt
# mkdir -p /usr/sap/HA1/{ASCS00,D01,D02,ERS10,SYS}
# mount -t nfs nfs1:/data/nfs/suseEnqReplNW7x/HA1/sapmnt /sapmnt
# mount -t nfs nfs1:/data/nfs/suseEnqReplNW7x/HA1/usrsapsys /usr/sap/HA1/SYS
# mount -t nfs nfs1:/data/SCT/media/SAP-MEDIA/NW75 /sapcd
# mkdir -p /sapdb
# mkdir -p /hana/{shared,data,log}
As we do not control the NFS shares via the cluster in this setup, you should add these le
systems to /etc/fstab to get the le systems mounted during the next system boot.
NFS mounts
/sapdb
/usr/sap/<sid>/ /sapmnt
/usr/sap/<sid>/
ASCS00 /usr/sap/<sid>/
DVEBMGSxx
/usr/sap/<sid>/ SYS
/usr/sap/<sid>/
ERS10 Dyy
15 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
We prepare the three servers for the distributed SAP installation. Server 1 (hacert01) will be
used to install the ASCS SAP instance. Server 2 (hacert02) will be used to install the ERS SAP
instance. Server 3 (hacert03) will be used to install the dialog SAP instances and the database.
Mounting the instance and database le systems at one specific node:
# ls -la /usr/sap/HA1/
total 0
drwxr-xr-x 1 ha1adm sapsys 70 28. Mar 17:26 ./
drwxr-xr-x 1 root sapsys 58 28. Mar 16:49 ../
drwxr-xr-x 7 ha1adm sapsys 58 28. Mar 16:49 ASCS00/
drwxr-xr-x 1 ha1adm sapsys 0 28. Mar 15:59 D02/
drwxr-xr-x 1 ha1adm sapsys 0 28. Mar 15:59 D01/
drwxr-xr-x 1 ha1adm sapsys 0 28. Mar 15:59 ERS10/
drwxr-xr-x 5 ha1adm sapsys 87 28. Mar 17:21 SYS/
Note
The owner of the directory and les is changed during the SAP installation. By default
all of them are owned by root.
16 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
4 SAP installation
The overall procedure to install the distributed SAP is:
Preparing the ASCS and ERS installations for the cluster take-over
ASCS VIP
ascs
VIP
ers ERS VIP
db DB
17 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
User sapadm 3004
User h04adm 4001
SID id HA1
18 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
# mount /dev/sdb3 /usr/sap/HA1/ERS10
# cd /sapcd/SWPM/
# ./sapinst SAPINST_USE_HOSTNAME=sapha1er
If you get an error during the installation about permissions, change the ownership of the
ERS directory
If you get a prompt to manually stop/start the ASCS instance, log in at hacert01 as user
ha1adm and call sapcontrol.
On hacert01
# su - ha1adm
# sapcontrol -nr 00 -function Stop
# sapcontrol -nr 00 -function StopService
On hacert02
19 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
# su - ha1adm
# sapcontrol -nr 10 -function Stop
# sapcontrol -nr 10 -function StopService
Ensure /usr/sap/sapservices hold both entries (ASCS+ERS) on both cluster nodes. This allows
the sapstartsrv clients to start the service like (do not execute this at this point in time).
As user ha1adm
#!/bin/sh
LD_LIBRARY_PATH=/usr/sap/HA1/ASCS00/exe:$LD_LIBRARY_PATH; export LD_LIBRARY_PATH; /usr/
sap/HA1/ASCS00/exe/sapstartsrv pf=/usr/sap/HA1/SYS/profile/HA1_ASCS00_sapha1as -D -u
ha1adm
LD_LIBRARY_PATH=/usr/sap/HA1/ERS10/exe:$LD_LIBRARY_PATH; export LD_LIBRARY_PATH; /usr/
sap/HA1/ERS10/exe/sapstartsrv pf=/usr/sap/HA1/ERS10/profile/HA1_ERS10_sapha1er -D -u
ha1adm
# zypper in sap-suse-cluster-connector
Note
Be careful there are two packages available. The package sap_suse_cluster_connector con-
tinues to contain the old version 1.1.0 (SAP API 1). The package sap-suse-cluster-connec-
tor contains the new version 3.1.x (SAP API 3). The package sap-suse-cluster-connector
with version 3.1.x implements the SUSE SAP API version 3. New features like SAP Rolling
Kernel Switch (RKS) and the migration of ASCS are only supported with this new version.
For the ERS and ASCS instance edit the instance profiles HA1_ASCS00_sapha1as and
HA1_ERS10_sapha1er in the profile directory /usr/sap/HA1/SYS/profile/.
20 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
You need to tell the sapstartsrv to load the HA script connector library and to use the sap-
suse-cluster-connector . Additionally, make sure the feature Autostart is not used.
service/halib = $(DIR_EXECUTABLE)/saphascriptco.so
service/halib_cluster_connector = /usr/bin/sap_suse_cluster_connector
4.4.4 Adapting SAP profiles to match the SAP NW-HA-CLU 7.40 certification
For the ASCS, change the start command from Restart_Programm_xx to Start_Programm_xx for
the enqueue server (enserver). This change tells the SAP start framework not to self-restart the
enqueue process. Such a restart would lead in loss of the locks.
Optionally you could limit the number of restarts of services (in the case of ASCS this limits the
restart of the message server).
For the ERS change instance the start command from Restart_Programm_xx to Start_Programm_xx
for the enqueue replication server (enrepserver).
# su - ha1adm
# sapcontrol -nr 00 -function StartService HA1
# sapcontrol -nr 00 -function Start
On hacert02
# su - ha1adm
# sapcontrol -nr 10 -function StartService HA1
21 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
# sapcontrol -nr 10 -function Start
We are installing SAP NetWeaver 7.40 SR2 → MaxDB → SAP-Systems → Application Server
ABAP → High Availability System → DB
DB ID is HA1
We are installing SAP NetWeaver 7.5 → SAP HANA Database → Installation → Application
Server ABAP → High-Availability System → Database Instance
22 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Deselect using FQDN
Database parameters: enter DBSID is H04; Database Host is sapha1db; Instance Number
is 00
Database System ID: enter Instance Number is 00; SAP Mount Directory is /hana/shared
Clean up: select Yes, remove operating system users from group’sapinst'….
or alternatively:
23 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
No SLD
Install the cluster software if not already done during the installation of the operating
system
24 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Note
Before we continue to set up the cluster, we rst stop all SAP instances, remove the
(manual added) IP addresses on the cluster nodes and unmount the le systems which
will be controlled by the cluster later.
Note
The SBD device/partition need to be created in beforehand. In this setup guide we already
have reserved partition /dev/sdb1 for SBD usage.
TASKS
You can use either YaST to configure the cluster base or the interactive command line tool ha-
cluster-init. The following script can be used for automated setups.
# modprobe softdog
# echo "softdog" > /etc/modules-load.d/softdog.conf
# systemctl enable sbd
# ha-cluster-init -y -i eth0 -u -s /dev/sdb1
Keep in mind that a hardware watchdog is preferred instead of the softdog method.
# modprobe softdog
# echo "softdog" > /etc/modules-load.d/softdog.conf
# systemctl enable sbd
25 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
# rsync 192.168.201.111:/etc/sysconfig/sbd /etc/sysconfig
You can use either YaST to configure the cluster base or the interactive command line tool ha-
cluster-join. The following script can be used for automated setups.
Last updated: Thu Nov 21 14:25:53 2019 Last change: Thu Nov 21 14:23:21 2019 by ha1adm
via crm_resource on hacert01
Stack: corosync
Current DC: hacert01 (version 1.1.19-20181105.ccd6b5b10) - partition with quorum
2 nodes and 1 resource configured
After both nodes are listed in the overview, verify the property setting of the basic cluster
configuration. Very important here is the setting: record-pending=true.
26 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
For this there is a new functionality for the ASCS needed to follow the ERS. The ASCS needs to
mount the shared memory table of the ERS to avoid the loss of locks.
grp_SL1_ASCS00 grp_SL1_ERS10
rsc_fs_HA1_ASCS00 rsc_fs_HA1_ERS10
On
rsc_sap_HA1_ASCS00
Failure rsc_sap_HA1_ERS10 IS_ERS
migrate 1
Stickiness 3000
Follow ERS 2000
The implementation is done using the new ag "runs_ers_$SID" within the RA, enabled with help
of the resource parameter "IS_ERS=TRUE".
Another benefit of this concept is that we can now work with local (mountable) le systems
instead of a shared (NFS) le system for the SAP instance directories.
To avoid that the cluster starts partially defined resources, we set the cluster to the maintenance
mode. This deactivates all monitor actions.
As user root
First we configure the resources for the le system, IP address and the SAP instance. Of course
you need to adapt the parameters to your environment.
27 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
EXAMPLE 7: ASCS PRIMITIVE
group grp_HA1_ASCS00 \
rsc_ip_HA1_ASCS00 rsc_fs_HA1_ASCS00 rsc_sap_HA1_ASCS00 \
meta resource-stickiness=3000
Create a txt le (like crm_ascs.txt) with your preferred text editor, enter both examples (primi-
tives and group) to that le and load the configuration to the cluster manager configuration.
As user root
Second, we configure the resources for the le system, IP address and the SAP instance. Of
course you need to adapt the parameters to your environment.
The specific parameter IS_ERS=true should only be set for the ERS instance.
28 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
op start timeout=60s interval=0 \
op stop timeout=60s interval=0 \
op monitor interval=20s timeout=40s
primitive rsc_ip_HA1_ERS10 IPaddr2 \
params ip=192.168.201.116 \
op monitor interval=10s timeout=20s
primitive rsc_sap_HA1_ERS10 SAPInstance \
operations $id=rsc_sap_HA1_ERS10-operations \
op monitor interval=11 timeout=60 on-fail=restart \
params InstanceName=HA1_ERS10_sapha1er \
START_PROFILE="/sapmnt/HA1/profile/HA1_ERS10_sapha1er" \
AUTOMATIC_RECOVER=false IS_ERS=true \
meta priority=1000
group grp_HA1_ERS10 \
rsc_ip_HA1_ERS10 rsc_fs_HA1_ERS10 rsc_sap_HA1_ERS10
Create a txt le (like crm_ers.txt) with your preferred text editor, enter both examples (primitives
and group) to that le and load the configuration to the cluster manager configuration.
As user root
The constraints between the ASCS and ERS instance are needed to define that the ASCS
instance starts exactly on the cluster node running the ERS instance after a failure (loc_s-
ap_HA1_failover_to_ers). This constraint is needed to ensure that the locks are not lost after an
ASCS instance (or node) failure.
If the ASCS instance has been started by the cluster the ERS instance should be moved to an
"other" cluster node (col_sap_HA1_no_both). This constraint is needed to ensure that the ERS will
synchronize the locks again and the cluster is ready for an additional take-over.
29 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
order ord_sap_HA1_first_start_ascs Optional: rsc_sap_HA1_ASCS00:start \
rsc_sap_HA1_ERS10:stop symmetrical=false
Create a txt le (like crm_col.txt) with your preferred text editor, enter all three constraints to
that le and load the configuration to the cluster manager configuration.
As user root
Now the last step is to end the cluster maintenance mode and to allow the cluster to detect
already running resources.
As user root
6 Administration
For normal operation do not stop the ASCS SAP instance with any tool such as cluster tools or
SAP tools. The stop of the ASCS instance might lead to a loss of enqueue locks. Because following
the new SAP NW-HA-CLU 7.40 certification the cluster must allow local restarts of the ASCS.
This feature is needed to allow rolling kernel switch (RKS) updates without reconfiguring the
cluster.
Warning
Stopping the ASCS instance might lead into the loss of SAP enqueue locks during the start
of the ASCS on the same node.
30 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
6.1.2 How to move ASCS
To move the ASCS SAP instance you should use the SAP tools such as the SAP management
console. This will trigger sapstartsrv to use the sap-suse-cluster-connector to move the ASCS
instance. As user ha1adm you might call the following command to move-away the ASCS. The
move-away will always move the ASCS to the ERS side which will keep the SAP enqueue locks.
As ha1adm
With SAP NW-HA-CLU 7.40 it is not longer allowed to block resources from being controlled
manually. This using the variable BLOCK_RESOURCES in /etc/sysconfig/sap_suse_cluster_connector
is not allowed anymore.
Currently all SAP instance numbers controlled by the cluster must be unique. If you need
to have multiple dialog instances such as D00 running on different systems they should be not
controlled by the cluster.
The procedure to set the cluster into maintenance mode can be done as root or sidadm.
As user root
As user root
31 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
# crm configure property maintenance-mode="false"
How to clean up resource failures? Failures of the ASCS will be automatically deleted to allow
a failback after the configured period of time. For all other resources you can clean up the status
including the failures:
As user root
Warning
You should not clean up the complete group of the ASCS resource as this might lead
into an unwanted cluster action to take-over the complete group to the node where ERS
instance is running.
Check if the name of the SUSE cluster solution is shown in the output of sapcontrol or SAP
management console. This test checks the status of the SAP NetWeaver cluster integration.
As user ha1adm
32 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
# sapcontrol -nr 00 -function HACheckConfig
# sapcontrol -nr 00 -function HACheckFailoverConfig
Warning
This test will force the SAP system to lose the enqueue locks. This test should not be
processed during production.
33 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
As user ha1adm
Check the recoverable and non-recoverable outage of the message server process
7 References
For more information, see the documents listed below.
7.1 Pacemaker
Pacemaker 1.1 Configuration Explained: https://clusterlabs.org/pacemaker/doc/en-US/
Pacemaker/1.1/html/Pacemaker_Explained/
corosync_overview(8)
34 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
crm(8)
crm_mon(8)
crm_simulate(8)
cs_clusterstate(8)
cs_man2pdf(8)
mount.nfs(8)
ocf_heartbeat_IPAddr2(7)
ocf_heartbeat_SAPInstance(7)
ocf_suse_SAPStartSrv(7)
sapping(7)
sapservices-move(8)
SAPStartSrv_basic_cluster(7)
sap_suse_cluster_connector(8)
sbd(8)
stonith_sbd(7)
systemctl(8)
usermod(8)
votequorum(5)
zypper (8)
SAP S/4 HANA - Enqueue Replication 2 High Availability Cluster - Setup Guide (https://
www.suse.com/support/kb/doc/?id=7023714 )
35 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Integration of sap-suse-cluster-connector does not work as expected (https://
www.suse.com/support/kb/doc/?id=000019244 )
1763512 - Support details for SUSE Linux Enterprise for SAP Applications (https://launch-
pad.support.sap.com/#/notes/1763512/E )
1944799 - SAP HANA Guidelines for SLES Operating System Installation (https://launch-
pad.support.sap.com/#/notes/1944799 )
36 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
2205917 - SAP HANA DB: Recommended OS settings for SLES 12 / SLES for SAP Applica-
tions 12 (https://launchpad.support.sap.com/#/notes/2205917 )
2308598 - Error "Ifconfig is obsolete" happens when you run startsap to start SAP system
(https://launchpad.support.sap.com/#/notes/2308598 )
2684254 - SAP HANA DB: Recommended OS settings for SLES 15 / SLES for SAP Applica-
tions 15 (https://launchpad.support.sap.com/#/notes/2684254 )
2855499 - FAIL: RKS Warning(s): Unsupported SCS instance with additional gateway found
(https://launchpad.support.sap.com/#/notes/2855499 )
2992028 - SYB: Fault Manager: install Fault Manager in separated instance (https://launch-
pad.support.sap.com/#/notes/2992028 )
3139184 - Linux: systemd integration for sapstartsrv and SAP Hostagent (https://launch-
pad.support.sap.com/#/notes/3139184 )
37 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
8 Appendix
## nodes
38 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
params pcmk_delay_max=30s
property cib-bootstrap-options: \
have-watchdog=true \
dc-version=1.1.19-20181105.ccd6b5b10 \
cluster-infrastructure=corosync \
cluster-name=hacluster \
stonith-enabled=true \
last-lrm-refresh=1494346532
rsc_defaults rsc-options: \
resource-stickiness=1 \
migration-threshold=3
op_defaults op-options: \
timeout=600 \
record-pending=true
39 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
9 Legal notice
Copyright © 2006–2022 SUSE LLC and contributors. All rights reserved.
Permission is granted to copy, distribute and/or modify this document under the terms of the
GNU Free Documentation License, Version 1.2 or (at your option) version 1.3; with the Invariant
Section being this copyright notice and license. A copy of the license version 1.2 is included in
the section entitled "GNU Free Documentation License".
SUSE, the SUSE logo and YaST are registered trademarks of SUSE LLC in the United States and
other countries. For SUSE trademarks, see https://www.suse.com/company/legal/ .
Linux is a registered trademark of Linus Torvalds. All other names or trademarks mentioned in
this document may be trademarks or registered trademarks of their respective owners.
Documents published as part of the SUSE Best Practices series have been contributed voluntarily
by SUSE employees and third parties. They are meant to serve as examples of how particular
actions can be performed. They have been compiled with utmost attention to detail. However,
this does not guarantee complete accuracy. SUSE cannot verify that actions described in these
documents do what is claimed or whether actions described have unintended consequences.
SUSE LLC, its affiliates, the authors, and the translators may not be held liable for possible errors
or the consequences thereof.
Below we draw your attention to the license under which the articles are published.
40 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
10 GNU Free Documentation License
Copyright © 2000, 2001, 2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston,
MA 02110-1301 USA. Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.
0. PREAMBLE
The purpose of this License is to make a manual, textbook, or other functional and useful docu-
ment "free" in the sense of freedom: to assure everyone the effective freedom to copy and redis-
tribute it, with or without modifying it, either commercially or noncommercially. Secondarily,
this License preserves for the author and publisher a way to get credit for their work, while not
being considered responsible for modifications made by others.
This License is a kind of "copyleft", which means that derivative works of the document must
themselves be free in the same sense. It complements the GNU General Public License, which
is a copyleft license designed for free software.
We have designed this License in order to use it for manuals for free software, because free
software needs free documentation: a free program should come with manuals providing the
same freedoms that the software does. But this License is not limited to software manuals; it
can be used for any textual work, regardless of subject matter or whether it is published as a
printed book. We recommend this License principally for works whose purpose is instruction
or reference.
41 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
A "Secondary Section" is a named appendix or a front-matter section of the Document that deals
exclusively with the relationship of the publishers or authors of the Document to the Document’s
overall subject (or to related matters) and contains nothing that could fall directly within that
overall subject. (Thus, if the Document is in part a textbook of mathematics, a Secondary Section
may not explain any mathematics.) The relationship could be a matter of historical connection
with the subject or with related matters, or of legal, commercial, philosophical, ethical or po-
litical position regarding them.
The "Invariant Sections" are certain Secondary Sections whose titles are designated, as being
those of Invariant Sections, in the notice that says that the Document is released under this
License. If a section does not t the above definition of Secondary then it is not allowed to be
designated as Invariant. The Document may contain zero Invariant Sections. If the Document
does not identify any Invariant Sections then there are none.
The "Cover Texts" are certain short passages of text that are listed, as Front-Cover Texts or Back-
Cover Texts, in the notice that says that the Document is released under this License. A Front-
Cover Text may be at most 5 words, and a Back-Cover Text may be at most 25 words.
A "Transparent" copy of the Document means a machine-readable copy, represented in a format
whose specification is available to the general public, that is suitable for revising the document
straightforwardly with generic text editors or (for images composed of pixels) generic paint
programs or (for drawings) some widely available drawing editor, and that is suitable for input
to text formatters or for automatic translation to a variety of formats suitable for input to text
formatters. A copy made in an otherwise Transparent le format whose markup, or absence of
markup, has been arranged to thwart or discourage subsequent modification by readers is not
Transparent. An image format is not Transparent if used for any substantial amount of text. A
copy that is not "Transparent" is called "Opaque".
Examples of suitable formats for Transparent copies include plain ASCII without markup, Tex-
info input format, LaTeX input format, SGML or XML using a publicly available DTD, and stan-
dard-conforming simple HTML, PostScript or PDF designed for human modification. Examples
of transparent image formats include PNG, XCF and JPG. Opaque formats include proprietary
formats that can be read and edited only by proprietary word processors, SGML or XML for
which the DTD and/or processing tools are not generally available, and the machine-generated
HTML, PostScript or PDF produced by some word processors for output purposes only.
The "Title Page" means, for a printed book, the title page itself, plus such following pages as are
needed to hold, legibly, the material this License requires to appear in the title page. For works
in formats which do not have any title page as such, "Title Page" means the text near the most
prominent appearance of the work’s title, preceding the beginning of the body of the text.
42 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
A section "Entitled XYZ" means a named subunit of the Document whose title either is precisely
XYZ or contains XYZ in parentheses following text that translates XYZ in another language.
(Here XYZ stands for a specific section name mentioned below, such as "Acknowledgements",
"Dedications", "Endorsements", or "History".) To "Preserve the Title" of such a section when you
modify the Document means that it remains a section "Entitled XYZ" according to this definition.
The Document may include Warranty Disclaimers next to the notice which states that this Li-
cense applies to the Document. These Warranty Disclaimers are considered to be included by
reference in this License, but only as regards disclaiming warranties: any other implication that
these Warranty Disclaimers may have is void and has no effect on the meaning of this License.
2. VERBATIM COPYING
You may copy and distribute the Document in any medium, either commercially or noncom-
mercially, provided that this License, the copyright notices, and the license notice saying this
License applies to the Document are reproduced in all copies, and that you add no other condi-
tions whatsoever to those of this License. You may not use technical measures to obstruct or
control the reading or further copying of the copies you make or distribute. However, you may
accept compensation in exchange for copies. If you distribute a large enough number of copies
you must also follow the conditions in section 3.
You may also lend copies, under the same conditions stated above, and you may publicly display
copies.
3. COPYING IN QUANTITY
If you publish printed copies (or copies in media that commonly have printed covers) of the
Document, numbering more than 100, and the Document’s license notice requires Cover Texts,
you must enclose the copies in covers that carry, clearly and legibly, all these Cover Texts: Front-
Cover Texts on the front cover, and Back-Cover Texts on the back cover. Both covers must also
clearly and legibly identify you as the publisher of these copies. The front cover must present the
full title with all words of the title equally prominent and visible. You may add other material
on the covers in addition. Copying with changes limited to the covers, as long as they preserve
the title of the Document and satisfy these conditions, can be treated as verbatim copying in
other respects.
43 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
If the required texts for either cover are too voluminous to t legibly, you should put the rst
ones listed (as many as t reasonably) on the actual cover, and continue the rest onto adjacent
pages.
If you publish or distribute Opaque copies of the Document numbering more than 100, you must
either include a machine-readable Transparent copy along with each Opaque copy, or state in
or with each Opaque copy a computer-network location from which the general network-using
public has access to download using public-standard network protocols a complete Transparent
copy of the Document, free of added material. If you use the latter option, you must take rea-
sonably prudent steps, when you begin distribution of Opaque copies in quantity, to ensure that
this Transparent copy will remain thus accessible at the stated location until at least one year
after the last time you distribute an Opaque copy (directly or through your agents or retailers)
of that edition to the public.
It is requested, but not required, that you contact the authors of the Document well before
redistributing any large number of copies, to give them a chance to provide you with an updated
version of the Document.
4. MODIFICATIONS
You may copy and distribute a Modified Version of the Document under the conditions of sec-
tions 2 and 3 above, provided that you release the Modified Version under precisely this License,
with the Modified Version filling the role of the Document, thus licensing distribution and mod-
ification of the Modified Version to whoever possesses a copy of it. In addition, you must do
these things in the Modified Version:
A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document,
and from those of previous versions (which should, if there were any, be listed in the
History section of the Document). You may use the same title as a previous version if the
original publisher of that version gives permission.
B. List on the Title Page, as authors, one or more persons or entities responsible for authorship
of the modifications in the Modified Version, together with at least ve of the principal
authors of the Document (all of its principal authors, if it has fewer than ve), unless they
release you from this requirement.
C. State on the Title page the name of the publisher of the Modified Version, as the publisher.
44 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
E. Add an appropriate copyright notice for your modifications adjacent to the other copyright
notices.
F. Include, immediately after the copyright notices, a license notice giving the public permis-
sion to use the Modified Version under the terms of this License, in the form shown in
the Addendum below.
G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts
given in the Document’s license notice.
I. Preserve the section Entitled "History", Preserve its Title, and add to it an item stating at
least the title, year, new authors, and publisher of the Modified Version as given on the
Title Page. If there is no section Entitled "History" in the Document, create one stating the
title, year, authors, and publisher of the Document as given on its Title Page, then add an
item describing the Modified Version as stated in the previous sentence.
J. Preserve the network location, if any, given in the Document for public access to a Trans-
parent copy of the Document, and likewise the network locations given in the Document
for previous versions it was based on. These may be placed in the "History" section. You
may omit a network location for a work that was published at least four years before the
Document itself, or if the original publisher of the version it refers to gives permission.
K. For any section Entitled "Acknowledgements" or "Dedications", Preserve the Title of the
section, and preserve in the section all the substance and tone of each of the contributor
acknowledgements and/or dedications given therein.
L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their
titles. Section numbers or the equivalent are not considered part of the section titles.
M. Delete any section Entitled "Endorsements". Such a section may not be included in the
Modified Version.
N. Do not retitle any existing section to be Entitled "Endorsements" or to conflict in title with
any Invariant Section.
45 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
If the Modified Version includes new front-matter sections or appendices that qualify as Se-
condary Sections and contain no material copied from the Document, you may at your option
designate some or all of these sections as invariant. To do this, add their titles to the list of
Invariant Sections in the Modified Version’s license notice. These titles must be distinct from
any other section titles.
You may add a section Entitled "Endorsements", provided it contains nothing but endorsements
of your Modified Version by various parties—for example, statements of peer review or that the
text has been approved by an organization as the authoritative definition of a standard.
You may add a passage of up to ve words as a Front-Cover Text, and a passage of up to 25
words as a Back-Cover Text, to the end of the list of Cover Texts in the Modified Version. Only
one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through
arrangements made by) any one entity. If the Document already includes a cover text for the
same cover, previously added by you or by arrangement made by the same entity you are acting
on behalf of, you may not add another; but you may replace the old one, on explicit permission
from the previous publisher that added the old one.
The author(s) and publisher(s) of the Document do not by this License give permission to use
their names for publicity for or to assert or imply endorsement of any Modified Version.
5. COMBINING DOCUMENTS
You may combine the Document with other documents released under this License, under the
terms defined in section 4 above for modified versions, provided that you include in the combi-
nation all of the Invariant Sections of all of the original documents, unmodified, and list them
all as Invariant Sections of your combined work in its license notice, and that you preserve all
their Warranty Disclaimers.
The combined work need only contain one copy of this License, and multiple identical Invariant
Sections may be replaced with a single copy. If there are multiple Invariant Sections with the
same name but different contents, make the title of each such section unique by adding at the
end of it, in parentheses, the name of the original author or publisher of that section if known,
or else a unique number. Make the same adjustment to the section titles in the list of Invariant
Sections in the license notice of the combined work.
46 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
In the combination, you must combine any sections Entitled "History" in the various original
documents, forming one section Entitled "History"; likewise combine any sections Entitled "Ac-
knowledgements", and any sections Entitled "Dedications". You must delete all sections Entitled
"Endorsements".
6. COLLECTIONS OF DOCUMENTS
You may make a collection consisting of the Document and other documents released under
this License, and replace the individual copies of this License in the various documents with a
single copy that is included in the collection, provided that you follow the rules of this License
for verbatim copying of each of the documents in all other respects.
You may extract a single document from such a collection, and distribute it individually under
this License, provided you insert a copy of this License into the extracted document, and follow
this License in all other respects regarding verbatim copying of that document.
8. TRANSLATION
Translation is considered a kind of modification, so you may distribute translations of the Doc-
ument under the terms of section 4. Replacing Invariant Sections with translations requires spe-
cial permission from their copyright holders, but you may include translations of some or all
47 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
Invariant Sections in addition to the original versions of these Invariant Sections. You may in-
clude a translation of this License, and all the license notices in the Document, and any War-
ranty Disclaimers, provided that you also include the original English version of this License
and the original versions of those notices and disclaimers. In case of a disagreement between
the translation and the original version of this License or a notice or disclaimer, the original
version will prevail.
If a section in the Document is Entitled "Acknowledgements", "Dedications", or "History", the
requirement (section 4) to Preserve its Title (section 1) will typically require changing the actual
title.
9. TERMINATION
You may not copy, modify, sublicense, or distribute the Document except as expressly provided
for under this License. Any other attempt to copy, modify, sublicense or distribute the Document
is void, and will automatically terminate your rights under this License. However, parties who
have received copies, or rights, from you under this License will not have their licenses termi-
nated so long as such parties remain in full compliance.
48 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled “GNU
Free Documentation License”.
If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, replace the “ with…
Texts.” line with this:
with the Invariant Sections being LIST THEIR TITLES, with the
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
If you have Invariant Sections without Cover Texts, or some other combination of the three,
merge those two alternatives to suit the situation.
If your document contains nontrivial examples of program code, we recommend releasing these
examples in parallel under your choice of free software license, such as the GNU General Public
License, to permit their use in free software.
49 SAP NetWeaver Enqueue Replication 1 High Availability Cluster - SAP NetWeaver 7.40 and 7.50