Skip to content

Commit d2f28ef

Browse files
authored
Merge pull request #221979 from v-amallick/Dec-19-2022-CadDump
Catalog dumping GA release updates
2 parents a09ad32 + de7cf48 commit d2f28ef

File tree

3 files changed

+103
-108
lines changed

3 files changed

+103
-108
lines changed

articles/backup/backup-azure-vms-troubleshoot.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Troubleshoot backup errors with Azure VMs
33
description: In this article, learn how to troubleshoot errors encountered with backup and restore of Azure virtual machines.
44
ms.reviewer: srinathv
55
ms.topic: troubleshooting
6-
ms.date: 11/07/2022
6+
ms.date: 12/21/2022
77
author: v-amallick
88
ms.service: backup
99
ms.author: v-amallick
@@ -542,6 +542,9 @@ VM backup relies on issuing snapshot commands to underlying storage. Not having
542542
"USEVSSCOPYBACKUP"="TRUE"
543543
```
544544

545+
>[!Note]
546+
>From December 12, 2022, Azure VM backup automatically sets the registry key in the existing protected Azure VMs that are registered as SQL VMs. Now, you don't need to explicitly set this registry key. This ensures that snapshots aren't delayed and any log chains managed by other backup products are also not broken. Azure VM backup now also set the registry key in any new SQL VMs automatically during the configuration of backup.
547+
545548
* **VM status is reported incorrectly because the VM is shut down in RDP**. If you used the remote desktop to shut down the virtual machine, verify that the VM status in the portal is correct. If the status isn't correct, use the **Shutdown** option in the portal VM dashboard to shut down the VM.
546549
* **If more than four VMs share the same cloud service, spread the VMs across multiple backup policies**. Stagger the backup times, so no more than four VM backups start at the same time. Try to separate the start times in the policies by at least an hour.
547550
* **The VM runs at high CPU or memory**. If the virtual machine runs at high memory or CPU usage, more than 90 percent, your snapshot task is queued and delayed. Eventually it times out. If this issue happens, try an on-demand backup.

articles/backup/sap-hana-database-manage.md

Lines changed: 86 additions & 74 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: Manage backed up SAP HANA databases on Azure VMs
33
description: In this article, you'll learn common tasks for managing and monitoring SAP HANA databases that are running on Azure virtual machines.
4-
ms.topic: conceptual
5-
ms.date: 10/08/2022
4+
ms.topic: how-to
5+
ms.date: 12/21/2022
66
author: v-amallick
77
ms.service: backup
88
ms.custom: ignite-2022
@@ -20,7 +20,31 @@ You'll learn how to monitor jobs and alerts, trigger an on-demand backup, edit p
2020
2121
If you haven't configured backups yet for your SAP HANA databases, see [Back up SAP HANA databases on Azure VMs](./backup-azure-sap-hana-database.md). To earn more about the supported configurations and scenarios, see [Support matrix for backup of SAP HANA databases on Azure VMs](sap-hana-backup-support-matrix.md).
2222

23-
## Monitor manual backup jobs by using the Azure portal
23+
## Run on-demand backups
24+
25+
Backups run according to the policy schedule.
26+
27+
To run on-demand backups, follow these steps:
28+
29+
1. On the left pane of the Recovery Services vault, select **Backup items**.
30+
31+
![Screenshot that shows the 'Backup items' link on the Recovery Services vault dashboard.](./media/sap-hana-db-manage/backup-items.png)
32+
33+
1. On the **Backup Items** pane, select the VM that's running the SAP HANA database, and then select **Backup now**.
34+
35+
1. On the **Backup Now** pane, choose the type of backup that you want to perform, and then select **OK**.
36+
37+
The retention period of this backup is determined by the type of on-demand backup you want to run.
38+
39+
- *On-demand full backups* are retained for a minimum of *45 days* and a maximum of *99 years*.
40+
- *On-demand differential backups* are retained as per the *log retention set in the policy*.
41+
- *On-demand incremental backups* aren't currently supported.
42+
43+
1. Monitor the Azure portal notifications. To do so, on the Recovery Services vault dashboard, select **Backup Jobs**, and then select **In progress**.
44+
45+
Depending on the size of your database, creating the initial backup might take a while.
46+
47+
## Monitor manual backup jobs
2448

2549
Azure Backup shows all manually triggered jobs in the **Backup jobs** section of **Backup center**.
2650

@@ -32,7 +56,7 @@ The jobs that are displayed in the Azure portal include database discovery and r
3256

3357
To learn more about monitoring, go to [Monitor Azure Backup workloads in the Azure portal](./backup-azure-monitoring-built-in-monitor.md) and [Monitor at scale by using Azure Monitor](./backup-azure-monitoring-use-azuremonitor.md).
3458

35-
## View backup alerts
59+
## Monitor backup alerts
3660

3761
Alerts are an easy means of monitoring backups of SAP HANA databases. Alerts help you focus on the events you care about the most without getting lost in the multitude of events that a backup generates.
3862

@@ -58,63 +82,11 @@ With Azure Backup, you can send alerts by email. These alerts are:
5882
* Consolidated at the database level by error code.
5983
* Sent only for a database's first backup failure.
6084

61-
## Manage operations
62-
63-
Azure Backup supports several management operations that make it easy to manage a backed-up SAP HANA database. These operations are discussed in the following sections.
64-
65-
### Run on-demand backups
66-
67-
Backups run according to the policy schedule. You can run on-demand backups by doing the following:
68-
69-
1. On the left pane of the Recovery Services vault, select **Backup items**.
70-
71-
![Screenshot that shows the 'Backup items' link on the Recovery Services vault dashboard.](./media/sap-hana-db-manage/backup-items.png)
72-
73-
1. On the **Backup Items** pane, select the VM that's running the SAP HANA database, and then select **Backup now**.
74-
75-
1. On the **Backup Now** pane, choose the type of backup that you want to perform, and then select **OK**.
76-
77-
The retention period of this backup is determined by the type of on-demand backup you want to run.
78-
79-
- *On-demand full backups* are retained for a minimum of *45 days* and a maximum of *99 years*.
80-
- *On-demand differential backups* are retained as per the *log retention set in the policy*.
81-
- *On-demand incremental backups* aren't currently supported.
82-
83-
1. Monitor the Azure portal notifications. To do so, on the Recovery Services vault dashboard, select **Backup Jobs**, and then select **In progress**.
84-
85-
Depending on the size of your database, creating the initial backup might take a while.
86-
87-
### HANA native client integration
88-
89-
In the following sections, you'll learn how to trigger the backup and restore operations from non-Azure clients, such as HANA Studio.
90-
91-
> [!Note]
92-
> HANA native clients are integrated for Backint-based operations only. Snapshots and HANA System Replication mode-related operations are currently not supported.
93-
94-
#### Backup
95-
96-
On-demand backups that are triggered from any of the HANA native clients that use Backint are displayed in the backup list on the **Backup Instances** page.
97-
98-
![Screenshot that shows the 'Restore points' pane for viewing the most recently run backups.](./media/sap-hana-db-manage/last-backups.png)
99-
100-
> [!Note]
101-
> You can also [monitor the backups](#monitor-manual-backup-jobs-by-using-the-azure-portal) from the **Backup jobs** page.
102-
103-
These on-demand backups are also displayed in the list of restore points on the **Select restore point** pane.
104-
105-
![Screenshot that shows a list of restore points.](./media/sap-hana-db-manage/list-restore-points.png)
106-
107-
#### Restore
108-
109-
Restore operations that are triggered from HANA native clients that use Backint to restore backups *to the same machine* can be [monitored](#monitor-manual-backup-jobs-by-using-the-azure-portal) from the **Backup jobs** page.
110-
111-
Restore operations that are triggered from HANA native clients to restore *to another machine* are not allowed. This is because, according to Azure role-based access control (RBAC) rules, the Azure Backup service can't authenticate the target server for restore operations.
112-
113-
#### Delete
85+
## Manage operations using the Azure portal
11486

115-
The delete operation from HANA native clients is *not* supported by Azure Backup, because the backup policy determines the lifecycle of backups in the Azure Recovery services vault.
87+
This section describes several Azure Backup supported management operations that make it easy to manage a backed-up SAP HANA database.
11688

117-
### Change policy
89+
### Change a policy
11890

11991
You can change the underlying policy for an SAP HANA backup item.
12092

@@ -139,11 +111,11 @@ On the **Backup center** dashboard, go to **Backup Instances**, and then do the
139111

140112
1. Select **Save**.
141113

142-
![Screenshot that shows the 'Save' button for changing the backup policy change.](./media/sap-hana-db-manage/save-changes.png)
114+
![Screenshot that shows the 'Save' button for changing the backup policy change.](./media/sap-hana-db-manage/save-changes.png)
143115

144116
Making policy modifications affects all the associated backup items and triggers corresponding *configure protection* jobs.
145117

146-
### Modify the policy
118+
### Edit a policy
147119

148120
To modify the policy to change backup types, frequencies, and retention range, follow these steps:
149121

@@ -166,6 +138,10 @@ To modify the policy to change backup types, frequencies, and retention range, f
166138

167139
Modifying the backup policy affects all the associated backup items and triggers corresponding *configure protection* jobs.
168140

141+
### Upgrade from SDC to MDC
142+
143+
Learn how to continue backing up an [SAP HANA database after you upgrade from a single container database (SDC) to a multiple container database (MDC)](backup-azure-sap-hana-database-troubleshoot.md#sdc-to-mdc-upgrade-with-a-change-in-sid).
144+
169145
### Inconsistent policy
170146

171147
Occasionally, a *modify policy* operation can lead to an *inconsistent* policy version for some backup items. This happens when the corresponding *configure protection* job fails for the backup item after a modify policy operation is triggered. It appears as follows in the backup item view:
@@ -176,6 +152,14 @@ You can fix the policy version for all the impacted items in one click:
176152

177153
![Screenshot that shows the 'Fix Inconsistent Policy' pane.](./media/sap-hana-db-manage/fix-policy-version.png)
178154

155+
### Upgrade from SDC to MDC without a SID change
156+
157+
Learn how to continue backing up an [SAP HANA database whose SID hasn't changed after your upgrade from an SDC to an MDC](backup-azure-sap-hana-database-troubleshoot.md#sdc-to-mdc-upgrade-with-no-change-in-sid).
158+
159+
### Upgrade to a new version in either SDC or MDC
160+
161+
Learn how to continue backing up an [SAP HANA database whose version you're upgrading](backup-azure-sap-hana-database-troubleshoot.md#sdc-version-upgrade-or-mdc-version-upgrade-on-the-same-vm).
162+
179163
### Stop protection for an SAP HANA database or HANA instance
180164

181165
You can stop protecting an SAP HANA database in a couple of ways:
@@ -223,17 +207,11 @@ To resume protection for an SAP HANA database:
223207

224208
1. On the **Backup policy** menu, select a policy, and then select **Save**.
225209

226-
### Upgrade from SDC to MDC
227-
228-
Learn how to continue backing up an [SAP HANA database after you upgrade from a single container database (SDC) to a multiple container database (MDC)](backup-azure-sap-hana-database-troubleshoot.md#sdc-to-mdc-upgrade-with-a-change-in-sid).
229-
230-
### Upgrade from SDC to MDC without a SID change
231-
232-
Learn how to continue backing up an [SAP HANA database whose SID hasn't changed after you upgrade from an SDC to an MDC](backup-azure-sap-hana-database-troubleshoot.md#sdc-to-mdc-upgrade-with-no-change-in-sid).
210+
### Re-register an extension on the SAP HANA server VM
233211

234-
### Upgrade to a new version in either SDC or MDC
212+
The workload extension on the VM might sometimes be adversely affected for one reason or another. If it is, all operations that are triggered on the VM will begin to fail. You might then need to re-register the extension on the VM. The re-register operation reinstalls the workload backup extension on the VM for operations to continue.
235213

236-
Learn how to continue backing up an [SAP HANA database whose version you're upgrading](backup-azure-sap-hana-database-troubleshoot.md#sdc-version-upgrade-or-mdc-version-upgrade-on-the-same-vm).
214+
Use this option with caution: when it's triggered on a VM with an already healthy extension, the operation will cause the extension to restart. This might in turn cause all the in-progress jobs to fail. Before you trigger a re-register operation, [check for one or more of the symptoms](backup-azure-sap-hana-database-troubleshoot.md#re-registration-failures).
237215

238216
### Unregister an SAP HANA instance
239217

@@ -253,12 +231,46 @@ Unregister an SAP HANA instance after you disable protection but before you dele
253231

254232
![Select unregister](./media/sap-hana-db-manage/unregister.png)
255233

256-
### Re-register an extension on the SAP HANA server VM
234+
## Manage operations using SAP HANA native clients
257235

258-
The workload extension on the VM might sometimes be adversely affected for one reason or another. If it is, all operations that are triggered on the VM will begin to fail. You might then need to re-register the extension on the VM. The re-register operation reinstalls the workload backup extension on the VM for operations to continue.
236+
This section describes how to manage various operations from non-Azure clients, such as HANA Studio.
259237

260-
Use this option with caution: when it's triggered on a VM with an already healthy extension, the operation will cause the extension to restart. This might in turn cause all the in-progress jobs to fail. Before you trigger a re-register operation, [check for one or more of the symptoms](backup-azure-sap-hana-database-troubleshoot.md#re-registration-failures).
238+
> [!Note]
239+
> HANA native clients are integrated for Backint-based operations only. Snapshots and HANA System Replication mode-related operations are currently not supported.
240+
241+
### Backup via Backint
242+
243+
On-demand backups that are triggered from any of the HANA native clients that use Backint are displayed in the backup list on the **Backup Instances** page.
244+
245+
![Screenshot that shows the 'Restore points' pane for viewing the most recently run backups.](./media/sap-hana-db-manage/last-backups.png)
246+
247+
> [!Note]
248+
> You can also [monitor the backups](#monitor-manual-backup-jobs) from the **Backup jobs** page.
249+
250+
These on-demand backups are also displayed in the list of restore points on the **Select restore point** pane.
251+
252+
![Screenshot that shows a list of restore points.](./media/sap-hana-db-manage/list-restore-points.png)
253+
254+
#### Back up to local files instead of Backint
255+
256+
To back up local files, in the SAP HANA native client (HANA Studio/Cockpit), change the target to *local filesystem* instead of *Backint*.
257+
258+
Then HANA dumps the backups to the mentioned filesystem path and Azure Backup (the Backint service) places the subsequent catalog on that path using the `basepath_catalogbackup` parameter.
259+
260+
### Restore the backups
261+
262+
Restore operations that are triggered from HANA native clients that use Backint to restore backups *to the same machine* can be [monitored](#monitor-manual-backup-jobs) from the **Backup jobs** page.
263+
264+
Restore operations that are triggered from HANA native clients to restore *to another machine* aren't allowed. This is because, according to Azure role-based access control (RBAC) rules, the Azure Backup service can't authenticate the target server for restore operations.
265+
266+
### Delete the backups
267+
268+
The delete operation from HANA native clients isn't supported by Azure Backup, because the backup policy determines the lifecycle of backups in the Azure Recovery services vault.
269+
270+
### Clean up HANA catalog
271+
272+
The Azure Backup service currently doesn't modify the HANA backup catalog as per the policy. Because you can store the backup locally (outside of Backint), you need to maintain the lifecycle of the catalog. You can clean up the catalog as per the [SAP documentation](https://help.sap.com/docs/HANA_SERVICE_CF/7c78579ce9b14a669c1f3295b0d8ca16/22275913eb9e4a5bb539fc8df3da77f1.html) and Azure Backup (the Backint service) places the subsequent catalog in the path specified by the `basepath_catalogbackup` parameter.
261273

262274
## Next steps
263275

264-
* [Troubleshoot common issues with SAP HANA database backups](./backup-azure-sap-hana-database-troubleshoot.md)
276+
[Troubleshoot common issues with SAP HANA database backups](./backup-azure-sap-hana-database-troubleshoot.md)

0 commit comments

Comments
 (0)