configuring sap hana backup, recovery, database copy · pdf filesap hana backups configuring...

TECHNICAL NOTE

This technical note provides details about using SAP HANA Studio to configure the EMC Data Domain Boost for Enterprise Applications and EMC ProtectPoint database application agent versions 1.0, 2.x and 3.0 for backup, recovery, database copy, and deletion operations. All the operations and screens described in this document use SAP HANA 1.00.100 and SAP HANA Studio 1.0.100.

Note: The database application agent 1.0 was formerly known as DDBDA 1.0.

Topics include:

◆ Revision history ........................................................................................................ 2◆ What is SAP HANA? ................................................................................................... 2◆ SAP HANA backups ................................................................................................... 2◆ What is SAP HANA Studio? ........................................................................................ 4◆ Configuring the database application agent operations with SAP HANA Studio .......... 4◆ Performing data backups with SAP HANA Studio ....................................................... 6◆ Performing data recovery with SAP HANA Studio...................................................... 10◆ Deleting backups with SAP HANA Studio ................................................................. 20

EMC® Data Domain® Boost for Enterprise Applications andEMC ProtectPoint™ Database Application AgentVersions 1.0, 2.x, and 3.0

Configuring SAP HANA Backup, Recovery, Database Copy, and Deletion with SAP HANA StudioP/N 302-001-022REV 02

July 22, 2016

Revision history

Revision historyThe following table presents the revision history of this document.

What is SAP HANA?SAP HANA Enterprise 1.0 is an in-memory computing appliance that combines SAP database software with pretuned server, storage, and networking hardware from one of several SAP hardware partners. SAP HANA is designed to support real-time analytical and transactional processing.

As an appliance, SAP HANA combines SAP software components tuned for optimal performance on the certified hardware. The SAP HANA Platform Edition provides several SAP components, including the SAP HANA database, SAP HANA Studio, and SAP HANA clients.

The SAP HANA article What is SAP HANA? provides details about the real-time benefits of the SAP HANA database software.

SAP HANA backupsIn-memory data in SAP HANA is constantly written from the memory to persistent storage on the disk at regular save points. SAP HANA data protection is also achieved by using data backups and log backups. These backups can be performed to the file system or by using third-party backup binaries, such as the database application agent binary hdbbackint. You can perform the backups while the database is online.

The SAP HANA article Backup and Recovery - SAP HANA provides details about SAP HANA backup and recovery. The database application agent supports backups when SAP HANA is installed as either a single-container database or multi-container database.

Revision Date Description

02 July 22, 2016 Updated the following information:• Changed the product name DDBDA to database application

agent throughout the document.• “SAP HANA backups” on page 2—Added details in this topic

and its subtopics about support of container databases and delta (incremental and differential) backups.

• “Configuring the database application agent operations with SAP HANA Studio” on page 4—Added the last paragraph about distributing the backups from different databases into different subspaces in the Data Domain system.

• “Performing data backups with SAP HANA Studio” on page 6 - Updated details about backup settings in SAP HANA Studio.

• “Performing data recovery with SAP HANA Studio” on page 10 - Updated the screens and specific content n the subtopics.

• “Appendix” on page 21 - Added this topic with command-line examples of backups and recovery.

01 May 12, 2014 Initial release of this technical note.

2 Configuring SAP HANA Backup, Recovery, Database Copy, and Deletion with SAP HANA Studio Technical Note

http://www.saphana.com/docs/DOC-2272


SAP HANA backups

Data backups

You can configure a data backup in SAP HANA Studio. You can also manually start a data backup in SAP HANA Studio. Before a data backup can be performed in SAP HANA Studio, you must meet the following prerequisites:

◆ Create a database user or use an existing database user with the necessary privileges and authorizations. A backup in SAP HANA can only be performed by a database user.

◆ The database user must have the BACKUP ADMIN system privilege to perform the backup or recovery operation.

◆ The database user must have the CATALOG READ system privilege to collect the information that the backup wizard requires.

