Skip to main content
BlueXP backup and recovery
All cloud providers
  • Amazon Web Services
  • Google Cloud
  • Microsoft Azure
  • All cloud providers

Install SnapCenter Plug-in for SAP HANA and add database hosts

Contributors netapp-soumikd netapp-nsriram

You should install the SnapCenter Plug-in for SAP HANA on each of the SAP HANA database hosts. Depending on whether the SAP HANA host has an SSH key based authentication enabled, you can follow one of the methods to install the plug-in.

  • If SSH is enabled for the database host, you can install the plug-in using SSH option. Learn more.

  • If SSH is disabled, install the plug-in manually. Learn more.

Prerequisites

Before adding the host, you should ensure that the prerequisites are met.

  • Ensure that either Java 11 (64-bit) Oracle Java or OpenJDK is installed on each of the SAP HANA database hosts.

  • You should have added the working environment and created the Connector.

  • Ensure that the Connector has connectivity to the SAP HANA database hosts.

    For information on how to resolve the connectivity issue, refer to Failed to validate connectivity from BlueXP connector host to application database host.

    When the connector is lost or if you have created a new connector, you should associate the connector with the existing application resources. For instructions to update the Connector, see Update the Connector Details.

  • Ensure that the BlueXP user has the “Account Admin” role.

  • You should have created the SnapCenter user and configured sudo for the non-root (sudo) user. For information, refer to Configure sudo for SnapCenter user.

  • You should have installed the SnapCenter Plug-in for SAP HANA before adding the database host.

  • While adding the SAP HANA database hosts, you should add the HDB user store keys. The HDB secure user store key is used to store the connection information of SAP HANA database hosts securely on the client and HDBSQL client uses the secure user store key to connect to SAP HANA database host.

  • For HANA System Replication (HSR), to protect the HANA systems, you should manually register both primary and secondary HANA systems.

    Note The hostname must be the same as that of the host that is used in the HSR replication.
  • Ensure that the Connector has the communication enabled to the SSH port (default: 22) if SSH based installation is performed.

  • Ensure that the Connector has the communication enabled to plug-in port (default: 8145) for the data protection operations to work.

  • Ensure that the you have the latest version of plug-in is installed. To upgrade the plug-in, refer to Upgrade SnapCenter Plug-in for SAP HANA Database.

Configure sudo for SnapCenter user

Create a non-root (sudo) user to install the plug-in.

Steps
  1. Log into the Connector VM.

  2. Download the SnapCenter Linux host plug-in binary.
    sudo docker exec -it cloudmanager_scs_cloud curl -X GET 'http://127.0.0.1/deploy/downloadLinuxPlugin'

  3. Copy the contents of sudoer.txt located at: /var/lib/docker/volumes/service-manager-2_cloudmanager_scs_cloud_volume/_data/$(sudo docker ps|grep -Po "cloudmanager_scs_cloud:.*? "|sed -e 's/ *$//'|cut -f2 -d":")/sc-linux-host-plugin

  4. Log into the SAP HANA system host using root user account.

  5. Configure sudo access for the non-root user by copying the text copied in the step 3 to /etc/sudoers.d/snapcenter file.

    In the lines you added to the /etc/sudoers.d/snapcenter file, replace the <LINUXUSER> with the non-root user and <USER_HOME_DIRECTORY> with home/<non-root-user>.

Install the plug-in using script

Configure SSH key based authentication for the SAP HANA host non-root user account and perform the following steps to install the plug-in.

Before your begin

Ensure that the SSH connection to the Connector is enabled.

