Cloud Storage Backint agent for SAP HANA installation guide

These instructions show you how to install and configure the Cloud Storage Backint agent for SAP HANA (Backint agent) on a Compute Engine VM that has SAP HANA installed.

For an overview of the Backint agent, see Cloud Storage Backint agent for SAP HANA in the SAP HANA operations guide.

Prerequisites

Before you install the Backint agent, the following prerequisites must be met:

SAP HANA is installed. To install SAP HANA on GCP, see SAP HANA Deployment Guide.

Creating a Cloud Storage bucket for backups

Before you can configure the Backint agent, you need to create a Cloud Storage bucket to hold the backups.

Depending on whether you need to be able to restore your backups to SAP HANA instances in a single region or to SAP HANA instances in other regions, you can define the bucket as either regional or multi-regional.

The Backint agent itself doesn't impose any restrictions on the type of bucket you use or where the bucket is located.

To create a Cloud Storage bucket, use the GCP Console.

Open the Cloud Storage browser in GCP Console.

Open the Cloud Storage browser
Click CREATE BUCKET.
Specify the storage class.
Click Create.
To configure bucket permissions, click the permissions tab. By default, as owner of the bucket, you have read-write access to the bucket. You can also give other members in your group or individual users to access your bucket.

Installing the agent on your SAP HANA VM

The Backint agent is installed in the same shared file system as the SAP HANA database.

Connect to your VM by using SSH. From the Compute Engine VM instances page, you can click the SSH button for your VM instance, or you can use your preferred SSH method.
Switch to the SAP HANA system administrator.
```
sudo su - sidadm
```
Download and install the Backint agent.
```
curl https://storage.googleapis.com/sapdeploy/backint-gcs/install.sh | bash
```
The installation process:
- Downloads Backint agent and installs it in /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs.
- Downloads a compatible version of the Java Runtime Environment.
- Sets up an executable script that invokes the program. Do not modify the executable script.
- Upon completion, issues a message instructing you to update the parameters.txt file and to set up authentication.
If your SAP HANA instance is running on premises, on another cloud platform, or in a different GCP project than your Cloud Storage bucket, set up authentication and permissions for Backint agent to access the bucket.
1. Open the IAM & admin Service accounts page in Google Cloud Platform Console.
  
  Go to the Service Accounts page
2. Click + CREATE SERVICE ACCOUNT.
3. Specify the name of the GCP project that contains the Cloud Storage bucket that SAP HANA will use.
4. In the Role drop-down menu select Storage > Storage Object Admin.
5. As appropriate, grant users access to the service account.
6. Click CREATE KEY and accept JSON as the default. A private key is saved to your computer.
7. Click Done.
8. Upload the private key to the SAP HANA VM.
Configure the Backint agent.
1. Use your preferred method to edit the parameters.txt file, which is installed in the following directory.
```
/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt
```
2. In parameters.txt, add the name of the Cloud Storage bucket to use for the backups.
```
#BUCKET bucket-name
```
3. If you created a service account and private key for the Backint agent, add the path to the JSON file that contains the private key to parameters.txt.
```
#SERVICE_ACCOUNT /path/to/json/file/on/SAP/HANA/VM
```

Configure SAP HANA to use the Backint agent.

Use SAP HANA Studio to set the following parameters in the backup section of the global.ini configuration file to the values shown in the table.

Parameter	Value
`catalog_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt`
`catalog_backup_using_backint`	`true`
`data_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt`
`log_backup_parameter_file`	`/usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt`
`log_backup_using_backint`	`true`

Use SAP HANA Studio to specify the same value for both basepath_catalogbackup and basepath_logbackup in the persistence section of the global.ini file. For example:

Test the installation by creating a backup in the Cloud Storage bucket and restoring from the backup.
To support the Backint agent automatic update function, enable remote HTTP requests from the SAP HANA VM to https://www.googleapis.com/.
Optionally, enable Stackdriver Logging.
- If SAP HANA is running on GCP, add the com.google.cloud.logging.LoggingHandler handler to the com.google.cloud.partners.handlers property in the /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logging.properties file.
- If SAP HANA is running outside of GCP, install Cloud SDK and configure the application-default login by using the gcloud auth application-default login command.

Troubleshooting

If errors occur during the execution of a backup or a recovery, error messages are displayed in SAP HANA Studio or SAP HANA Cockpit, so check there first for information about the cause of an error. This information might be displayed in the backup.log and backint.log trace files. Be sure to select the relevant database name when multitenant database containers (MDC) are used.

The Backint agent also writes installation and operational events to files on the SAP HANA VM in the directory /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/logs.

If the Backint agent can't connect to the Cloud Storage bucket, review the configuration steps. In particular, check the following items:

If you are using the default VM service account with the Backint agent, the access scope for Storage is listed as Read Write under Cloud API access scopes on the VM instance details page in the GCP Console. If it is not, stop the instance and edit the access scope.
If you created a service account for the Backint agent:
- On the Permissions tab of the Bucket details page in the GCP Console, the Storage Object Admin role is assigned to the service account.
- You created a private key, stored on the SAP HANA VM, and correctly specified the path to the JSON file in the Backint agent configuration file, /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs/parameters.txt.
All parameters are specified correctly in both the parameters.txt Backint agent configuration file and the SAP HANA global.ini file.

If you get errors while multistreaming, change the number of streams to one (1) to see if the error is related to the number of streams.

For more information about Backint agent logging, see Logging for the Backint agent.

Support

If you cannot resolve a problem with Backint agent yourself, you can open a support incident with SAP under component BC-OP-LNX-GOOGLE.

Include the following information:

The HANA version
The parameters file used for Backint
The global.ini entries for backup
- backint_response_timeout
- data_backup_buffer_size
- parallel_data_backup_backint_channels

For more information from SAP about getting support for SAP HANA, see the "Getting Support" section in the SAP HANA Administration Guide.

Was this page helpful? Let us know how we did:

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated March 29, 2019.