PowerProtect Data Manager 19.9 Oracle RMAN Agent User Guide

Install the PowerProtect Data Manager agent

Install the PowerProtect Data Manager agent as the root user on the Oracle RMAN host so that the Oracle RMAN agent can communicate with the PowerProtect Data Manager server.

1. Log in as the root user on the Oracle RMAN host.
2. To install the PowerProtect agent service, run the appropriate command:

   • On AIX, run either the installp command-line program or the SMIT GUI program:

     • To run the command-line program, type the following command:

       installp -a -d <user_home_directory>/ddrman powerprotect-agentsvc.rte

       NOTE The powerprotect-agentsvc.rte file is located in the <user_home_directory>/ddrman directory after you download and uncompress the Oracle RMAN agent software package.

       For example, the command and output appears as follows:

       installp -a -d /home/oracle/ddrman powerprotect-agentsvc.rte
       +-----------------------------------------------------------------------------+
                           Pre-installation Verification...
       +-----------------------------------------------------------------------------+
       Verifying selections...done
       Verifying requisites...done
       Results...
       SUCCESSES
       ---------
         Filesets listed in this section passed pre-installation verification
         and will be installed.
         Selected Filesets
         -----------------
         powerprotect-agentsvc.rte 99.0.99.793       # powerprotect agent service
         << End of Success Section >>
       +-----------------------------------------------------------------------------+
                          BUILDDATE Verification ...
       +-----------------------------------------------------------------------------+
       Verifying build dates...done
       FILESET STATISTICS
       ------------------
           1  Selected to be installed, of which:
               1  Passed pre-installation verification
         ----
           1  Total to be installed
       +-----------------------------------------------------------------------------+
                                Installing Software...
       +-----------------------------------------------------------------------------+
       installp:  APPLYING software for:
               powerprotect-agentsvc.rte 99.0.99.793
       +-----------------------------------------------------------------------------+
       **                    Post Installation Step                                 **
       +-----------------------------------------------------------------------------+
       To configure the firewall rules, run the /opt/dpsapps/agentsvc/configfw.sh script.
       Finished processing all filesets.  (Total time:  6 secs).
       +-----------------------------------------------------------------------------+
                                       Summaries:
       +-----------------------------------------------------------------------------+
       Installation Summary
       --------------------
       Name                        Level           Part        Event       Result
       -------------------------------------------------------------------------------
       powerprotect-agentsvc.rte   99.0.99.793     USR         APPLY       SUCCESS

     • To run the SMIT GUI program, perform the following steps:

       1. Type the following command:

          smitty install_latest

       2. In the Entry Field, type the complete pathname of the directory that contains the software installation files.
       3. Select the option SOFTWARE to install.

       4. To start the installation, perform either of the following actions:

          • Select default <all_latest>, and with the default input SOFTWARE to install, press Enter.
          • Select F4=List, select powerprotect-agentsvc.rte, and press Enter.

     To verify that the installation succeeded, type the following command:

     lslpp -L all | grep -i powerprotect-agentsvc
       powerprotect-agentsvc.rte

     If the command output includes powerprotect-agentsvc.rte, then the installation succeeded.

   • On Linux, run the following command:

     rpm -ivh powerprotect-agentsvc-19.9.0.0.0-1.x86_64.rpm

     NOTE To validate the agent service .rpm file before you run the command, follow the instructions in Knowledgebase article number 546613 at https://www.dell.com/support/kbdoc/en-us/546613.

     For example, the command on Linux displays the following command output:

     rpm -ivh powerprotect-agentsvc-19.9.0.0.0-1.x86_64.rpm
     Preparing... ################################# [100%]
     Updating / installing...
     1:powerprotect-agentsvc-19.9.0.0.0-################################# [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

3. To enable the PowerProtect Data Manager communication 7000 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.
4. To complete the required addons configuration and registration with PowerProtect Data Manager, run the configureAddOn.sh script from the RMAN agent addon directory $RMAN_AGENT_HOME/addon. The following examples show the results when the retention time is set and the retention time is not set.
   NOTE If you specify a hostname or fully qualified domain name (FQDN) with an underscore (_) for the PowerProtect Data Manager server, then the communication will be done by the system's IP, if provided by the system on registration.

   When the retention time is set to days:

   ./configureAddOn.sh
   Enter the Oracle RMAN agent home pathname. Press ENTER for the default home pathname /home/oracle/opt/dpsapps/rmanagent:
   Creating the /opt/dpsapps/agentsvc/AddOns directory.
   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.
   Enter the PowerProtect Data Manager IP address or hostname: 10.63.102.140
   TMPDIR set to value /opt/dpsapps/agentsvc/tmp
   Agent service (pid 20006) started successfully.
   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 as the number of days: 2
   Setting RETENTION_TIME=2. When PowerProtect Data Manager protects the asset, the existing backup copies are deleted after 2 days.
   Allow SYSDBA access for RMAN agent? (y or n) y
   Setting SYSADMIN_ACCESS=TRUE.
   Addons configuration is completed.

   When the retention time is not set:

   ./configureAddOn.sh
   Enter the Oracle RMAN agent home pathname. Press ENTER for the default home pathname /home/oracle/opt/dpsapps/rmanagent:
   Creating the /opt/dpsapps/agentsvc/AddOns directory.
   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.
   Enter the PowerProtect Data Manager IP address or hostname: 10.63.102.140
   TMPDIR set to value /opt/dpsapps/agentsvc/tmp
   Agent service (pid 20680) started successfully.
   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) n
   When PowerProtect Data Manager protects the asset, the existing backup copies are deleted after 30 days.
   Allow SYSDBA access for RMAN agent? (y or n) y
   Setting SYSADMIN_ACCESS=TRUE.
   Addons configuration is completed.

5. To register or re-register the Oracle RMAN agent with the new PowerProtect Data Manager server, run the register.sh script from the agent service directory /opt/dpsapps/agentsvc. For example:

   /opt/dpsapps/agentsvc/register.sh
   Enter the PowerProtect Data Manager IP address or hostname: 10.63.102.138
   Warning: Changing IP of PowerProtect Server from 10.118.159.140 to 10.63.102.138
   Started agent service with PID - 20795