PowerProtect Data Manager 19.10 Oracle RMAN User Guide

To update the PowerProtect agent, 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 files.
    3. Select the option SOFTWARE to install.

    4. To start the update, 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 update 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 update succeeded.

• On Linux, run the following command:

  rpm -Uvh powerprotect-agentsvc-19.10.0.0.0-1.x86_64.rpm

  NOTE To verify the authenticity and integrity of the agent service RPM file before you run the command, follow the instructions in the PowerProtect Data Manager Security Configuration Guide.

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

  rpm -Uvh powerprotect-agentsvc-19.10.0.0.0-1.x86_64.rpm
  Preparing... ################################# [100%]
  Stopping agent service (pid 25731, count=1) ...
  Stopping agent service (pid 25732, count=2) ...
  Stopping agent service (pid 25740, count=3) ...
  Removed symlink /etc/systemd/system/multi-user.target.wants/agentsvc.service.
  Updating / installing...
  1:powerprotect-agentsvc-19.10.0.0.0-################################# [ 50%]
  Cleaning up / removing...
  2: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

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

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

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.

For example:

/home/oracle/opt/dpsapps/rmanagent/addon/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
Agent service (pid 32047) started successfully.
Do you want to set the default retention time? (y or n) y
Provide the default retention time as the number of days: 1
Setting RETENTION_TIME=1.
Allow SYSDBA access for RMAN agent? (y or n) y
Setting SYSADMIN_ACCESS=TRUE.
Addons configuration is completed.

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