Steps
  1. Log into Connector VM.

  2. Install the plug-in using the script provided in the Connector.
    sudo bash /var/lib/docker/volumes/service-manager-2_cloudmanager_scs_cloud_volume/_data/scripts/linux_plugin_copy_and_install.sh --host <plugin_host> --username <host_user_name> --sshkey <host_ssh_key> --pluginport <plugin_port> --sshport <host_ssh_port>

    If you are using an older Connector, run the following command to install the plug-in.
    sudo /var/lib/docker/volumes/cloudmanager_scs_cloud_volume/_data/scripts/linux_plugin_copy_and_install.sh --host <plugin_host> --username <host_user_name> --sshkey <host_ssh_key> --pluginport <plugin_port> --sshport <host_ssh_port>

    Name Description Mandatory Default

    plugin_host

    Specifies the SAP HANA host

    Yes

    -

    host_user_name

    Specifies the SnapCenter user with SSH privileges on the SAP HANA host

    Yes

    -

    host_ssh_key

    Specifies the SSH key of the SnapCenter user and is used to connect to the SAP HANA host

    Yes

    -

    plugin_port

    Specifies the port used by the plug-in

    No

    8145

    host_ssh_port

    Specifies the SSH port on the SAP HANA host

    No

    22

    For example, `sudo bash /var/lib/docker/volumes/service-manager-2_cloudmanager_scs_cloud_volume/_data/scripts/linux_plugin_copy_and_install.sh --host 10.0.1.1 --username snapcenter --sshkey /keys/netapp-ssh.ppk

After installing the plug-in, you should Add SAP HANA database hosts.

Install the plug-in manually

If SSH key based authentication is not enabled on the HANA host, you should perform the below manual steps to install the plug-in.

Steps

  1. Log in to Connector VM.

  2. Download the SnapCenter Linux host plug-in binary.
    sudo docker exec -it cloudmanager_scs_cloud curl -X GET 'http://127.0.0.1/deploy/downloadLinuxPlugin'

    The plug-in binary is available at: cd /var/lib/docker/volumes/service-manager-2_cloudmanager_scs_cloud_volume/_data/$(sudo docker ps|grep -Po "cloudmanager_scs_cloud:.*? "|sed -e 's/ *$//'|cut -f2 -d":")/sc-linux-host-plugin

  3. Copy snapcenter_linux_host_plugin_scs.bin from the above path to /home/<non root user (sudo)>/.sc_netapp path for each of the SAP HANA database hosts either using scp or other alternate methods.

  4. Log into the SAP HANA database host using the non-root (sudo) account.

  5. Change directory to /home/<non root user>/.sc_netapp/ and run the following command to enable execute permissions for the binary.
    chmod +x snapcenter_linux_host_plugin_scs.bin

  6. Install the SAP HANA plug-in as a sudo SnapCenter user.
    ./snapcenter_linux_host_plugin_scs.bin -i silent -DSPL_USER=<non-root>

  7. Copy certificate.pem from <base_mount_path>/client/certificate/ path of the Connector VM to /var/opt/snapcenter/spl/etc/ on the plug-in host.

  8. Navigate to /var/opt/snapcenter/spl/etc and execute the keytool command to import the certificate.
    keytool -import -alias agentcert -file certificate.pem -keystore keystore.jks -deststorepass snapcenter -noprompt

  9. Restart SPL: systemctl restart spl

  10. Validate that the plug-in is reachable from the Connector by running the below command from the Connector.
    docker exec -it cloudmanager_scs_cloud curl -ik https://<FQDN or IP of the plug-in host>:<plug-in port>/PluginService/Version --cert config/client/certificate/certificate.pem --key /config/client/certificate/key.pem

After installing the plug-in, you should Add SAP HANA database hosts.

Upgrade SnapCenter Plug-in for SAP HANA Database

You should upgrade the SnapCenter Plug-in for SAP HANA database to gain access to the latest new features and enhancements.

Before you begin

  • Ensure that there are no operations running on the host.

Steps

  1. Configure sudo for SnapCenter user. For information, see Configure sudo for SnapCenter user.

  2. Run the following script.
    /var/lib/docker/volumes/service-manager-2_cloudmanager_scs_cloud_volume/_data/scripts/linux_plugin_copy_and_install.sh --host <plugin_host> --username <host_user_name> --sshkey <host_ssh_key> --pluginport <plugin_port> --sshport <host_ssh_port> --upgrade

    If you are using an older Connector, run the following command to upgrade the plug-in.
    /var/lib/docker/volumes/cloudmanager_scs_cloud_volume/_data/scripts/linux_plugin_copy_and_install.sh --host <plugin_host> --username <host_user_name> --sshkey <host_ssh_key> --pluginport <plugin_port> --sshport <host_ssh_port> --upgrade

Add SAP HANA database hosts

You should manually add SAP HANA database hosts to assign policies and create backups. Auto discovery of SAP HANA database host is not supported.

Steps

  1. In the BlueXP UI, select Protection > Backup and recovery > Applications.

  2. Select Discover Applications.

  3. Select Cloud Native > SAP HANA and select Next.

  4. In the Applications page, select Add System.

  5. In the System Details page, perform the following actions:

    1. Select the System Type as Multi-tenant database container or Global Non-Data Volumes.

    2. Enter the SAP HANA system name.

    3. Specify the SID of the SAP HANA system.

    4. (Optional) Modify OSDB user.

    5. If HANA system is configured with HANA System replication, enable HANA System Replication (HSR) System.

    6. Select HDB Secure User Store Keys text box to add user store keys details.

      Specify the key name, system details, username, and password and click Add Key.

      You can delete or modify the user store keys.

  6. Select Next.

  7. In the Host Details page, perform the following actions:

    1. Select Add new host or Use existing host.

    2. Select Using SSH or Manual.

      For Manual, enter the Host FQDN or IP, Connector, Username, SSH port, Plug-in port, and optionally add and validate the SSH private key.

      For SSH, enter the Host FQDN or IP, Connector, Username, and Plug-in port.

    3. Select Next.

  8. In the Host configuration page, verify whether the configuration requirements are met.

    Select the check boxes to confirm.

  9. Select Next.

  10. In the Storage Footprint page, select Add Storage and perform the following:

    1. Select the working environment and specify the NetApp account.

      From the left navigation pane, select BlueXP Canvas to add a new working environment.

    2. Select the required volumes.

    3. Select Add Storage.

  11. Review all the details and select Add System.

You can modify or remove the SAP HANA systems from the UI.

Before removing the SAP HANA system, you should delete all the associated backups and remove the protection.

Add Non-Data Volumes

After adding the multi-tenant database container type SAP HANA system, you can add the Non-Data Volumes of the HANA system.

You can add these resources to resource groups to perform data protection operations after you discover the SAP HANA databases that are available.

Steps

  1. In the BlueXP UI, click Protection > Backup and recovery > Applications.

  2. Click Discover Applications.

  3. Select Cloud Native > SAP HANA and click Next.

  4. In the Applications page, click icon to select the action corresponding to the system for which you want to add the Non-Data Volumes and select Manage System > Non-Data Volume.

Add Global Non-Data Volumes

After adding the multi-tenant database container type SAP HANA system, you can add the Global Non-Data Volumes of the HANA system.

Steps

  1. In the BlueXP UI, click Protection > Backup and recovery > Applications.

  2. Click Discover Applications.

  3. Select Cloud Native > SAP HANA and click Next.

  4. In the Applications page, click Add System.

  5. In the System Details page, perform the following actions:

    1. From System Type drop-down, select Global Non-Data Volume.

    2. Enter the SAP HANA system name.

  6. . In the Host Details page, perform the following actions:

    1. Specify the associated SIDs of the SAP HANA system.

    2. Select the plug-in host

    3. Click Next.

    4. Review all the details and click Add System.