PowerProtect Data Manager Appliance 5.15.0.0 Oracle RMAN User Guide

Install the Oracle RMAN agent and PowerProtect Data Manager Appliance agent

Learn how to install the Oracle RMAN agent and PowerProtect Data Manager Appliance agent as the root user on all the database servers that must access the DD system.

1. In the PowerProtect Data Manager UI:
   1. Click , and then select Downloads from the System Settings menu.
   2. Under Oracle, select Download Agent.
   3. Select the Oracle RMAN agent download package:
      • On AIX: Select Download for AIX to download the AIX software package, ddrman1915_aixpower.tar.
      • On Linux: Select Download for Linux to download the Linux software package, ddrman1915_linux_x86_64.tar.

      The software package is downloaded to the Oracle server host.

   4. Copy the package to any user-defined directory with Oracle user ownership on the Oracle server host.
   NOTE:Refer to Chapter 8 in the PowerProtect Data Manager Appliance Security Configuration Guide for details on how to verify the authenticity and integrity of the downloaded package.
2. Uncompress the downloaded tar file outside of the $RMAN_AGENT_HOME directory using the oracle user by running the following command:
   • On AIX:

     tar -xvf ddrman1915_aixpower.tar

   • On Linux:

     tar -xvf ddrman1915_linux_x86_64.tar

   The Oracle RMAN agent installation files are uncompressed under the ddrman folder.

