PowerProtect Data Manager 19.9 Oracle RMAN Agent User Guide

Update the eCDM agent or PowerProtect agent

You must complete the required steps to update from the Enterprise Copy Data Management (eCDM) agent or a previous version of the PowerProtect agent. Use the following methods to update from either the eCDM agent 19.3 or earlier or the PowerProtect agent 19.4 or later to the current version of the PowerProtect agent.

Update from eCDM agent 19.3 or earlier

Complete the following steps to update from the eCDM agent 19.3 or earlier to the current version of the PowerProtect agent.

To stop the eCDM agent on the Oracle RMAN agent client host, run the following command as the root user:
```
/usr/local/ecdm/ecdm-agent/bin/ecdm-agent.bin stop
```
The following message appears when the eCDM agent is stopped:
```
eCDM Agent daemon control 'stop' is successful
```

To uninstall the eCDM agent, run the rpm -e ecdm-agent-3.0.0-15_1.x86_64 command. For example:

rpm -e ecdm-agent-3.0.0-15_1.x86_64
Uninstalling ecdm-agent...
ecdmagent.service - eCDM Agent Service
Loaded: loaded (/etc/systemd/system/ecdmagent.service; enabled)
   :

To install the PowerProtect agent, run the rpm -ivh powerprotect-agentsvc-19.9.0.0.0-1.x86_64.rpm command. For example:

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

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
```
NOTE If the firewall rules are not applied, restart the firewall.

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.

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.

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

To complete the update, manually approve the Oracle RMAN agent from the PowerProtect Data Manager server. Manage the Oracle application agent provides information.

Update from PowerProtect agent 19.4 or later

Complete the following steps to update from the PowerProtect agent 19.4 or later to the current version of the PowerProtect agent.

To update the PowerProtect agent, run the rpm -Uvh powerprotect-agentsvc-19.9.0.0.0-1.x86_64.rpm command. For example:

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.

rpm -Uvh powerprotect-agentsvc-19.9.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.9.0.0.0-################################# [ 50%]
Cleaning up / removing...
2:powerprotect-agentsvc-19.8.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
```
NOTE If the firewall rules are not applied, restart the firewall.