Step-by-Step: ติดตั้ง Oracle Integration Cloud Service Connectivity Agent บน On-premises Host

Installation Prerequisites

เพื่อ Access หรือ Establish Connection กับ On-premises Standalone Database หรือ Oracle® E-Business Suite (EBS) Database จาก Oracle Integration Cloud Service ต้อง Install Oracle Integration Cloud Service Connectivity Agent บน On-premises Host Agent ติดตั้ง WebLogic Server พร้อมแค่ AdminServer Component

ข้อกำหนดก่อนติดตั้ง

ก่อน Install Connectivity Agent บน On-premises Database ตรวจสอบ Prerequisites:

OS Prerequisites:
- Oracle Enterprise Linux® (OEL) Version 6 หรือ 7
- Free Memory 8 GB บน Host พร้อม Java Heap Size 4 GB (ถ้า Heap Size เพิ่ม ต้องการ Memory มากขึ้น)
- Fully-qualified Domain Name Entry ใน /etc/hosts
- Mount Point พร้อม Free Space 20 GB
- Username ที่มี DBA Group
Java Version Prerequisites:
- ต้อง Install Oracle JDK Version 1.7 หรือ 1.8 เพื่อ Install และใช้ Connectivity Agent
- JDK อื่นๆ ไม่ Support
Open Port 443 บน On-premises Host เพื่อ Connectivity ระหว่าง On-premises Host (ที่ Agent จะติดตั้ง) และ Oracle Integration Cloud Service

Required Software Downloads และ Configuration Steps

Download Oracle Integration Cloud Service Connectivity Agent

เข้า https://cloud.oracle.com/OIC ใน Browser
Click Sign In และ Sign In ด้วย Cloud Username/Password
Click Agent

Step-by-Step: ติดตั้ง Oracle Integration Cloud Service Connectivity Agent บน On-premises Host

Click Download แล้ว Click Connectivity Agent

Move Downloaded Installation Software ไป On-premises Host Server Software Size ประมาณ 2GB

Create Agent Group ใน Oracle Integration Cloud Service

ก่อน Install Agent สร้าง Agent Group ใน Oracle Integration Cloud Service:

Click Create Agent Group ใส่ Inputs ตามภาพ:

Inputs ประกอบด้วย:

Agent Group Name: ใช้ตอน Install Connectivity Agent บน On-premises Host
Identifier: ใช้ชื่อเดียวกับ Agent Group Name หรือชื่ออื่นเพื่อ Identify Group นี้
Agent Type: ไม่สามารถเปลี่ยนได้
Description: Description ของ Agent

Download Oracle Java JDK 1.7 หรือ 1.8

Download Oracle Java JDK 1.7 หรือ 1.8 จาก Oracle ใน Blog นี้ใช้ 64-bit Version Java สำหรับ Linux

Note: Move Downloaded Java ไป On-premises Host ที่จะ Install Connectivity Agent และ Extract

Install Oracle Integration Cloud Service Connectivity Agent

ตรวจสอบว่า Installation Software ที่ Download ไปแล้ว Move ไป On-premises Host Server แล้ว

ใช้ Steps ต่อไปนี้ Install Connectivity Agent ใน /u01/app/OICS บน On-premises Linux Host

Set JDK 1.7 หรือ 1.8 ให้ PATH

Extract Latest JDK Version ที่ /u01/app/OICS ตัวอย่าง:

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

Copy Files จาก jdk1.8.0_181 ไป JAVA_HOME Directory:

[Softwares]$ cd jdk1.8.0_181
[jdk1.8.0_181]$ cp -pr * ../../jdk/

Export JAVA_HOME, Add to PATH, Check Java Version:

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

Check Connectivity ระหว่าง On-premises Server และ Oracle Integration Cloud Service

ก่อน Install Agent Verify ว่า Oracle Integrated Cloud Service URL Accessible จาก On-premises Server ถ้า Inaccessible Agent Installation จะ Fail ใช้ Command Download ไฟล์เล็กเพื่อ Verify:

