日日是Oracle APEX: Oracle APEXの環境作成(6) - Oracle REST Data Servicesのインストール

2022年11月22日火曜日

Oracle APEXの環境作成(6) - Oracle REST Data Servicesのインストール

更新: 2026年1月27日

Oracle REST Data Services（以下ORDS）をインストールします。

ORDSは、バージョン22にて設定ファイルの構成が大きく変更されました。また、22.3ではORDSのインストール先がCDBであれば、デフォルトでPluggable Mappingの設定を行います。

過去の手順ではPluggable MappingでORDSを構成していました。テスト環境ではPDBを作成するたびにORDSの構成を変更せずに済むため便利なのですが、本番環境には推奨できません。そのため、ORDSのインストール先にPDBを指定します。

以下のインストール手順は、ORDS 24.1以降を対象にしています。

firewalldの構成

ユーザーrootにて仮想マシンにログインし、firewalldを構成します。

Oracle Linuxはデフォルトでfirewalldを含んでいます。AlmaLinuxやRocky Linuxなどのディストリビューションでfirewalldが含まれていない場合は、firewallのインストールと有効化を行います。

dnf -y install firewalld
systemctl enable firewalld
systemctl start firewalld

ORDSは一般ユーザーの権限で動作させるため、HTTPやHTTPSのポート（80および443）の接続を待ち受けることはできません。代わりにポート8080と8443を使用します。firewalldではHTTP（ポート80）の接続をポート8080、HTTPS（ポート443）の接続をポート8443へ転送します。また、HTTPとHTTPSへの接続を許可します。

firewalldを構成する一連のコマンドは以下になります。

firewall-cmd --add-service=https
firewall-cmd --add-service=http
firewall-cmd --add-forward-port=port=443:proto=tcp:toport=8443
firewall-cmd --add-forward-port=port=80:proto=tcp:toport=8080
firewall-cmd --runtime-to-permanent
firewall-cmd --reload
firewall-cmd --list-all

ユーザーrootで、上記のコマンドを実行します。

[root@localhost ~]# firewall-cmd --add-service=https

success

[root@localhost ~]# firewall-cmd --add-service=http

success

[root@localhost ~]# firewall-cmd --add-forward-port=port=443:proto=tcp:toport=8443

success

[root@localhost ~]# firewall-cmd --add-forward-port=port=80:proto=tcp:toport=8080

success

[root@localhost ~]# firewall-cmd --runtime-to-permanent

success

[root@localhost ~]# firewall-cmd --reload

success

[root@localhost ~]# firewall-cmd --list-all

public (active)

target: default

icmp-block-inversion: no

interfaces: enp0s8

sources:

services: cockpit dhcpv6-client http https ssh

ports:

protocols:

forward: no

masquerade: no

forward-ports:

port=443:proto=tcp:toport=8443:toaddr=

port=80:proto=tcp:toport=8080:toaddr=

source-ports:

icmp-blocks:

rich rules:

[root@localhost ~]#

以上でfirewalldの設定は完了です。

Java Development Kitのインストール

ORDSはJavaで書かれたアプリケーションです。使用するJDKは、Oracle JDKを想定しています。不具合なのでSRを上げる場合はOracle JDKで再現することを確認する必要がありますが、今回のような無料の環境での利用であれば、OpenJDKやAmazon Correttoを使用することもできます。

サポートしているJDKのバージョンは17または21です。今回はOpenJDK 21を使用してORDSを動かします。Oracle REST Data Services 23.3に追加されたGraphQLのサポートを有効にするには、通常のJDKではなくGraalVMを使う必要があります。

dnf -y install java-21-openjdk-headless

[root@localhost ~]# dnf -y install java-21-openjdk-headless

Failed to set locale, defaulting to C.UTF-8

Last metadata expiration check: 2:38:48 ago on Tue Jan 27 12:22:25 2026.

Dependencies resolved.

================================================================================

Package Arch Version Repository Size

================================================================================

Installing:

java-21-openjdk-headless aarch64 1:21.0.10.0.7-1.0.1.el8

ol8_appstream 48 M

Installing dependencies:

alsa-lib aarch64 1.2.10-2.el8 ol8_appstream 468 k

avahi-libs aarch64 0.7-27.el8_10.1 ol8_baseos_latest 60 k