The SAP HANA database backs up its services (nameserver, nameserver topology, indexserver, xsengine, and statisticserver) in parallel to the file system or to Backint as implemented with a third-party backup tool.

Delta backups

Starting with SAP HANA SPS 10, SAP HANA supports the following types of delta backups:

◆ Incremental backups—An incremental backup stores the data that has changed since either the last data backup or the last delta backup (incremental or differential).

◆ Differential backups—A differential backup stores the data that has changed since the last data backup.

Log backups

Log backups in SAP HANA back up the log segments and depend on the SAP HANA log mode as configured in the global.ini file. Automatic log backups are enabled by default in the global.ini file, but you can change this default configuration. The log mode is also set to normal mode by default.

Log backups are performed independently of data backups at the interval specified in the global.ini file with the parameter log_backup_timeout_s.

A log backup of the redo log segment is performed when any of the following scenarios occur:

◆ A data change occurs, and the log segment is full.◆ The log segment is closed after exceeding the configured time threshold.◆ The database is started.◆ The log backup interval configuration is changed.

Note: A delta backup (incremental or differential) contains actual data, whereas a log backup contains redo log entries.

Configuring SAP HANA Backup, Recovery, Database Copy, and Deletion with SAP HANA Studio Technical Note 3

What is SAP HANA Studio?

What is SAP HANA Studio?SAP HANA Studio is an interface for users to manage the SAP HANA database, create and manage user authorizations, and create new or modify existing data models in the SAP HANA database. By using this tool, a user can configure multiple SAP HANA databases to the same Studio and manage the backup and recovery operations.

To connect to a SAP HANA instance, you must know the server where the instance is running and the instance number. You also need the required username and password to connect to the instance. Once the instance is added, the left-side navigator space shows all the SAP HANA instances that are available in SAP HANA Studio. At that point, you can perform backups and recovery in SAP HANA Studio.

The SAP HANA article Overview - SAP HANA Studio provides more details.

Configuring the database application agent operations with SAP HANA Studio

Note: Before you use SAP HANA Studio to configure the database application agent operations, ensure that you have configured the lockbox, set up the hdbbackint file, and set the required parameters in the configuration file. The EMC Data Domain Boost for Enterprise Applications and EMC ProtectPoint Database Application Agent Installation and Administration Guide provides detailed instructions.

In SAP HANA Studio, you must specify the location of the configuration file for the database application agent backups.

1. Expand the database instance, double-click Backup in the Systems view, and then click the Configuration tab.

2. Expand Backint Settings, and then type the complete pathname of the configuration file in the Backint Parameter File text box under Data Backup.

The following figure shows an example of the configuration file setting for the data backups.



Configuring the database application agent operations with SAP HANA Studio

Figure 1 Configuration file setting for data backups

You can specify either the same configuration file or a different configuration file for the log backups. To use the same configuration file for both data backups and log backups, select Use the same parameter file for data backup and log backup under Data Backup. Then the same configuration file pathname automatically appears in the Backint Parameter File text box under Log Backup, as shown in the following figure.

Figure 2 Configuration file setting for both data backups and log backups

To configure automatic log backups, complete the settings in the Log Backup Settings group box:

◆ Select Enable Automatic Log Backup.◆ Select Backint for the Destination Type.◆ Specify the log backup interval in Backup Interval.


Performing data backups with SAP HANA Studio

Specify the log backup interval based on the requirements of the particular environment. Every deployment has different requirements. Do not specify a very short interval or long interval. A short backup interval triggers too many backups and creates too many smaller backup files on the Data Domain system, which impacts the system performance. A longer backup interval causes more logs to be stored in the SAP HANA memory and reduces the speed of all the database operations.

You can specify File as the Destination Type so that log backups are performed to the local file system while data backups are performed to the Data Domain system. However, it is best to perform both data and log backups to either the file system or the Data Domain system.

Note: The log backup settings are disabled if the log mode is set to overwrite. Set the log mode to normal to enable the log backup settings. The SAP HANA Administration Guide provides more details.

