Oracle Integration Gen3 でのMySQL接続設定ガイド

Oracle Integration Gen3 でのMySQL接続設定ガイドとなります。

## 参考資料

https://docs.oracle.com/cd/E83857_01/paas/application-integration/mysql-adapter/prerequisites-creating-connection.html#GUID-05E8DBC6-95C0-4831-A7FB-A7AAA059B81F


## MySQL インスタンスの作成

こちらは、Oracle Cloud Infrastructureが提供しているMySQL Database Serviceインスタンスを作成します。（詳細のステップは省略）
MySQLがOn Premiseまたは、Marketplaceから作成の場合、設定方法が同じです。何れにしても、OIC Agentを経由して接続します。（Public IPアドレスが有っても、OIC Agentを設定することが必要です）

![Snipaste_2023-09-01_14-38-58.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/62c26662-56a4-7d82-6763-e5c95306cd46.png)

注意：作成したインスタンスは、Public IPアドレス持つことができないため、踏み台サーバーなど方法でアクセスする必要があります。

## 踏み台サーバーの作成

MySQL インスタンスと同じVCNの下で、Public IPアドレスを持つ踏み台サーバー用のVMインスタンスを作成します。
（詳細のステップは省略）

## MySQL Database及びユーザの作成

踏み台サーバーvmで、mysqlクライアントツール（こちらはmysqlsh）をインストールします。その後に、MySQL Database（demodb）及びユーザ（user01）の作成を実施します。

![Snipaste_2023-09-01_15-47-00.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/7537568d-3ce1-7ecc-4f34-8983bdebe59a.png)

![Snipaste_2023-09-04_14-22-02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/b0ca952f-67a2-6787-98e7-e32678696ffd.png)

![Snipaste_2023-09-04_16-37-46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/6ba2158e-9c95-042c-287e-238f81ae32fd.png)

## OIC Agentインストール・ファイルのダウンロード

Oracle Integration Gen3にログインして、Agentインストール・ファイルをダウンロードします。

![Snipaste_2023-09-07_17-47-04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/0936e77f-bd57-bc24-1dda-14b701ca65ae.png)

## OIC Agent Groupの作成

![Snipaste_2023-09-08_13-21-11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/1bc36a28-5ac4-281b-03cf-049ec3f3ffef.png)

![Snipaste_2023-09-08_13-21-46.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/2612e474-1f67-4768-2bde-51bc7005b051.png)

![Snipaste_2023-09-08_13-22-28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/793aeb8f-7def-7a28-375e-2f97d442c7e4.png)

## OIC Agent Groupの構成ファイルのダウンロード

![Snipaste_2023-09-08_13-22-57.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/1ed9c63c-21e0-c2d6-52af-b3bba98a0bdb.png)


## mysql-connector JARのダウンロード

次のサイトから、mysql-connector JARをダウンロードします。

https://downloads.mysql.com/archives/c-j/

![Snipaste_2023-09-11_13-51-31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/1a1e3f54-a619-67ab-5716-4f6e4df2539f.png)

## 各種インストール・ファイルを踏み台サーバーへ転送

ダウンロードした次のファイルを踏み台サーバーへ転送します。

- OIC Agentインストール・ファイル
- OIC Agent Groupの構成ファイル
- mysql-connector JAR


## 踏み台サーバーでJDK17をインストール

踏み台サーバーでJDK17をインストールします。
（詳細のステップは省略）

## 踏み台サーバーでOIC Agentをインストール

1. 転送したAgentインストール・ファイルを次のフォルダ（oic_agent）に解凍します。

    `unzip -d oic_agent oic_conn_agent_installer.zip`

2. 転送したOIC Agent Groupの構成ファイルをoic_agentに上書きします。

    ![Snipaste_2023-09-08_13-33-53.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/38b2bc62-6c68-0ed3-ef12-ae6b151a489c.png)

3. 転送したmysql-connector JARを `oic_agent/agenthome/thirdparty/lib/` の下にコピーします。

## 踏み台サーバーでOIC Agentを起動

```
cd oic_agent/
export JAVA_HOME=/usr/lib/jvm/jdk-17-oracle-x64
export PATH=$JAVA_HOME/bin:$PATH
java -jar connectivityagent.jar
```

![Snipaste_2023-09-08_14-00-44.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/0ead55d4-00ad-aff8-68a5-c1ae6c764d53.png)

OIC ConsoleでAgentのステータスを確認します。


![Snipaste_2023-09-08_14-05-07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/562b7794-1e22-c902-36ef-54dd7c19700b.png)

![Snipaste_2023-09-08_14-05-26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/fb361022-678f-7249-d9c0-24986b9bc2e7.png)

## OICで接続の作成

- Host：MySQLインスタンスのIPアドレス（プライベートIP）
- Port：3306
- Database Name：demodb?sslMode=DISABLED（デフォルトでは、MySQLクライアントはSSL対応MySQLサーバーとのセキュアな接続を確立します。 現在、「MySQLアダプタ」ではSSL暗号化ネットワーク接続はサポートされていません。「?sslMode=DISABLED」をデータベース名demodbの後ろに追加する必要です。）
- Username：user01
- Password：作成したユーザuser01のパスワード
- Connectivity agent：作成したAgent Groupを選択

![Snipaste_2023-09-11_11-12-38.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2534261/18d84521-0206-f697-c1d4-3c137809ebe2.png)