Edward Whalen


This process for Configuring a Linux DIPC Agent for Oracle Database is entirely based on Autonomous DIPC 18.4.3 which is the latest version as of the time of publication.  Recently, DIPC was renamed to DIPC Classic and Autonomous DIPC was renamed to DIPC.

Prior to configuring the DIPC agent you must setup the agent as a confidential application in the Oracle Identity Cloud.  How to do this is covered in the Oracle Documentation “Using Data Integration Platform Cloud” under “Set up an Agent”.  This will be also covered in additional document from me.

Configuring a Linux DIPC Agent for Oracle Database involves downloading the agent, collecting information from the Identity Cloud and Setting up the agent.  Once the agent is up and running there are a few steps to setup GoldenGate replication that will be covered in subsequent blogs.

From the DIPC Console select Agents, then click on the Download button.  Select the OS (Linux or Windows) and products to be replicated to/from.  Note:  Some can only be targets (Big Data) and others both source and target.

Next download the agent by clicking the Download button.  Once you have downloaded it, unzip it in the desired location.  I prefer /u01/app/oracle/dicloud but any location will work.

Once the agent has been downloaded you will need the following information in order to configure the agent:

JAVA_HOME                 The 1.8 JDK must be installed and the JAVA_HOME environment variable must be configured.  The java executable must also be in the user’s path.

DICLOUD service host    This is the URL of your DIPC instance.  You can find this on the top of the browser that you are using to manage DIPC.

DICLOUD service port    This is usually 443 unless you have changed this in the DIPC console.

IDCS server URL            This is found at the bottom of the page under Services Instances of the Identity Cloud Service.  This, along with the agentIdcsScope are also provided as output from the Autonomous DIPC instance creation.

Agent IDCS Scope          This is also found in the end of the creation of the ADIPC instance.

IDCS Client ID                This is taken from the Confidential Application that you have created as part of the Identity Cloud.

IDCS Secret                   This is also taken from the Confidential Application that you have created as part of the Identity Cloud.

Username                     This is your DIPC username.

Password                      This is your DIPC password.

Once you have completed these tasks change directories to ./agent/<instance>/bin under the dicloud directory.  Here startup the agent using nohup ./startAgentInstance.sh & in order to start up the agent in the background.  Once you have started the agent you should see it show up in the DIPC console as shown here:

Once the Linux DIPC Agent for Oracle Database is up and running you can create a connection to the database and/or Kafka or other source/target from the DIPC console.  Setting up connections and tasks will be covered in another paper.