You can use different CLIENT parameter settings in the database application agent configuration file to distribute the backups from different databases into different subspaces in the Data Domain system. The backup save sets and indexes are stored in different folder structures to ensure faster recovery operations.


Note: You can also perform all the SAP HANA data backups by using the hdbsql command at the command line, instead of using SAP HANA Studio. “Appendix” on page 21 provides examples of backup commands.

You can start a data backup manually in SAP HANA Studio. Right-click the database instance, and select Back Up from the displayed menu. You can select to back up either the SYSTEMDB database or the tenant database, as shown in the following figure.

Figure 3 Menu option to start a backup



Complete the required settings in the Specify Backup Settings dialog box:

◆ In the Backup Type field, select one of the backup types:

• Complete Data Backup• Differential Data Backup• Incremental Data Backup

You can use both incremental and differential backups in your backup strategy.

◆ In the Destination Type field, select Backint.

◆ In the Backup Prefix field, optionally type a prefix for the backup name. If you specify a prefix, then the backup name includes the prefix, prefix_databackup_#_#.

The following three figures show the settings in the Specify Backup Settings dialog box for the three supported types of SAP HANA backups.

Figure 4 Settings in Specify Backup Settings dialog box for a complete data backup



Figure 5 Settings in Specify Backup Settings dialog box for a differential backup

Figure 6 Settings in Specify Backup Settings dialog box for an incremental backup

Click Next to confirm the summary details of the backup, and then click Finish to start the backup. All the services are backed up in parallel, as shown in the following figure.



Figure 7 Progress of the backup

After the backup is complete, you can obtain the backup details from the backup catalog that is listed on the Backup Catalog tab. The backup catalog lists all the log backups and data backups and the backup details, such as the backup duration, throughput, and size of the data sets. By default, delta backups are hidden on the Backup Catalog tab. To display the delta backups, select Show Delta Backups.

The following figure shows the backup catalog display for a successful backup.

Figure 8 Backup catalog information for a successful backup


Performing data recovery with SAP HANA Studio


Note: You can also perform the SAP HANA data recoveries (except for recoveries of tenant databases) by using the HDBSettings.sh utility at the command line, instead of using SAP HANA Studio. Recoveries of tenant databases are not supported with the HDBSettings.sh utility. “Appendix” on page 21 provides examples of recoveries with the utility.

Recovery of a database is required when the database data or log area becomes unusable due to an issue, such as a hardware failure or logical error. SAP HANA uses both data backups and log backups to recover the database to a consistent state. For example:

◆ When a hardware failure or another issue causes the database data or log area to become unusable, you can recover the SAP HANA database by recovering the last available data backup and the appropriate log backups.

◆ When a logical error occurs, you can recover the database to the point-in-time of the failure by recovering the last data backup before the point-in-time and the appropriate log entries from the log backups.

Before you perform a recovery in SAP HANA Studio, you must meet the following prerequisites:

◆ You have the SIDadm user password that is required to shut down the target system where the backups will be recovered.

◆ You have at least one data backup and log backup from the time before the system failure or the time to which the system must be recovered.

◆ The database is offline.

After all the database services are stopped, you can start the database recovery in SAP HANA Studio.

You cannot recover a database backup from a later SAP HANA release to an earlier SAP HANA release. You also cannot interrupt or stop a running recovery. If the license expires on recovery, you must install a new license.

Recovery types

You must select the recovery type for the required SID to recover the database in SAP HANA Studio. When the Specify Recovery Type dialog box appears, you must select one of the following recovery types:

◆ Recover the database to its most recent state◆ Recover the database to the following point in time◆ Recover the database to a specific data backup◆ Recover the database to the following log position (for support purposes only)

Note: The recovery to a specified log position uses the last data backup before that log position and the log entries from the log backups between the data backup and that log position.



The following topics provide details about the first three recovery types.

Recovering the database to its most recent state