copy-jdk-configs noarch 4.0-2.el8 ol8_appstream 30 k

cups-libs aarch64 1:2.2.6-66.el8_10 ol8_baseos_latest 420 k

javapackages-filesystem noarch 5.3.0-1.module+el8+5136+7ff78f74

ol8_appstream 30 k

lksctp-tools aarch64 1.0.18-3.el8 ol8_baseos_latest 98 k

lua aarch64 5.3.4-12.el8 ol8_appstream 188 k

tzdata-java noarch 2025c-1.0.1.el8 ol8_appstream 186 k

Enabling module streams:

javapackages-runtime 201801

Transaction Summary

================================================================================

Install 9 Packages

Total download size: 50 M

Installed size: 218 M

Downloading Packages:

(1/9): avahi-libs-0.7-27.el8_10.1.aarch64.rpm 11 kB/s | 60 kB 00:05

(2/9): lksctp-tools-1.0.18-3.el8.aarch64.rpm 18 kB/s | 98 kB 00:05

(3/9): cups-libs-2.2.6-66.el8_10.aarch64.rpm 77 kB/s | 420 kB 00:05

(4/9): copy-jdk-configs-4.0-2.el8.noarch.rpm 450 kB/s | 30 kB 00:00

(5/9): javapackages-filesystem-5.3.0-1.module+e 287 kB/s | 30 kB 00:00

(6/9): alsa-lib-1.2.10-2.el8.aarch64.rpm 2.2 MB/s | 468 kB 00:00

(7/9): lua-5.3.4-12.el8.aarch64.rpm 1.4 MB/s | 188 kB 00:00

(8/9): tzdata-java-2025c-1.0.1.el8.noarch.rpm 1.4 MB/s | 186 kB 00:00

(9/9): java-21-openjdk-headless-21.0.10.0.7-1.0 8.9 MB/s | 48 MB 00:05

--------------------------------------------------------------------------------

Total 4.6 MB/s | 50 MB 00:10

Running transaction check

Transaction check succeeded.

Running transaction test

Transaction test succeeded.

Running transaction

Running scriptlet: copy-jdk-configs-4.0-2.el8.noarch 1/1

Running scriptlet: java-21-openjdk-headless-1:21.0.10.0.7-1.0.1.el8.aar 1/1

Preparing : 1/1

Installing : tzdata-java-2025c-1.0.1.el8.noarch 1/9

Installing : lua-5.3.4-12.el8.aarch64 2/9

Installing : copy-jdk-configs-4.0-2.el8.noarch 3/9

Installing : javapackages-filesystem-5.3.0-1.module+el8+5136+7ff7 4/9

Installing : alsa-lib-1.2.10-2.el8.aarch64 5/9

Running scriptlet: alsa-lib-1.2.10-2.el8.aarch64 5/9

Installing : lksctp-tools-1.0.18-3.el8.aarch64 6/9

Running scriptlet: lksctp-tools-1.0.18-3.el8.aarch64 6/9

Installing : avahi-libs-0.7-27.el8_10.1.aarch64 7/9

Installing : cups-libs-1:2.2.6-66.el8_10.aarch64 8/9

Installing : java-21-openjdk-headless-1:21.0.10.0.7-1.0.1.el8.aar 9/9

Running scriptlet: java-21-openjdk-headless-1:21.0.10.0.7-1.0.1.el8.aar 9/9

Running scriptlet: copy-jdk-configs-4.0-2.el8.noarch 9/9

Running scriptlet: java-21-openjdk-headless-1:21.0.10.0.7-1.0.1.el8.aar 9/9

Verifying : avahi-libs-0.7-27.el8_10.1.aarch64 1/9

Verifying : cups-libs-1:2.2.6-66.el8_10.aarch64 2/9

Verifying : lksctp-tools-1.0.18-3.el8.aarch64 3/9

Verifying : alsa-lib-1.2.10-2.el8.aarch64 4/9

Verifying : copy-jdk-configs-4.0-2.el8.noarch 5/9

Verifying : java-21-openjdk-headless-1:21.0.10.0.7-1.0.1.el8.aar 6/9

Verifying : javapackages-filesystem-5.3.0-1.module+el8+5136+7ff7 7/9

