Skip to content

Commit 5be8797

Browse files
Merge pull request #279579 from AbhishekMallick-MS/Jun-28-2024-EEE1
Addressed EEE doc ask #27916844
2 parents b385b47 + 8a36f8e commit 5be8797

File tree

1 file changed

+16
-9
lines changed

1 file changed

+16
-9
lines changed

articles/backup/backup-azure-sap-hana-database-troubleshoot.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Troubleshoot SAP HANA databases back up errors
33
description: Describes how to troubleshoot common errors that might occur when you use Azure Backup to back up SAP HANA databases.
44
ms.topic: troubleshooting
5-
ms.date: 09/10/2024
5+
ms.date: 09/30/2024
66
ms.service: azure-backup
77
author: AbhishekMallick-MS
88
ms.author: v-abhmallick
@@ -20,31 +20,31 @@ See the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [What
2020

2121
### UserErrorHANAInternalRoleNotPresent
2222

23-
| **Error message** | `Azure Backup does not have required role privileges to carry out Backup and Restore operations` |
23+
| **Error message** | `Azure Backup doesn't have required role privileges to carry out Backup and Restore operations` |
2424
| ---------------------- | ------------------------------------------------------------ |
25-
| **Possible causes** | All operations fail with this error when the Backup user (AZUREWLBACKUPHANAUSER) doesn't have the **SAP_INTERNAL_HANA_SUPPORT** role assigned or the role might have been overwritten. |
25+
| **Possible causes** | All operations fail with this error when the Backup user (AZUREWLBACKUPHANAUSER) doesn't have the **SAP_INTERNAL_HANA_SUPPORT** role assigned or the role might be overwritten. |
2626
| **Recommended action** | Download and run the [pre-registration script](https://aka.ms/scriptforpermsonhana) on the SAP HANA instance, or manually assign the **SAP_INTERNAL_HANA_SUPPORT** role to the Backup user (AZUREWLBACKUPHANAUSER).<br><br>**Note**<br><br>If you're using HANA 2.0 SPS04 Rev 46 and later, this error doesn't occur as the use of the **SAP_INTERNAL_HANA_SUPPORT** role is deprecated in these HANA versions. |
2727

2828
### UserErrorInOpeningHanaOdbcConnection
2929

3030
| **Error message** | `Failed to connect to HANA system` |
3131
| ------------------ | ------------------------------------------------------------ |
32-
| **Possible causes** | <ul><li>Connection to HANA instance failed</li><li>System DB is offline</li><li>Tenant DB is offline</li><li>Backup user (AZUREWLBACKUPHANAUSER) doesn't have enough permissions/privileges.</li></ul> |
32+
| **Possible causes** | <ul><li>Connection to HANA instance failed</li><li>System database (DB) is offline</li><li>Tenant DB is offline</li><li>Backup user (AZUREWLBACKUPHANAUSER) doesn't have enough permissions/privileges.</li></ul> |
3333
| **Recommended action** | Check if the system is running. If one or more databases is running, ensure that the required permissions are set. To do so, download and run the [pre-registration script](https://aka.ms/scriptforpermsonhana) on the SAP HANA instance. |
3434

3535
### UserErrorHanaInstanceNameInvalid
3636

3737
| **Error message** | `The specified SAP HANA instance is either invalid or can't be found` |
3838
| ------------------ | ------------------------------------------------------------ |
39-
| **Possible causes** | <ul><li>The specified SAP HANA instance is either invalid or can't be found.</li><li>Multiple SAP HANA instances on a single Azure VM can't be backed up.</li></ul> |
39+
| **Possible causes** | <ul><li>The specified SAP HANA instance is either invalid or can't be found.</li><li>Multiple SAP HANA instances on a single Azure Virtual Machine (VM) can't be backed up.</li></ul> |
4040
| **Recommended action** | <ul><li>Ensure that only one HANA instance is running on the Azure VM.</li><li> To resolve the issue, run the script from the _Discover DB_ pane (you can also find the script [here](https://aka.ms/scriptforpermsonhana)) with the correct SAP HANA instance.</li></ul> |
4141

4242
### UserErrorHANALSNValidationFailure
4343

4444
| **Error message** | `Backup log chain is broken` |
4545
| ------------------ | ------------------------------------------------------------ |
46-
| **Possible causes** | HANA LSN Log chain break can be triggered for various reasons, including:<ul><li>Azure Storage call failure to commit backup.</li><li>The Tenant DB is offline.</li><li>Extension upgrade has terminated an in-progress Backup job.</li><li>Unable to connect to Azure Storage during backup.</li><li>SAP HANA has rolled back a transaction in the backup process.</li><li>A backup is complete, but catalog isn't yet updated with success in HANA system.</li><li>Backup failed from Azure Backup perspective, but success from the perspective of HANA — the log backup/catalog destination might have been updated from Backint-to-file system, or the Backint executable might have been changed.</li></ul> |
47-
| **Recommended action** | To resolve this issue, Azure Backup triggers an autoheal Full backup. While this auto-heal backup is in progress, all log backups are triggered by HANA fail with **OperationCancelledBecauseConflictingAutohealOperationRunningUserError**. Once the autoheal Full backup is complete, logs and all other backups start working as expected.<br>If you don't see an autoheal full backup triggered or any successful backup (Full/Differential/ Incremental) in 24 hours, contact Microsoft support.</br> |
46+
| **Possible causes** | HANA LSN Log chain break can be triggered for various reasons, including:<ul><li>Azure Storage call failure to commit backup.</li><li>The Tenant DB is offline.</li><li>Extension upgrade is terminated an in-progress Backup job.</li><li>Unable to connect to Azure Storage during backup.</li><li>SAP HANA has rolled back a transaction in the backup process.</li><li>A backup is complete, but catalog isn't yet updated with success in HANA system.</li><li>Backup failed from Azure Backup perspective, but success from the perspective of HANA — the log backup/catalog destination might have been updated from Backint-to-file system, or the Backint executable might have been changed.</li></ul> |
47+
| **Recommended action** | To resolve this issue, Azure Backup triggers an auto-heal Full backup. While this auto-heal backup is in progress, all log backups are triggered by HANA fail with **OperationCancelledBecauseConflictingAutohealOperationRunningUserError**. Once the auto-heal Full backup is complete, logs and all other backups start working as expected.<br>If you don't see an auto-heal full backup triggered or any successful backup (Full/Differential/ Incremental) in 24 hours, contact Microsoft support.</br> |
4848

4949
### UserErrorSDCtoMDCUpgradeDetected
5050

@@ -65,11 +65,11 @@ See the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [What
6565
|**Error message** | `The source and target systems for restore are incompatible.` |
6666
|---------|---------|
6767
|**Possible causes** | The restore flow fails with this error when the source and target HANA databases, and systems are incompatible. |
68-
|Recommended action | Ensure that your restore scenario isn't in the following list of possible incompatible restores:<br> **Case 1:** SYSTEMDB can't be renamed during restore.<br>**Case 2:** Source - SDC and target - MDC: The source database can't be restored as SYSTEMDB or tenant DB on the target. <br> **Case 3:** Source — MDC and target — SDC: The source database (SYSTEMDB or tenant DB) can't be restored to the target.<br>To learn more, see the note **1642148** in the [SAP support launchpad](https://launchpad.support.sap.com). |
68+
|Recommended action | Ensure that your restore scenario isn't in the following list of possible incompatible restores:<br> **Case 1:** SYSTEMDB can't be renamed during restore.<br>**Case 2:** Source SDC and target MDC: The source database can't be restored as SYSTEMDB or tenant DB on the target. <br> **Case 3:** Source — MDC and target — SDC: The source database (SYSTEMDB or tenant DB) can't be restored to the target.<br>To learn more, see the note **1642148** in the [SAP support launchpad](https://launchpad.support.sap.com). |
6969

7070
### UserErrorHANAPODoesNotExist
7171

72-
**Error message** | `Database configured for backup does not exist.`
72+
**Error message** | `Database configured for backup doesn't exist.`
7373
--------- | --------------------------------
7474
**Possible causes** | If you delete a database that is configured for backup, all scheduled and on-demand backups on this database will fail.
7575
**Recommended action** | Verify if the database is deleted. Re-create the database or [stop protection](sap-hana-db-manage.md#stop-protection-for-an-sap-hana-database) (with or without retain data) for the database.
@@ -212,6 +212,13 @@ See the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [What
212212
**Possible causes** | - Disk corruption issue. <br> - Memory allocation issues. <br> - Too many databases in use. <br> - Topology update issue.
213213
**Recommended action** | Work with the SAP HANA team to fix this issue. However, if the issue persists, you can contact Microsoft support for further assistance.
214214

215+
### UserErrorRestoreTargetDirectoriesAbsent
216+
217+
| **Error Message** | `PreRestoreDataParamsPrep: Target directory` doesn't exist. |
218+
| --- | --- |
219+
| **Possible Causes** | Restore as files is failing due to *directory* that is selected for restore doesn't exist on the Target server or isn't accessible.
220+
| **Recommended action** | Verify the directory that you selected is available on the target server and ensure you have selected the correct target server at the time of restore. |
221+
215222
## Restore checks
216223

217224
### Single Container Database (SDC) restore

0 commit comments

Comments
 (0)