Using the recover_scaleup_snapshot utility application consistent and crash consistent storage snapshots can be created. The following behaviors should be noted when using this process:
- Only application consistent storage snapshots for Scale Up instances can be recovered.
- Recovery can be performed by copying the snapshot to a new volume or overwriting an existing volume with the storage snapshot.
- If recovery is performed by copying the snapshot to a new volume then the existing data volume is detached from the host and the new volume is attached.
- All tenants and the SystemDB are recovered as apart of this process.
- The SAP HANA database must be running to perform recovery. This is a recovery in place scenario , recovery cannot be redirected.
If the SAP HANA instance is not running then the standard recovery process needs to be used through SAP HANA Studio or SAP HANA Cockpit.
The following arguments are used with the recover_scaleup_snapshot utility
|
Argument |
Purpose |
Requirement |
|---|---|---|
|
-h, --help |
Show help message text. |
Optional |
|
-ha HOSTADDRESS, --hostaddress HOSTADDRESS |
Host address (hostname) of an SAP HANA Scale Out worker System. Defaults to localhost if not provided. |
Optional |
|
-i INSTANCENUMBER, --instancenumber INSTANCENUMBER |
SAP HANA instance number, typically in the form 00. Defaults to 00 if not provided. |
Optional |
|
-du DATABASEUSER, --databaseuser DATABASEUSER |
SAP HANA system database user with the correct permissions to create a storage snapshot. |
Required |
|
-dp DATABASEPASSWORD, --databasepassword DATABASEPASSWORD |
SAP HANA system database password with the correct permissions to create a storage snapshot. Will prompt for a password if not provided. |
Optional |
|
-osu OPERATINGSYSTEMUSER, --operatingsystemuser OPERATINGSYSTEMUSER |
A user with the permissions to freeze the SAP HANA data volume and view volume information. |
Required |
|
-osp OPERATINGSYSTEMPASSWORD, --operatingsystempassword OPERATINGSYSTEMPASSWORD |
Password for the user with permissions to freeze the SAP HANA data volume and view volume information. Will prompt for the password if not provided. |
Optional |
|
-fa FLASHARRAY, --flasharray FLASHARRAY |
The IP address or hostname of a Everpure FlashArray with the SAP HANA systems volumes on it. |
Required |
|
-fau FLASHARRAYUSER, --flasharrayuser FLASHARRAYUSER |
A user on the FlashArray with permissions to create a volume snapshot. |
Required |
|
-fap FLASHARRAYPASSWORD, --flasharraypassword FLASHARRAYPASSWORD |
Password for the user with permissions to create a volume snapshot on FlashArray. Will prompt for the password if not provided. |
Optional |
|
-sp SIDADMPASSWORD, --sidadmpassword SIDADMPASSWORD |
<sid>adm password for the <sid>adm user |
Required |
|
-ov, --overwritevolume |
Overwrite the original SAP HANA volume with the snapshot. The default behaviour without this argument is to copy the snapshot to a new volume and attach that to the host operating system. |
Optional |
|
-vca VCENTERADDRESS, --vcenteraddress VCENTERADDRESS |
The IP address or hostname of a vCenter Server managing the SAP HANA VM. |
Optional |
|
-vcu VCENTERUSER, --vcenteruser VCENTERUSER |
The Username of a user for the vCenter Server managing the SAP HANA VM. |
Optional |
|
-vcp VCENTERPASSWORD, --vcenterpassword VCENTERPASSWORD |
The Password of a user for the vCenter Server managing the SAP HANA VM. Will prompt for the password if not provided. |
Optional |
|
--version |
Show program's version number and exit. |
Optional |
Example Recovering local SAP HANA Scale Up Instance
HANA:~ # recover_scaleup_snapshot --databaseuser SYSTEM --operatingsystemuser root --flasharray 10.21.227.53 --flasharrayuser pureuser --sidadmpassword Osmium76
Database Password:
Operating System Password:
FlashArray Password:
vCenter Password (Leave blank if not required):
This recovery method is possible with both vVols and bear metal deployments.
The SAP HANA Catalog is queried for all of the recovery points it is aware of (only for data snapshots).
Once a catalog ID is selected the relevant FlashArray is queried to check if the storage snapshot is present.
If recovery is selected to proceed the SAP HANA instance is shut down and the relevant recovery method is performed.
Once the new volume has been attached to the host, the SystemDB and tenant databases are recovered.
Its important to note than when using the default recovery method a new volume is created , which alters the world wide identifier of the SAP HANA data volume will be different. The original volume is preserved and the new data volume will have the SAP HANA Backup ID appended to the volume name.
The SAP HANA toolkit is a set of executables packaged in an rpm for Redhat Enterprise Linux and SUSE Enterprise Linux.