Skip to content

Commit 11c3629

Browse files
committed
Update in SLES documentation
1 parent ec110c8 commit 11c3629

7 files changed

+46
-31
lines changed

articles/sap/workloads/high-availability-guide-suse-netapp-files.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.service: sap-on-azure
99
ms.subservice: sap-vm-workloads
1010
ms.topic: article
1111
ms.workload: infrastructure-services
12-
ms.date: 07/17/2023
12+
ms.date: 09/15/2023
1313
ms.author: radeltch
1414
---
1515

@@ -663,6 +663,8 @@ The following items are prefixed with either **[A]** - applicable to all nodes,
663663
sudo crm configure colocation col_sap_QAS_no_both -5000: g-QAS_ERS g-QAS_ASCS
664664
sudo crm configure location loc_sap_QAS_failover_to_ers rsc_sap_QAS_ASCS00 rule 2000: runs_ers_QAS eq 1
665665
sudo crm configure order ord_sap_QAS_first_start_ascs Optional: rsc_sap_QAS_ASCS00:start rsc_sap_QAS_ERS01:stop symmetrical=false
666+
667+
sudo crm_attribute --delete --name priority-fencing-delay
666668
667669
sudo crm node online anftstsapcl1
668670
sudo crm configure property maintenance-mode="false"

articles/sap/workloads/high-availability-guide-suse-nfs-azure-files.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.service: sap-on-azure
99
ms.subservice: sap-vm-workloads
1010
ms.topic: tutorial
1111
ms.workload: infrastructure-services
12-
ms.date: 07/17/2023
12+
ms.date: 09/15/2023
1313
ms.author: radeltch
1414
---
1515

@@ -569,6 +569,8 @@ The following items are prefixed with either **[A]** - applicable to all nodes,
569569
sudo crm configure colocation col_sap_NW1_no_both -5000: g-NW1_ERS g-NW1_ASCS
570570
sudo crm configure location loc_sap_NW1_failover_to_ers rsc_sap_NW1_ASCS00 rule 2000: runs_ers_NW1 eq 1
571571
sudo crm configure order ord_sap_NW1_first_start_ascs Optional: rsc_sap_NW1_ASCS00:start rsc_sap_NW1_ERS01:stop symmetrical=false
572+
573+
sudo crm_attribute --delete --name priority-fencing-delay
572574
573575
sudo crm node online sap-cl1
574576
sudo crm configure property maintenance-mode="false"

articles/sap/workloads/high-availability-guide-suse-nfs-simple-mount.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.service: sap-on-azure
99
ms.subservice: sap-vm-workloads
1010
ms.topic: tutorial
1111
ms.workload: infrastructure-services
12-
ms.date: 07/17/2023
12+
ms.date: 09/15/2023
1313
ms.author: radeltch
1414
---
1515