Verifying : lua-5.3.4-12.el8.aarch64 8/9

Verifying : tzdata-java-2025c-1.0.1.el8.noarch 9/9

Installed:

alsa-lib-1.2.10-2.el8.aarch64

avahi-libs-0.7-27.el8_10.1.aarch64

copy-jdk-configs-4.0-2.el8.noarch

cups-libs-1:2.2.6-66.el8_10.aarch64

java-21-openjdk-headless-1:21.0.10.0.7-1.0.1.el8.aarch64

javapackages-filesystem-5.3.0-1.module+el8+5136+7ff78f74.noarch

lksctp-tools-1.0.18-3.el8.aarch64

lua-5.3.4-12.el8.aarch64

tzdata-java-2025c-1.0.1.el8.noarch

Complete!

[root@localhost ~]#

JDKのインストールが完了したら、Javaのバージョンを確認します。

java -version

[root@localhost ~]# java -version

OpenJDK 64-Bit Server VM warning: Unable to get SVE vector length on this system. Disabling SVE. Specify -XX:UseSVE=0 to shun this warning.

openjdk version "21.0.10" 2026-01-20 LTS

OpenJDK Runtime Environment (Red_Hat-21.0.10.0.7-1.0.1) (build 21.0.10+7-LTS)

OpenJDK 64-Bit Server VM (Red_Hat-21.0.10.0.7-1.0.1) (build 21.0.10+7-LTS, mixed mode, sharing)

[root@localhost ~]#

Oracle REST Data Servicesのインストール

ORDSのインストールに使用するメディアは、RPMとZIPの２種類から選ぶことができます。RedHat Enterprise Linuxの系列であれば、RPMを選択するのが良いでしょう。

RPMは以下のYumリポジトリからインストールします。ORDSとSQLclのPRMパッケージが含まれています。

ARM 64-bit: https://yum.oracle.com/repo/OracleLinux/OL8/oracle/software/aarch64/

x86_64: https://yum.oracle.com/repo/OracleLinux/OL9/oracle/software/x86_64/

ZIPファイルは、Oracle REST Data Servicesのダウンロード・ページよりダウンロードできます。

https://www.oracle.com/database/sqldeveloper/technologies/db-actions/download/

最新のORDSのZIPファイルは、Use this link for the latest version updateよりダウンロードできます。このリンクはバージョンによらず、以下になります。

https://download.oracle.com/otn_software/java/ords/ords-latest.zip

今回はRPMをインストールします。以下のコマンドを実行します。

ARM 64-bit: dnf -y --repofrompath ol8_oracle_software,http://yum.oracle.com/repo/OracleLinux/OL8/oracle/software/aarch64 install ords

x86_64: dnf -y --repofrompath ol9_oracle_software,http://yum.oracle.com/repo/OracleLinux/OL9/oracle/software/x86_64 install ords

以下はARM 64-bitでの実行例です。

[root@localhost ~]# dnf -y --repofrompath ol8_oracle_software,http://yum.oracle.com/repo/OracleLinux/OL8/oracle/software/aarch64 install ords

Failed to set locale, defaulting to C.UTF-8

Added ol8_oracle_software repo from http://yum.oracle.com/repo/OracleLinux/OL8/oracle/software/aarch64

ol8_oracle_software 5.1 kB/s | 108 kB 00:21

Dependencies resolved.

================================================================================

Package Architecture Version Repository Size

================================================================================

Installing:

ords noarch 25.4.0-7.el8 ol8_oracle_software 179 M

Installing dependencies:

lsof aarch64 4.93.2-1.el8 ol8_baseos_latest 249 k

Transaction Summary

================================================================================

Install 2 Packages

Total download size: 179 M

Installed size: 184 M

Downloading Packages:

(1/2): lsof-4.93.2-1.el8.aarch64.rpm 46 kB/s | 249 kB 00:05

(2/2): ords-25.4.0-7.el8.noarch.rpm 2.8 MB/s | 179 MB 01:03

--------------------------------------------------------------------------------

Total 2.8 MB/s | 179 MB 01:03

Running transaction check

Transaction check succeeded.

Running transaction test

Transaction test succeeded.

Running transaction

Preparing : 1/1

Installing : lsof-4.93.2-1.el8.aarch64 1/2

