Merge pull request #109463 from prtyag/prtyag/enableKDUMPScriptPublicDoc

Add Kdump script public document

Author: GitHubber17

articles/virtual-machines/workloads/sap/hana-large-instance-enable-kdump.md

@@ -0,0 +1,90 @@
+---
+title: Script to enable Kdump in SAP HANA (Large Instances)| Microsoft Docs
+description: Script to enable Kdump in SAP HANA (Large Instances) HLI Type I, HLI Type II
+services: virtual-machines-linux
+documentationcenter:
+author: prtyag
+manager: hrushib
+editor:
+
+ms.service: virtual-machines-linux
+
+ms.topic: article
+ms.tgt_pltfrm: vm-linux
+ms.workload: infrastructure
+ms.date: 03/30/2020
+ms.author: prtyag
+ms.custom: H1Hack27Feb2017
+
+---
+
+# Enable Kdump service
+
+This document describes the details on how to enable Kdump service on Azure HANA Large
+Instance(**Type I and Type II**)
+
+## Supported SKUs
+
+|  Hana Large Instance type   |  OS vendor   |  OS package version   |  SKU	       |
+|-----------------------------|--------------|-----------------------|-------------|
+|   Type I                    |  SuSE        |   SLES 12 SP3         |  S224m      |
+|   Type I                    |  SuSE        |   SLES 12 SP4         |  S224m      |
+|   Type I                    |  SuSE        |   SLES 12 SP2         |  S72m       |
+|   Type I                    |  SuSE        |   SLES 12 SP3         |  S72m       |
+|   Type I                    |  SuSE        |   SLES 12 SP2         |  S96        |
+|   Type I                    |  SuSE        |   SLES 12 SP3         |  S96        |
+|   Type II                   |  SuSE        |   SLES 12 SP3         |  S384       |
+|   Type II                   |  SuSE        |   SLES 12 SP3         |  S576m      |
+|   Type II                   |  SuSE        |   SLES 12 SP3         |  S384xm     |
+|   Type II                   |  SuSE        |   SLES 12 SP4         |  S384xm     |
+
+## Prerequisites
+
+- Kdump service uses `/var/crash` directory to write dumps, make sure the partition corresponds to this directory has sufficient space to accommodate dumps.
+
+## Setup details
+
+- Script to enable Kdump can be found [here](https://github.com/Azure/sap-hana/blob/master/tools/enable-kdump.sh)
+
+- Run this script on HANA Large Instance using the below command
+
+    > [!NOTE]
+    > sudo privilege needed to run this command.
+
+    ```bash
+    sudo bash enable-kdump.sh
+    ```
+
+- If the command outputs Kdump is successfully enabled, please reboot the system to apply the change, then the Kdump is successfully enabled. Reboot the system to apply changes.
+
+- If the command output is Failed to do certain operation, Exiting!!!!, then Kdump service is not enabled. Refer to section [Support issue](#support-issue).
+
+## Test Kdump
+
+> [!NOTE]
+>  Below operation will trigger a kernel crash and system reboot.
+
+- Trigger a kernel crash
+
+    ```bash
+    echo 1 > /proc/sys/kernel/sysrq
+    echo c > /proc/sysrq-trigger
+    ```
+
+- After the system reboots successfully, check the `/var/crash` directory for kernel crash logs.
+
+- If the `/var/crash` has directory with current date, then the Kdump is successfully enabled.
+
+## Support issue
+
+If the script fails with an error or Kdump isn't enabled, raise service request with Microsoft support team with following details.
+
+* HLI subscription ID
+
+* Server name
+
+* OS vendor
+
+* OS version
+
+* Kernel version

articles/virtual-machines/workloads/sap/toc.yml

@@ -76,6 +76,8 @@
       href: ha-setup-with-stonith.md
     - name: OS Backup for Type II SKUs
       href: os-backup-type-ii-skus.md
+    - name: Enable Kdump for HANA Large Instances
+      href: hana-large-instance-enable-kdump.md
     - name: OS Upgrade for HANA Large Instances
       href: os-upgrade-hana-large-instance.md
     - name: Setting up SMT server for SUSE Linux