5.5 埋込みPL/SQLゲートウェイの構成

埋込みPL/SQLゲートウェイを構成するには、構成スクリプトを実行して、ANONYMOUSアカウントのロックを解除します。

埋込みPL/SQLゲートウェイは、Oracle Database 11g以降とともにインストールされます。ただし、Oracle Application Expressで使用する前に構成する必要があります。埋込みPL/SQLゲートウェイを構成するには、構成スクリプトを実行して、ANONYMOUSアカウントのロックを解除します。

注意:

Oracle XML DBプロトコル・サーバーおよび埋込みPL/SQLゲートウェイは、Oracle Database 11gより前のデータベースではサポートされていません。

トピック:

• apex_epg_config.sql構成スクリプトの実行
  apex_epg_config.sqlスクリプトを実行します。次に、ANONYMOUSアカウントのロックを解除します。
• 以前のリリースからアップグレードする場合のイメージ・ディレクトリの更新
  apex_epg_config.sqlスクリプトを実行してimagesディレクトリを更新します。
• Oracle XML DB HTTPサーバーでHTTPに割り当てられたポートの確認
  SQL*Plusを起動してデータベースに接続し、Oracle XML DB HTTPサーバーのHTTPに割り当てられているポート番号を確認する文を入力します。
• Oracle XML DBプロトコル・サーバー・ポートの検証
  SQL*Plusを起動してデータベースに接続し、Oracle XML DBプロトコル・サーバーが実行されているポート番号を確認する文を入力します。
• Oracle XML DBプロトコル・サーバーの有効化
  SQL* Plusを起動してデータベースに接続し、Oracle XML DBプロトコル・サーバーを有効化するSQL文を実行します。
• 静的ファイル・サポートの構成
  静的ファイルを構成するために、Oracle Application Expressの新規インストールまたはアップグレード後にはapex_rest_config.sqlを実行する必要があります。
• リバース・プロキシやロード・バランサの内側にある埋込みPL/SQLゲートウェイの構成について
  SQL*Plusを起動して、SYSDBAロールが指定されているSYSとしてOracle Application Expressがインストールされているデータベースに接続します。PL/SQLブロックを実行します。

参照:

• Webリスナーの選択

• "埋込みPL/SQLゲートウェイについて"

5.5.1 apex_epg_config.sql構成スクリプトの実行

apex_epg_config.sqlスクリプトを実行します。次に、ANONYMOUSアカウントのロックを解除します。

構成スクリプトapex_epg_config.sqlを実行し、埋込みPL/SQLゲートウェイを構成します。次に、ANONYMOUSアカウントのロックを解除します。

apex_epg_config.sql構成スクリプトを実行するには、次のステップを実行します。

警告:

このスクリプトは、データベース・サーバー上でのみ実行する必要があります。データベース・サーバーへのリモート接続は実行できません。データベース・サーバーは、指定されたディレクトリへのアクセス権を持っている必要があります。ネットワーク・ディレクトリをマッピングすることもできません。

1. 作業ディレクトリを、Oracle Application Expressソフトウェアを解凍したapexディレクトリに変更します。
2. SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。次に例を示します。

   • Windowsの場合:

     SYSTEM_DRIVE:\ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

   • UNIXおよびLinuxの場合:

     $ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

3. PDBを構成する場合は、次の文を入力します。

   ALTER SESSION SET CONTAINER = <PDB_NAME>;
   

4. 次の例に示すとおり、Oracle Application Expressソフトウェアを解凍したベース・ディレクトリにファイル・システム・パスを渡すapex_epg_config.sqlを実行します。

   • Windowsの場合:

     @apex_epg_config.sql SYSTEM_DRIVE:\TEMP
     

   • UNIXおよびLinuxの場合:

     @apex_epg_config.sql /tmp

5. 次の文を入力し、ANONYMOUSアカウントのロックを解除します。

   ALTER USER ANONYMOUS ACCOUNT UNLOCK;
   

5.5.2 以前のリリースからアップグレードする場合のimagesディレクトリの更新

apex_epg_config.sqlスクリプトを実行してimagesディレクトリを更新します。

Oracle Application Expressを以前のリリースからアップグレードする場合は、apex_epg_config.sql スクリプトを実行してimagesディレクトリを更新する必要があります。

ヒント:

新規インストールの場合、この手順は不要です。前述のセクションで説明したように、apex_epg_config.sqlを実行すると、イメージがロードされます。

apex_epg_config.sqlスクリプトを実行するには、次のステップを実行します。

1. 作業ディレクトリを、Oracle Application Expressソフトウェアを解凍したapexディレクトリに変更します。
2. SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。

   • Windowsの場合:

     SYSTEM_DRIVE:\ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

   • UNIXおよびLinuxの場合:

     $ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

3. 次の例に示すとおり、Oracle Application Expressソフトウェアを解凍したベース・ディレクトリにファイル・システム・パスを渡すapex_epg_config.sqlを実行します。

   • Windowsの場合:

     @apex_epg_config.sql SYSTEM_DRIVE:\TEMP
     

   • UNIXおよびLinuxの場合:

     @apex_epg_config.sql /tmp
     

   ヒント:

   前述の例では、Windowsの場合はTEMP、UNIXまたはLinuxの場合はtmpというディレクトリにOracle Application Expressを解凍したことを前提としています。