Running scriptlet: ords-25.4.0-7.el8.noarch 2/2

Installing : ords-25.4.0-7.el8.noarch 2/2

Running scriptlet: ords-25.4.0-7.el8.noarch 2/2

WARN: ORDS requires Java 17.

You can install Oracle Java at https://www.oracle.com/java/technologies/downloads/#java17.

INFO: Before starting ORDS service, run the below command as user oracle:

ords --config /etc/ords/config install

INFO: To enable the ORDS service during startup, run the below command:

sudo systemctl enable ords

Verifying : lsof-4.93.2-1.el8.aarch64 1/2

Verifying : ords-25.4.0-7.el8.noarch 2/2

Installed:

lsof-4.93.2-1.el8.aarch64 ords-25.4.0-7.el8.noarch

Complete!

[root@localhost ~]#

--repofrompathオプションでYumリポジトリの位置を指定する代わりに、/etc/yum.repos.d/以下にYumリポジトリを定義するファイルを作成しても良いでしょう。

ORDSのインストールは以上で完了です。

Oracle REST Data Servicesの構成

ORDSの構成ファイルのデフォルトの位置は/etc/ords/configです。dnfコマンドでORDSをRPMファイルからインストールしている場合は、この構成ディレクトリも作成されます。

ORDSの構成はユーザーoracleで行います。ORDSを操作するコマンドは、/usr/local/bin/ordsとしてスクリプトがインストールされているので、/usr/local/binを環境変数PATHに追加します。

ORDSコマンドを実行するときに構成ディレクトリが未指定だとカレント・ディレクトリを構成ディレクトリと見做します。作業は/etc/ords/config上で実施します。

su - oracle

export PATH=/usr/local/bin:$PATH

cd /etc/ords/config

[root@localhost ~]# su - oracle

Last login: Tue Jan 27 14:08:55 JST 2026 on pts/0

[oracle@localhost ~]$ export PATH=/usr/local/bin:$PATH

[oracle@localhost ~]$ cd /etc/ords/config

[oracle@localhost config]$

構成を開始します。データベースへのオブジェクトのインストールと、Webサーバーの構成を行います。

ほとんどの指定はデフォルトを選択します。デフォルトと異なる指定は、以下です。

database service name として freepdb1 を指定します。

administrator username として sys を指定します。

database password for SYS AS SYSDBA にSYSのパスワードを指定します。

インストールの準備が完了した時点でAではなく9を入力して、APEX static resource location として /home/oracle/i を指定します。

ords --config /etc/ords/config install

[oracle@localhost config]$ ords --config /etc/ords/config install

OpenJDK 64-Bit Server VM warning: Unable to get SVE vector length on this system. Disabling SVE. Specify -XX:UseSVE=0 to shun this warning.

ORDS: Release 25.4 Production on Tue Jan 27 06:17:57 2026

Configuration:

/etc/ords/config

The configuration folder /etc/ords/config does not contain any configuration files.

Oracle REST Data Services - Interactive Install

Enter a number to select the database connection type to use

[1] Basic (host name, port, service name)

[2] TNS (TNS alias, TNS directory)

[3] Custom database URL

Choose [1]:

Enter the database host name [localhost]:

Enter the database listen port [1521]:

Enter the database service name [orcl]: freepdb1

Provide database user name with administrator privileges.

Enter the administrator username: sys

Enter the database password for SYS AS SYSDBA: ********

Retrieving information.

ORDS is not installed in the database. ORDS installation is required.

Enter a number to update the value or select option A to Accept and Continue

[1] Connection Type: Basic

[2] Basic Connection: HOST=localhost PORT=1521 SERVICE_NAME=freepdb1

Administrator User: SYS AS SYSDBA

[3] Database password for ORDS runtime user (ORDS_PUBLIC_USER): <generate>

[4] ORDS runtime user and schema tablespaces: Default: SYSAUX Temporary TEMP

[5] Additional Feature: Database Actions

[6] Configure and start ORDS in Standalone Mode: Yes

[7] Protocol: HTTP

[8] HTTP Port: 8080

[9] APEX static resources location: null

[A] Accept and Continue - Create configuration and Install ORDS in the database

[Q] Quit - Do not proceed. No changes

Choose [A]: 9

