APEX と Oracle Rest Data Services (ORDS) のセットアップ
次のトピックでは、APEX と ORDS のセットアップに必要な手順を一覧表示します。
トピック
APEX および APEX-DEV オプションの DB インスタンスへの追加
RDS for Oracle DB インスタンスに APEX
および APEX-DEV
オプションを追加するには、次の手順を実行します。
-
新しいオプショングループを作成するか、既存のオプショングループをコピーまたは変更します。
-
オプショングループに
APEX
とAPEX-DEV
オプションを追加します。 -
オプショングループを DB インスタンスに関連付けます。
Amazon RDS APEX オプションを追加する場合、DB インスタンスを自動的に再起動している間に短い停止が発生します。
注記
APEX_MAIL
は、APEX
オプションがインストールされている場合に使用できます。APEX_MAIL
パッケージの実行権限が PUBLIC
に付与されるため、APEX 管理者アカウントを使用する必要はありません。
APEX オプションを DB インスタンスに追加するには
-
使用するオプショングループを決定します。新しいオプショングループを作成することも、既存のオプショングループを使用することもできます。既存のオプショングループを使用する場合は、次のステップは飛ばしてください。または、次の設定でカスタム DB オプショングループを作成します。
-
[Engine] で、使用する Oracle のエディションを選択します。APEX オプションは、すべてのエディションでサポートされます。
-
[メジャーエンジンのバージョン] で、DB インスタンスのバージョンを選択します。
詳細については、「オプショングループを作成する」を参照してください。
-
-
オプショングループにオプションを追加します。Oracle APEX ランタイム環境のみをデプロイする場合には、
APEX
オプションのみを追加します。完全なデプロイ環境をデプロイするには、APEX
とAPEX-DEV
の両方のオプションを追加します。[ Version] で使用する
APEX
のバージョンを選択します。重要
既に 1 つ以上の DB インスタンスにアタッチされている既存のオプショングループに APEX オプションを追加すると、短い停止が発生します。この停止の間、DB インスタンスはすべて、自動的に再起動されます。
オプションの追加方法の詳細については、「オプショングループにオプションを追加する」を参照してください。
-
新規または既存の DB インスタンスに、DB オプショングループを適用します。
-
新規 DB インスタンスの場合は、インスタンスを起動するときにオプショングループを適用します。詳細については、「Amazon RDS DB インスタンスの作成」を参照してください。
-
既存の DB インスタンスの場合は、インスタンスを修正し、新しいオプショングループを添付することで、オプショングループを適用します。既存の DB インスタンスに APEX オプションを追加すると、DB インスタンスを自動的に再起動している間に短い停止が発生します。詳細については、「Amazon RDS DB インスタンスを変更する」を参照してください。
-
DB インスタンスのパブリックユーザーアカウントのロック解除
Amazon RDS APEX オプションを DB インスタンスにインストールした後に、必ず次の手順を実行してください。
-
APEX パブリックユーザーアカウントのパスワードを変更します。
-
アカウントのロックを解除します。
Oracle SQL*Plus コマンドラインユーティリティを使用してこれを行うことができます。DB インスタンスにマスターユーザーとして接続し、次のコマンドを発行します。new_password
を任意のパスワードに置き換えます。
ALTER USER APEX_PUBLIC_USER IDENTIFIED BY
new_password
; ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
Oracle APEX の RESTful サービスの設定
APEX で RESTful サービスを設定するには (APEX 4.1.1.V1 では必要ありません)、SQL*Plus を使用して、マスターユーザーとして DB インスタンスに接続します。接続したら、rdsadmin.rdsadmin_run_apex_rest_config
ストアドプロシージャを実行します。ストアドプロシージャを実行するときは、次のユーザーにパスワードを提供します。
-
APEX_LISTENER
-
APEX_REST_PUBLIC_USER
ストアドプロシージャは apex_rest_config.sql
スクリプトを実行し、そのスクリプトによりそれらのユーザーの新しいデータベースアカウントが作成されます。
注記
Oracle APEX バージョン 4.1.1.v1 に対する設定は不要です。この Oracle APEX バージョンに限り、ストアドプロシージャの実行は不要です。
次のコマンドはストアドプロシージャを実行します。
EXEC rdsadmin.rdsadmin_run_apex_rest_config('
apex_listener_password
', 'apex_rest_public_user_password
');
ORDS を別のホストにインストールする準備
別個のホスト (Amazon EC2 インスタンス、社内のオンプレミスサーバー、またはデスクトップコンピュータなど) にインストールします。このセクションの例では、ホストが Linux を実行し、myapexhost.example.com
という名前が付けられていることを前提としています。
ORDS をインストールする前に、権限を持っていない OS ユーザーを作成し、APEX インストールファイルをダウンロードして解凍する必要があります。
ORDS のインストールを準備するには
-
myapexhost.example.com
としてroot
にログインします。 -
リスナーのインストールを所有する権限を持っていない OS ユーザーを作成します。以下のコマンドでは、apexuser という名前の新規ユーザーを作成します。
useradd -d /home/apexuser
apexuser
以下のコマンドは、新規ユーザーにパスワードを割り当てます。
passwd apexuser;
-
myapexhost.example.com
にapexuser
としてログインし、APEX のインストールファイルを Oracle から/home/apexuser
ディレクトリにダウンロードします。 -
ファイルを
/home/apexuser
ディレクトリに解凍します。unzip apex_
version
.zipファイルは、
apex
ディレクトリ内に/home/apexuser
ディレクトリとして解凍されます。 -
myapexhost.example.com
にapexuser
としてログインしている間に Oracle から Oracle REST Data Services ファイルを/home/apexuser
ディレクトリにダウンロードします。http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html
Oracle APEX リスナーの設定
注記
Oracle APEX リスナーは非推奨です。
Amazon RDS for Oracle は、引き続き APEX バージョン 4.1.1 および Oracle APEX リスナーバージョン 1.1.4 をサポートしています。サポートされている最新バージョンの Oracle APEX および ORDS を使用することをお勧めします。
Oracle APEX Listener は別個のホストにインストールします (Amazon EC2 インスタンス、社内のオンプレミスサーバー、またはデスクトップコンピュータ)。ここでは、ホスト名が myapexhost.example.com
であり、ホストで Linux が実行されていることが前提です。
Oracle APEX リスナーのインストールの準備
Oracle APEX リスナーをインストールする前に、権限のない OS ユーザーを作成し、APEX インストールファイルをダウンロードして解凍する必要があります。
Oracle APEX リスナーのインストールを準備するには
-
myapexhost.example.com
としてroot
にログインします。 -
リスナーのインストールを所有する権限を持っていない OS ユーザーを作成します。以下のコマンドでは、apexuser という名前の新規ユーザーを作成します。
useradd -d /home/apexuser
apexuser
以下のコマンドは、新規ユーザーにパスワードを割り当てます。
passwd apexuser;
-
myapexhost.example.com
にapexuser
としてログインし、APEX のインストールファイルを Oracle から/home/apexuser
ディレクトリにダウンロードします。 -
ファイルを
/home/apexuser
ディレクトリに解凍します。unzip apex_
<version>
.zipファイルは、
apex
ディレクトリ内に/home/apexuser
ディレクトリとして解凍されます。 -
myapexhost.example.com
にapexuser
としてログインしている間に、Oracle APEX Listener ファイルを Oracle から/home/apexuser
ディレクトリにダウンロードします。
Oracle APEX リスナーのインストールと設定
APEX を使用する前に、apex.war ファイルをダウンロードし、Java を使用して Oracle APEX リスナーをインストールしてから、リスナーを起動する必要があります。
Oracle APEX リスナーをインストールして設定するには
-
Oracle APEX リスナーに基づいて新しいディレクトリを作成し、リスナーファイルを開きます。
以下のコードを実行します。
mkdir /home/apexuser/apexlistener cd /home/apexuser/apexlistener unzip ../apex_listener.
version
.zip -
以下の コードを実行します。
java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
-
次のプログラムプロンプトの情報を入力します。
-
APEX Listener Administrator のユーザー名。デフォルト値は adminlistener です。
-
APEX Listener Administrator のパスワード。
-
APEX リスナーマネージャのユーザー名。デフォルトは managerlistener です。
-
APEX Listener Administrator のパスワード。
プログラムは、次のように設定を完了するために必要な URL を出力します。
INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure Database is not yet configured
-
-
Oracle Application Express を使用できるように、Oracle APEX リスナーを実行したままにします。この設定手順を完了したら、リスナーをバックグラウンドで実行できます。
-
ウェブブラウザから、APEX Listener プログラムにより提供される URL にアクセスします。Oracle Application Express Listener の管理ウィンドウが表示されます。次の情報を入力します。
-
Username -
APEX_PUBLIC_USER
-
[Password] - APEX_PUBLIC_USER のパスワード このパスワードは、APEX リポジトリの設定時に前の手順で指定したパスワードです。詳細については、「DB インスタンスのパブリックユーザーアカウントのロック解除」を参照してください。
-
Connection Type - Basic
-
Hostname - Amazon RDS DB インスタンスのエンドポイント。
mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com
など。 -
[Port] - 1521
-
SID - Amazon RDS DB インスタンスのデータベースの名前。
mydb
など。
-
-
[Apply] を選択します。APEX 管理ウィンドウが表示されます。
-
APEX
admin
ユーザーのパスワードを設定します。これを行うには、SQL*Plus を使用して DB インスタンスにマスターユーザーとして接続し、次のコマンドを実行します。EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; grant APEX_ADMINISTRATOR_ROLE to
master
; @/home/apexuser/apex/apxchpwd.sql
を自身のマスターユーザー名に置き換えます。master
apxchpwd.sql
スクリプトによってプロンプトが表示されたら、新しいadmin
パスワードを入力します。 -
ブラウザで APEX 管理ウィンドウに戻り、[Administration] を選択します。次に、[Application Express Internal Administration] を選択します。認証情報を求められたら、以下の情報を入力します。
-
User name -
admin
-
Password -
apxchpwd.sql
スクリプトを使用して設定したパスワード。
[Login] を選択し、その
admin
ユーザーの新しいパスワードを設定します。 -
これで、リスナーを使用する準備ができました。