5.5.3 Oracle XML DB HTTPサーバーでHTTPに割り当てられたポートの確認

SQL*Plusを起動してデータベースに接続し、Oracle XML DB HTTPサーバーのHTTPに割り当てられているポート番号を確認する文を入力します。

埋込みPL/SQLゲートウェイは、Oracle DatabaseのOracle XML DBプロトコル・サーバーで実行されます。

Oracle XML DB HTTPサーバーでHTTPに割り当てられたポートを確認するには、次の手順を実行します。

1. SQL*Plusを起動し、Oracle Application Expressをインストールするデータベースに、SYSDBAロールが指定されているSYSとして接続します。次に例を示します。

   • Windowsの場合:

     SYSTEM_DRIVE:\ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

   • UNIXおよびLinuxの場合:

     $ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

2. 次の文を入力して、ポート番号を検証します。

   SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;
   

   ポート番号が0を返したら、Oracle XML DB HTTP Serverが無効になっています。

5.5.4 Oracle XML DBプロトコル・サーバー・ポートの検証

SQL*Plusを起動してデータベースに接続し、Oracle XML DBプロトコル・サーバーが実行されているポート番号を確認する文を入力します。

埋込みPL/SQLゲートウェイは、Oracle DatabaseのOracle XML DBプロトコル・サーバーで実行されます。対応するポート番号を確認すると、Oracle XML DB Protocol Serverが有効化されているかどうかを判断できます。

Oracle XML DBプロトコル・サーバーが実行されているポート番号を検証するには、次のステップを実行します。

1. SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。

   • Windowsの場合:

     SYSTEM_DRIVE:\ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

   • UNIXおよびLinuxの場合:

     $ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

2. 次の文を入力して、ポート番号を検証します。

   SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;
   

   ポート番号に0が戻された場合、Oracle XML DBプロトコル・サーバーは無効化されています。

3. Oracle XML DBプロトコル・サーバーを有効化します。

参照:

「Oracle XML DBプロトコル・サーバーの有効化」

5.5.5 Oracle XML DBプロトコル・サーバーの有効化

SQL* Plusを起動してデータベースに接続し、Oracle XML DBプロトコル・サーバーを有効化するSQL文を実行します。

埋込みPL/SQLゲートウェイは、Oracle DatabaseのOracle XML DBプロトコル・サーバーで実行されます。

Oracle XML DBプロトコル・サーバーを有効化するには、次のステップを実行します。

1. SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。次に例を示します。

   • Windowsの場合:

     SYSTEM_DRIVE:\ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

   • UNIXおよびLinuxの場合:

     $ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

2. 次のような文を入力します。

   EXEC DBMS_XDB.SETHTTPPORT(port);
   

   次に例を示します。

   EXEC DBMS_XDB.SETHTTPPORT(8080);
   

注意:

1024未満のポート番号は、多くのオペレーティング・システムで特権プロセス用に予約されています。1024未満のポート(80など)でXML DB HTTPリスナーを有効化するには、ドキュメントを参照してください。

参照:

• 『Oracle XML DB開発者ガイド』のプロトコルを使用したリポジトリへのアクセスに関する項

• 『Oracle Database Net Servicesリファレンス』 のプロトコル・アドレスの構成およびポート番号の制限に関する項

5.5.6 静的ファイル・サポートの構成

静的ファイルを構成するために、Oracle Application Expressの新規インストールまたはアップグレード後にはapex_rest_config.sqlを実行する必要があります。

Oracle Application Expressを使用すると、アプリケーション開発者はアプリケーションに静的ファイルを含めることができます。静的ファイルは、ワークスペース、アプリケーション、プラグインまたはアプリケーション・テーマに関連付けることができます。埋込みPL/SQLゲートウェイをWebリスナーとして使用する場合、静的ファイルをサポートするために必要な構成は、埋込みPL/SQLゲートウェイの構成の一環として実行されます。

参照:

• 新規インストールの場合は、「apex_epg_config.sql構成スクリプトの実行」を参照してください

• アップグレード・インストールの場合は、「以前のリリースからアップグレードする場合のイメージ・ディレクトリの更新」を参照してください

5.5.7 リバース・プロキシやロード・バランサの内側にある埋込みPL/SQLゲートウェイの構成について

SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。PL/SQLブロックを実行します。

Oracle Application Expressがリバース・プロキシやロード・バランサの内側で実行される場合は、CGI環境変数PROTOCOLおよびHTTP_HOSTを設定します。埋込みPL/SQLゲートウェイの場合、次のPL/SQLブロックをコールする必要があります。

1. 作業ディレクトリを、インストール・ソフトウェアを解凍したapexディレクトリに変更します。

2. SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。次に例を示します。

   • Windowsの場合:

     SYSTEM_DRIVE:\ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

   • UNIXおよびLinuxの場合:

     $ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

3. 次のPL/SQLブロックを実行します。

   BEGIN
    DBMS_EPG.set_dad_attribute (
    dad_name => 'APEX',
    attr_name => 'cgi-environment-list',
    attr_value => 'REQUEST_PROTOCOL=https');
    DBMS_EPG.set_dad_attribute (
    dad_name => 'APEX',
    attr_name => 'cgi-environment-list',
    attr_value => 'HTTP_HOST=external-name:external-port');
    commit;
   END;
   /
   

詳細は、Java EEアプリケーション・サーバーのドキュメントを参照してください。