PowerProtect Data Manager 19.10 Oracle RMAN User Guide

PDF

Uninstall the Oracle RMAN agent

Run the uninstall.sh script to uninstall the Oracle RMAN agent 19.10. You can also run the script to uninstall a previous version of the Oracle RMAN agent.

About this task

Run the uninstall.sh -h or uninstall.sh --help command to obtain more information about the script operation.

You can run the uninstall.sh script manually or automatically. To enable the automatic operation, you must set the appropriate environment variables as listed in Table 1:

When the variables are not set, the script runs manually and prompts for the required values.
When the variables are set, the script runs automatically and performs the uninstallation according to the environment variable settings.

Table 1. Environment variables for uninstallation of Oracle RMAN agent
Environment variable	Description	Default and valid values
`RMAN_AGENT_HOME`	Specifies the installation directory for the Oracle RMAN agent.	`<user_home_directory>`/opt/dpsapps/rmanagent (default). Valid complete pathname of the directory for installation of Oracle RMAN agent. NOTE The directory pathname must not end with a slash (/).
`RMAN_AGENT_UNINSTALL_OPTIONS`	Specifies the software components to uninstall.	Undefined (default). NONE or none—Specifies to keep the Oracle RMAN agent software, and not perform the uninstallation. BINARY or binary—Specifies to uninstall the software, but not the lockbox or the configuration file. FULL or full—Specifies to uninstall the software, lockbox, and configuration file.

NOTE It is not necessary to uninstall the Oracle RMAN agent for an update. An existing Oracle RMAN agent is overwritten during an update.

Perform the following steps to uninstall the Oracle RMAN agent.

Steps

Ensure that backup and restore operations are not in progress when you uninstall the Oracle RMAN agent.
If you want the uninstallation script to run automatically, ensure that RMAN_AGENT_HOME and RMAN_AGENT_UNINSTALL_OPTIONS are set as described in Table 1.
To verify the value of an environment variable, run the echo command. For example:
```
# echo $RMAN_AGENT_HOME
```
```
/home/oracle/opt/dpsapps/rmanagent
```
To set an environment variable, run the export command. For example:
```
# export RMAN_AGENT_HOME=/home/oracle/opt/dpsapps/rmanagent
```
To unconfigure the Oracle addon for PowerProtect Data Manager, log in as the root user on the Oracle RMAN host and run the unConfigureAddOn.sh script from the RMAN agent addon directory $RMAN_AGENT_HOME/addon.
This step deletes the Oracle addon files in the agent service addon directory. For example:
```
/home/oracle/opt/dpsapps/rmanagent/addon/unConfigureAddOn.sh
Enter the Oracle RMAN agent home pathname. Press ENTER for the default home pathname /home/oracle/opt/dpsapps/rmanagent:
```
As an Oracle user, run the uninstall.sh script:
NOTE Before you run the uninstall.sh script, it is recommended that you run the unConfigureAddOn.sh script to delete the Oracle addon files and then set the RMAN_AGENT_HOME environment variable.
```
# ./uninstall.sh
```
If the script does not run automatically, type the appropriate values at the prompts:
1. When prompted, specify whether you want to enter the directory pathname of the Oracle RMAN agent installation:
```
An installation directory pathname is not specified. Do you want to enter the installation pathname?  (y or n)
```
  If you type y, then the script prompts for the installation location. Type the complete pathname of the installation location, without a slash (/) at the end.
2. When prompted, specify whether you want the lockbox and configuration file to be removed:
```
Do you want to remove the lockbox and the configuration file? (y or n)
```
3. If the script detects an additional installation of Oracle RMAN agent, the script prompts whether to uninstall that version. You can specify to keep or uninstall the software.
  The script removes the Oracle RMAN agent software and prints the following type of message:
```
The Oracle RMAN agent is uninstalled from the /home/oracle/opt/dpsapps/rmanagent directory.
Uninstallation is completed.
```

PowerProtect Data Manager 19.10 Oracle RMAN User Guide

Uninstall the Oracle RMAN agent

About this task

Steps

Rate this content