TECHNICAL NOTE

EMC Data Domain Boost for Enterprise Applications and

EMC ProtectPoint Database Application Agent
Versions 1.0, 2.x, and 3.0

Configuring SAP HANA Backup, Recovery, Database

Copy, and Deletion with SAP HANA Studio
P/N 302-001-022
REV 02
July 22, 2016

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

Revision history

Revision history
The following table presents the revision history of this document.
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 2Added 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 4Added 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.

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 backups

In-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.

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

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 backupsAn incremental backup stores the data that has changed since
either the last data backup or the last delta backup (incremental or differential).

Differential backupsA 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

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 SAP HANA Backup, Recovery, Database Copy, and Deletion with SAP HANA Studio Technical Note

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.

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

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.

Performing data backups with SAP HANA Studio

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

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

Performing data backups with SAP HANA Studio

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

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

Performing data backups with SAP HANA Studio

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.

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

Performing data backups with SAP HANA Studio

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

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

Performing data recovery with SAP HANA Studio

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.

10

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

Performing data recovery with SAP HANA Studio

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.
The following figure shows the dialog box selection for this recovery type.

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

11

Performing data recovery with SAP HANA Studio

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.

12

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

Performing data recovery with SAP HANA Studio

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.

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

13

Performing data recovery with SAP HANA Studio

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.

14

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

Performing data recovery with SAP HANA Studio

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.
The following figure shows the dialog box selection for this recovery type.

Figure 15 Selection of recovery of a specific data backup

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

15

Performing data recovery with SAP HANA Studio

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.

16

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

Performing data recovery with SAP HANA Studio

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.

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

17

Performing data recovery with SAP HANA Studio

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.

18

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

Performing data recovery with SAP HANA Studio

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

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

19

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 Studio

You 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.

20

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

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.

Appendix
The 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>')"

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

21

Appendix

Backup of a tenant database:

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

-p P3t3rPan

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).

22

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