Oracle Integration Cloud Service에서 온프레미스 독립형 데이터베이스 또는 Oracle® E-Business Suite(EBS) 데이터베이스에 접근하거나 연결을 구성하려면, 온프레미스 호스트에 Oracle Integration Cloud Service 연결 에이전트(connectivity agent)를 먼저 설치해야 합니다. 연결 에이전트는 WebLogic 서버를 함께 설치하며, 이때 AdminServer 컴포넌트만 포함됩니다.
설치 사전 요건
온프레미스 데이터베이스 환경에 연결 에이전트를 설치하기 전에 아래 요건들을 반드시 확인하시기 바랍니다.
-
운영체제(OS) 요건
- Oracle Enterprise Linux®(OEL) 버전 6 또는 7
- 호스트에 여유 메모리 8GB 이상 확보, Java 힙(heap) 크기는 4GB로 설정 (힙 크기를 늘릴 경우 더 많은 메모리 필요)
/etc/hosts파일에 정규화된 도메인 이름(FQDN) 항목 등록- 여유 공간 20GB 이상의 마운트 지점 확보
- 데이터베이스 관리자(DBA) 그룹에 속한 사용자 계정
-
Java 버전 요건
- 연결 에이전트의 설치 및 사용에는 Oracle JDK 1.7 또는 1.8 버전이 필수입니다.
- 그 외 다른 JDK 버전은 지원되지 않습니다.
-
네트워크 요건: 온프레미스 호스트(에이전트 설치 대상 서버)와 Oracle Integration Cloud Service 간의 원활한 통신을 위해 443 포트를 개방해야 합니다.
필수 소프트웨어 다운로드 및 구성 절차
아래 절차에 따라 필요한 소프트웨어 구성 요소를 다운로드합니다.
Oracle Integration Cloud Service 연결 에이전트 다운로드
Oracle Integration Cloud Service에서 연결 에이전트 소프트웨어를 다운로드하려면 다음 단계를 수행합니다.
- 브라우저 주소창에 https://cloud.oracle.com/OIC 를 입력합니다.
- Sign In(로그인)을 클릭하고 화면 안내에 따라 클라우드 사용자 이름과 비밀번호로 로그인합니다.
- Agent를 클릭합니다.
- Download를 클릭한 후 Connectivity Agent를 선택합니다.
- 다운로드한 설치 소프트웨어를 온프레미스 호스트 서버로 옮깁니다. 소프트웨어 용량은 약 2GB입니다.
Oracle Integration Cloud Service에서 에이전트 그룹 생성
에이전트를 설치하기 전에 Oracle Integration Cloud Service에서 에이전트 그룹을 먼저 생성해야 합니다. 다음 단계를 따르세요.
- https://cloud.oracle.com/OIC 에서 클라우드 관리자 계정으로 로그인한 후, Agent 아이콘을 클릭하여 에이전트 그룹을 생성합니다.
- Create Agent Group을 클릭하고 아래 이미지와 같이 값을 입력합니다.
입력 항목은 다음과 같습니다.
- Agent group name(에이전트 그룹 이름): 온프레미스 호스트에 연결 에이전트를 설치할 때 사용되는 이름입니다.
- Identifier(식별자): 에이전트 그룹 이름과 동일하게 사용하거나, 그룹을 식별할 수 있는 임의의 이름을 지정할 수 있습니다.
- Agent type(에이전트 유형): 변경할 수 없습니다.
- Description(설명): 에이전트에 대한 간단한 설명을 입력합니다.
Oracle Java JDK 1.7 또는 1.8 다운로드
Oracle 공식 사이트에서 Oracle Java JDK 1.7 또는 1.8을 다운로드합니다. 본 가이드에서는 리눅스 환경 기준 64비트 버전의 Java를 사용했습니다.
참고: 다운로드한 Java 파일은 연결 에이전트를 설치할 온프레미스 호스트로 옮긴 뒤 압축을 해제합니다.
Oracle Integration Cloud Service 연결 에이전트 설치
앞서 다운로드한 설치 소프트웨어가 온프레미스 호스트 서버로 이동되어 있는지 먼저 확인합니다.
아래 절차에 따라 온프레미스 리눅스 호스트의 /u01/app/OICS 경로에 연결 에이전트를 설치합니다.
JDK 1.7 또는 1.8을 PATH에 설정
-
최신 JDK 버전을 /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]$ [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 [Softwares]$ -
jdk1.8.0_181 디렉터리의 모든 파일을 JAVA_HOME 디렉터리로 복사합니다.
[Softwares]$ pwd /u02/app/OICS/Softwares [Softwares]$ cd jdk1.8.0_181 [jdk1.8.0_181]$ cp -pr . ../../jdk/ -
JAVA_HOME을 export하고 PATH에 추가한 후, Java 버전을 확인합니다.
[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) [OICS]$
온프레미스 서버와 Oracle Integration Cloud Service 간 연결 확인
에이전트를 설치하기 전에 온프레미스 서버에서 Oracle Integration Cloud Service URL에 접근 가능한지 반드시 확인해야 합니다. 접근이 불가능하면 연결 에이전트 설치가 실패합니다. 아래 명령어는 작은 파일 하나를 다운로드하여 URL 접근 가능 여부를 검증합니다. 다운로드가 성공적으로 완료되면 해당 URL에 정상적으로 접근할 수 있는 상태입니다.
[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)
[OICS]$온프레미스 연결 에이전트 설치
온프레미스 연결 에이전트를 설치하려면 연결 에이전트 소프트웨어의 압축을 해제합니다. cloud-connectivity-agent-installer.bsx 파일을 에이전트를 설치할 위치(본 예시에서는 /u2/app/OICS/Agent)로 복사합니다.
아래 명령어로 에이전트를 설치합니다.
./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명령어 파라미터는 다음과 같습니다.
-h(필수): Oracle Integration Cloud Service의 호스트 이름과 포트-u(필수): 에이전트가 접속에 사용할 Oracle Integration Cloud Service 사용자 이름-p(필수): Oracle Integration Cloud Service 비밀번호-ad(필수): 앞서 생성한 에이전트 그룹 이름-au(선택): WebLogic 관리자 사용자 이름. 별도의 사용자 이름을 지정하지 않으려면 weblogic으로 지정해야 합니다.-ap(선택): 위-au파라미터에서 지정한 WebLogic 사용자의 비밀번호
아래 예시는 실제 설치 과정을 보여줍니다.
[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에이전트 설치가 성공적으로 완료되면 다음과 같은 형식의 WebLogic 콘솔 URL이 표시됩니다.
https://hostname:7001/console사용자 이름 weblogic과 설치 시 -ap 파라미터로 지정한 비밀번호를 사용해 콘솔에 접속합니다.
WebLogic 콘솔에서 AdminServer가 RUNNING 상태로 표시되어야 합니다.
Oracle Integration Cloud Service 인증서 가져오기
아래 단계에 따라 Oracle Integration Cloud Service 인증서를 에이전트의 Keystore Service(KSS) 키 스토어에 가져옵니다.
-
startAgent.sh 파일의 63번째 줄에서 키 스토어 경로를 확인합니다. 예: Agent_Home/cert/keystore.jks. 본 예시에서 Agent_Home은 /u02/app/OICS/Agent/cert/keystore.jks입니다.
-
키 스토어를 백업합니다.
-
에이전트가 실행 중인 호스트에 Oracle Integration Cloud Service 인증서를 다운로드합니다.
-
Oracle Integration Cloud Service에 로그인합니다.
-
브라우저에서 HTTPS URL 왼쪽의 보안 연결 아이콘(자물쇠)을 클릭합니다.
-
Secure Connection > More Information > Security > View Certificate > Details 순서로 이동합니다.
-
Export를 클릭하고 .crt 확장자로 저장합니다. 파일 형식은 X.509 Certificate with chain (PEM) (*.crt, *.pem)으로 지정합니다.
-
루트(Root), 중간(Intermediate), 사용자(User Level) 인증서 세 개를 모두 다운로드한 후, 해당 인증서들을 /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 [cert]$
- 아래와 같이 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 <rootca [jdk]>
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에이전트 서비스 재시작
온프레미스 호스트에서 연결 에이전트를 중지하려면 아래 명령어로 Oracle Integration Cloud Service 에이전트의 환경 변수를 설정한 후 중지 스크립트를 실행합니다.
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반대로 연결 에이전트를 시작하려면 환경 변수를 설정한 후 시작 스크립트를 백그라운드로 실행합니다.
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 온프레미스 연결 에이전트는 온프레미스 데이터베이스를 Oracle Cloud와 통합하는 데 필수적인 핵심 구성 요소입니다. 최신 버전의 Oracle 연결 에이전트는 고가용성(HA) 구성에서도 실행할 수 있도록 지원합니다.
궁금한 점이나 의견이 있다면 피드백 탭을 활용해 주세요. 데이터베이스 서비스와 Rackspace 애플리케이션 서비스에 대한 자세한 내용도 함께 확인해 보시기 바랍니다.