Enter the APEX static resources location: /home/oracle/i

Enter a number to update the value or select option A to Accept and Continue

[1] Connection Type: Basic

[2] Basic Connection: HOST=localhost PORT=1521 SERVICE_NAME=freepdb1

Administrator User: SYS AS SYSDBA

[3] Database password for ORDS runtime user (ORDS_PUBLIC_USER): <generate>

[4] ORDS runtime user and schema tablespaces: Default: SYSAUX Temporary TEMP

[5] Additional Feature: Database Actions

[6] Configure and start ORDS in Standalone Mode: Yes

[7] Protocol: HTTP

[8] HTTP Port: 8080

[9] APEX static resources location: /home/oracle/i

[A] Accept and Continue - Create configuration and Install ORDS in the database

[Q] Quit - Do not proceed. No changes

Choose [A]:

The setting named: db.connectionType was set to: basic in configuration: default

The setting named: db.hostname was set to: localhost in configuration: default

The setting named: db.port was set to: 1521 in configuration: default

The setting named: db.servicename was set to: freepdb1 in configuration: default

The setting named: plsql.gateway.mode was set to: proxied in configuration: default

The setting named: db.username was set to: ORDS_PUBLIC_USER in configuration: default

The setting named: db.password was set to: ****** in configuration: default

The setting named: feature.sdw was set to: true in configuration: default

The global setting named: database.api.enabled was set to: true

The setting named: restEnabledSql.active was set to: true in configuration: default

The global setting named: standalone.http.port was set to: 8080

The global setting named: standalone.static.path was set to: /home/oracle/i

The global setting named: standalone.doc.root was set to: /etc/ords/config/global/doc_root

The setting named: security.requestValidationFunction was set to: ords_util.authorize_plsql_gateway in configuration: default

2026-01-27T06:18:39.870Z INFO Created folder /etc/ords/config/logs

2026-01-27T06:18:39.871Z INFO The log file is defaulted to the current working directory located at /etc/ords/config/logs

2026-01-27T06:18:39.911Z INFO Installing Oracle REST Data Services version 25.4.0.r3641739 in FREEPDB1

2026-01-27T06:18:40.556Z INFO ... Verified database prerequisites

2026-01-27T06:18:40.742Z INFO ... Created Oracle REST Data Services proxy user

2026-01-27T06:18:40.918Z INFO ... Created Oracle REST Data Services schema

2026-01-27T06:18:41.112Z INFO ... Granted privileges to Oracle REST Data Services

2026-01-27T06:18:42.132Z INFO ... Created Oracle REST Data Services database objects

2026-01-27T06:18:46.818Z INFO Completed installation for Oracle REST Data Services version 25.4.0.r3641739. Elapsed time: 00:00:06.886

2026-01-27T06:18:46.848Z INFO Completed configuring PL/SQL gateway user for Oracle REST Data Services version 25.4.0.r3641739. Elapsed time: 00:00:00.30

2026-01-27T06:18:46.849Z INFO Log file written to /etc/ords/config/logs/ords_install_2026-01-27_061839_87152.log

2026-01-27T06:18:46.989Z INFO HTTP and HTTP/2 cleartext listening on host: 0.0.0.0 port: 8080

2026-01-27T06:18:47.007Z INFO Disabling document root because the specified folder does not exist: /etc/ords/config/global/doc_root

2026-01-27T06:18:47.008Z INFO Default forwarding from / to contextRoot configured.

2026-01-27T06:18:48.412Z INFO Configuration properties for: |default|lo|

db.connectionType=basic

db.hostname=localhost

db.port=1521

db.servicename=freepdb1

db.username=ORDS_PUBLIC_USER

feature.sdw=true

plsql.gateway.mode=proxied

restEnabledSql.active=true

security.requestValidationFunction=ords_util.authorize_plsql_gateway

database.api.enabled=true

standalone.doc.root=/etc/ords/config/global/doc_root

standalone.http.port=8080

standalone.static.path=/home/oracle/i

config.required=true

db.password=******

conf.use.wallet=true

2026-01-27T06:18:48.413Z WARNING *** jdbc.MaxLimit in configuration |default|lo| is using a value of 10, this setting may not be sized adequately for a production environment ***

