
PowerProtect Data Manager 19.14 SAP HANA User Guide
Install the SAP HANA agent
Learn how to install the SAP HANA agent on all the Linux database servers that must access the DD system.
About this task
Run the ppdmHanaInstall.sh script to install the SAP HANA agent 19.14. The script installs the SAP HANA agent and the agent service in the default directory, /opt/dpsapps/dbappagent/saphana.
Run the ppdmHanaInstall.sh -h or ppdmHanaInstall.sh --help command to obtain more information about the script operation.
Complete the following steps to download the SAP HANA agent and install the software on Linux.
Steps
- In the PowerProtect Data Manager UI:
- Click
, and then select
Downloads from the
System Settings menu.
- Under
SAP HANA, select
Download Agent.
The SAP HANA agent download package, dbappagent1914_linux_x86_64.tar.gz, is downloaded.
- Upload the package to the SAP HANA host on Linux.
NOTE:Refer to Chapter 8 in the PowerProtect Data Manager Security Configuration Guide for details on how to verify the authenticity and integrity of the downloaded package. - Click
- Uncompress the downloaded tar file by running the following command as the SAP HANA user:
tar -xvf dbappagent1914_linux_x86_64.tar.gz
NOTE:To verify the authenticity and integrity of the RPM files before you install the software, follow the instructions in the PowerProtect Data Manager Security Configuration Guide. -
As the root user, run the
ppdmHanaInstall.sh script with the appropriate options from the following table to install the SAP HANA agent and register the agent with the
PowerProtect Data Manager server.
For example, run the following command to install and register the SAP HANA agent. The command includes the options for the preferred agent host address and communication port. The port is used for communication between the SAP HANA agent and the PowerProtect Data Manager server:
ppdmHanaInstall.sh --server=<PowerProtect_Data_Manager_server_FQDN_or_IP> --preferredAddress=<SAP_HANA_agent_host_FQDN_or_IP> --clientPort=<port_number> --firewallException
Table 1. Installation script options Command option Description --server= <PowerProtect_Data_Manager_server_FQDN_or_IP>
Specifies the fully qualified domain name (FQDN) or IP address of the PowerProtect Data Manager server for registering the agent host. During an interactive installation, if you do not include the --server option, the script prompts for the PowerProtect Data Manager server address.
NOTE:If you specify a hostname or fully qualified domain name (FQDN) with an underscore (_) for the PowerProtect Data Manager server, then the communication is done by the system's IP, if provided by the system on registration.--silent Specifies to perform a silent installation, instead of an interactive installation with prompts. Always include the --server option with the --silent option. For example: ppdmHanaInstall.sh --silent --server= <PowerProtect_Data_Manager_server_FQDN_or_IP>
--preferredAddress= <SAP_HANA_agent_host_FQDN_or_IP>
Specifies the FQDN, IPv4 address, or IPv6 address of the SAP HANA agent host to be registered with the PowerProtect Data Manager server. The preferred host address is used for communication between the SAP HANA agent and the PowerProtect Data Manager server. NOTE:It is recommended to use an FQDN as the preferred host address in DHCP environments and other environments where static IP addresses can change.During an interactive installation, if you do not include this option, the script prompts for the address value.
During a silent installation, if you do not include this option, the script automatically retrieves the hostname.--clientPort=<port_number> Specifies the port on the SAP HANA agent host to use for communication between the SAP HANA agent and the PowerProtect Data Manager server. The port number must be from the port ranges 7000 to 7009 and 7012 to 7020. The ports 7010 and 7011 are used by the agent service message bus. During an interactive installation, if you do not include this option, the script prompts you to enter the port number or select the default port 7000.
During a silent installation, if you do not include this option, the default port 7000 is used as the communications port.--firewallException Specifies to set up the firewall exceptions so that the SAP HANA agent host can communicate with the PowerProtect Data Manager server. During an interactive installation, if you do not include this option, the script asks whether you want to add the firewall rule for the specified port.
During a silent installation, if you do not include this option, the firewall configuration is skipped. You must take the appropriate steps to set up the firewall exceptions. - To verify the installed version of the SAP HANA agent, run the following command:
rpm -qa | grep "agent"
emcdbappagent-19.14.0.0.0-1.x86_64 powerprotect-agentsvc-19.14.0.0.0-1.x86_64