Note: Private Access Channel is now available in Oracle Analytics and is recommended by Oracle for new connections to private data sources. For more information on the feature and the data sources it supports refer to:
    Connect to Private Data Sources Through a Private Access Channel
    Supported Data Sources
    A-Team Chronicles Private Access Channel Series

Validated on January 20, 2021 for OAC 5.9

Introduction

This post is a step-by-step guide to completing the configuration and validation of Remote Data Gateway.

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

 Validations

January 20, 2021 for OAC 5.9

October 12, 2020 for OAC 5.8

July 22, 2020 for OAC 5.7

May 20, 2020 for OAC 5.6

February 14, 2020 for OAC 5.5 and RDG 5.5

October 15, 2019 for OAC 5.4 and RDG 5.4

Topics

Before you Begin

Enabling the Remote Data Gateway in OAC

Configuring the Remote Data Gateway Agents

Validating OAC Remote Data Access

 Before You Begin

Prerequisites

Configuring and Validating RDG requires the following common items:

Credentials and Privileges to install software on the RDG host.

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

An SSH client with a configuration file containing the RDG host and a bastion host if the RDG host is in a private subnet. A local port forwarding directive for the RDG HTTP port should exist in the file. Refer here for the steps to create the configuration file. Note: All SSH commands below use  the configuration file.

The DB subnet must have a security list or Network Security Group rule allowing ingress via the DB Listening Port e.g. 1521, 1522 

 Enabling the Remote Data Gateway in OAC

Log into OAC. From the home page, navigate to the DV Console:

Click the Hamburger icon.

Click Console.

Click Remote Data Connectivity

Click Enable Data Gateway

 Configuring the Remote Data Gateway Agents

Configuring a Remote Data Gateway Agent requires navigating between the OAC Remote Data Connectivity console and the Remote Data Gateway Agent console.

Starting the RDG Configuration Utility

MAC

Start the RDG i.e. Oracle Analytics Data Gateway.app from the Applications folder.

Windows

Connect with RDP if necessary. Start RDG i.e. datagateway.exe from the installation directory.

Linux

Starting the RDG Configuration Utility requires browser access to the RDG host and port. 

Start the SSH Local Port Forwarding

ssh RDG-HOST

Test if Access is Available

Use a browser and the following URL:

http://localhost:<Your RDG HTTP port>/obiee/javads?status

If successful, an XML response is returned.

Start the configuration

http://localhost:<Your RDG HTTP port>/obiee/config.jsp

Obtaining the OAC URL

From the OAC instance. Copy the URL up to the end of the host name

e.g. < instance >-<tenancy>.analytics.ocp.oraclecoud.com

Creating an RDG Agent 1 of 2

Once the various configuration utilities have been started, the GUI is the same for all.

• Enter the OAC URL obtained above and click Generate Key

• Copy the generated key to the clipboard

• Leave the other fields blank unless you want to restrict the hosts that an agent can access or restrict the type of access.

​​​Leave the configuration screen as is and switch over to OAC,

Registering the Data Gateway Agent in OAC

Go to the OAC Remote Data Connectivity page in OAC.

• Click Add.

• Paste the key generated from the Agent definition screen into the Public Key. Note that the Name, ID and Host are populated from the key contents. Optionally change the Name. Click OK.

• The agent is registered.

Creating an RDG Agent 2 of 2

Return to the configuration utility.

Click Test. A Successfully authenticated message appears.

Click Save. A Successfully Submitted message appears

Click Enable.

​​​ Validating OAC Remote Data Access

With the agent(s) configured and running, creating a new DV data connection validates that RDG is configured correctly.

• Login or Go to the OAC home page

• Click the Hamburger icon.

• Click Data

​

• Click Connections

​

• Enter the required fields.

  • Check the Use Remote Data Connectivity box.

  • Click Save

​

You can now create DV Data Sets and projects using the remote data source.

 Summary

This post described the common tasks necessary to complete the configuration and validation of Remote Data Gateway.

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