2026-01-27T06:18:48.528Z INFO Created Pool: |default|lo|-2026-01-27T06-18-48.350569032Z at: 2026-01-27T06:18:48.350569032Z

2026-01-27T06:18:48.574Z INFO

Mapped local pools from /etc/ords/config/databases:

/ords/ => default => VALID

2026-01-27T06:18:48.579Z INFO Oracle REST Data Services initialized

Oracle REST Data Services version : 25.4.0.r3641739

Oracle REST Data Services server info: jetty/12.0.25

Oracle REST Data Services java info: OpenJDK 64-Bit Server VM (Red_Hat-21.0.10.0.7-1.0.1) (build 21.0.10+7-LTS mixed mode, sharing)

ORDSが正しく構成されていると、ORDSは起動したままでコマンド・プロンプトに戻りません。

Oracle APEXの接続確認

仮想マシンではORDSが起動し、HTTPによる接続を待っている状態です。VirtualBoxマネージャーより、仮想マシンのネットワークのポート・フォワーディングのルールを追加します。

localhostのポート8080への接続要求が仮想マシンのポート80へ転送されます。仮想マシンではfirewalldがポート80への接続要求を、ORDSが接続を待ち受けしているポート8080へ転送します。

ブラウザを立ち上げ、以下のURLに接続します。

http://localhost:8080/ords/apex_admin

管理サービスの接続画面が開いたら、ユーザー名にadmin、パスワードとしてAPEXのインストール時にapxchpwd.sqlを実行して設定したパスワードを指定します。

管理にサインインをクリックします。

サインインに成功することを確認します。

ワークスペースの作成を求められます。上部のナビゲーション・メニューを選択すると、ワークスペースの作成をスキップできます。

これ以降はOracle APEXの使い方になります。APEXが動作する環境は出来ました。

ORDSの自動起動の設定

仮想マシンが起動したときにORDSも起動するように設定します。

実行中のORDSをCTRL+Cを入力して終了します。

2026-01-27T06:18:48.579Z INFO Oracle REST Data Services initialized

Oracle REST Data Services version : 25.4.0.r3641739

Oracle REST Data Services server info: jetty/12.0.25

Oracle REST Data Services java info: OpenJDK 64-Bit Server VM (Red_Hat-21.0.10.0.7-1.0.1) (build 21.0.10+7-LTS mixed mode, sharing)

^C[oracle@localhost config]$

データベースより先にORDSが起動していると、HTTP 503 - ORA-12514のエラーが発生することがあります。

接続上の問題が発生したときに、コネクション・プールをリセットする時間を設定します。今回は30sとします。

ords --config /etc/ords/config config set --global db.invalidPoolTimeout 30s

[oracle@localhost config]$ ords --config /etc/ords/config config set --global db.invalidPoolTimeout 30s

OpenJDK 64-Bit Server VM warning: Unable to get SVE vector length on this system. Disabling SVE. Specify -XX:UseSVE=0 to shun this warning.

ORDS: Release 25.4 Production on Tue Jan 27 06:28:04 2026

Configuration:

/etc/ords/config

The global setting named: db.invalidPoolTimeout was set to: 30s

[oracle@localhost config]$

ユーザーoracleから抜けます。

exit

[oracle@localhost config]$ exit

logout

[root@localhost ~]#

ORDSの自動起動を設定します。

systemctl enable ords

[root@localhost ~]# systemctl enable ords

Synchronizing state of ords.service with SysV service script with /usr/lib/systemd/systemd-sysv-install.

Executing: /usr/lib/systemd/systemd-sysv-install enable ords

Created symlink /etc/systemd/system/multi-user.target.wants/ords.service → /etc/systemd/system/ords.service.

Created symlink /etc/systemd/system/graphical.target.wants/ords.service → /etc/systemd/system/ords.service.

[root@localhost ~]#

systemctlコマンドによってORDSが起動できることを確認します。

systemctl stop ords
systemctl start ords

[root@localhost ~]# systemctl stop ords

[root@localhost ~]# systemctl start ords

[root@localhost ~]#

先ほどと同様にOracle APEXの管理サービスに接続できることを確認します。

http://localhost:8080/ords/apex_admin

接続の確認ができれば、ORDSのインストールと構成は完了です。

また、これよりOracle APEXを使用することができます。

続く