Restoring the SAP HANA Tenant Database

Restore a tenant database.

If you need to restore a SYSTEMDB database and tenant databases, perform the SYSTEMDB database restore first, and then restore the tenant databases.

You can restore to the same destination, or to the following new destinations:

• An in-place restore

• Restore to a different SID. The destination SID must have the same tenant database name and topology as the source SID.

Note: Do not run a tenant database restore when a SYSTEMDB database restore is in progress.

Before You Begin

1. Perform a full backup or perform an incremental backup. For more information, see Performing a SAP HANA Multitenant Database Container Backup

2. If you need to restore a SYSTEMDB database and tenant databases, restore the system database.

3. Verify that the restore environment has the same set of nodes and the instance SID name as the backup environment. In case of any configuration file modification in the backup environment, make the same modifications in the restore environment before starting the recovery process.

4. Verify that the SAP HANA software version that is used for restore is of the same version or later than the software version used during backup.

5. If you recover the data only, make sure that you have the backup prefix for the tenant database. If you use the SYSTEMDB database backup prefix, the restore fails.

Procedure

1. You can perform a restore on the instances, database details, DbBackupset details, or job details page.

   • Instances: From the navigation pane, go to Protect > Databases > Instances tab. In the row for the instance that you want to restore, click the ellipsis button, and then select Restore. Alternatively, click the instance that you want to restore. Under Overview tab, in the Recovery points section, click Restore.

   • Database Details: From the navigation pane, go to Protect > Databases > Databases tab. In the row for the database instance that you want to restore, click the ellipsis button, and then select Restore. Alternatively, click the database that you want to restore. Under Overview tab, in the Recovery points section, click Restore.

   • DbBackupset Details: From the navigation pane, go to Protect > Databases > Databases tab. Click the database instance that you want to restore. Under Overview tab, in the Recovery points section, click Restore.

   • Job details: From the navigation pane, click Jobs > Job history tab. In the row for the job that you want to restore, click the ellipsis button, and then select Restore. Alternatively, click the job that you want to restore, and then click Restore.

   The Restore Options page appears.

2. Perform an in-place restore.

   Steps to perform an in-place restore

   1. On the In place tab, from the Destination database list, select the database to restore the data to.

   2. In the Number of streams box, enter the number of streams that are applicable for snapshot or backup copy restores.

   3. For Recover to, specify how to restore the instance:

      • Select the restore by specifying the most recent state, select Most recent state.

      • To recover the database to a point-in-time, select Point in time, and then select the date and time.

      • To restore by specifying the backup prefix, select Using backup prefix, and then enter a prefix to identify the backup.

        The Commvault software creates the backup prefix by pre-pending the job ID to the backup prefix. For example, if you enter COMPLETE_DATA_BACKUP, then the backup is named 4815976_COMPLETE_DATA_BACKUP. You do not need the catalog backup available with backint.

      • To restore by specifying the internal backup job ID, select Using internal backup id, and then enter the internal backup job ID.

        Note

        If you restore by specifying the internal backup job ID, then you must have the catalog backup available with backint. SAP HANA creates the internal backup ID.

   4. Under Advanced options, do the following:

      • To restore from a storage policy copy if backup gets corrupted, from the Restore from copy list, select the copy that you want to use.

      • Select a media agent from the Select MediaAgent box.

      • To restore SAP HANA catalog to a point in time, move the Restore catalog from time toggle key to the right, and then do the following:

        1. To restore to a point in time, select Point in time, and then enter the date and time.

        2. To restore relative to the system date, select Relative to sysdate, and then enter the number of days or hours relative to the system date.

      • To verify that all the backups that are required for the recovery operation are available, select the Check access check box.

      • To initialize the log area after the restore, select the Initialize log area check box.

      • To recover using delta backups, select the Use delta backups check box.

        If you do not use a delta backup for the recovery option, the software uses only the log backups for recovery.

   5. Under Pre or Post options, do the following:

      • In the Pre recovery command box, enter the name or path of the process to run before the restore. Alternately, select the file icon on the right side to select a physical client from the Physical client selection list.

      • In the Post recovery command box, enter the name or path of the process to run after the restore. Alternately, select the file icon on the right side to select a physical client from the Physical client selection list.

      • If you want to initiate the restore as user, move the Run as User toggle button to right.

        • In the User name box, enter a user name you want to run the restore with.

      • To send a notification email when the restore job completes, select the When the job completes, notify me via email.

3. Perform an out of place restore.

   Steps to perform an out of place restore

   1. On the Out of place tab, from the Destination server list, select the host to restore the data to.

   2. From the Destination instance list, select the instance to restore the data to.

   3. In the Number of streams box, enter the number of streams that are applicable for snapshot or backup copy restores.

   4. From the Source database, select the source database from where you want to restore.

   5. From the Destination database list, select the database to restore the data to.

   6. To restore from a snapshot backup, in the HANA data directory box, specify the HANA directory.

      Enter the full path where the destination instance resides. For example, if the SAP HANA SID path is hana/data/SID, then enter /hana/data.

      Note

      This value is required for IntelliSnap cross-instance and cross-machine restores.

   7. For Recover to, specify how to restore the instance:

      • Select the restore by specifying the most recent state, select Most recent state.

      • To recover the database to a point-in-time, select Point in time, and then select the date and time.

      • To restore by specifying the backup prefix, select Using backup prefix, and then enter a prefix to identify the backup.

        The Commvault software creates the backup prefix by pre-pending the job ID to the backup prefix. For example, if you enter COMPLETE_DATA_BACKUP, then the backup is named 4815976_COMPLETE_DATA_BACKUP. You do not need the catalog backup available with backint.

      • To restore by specifying the internal backup job ID, select Using internal backup id, and then enter the internal backup job ID.

        Note

        If you restore by specifying the internal backup job ID, then you must have the catalog backup available with backint. SAP HANA creates the internal backup ID.

   8. Under Advanced options, do the following:

      • To restore from a storage policy copy if backup gets corrupted, from the Restore from copy list, select the copy that you want to use.

      • Select a media agent from the Select MediaAgent box.

      • To restore SAP HANA catalog to a point in time, move the Restore catalog from time toggle key to the right, and then do the following:

        1. To restore to a point in time, select Point in time, and then enter the date and time.

        2. To restore relative to the system date, select Relative to sysdate, and then enter the number of days or hours relative to the system date.

      • To verify that all the backups that are required for the recovery operation are available, select the Check access check box.

      • To initialize the log area after the restore, select the Initialize log area check box.

      • To recover using delta backups, select the Use delta backups check box.

        If you do not use a delta backup for the recovery option, the software uses only the log backups for recovery.

   9. Under Pre or Post options, do the following:

      • In the Pre recovery command box, enter the name or path of the process to run before the restore. Alternately, select the file icon on the right side to select a physical client from the Physical client selection list.

      • In the Post recovery command box, enter the name or path of the process to run after the restore. Alternately, select the file icon on the right side to select a physical client from the Physical client selection list.

      • If you want to initiate the restore as user, move the Run as User toggle button to right.

        • In the User name box, enter a user name you want to run the restore with.

      • To send a notification email when the restore job completes, select the When the job completes, notify me via email.

4. Click Submit.

What to Do Next

You can control or view the job. For more information, see Jobs.

If you only restored the tenant database, after the restore the tenant database is in the Up state.