Skip to main content
Install the agent and register Oracle Server
Updated over a week ago

Enterprise Workloads Editions: βœ… Business | βœ… Enterprise | βœ… 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 Enterprise 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 Enterprise 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.

    For agent version 6.x or earlier:

    clipboard_efe1c2bc04f7a4f542b886802f6eff890.png

For agent version 7.x or later:
​


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

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

  1. Go to the directory that contains the Enterprise 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:
    For agent version 6.x or earlier, run the following command:
    ​ rpm –ivh druva-phoenix-oracle-client-4.9.3-107618.x86_64.rpm
    For agent version 7.x or later, run the following command:

    rpm –ivh EnterpriseWorkloads-UnifiedAgent-7.0.0-419591-x86_64.rpm

πŸ“ Note
​ We do not recommend the use of a package manager, such as yum, for installing the Enterprise Workloads agent package to avoid any installation errors.


Step 3: Activate the Enterprise Workloads agent

After you install the Enterprise Workloads agent, you must activate the Enterprise 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 Enterprise Workloads agent. After authentication, the Enterprise 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.

    • 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 Enterprise 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 Enterprise Workloads agent on Linux is as follows:
    ​/etc/PhoenixOracle/Phoenix.yml (for agent version 6.x or earlier) or /etc/Druva/EnterpriseWorkloads/OraclePlugin.yml (for agent version 7.x or later)

Procedure

  1. Open the command prompt.

  2. Run the activation script copied in Step 3.1.
    ​

Cloud

Agent Version

Command

Example

Public

6.1.3-466835.x86_64 or earlier

/opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate --token <valid_token> -n β€œ<ServerName>”

/opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate --token eyJQcm9kdWN0SUQiOjEyMjg5LCJDdXN0b21lcklEIjozLCJjb29raWUiOiIiLCJUb2tlbiI6ImQ0MmM2Y2IyY2Q0ZjA1Zjk4YzRhN2RlMTY5YjI3MzE5IiwiVG9rZW5JRCI6NzY4M30=

7.x or later

EnterpriseWorkloadsAgent oracle activate -t <valid_token>

EnterpriseWorkloadsAgent oracle activate -t eyJQcm9kdWN0SUQiOjEyMjg5LCJDdXN0b21lcklEIjoxMDMzNjcsImNvb2tpZSI6IiIsIlRva2VuIjoiNzYyNjc3ZDhkMTVmNzdmOGI1NTQxYWFkY2YyYTk2NmMiLCJUb2tlbklEIjo0NjkyLCJHbG9iYWxDdXN0b21lcklEIjoiZTkwNGQwYWQtN2MwOC00YmUwLWJhMTItMWUzNDRmMDNiYWIyIn0=

Gov

6.1.3-466835.x86_64 or earlier

/opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate --gov-cloud --token <token> -n ”<ServerName>”

/opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent oracledtc activate --gov-cloud --token 52931-221-1762-591132241ce4fb2e14fca792cbf532f4a2359eb0bf1b96f8221343eb233c44a -n β€œLIN-RTG3”

7.x or later

EnterpriseWorkloadsAgent oracle activate --gov-cloud <valid_token>

EnterpriseWorkloadsAgent oracle activate --gov-cloud eyJQcm9kdWN0SUQiOjEyMjg5LCJDdXN0b21lcklEIjoxMDMzNjcsImNvb2tpZSI6IiIsIlRva2VuIjoiNzYyNjc3ZDhkMTVmNzdmOGI1NTQxYWFkY2YyYTk2NmMiLCJUb2tlbklEIjo0NjkyLCJHbG9iYWxDdXN0b21lcklEIjoiZTkwNGQwYWQtN2MwOC00YmUwLWJhMTItMWUzNDRmMDNiYWIyIn0=


πŸ“ Note
​The ServerName should be within double quotes.
These commands are for client version 6.1.0 to
6.1.3-466835.x86_64.
​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 Enterprise 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 Enterprise Workloads agent is activated, the registered Oracle server hosts appear on the Oracle Servers page.

clipboard_ef47e98c3e333ea151def39d778502f1c.png

Configure Web proxy

Before you begin

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

Procedure

  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> (for agent version 6.x or earlier)

    OR

    EnterpriseWorkloadsAgent web-proxy-config -s -i 172.16.27.47:3128 -t http -u pxuser -p pxpass (for agent version 7.x or later)

  3. (Optional)You can use the following command to fetch the current proxy configuration:
    /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent web-proxy-config -g (for agent version 6.x or earlier) or
    EnterpriseWorkloadsAgent web-proxy-config -g (for agent version 7.x or later)

Field

Description

Get_web-proxy

(-g, --get)

Fetches the current Web proxy configuration for the agent.

Set_web_proxy

(-s, --set)

Sets the current Web proxy configuration for the agent.

Proxy_type

(-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.

Proxy_IP

(-i, --host string)

Valid IP or URL of proxy server.

Port

Respective proxy port number.

Proxy_user

(-u, --user string)

Valid proxy user name.

Proxy_password

(-p, --pass string)

Valid proxy password.

  1. The Web proxy is configured successfully.

  2. Notes:

    • 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 (for agent version 6.x or earlier)
        or
        EnterpriseWorkloadsAgent web-proxy-config -r (for agent version 7.x or later)
        OR

      • /opt/Druva/PhoenixOracle/bin/HybridWorkloadsAgent web-proxy-config --remove (for agent version 6.x or earlier)

        or

        EnterpriseWorkloadsAgent web-proxy-config --remove (for agent version 7.x or later)

Next steps

The Enterprise 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.

Did this answer your question?