PowerProtect Data Manager 19.9 Oracle RMAN Agent User Guide

Update the Oracle RMAN agent

An update of the Oracle RMAN agent to version 19.9 requires additional steps when the pre-19.9 Oracle RMAN agent is integrated with Enterprise Copy Data Management (eCDM) or a previous version of the PowerProtect agent. A later topic provides details about updating from the eCDM agent or a previous version of the PowerProtect agent.

1. Log in as an Oracle user.
2. To obtain details about the DD server hosts and storage units that eCDM or PowerProtect has registered with the Oracle RMAN agent, run the ddutil -s command on the Oracle RMAN agent client host. For example:

   ddutil -s

   PowerProtect DD hostname: 10.125.192.190
   
   FC service name: None
   FC service enabled: false
   
   Storage Unit: multi-asset-blrv041a118-7dab9
   Top Level Path: PLCTLP-43f18cb1-fadb-4b25-ae9e-e385d5b5c401
   Protection Policy Name: multi-asset
   
   User: multi-asset-blrv041a118-7dab9
   Type: PROTECTION

3. Update the Oracle RMAN agent by using either of the following methods:

   • Interactive update method:

     To update the Oracle RMAN agent by using the interactive method that prompts for input, follow the instructions in Install the Oracle RMAN agent.

     For example, when you run the install.sh script to perform the interactive update, the following type of prompts and output appear:

     install.sh
     Do you want to install under the default installation directory /home/oracle/opt/dpsapps/rmanagent? (y or n) y
     An Oracle RMAN agent already exists. Do you want to continue the installation? (y or n) y
     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 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/.
     Upgrading the lockbox.
     Import operation is not needed because the lockbox version is already updated.
     As a PowerProtect Data Manager user, update the existing PowerProtect DD details? (y/Y or n/N) y
     PowerProtect DD server name: BLRV033A205.blr.lab.emc.com
     PowerProtect DD storage unit name: rman
     Lockbox update is not needed for PowerProtect DD server 'BLRV033A205.blr.lab.emc.com'.
     As a PowerProtect Data Manager user, update the existing PowerProtect DD details? (y/Y or n/N) n
     Successfully installed the Oracle RMAN agent.
     Do you want to uninstall the previous Oracle RMAN agent in /u01/app/oracle/product/12.1.0/dbhome_1 directory? (y or n) y
     The Oracle RMAN agent is uninstalled.
     Do you want to update settings in /u01/app/oracle/product/12.1.0/dbhome_1 directory so that RMAN scripts from previous installation can be reused? (y or n) y
     Updating settings in the /u01/app/oracle/product/12.1.0/dbhome_1 directory.
     Settings are updated.
     Installation is completed.

   • Silent update method:

     To update the Oracle RMAN agent by using the silent update method that does not prompt for input, follow these steps:

     1. Log in as the Oracle user.

     2. Set the three environment variables as follows:

        export RMAN_AGENT_HOME=<$RMAN_AGENT_HOME>
        export RMAN_AGENT_INSTALL_OPTIONS=OVERWRITE
        export DD_CREDENTIALS_UPDATE=TRUE

     3. Run the following update command, including the two -a command-line options that specify the DD server and storage unit credentials to be updated. If the credentials of more than one server or storage unit must be updated, specify a comma-separated list of the server names and storage unit names:

        install.sh -a DD_SERVER_NAME={<server_name1>[,<server_name2>,...]} -a DD_STORAGE_UNIT={<storage_unit1>[,<storage_unit2>,...]}