{"id":7979,"date":"2019-04-12T04:04:24","date_gmt":"2019-04-12T04:04:24","guid":{"rendered":"https:\/\/rax-stg-wp-aws.com\/blogs\/install-the-oracle-integration-cloud-service-connectivity-agent-on-an-on-premises-host\/"},"modified":"2026-11-03T19:29:11","modified_gmt":"2026-11-03T19:29:11","slug":"install-the-oracle-integration-cloud-service-connectivity-agent-on-an-on-premises-host","status":"publish","type":"blogs","link":"https:\/\/www.rackspace.com\/en-gb\/blogs\/install-the-oracle-integration-cloud-service-connectivity-agent-on-an-on-premises-host\/","title":{"rendered":"Install the Oracle Integration Cloud Service connectivity agent on an on-premises host"},"content":{"rendered":"

Introduction<\/strong><\/p>\n

To gain access to or to establish a connection with an on-premises, standalone
\ndatabase or Oracle\u00a9 E-business Suite (EBS) database from the Oracle Integration Cloud Service, you need to install the Oracle Integration Cloud Service connectivity agent on your on-premises host. The Oracle Integration Cloud Service agent installs a WebLogic server with only the AdminServer component.<\/p>\n

Installation prerequisites<\/strong><\/p>\n

Before you install the connectivity agent on an on-premises database, make sure that you have considered the following prerequisites:<\/p>\n

*  Operating system (OS) prerequisites include the following items:<\/em><\/p>\n

   –  Oracle Enterprise Linux\u00a9 (OEL) version 6 or 7.<\/em><\/p>\n

   –  8 GB of free memory on the host with a 4 GB Java heap size. If the heap
\n      size increases, you need more memory.<\/em><\/p>\n

   –  A fully-qualified domain name entry in \/etc\/hosts<\/strong>.<\/em><\/p>\n

   –  A mount point with 20 GB of free space.<\/em><\/p>\n

   –  A user name with the database administrator (DBA) group.<\/em><\/p>\n

*  Java version prerequisites include the following items:<\/em><\/p>\n

   –  You must install Oracle JDK version 1.7 or 1.8 to install and use the
\n      connectivity agent.<\/em><\/p>\n

   –  Other JDKs are not supported.<\/em><\/p>\n

*  Open port 443 on the on-premises host to enable connectivity between the
\n   on-premises host (where agent will be installed) and the Oracle Integration
\n   Cloud Service.<\/em>
\n <\/p>\n

Required software downloads and configuration steps<\/strong><\/p>\n

Use the following steps to download the required software components.<\/p>\n

Download the Oracle Integration Cloud Service connectivity agent<\/strong><\/p>\n

Use the following steps to download the connectivity agent software from the
\nOracle Integration Cloud Service:<\/p>\n

1.  Enter https:\/\/cloud.oracle.com\/OIC<\/a> in your browser.
\n2.  Click Sign In<\/strong> and follow the prompts to sign in with your cloud user
\n    name and password.
\n3.  Click Agent<\/strong><\/p>\n

\"oracle<\/p>\n

Click Download and then click Connectivity Agent<\/p>\n

\"oracle<\/p>\n

Move the downloaded installation software to your on-premises host server.The software size should be around 2GB. <\/p>\n

Create an agent group in the Oracle Integration Cloud Service<\/strong><\/p>\n

Before installing the agent, create an agent group in Oracle Integration Cloud Service by using the following steps:<\/p>\n

1. Sign in on [https:\/\/cloud.oracle.com\/OIC<\/a> with your cloud administrator login ID and password, and create an agent group by
\n   clicking the Agent Icon<\/strong><\/p>\n

\"oracle<\/p>\n

Click Create Agent Group and provide inputs as shown in the following image <\/p>\n

\"oracle<\/p>\n

The inputs include the following items:<\/p>\n

– Agent group name<\/strong>: This name is used when you install the connectivity agent on   the on-premises host.
\n– Identifier<\/strong>: You can use the same name as the agent group name or give any name to identify this group.
\n– Agent type<\/strong>: Not changeable.
\n– Description<\/strong>: Give a description of the agent.<\/p>\n

 Download the Oracle Java JDK 1.7 or 1.8<\/strong><\/p>\n

Download the Oracle Java JDK 1.7 or 1.8 from Oracle<\/a><\/p>\n

In this blog post, the installation used the 64-bit version Java as the Linux version.<\/p>\n

Note:<\/strong> Move the downloaded Java to the on-premises host where you want to install the connectivity agent and extract it.<\/p>\n

 Install the Oracle Integration Cloud Service connectivity agent<\/strong><\/p>\n

Make sure the installation software that you previously downloaded is already moved to your on-premises host server.<\/p>\n

Use the following steps to install the connectivity agent in \/u01\/app\/OICS <\/strong>in the on-premises Linux host.
\n <\/p>\n

Set JDK 1.7 or 1.8 to PATH<\/strong><\/p>\n

1.  Extract the latest JDK version at \/u01\/app\/OICS<\/strong> as shown in the following
\n    example:<\/p>\n

    [Softwares]$ pwd
\n    \/u02\/app\/OICS\/Softwares
\n    [Softwares]$ ls -ltr jdk-8u181-linux-x64.tar.gz
\n    -rw-r–r– 1 orati2 dba 185646832 Aug 22 02:29 jdk-8u181-linux-x64.tar.gz
\n    [Softwares]$
\n    [Softwares]$ tar -xzvf jdk-8u181-linux-x64.tar.gz
\n    [Softwares]$ ls -tlr|grep ^d
\n    drwxr-xr-x 7 orati2 dba       4096 Jul  7 04:09 jdk1.8.0_181
\n    [Softwares]$<\/p>\n

2.  Copy all the files from **jdk1.8.0_181<\/strong>** to your **JAVA_HOME<\/strong>** directory as
\n    shown in the following example:<\/p>\n

    [Softwares]$ pwd
\n    \/u02\/app\/OICS\/Softwares
\n    [Softwares]$ cd jdk1.8.0_181
\n    [jdk1.8.0_181]$ cp -pr *.* ..\/..\/jdk\/<\/p>\n

3.  Export JAVA_HOME, add it to your PATH, and check the Java version as shown in the
\n    following example:<\/p>\n

    [OICS]$ export JAVA_HOME=\/u02\/app\/OICS\/jdk
\n    [OICS]$ export PATH=$JAVA_HOME\/bin:$PATH
\n    [OICS]$ which java
\n    \/u02\/app\/OICS\/jdk\/bin\/java
\n    [OICS]$ java -version
\n    java version “1.8.0_181”
\n    Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
\n    Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)
\n    [OICS]$
\n <\/p>\n

 Check the connectivity between the on-premises server and the Oracle Integration Cloud Service<\/strong><\/p>\n

Before installing the agent, verify that the Oracle Integrated Cloud Service URL can be accessed from the on-premises server. If it is inaccessible, the connectivity agent installation fails. Use the following command, which downloads a small file, to verify that Oracle Integration Cloud Service URL is accessible. If the download succeeds, the URL is accessible.
\n <\/p>\n

  [OICS]$  wget -p https:\/\/inspire1-rhughes.integration.us2.oraclecloud.com:443<\/em><\/p>\n

 <\/p>\n

100%[=====================================================================================================================================================>] 8,295       –.-K\/s   in 0.003s<\/em><\/p>\n

    2018-11-15 06:32:49 (2.69 MB\/s) – \u00e2inspire1-rhughes.integration.us2.oraclecloud.com\/index.html\u00e2 saved [8295\/8295]<\/em><\/p>\n

    FINISHED –2018-11-15 06:32:49–
\n    Total wall clock time: 0.6s
\n    Downloaded: 1 file, 8.1K in 0.003s (2.69 MB\/s)
\n    [OICS]$<\/em><\/p>\n

Install the on-premises connectivity agent<\/strong><\/p>\n

\nTo install the on-premises connectivity agent, extract the connectivity agent software. Copy cloud-connectivity-agent-installer.bsx<\/strong>** to a location where you want to install the connectivity agent, such as \/u2\/app\/OICS\/Agent<\/strong>
\nin this example.<\/p>\n

Install the agent by using the following command:<\/p>\n

    .\/cloud-connectivity-agent-installer.bsx \u2014h=https:\/\/ICS_host.us.oracle.com:port \u2014u=username \u2014p=my_password \u2014ad=agent_group_identifier -au=agent_username -ap=agent_password<\/p>\n

The parameters of the command include the following options:<\/p>\n

–    `-h<\/em>` (Required): The Oracle Integration Cloud Service hostname and port.
\n–    `-u<\/em>` (Required): The username of the Oracle Integration Cloud Service with
\n   which the agent connects.
\n–    `-p<\/em>` (Required): The password of Oracle Integration Cloud Service.
\n–    `-ad<\/em>` (Required): The agent group name that you created previously.
\n–    `-au<\/em>` (optional): The WebLogic administrator username, if you don\u2019t want
\n   WebLogic as a user. You should give the username as WebLogic only.
\n–    `-ap<\/em>` (optional): The password of the WebLogic user provided in the ` ‘-ad`
\n   parameter.’<\/p>\n

The following example demonstrates the installation:<\/p>\n

    [Agent]$ pwd
\n    \/u02\/app\/OICS\/Agent
\n    [Agent]$ .\/cloud-connectivity-agent-installer.bsx \u2014h=https:\/\/inspire1-rhughes.integration.us2.oraclecloud.com:443 \u2014u=Vedagiri.Kandasamy@cognizant.com \u2014p=Cts#12345 \u2014ad=INSPIRE_ICS_DB_AGENT -au=weblogic -ap=weblogic123<\/em><\/p>\n

\nUpon successful installation of the agent, the WebLogic console URL is shown in the following example:<\/p>\n

    https:\/\/hostname:7001\/console.<\/em><\/p>\n

Open the console by using the username `weblogic<\/em>` and the password given during the installation in the `-ap<\/em>` parameter.<\/p>\n

The WebLogic console should show AdminServer<\/strong> in RUNNING<\/strong> status.<\/p>\n

 Import the Oracle Integration Cloud Service certificate<\/strong><\/p>\n

Use the following steps to import the Oracle Integration Cloud Service certificate into the agent Keystore Service (KSS) key store.<\/p>\n

1.  In the startAgent.sh<\/strong> file, check line 63 for the key store path, for
\n    example, Agent_Home\/cert\/keystore.jks.<\/strong> In this case, Agent_Home<\/strong> is
\n    \/u02\/app\/OICS\/Agent\/cert\/keystore.jks<\/strong>.
\n2.    Back up the key store.
\n3.  Download the Oracle Integration Cloud Service certificates to the host where
\n    the agent is running.
\n4.  Log in to the Oracle Integration Cloud Service.
\n5.  In a browser, click the secure link to the left of the HTTPS URL.
\n6.  Click Secure Connection > More Information > Security > View Certificate > Details<\/strong>.
\n7.  Click Export<\/strong> and save the file with a .crt<\/strong> extension and as a
\n    type X.509 Certificate with chain (PEM) (\\*.crt,\\*.pem)<\/strong>.
\n8.  Download all three certificates (Root, Intermediate, and User Level, and move
\n    the downloaded certificates to \/u02\/app\/OICS\/Agent\/agenthome\/cert<\/strong><\/p>\n

\n    [cert]$ pwd
\n    \/u02\/app\/OICS\/Agent\/agenthome\/cert
\n    [cert]$ ls -ltr *.crt
\n    -rw-r–r– 1 orati2 dba 1360 Aug 23 03:28 RootCA.crt
\n    -rw-r–r– 1 orati2 dba 1674 Aug 23 04:22 CA_intermediate.crt
\n    -rw-r–r– 1 orati2 dba 2318 Aug 23 04:22 oraclecloudcom.crt
\n    [cert]$<\/em>
\n.<\/p>\n

Import the entire certificate chain from Oracle Integration Cloud Service as follows::<\/p>\n

  [cert]$ keytool -import -trustcacerts -keystore \/u02\/app\/OICS\/Agent\/agenthome\/cert\/keystore.jks -file oraclecloudcom.crt –     alias ICS.us2.oraclecloud.com
\n    Enter keystore password: *******<\/p>\n

    [cert]$ keytool -import -trustcacerts -keystore \/u02\/app\/OICS\/Agent\/agenthome\/cert\/keystore.jks -file RootCA.crt -alias       ICS.us2.oraclecloud.com
\n    Enter keystore password:  *******
\n    Certificate already exists in system-wide CA keystore under alias <rootca [jdk]>
\n    Do you still want to add it to your own keystore? [no]:  yes
\n    Certificate was added to keystore<\/p>\n

    [cert]$ keytool -import -trustcacerts -keystore \/u02\/app\/OICS\/Agent\/agenthome\/cert\/keystore.jks -file CA_intermediate.crt     -alias intermediate_ICS.us2.oraclecloud.com
\n <\/p>\n

 Bounce the agent services<\/strong><\/p>\n

To stop the connectivity agent on the on-premises host, set the environments variable of the Oracle Integration Cloud Service agent by using the following commands:<\/p>\n

    export JAVA_HOME=\/u01\/app\/OICS\/jdk
\n    export AGENT_HOME=\/u02\/app\/OICS\/Agent\/agenthome
\n    export PATH=$JAVA_HOME:$AGENT_HOME:$PATH<\/em><\/p>\n

    cd \/u02\/app\/OICS\/Agent
\n    sh stopAgent.sh<\/em><\/p>\n

\nTo start the connectivity agent on the on-premises host, set the environment variables of the Oracle Integration Cloud Service agent by using the following commands:<\/p>\n

\n    export JAVA_HOME=\/u01\/app\/OICS\/jdk
\n    export AGENT_HOME=\/u02\/app\/OICS\/Agent\/agenthome
\n    export PATH=$JAVA_HOME:$AGENT_HOME:$PATH<\/em><\/p>\n

    cd \/u02\/app\/OICS\/Agent
\n    nohup .\/startAgent.sh -u=CloudUserName -p=CloudPassword &<\/em><\/p>\n

Conclusion<\/strong>
\nThe Oracle on-premises connectivity agent is a key component to integrate any on-premises database to the Oracle Cloud. The latest version of Oracle connectivity agent is available and enables the agent to run in a high availability configuration.<\/p>\n","protected":false},"excerpt":{"rendered":"

Install the Oracle Integration Cloud Service connectivity agent on an on-premises host<\/p>\n","protected":false},"author":2,"featured_media":7981,"menu_order":0,"comment_status":"open","ping_status":"open","template":"","format":"standard","meta":{"content-type":"","nid":"26561","content_type":"blog","created_by":"10130","authored_on":"2024-02-01T05:04:24+00:00","field_article_industries":"","tag_category":"Technical","field_blog_author_text":"by Sunil Sharma, Oracle Applications Database Administrator, Rackspace TBefore you install the connectivity agent on an on-premises database, make sure that you have considered the following prerequisites: * Operating system (OS) prerequisites echnology","seo_description":"Install the Oracle Integration Cloud Service connectivity agent to establish connection with on-premises databases.\r\n","field_featured_image":"","insights_image":"\/wp-content\/uploads\/2026\/blog_technical_images\/26561-insights_image-oracle-technical-blog-1-insights.jpg","field_partners":"","rxt_platforms":"Oracle","product":"","publisheddate":"2019-04-12T04:04:24","rxt_solutions":"Data, Databases, Data Management","opengraph_tag":"","x_tag":"","teaser_flag":"Technical Blog","seo_titile":"Install Oracle Integration Cloud Service connectivity agent | Rackspace Technology","field_topics":"","field_slug":"install-oracle-integration-cloud-connectivity -agent-on-an on-premises-host","footnotes":""},"categories":[178],"tags":[204],"class_list":["post-7979","blogs","type-blogs","status-publish","format-standard","has-post-thumbnail","hentry","category-blog","tag-technical"],"_links":{"self":[{"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/blogs\/7979","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/blogs"}],"about":[{"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/types\/blogs"}],"author":[{"embeddable":true,"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/comments?post=7979"}],"version-history":[{"count":3,"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/blogs\/7979\/revisions"}],"predecessor-version":[{"id":9801,"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/blogs\/7979\/revisions\/9801"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/media\/7981"}],"wp:attachment":[{"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/media?parent=7979"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/categories?post=7979"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.rackspace.com\/en-gb\/wp-json\/wp\/v2\/tags?post=7979"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}