Skip to content

Commit 68fbef3

Browse files
committed
HANA scale-out susChkSrv
1 parent 2af6d03 commit 68fbef3

File tree

1 file changed

+16
-15
lines changed

1 file changed

+16
-15
lines changed

articles/virtual-machines/workloads/sap/sap-hana-high-availability-scale-out-hsr-suse.md

Lines changed: 16 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -820,24 +820,24 @@ Create a dummy file system cluster resource, which will monitor and report failu
820820

821821
## Implement HANA hooks SAPHanaSR and susChkSrv
822822

823-
This important step is to optimize the integration with the cluster and detection when a cluster failover is possible. It is highly recommended to configure the SAPHanaSR-ScaleOut Python hook. For HANA 2.0 SP5 and above, implementing SAPHanaSR, along with susChkSrv hook is recommended.
823+
This important step is to optimize the integration with the cluster and detection when a cluster failover is possible. It is highly recommended to configure the SAPHanaSR Python hook. For HANA 2.0 SP5 and above, implementing both SAPHanaSR and susChkSrv hook is recommended.
824824

825825
SusChkSrv extends the functionality of the main SAPHanaSR HA provider. It acts in the situation when HANA process hdbindexserver crashes. If a single process crashes typically HANA tries to restart it. Restarting the indexserver process can take a long time, during which the HANA database is not responsive.
826826

827-
With susChkSrv implemented, an immediate and configurable action is executed, instead of waiting on hdbindexserver process to restart on the same node. In HANA scale-out susChkSrv acts independently for every HANA VM. The configured action will kill HANA or fence the affected VM, which triggers a failover by SAPHanaSR in the configured timeout period.
827+
With susChkSrv implemented, an immediate and configurable action is executed, instead of waiting on hdbindexserver process to restart on the same node. In HANA scale-out susChkSrv acts for every HANA VM independently. The configured action will kill HANA or fence the affected VM, which triggers a failover by SAPHanaSR in the configured timeout period.
828828

829829
> [!NOTE]
830830
> susChkSrv Python hook requires SAP HANA 2.0 SP5 and SAPHanaSR-ScaleOut version 0.184.1 or higher must be installed.
831831

832-
1. **[1,2]** Install the HANA "system replication hook". The hook needs to be installed on one HANA DB node on each system replication site.
832+
1. **[1,2]** Stop HANA on both system replication sites. Execute as <sid\>adm:
833833

834-
1. Stop HANA on both system replication sites. Execute as <sid\>adm:
835-
```bash
836-
sapcontrol -nr 03 -function StopSystem
837-
```
834+
```bash
835+
sapcontrol -nr 03 -function StopSystem
836+
```
837+
838+
2. **[1,2]** Adjust `global.ini` on each cluster site. If the requirements for susChkSrv hook are not met, remove the entire block `[ha_dr_provider_suschksrv]` from below section.
839+
You can adjust the behavior of susChkSrv with parameter action_on_lost. Valid values are [ ignore | stop | kill | fence ].
838840

839-
3. Adjust `global.ini` on each cluster site. If the requirements for susChkSrv hook are not met, remove the entire block `[ha_dr_provider_suschksrv]` from below section.
840-
You can adjust the behavior of susChkSrv with parameter action_on_lost. Valid values are [ ignore | stop | kill | fence ].
841841
```bash
842842
# add to global.ini
843843
[ha_dr_provider_SAPHanaSR]
@@ -850,14 +850,15 @@ With susChkSrv implemented, an immediate and configurable action is executed, in
850850
path = /usr/share/SAPHanaSR-ScaleOut
851851
execution_order = 3
852852
action_on_lost = kill
853-
853+
854854
[trace]
855855
ha_dr_saphanasr = info
856856
```
857857

858-
Configuration pointing to the standard location /usr/share/SAPHanaSR-ScaleOut, brings a benefit, that the python hook code is automatically updated through OS or package updates and it gets used by HANA at next restart. With an optional, own path, such as /hana/shared/myHooks you can decouple OS updates from the used hook version.
858+
Configuration pointing to the standard location /usr/share/SAPHanaSR-ScaleOut brings a benefit, that the python hook code is automatically updated through OS or package updates and it gets used by HANA at next restart. With an optional, own path, such as /hana/shared/myHooks you can decouple OS updates from the used hook version.
859+
860+
3. **[AH]** The cluster requires sudoers configuration on the cluster node for <sid\>adm. In this example that is achieved by creating a new file. Execute the commands as `root` adapt the values of hn1/HN1 with correct SID.
859861

860-
2. **[AH]** The cluster requires sudoers configuration on the cluster node for <sid\>adm. In this example that is achieved by creating a new file. Execute the commands as `root` adapt the values of hn1/HN1 with correct SID.
861862
```bash
862863
cat << EOF > /etc/sudoers.d/20-saphana
863864
# SAPHanaSR-ScaleOut needs for srHook
@@ -868,13 +869,13 @@ With susChkSrv implemented, an immediate and configurable action is executed, in
868869
EOF
869870
```
870871
871-
3. **[1,2]** Start SAP HANA on both replication sites. Execute as <sid\>adm.
872+
4. **[1,2]** Start SAP HANA on both replication sites. Execute as <sid\>adm.
872873
873874
```bash
874875
sapcontrol -nr 03 -function StartSystem
875876
```
876877
877-
4. **[1]** Verify the hook installation. Execute as <sid\>adm on the active HANA system replication site.
878+
5. **[1]** Verify the hook installation. Execute as <sid\>adm on the active HANA system replication site.
878879
879880
```bash
880881
cdtrace
@@ -889,7 +890,7 @@ With susChkSrv implemented, an immediate and configurable action is executed, in
889890
# 2021-03-31 01:04:15.062181 ha_dr_SAPHanaSR SOK
890891
```
891892
892-
Verify the susChkSrv hook installation. Execute as <sid\>adm on all HANA VMs
893+
Verify the susChkSrv hook installation. Execute as <sid\>adm on all HANA VMs
893894
```bash
894895
cdtrace
895896
egrep '(LOST:|STOP:|START:|DOWN:|init|load|fail)' nameserver_suschksrv.trc

0 commit comments

Comments
 (0)