[OICS]$ wget -p https://inspire1-rhughes.integration.us2.oraclecloud.com:443
100%[=====================================================================================================================================================>] 8,295 --.-K/s in 0.003s
2018-11-15 06:32:49 (2.69 MB/s) - 'inspire1-rhughes.integration.us2.oraclecloud.com/index.html' saved [8295/8295]
FINISHED --2018-11-15 06:32:49--
Total wall clock time: 0.6s Downloaded: 1 file, 8.1K in 0.003s (2.69 MB/s)

Install On-premises Connectivity Agent

Extract Connectivity Agent Software Copy cloud-connectivity-agent-installer.bsx ไป Location ที่จะ Install เช่น /u2/app/OICS/Agent

Install Agent ด้วย Command:

./cloud-connectivity-agent-installer.bsx —h=https://ICS_host.us.oracle.com:port —u=username —p=my_password —ad=agent_group_identifier -au=agent_username -ap=agent_password

Parameters:

-h (Required): Oracle Integration Cloud Service Hostname และ Port
-u (Required): Username ของ Oracle Integration Cloud Service ที่ Agent Connect
-p (Required): Password ของ Oracle Integration Cloud Service
-ad (Required): Agent Group Name ที่สร้างไว้ก่อนหน้า
-au (Optional): WebLogic Admin Username ถ้าไม่ต้องการ WebLogic เป็น User ให้ Username เป็น WebLogic เท่านั้น
-ap (Optional): Password ของ WebLogic User ใน Parameter -ad

ตัวอย่าง Installation:

[Agent]$ pwd /u02/app/OICS/Agent
[Agent]$ ./cloud-connectivity-agent-installer.bsx —h=https://inspire1-rhughes.integration.us2.oraclecloud.com:443 —u=Vedagiri.Kandasamy@cognizant.com —p=Cts#12345 —ad=INSPIRE_ICS_DB_AGENT -au=weblogic -ap=weblogic123

ตอน Install สำเร็จ WebLogic Console URL จะแสดง:

https://hostname:7001/console.

Open Console ด้วย Username weblogic และ Password ที่ให้ตอน Install ใน Parameter -ap

WebLogic Console ควรแสดง AdminServer ใน Status RUNNING

Import Oracle Integration Cloud Service Certificate

Import Certificate เข้า Agent Keystore Service (KSS) Key Store:

ใน File startAgent.sh Check บรรทัด 63 สำหรับ Key Store Path เช่น Agent_Home/cert/keystore.jks ในกรณีนี้ /u02/app/OICS/Agent/cert/keystore.jks
Backup Key Store
Download Oracle Integration Cloud Service Certificates ไป Host ที่ Agent รัน
Log In Oracle Integration Cloud Service
ใน Browser Click Secure Link ด้านซ้าย HTTPS URL
Click Secure Connection > More Information > Security > View Certificate > Details
Click Export Save File ด้วย Extension .crt และ Type X.509 Certificate with chain (PEM) (*.crt,*.pem)

Download All 3 Certificates (Root, Intermediate, User Level) Move ไป /u02/app/OICS/Agent/agenthome/cert

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

Import Entire Certificate Chain จาก Oracle Integration Cloud Service:

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

Bounce Agent Services

Stop Connectivity Agent บน On-premises Host Set Environment Variables:

export JAVA_HOME=/u01/app/OICS/jdk
export AGENT_HOME=/u02/app/OICS/Agent/agenthome
export PATH=$JAVA_HOME:$AGENT_HOME:$PATH
cd /u02/app/OICS/Agent
sh stopAgent.sh

Start Connectivity Agent บน On-premises Host Set Environment Variables:

export JAVA_HOME=/u01/app/OICS/jdk
export AGENT_HOME=/u02/app/OICS/Agent/agenthome
export PATH=$JAVA_HOME:$AGENT_HOME:$PATH
cd /u02/app/OICS/Agent
nohup ./startAgent.sh -u=CloudUserName -p=CloudPassword &

สรุป

Oracle On-premises Connectivity Agent เป็น Key Component เพื่อ Integrate On-premises Database ไป Oracle Cloud Latest Version ของ Oracle Connectivity Agent Available และ Enable Agent รันใน High Availability Configuration

ใช้แท็บ Feedback เพื่อแสดงความคิดเห็นหรือถามคำถาม

เรียนรู้เพิ่มเติมเกี่ยวกับ Database Services และ Rackspace Application Services