Install and Manage the SAP HANA Connector on IBM PowerPC PlatformCopy link

This topic covers instructions on how to install the SAP HANA Connector on IBM PowerPC Platform.

This is an Early Access feature. Contact your Cohesity account team to enable the feature.

PrerequistesCopy link

Before you register your SAP HANA deployment as a source with Cohesity and protect SAP HANA databases, ensure the following prerequisites:

  • Identify the node(s) in your SAP HANA cluster with adequate resources to execute the SAP HANA connector.

  • SAP HANA node(s) must be using JDK version 1.8 or higher.

  • Ensure that the fully qualified domain name (FQDN) of the Cohesity cluster is resolvable from all the nodes in the SAP HANA cluster.

  • Synchronize the SAP HANA Linux machine time with a Network Time Protocol (NTP) server. For detailed instructions, see How to Sync Linux Server Time with an NTP Server.

  • Ensure that the NTP time is in sync between the client and the Cohesity cluster. Perform the following on the client:

    • Verify if NTP is enabled and synchronized in the client using the following command:

      timedatectl

    • If the NTP time is not synchronized, use the following command to synchronize the NTP time

      timedatectl set-ntp true

  • Use "bash" shell to install the SAP HANA Connector and to run backups and restore workflows of SAP HANA databases.

  • A database user with database admin user privileges.

  • Download and install the Cohesity Linux Agent (el-java_cohesity-agent-7.0-1.ppc64le.rpm) on the SAP HANA node.

  • Download the SAP HANA connector Installer, (cohesity-hana-java-backint-7.0-1.noarch.rpm), for IBM PowerPC Platform.

  • Configure the following environment variables on the SAP HANA node(s):

    Environment Variable Description Command
    SERVICE_USER

    The <SID>adm user account that must own the backup files on the Cohesity view. If you have not created the user account, then create an Operating System (OS) user account in the following format: <SID>adm.

    Where <SID> is a unique three-character code called SAP System Identification (SID). It is available for every R/3 installation (SAP system) that consists of a database server and several application servers.

    export SERVICE_USER=qqqadm

    Where qqqadm is the <SID>adm user account and qqq is the SAP System Identification (SID).
    WORKFLOW The type of workflow you intend to install the SAP HANA connector. For UDA workflow, specify UDA. export WORKFLOW=UDA
    SYSTEMDB_KEY

    The SAP HANA HDBUSERSTORE key to connect to the SYSTEM DB.

    You can generate the HDBUSERSTORE key using the following command:

    hdbuserstore -i set SYS_KEY <HOSTNAME>:<SQL_PORT> <User> <Password>

    For detailed instruction, see hdbuserstore Commands in SAP HANA documentation.

    		 export SYSTEMDB_KEY=<HDBUSERSTORE key>
    CONTROL_NODES The IP address or hostname of the SAP HANA machine. export CONTROL_NODES="<IP_ADDRESS>"
    SOURCE_NAME A name for the SAP HANA source you want to use while registering the SAP HANA as a source on the Cohesity cluster. export SOURCE_NAME="myhostname"

Install the SAP HANA ConnectorCopy link

On the SAP HANA node where you have copied the SAP HANA connector (cohesity-hana-java-backint-7.0-1.noarch.rpm), perform the following to install the SAP HANA connector.

For multi-node SAP HANA deployments, ensure that:

  • You install the SAP HANA connector on the machine where you have installed Cohesity Linux Agent.

  • The SAP HANA Connector is installed on the shared NFS path, to which all the SAP HANA nodes have access.

To install the SAP HANA connector:

  1. Log on to the SAP HANA node’s bash CLI using <SID>adm user.

  2. Make the SAP HANA connector installer (cohesity-hana-java-backint-7.0-1.noarch.rpm) executable using the following command:

    > chmod +x cohesity-hana-java-backint-7.0-1.noarch.rpm

  3. Install the SAP HANA connector using the following command:

    > sudo -E rpm -ivh cohesity-hana-java-backint-7.0-1.noarch.rpm

