オンプレミスのホストにOracle Integration Cloud Service接続エージェントをインストールする方法

Oracle Integration Cloud ServiceからオンプレミスのスタンドアロンデータベースやOracle® E-Business Suite(EBS)データベースにアクセスまたは接続を確立するには、オンプレミスのホストにOracle Integration Cloud Service接続エージェントをインストールする必要があります。この接続エージェントをインストールすると、AdminServerコンポーネントのみを含むWebLogic Serverが導入されます。

インストールの前提条件

オンプレミス環境に接続エージェントをインストールする前に、以下の前提条件を満たしているかどうかを必ず確認してください。

OS(オペレーティングシステム)の要件

• Oracle Enterprise Linux®(OEL) バージョン6または7であること。
• ホストに8GB以上の空きメモリがあること(Javaヒープサイズは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から接続エージェントのソフトウェアをダウンロードするには、次の手順を実行します。

1. ブラウザで https://cloud.oracle.com/OIC にアクセスします。
2. 「Sign In」をクリックし、クラウドのユーザー名とパスワードを使ってサインインします。
3. 「Agent」をクリックします。

4. 「Download」をクリックし、続けて「Connectivity Agent」を選択します。

5. ダウンロードしたインストールソフトウェア(サイズは約2GB)を、オンプレミスのホストサーバーに移動します。

Oracle Integration Cloud Serviceでのエージェント・グループの作成

エージェントをインストールする前に、次の手順でOracle Integration Cloud Service上にエージェント・グループを作成しておきます。

1. https://cloud.oracle.com/OIC にクラウド管理者のログインIDとパスワードでサインインし、エージェントアイコンをクリックしてエージェント・グループを作成します。

2. 「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をダウンロードしてください。

本記事の手順では、Linux環境向けに64ビット版のJavaを使用しています。

注意: ダウンロードしたJavaは、接続エージェントをインストールするオンプレミスホストに移動し、展開しておいてください。

Oracle Integration Cloud Service接続エージェントのインストール

事前にダウンロードしたインストールソフトウェアが、オンプレミスのホストサーバーに移動済みであることを確認してください。

以下の手順では、オンプレミスのLinuxホスト上の /u01/app/OICS に接続エージェントをインストールします。

JDK 1.7または1.8をPATHに設定する

1. 最新の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]$ 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]$

2. 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/

3. JAVA_HOMEをエクスポートし、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にアクセスできることを必ず確認してください。アクセスできない場合、接続エージェントのインストールは失敗します。

次のコマンド(wgetによる小さなファイルのダウンロード)を実行して、Oracle Integration Cloud Serviceの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 を任意のインストール先ディレクトリ(本記事の例では /u02/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管理者ユーザー名。指定する場合は「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)キーストアにインポートします。

1. startAgent.sh ファイルの63行目でキーストアのパスを確認します。たとえば Agent_Home/cert/keystore.jks のような形式です。本記事の場合、Agent_Home は /u02/app/OICS/Agent/cert/keystore.jks となります。

2. キーストアのバックアップを作成します。

3. Oracle Integration Cloud Serviceの証明書を、エージェントが稼働しているホストにダウンロードします。

4. Oracle Integration Cloud Serviceにログインします。

5. ブラウザで、HTTPS URLの左側にある鍵アイコン(セキュアリンク)をクリックします。

6. 「Secure Connection」>「More Information」>「Security」>「View Certificate」>「Details」の順にクリックします。

7. 「Export」をクリックし、拡張子 .crt で、ファイル形式を X.509 Certificate with chain (PEM)(*.crt、*.pem) として保存します。

8. ルートCA、中間CA、ユーザーレベルの3種類すべての証明書をダウンロードし、/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]$

9. Oracle Integration Cloud Serviceから証明書チェーン全体を、次のようにkeytoolコマンドでインポートします。

[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と統合するための重要なコンポーネントです。最新バージョンの接続エージェントでは、高可用性(HA)構成での運用にも対応しています。

ご意見やご質問がある場合は、フィードバックタブからお気軽にお寄せください。

データベースサービスやRackspace Application Servicesの詳細については、関連ページをご覧ください。