2025年6月9日月曜日

Oracle Autonomous Database Freeのコンテナに含まれるOracle Estate Explorerを実行する

Oracle Autonomous Database Free Container Image Documentationを読んでいると、このコンテナ・イメージにはOracle Estate Explorerが含まれているとの記載がありました。

https://container-registry.oracle.com/ords/ocr/ba/database/adb-free

Oracle Estate Explorerは以下のリンクで紹介されているとおり、Autonomous Databaseへの移行を事前に評価するためのツールです。Oracle APEXで作成されていて、無料で使用できます。ただし、アプリケーションをダウンロードする方法が一般に公開されていません。

https://docs.oracle.com/ja/learn/unveiling-oracle-estate-explorer-autonomous-db/index.html

ADB Free Container Imageに入っているとのことなので、コンテナを実行して確認してみました。行った作業はOracle Estate Explorerを実行するところまでです。Oracle Estate Explorerの使い方については、また、機会があったら勉強しようと思います。

以下より、ADB FreeにインストールされているOracle Estate Explorerの実行手順を紹介します。

最初にADB Freeのコンテナを実行します。ADB Freeのコンテナ・イメージはx86-64しかないので、Intel CPUのMacbook Proのpodmanを使って作業しました。

以下のコマンドを実行し、コンテナadb-freeの作成と実行をします。
podman run -d \
-p 1521:1522 \
-p 1522:1522 \
-p 8443:8443 \
-p 27017:27017 \
-e WORKLOAD_TYPE=ATP \
-e WALLET_PASSWORD=[Walletパスワード] \
-e ADMIN_PASSWORD=[ADMINパスワード] \
--cap-add SYS_ADMIN \
--device /dev/fuse \
--name adb-free \
container-registry.oracle.com/database/adb-free:latest-23ai

% podman run -d \

-p 1521:1522 \

-p 1522:1522 \

-p 8443:8443 \

-p 27017:27017 \

-e WORKLOAD_TYPE=ATP \

-e WALLET_PASSWORD=*********** \

-e ADMIN_PASSWORD=************ \

--cap-add SYS_ADMIN \

--device /dev/fuse \

--name adb-free \

container-registry.oracle.com/database/adb-free:latest-23ai


253b3537965d2b8ad7f58f62034347286e05abd15c94f95c157a6fd34c3a57cf

%


ADB Freeのコンテナは初回起動時にPDBのデータファイルをダウンロードします。そのため、初回起動に時間がかかります。

コンテナのログを確認します。

podman logs -f adb-free

PDBのダウンロード時は以下のようなログが表示されます。ネットワークの速度に依存しますが、この部分で一番時間がかかります。

User has requested to download '.pdb' archive file from Object Storage bucket

Downloading MY_ATP.pdb..

 25%|██▍       | 100M/408M [00:45<02:56, 1.83MB/s] 


ORDSの起動の完了を示す、以下のようなログが出力されれば接続可能な状態になっています。

Mapped local pools from /u01/ords/databases:

  /ords/                              => default                        => VALID     



2025-06-06T07:37:24.038Z INFO        Oracle REST Data Services initialized

Oracle REST Data Services version : 25.1.0.r1001652

Oracle REST Data Services server info: jetty/12.0.13

Oracle REST Data Services java info: Java HotSpot(TM) 64-Bit Server VM  (build: 17.0.12+8-LTS-286 mixed mode, sharing)


ブラウザで以下のURLにアクセスします。


自己署名証明書によってHTTPS化しているため、警告が表示されます。詳細情報を表示し、localhostにアクセスする(安全ではありません)をクリックします。


SQL Developer Webを開きます。Goをクリックします。


SQL Developer WebにユーザーADMINでサインインします。パスワードはコンテナ作成時に環境変数ADMIN_PASSWORDに設定した値です。


Launchpadが開きます。DevelopmentSQLを開きます。


以下のコマンドを実行しデータベース・ユーザーMPACK_OEEにパスワードを設定します。

ALTER USER MPACK_OEE IDENTIFIED BY <PASSWORD>

ユーザーMPACK_OEEは、Oracle Estate ExplorerのAPEXアプリケーションが含まれるワークペースMPACK_OEEの管理者ユーザです。Autonomous Databaseなので、データベース・ユーザーのパスワードがワークスペースへサインインする際のパスワードになります。


APEXのワークスペースMPACK_OEEにサインインします。以下のURLにアクセスします。


ワークスペース名MPACK_OEEユーザー名MPACK_OEEパスワードは直前のALTER USER文で設定した値を入力します。

以上でサインインします。


APEX AccountのPasswordを設定するように要求されます。Set APEX Account Passwordをクリックして作業を進めてもよいのですが、他にも調整すべき項目があったので、AdministrationManage Users and Groupsを開きます。


ユーザーMPACK_OEEが登録されているので、それを開きます。


Account PrivilegesAccessible Schemas (null for all)に記載されているADMINを削除して空白にします。


Password (For authentication against workspace user account repository only)PasswordConfirm Passwordを設定します。ALTER USER MPACK_OEE文で設定したパスワードは、APEXのワークスペースへのサインインに使用するパスワードです。ここで設定するパスワードは、Oracle Estate Explorerのアプリケーションのサインインに使用します。

Apply Changesをクリックし、変更を確定します。


App Builderを開き、Oracle Estate Explorerを開きます。


Run Applicationを実行します。


Oracle Estate Explorerの画面が開きます。ユーザーMPACK_OEE、パスワードをはワークスペースに設定したものを入力します。

Sign Inをクリックします。


Oracle Estate Explorerの画面が開きます。


Helpタブ以下よりOracle Estate Explorerのドキュメントやサンプルにアクセスできます。


HelpAdditional Resourcesからは、カタログに登録するデータを抽出するスクリプトなどがダウンロードできます。


今回の記事は以上になります。