Oracle Analytics Server：マーケットプレイスからのデプロイ

# はじめに
Oracle Analytics Server（**OAS**）は、Oracle Analytics Cloud（**OAC**）とほぼ同等の機能を提供する総合的なアナリティクス・スイートです。
OACとの違いは、オンプレミス用のソフトウェアであるということです。
ソフトウェアの構成を顧客が管理するのと引き換えに、オラクル管理であるOACでは不可能な一部のカスタマイズが可能になります。
Oracle Cloud Infrastructure（**OCI**）では、IaaS環境を提供していますので、OASもそこで動作可能なのです。
マーケットプレイスという仕組みを使用すればOCIのIaaS環境へのデプロイが簡単にできるという利点があります。

# 構成
今回想定しているのは、同一のプライベート・サブネットにDatabase CloudのインスタンスとOASのコンピュート・インスタンスを作成する極めてシンプルなものです。
Database Cloudには、OASの管理情報が格納されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/2bdbe121-9fd9-2c63-7566-3d7fd93b7ffc.png)

# 使用するユーザ
| ユーザ | 目的 | どこで管理するか |
|:-|:-|:-:|
|OCIセキュリティ管理者|ユーザ、グループ、ポリシー、コンパートメントの作成・管理|OCI管理コンソール|
|OASインスタンス管理者|マーケットプレイスからOASインスタンスをデプロイ・管理|OCI管理コンソール|
|DBインスタンス管理者|OASが管理用途で使用するDBインスタンスのデプロイ・管理、OASインスタンス管理者と共通でも可|OCI管理コンソール|

# 1. 管理用のユーザの作成
OCIセキュリティ管理者として、OCI管理コンソールにログインします。
アイデンティディ・ドメインに必要なユーザを作成します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/16c264a3-f143-6acb-5a20-4e46373dd106.png)
グループも作成し、ユーザをマップします。
今回の例では、「OAS_Admins」というグループをOASインスタンス管理者グループとして使用します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/e3049e78-ea59-2560-c4fd-856bbb5c955e.png)

# 2. ポリシーの設定
アイデンティティの「ポリシー」に移動します。
ルートコンパートメントで「ポリシーの作成」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/32dd0cf0-65cf-dda3-b246-47cedde49537.png)
任意の名前を入力します。
「手動エディタの表示」をオンにして、ポリシーを設定します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/f9c4b32d-d6ab-4b3d-3da3-7be6d765c321.png)
```
allow group OAS_Admins to read compartments in tenancy
allow group OAS_Admins to manage instance-family in compartment demo
allow group OAS_Admins to use virtual-network-family in compartment demo
allow group OAS_Admins to manage orm-family in compartment demo
```
「作成」をクリックしてポリシーを作成します。

# 3. PDBの接続文字列の取得
DBインスタンス管理者として、OCI管理コンソールにログインします。
作成済みのDBシステムの「データベース詳細」画面に移動します。
まだ作成していない場合は、ここで作成します。
プラガブル・データベースの接続文字列を確認しメモします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/9166032d-46b1-ef23-45a0-a45c232e388a.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/95a184d7-5395-89d1-9eca-8dc6d186b4b2.png)

# 4. マーケットプレイスでAnalytics Serverをデプロイ
OASインスタンス管理者として、OCI管理コンソールにログインします。

## 4.1 スタックの起動
マーケットプレイスの「すべてのアプリケーション」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/a825f0db-ba70-f109-ca02-cad29d9d0089.png)
「Analytics Server」で検索します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/526cd9ce-eecc-e343-e026-c8c082fe2248.png)
課金タイプに合わせて、BYOLかUCMを選択します。ここではUCMを選択したものとします。
バージョン、コンパートメントを選び「スタックの起動」をクリックします。
この記事を書いている時点の最新版である「OAS 2022 (6.4)」を選択しました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/a05d654f-244f-8404-6157-129ced04f00c.png)

