Skip to main content

How can we help you?

Druva Documentation

Install the agent and register Oracle Server

Enterprise Workloads Editions: File:/tick.png Business File:/cross.png Enterprise File:/tick.png Elite


Before you can set up Druva in your infrastructure, ensure that you have configured organizations and administrators. For more information, see Quick steps to set up Druva to back up Oracle databases.

Ensure that you read through the system requirements and prerequisites.

Note: These instructions apply to install the Hybrid Workloads agent on Oracle Linux, RHEL Linux, and CentOS servers. Druva does not support database backups on the Windows server hosts.

The following video illustrates the process. 

Step 1: Download the Hybrid Workloads agent on the Oracle server

  1. Log in to the Management Console.
  2. Click Oracle > Direct to cloud from the Protect menu. Note that if the All Organizations menu is enabled, you have to first select an organization where you want to register the Oracle Server and then click Oracle > Direct to Cloud.
  3. On the Oracle page, click Register Oracle Server.
    The Register Oracle Server page opens.
  4. In the Download and install Oracle agent on the server section, click Download to download the package.clipboard_efe1c2bc04f7a4f542b886802f6eff890.png

After you download the agent installer, install the Hybrid Workloads agent on your Oracle server.

Step 2: Install the Hybrid Workloads agent on the Oracle Server

  1. Go to the directory that contains the Hybrid Workloads agent installer.
  2. Run the following command:
    rpm –ivh <package name>
    where <package name> represents the file name (along with the extension) of the installer.
    Example: rpm –ivh druva-phoenix-oracle-client-4.9.3-107618.x86_64.rpm

Note: We do not recommend the use of a package manager, such as yum, for installing the Hybrid Workloads agent package to avoid any installation errors.

Step 3: Activate the Hybrid Workloads agent

After you install the Hybrid Workloads agent, you must activate the Hybrid Workloads agent by using the activation token generated at the time of registering the Oracle server. The token functions as a unique identifier and performs a one-time authentication of the Hybrid Workloads agent. After authentication, the Hybrid Workloads agent establishes a persistent connection with the Druva Cloud.

  1. In the Activate Server for Backup section, Druva provides a Default Activation Token that you use to activate the Oracle server. This token is valid for  25 servers and for 7 days. 
  2. Click Copy Script to copy the activation script containing the activation command and activation token, save it to a text file, and click Done.
  3. You can also navigate to Manage > Activation Tokens from the top menu bar to get the activation token again.
  4. If this token has expired, click Generate New Token. In the Generate Token dialog box, enter the following details, and click Generate
    Field Description
    Token Label Specify a label to help you identify the token.

    This token can activate

    Specify the number of Oracle servers that the activation token can activate. The default value is 25 servers.
    The token expires in Specify the number of days after which the activation token expires. The default value is 7 days.

After you generate an activation token, activate the Hybrid Workloads agent on your Oracle server.

Note: We recommend that you use a single token to activate servers that share something in common. For example, you might want to use a token to activate all servers that are geographically co-located.

Additional information

  • The Threat Management Gateway (TMG) drops the idle connections after a defined timeout duration, due to which the agent does an aggressive retry with the server.

    Note: In TMG application, it is recommended to set connection timeout value to 5 minutes.

  • The configuration file path for Hybrid Workloads agent on Linux is as follows:


  1. Open the command prompt.
  2. Run the activation script copied in Step 3.1.  
    • To activate server on the public cloud:
      /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate --token <valid_token> -n “<ServerName>”
      For Example:
      /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate --token 52931-221-1762-591132241ce4fb2e14fca792cbf532f4a2359eb0bf1b96f8221343eb233c44a -n "WIN-RTG3"
    • To activate server on the gov cloud:
      /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate -g --token <token> -n ”<ServerName>”
      For example:
      /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate -g --token 52931-221-1762-591132241ce4fb2e14fca792cbf532f4a2359eb0bf1b96f8221343eb233c44a -n “WIN-RTG3”

NoteThe ServerName should be within double quotes.
These commands are for client version 6.1.0 and later.

For versions 6.0.0 and earlier: 

  • To activate server on the public cloud:
    • PhoenixOracleActivate <token>
  • Example:
  • Oracle activated command prompt.PNG
  • To activate server on the gov cloud:
    • PhoenixOracleActivate govcloud <token>
  • Note: On Linux servers, the Hybrid Workloads agent writes logs to /var/log/Phoenix. The free space at this location should be at least 1% of your source data size.

After the Hybrid Workloads agent is activated, the registered Oracle server hosts appear on the Oracle Servers page. 


Configure Web proxy

Before you begin

Ensure that the Hybrid Workloads agent service is running before starting proxy settings.


  1. Open the command line interface window.

  2. In the terminal, run the following command set the Web proxy:
    /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent web-proxy-config -s -t <proxy_type> -i <ProxyHost_IP>:port -u <Proxy_user> -p <Proxy_password>

  3. (Optional)You can use the following command to fetch the current proxy configuration:
    /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent web-proxy-config -g





(-g, --get)

Fetches the current Web proxy configuration for the agent.


(-s, --set)

Sets the current Web proxy configuration for the agent.


(-t, --proxy-type string)

Agent supports the following proxy types:

  • http

  • socks4

  • socks5

Note: If you do not provide the type, http is applied by default.


(-i, --host string)

Valid IP or URL of proxy server.


Respective proxy port number.


(-u, --user string)

Valid proxy user name. 


(-p, --pass string)

Valid proxy password.

  1. The Web proxy is configured successfully.

  2. Note: 

    • Do not use quotes for proxy_IP, proxy_user or proxy_password. 

    • In the terminal, run the following command in the Linux server to remove the Web proxy:

      • /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent web-proxy-config -r

      • /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent web-proxy-config --remove


Next steps

The Hybrid Workloads agent intelligently discovers container databases (and pluggable databases for each container database) and standalone databases that run on the Oracle Server hosts and lists them on the Databases page. However, you can trigger the Discover Database operation on the Druva Management Console to fetch details of the discovered databases. For more information, see Discover databases.

  • Was this article helpful?