Skip to content

Commit 2afcf2a

Browse files
addressed acrolinx board
1 parent ab78b64 commit 2afcf2a

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

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

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Troubleshoot SAP HANA databases backup errors
2+
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
55
ms.date: 07/18/2023
@@ -43,7 +43,7 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
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 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> |
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 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> |
4747
| **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> |
4848

4949
### UserErrorSDCtoMDCUpgradeDetected
@@ -57,8 +57,8 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
5757

5858
| **Error message** | `Backups will fail with this error when the Backint Configuration is incorrectly updated.` |
5959
| ------------------ | ------------------------------------------------------------ |
60-
| **Possible causes** | The backint configuration updated during the Configure Protection flow by Azure Backup is either altered/updated by the customer. |
61-
| **Recommended action** | Check if the following (backint) parameters are set:<br><ul><li>[catalog_backup_using_backint:true]</li><li>[enable_accumulated_catalog_backup:false]</li><li>[parallel_data_backup_backint_channels:1]</li><li>[log_backup_timeout_s:900)]</li><li>[backint_response_timeout:7200]</li></ul>If backint-based parameters are present at the HOST level, remove them. However, if the parameters aren't present at the HOST level, but are manually modified at a database level, ensure that the database level values are set. Or, run [stop protection with retain backup data](./sap-hana-db-manage.md#stop-protection-for-an-sap-hana-database) from the Azure portal, and then select Resume backup. |
60+
| **Possible causes** | The Backint configuration updated during the Configure Protection flow by Azure Backup is either altered/updated by the customer. |
61+
| **Recommended action** | Check if the following (Backint) parameters are set:<br><ul><li> `[catalog_backup_using_backint:true]` </li><li> `[enable_accumulated_catalog_backup:false]` </li><li> `[parallel_data_backup_backint_channels:1]` </li><li> `[log_backup_timeout_s:900)]` </li><li> `[backint_response_timeout:7200]` </li></ul>If backint-based parameters are present at the HOST level, remove them. However, if the parameters aren't present at the HOST level, but are manually modified at a database level, ensure that the database level values are set. Or, run [stop protection with retain backup data](./sap-hana-db-manage.md#stop-protection-for-an-sap-hana-database) from the Azure portal, and then select Resume backup. |
6262

6363
### UserErrorIncompatibleSrcTargetSystemsForRestore
6464

@@ -99,8 +99,8 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
9999

100100
**Error message** | `Unable to connect to the AAD service from the HANA system.`
101101
--------- | --------
102-
**Possible causes** | Firewall or proxy settings as Backup extension's plugin service account is not allowing the outbound connection to AAD.
103-
**Recommended action** | Fix the firewall or proxy settings for the outbound connection to AAD to succeed.
102+
**Possible causes** | Firewall or proxy settings as Backup extension's plugin service account is not allowing the outbound connection to Azure Active Directory.
103+
**Recommended action** | Fix the firewall or proxy settings for the outbound connection to Azure Active Directory to succeed.
104104

105105
### UserErrorMisConfiguredSslCaStore
106106

@@ -195,7 +195,7 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
195195

196196
**Error message** | `Operation is blocked as the vault has reached its maximum limit for such operations permitted in a span of 24 hours.`
197197
------ | -----------
198-
**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 configure protection jobs for each of the protected items and sometimes may hit the maximum limit permissible for such operations per day.
198+
**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.
199199
**Recommended action** | Azure Backup service will automatically retry this operation after 24 hours.
200200

201201
### UserErrorInvalidBackint
@@ -216,16 +216,16 @@ Refer to the [prerequisites](tutorial-backup-sap-hana-db.md#prerequisites) and [
216216

217217
### Single Container Database (SDC) restore
218218

219-
Take care of inputs while restoring a single container database (SDC) for HANA to another SDC machine. The database name should be given with lowercase and with "sdc" appended in brackets. The HANA instance will be displayed in capitals.
219+
Take care of inputs while restoring a single container database (SDC) for HANA to another SDC machine. The database name should be given with lowercase and with `sdc` appended in brackets. The HANA instance will be displayed in capitals.
220220

221-
Assume an SDC HANA instance "H21" is backed up. The backup items page will show the backup item name as **"h21(sdc)"**. If you attempt to restore this database to another target SDC, say H11, then following inputs need to be provided.
221+
Assume an SDC HANA instance "H21" is backed up. The backup items page will show the backup item name as `h21(sdc)`. If you attempt to restore this database to another target SDC, say H11, then following inputs need to be provided.
222222

223223
![Restored SDC database name](media/backup-azure-sap-hana-database/hana-sdc-restore.png)
224224

225225
Note the following points:
226226

227-
- By default, the restored database name will be populated with the backup item name. In this case, h21(sdc).
228-
- Select the target as H11 won't change the restored database name automatically. **It should be edited to h11(sdc)**. Regarding SDC, the restored db name will be the target instance ID with lowercase letters and 'sdc' appended in brackets.
227+
- By default, the restored database name will be populated with the backup item name. In this case, `h21(sdc)`.
228+
- Select the target as H11 won't change the restored database name automatically. It should be edited to `h11(sdc)`. Regarding SDC, the restored db name will be the target instance ID with lowercase letters and `sdc` appended in brackets.
229229
- Since SDC can have only single database, you also need to select the checkbox to allow override of the existing database data with the recovery point data.
230230
- Linux is case-sensitive. So be careful to preserve the case.
231231

@@ -295,7 +295,7 @@ Upgrades from SDC to MDC that don't cause a SID change can be handled as follows
295295
- Rerun the [pre-registration script](https://aka.ms/scriptforpermsonhana)
296296
- Re-register the extension for the same machine in the Azure portal (**Backup** -> **View details** -> Select the relevant Azure VM -> Re-register)
297297
- Select **Rediscover DBs** for the same VM. This action should show the new DBs in step 3 as SYSTEMDB and Tenant DB, not SDC
298-
- The older SDC database continues to exist in the vault and have the old backed-up data retained according to the policy
298+
- The older SDC database continues to exist in the vault and has the old backed-up data retained according to the policy.
299299
- Configure backup for these databases
300300

301301
## SDC to MDC upgrade with a change in SID
@@ -309,7 +309,7 @@ Upgrades from SDC to MDC that cause a SID change can be handled as follows:
309309
- Rerun the [pre-registration script](https://aka.ms/scriptforpermsonhana) with correct details (new SID and MDC). Due to a change in SID, you might face issues with successful execution of the script. Contact Azure Backup support if you face issues.
310310
- Re-register the extension for the same machine in the Azure portal (**Backup** -> **View details** -> Select the relevant Azure VM -> Re-register).
311311
- Select **Rediscover DBs** for the same VM. This action should show the new DBs in step 3 as SYSTEMDB and Tenant DB, not SDC.
312-
- The older SDC database continues to exist in the vault and have old backed up data retained according to the policy.
312+
- The older SDC database continues to exist in the vault and has old backed-up data retained according to the policy.
313313
- Configure backup for these databases.
314314

315315
## Re-registration failures
@@ -334,4 +334,4 @@ In the preceding scenarios, we recommend that you trigger a re-register operatio
334334

335335
## Next steps
336336

337-
- Review the [frequently asked questions](./sap-hana-faq-backup-azure-vm.yml) about the back up of SAP HANA databases on Azure VMs.
337+
- 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

Comments
 (0)