Configuración de APEX y Oracle Rest Data Services (ORDS) - Amazon Relational Database Service
Adición de opciones de APEXDesbloqueo de la cuenta de usuario pública Configuración de los servicios RESTfulPreparativos para la instalación de ORDS en un host independienteConfiguración del agente de escucha de Oracle APEX

Configuración de APEX y Oracle Rest Data Services (ORDS)

En el siguiente tema se enumeran los pasos necesarios para configurar APEX y ORDS.

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.

  2. Agregue las opciones APEX y APEX-DEV al grupo de opciones.

  3. Asocie el grupo de opciones con la instancia de base de datos.

Cuando se añaden las opciones de APEX en Amazon RDS, 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 PUBLICpor lo que no necesita la cuenta administrativa de APEX para usarlo.

Para añadir las opciones de APEX 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 se admiten en todas las ediciones.

    2. 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.

  2. 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.

    En Version, elija la versión de APEX que desea utilizar.

    importante

    Si añade las opciones de APEX a un grupo de opciones 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.

  3. 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.

    • 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 añaden las opciones de APEX 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.

Desbloqueo de la cuenta de usuario pública en una instancia de base de datos

Después de instalar las opciones de APEX en Amazon RDS para su instancia de base de datos, haga lo siguiente:

  1. Cambie la contraseña de la cuenta de usuario pública de APEX.

  2. Desbloquee la cuenta.

Para ello, puede usar la utilidad de línea de comandos Oracle SQL*Plus. 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. 

ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

Configuración de los servicios RESTful para Oracle APEX

Para configurar los servicios RESTful en APEX (no es necesario para APEX 4.1.1.V1), utilice SQL*Plus 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.

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 APEX.

Para prepararse para la instalación de ORDS

  1. Inicie sesión en myapexhost.example.com como root.

  2. 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;

  3. Inicie sesión en myapexhost.example.com como apexuser y descargue los archivos de instalación de APEX desde Oracle en su directorio:/home/apexuser

  4. 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.

  5. 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.

Configuración del agente de escucha de Oracle APEX

nota

Oracle APEX Listener está obsoleto.

Amazon RDS para Oracle sigue siendo compatible con 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 APEX.

Para prepararse para la instalación del agente de escucha de Oracle APEX

  1. Inicie sesión en myapexhost.example.com como root.

  2. 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;

  3. Inicie sesión en myapexhost.example.com como apexuser y descargue los archivos de instalación de APEX desde Oracle en su directorio:/home/apexuser

  4. 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.

  5. 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 APEX, debe descargar el archivo apex.war, usar Java para instalar Oracle APEX Listener y, a continuación, iniciar el agente de escucha.

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

  2. Ejecute el siguiente código.

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

  3. 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

  4. 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.

  5. Desde el navegador web, vaya a la dirección URL proporcionada por el programa del agente de escucha de 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_PUBLIC_USER. Esta contraseña es la que especificó antes cuando configuró el repositorio de APEX. Para obtener más información, consulte Desbloqueo de la cuenta de usuario pública en una instancia de base de datos.

    • 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.

  6. Seleccione Apply. Aparece la ventana de administración de APEX.

  7. Establezca una contraseña para el usuario admin de APEX. Para ello, use SQL*Plus para conectarse a la instancia de base de datos como usuario principal y, a continuación, ejecute los siguientes comandos.

    EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
grant APEX_ADMINISTRATOR_ROLE to master;
@/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.

  8. Vuelva a la ventana de administración de APEX en el navegador y elija Administration. 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.