Oracle Analytics Cloud：Data Gatewayをサイレントモードでアップグレードする

# はじめに
Oracle Analytics Cloud（**OAC**）では、オンプレミスデータに接続する際に2つの方法を用意しています。
* Data Gateway
* Privete Access Channel

これらは、オンプレミスデータだけではなく、Private Subnetに配置されたPublic IPアドレスを持たないDBへの接続にも利用できます。
こちらのサポートされるデータソースで「Remote Data Connectivity」と記載されているデータソースは、Data Gatewayを経由した接続に対応しています。

https://docs.oracle.com/en/cloud/paas/analytics-cloud/acsds/supported-data-sources.html

:::note info
Data Gateway経由では以下の機能は利用できないことに注意してください。
* Data Gateway経由のデータベースへのUsage Trackingデータの保存
* データフローを使用して、Data Gateway経由のデータベースにデータを保存
:::

Data Gatewayを使用するには、Data GatewayのAgentをデータベースがホストされているネットワーク内のマシンにインストールします。
Data GatewayのServer機能はOACに内蔵されています。
Data GatewayのAgentは、OACのバージョンアップに合わせて新しいバージョンがリリースされます。

この記事では、Linuxマシンにインストール済みのData Gateway Agentをサイレントモードでアップグレードする手順を紹介します。

# Data Gateway Agentの取得
[Data Gateway Agentをダウンロード](https://www.oracle.com/middleware/technologies/oac-downloads.html)します。
この記事を書いている時点では、2022年11月版がダウロード可能になっていました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/c686e882-a7d7-a9e4-f7f4-61cc6e3f5553.png)
Linux版をダウンロードします。
ダウンロードが完了したら、インストール先のLinuxマシンに転送し圧縮ファイルを展開しておきます。

# サイレントモードの準備
rootユーザで /etc/oraInst.loc ファイルを作成します。
```
inst_group=oinstall
inventory_loc=/u01/app/oracle/oraInventory
```

続いてレスポンスファイルを作成します。
ホームディレクトリに rdg.res という名前で作成しました。
```
[ENGINE]
#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0

[GENERIC]
#The oracle home location.
ORACLE_HOME=/u01/app/rdg

#Install RDG
SELECT_RD_VERSION_RADIO_V1=false

#Username for account used to configure RDG
CREDENTIALS_PAGE_ADMIN_USERNAME=admin

#Password
CREDENTIALS_PAGE_PASSWORD=Admin123
```

# 実行
Data Gatewa Agentを停止します。
```
$ /u01/app/rdg/domain/bin/stopJetty.sh
$ /u01/app/rdg/domain/bin/status.sh
****************************************************************************
******************************** Data Gateway STATUS ********************************
Data Gateway Jetty Home: /u01/app/rdg/jetty
Data Gateway Domain Home: /u01/app/rdg/domain
Data Gateway Jetty HTTP Port: 8080
Data Gateway Status: DOWN
****************************************************************************
```

展開したファイルを実行します。
```
$ ~/DataGateway_November2022_Linux64.bin -silent -responseFile ~/rdg.res -invPtrLoc /etc/oraInst.loc
Launcher log file is /tmp/OraInstall2022-12-23_02-38-22AM/launcher2022-12-23_02-38-22AM.log.
Checking if CPU speed is above 300 MHz.   Actual 1996.249 MHz    Passed
Checking swap space: must be greater than 512 MB.   Actual 8191 MB    Passed
Preparing to launch the Oracle Universal Installer from /tmp/OraInstall2022-12-23_02-38-22AM
Log: /tmp/OraInstall2022-12-23_02-38-22AM/install2022-12-23_02-38-22AM.log
Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved.
Reading response file..
Validations are enabled for this session.
Verifying data
Copying Files
Percent Complete : 10
Percent Complete : 20
Percent Complete : 30
Percent Complete : 40
Percent Complete : 50
Percent Complete : 60
Percent Complete : 70
Percent Complete : 80
Percent Complete : 90
Percent Complete : 100

The installation of bi_rdc_client 6.9.0.0.0 completed successfully.
Logs successfully copied to /u01/app/oracle/oraInventory/logs.
```

Data Gateway Agentを実行します。
```
$ /u01/app/rdg/domain/bin/startJetty.sh
```

# 関連ドキュメント
* 公式ドキュメント：[Data Gatewayの概要](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acsds/connect-premises-data-sources-using-data-gateway.html)
* 公式ドキュメント：[Data Gatewayのインストールまたはアップグレード](https://docs.oracle.com/en/cloud/paas/analytics-cloud/acsds/install-data-gateway.html#GUID-405875DC-403E-4C40-A7A7-947BEE650D62)
* [Oracle Analytics Cloud：プライベート・アクセス・チャネルでプライベート・データソースにアクセス](https://qiita.com/tyo38/items/489ecd3f323fba471c51)