In the Specify Recovery Type dialog box, select Recover the database to its most recent state to recover the database to the time as close as possible to the current time. This recovery type uses the latest available data backup, all the log backups since the latest data backup, and all the log entries that are still available in the log area.

The following figure shows the dialog box selection for this recovery type.

Figure 9 Selection to recover the database to its most recent state

Recovering the database to a point-in-time

In the Specify Recovery Type dialog box, select Recover the database to the following point in time, and then specify a date and time to recover the database to the specified point-in-time in the past. This recovery type uses the last data backup before the point-in-time and the log entries from the log backups between that data backup and the point-in-time.




Figure 10 Selection to recover the database to a point-in-time

You must also specify the pathnames of the log backup locations, as required to search for the log backups and list the available data backups for recovery:

◆ For a single-container database, the log backup location pathname can be /usr/sap/SID/SYS/global/hdb/backint.

◆ For a multi-container database, the log backup location pathname can be /usr/sap/SID/SYS/global/hdb/backint/SYSTEMDB or /usr/sap/SID/SYS/global/hdb/backint/DB_tenant_database, depending on whether you are restoring a SYSTEMDB database or tenant database.

The following figure shows the dialog box entries for the log backup locations.

Figure 11 Log backup location as required for recovery

The Select Data Backup dialog box appears with a list of the data backups that were performed previously. Select the data backup for the recovery.



You can also check the availability of the complete data backup in the Data Domain system by clicking Check Backup in the SAP HANA Studio, which triggers an inquire process that verifies the physical availability of the data set. The following figure shows that the selected backup is available.

Figure 12 Result of backup availability check

You can also complete the settings in the Other Settings dialog box. Select Third-Party Backup Tool (Backint). To use the delta backups in the point-in-time recovery, select Use Delta Backups (Recommended), as shown in the following figure.



Figure 13 Selections in Other Settings dialog box

After you have completed all the selections in the recovery windows, a summary pane displays all the details. You can verify the details and start the recovery by clicking Finish. The recovery progress is displayed for each service, as shown in the following figure.



Figure 14 Progress of the data and log recovery

Recovering the database to a specific data backup

In the Specify Recovery Type dialog box, select Recover the database to a specific data backup to restore only the specified data backup. This recovery type uses the specified data backup, but does not use any log backups. All the log entries that exist in the log area are deleted.


Figure 15 Selection of recovery of a specific data backup



In the Specify Backup Location dialog box, you can either select the backup from the backup catalog or specify the backup without the catalog by entering the backup name and pathname. To select the backup from the backup catalog, specify the pathnames of the backup catalog locations:

◆ For a single-container database, the backup catalog location pathname can be /usr/sap/SID/SYS/global/hdb/backint.

◆ For a multi-container database, the backup catalog location pathname can be /usr/sap/SID/SYS/global/hdb/backint/SYSTEMDB or /usr/sap/SID/SYS/global/hdb/backint/DB_tenant_database, depending on whether you are restoring a SYSTEMDB database or tenant database.

The following figure shows the dialog box entries for selecting the backup from the backup catalog. All the backups in the backup catalog will be displayed.

Figure 16 Selection of backup from the backup catalog

If you select to specify the backup without the backup catalog, the Specify Backup Location dialog box appears as follows.



Figure 17 Selection of backup without the backup catalog

In the Specify the Backup Files to Recover dialog box, specify the destination type as Backint and specify the backup prefix of the data backup, as shown in the following figure.

Figure 18 Specifying the destination type and backup prefix for recovery

After you have completed all the selections in the recovery windows, a summary pane displays all the details. You can verify the details and start the recovery by clicking Finish. The recovery progress is displayed for each service, as shown in the following figure.



Figure 19 Progress of the data and log recovery

Redirected recovery

When a system crash or hardware failure occurs, you can bring the SAP HANA system back online in a target device by using disaster recovery or redirected recovery.

Before you perform a redirected recovery or disaster recovery, you must meet the following prerequisites:

◆ The source and target hosts have the same environment.

