This is an archive version of the document. To get the most up-to-date information, see the current version.

Configuring Veeam Plug-in for SAP HANA

In this article

When you configure Veeam Plug-in settings, you set up integration settings between a SAP HANA server, Veeam backup server and backup repository where the backup files will be stored. Veeam Plug-in uses the SapBackintConfigTool wizard to configure the integration settings. The wizard configures the SAP HANA Backint settings and creates the /opt/veeam/VeeamPluginforSAPHANA/veeam_config.xml file.

If you change the plug-in configuration with SAPBackintConfigTool, changes will be recorded in the log file: /tmp/Veeam_plugin_logs/<user>/SAPHANAConfigTool.log. Note that if you change the veeam_config.xml file manually, it will not be recorded in logs.

Configuring Veeam Plug-in for SAP HANA Note:

The configuration of Veeam Plug-in must be performed by a user with database administrator rights on all SAP HANA instances of the server. Note that the SAP HANA High Level Isolation mode is not supported.

Procedure

To configure Veeam Plug-in, do the following:

Log in as a user with database administrator rights and launch the Veeam Plug-in configuration tool. You do not need sudo rights if you have configured group access as described in the Required Permissions section.

sudo SapBackintConfigTool --wizard

Specify the DNS name or IP address of your Veeam Backup & Replication server.

Enter backup server name or IP address: serv02.tech.local

Specify the port which will be used to communicate with the backup server. Default port: 10006.

Enter backup server port number: 10006

Specify credentials to authenticate against the Veeam Backup & Replication server.

Enter username: serv02\administrator

Enter password for serv02\administrator:

Configuring Veeam Plug-in for SAP HANA Important!

You can work with backups created by Veeam Plug-in only with the account used for creating the backups. If you want to use another account, assign the following roles to the required account:

To restore from the backup using another account, assign Veeam Backup Administrator or Veeam Restore Operator roles to the required account.
To continue the backup using another account, assign the Veeam Backup Administrator role to the required account.

To learn how to assign Veeam Backup & Replication roles, see the Roles and Users section of the Veeam Backup & Replication Guide.

Select the backup repository where you want to store backups. In the terminal dialog, enter the number of the repository from the list of available repositories.

Configuring Veeam Plug-in for SAP HANA Important!

You must have access to backup repositories that you plan to use. Otherwise, the repositories will not be listed as available. To learn how to configure access permissions on repositories, see Setting Up User Permissions on Backup Repositories.

Available backup repositories:

1. serv10_repo

2. serv07_repo

Enter repository number: 1

Configuration result:

SID SH2 has been configured

If you start the wizard for the first time on an SAP HANA scale-out cluster, the wizard asks you for a cluster name. The cluster name will be used by Veeam Backup & Replication to identify the backup job for the cluster. Further runs of the wizard within the SAP HANA scale-out cluster will not ask for this entry again.

Setting Permissions for Configuration File

Configuration of Veeam Plug-in includes configuration or creation of the SAP HANA Backint symlinks on all SAP HANA instances. To be able to do this for multiple SAP HANA instances at the same time, the configuration must be performed by a user with sudo rights. Alternatively, you can use an account from the sapsys user group to configure the plug-in and set the symlink for SAP HANA instances where the account has access rights. You can repeat the wizard under another account to configure additional SAP HANA instances.

Alternatively, you can configure a Linux security group. To do that, you must add all Veeam Plug-in admins to this security group and set the following rights:

sudo chown root:<youradmingroup> /opt/veeam/VeeamPluginforSAPHANA/veeam_config.xml

sudo chmod 664 /opt/veeam/VeeamPluginforSAPHANA/veeam_config.xml

To learn about required permissions for backup and restore operations within SAP HANA, see the Authorization for Backup and Recovery section of the SAP HANA Administration Guide. Note that the SAP HANA High Level Isolation Mode is not supported.

Verifying Configuration of Veeam Plug-in for SAP HANA

When you finish the plug-in configuration wizard, the plug-in creates a soft link in /hana/shared/<SID>/global/hdb/opt.

To verify the Backint configuration, do the following:

Connect to the database using SAP HANA Studio or Cockpit.
Go to Backup/Configuration.
In the Backint Agent field, make sure that the specified path leads to /opt/veeam/VeeamPluginforSAPHANA/hdbbackint.

Configuring Veeam Plug-in for SAP HANA

Changing Specific Parameters of Veeam Plug-in

If you want to edit a specific parameter of Veeam Plug-in, use SapBackintConfigTool with the required command from the table below:

Command	Description
--help	Shows the list of tool parameters.
--show-config	Shows configuration parameters.
--wizard	Starts the wizard to configure the plug-in settings.
--set-credentials <"serv\username"> <password>	Specifies credentials to log in to the Veeam Backup & Replication server.
--set-host <hostname>	Specifies the IP address or hostname of the Veeam Backup & Replication server.
--set-port <port_number>	Specifies a port number that will be used to communicate with the Veeam Backup & Replication server.
--set-repository	Specifies the backup repository.
--set-restore-server	[for System Copy] Specifies the backup that will be copied.
--map-backup	Maps the imported backup.

Example:

To specify credentials that will be used to log in to the Veeam Backup & Replication server, use the plug-in configuration tool with the following command.

sudo SapBackintConfigTool --set-credentials "serv02\Administrator" "password"