3. Ensure that no backups are running. Stop the RMAN processes before you install the Oracle RMAN agent.
4. As the root user, run the install.sh script:

   install.sh

   NOTE:On the install.sh command line, you can include one or more of the installation command options described in Installation command options. The command options prevent the display of the corresponding prompts by the install.sh script.

   By default, the install.sh script displays the following initial prompt:

   Do you want to register the agent to PowerProtect Data Manager? (y or n)

   At the prompt, type either n or y:

   • If you type n, then the Oracle RMAN agent and BoostFS package are installed.
   • If you type y, then the Oracle RMAN agent, PowerProtect Data Manager Appliance agent, and BoostFS package are installed.

   NOTE:The BoostFS package is installed only when you type y at the following prompt:

   Do you want to install the BoostFS rpm, which is required to use Oracle Incremental Merge backup technology? (y or n)

   At the following prompt, you can choose to install the software in an existing non-default directory, if preferred:

   Do you want to install this package under the default installation directory /home/oracle/opt/dpsapps/rmanagent? (y or n)

   The non-default directory must already be created specifically for the Oracle RMAN agent 5500 installation, and must not be the ORACLE_HOME directory. You must provide the complete pathname of the directory without a slash (/) at the end.

   At a subsequent prompt, you must specify the FQDN or IP address of PowerProtect Data Manager Appliance server. You can also specify the preferred FQDN or IP address of the Oracle RMAN agent host and the port to be used for communication between the Oracle RMAN agent and PowerProtect Data Manager Appliance server.

   NOTE:

   If you specify a hostname or fully qualified domain name (FQDN) with an underscore (_) for the PowerProtect Data Manager Appliance server, then the communication will be done by the system's IP, if provided by the system on registration.

   The specified port number must be from the supported port ranges 7000 to 7009 and 7012 to 7020. The ports 7010 and 7011 are used by the agent service message bus. If you do not specify a port number, the default port 7000 is used as the communication port.

   If ORACLE_HOME is set in the environment, the install.sh script displays the following type of prompt. Type n, as required for a new installation:

   The Oracle RMAN agent library, libddobk.so, does not exist in /space/oracle/app/oracle/product/12.1.0/dbhome_1/lib.
   Do you want to update settings in /space/oracle/app/oracle/product/12.1.0/dbhome_1 directory so that RMAN scripts from previous installation can be reused? (y or n) n

   The following example shows the default output from the install.sh script on Linux when the Oracle RMAN agent, PowerProtect Data Manager Appliance agent, and BoostFS package are selected for installation:

   # ./install.sh
   Do you want to register the agent to PowerProtect Data Manager? (y or n) y
   To install the Oracle RMAN agent, enter the same username that was used to install the Oracle database software.
   oracle
   Do you want to install this package under the default installation directory /home/oracle/opt/dpsapps/rmanagent? (y or n) y
   The lib directory /home/oracle/opt/dpsapps/rmanagent/lib is created.
   The config directory /home/oracle/opt/dpsapps/rmanagent/config is created.
   The addon directory /home/oracle/opt/dpsapps/rmanagent/addon is created.
   The Oracle addon directory /home/oracle/opt/dpsapps/rmanagent/addon/D2B24128_9482_44D2_8723_6D211DB49BFB is created.
   The bin directory /home/oracle/opt/dpsapps/rmanagent/bin is created.
   Installing the Oracle RMAN agent.
   Copying the lockbox libraries to /home/oracle/opt/dpsapps/rmanagent/lib/.
   Copying libddobk.so to /home/oracle/opt/dpsapps/rmanagent/lib/.
   Copying libDDBoost.so to /home/oracle/opt/dpsapps/rmanagent/lib/.
   Copying libzmq.so.5 to /home/oracle/opt/dpsapps/rmanagent/lib/.
   Copying ddutil to /home/oracle/opt/dpsapps/rmanagent/bin/.
   Copying the dependency libraries to /home/oracle/opt/dpsapps/rmanagent/lib/.
   Copying the ddbmcon program to /home/oracle/opt/dpsapps/rmanagent/bin/.
   Copying the configuration file to /home/oracle/opt/dpsapps/rmanagent/config/.
   Copying the addon library program to /home/oracle/opt/dpsapps/rmanagent/addon/D2B24128_9482_44D2_8723_6D211DB49BFB/.
   Copying the configureAddOn.sh program to /home/oracle/opt/dpsapps/rmanagent/addon/.
   Copying the unConfigureAddOn.sh program to /home/oracle/opt/dpsapps/rmanagent/addon/.
   Copying pushupdate.sh to /home/oracle/opt/dpsapps/rmanagent/bin/.
   Copying the ddbmoim configuration file to /home/oracle/opt/dpsapps/rmanagent/config/.
   Copying the ddbmoim program to /home/oracle/opt/dpsapps/rmanagent/bin/.
   Creating the lockbox.
   Successfully installed the Oracle RMAN agent.
   Environment variable ORACLE_HOME is not defined.
   Installation is completed.
   The installed version of the Oracle RMAN agent is 19.14.0.26(26)
   
   The BoostFS installation is started.
   Do you want to install the BoostFS rpm, which is required to use Oracle Incremental Merge backup technology? (y or n) y
   ################################# [100%]
   Updating / installing...
   ################################# [100%]
   The installed version of BoostFS is 7.12.0.0-1050583
   
   The powerprotect-agentsvc installation is started.
   ################################# [100%]
   Updating / installing...
   ################################# [100%]
   Created symlink from /etc/systemd/system/multi-user.target.wants/agentsvc.service to /etc/systemd/system/agentsvc.service.
   To configure firewall rules run
   /opt/dpsapps/agentsvc/configfw.sh
   The installed version of powerprotect-agentsvc is 19.14.0.26.26
   
   Creating the /opt/dpsapps/agentsvc/AddOns/D2B24128_9482_44D2_8723_6D211DB49BFB directory.
   Copying the D2B24128_9482_44D2_8723_6D211DB49BFB.zip file.
   Copying the addon.cfg file.
   /opt/dpsapps/agentsvc/register.sh
   Enter the PowerProtect Data Manager server FQDN or IP address: 10.125.215.10
   PowerProtect Data Manager server FQDN or IP address used by application host is 10.125.215.10
   To use the Fully Qualified Domain Name (FQDN) as the preferred address for the agent host, in the PowerProtect Data Manager UI, go to Infrastructure > Application Agents and select Configure DNS Name Resolution.
   Enter the preferred FQDN or IP address of the application host: 10.125.208.87
   Preferred Address of the application host is 10.125.208.87
   Please enter the port number in the allowed range from 7000 to 7020 excluding {7010 and 7011 as they will be used by the agent service process}
   Enter the Port Number for AgentService[7000]:
   Do you want to add the Firewall rule for the port: 7000 ?(yes/no):
   Port number used by application host is 7000
   TMPDIR set to value /opt/dpsapps/agentsvc/tmp
   Agent service (pid 18933) started successfully.
   Checking for PowerProtect Data Manager server Accessibility.
   PowerProtect Data Manager server is Accessible.
   Existing backups are not automatically discovered and managed by PowerProtect Data Manager by default. Follow the instructions in the PowerProtect Data Manager Oracle RMAN User Guide to discover existing bbackups.
   Do you want to set the retention time for retention management of existing backups by PowerProtect Data Manager? Enter "y" to specify the retention time as the number of days, or "n" to accept the default retention time of 30 days: (y or n) y
   Provide the retention time as the number of days: 45
   Setting RETENTION_TIME=45. When PowerProtect Data Manager protects the asset, the existing backup copies are deleted after 45 days.
   Allow SYSDBA access for RMAN agent? (y or n) y
   Setting SYSADMIN_ACCESS=TRUE.
   Addons configuration is completed.

5. To verify the installed version of Oracle RMAN agent, run the following command:

   $RMAN_AGENT_HOME/bin/ddutil -i
   RMAN Agent Version: 19.15.0.26(26)

6. To enable the PowerProtect Data Manager Appliance communication TCP port, run the /opt/dpsapps/agentsvc/configfw.sh script as the root user.

   On AIX, the command output appears as follows:

   /opt/dpsapps/agentsvc/configfw.sh 
   configuring inbound rules for AIX OS
   Filter rule 3 for IPv4 has been added successfully.

   On Linux, the command output appears as follows:

   /opt/dpsapps/agentsvc/configfw.sh
   firewalld service is running
   configuring firewall rules

   NOTE:If the firewall rules are not applied, restart the firewall.