◆ You have installed and configured the database application agent on the target system before you perform a backup or recovery. You have specified the same Data Domain settings as on the source system. The CLIENT parameter setting is the same in the source and target system configurations.

After you have met the prerequisites, perform a normal recovery by using SAP HANA Studio and the backups saved from the source system. After a successful recovery, all the data available in the source system will also be available in the target system.

Source SID and target SID are the same

When the source SID and target SID are the same, the database recovery to the target host is a straightforward procedure. You must ensure that the Data Domain parameters are the same between the source and target hosts.

In this case, you can perform all the recovery operations as normal recoveries. The database copy section in the SAP HANA Administration Guide provides more details.



Source SID and target SID are different

When the source SID and target SID are different, you must specify the source SID and backup paths in the recovery dialog boxes, as shown in the following two figures. These settings ensure that the target system correctly checks for the backup save sets from the source system.

Figure 20 Settings for redirected recovery of a data backup with different source and target SIDs


Deleting backups with SAP HANA Studio

Figure 21 Settings for redirected recovery to a recent state with different source and target SIDs

Deleting backups with SAP HANA StudioYou can delete multiple data and log backups from the backup catalog only, or from the backup catalog and physically from the backup location. This functionality enables you to manage the backup storage space or to fulfill regulatory deletion requirements.

Note: The delete functionality is available in SAP HANA SPS 06 or later.

Before you perform a deletion in SAP HANA, you must meet the following prerequisites:

◆ You have the BACKUP ADMIN system privilege.◆ You have determined the oldest data backup that you want to retain.

You can delete the backup from the backup catalog and from the backend Data Domain system by using the two options available in the SAP HANA Studio, as shown in the following figures. When you right-click any particular backup in the backup catalog, you see the options to delete the selected backup and delete the previous backups before the selected backup.


Appendix

Figure 22 Deletion options when you right-click in backup catalog

Figure 23 Specifying location details for backup deletion

When you click Next, you see a summary of the backup save sets that will be deleted from the Data Domain system. After confirmation, the backup catalog is deleted first, and then the DELETE function is called in the SAP HANA system to delete all the save sets and the index entries.

When you delete all backups that are older than a specific full backup, the older delta backups are also deleted in addition to the older full backups and log backups.

AppendixThe following examples show how to perform backups by running the hdbsql command at the command line:

◆ Backup of a single-container database:

/usr/sap/hdbclient/hdbsql -n localhost:30015 -u system -p P3t3rPan "backup data using backint ('/usr/sap/<SID>/SYS/global/hdb/backint/<prefix>')"


Appendix

◆ Backup of a tenant database:

/usr/sap/hdbclient/hdbsql -n localhost:30013 -u SYSTEM -p P3t3rPan " BACKUP DATA INCREMENTAL FOR DB0 USING BACKINT ('/usr/sap/NEW/SYS/global/hdb/backint/DB_DB0/new')"

The following examples show how to perform recoveries by running the HDBSettings.sh utility at the command line:

◆ Point-in-time recovery of a single-container database:

HDBSettings.sh recoverSys.py --silent --command "RECOVER DATABASE UNTIL TIMESTAMP '<TIME>' CLEAR LOG USING LOG PATH ('/usr/sap/<SID>/SYS/global/hdb/backint') USING BACKUP_ID <BACKUPID> --masterOnly

◆ System copy that uses a specific data backup:

HDBSettings.sh recoverSys.py --silent --command "RECOVER DATA USING SOURCE '<SOURCE_SID>' USING BACKINT ('/usr/sap/<SID>/SYS/global/hdb/backint/COMPLETE_DATA_BACKUP') CLEAR LOG

Copyright © 2016 EMC Corporation. All rights reserved. Published in the USA.

Published July 22, 2016

EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind with respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a particular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

EMC2, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and other countries. All other trademarks used herein are the property of their respective owners.

For the most up-to-date regulatory document for your product line, go to EMC Online Support (https://support.emc.com).


http://support.emc.com

configuring sap hana backup, recovery, database copy · pdf filesap hana backups configuring...

Documents