The following is a sample output of the successful installation:

sles-sap:kumadm> export SERVICE_USER=kumadm 
sles-sap:kumadm> export SYSTEMDB_KEY=SYS_KEY  
sles-sap:kumadm> sudo -E rpm -ivh cohesity-hana-java-backint-7.0-1.noarch.rpm            
Preparing...                          ################################# [100%]                                                                                         
Pre-install/Upgrade section                                                                                                                                            
==> Service user is kumadm
==> System db key is SYS_KEY                                                       
==> WORKFLOW is UDA by default, hence cluster ips and view name are auto  populated during                                                                             
      DB workflow through UDA framework                                                                                                                                
==>                                                                                                                                                                    
==> User kumadm does not exist in /etc/passwd                        
==> Checking if User kumadm exists using getent command.                           
==> User kumadm found with getent command                                          
==> Package installation is happening at /opt/cohesity/hana_java_plugin           
Updating / installing...                                                           
   1:cohesity-hana-java-backint-ENG_27################################# [100%]     
==> Post-install/Upgrade section                                                                                                                                       
workflow is set to UDA                                                                                                                                                 
LOG_DIR_PATH is not set, hence using /opt/cohesity/hana_java_plugin                                                                                                    
Backint log dir location is /opt/cohesity/hana_java_plugin/cohesity_backint_logs
Service user is set to kumadm                                                      
==> hdbsql is /usr/sap/KUM/HDB01/exe/hdbsql, hdbuserstore is /usr/sap/KUM/HDB01/exe/hdbuserstore                                                                       
------------------------------------------------------------------------------     
Control Nodes is sles-sap, source name is sles-sap                                 
Creating soft link from /opt/cohesity/hana_java_plugin/bin/backint.sh to /usr/sap/KUM/SYS/global/hdb/opt/hdbbackint                                                    
Creating soft link from /opt/cohesity/hana_java_plugin/uda_scripts to /opt/cohesity/agent/uda_scripts                                                                  
updating the LOG_DIR_TEMPLATE with /opt/cohesity/hana_java_plugin for scripts located at                                                                               
  /opt/cohesity/hana_java_plugin location                                                                                                                              
updating the INSTALL_DIR_TEMPLATE with /opt/cohesity/hana_java_plugin for scripts located at                                                                           
  /opt/cohesity/hana_java_plugin location               
Executing backint -V                                                               
Cohesity DataProtect 6.5 for SAP HANA (PPC)                                   
backint.jar, Build Version: b7efc5cd                                 
Successful Installation of UDA HANA Java Connector

Uninstall the SAP HANA ConnectorCopy link

To uninstall the SAP HANA Connector using the root user account, use the following command:

> sudo -E rpm -evh cohesity-hana-java-backint-7.0-1.noarch.rpm

The following is a sample output of the successful uninstallation:

sles-sap:adm> sudo -E rpm -evh cohesity-hana-java-backint-7.0-1.noarch.rpm
[sudo] password for root: 
Preparing...                          ################################# [100%]
==> Pre-uninstall section
grep: /opt/cohesity/hana_java_plugin/profile/cohesity_param_file_: No such file or directory
Log directory is set to  in /opt/cohesity/hana_java_plugin/profile/cohesity_param_file_
Cleaning up / removing...
   1:cohesity-hana-java-backint-ENG_27################################# [100%]
==> Post-uninstall section
==> Deleting RPM install files at /opt/cohesity/hana_java_plugin
rm -rf /opt/cohesity/hana_java_plugin
UDA HANA Java Connector is successfully uninstalled

Upgrade the SAP HANA ConnectorCopy link

To upgrade the SAP HANA connector, run the following command on all SAP HANA nodes:

sudo -E rpm -Uvh cohesity-hana-java-backint-7.0-1.noarch.rpm