Best Practices from Oracle Development's A‑Team

Installing Oracle Analytics Cloud Remote Data Gateway

Validated February 13, 2020 with OAC 5.5 and RDG 5.5


This post is a step-by-step guide describing the common installation tasks for Oracle Analytics Cloud (OAC) Remote Data Gateway (RDG).

For Linux, it details the steps for using the installer with a GUI. 

Note: Refer here for a post on installing RDG silently on Linux without a GUI.

This post is used by the scenarios noted in the companion blog Deploying Remote Data Gateway in Oracle Analytics Cloud for Data Visualization


  • February 13, 2020 with OAC 5.5 and RDG 5.5

  • October 15, 2019 with OAC 5.4 and RDG 5.4


  • MacBook Pro OS 10.13.6 

  • Windows Server R12 Compute Instance

  • Linux 7.2 / 7.7 Compute Instance


  • Before You Begin

  • Installing Remote Data Gateway

 Before You Begin

Reviewing Supported Operating Systems

  • Ensure your operating system is supported by viewing the list at OAC Downloads.


It is assumed that the latest installer zip file exists on the RDG host. Installing RDG requires the following common items:

All Platforms

Credentials and Privileges to install software on the RDG host.

Linux and Windows Servers

The IP address or host name where RDG is to be installed.


A Graphical User Interface or alternatives such as VNC and X11

Linux and Windows SSH

Follow the steps in Preparing SSH Tunneling for Oracle Analytics Cloud Remote Data Gateway in a Private Subnet to setup your SSH configuration file for access to the RDG Host.


The Microsoft Remote Desktop (RDP) utility if accessing remote Windows servers.

 Installing Remote Data Gateway

The steps for all platforms are documented in Install Data Gateway.


  • Installing RDG on Windows

  • Installing RDG on MAC

  • Installing RDG on Linux

  • Installing Additional RDG Agents on Linux

Installing RDG on Windows

Connect to the RDG host via RDP if necessary.

There is not a standalone installer. Extract the contents of the downloaded ZIP file to a desired directory.

Installing RDG on MAC-OS

Unpack the ZIP file contents to the /Application folder.

Installing RDG on Linux

Remote Data Gateway may be installed on Linux with or without a GUI. This post focuses on the GUI and uses X11. If the host does not have one, consider installing the X11 system. Pointers can be found in Preparing Linux for Oracle Remote Data Gateway. The SSH commands assume the ssh client configuration file has an entry for the RDG host e.g. RDG-HOST

Start the X11 Server on the Client

Start the X11 server on your client machine e.g. XQuartz on Mac or XMing on Windows

Unzip the RDG Download

ssh RDG-HOST unzip < Path to Installer Zip File >

Make the RDG Installer Executable

If necessary,

ssh RDG-HOST chmod 774 <name of bin file>.bin

Run the Installer using X11Forwarding

ssh -X RDG-HOST ./<name of bin file>.bin

Waiting for and Using the Installer GUI

Accept the defaults for the Installation Inventory Setup and click OK.

If a Welcome dialog is displayed, click Next.

At the Installation Location dialog, choose an unused location and click NextNote: The installer creates the directory if it does not exist.

At the Select Remote Data Version dialog, select Remote Data Gateway and click Next.

At the Agent Configuration Credentials dialog, specify a username and password to use for logging into the Data Gateway Agent Configuration page and click Next.

At the Installation Summary dialog, click Install.

After the Installation Progress screen completes, click Next.

At the Installation Complete dialog, click Start Jetty and then click Finish.

Validating the Linux Installation and Obtaining the Port and the URL

Use the status command and make a note of the HTTP Port and the URL for use in configuring RDG

ssh RDG-HOST <Install Directory>/domain/bin/status.sh

Installing Additional RDG Agents

Additional RDG installations in different availability domains are recommended for High-Availability (HA) requirements.


This post described the common installation tasks for Oracle Analytics Cloud (OAC) Remote Data Gateway (RDG).

RDG is now ready for the scenario-specific pre-configuration steps described in the various scenario-specific posts.

For other posts relating to analytics and data integration visit http://www.ateam-oracle.com/dayne-carley


Be the first to comment

Comments ( 0 )
Please enter your name.Please provide a valid email address.Please enter a comment.CAPTCHA challenge response provided was incorrect. Please try again.Captcha