You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/backup/backup-azure-sap-hana-database-troubleshoot.md
+23-23Lines changed: 23 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Troubleshoot SAP HANA databases back up errors
3
3
description: Describes how to troubleshoot common errors that might occur when you use Azure Backup to back up SAP HANA databases.
4
4
ms.topic: troubleshooting
5
-
ms.date: 10/11/2023
5
+
ms.date: 07/30/2024
6
6
ms.service: backup
7
7
author: AbhishekMallick-MS
8
8
ms.author: v-abhmallick
@@ -15,7 +15,7 @@ This article provides troubleshooting information to back up SAP HANA databases
15
15
16
16
## Prerequisites and Permissions
17
17
18
-
Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [What the pre-registration script does](tutorial-backup-sap-hana-db.md#what-the-pre-registration-script-does) sections before configuring backups.
18
+
See the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [What the preregistration script does](tutorial-backup-sap-hana-db.md#what-the-pre-registration-script-does) sections before configuring backups.
19
19
20
20
## Common user errors
21
21
@@ -24,7 +24,7 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
24
24
|**Error message**|`Azure Backup does not have required role privileges to carry out Backup and Restore operations`|
|**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. |
27
-
|**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 are 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. |
27
+
|**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. |
28
28
29
29
### UserErrorInOpeningHanaOdbcConnection
30
30
@@ -44,8 +44,8 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
|**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 is not 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> |
48
-
|**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 do not see an auto-heal full backup triggered or any successful backup (Full/Differential/ Incremental) in 24 hours, contact Microsoft support.</br> |
47
+
|**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 terminates 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> |
48
+
|**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> |
49
49
50
50
### UserErrorSDCtoMDCUpgradeDetected
51
51
@@ -66,7 +66,7 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
66
66
|**Error message**|`The source and target systems for restore are incompatible.`|
67
67
|---------|---------|
68
68
|**Possible causes**| The restore flow fails with this error when the source and target HANA databases, and systems are incompatible. |
69
-
|Recommended action | Ensure that your restore scenario isn't in the following list of possible incompatible restores:<br> **Case 1:** SYSTEMDB cannot be renamed during restore.<br>**Case 2:** Source — SDC and target — MDC: The source database cannot 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) cannot be restored to the target.<br>To learn more, see the note **1642148** in the [SAP support launchpad](https://launchpad.support.sap.com). |
69
+
|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). |
70
70
71
71
### UserErrorHANAPODoesNotExist
72
72
@@ -79,14 +79,14 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
79
79
80
80
**Error message** | `Azure Backup does not have enough privileges to carry out Backup and Restore operations.`
81
81
---------- | ---------
82
-
**Possible causes** | Backup user (AZUREWLBACKUPHANAUSER) created by the pre-registration script doesn't have one or more of the following roles assigned:<ul><li>For MDC, DATABASE ADMIN and BACKUP ADMIN (for HANA 2.0 SPS05 and later) create new databases during restore.</li><li>For SDC, BACKUP ADMIN creates new databases during restore.</li><li>CATALOG READ to read the backup catalog.</li><li>SAP_INTERNAL_HANA_SUPPORT to access a few private tables. Only required for SDC and MDC versions prior to HANA 2.0 SPS04 Rev 46. It's not required for HANA 2.0 SPS04 Rev 46 and later. This is because we are getting the required information from public tables now with the fix from HANA team.</li></ul>
83
-
**Recommended action** | To resolve the issue, add the required roles and permissions manually to the Backup user (AZUREWLBACKUPHANAUSER). Or, you can download and run the pre-registration script on the [SAP HANA instance](https://aka.ms/scriptforpermsonhana).
82
+
**Possible causes** | Backup user (AZUREWLBACKUPHANAUSER) created by the preregistration script doesn't have one or more of the following roles assigned:<ul><li>For MDC, DATABASE ADMIN and BACKUP ADMIN (for HANA 2.0 SPS05 and later) create new databases during restore.</li><li>For SDC, BACKUP ADMIN creates new databases during restore.</li><li>CATALOG READ to read the backup catalog.</li><li>SAP_INTERNAL_HANA_SUPPORT to access a few private tables. Only required for SDC and MDC versions prior to HANA 2.0 SPS04 Rev 46. It's not required for HANA 2.0 SPS04 Rev 46 and later. This is because we're getting the required information from public tables now with the fix from HANA team.</li></ul>
83
+
**Recommended action** | To resolve the issue, add the required roles and permissions manually to the Backup user (AZUREWLBACKUPHANAUSER). Or, you can download and run the preregistration script on the [SAP HANA instance](https://aka.ms/scriptforpermsonhana).
**Possible causes** | The Database/Backup user created by the pre-registration script doesn't set expiry for the password. However, if it was altered, you may see this error.
89
+
**Possible causes** | The Database/Backup user created by the preregistration script doesn't set expiry for the password. However, if it was altered, you may see this error.
90
90
**Recommended action** | Download and run the [pre-registration script](https://aka.ms/scriptforpermsonhana) on the SAP HANA instance to resolve the issue.
91
91
92
92
### UserErrorInconsistentSSFS
@@ -100,7 +100,7 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
100
100
101
101
**Error message** | `Unable to connect to the AAD service from the HANA system.`
102
102
--------- | --------
103
-
**Possible causes** | Firewall or proxy settings as Backup extension's plugin service account is not allowing the outbound connection to Microsoft Entra ID.
103
+
**Possible causes** | Firewall or proxy settings as Backup extension's plugin service account isn't allowing the outbound connection to Microsoft Entra ID.
104
104
**Recommended action** | Fix the firewall or proxy settings for the outbound connection to Microsoft Entra ID to succeed.
105
105
106
106
### UserErrorMisConfiguredSslCaStore
@@ -139,7 +139,7 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
139
139
140
140
**Error message** | `Pre-registration script not run.`
141
141
--------- | --------
142
-
**Possible causes** | The SAP HANA pre-registration script to set up the environment has not been run.
142
+
**Possible causes** | The SAP HANA preregistration script to set up the environment hasn't been run.
143
143
**Recommended action** | Download and run the [pre-registration script](https://aka.ms/scriptforpermsonhana) on the SAP HANA instance.
144
144
145
145
@@ -161,14 +161,14 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
161
161
162
162
**Error message** | `Restored database name not in correct format.`
163
163
--------- | --------
164
-
**Possible causes** | The Restored database name that you have provided is not in the acceptable/expected format.
164
+
**Possible causes** | The Restored database name that you have provided isn't in the acceptable/expected format.
165
165
**Recommended action** | Ensure that the restored database name starts with a letter and shouldn't contain any symbol, other than digits or an underscore.<br>It can contain a maximum of 127 characters only and must not begin with "\_SYS_\".
**Possible causes** | The default **sid-adm** directory was changed, and **HDBSetting.sh**is not available in this default directory.
171
+
**Possible causes** | The default **sid-adm** directory was changed, and **HDBSetting.sh**isn't available in this default directory.
172
172
**Recommended action** | If HXE is the SID, ensure that environment variable HOME is set to _/usr/sap/HXE/home_ as **sid-adm** user.
173
173
174
174
### UserErrorHDBsettingsScriptNotFound
@@ -183,7 +183,7 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
183
183
**Error message** | `Insufficient space on HANA machine to perform Configure Backup, Backup or Restore activities.`
184
184
------------------- | --------------------------
185
185
**Possible causes** | The disk space on your HANA machine is almost full or full causing the Configure Backup, Backup, or Restore activitie(s) to fail.
186
-
**Recommended action** | Check the disk space on your HANA machine to ensure that there is enough space for the Configure Backup, Backup, or Restore activitie(s) to complete successfully.
186
+
**Recommended action** | Check the disk space on your HANA machine to ensure that there's enough space for the Configure Backup, Backup, or Restore activitie(s) to complete successfully.
187
187
188
188
### CloudDosAbsoluteLimitReached
189
189
@@ -196,15 +196,15 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
196
196
197
197
**Error message** | `Operation is blocked as the vault has reached its maximum limit for such operations permitted in a span of 24 hours.`
198
198
------ | -----------
199
-
**Possible causes** | When you've reached the maximum permissible limit for an operation in a span of 24 hours, this error appears. This error usually appears when there are at-scale operations such as modify policy or auto-protection. Unlike the case of CloudDosAbsoluteLimitReached, there isn't much you can do to resolve this state. In fact, Azure Backup service will retry the operations internally for all the items in question.<br><br> For example, if you've a large number of datasources protected with a policy and you try to modify that policy, it will trigger the configure protection jobs for each of the protected items and sometimes may hit the maximum limit permissible for such operations per day.
199
+
**Possible causes** | When you've reached the maximum permissible limit for an operation in a span of 24 hours, this error appears. This error usually appears when there are at-scale operations such as modify policy or auto-protection. Unlike the case of CloudDosAbsoluteLimitReached, there isn't much you can do to resolve this state. In fact, Azure Backup service will retry the operations internally for all the items in question.<br><br> For example, if you have a large number of datasources protected with a policy and you try to modify that policy, it'll trigger the configure protection jobs for each of the protected items and sometimes may hit the maximum limit permissible for such operations per day.
200
200
**Recommended action** | Azure Backup service will automatically retry this operation after 24 hours.
201
201
202
202
### UserErrorInvalidBackint
203
203
204
204
**Error message** | Found invalid hdbbackint executable.
205
205
--- | ---
206
206
**Possible cause** | 1. The operation to change Backint path from `/opt/msawb/bin` to `/usr/sap/<sid>/SYS/global/hdb/opt/hdbbackint` failed due to insufficient storage space in the new location. <br><br> 2. The *hdbbackint utility* located on `/usr/sap/<sid>/SYS/global/hdb/opt/hdbbackint` doesn't have executable permissions or correct ownership.
207
-
**Recommended action** | 1. Ensure that there is free space available on `/usr/sap/<sid>/SYS/global/hdb/opt/hdbbackint` or the path where you want to save backups. <br><br> 2. Ensure that *sapsys* group has appropriate permissions on the `/usr/sap/<sid>/SYS/global/hdb/opt/hdbbackint` file by running the command `chmod 755`.
207
+
**Recommended action** | 1. Ensure that there's free space available on `/usr/sap/<sid>/SYS/global/hdb/opt/hdbbackint` or the path where you want to save backups. <br><br> 2. Ensure that *sapsys* group has appropriate permissions on the `/usr/sap/<sid>/SYS/global/hdb/opt/hdbbackint` file by running the command `chmod 755`.
208
208
209
209
### UserErrorHanaSQLQueryFailed
210
210
@@ -232,7 +232,7 @@ Note the following points:
232
232
233
233
### Multiple Container Database (MDC) restore
234
234
235
-
In multiple container databases for HANA, the standard configuration is SYSTEMDB + 1 or more Tenant DBs. Restore of an entire SAP HANA instance restores both SYSTEMDB and Tenant DBs. One restores SYSTEMDB first and then proceeds for Tenant DB. System DB essentially means to override the system information on the selected target. This restore also overrides the BackInt related information in the target instance. So after the system DB is restored to a target instance, run the pre-registration script again. Only then the subsequent tenant DB restores will succeed.
235
+
In multiple container databases for HANA, the standard configuration is SYSTEMDB + 1 or more Tenant DBs. Restore of an entire SAP HANA instance restores both SYSTEMDB and Tenant DBs. One restores SYSTEMDB first and then proceeds for Tenant DB. System DB essentially means to override the system information on the selected target. This restore also overrides the BackInt related information in the target instance. So after the system DB is restored to a target instance, run the preregistration script again. Only then the subsequent tenant DB restores will succeed.
236
236
237
237
## Back up a replicated VM
238
238
@@ -245,7 +245,7 @@ This scenario could include two possible cases. Learn how to back up the replica
245
245
1. The new VM created has the same name, and is in the same resource group and subscription as the deleted VM.
246
246
247
247
- The extension is already present on the VM, but isn't visible to any of the services
248
-
- Run the pre-registration script
248
+
- Run the preregistration script
249
249
- Re-register the extension for the same machine in the Azure portal (**Backup** -> **View details** -> Select the relevant Azure VM -> Re-register)
250
250
- The already existing backed up databases (from the deleted VM) should then start successfully being backed up
251
251
@@ -257,7 +257,7 @@ This scenario could include two possible cases. Learn how to back up the replica
257
257
If so, then follow these steps:
258
258
259
259
- The extension is already present on the VM, but isn't visible to any of the services
260
-
- Run the pre-registration script
260
+
- Run the preregistration script
261
261
- If you discover and protect the new databases, you start seeing duplicate active databases in the portal. To avoid this, [Stop protection with retain data](sap-hana-db-manage.md#stop-protection-for-an-sap-hana-database) for the old databases. Then continue with the remaining steps.
262
262
- Discover the databases
263
263
- Enable backups on these databases
@@ -270,9 +270,9 @@ The original VM was replicated using Azure Site Recovery or Azure VM backup. The
270
270
Follow these steps to enable backups on the new VM:
271
271
272
272
- The extension is already present on the VM, but not visible to any of the services
273
-
- Run the pre-registration script. Based on the SID of the new VM, two scenarios can arise:
274
-
- The original VM and the new VM have the same SID. The pre-registration script runs successfully.
275
-
- The original VM and the new VM have different SIDs. The pre-registration script fails. Contact support to get help in this scenario.
273
+
- Run the preregistration script. Based on the SID of the new VM, two scenarios can arise:
274
+
- The original VM and the new VM have the same SID. The preregistration script runs successfully.
275
+
- The original VM and the new VM have different SIDs. The preregistration script fails. Contact support to get help in this scenario.
276
276
- Discover the databases that you want to back up
277
277
- Enable backups on these databases
278
278
@@ -333,6 +333,6 @@ These symptoms might arise for one or more of the following reasons:
333
333
334
334
In the preceding scenarios, we recommend that you trigger a re-register operation on the VM.
335
335
336
-
## Next steps
336
+
## Next step
337
337
338
338
- Review the [frequently asked questions](./sap-hana-faq-backup-azure-vm.yml) about the backup of SAP HANA databases on Azure VMs.
0 commit comments