## 4.2 スタックの作成
名前と説明を入力して「次」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/f26338cb-7151-6a6f-b04d-8307dc0b93ae.png)
コンピュート・インスタンスの設定値を入力し、下にスクロールします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/00678037-6265-4ef0-5e97-a2b875559ecf.png)
ネットワークの情報を入力し、下にスクロールします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/2b665df4-3539-96a3-5656-731f0160e76e.png)
作成するドメインの構成情報を入力し、「次」をクリックします。
「Analytics Administrator Username」は、WebLogicコンソールにログインする管理者であり、OASの最初の管理者でもあります。
DBの接続文字列は、書式に注意してください。（「ホスト名：ポート番号：サービス名」です）
Database Schema Prefixは、RCUによって作成されるスキーマの接頭辞です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/3300faf9-88cb-7e4a-73cd-00b3b271f9a4.png)
ここまでの内容を確認し「作成」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/5c9d3470-be0c-d1fc-93b6-4bd061540cca.png)

## 4.3 スタック・ジョブの実行
ジョブの実行にはそれほど時間はかかりません。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/bcc4db11-ccad-e970-235b-43f1bf598d8d.png)
完了後、ジョブ・リソースで作成したリソースが確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/6cf5f7f6-851c-0edd-cf75-74d7ec2bfc7f.png)
同様に、出力でコンピュート・インスタンスに割り当てられたプライベートIPが確認できます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/2bae51f4-98dc-59e5-8729-a866d55ee407.png)

## 4.4 ログの確認
OASのコンピュートインスタンスにログインして、ログを確認できます。
確認するべきログファイル
- /var/log/oas_cloudinit.log
- /var/log/oas_create_domain.log

ドメインの作成が完了するまでに、30分くらいかかります。
最終的に oas_create_domain.log には、このような情報が出力されました。
```
[CONFIG] SUCCESS:Collect logs
Configuration:Oracle_Analytics_Configuration completed successfully
The configuration of Oracle Distribution completed successfully.
```
また、
/u01/app/oas-scripts/oas_install.finish
という長さ0のファイルが出力されます。

## 4.5 追加のライブラリをインストール
OASのコンピュート・インスタンスにopcユーザでログインし、次のコマンドを実行します。
```
sudo yum install -y libgfortran
```
これで完了です。

# 5. Analytics Serverにログインして動作確認
実際にログインして動作を確認してみます。

## 5.1 主要なポート番号
| WebLogic Serverコンポーネント | デフォルトポート |
|:-|:-:|
| 管理サーバ (http)  | 9500  |
| 管理サーバ (https)  | 9501  |
| 管理対象サーバ bi_server1 (http)  | 9502  |
| 管理対象サーバ bi_server1 (https)  | 9503  |

参考情報

https://docs.oracle.com/en/middleware/bi/analytics-server/deploy-oas-cloud/administer-oracle-analytics-server-oracle-cloud.html#GUID-742EE192-4868-4159-81FC-EF86284F5F6B

## 5.2 ログインしてみる
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/7e62247f-346d-1119-20b5-0ccae008c997.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/16c9c783-0419-705d-da34-afacabb6f807.png)

# 6. Analytics Serverの起動と停止
ブラウザ上からAnalytics Serverのサービスを起動・停止することはできません。
コンピュート・インスタンスにログインしたあとoracleユーザにスイッチし、スクリプトで起動・停止します。

スクリプトの場所：/u01/data/domain/bi/bitools/bin
| スクリプト | 機能 |
|:-:|:-|
| start.sh  | OASコンポーネントの起動  |
| stop.sh  | OASコンポーネントの停止  |
| status.sh  | OASコンポーネントのステータス確認  |

# 7. 削除
OASインスタンス管理者としてOCI管理コンソールにログインします。
「開発者サービス」の「スタック」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/2798fe93-45ba-d1b0-9569-80140e2a35b7.png)
Analytics Serverを作成したときのスタックをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/f54668c5-3a5e-c1cf-f65f-8d49305c51e7.png)
「破棄」ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/e2a26527-34a1-6917-bee0-95f67e638a4e.png)
確認画面が表示されるので、「破棄」ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/ba0e84db-68ab-6c2b-4568-2e5e118d2cef.png)
しばらく待ちます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/9742b29a-d632-e117-bb2e-97fca59597b7.png)
破棄が成功したら、スタック自体を削除します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/a6101219-5d24-20b9-b90a-368b66240d7b.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2342206/24ae1922-ea93-9cd2-616b-89b42d6f11f3.png)

# 8. ドキュメント
公式ドキュメントです。

https://docs.oracle.com/en/middleware/bi/analytics-server/deploy-oas-cloud/index.html