PowerProtect Data Manager 19.12 Oracle RMAN User Guide

Enable the Oracle RMAN agent after hostname change

After the hostname of the Oracle RMAN agent host is changed, you must delete and re-create the lockbox files and re-register the Oracle RMAN agent.

1. Unregister the Oracle RMAN agent from the PowerProtect Data Manager server by running the dpsapps/agentsvc/unregister.sh script.
2. Change the fully-qualified domain name (FQDN) of the Oracle host:
   1. Shut down the Oracle database, and stop the listener.

   2. Run the following command to set the hostname:

      hostnamectl set-hostname <FQDN>

   3. Edit the hostname in the tnsnames.ora, listener.ora, and hosts files.
   4. Start the Oracle database and listener.
3. Delete the following existing lockbox files:
   • ddboost.config* files in the $RMAN_AGENT_HOME/config directory
   • agents.clb* files in the dpsapps/agentsvc/config directory
4. Obtain the updated hostname of the client system by running the uname -n command.
5. Create the new lockbox files on the client by running the ddutil command:

   ddutil -H "hostnames <Oracle_hostname>"

   Replace <Oracle_hostname> with the hostname obtained in the previous step.
6. Re-register the Oracle RMAN agent with PowerProtect Data Manager by running the register.sh script from the agent service directory dpsapps/agentsvc.
7. In the PowerProtect Data Manager UI, configure the lockbox:
   1. In the left navigation pane, select Protection > Protection Policies.
   2. On the Protection Policies page, select the applicable protection policy in the list and click Set Lockbox.