@@ -700,6 +700,8 @@ The instructions in this section are applicable only if you're using Azure NetAp
700700
sudo crm configure location loc_sap_NW1_failover_to_ers rsc_sap_NW1_ASCS00 rule 2000: runs_ers_NW1 eq 1
701701
sudo crm configure order ord_sap_NW1_first_start_ascs Optional: rsc_sap_NW1_ASCS00:start rsc_sap_NW1_ERS01:stop symmetrical=false
702702
703+
sudo crm_attribute --delete --name priority-fencing-delay
704+
703705
sudo crm node online sap-cl1
704706
sudo crm configure property maintenance-mode="false"
705707
```

articles/sap/workloads/high-availability-guide-suse-pacemaker.md

Lines changed: 14 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.subservice: sap-vm-workloads
1010
ms.topic: article
1111
ms.workload: infrastructure-services
1212
ms.custom: devx-track-azurepowershell
13-
ms.date: 06/23/2023
13+
ms.date: 09/15/2023
1414
ms.author: radeltch
1515
---
1616

@@ -50,7 +50,7 @@ You can configure the SBD device by using either of two options:
5050
5151
- SBD with an Azure shared disk:
5252

53-
To configure an SBD device, you need to attach at least one [Azure shared disk](https://github.com/MicrosoftDocs/azure-docs/blob/master/articles/virtual-machines/disks-shared.md) to all virtual machines that are part of Pacemaker cluster. The advantage of SBD device using an Azure shared disk is that you dont need to deploy additional virtual machines.
53+
To configure an SBD device, you need to attach at least one [Azure shared disk](https://github.com/MicrosoftDocs/azure-docs/blob/master/articles/virtual-machines/disks-shared.md) to all virtual machines that are part of Pacemaker cluster. The advantage of SBD device using an Azure shared disk is that you don't need to deploy additional virtual machines.
5454

5555
![Diagram of the Azure shared disk SBD device for SLES Pacemaker cluster.](./media/high-availability-guide-suse-pacemaker/azure-shared-disk-sbd-device.png)
5656

@@ -63,7 +63,7 @@ You can configure the SBD device by using either of two options:
6363
- An SBD device using LRS for Azure premium shared disk (skuName - Premium_LRS) is only supported with deployment in availability set.
6464
- An SBD device using ZRS for an Azure premium shared disk (skuName - Premium_ZRS) is recommended with deployment in availability zones.
6565
- A ZRS for managed disk is currently unavailable in all regions with availability zones. For more information, review the ZRS "Limitations" section in [Redundancy options for managed disks](../../virtual-machines/disks-redundancy.md#limitations).
66-
- The Azure shared disk that you use for SBD devices doesnt need to be large. The [maxShares](../../virtual-machines/disks-shared-enable.md#disk-sizes) value determines how many cluster nodes can use the shared disk. For example, you can use P1 or P2 disk sizes for your SBD device on two-node cluster such as SAP ASCS/ERS or SAP HANA scale-up.
66+
- The Azure shared disk that you use for SBD devices doesn't need to be large. The [maxShares](../../virtual-machines/disks-shared-enable.md#disk-sizes) value determines how many cluster nodes can use the shared disk. For example, you can use P1 or P2 disk sizes for your SBD device on two-node cluster such as SAP ASCS/ERS or SAP HANA scale-up.
6767
- For [HANA scale-out with HANA system replication (HSR) and Pacemaker](sap-hana-high-availability-scale-out-hsr-suse.md), you can use an Azure shared disk for SBD devices in clusters with up to four nodes per replication site because of the current limit of [maxShares](../../virtual-machines/disks-shared-enable.md#disk-sizes).
6868
- We do *not* recommend attaching an Azure shared disk SBD device across Pacemaker clusters.
6969
- If you use multiple Azure shared disk SBD devices, check on the limit for a maximum number of data disks that can be attached to a VM.
@@ -239,6 +239,12 @@ Run the following commands on the nodes of the new cluster that you want to crea
239239
> - **[1]**: Applies only to node 1.
240240
> - **[2]**: Applies only to node 2.
241241
242+
1. **[A]** Install iSCSI package.
243+
244+
```bash
245+
sudo zypper install open-iscsi
246+
```
247+
242248
1. **[A]** Connect to the iSCSI devices. First, enable the iSCSI and SBD services.
243249

244250
```bash
@@ -911,7 +917,7 @@ Make sure to assign the custom role to the service principal at all VM (cluster
911917

912918
```bash
913919
sudo crm configure property stonith-enabled=true
914-
crm configure property concurrent-fencing=true
920+
sudo crm configure property concurrent-fencing=true
915921
```
916922

917923
> [!NOTE]
@@ -954,7 +960,7 @@ Make sure to assign the custom role to the service principal at all VM (cluster
954960
955961
## Configure Pacemaker for Azure scheduled events
956962
957-
Azure offers [scheduled events](../../virtual-machines/linux/scheduled-events.md). Scheduled events are provided via the metadata service and allow time for the application to prepare for such events. Resource agent [azure-events-az](https://github.com/ClusterLabs/resource-agents/pull/1161) monitors for scheduled Azure events. If events are detected and the resource agent determines that another cluster node is available, it sets a cluster health attribute. When the cluster health attribute is set for a node, the location constraint triggers and all resources, whose name doesnt start with health- are migrated away from the node with scheduled event. Once the affected cluster node is free of running cluster resources, scheduled event is acknowledged and can execute its action, such as restart.
963+
Azure offers [scheduled events](../../virtual-machines/linux/scheduled-events.md). Scheduled events are provided via the metadata service and allow time for the application to prepare for such events. Resource agent [azure-events-az](https://github.com/ClusterLabs/resource-agents/pull/1161) monitors for scheduled Azure events. If events are detected and the resource agent determines that another cluster node is available, it sets a cluster health attribute. When the cluster health attribute is set for a node, the location constraint triggers and all resources, whose name doesn't start with "health-" are migrated away from the node with scheduled event. Once the affected cluster node is free of running cluster resources, scheduled event is acknowledged and can execute its action, such as restart.
958964

959965
> [!IMPORTANT]
960966
> Previously, this document described the use of resource agent [azure-events](https://github.com/ClusterLabs/resource-agents/blob/main/heartbeat/azure-events.in). New resource agent [azure-events-az](https://github.com/ClusterLabs/resource-agents/blob/main/heartbeat/azure-events-az.in) fully supports Azure environments deployed in different availability zones.
@@ -978,6 +984,7 @@ Azure offers [scheduled events](../../virtual-machines/linux/scheduled-events.md
978984
```bash
979985
#Place the cluster in maintenance mode
980986
sudo crm configure property maintenance-mode=true
987+
```
981988

982989
3. **[1]** Set the pacemaker cluster health node strategy and constraint
983990

@@ -989,7 +996,7 @@ Azure offers [scheduled events](../../virtual-machines/linux/scheduled-events.md
989996

990997
> [!IMPORTANT]
991998
>
992-
> Don't define any other resources in the cluster starting with health-, besides the resources described in the next steps of the documentation.
999+
> Don't define any other resources in the cluster starting with "health-", besides the resources described in the next steps of the documentation.
9931000
9941001
4. **[1]** Set initial value of the cluster attributes.
9951002
Run for each cluster node. For scale-out environments including majority maker VM.
@@ -1000,7 +1007,7 @@ Azure offers [scheduled events](../../virtual-machines/linux/scheduled-events.md
10001007
```
10011008
10021009
5. **[1]** Configure the resources in Pacemaker.
1003-
Important: The resources must start with health-azure.
1010+
Important: The resources must start with 'health-azure'.
10041011
10051012
```bash
10061013
sudo crm configure primitive health-azure-events \

articles/sap/workloads/high-availability-guide-suse.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.service: sap-on-azure
99
ms.subservice: sap-vm-workloads
1010
ms.topic: article
1111
ms.workload: infrastructure-services
12-
ms.date: 07/17/2023
12+
ms.date: 09/15/2023
1313
ms.author: radeltch
1414
---
1515

@@ -512,6 +512,8 @@ The following items are prefixed with either **[A]** - applicable to all nodes,
512512
sudo crm configure colocation col_sap_NW1_no_both -5000: g-NW1_ERS g-NW1_ASCS
513513
sudo crm configure location loc_sap_NW1_failover_to_ers rsc_sap_NW1_ASCS00 rule 2000: runs_ers_NW1 eq 1
514514
sudo crm configure order ord_sap_NW1_first_start_ascs Optional: rsc_sap_NW1_ASCS00:start rsc_sap_NW1_ERS02:stop symmetrical=false
515+
516+
sudo crm_attribute --delete --name priority-fencing-delay
515517
516518
sudo crm node online nw1-cl-0
517519
sudo crm configure property maintenance-mode="false"

articles/sap/workloads/sap-hana-high-availability-netapp-files-suse.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.service: sap-on-azure
1111
ms.subservice: sap-vm-workloads
1212
ms.topic: tutorial
1313
ms.workload: infrastructure-services
14-
ms.date: 07/11/2023
14+
ms.date: 09/15/2023
1515
ms.author: ampatel
1616
---
1717

@@ -473,7 +473,7 @@ Create a dummy file system cluster resource, which monitors and reports failures
473473
```bash
474474
sudo crm configure primitive rsc_fs_check_HN1_HDB03 Filesystem params \
475475
device="/hana/shared/HN1/check/" \
476-
directory="/hana/shared/check/" fstype=nfs4 \
476+
directory="/hana/shared/check/" fstype=nfs \
477477
options="bind,defaults,rw,hard,rsize=262144,wsize=262144,proto=tcp,noatime,_netdev,nfsvers=4.1,lock,sec=sys" \
478478
op monitor interval=120 timeout=120 on-fail=fence \
479479
op_params OCF_CHECK_LEVEL=20 \

articles/sap/workloads/sap-hana-high-availability.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.service: sap-on-azure
99
ms.subservice: sap-vm-workloads
1010
ms.topic: article
1111
ms.workload: infrastructure
12-
ms.date: 06/23/2023
12+
ms.date: 09/15/2023
1313
ms.author: radeltch
1414

1515
---
@@ -207,7 +207,7 @@ Replace `<placeholders>` with the values for your SAP HANA installation.
207207
sudo mkfs.xfs /dev/vg_hana_log_<HANA SID>/hana_log
208208
sudo mkfs.xfs /dev/vg_hana_shared_<HANA SID>/hana_shared
209209
```
210-
210+
211211
1. Create the mount directories and copy the universally unique identifier (UUID) of all the logical volumes:
212212

213213
```bash
@@ -499,8 +499,8 @@ With susChkSrv implemented, an immediate and configurable action is executed. Th
499499
Run the following command as root:
500500
501501
```bash
502-
cat << EOF > /etc/sudoers.d/20-saphana
503-
# Needed for SAPHanaSR and susChkSrv Python hooks
502+
cat << EOF > /etc/sudoers.d/20-saphana
503+
# Needed for SAPHanaSR and susChkSrv Python hooks
504504
hn1adm ALL=(ALL) NOPASSWD: /usr/sbin/crm_attribute -n hana_hn1_site_srHook_*
505505
hn1adm ALL=(ALL) NOPASSWD: /usr/sbin/SAPHanaSR-hookHelper --sid=HN1 --case=fenceMe
506506
EOF
@@ -513,34 +513,34 @@ With susChkSrv implemented, an immediate and configurable action is executed. Th
513513
Run the following command as \<SAP SID\>adm:
514514
515515
```bash
516-
sapcontrol -nr <instance number> -function StartSystem
516+
sapcontrol -nr <instance number> -function StartSystem
517517
```
518518
519519
1. **[1]** Verify the hook installation.
520520
521521
Run the following command as \<SAP SID\>adm on the active HANA system replication site:
522522
523523
```bash
524-
cdtrace
525-
awk '/ha_dr_SAPHanaSR.*crm_attribute/ \
526-
{ printf "%s %s %s %s\n",$2,$3,$5,$16 }' nameserver_*
527-
# Example output
528-
# 2021-04-08 22:18:15.877583 ha_dr_SAPHanaSR SFAIL
529-
# 2021-04-08 22:18:46.531564 ha_dr_SAPHanaSR SFAIL
530-
# 2021-04-08 22:21:26.816573 ha_dr_SAPHanaSR SOK
524+
cdtrace
525+
awk '/ha_dr_SAPHanaSR.*crm_attribute/ \
526+
{ printf "%s %s %s %s\n",$2,$3,$5,$16 }' nameserver_*
527+
# Example output
528+
# 2021-04-08 22:18:15.877583 ha_dr_SAPHanaSR SFAIL
529+
# 2021-04-08 22:18:46.531564 ha_dr_SAPHanaSR SFAIL
530+
# 2021-04-08 22:21:26.816573 ha_dr_SAPHanaSR SOK
531531
```
532532
533533
Verify the susChkSrv hook installation.
534534
535535
Run the following command as \<SAP SID\>adm on all HANA VMs:
536536
537537
```bash
538-
cdtrace
539-
egrep '(LOST:|STOP:|START:|DOWN:|init|load|fail)' nameserver_suschksrv.trc
540-
# Example output
541-
# 2022-11-03 18:06:21.116728 susChkSrv.init() version 0.7.7, parameter info: action_on_lost=fence stop_timeout=20 kill_signal=9
542-
# 2022-11-03 18:06:27.613588 START: indexserver event looks like graceful tenant start
543-
# 2022-11-03 18:07:56.143766 START: indexserver event looks like graceful tenant start (indexserver started)
538+
cdtrace
539+
egrep '(LOST:|STOP:|START:|DOWN:|init|load|fail)' nameserver_suschksrv.trc
540+
# Example output
541+
# 2022-11-03 18:06:21.116728 susChkSrv.init() version 0.7.7, parameter info: action_on_lost=fence stop_timeout=20 kill_signal=9
542+
# 2022-11-03 18:06:27.613588 START: indexserver event looks like graceful tenant start
543+
# 2022-11-03 18:07:56.143766 START: indexserver event looks like graceful tenant start (indexserver started)
544544
```
545545
546546
## Create SAP HANA cluster resources

0 commit comments

Comments
 (0)