# Configuración de Oracle APEX y Oracle Rest Data Services (ORDS)
En el siguiente tema se muestran los pasos necesarios para configurar Oracle APEX y ORDS
**Topics**
+ [
## Cómo añadir las opciones de APEX y APEX-DEV a una instancia de base de datos
](#Appendix.Oracle.Options.APEX.Add)
+ [
## Desbloqueo de la cuenta de usuario pública en una instancia de base de datos
](#Appendix.Oracle.Options.APEX.PublicUser)
+ [
## Configuración de los servicios RESTful para Oracle APEX
](#Appendix.Oracle.Options.APEX.ConfigureRESTful)
+ [
## Preparativos para la instalación de ORDS en un host independiente
](#Appendix.Oracle.Options.APEX.ORDS.ords-setup)
+ [
## Configuración del agente de escucha de Oracle APEX
](#Appendix.Oracle.Options.APEX.Listener)
## Cómo añadir las opciones de APEX y APEX-DEV a una instancia de base de datos
Para añadir las opciones `APEX` y `APEX-DEV` a la instancia de base de datos de RDS para Oracle, haga lo siguiente:
1. Cree un grupo de opciones nuevo o copie o modifique un grupo de opciones existente.
1. Agregue las opciones `APEX` y `APEX-DEV` al grupo de opciones.
1. Asocie el grupo de opciones con la instancia de base de datos.
Cuando se agregan las opciones `APEX` y `APEX-DEV`, se produce una breve interrupción mientras la instancia de base de datos se reinicia automáticamente.
**nota**
`APEX_MAIL` está disponible cuando la opción `APEX` está instalada. El privilegio de ejecución del paquete `APEX_MAIL` se concede a `PUBLIC`por lo que no necesita la cuenta administrativa de APEX para usarlo.
**Agregación de las opciones de APEX y APEX-DEV a una instancia de base de datos**
1. Determine el grupo de opciones que desea utilizar. Puede crear un grupo de opciones o utilizar uno existente. Si desea utilizar un grupo de opciones existente, vaya al siguiente paso. De lo contrario, cree un grupo de opciones de base de datos personalizado con las siguientes opciones:
1. En **Engine**, elija la edición de Oracle que desea utilizar. Las opciones de `APEX` y `APEX-DEV` se admiten en todas las ediciones.
1. En **Major engine version (Versión principal del motor)**, elija la versión de su instancia de base de datos.
Para obtener más información, consulte [Creación de un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Añada las opciones al grupo de opciones. Si desea implementar únicamente el entorno de tiempo de ejecución de Oracle APEX, añada solo la opción `APEX`. Si desea implementar el entorno de desarrollo completo, añada las opciones `APEX` y `APEX-DEV`.
Para **Versión**, elija la versión de Oracle APEX que desea utilizar.
**importante**
Si agrega las opciones de `APEX` y `APEX-DEV` a un grupo de opciones existente que ya se ha adjuntado a una o varias instancias de base de datos, se producirá una breve interrupción. Durante esa interrupción, se reinician automáticamente todas las instancias de base de datos.
Para obtener más información acerca de la adición de opciones, consulte [Agregar una opción a un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).
1. Aplique el grupo de opciones a una instancia de base de datos nueva o existente:
+ Si se trata de una instancia de base de datos nueva, el grupo de opciones se aplica cuando se lanza la instancia. Para obtener más información, consulte [Creación de una instancia de base de datos de Amazon RDS](USER_CreateDBInstance.md).
+ Para una instancia de base de datos existente, el grupo de opciones se aplica modificando la instancia y asociando el grupo de opciones nuevo. Cuando se agregan las opciones de `APEX` o `APEX-DEV` a una instancia de base de datos existente, se produce una breve interrupción mientras la instancia de base de datos se reinicia automáticamente. Para obtener más información, consulte [Modificación de una instancia de base de datos de Amazon RDS](Overview.DBInstance.Modifying.md).
## Desbloqueo de la cuenta de usuario pública en una instancia de base de datos
Después de instalar las opciones de `APEX` o `APEX-DEV` para la instancia de base de datos, asegúrese de hacer lo siguiente:
1. Cambie la contraseña de la cuenta `APEX_PUBLIC_USER`.
1. Desbloquee la cuenta.
Para ello, puede usar la utilidad de línea de comandos Oracle SQL\$1Plus. Conéctese a la instancia de base de datos como usuario maestro y ejecute los siguientes comandos. Reemplace `new_password` por una contraseña de su elección.
```
1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;
```
## Configuración de los servicios RESTful para Oracle APEX
Para configurar los servicios RESTful en Oracle APEX (no es necesario para Oracle APEX 4.1.1.V1), utilice SQL\$1Plus para conectarse a la instancia de base de datos como usuario maestro. Una vez realizado ese paso, ejecute el procedimiento almacenado `rdsadmin.rdsadmin_run_apex_rest_config`. Cuando ejecute el procedimiento almacenado, proporcione contraseñas para los siguientes usuarios:
+ `APEX_LISTENER`
+ `APEX_REST_PUBLIC_USER`
El procedimiento almacenado ejecuta el script `apex_rest_config.sql`, que crea cuentas de base de datos nuevas para estos usuarios.
**nota**
La configuración no es necesaria para Oracle APEX versión 4.1.1.v1. No es necesario ejecutar el procedimiento almacenado únicamente para esta versión de Oracle APEX.
El comando siguiente ejecuta el procedimiento almacenado.
```
1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');
```
## Preparativos para la instalación de ORDS en un host independiente
Instale ORDS en un host independiente, como una instancia de Amazon EC2, un servidor en las instalaciones de su empresa o un equipo de escritorio. En los ejemplos de esta sección, se supone que el host ejecuta Linux y tiene el nombre `myapexhost.example.com`.
Antes de poder instalar ORDS, tiene que crear un usuario de SO sin privilegios y, a continuación, descargar y descomprimir el archivo de instalación de Oracle APEX.
**Para prepararse para la instalación de ORDS**
1. Inicie sesión en `myapexhost.example.com` como `root`.
1. Cree un usuario de SO sin privilegios que sea el propietario de la instalación del agente de escucha. El siguiente comando crea un nuevo usuario llamado *apexuser*.
```
useradd -d /home/apexuser apexuser
```
El siguiente comando asigna una contraseña al nuevo usuario.
```
passwd apexuser;
```
1. Inicie sesión en `myapexhost.example.com` como `apexuser` y descargue los archivos de instalación de Oracle APEX desde Oracle en su directorio `/home/apexuser`:
+ [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html)
+ [Archivos de liberación previos de Oracle Application Express](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Descomprima el archivo en el directorio `/home/apexuser`.
```
unzip apex_version.zip
```
Tras descomprimir el archivo, hay un directorio `apex` en el directorio `/home/apexuser`.
1. Mientras siga con la sesión iniciada en `myapexhost.example.com` como `apexuser`, descargue el archivo de Oracle REST Data Services de Oracle a su directorio:`/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).
## Configuración del agente de escucha de Oracle APEX
**nota**
Oracle APEX Listener está obsoleto.
Amazon RDS para Oracle sigue siendo compatible con Oracle APEX versión 4.1.1 y Oracle APEX Listener versión 1.1.4. Se recomienda utilizar las últimas versiones compatibles de Oracle APEX y ORDS.
Instale Oracle APEX Listener en un host independiente, como, por ejemplo, una instancia Amazon EC2, un servidor en las instalaciones en su empresa o un equipo de sobremesa. Suponemos que el nombre del host es `myapexhost.example.com` y que el host ejecuta Linux.
### Preparación para instalar el agente de escucha de Oracle APEX
Antes de instalar Oracle APEX Listener, debe crear un usuario de SO sin privilegios y, a continuación, descargar y descomprimir el archivo de instalación de Oracle APEX.
**Para prepararse para la instalación del agente de escucha de Oracle APEX**
1. Inicie sesión en `myapexhost.example.com` como `root`.
1. Cree un usuario de SO sin privilegios que sea el propietario de la instalación del agente de escucha. El siguiente comando crea un nuevo usuario llamado *apexuser*.
```
useradd -d /home/apexuser apexuser
```
El siguiente comando asigna una contraseña al nuevo usuario.
```
passwd apexuser;
```
1. Inicie sesión en `myapexhost.example.com` como `apexuser` y descargue los archivos de instalación de Oracle APEX desde Oracle en su directorio `/home/apexuser`:
+ [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html)
+ [Archivos de liberación previos de Oracle Application Express](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html)
1. Descomprima el archivo en el directorio `/home/apexuser`.
```
unzip apex_.zip
```
Tras descomprimir el archivo, hay un directorio `apex` en el directorio `/home/apexuser`.
1. Mientras sigue con la sesión iniciada en `myapexhost.example.com` como `apexuser`, descargue el archivo de Oracle APEX Listener desde Oracle a su directorio `/home/apexuser`.
#### Instalación y configuración del agente de escucha de Oracle APEX
Antes de poder utilizar Oracle APEX, debe descargar el archivo `apex.war`, usar Java para instalar Oracle APEX Listener y, a continuación, iniciar el oyente.
**Para instalar y configurar el agente de escucha de Oracle APEX**
1. Cree un nuevo directorio basado en Oracle APEX Listener y abra el archivo del agente de escucha.
Ejecute el siguiente código:
```
mkdir /home/apexuser/apexlistener
cd /home/apexuser/apexlistener
unzip ../apex_listener.version.zip
```
1. Ejecute el siguiente código.
```
java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war
```
1. Introduzca la siguiente información que el programa le solicita:
+ Nombre de usuario del administrador del agente de escucha de APEX. El valor predeterminado es *adminlistener*.
+ Contraseña del administrador del agente de escucha de APEX.
+ Nombre de usuario del gestor del agente de escucha de APEX. El valor predeterminado es *managerlistener*.
+ Contraseña del administrador del agente de escucha de APEX.
El programa imprime una dirección URL que se necesita para completar la configuración, tal y como se indica a continuación.
```
INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
Database is not yet configured
```
1. Deje Oracle APEX Listener en ejecución para que pueda utilizar Oracle Application Express. Cuando haya completado este procedimiento de configuración, podrá ejecutar el agente de escucha en segundo plano.
1. Desde el navegador web, vaya a la dirección URL proporcionada por el programa del oyente de Oracle APEX. Aparece la ventana de administración de Oracle Application Express Listener. Introduzca la información siguiente:
+ **Username (Nombre de usuario** – `APEX_PUBLIC_USER`
+ **Password (Contraseña)**: la contraseña de *APEX\$1PUBLIC\$1USER*. Esta contraseña es la que especificó antes cuando configuró el repositorio de Oracle APEX. Para obtener más información, consulte [Desbloqueo de la cuenta de usuario pública en una instancia de base de datos](#Appendix.Oracle.Options.APEX.PublicUser).
+ **Connection Type (Tipo de conexión)**: Basic (Básica)
+ **Hostname (Nombre de host)**: el punto de enlace de su instancia de base de datos de Amazon RDS, como `mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com`.
+ **Port (Puerto** – 1521
+ **SID**: el nombre de la base de datos de la instancia de base de datos de Amazon RDS, como `mydb`.
1. Seleccione **Apply**. Aparece la ventana de administración de Oracle APEX.
1. Establezca una contraseña para el usuario `admin` de Oracle APEX. Para ello, use SQL\$1Plus para conectarse a la instancia de base de datos como usuario principal y, a continuación, ejecute los siguientes comandos.
```
1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
2. grant APEX_ADMINISTRATOR_ROLE to master;
3. @/home/apexuser/apex/apxchpwd.sql
```
Sustituya `master` por el nombre de usuario maestro. Cuando el script de `apxchpwd.sql` se lo solicite, introduzca una nueva contraseña de `admin`.
1. Vuelva a la ventana de administración de Oracle APEX en el navegador y elija **Administración**. A continuación, elija **Application Express Internal Administration**. Cuando se le soliciten las credenciales, introduzca la siguiente información:
+ **User name (Nombre de usuario** – `admin`
+ **Password (Contraseña)**: la contraseña que se estableció con el script `apxchpwd.sql`
Elija **Login** y a continuación defina una nueva contraseña para el usuario `admin`.
El agente de escucha ya está listo para utilizarse.