本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定 Oracle APEX 和 Oracle Rest Data Services (ORDS)
<a name="Appendix.Oracle.Options.APEX.settingUp"></a>

下列主題列出設定 Oracle APEX 和 ORDS 所需的步驟

**Topics**
+ [將 APEX 和 APEX-DEV 選項新增至您的資料庫執行個體](#Appendix.Oracle.Options.APEX.Add)
+ [解除鎖定資料庫執行個體上的公有使用者帳戶](#Appendix.Oracle.Options.APEX.PublicUser)
+ [設定適用於 Oracle APEX 的 RESTful 服務](#Appendix.Oracle.Options.APEX.ConfigureRESTful)
+ [準備在個別主機上安裝 ORDS](#Appendix.Oracle.Options.APEX.ORDS.ords-setup)
+ [設定 Oracle APEX Listener](#Appendix.Oracle.Options.APEX.Listener)

## 將 APEX 和 APEX-DEV 選項新增至您的資料庫執行個體
<a name="Appendix.Oracle.Options.APEX.Add"></a>

若要將 `APEX` 和 `APEX-DEV` 選項新增至 RDS for Oracle 資料庫執行個體，請執行下列操作：

1. 建立新的選項群組，或是複製或修改現有選項群組。

1. 將 `APEX` 和 `APEX-DEV` 選項新增至選項群組。

1. 將選項群組與您的資料庫執行個體建立關聯。

當您新增 `APEX` 和 `APEX-DEV` 選項時，當資料庫執行個體自動重新啟動時會發生短暫的中斷。

**注意**  
`APEX_MAIL` 在已安裝 `APEX` 選項時可用。`APEX_MAIL` 套件的執行權限會授予 `PUBLIC`，因此您不需要有 APEX 管理帳戶就能使用它。

**將 APEX 和 APEX-DEV 選項新增至資料庫執行個體**

1. 判斷要使用的選項群組。您可以建立新的選項群組或使用現有的選項群組。如果您要使用現有的選項群組，請跳到下一個步驟。否則請使用下列設定來建立自訂資料庫選項群組：

   1. 針對 **Engine (引擎)**，選擇您想要使用的 Oracle 版本。所有版本都支援 `APEX` 和 `APEX-DEV` 選項。

   1. 針對 **Major engine version (主要引擎版本)**，請選擇您資料庫執行個體的版本。

   如需更多詳細資訊，請參閱 [建立選項群組](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create)。

1. 將選項新增至選項群組。如果您只想部署 Oracle APEX 執行階段環境，則只需要新增 `APEX` 選項。若要部署完整開發環境，請同時新增 `APEX` 和 `APEX-DEV` 選項。

   對於**版本**，選擇您想要使用的 Oracle APEX 版本。
**重要**  
如果您將 `APEX` 或 `APEX-DEV` 選項新增至已連接到一個或多個資料庫執行個體的現有選項群組，則會發生短暫的停機。在此停機期間，所有資料庫執行個體都會重新啟動。

   如需新增選項的詳細資訊，請參閱[將選項新增至選項群組](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption)。

1. 將選項群組套用至新的或現有的資料庫執行個體：
   + 針對新的資料庫執行個體，您會在啟動執行個體時套用選項群組。如需更多詳細資訊，請參閱 [建立 Amazon RDS 資料庫執行個體](USER_CreateDBInstance.md)。
   + 針對現有的資料庫執行個體，您可以透過修改執行個體並附加新的選項群組來套用選項群組。當您將 `APEX` 或 `APEX-DEV` 選項新增至現有的資料庫執行個體時，在資料庫執行個體自動重新啟動時會發生短暫的中斷。如需詳細資訊，請參閱[修改 Amazon RDS 資料庫執行個體](Overview.DBInstance.Modifying.md)。

## 解除鎖定資料庫執行個體上的公有使用者帳戶
<a name="Appendix.Oracle.Options.APEX.PublicUser"></a>

在您的資料庫執行個體上安裝 `APEX` 或 `APEX-DEV` 選項之後，請務必執行下列操作：

1. 變更 `APEX_PUBLIC_USER` 帳戶的密碼。

1. 解除鎖定帳戶。

您可以使用 Oracle SQL\$1Plus 命令列公用程式來這麼做。以主要使用者身分連線至資料庫執行個體，然後發出以下命令。將 `new_password` 改為您選擇的密碼。

```
1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
```

## 設定適用於 Oracle APEX 的 RESTful 服務
<a name="Appendix.Oracle.Options.APEX.ConfigureRESTful"></a>

若要在 Oracle APEX 中設定 RESTful 服務 (Oracle APEX 4.1.1.V1 不需要)，請使用 SQL\$1Plus 以主要使用者身分連線至資料庫執行個體。完成此作業後，請執行 `rdsadmin.rdsadmin_run_apex_rest_config` 預存程序。執行預存程序時，您需要提供下列使用者的密碼：
+ `APEX_LISTENER`
+ `APEX_REST_PUBLIC_USER`

此預存程序會執行 `apex_rest_config.sql` 指令碼，而為這些使用者建立新的資料庫帳戶。

**注意**  
若為 Oracle APEX 版本 4.1.1.v1，則不需要設定。僅針對此 Oracle APEX 版本，您不需要執行此預存程序。

下列命令會執行此預存程序。

```
1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');
```

## 準備在個別主機上安裝 ORDS
<a name="Appendix.Oracle.Options.APEX.ORDS.ords-setup"></a>

將 ORDS 安裝在另一部主機上，例如 Amazon EC2 執行個體、公司的內部部署伺服器或您的桌上型電腦。本節中的範例假設您的主機執行 Linux 且名為 `myapexhost.example.com`。

在安裝 ORDS 之前，您必須先建立無特殊權限的作業系統使用者，然後下載並解壓縮 Oracle APEX 安裝檔案。

**準備進行 ORDS 安裝**

1. 以 `myapexhost.example.com` 身分登入 `root`。

1. 建立無特殊權限的作業系統使用者來負責接聽程式安裝。以下命令建立一個名為 *apexuser* 的新使用者。

   ```
   useradd -d /home/apexuser apexuser
   ```

   以下命令指派密碼給新使用者。

   ```
   passwd apexuser;
   ```

1. 以 `myapexhost.example.com` 身分登入 `apexuser`，然後從 Oracle 下載 Oracle APEX 安裝檔案至您的 `/home/apexuser` 目錄：
   + [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html) 
   + [Oracle Application Express 發行前封存](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html) 

1. 將檔案解壓縮在 `/home/apexuser` 目錄中。

   ```
   unzip apex_version.zip
   ```

   解壓縮檔案之後，`apex` 目錄中會有一個 `/home/apexuser` 目錄。

1. 在您仍以 `myapexhost.example.com` 身分登入 `apexuser` 時，從 Oracle 下載 Oracle REST Data Services 檔案至您的 `/home/apexuser` 目錄：[http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html)。

## 設定 Oracle APEX Listener
<a name="Appendix.Oracle.Options.APEX.Listener"></a>

**注意**  
Oracle APEX Listener 已淘汰。

Amazon RDS for Oracle 繼續支援 Oracle APEX 4.1.1 版和 Oracle APEX Listener 1.1.4 版。我們建議您使用最新支援的 Oracle APEX 和 ORDS 版本。

將 Oracle APEX Listener 安裝在另一部主機上，例如 Amazon EC2 執行個體、公司的現場部署伺服器或您的桌上型電腦。我們假設主機名稱為 `myapexhost.example.com`，且主機執行 Linux。

### 準備安裝 Oracle APEX Listener
<a name="Appendix.Oracle.Options.APEX.Listener.preparing"></a>

在安裝 Oracle APEX Listener 之前，您必須先建立無特殊權限的作業系統使用者，然後下載並解壓縮 Oracle APEX 安裝檔案。

**準備安裝 Oracle APEX Listener**

1. 以 `myapexhost.example.com` 身分登入 `root`。

1. 建立無特殊權限的作業系統使用者來負責接聽程式安裝。以下命令建立一個名為 *apexuser* 的新使用者。

   ```
   useradd -d /home/apexuser apexuser
   ```

   以下命令指派密碼給新使用者。

   ```
   passwd apexuser;
   ```

1. 以 `myapexhost.example.com` 身分登入 `apexuser`，然後從 Oracle 下載 Oracle APEX 安裝檔案至您的 `/home/apexuser` 目錄：
   + [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html) 
   + [Oracle Application Express 發行前封存](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html) 

1. 將檔案解壓縮在 `/home/apexuser` 目錄中。

   ```
   unzip apex_<version>.zip                
   ```

   解壓縮檔案之後，`apex` 目錄中會有一個 `/home/apexuser` 目錄。

1. 在您仍以 `myapexhost.example.com` 身分登入 `apexuser` 時，從 Oracle 下載 Oracle APEX Listener 檔案至您的 `/home/apexuser` 目錄。

#### 安裝與設定 Oracle APEX Listener
<a name="Appendix.Oracle.Options.APEX.Listener.installing"></a>

在可以使用 Oracle APEX 之前，您需先下載 `apex.war` 檔案、使用 Java 安裝 Oracle APEX Listener，然後啟動接聽程式。

**安裝與設定 Oracle APEX Listener**

1. 根據 Oracle APEX Listener 建立新目錄，並開啟接聽程式檔案。

   執行下列程式碼：

   ```
   mkdir /home/apexuser/apexlistener
   cd /home/apexuser/apexlistener 
   unzip ../apex_listener.version.zip
   ```

1. 執行下列程式碼。

   ```
   java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
   ```

1. 輸入資訊讓程式提示下列：
   + APEX Listener Administrator 使用者名稱。預設值為 *adminlistener*。
   + APEX Listener Administrator 的密碼。
   + APEX Listener Manager 使用者名稱。預設值為 *managerlistener*。
   + APEX Listener Administrator 的密碼。

   程式會印出您完成組態所需的 URL，如下所示。

   ```
   INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
   Database is not yet configured
   ```

1. 讓 Oracle APEX Listener 保持執行，使得您可以使用 Oracle Application Express。當您完成此設定程序時，就可以換成在背景中執行接聽程式。

1. 在 web 瀏覽器中，移至 Oracle APEX Listener 程式所提供的 URL。Oracle Application Express Listener 管理視窗隨即出現。輸入下列資訊：
   + **使用者名稱** – `APEX_PUBLIC_USER`
   + **密碼** – *APEX\$1PUBLIC\$1USER* 的密碼。這是您稍早設定 Oracle APEX 儲存庫時所指定的密碼。如需詳細資訊，請參閱[解除鎖定資料庫執行個體上的公有使用者帳戶](#Appendix.Oracle.Options.APEX.PublicUser)。
   + **連線類型** – 基本 
   + **主機名稱** – Amazon RDS 資料庫執行個體的端點，例如 `mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com`。
   + **連接埠** – 1521
   + **SID** – Amazon RDS 資料庫執行個體上的資料庫名稱，例如 `mydb`。

1. 選擇 **Apply** (套用)。Oracle APEX 管理視窗隨即出現。

1. 設定 Oracle APEX `admin` 使用者的密碼。若要這麼做，請使用 SQL\$1Plus 以主要使用者身分連線至資料庫執行個體，然後執行以下命令。

   ```
   1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
   2. grant APEX_ADMINISTRATOR_ROLE to master;
   3. @/home/apexuser/apex/apxchpwd.sql
   ```

   將 `master` 改為您的主要使用者名稱。當 `apxchpwd.sql` 指令碼提示您時，請輸入新的 `admin` 密碼。

1. 在瀏覽器中返回 Oracle APEX 管理視窗，然後選擇**管理**。接著選擇 **Application Express Internal Administration (Application Express 內部管理)**。當提示您提供登入資料時，請輸入下列資訊：
   + **使用者名稱** – `admin` 
   + **密碼** – 使用 `apxchpwd.sql` 指令碼所設定的密碼 

   選擇 **Login (登入)**，然後設定 `admin` 使用者的新密碼。

您的接聽程式現在可供使用。