Oracle Application Express - Amazon Relational Database Service

Oracle Application Express

Amazon RDS es compatible con Oracle Application Express (APEX) mediante el uso de las opciones APEX y APEX-DEV. Oracle APEX puede implementarse como un entorno de tiempo de ejecución o como un entorno de desarrollo completo para aplicaciones basadas en web. Con Oracle APEX, puede crear aplicaciones de principio a fin en el navegador web. Para obtener más información, consulte Oracle Application Express en la documentación de Oracle.

Componentes de APEX

Oracle APEX consta de los siguientes componentes principales:

  • Un repositorio que almacena los metadatos para las aplicaciones y los componentes de APEX. El repositorio se compone de tablas, índices y otros objetos que están instalados en la instancia de base de datos de Amazon RDS.

  • Un agente de escucha que administra las comunicaciones HTTP con los clientes de Oracle APEX. El oyente está en un host independiente como, por ejemplo, una instancia de Amazon EC2, un servidor en las instalaciones de su empresa o un equipo de escritorio. El agente de escucha acepta las conexiones entrantes de los navegadores web, las reenvía a la instancia de base de datos de Amazon RDS para su procesamiento y, después, envía los resultados del repositorio de vuelta a los navegadores.

    RDS para Oracle admite los siguientes tipos de oyente:

    • Para APEX versión 5.0 y posteriores, utilice Oracle REST Data Services (ORDS), versión 19.1 y posteriores. Le recomendamos utilizar la última versión compatible de Oracle APEX y ORDS. Esta documentación describe versiones anteriores solo para compatibilidad con versiones anteriores.

    • Para la versión 4.1.1 de APEX, puede utilizar Oracle APEX Listener versión 1.1.4.

    • Puede utilizar Oracle HTTP Server y agentes de escucha mod_plsql.

      nota

      Amazon RDS no es compatible con el servidor HTTP de base de datos XML de Oracle con la puerta de enlace PL/SQL integrada como oyente para APEX. En general, Oracle recomienda evitar el uso de la gateway PL/SQL integrada para las aplicaciones que se ejecutan en Internet.

    Para obtener más información sobre estos tipos de agentes de escucha, consulte Elección de un agente de escucha web en la documentación de Oracle.

Cuando se añaden las opciones de APEX de Amazon RDS a la instancia de base de datos de RDS para Oracle, Amazon RDS instala únicamente el repositorio de Oracle APEX. Instale su oyente en un host independiente.

Requisitos de versión de APEX

La opción de APEX utiliza el almacenamiento en la clase de instancia de base de datos para su instancia de base de datos. Estas son las versiones admitidas y los requisitos de almacenamiento aproximados para Oracle APEX.

Versión de APEX Requisitos de almacenamiento Versiones de Oracle Database compatibles Notas

Oracle APEX versión 23.2.v1

110 MiB

Todos

Esta versión incluye el parche 35895964: PSE BUNDLE FOR APEX 23.2 (PSES ON TOP OF 23.2.0), PATCH_VERSION 6.

Oracle APEX versión 23.1.v1

106 MiB

Todos

Esta versión incluye el parche 35283657: PSE BUNDLE FOR APEX 23.1 (PSES ON TOP OF 23.1.0), PATCH_VERSION 2.

Oracle APEX, versión 22.2.v1

106 MiB

Todos

Esta versión incluye el parche 34628174: PSE BUNDLE FOR APEX 22,2 (PSES ON TOP OF 22,2.0), PATCH_VERSION 4.

Oracle APEX, versión 22.1.v1

124 MiB

Todos

Esta versión incluye el parche 34020981: PSE BUNDLE FOR APEX 22.1 (PSES ON TOP OF 22.1.0), PATCH_VERSION 6.

Oracle APEX, versión 21.2.v1

125 MiB

Todos

Esta versión incluye el parche 33420059: PSE BUNDLE FOR APEX 21,2 (PSES ON TOP OF 21,2.0), PATCH_VERSION 8.

Oracle APEX, versión 21.1.v1

125 MiB

Todos

Esta versión incluye la revisión 32598392: PSE BUNDLE FOR APEX 21.1, PATCH_VERSION 3.

Oracle APEX versión 20.2.v1

148 MiB

Todas excepto Oracle Database 21c

Esta versión incluye la revisión 32006852: PSE BUNDLE FOR APEX 20.2, PATCH_VERSION 2020.11.12. Puede consultar el número de parche y la fecha ejecutando la siguiente consulta:

SELECT PATCH_VERSION, PATCH_NUMBER FROM APEX_PATCHES;

Oracle APEX versión 20.1.v1

173 MiB

Todas excepto Oracle Database 21c

Esta versión incluye la revisión 30990551: PSE BUNDLE FOR APEX 20.1, PATCH_VERSION 2020.07.15.

Oracle APEX versión 19.2.v1

149 MiB

Todas excepto Oracle Database 21c

Oracle APEX, versión 19.1.v1

148 MiB

Todas excepto Oracle Database 21c

Para ver los archivos .zip de APEX descargables, consulte los archivos de versiones anteriores de Oracle APEX en el sitio web de Oracle.

Requisitos de Oracle APEX y ORDS

Tenga en cuenta los siguientes requisitos para APEX y ORDS:

  • El sistema debe utilizar el entorno de ejecución de Java (JRE).

  • Una instalación de cliente de Oracle debe incluir lo siguiente:

    • SQL*Plus o SQL Developer para tareas de administración

    • Oracle Net Services para configurar conexiones a su instancia de base de datos de RDS para Oracle

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.

Instalación y configuración de ORDS 21 y versiones anteriores

Ahora está listo para instalar y configurar Oracle Rest Data Services (ORDS) para su uso con Oracle APEX. Para APEX versión 5.0 y posteriores, utilice las versiones 19.1 a 21 de ORDS. Para obtener información sobre cómo instalar ORDS 22 y versiones posteriores, consulte Instalación y configuración de ORDS 22 y versiones posteriores.

Instale el agente de escucha en un host independiente como, por ejemplo, una instancia Amazon EC2, un servidor en las instalaciones de su empresa o un equipo de escritorio. Para los ejemplos de esta sección, suponemos que el nombre de su host es myapexhost.example.com y que su host está ejecutando Linux.

Instalación y configuración de ORDS 21 y versiones anteriores para usarse con Oracle APEX
  1. Consulte Oracle REST data services y examine el archivo Readme. Asegúrese de que tiene instalada la versión de Java necesaria.

  2. Cree un nuevo directorio para su instalación de ORDS.

    mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS
  3. Descargue el archivo ords.version.number.zip en Oracle REST data services (Servicios de datos REST de Oracle).

  4. Descomprima el archivo en el directorio /home/apexuser/ORDS.

  5. Si va a instalar ORDS en una base de datos multiusuario, agregue la siguiente línea al archivo:/home/apexuser/ORDS/params/ords_params.properties

    pdb.disable.lockdown=false
  6. Conceda al usuario principal los privilegios necesarios para instalar ORDS.

    Una vez instalada la opción Amazon RDS APEX, conceda al usuario principal los privilegios necesarios para instalar el esquema de ORDS. Para ello, conéctese a la base de datos y ejecute los siguientes comandos. Sustituya MASTER_USER por el nombre del usuario principal en mayúsculas.

    importante

    Al ingresar el nombre de usuario, utilice mayúsculas, a menos que haya creado el usuario con un identificador que distingue entre mayúsculas y minúsculas. Por ejemplo, si ejecuta CREATE USER myuser o CREATE USER MYUSER, el diccionario de datos almacena MYUSER. Sin embargo, si utiliza comillas dobles en CREATE USER "MyUser", el diccionario de datos almacena MyUser. Para obtener más información, consulte Concesión de privilegios SELECT o EXECUTE para objetos SYS.

    exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);
    nota

    Estos comandos se aplican a las versiones 19.1 y posteriores de ORDS.

  7. Instale el esquema de ORDS mediante el archivo ords.war descargado.

    java -jar ords.war install advanced

    El programa le pedirá la siguiente información. Los valores predeterminados aparecen entre corchetes. Para obtener más información, consulte Introduction to Oracle REST Data Services en la documentación de Oracle.

    • Escriba la ubicación para almacenar los datos de configuración:

      Ingrese /home/apexuser/ORDS. Esta es la ubicación de los archivos de configuración ORDS.

    • Especifique el tipo de conexión de base de datos que se va a utilizar. Escriba un número: [1] Basic [2] TNS [3] URL personalizada [1]:

      Elija el tipo de conexión deseado.

    • Escriba el nombre del servidor de la base de datos [localhost]: punto_de_enlace_de_instancia_de_base_de_datos

      Elija el valor predeterminado o introduzca el valor correcto.

    • Escriba el puerto del agente de escucha de la base de datos [1521]: puerto_de_instancia_de_base_de_datos

      Elija el valor predeterminado o introduzca el valor correcto.

    • Escriba 1 para especificar el nombre del servicio de base de datos o elija 2 para especificar el SID de la base de datos [1]:

      Elija 2 para especificar el SID de la base de datos.

    • SID de la base de datos [xe]

      Elija el valor predeterminado o introduzca el valor correcto.

    • Escriba 1 si desea verificar/instalar el esquema de Oracle REST Data Services o escriba 2 para omitir este paso [1]:

      Elija 1. Este paso crea el usuario del proxy de Oracle REST Data Services denominado ORDS_PUBLIC_USER.

    • Escriba la contraseña de la base de datos para ORDS_PUBLIC_USER:

      Escriba la contraseña y, a continuación, confírmela.

    • Es necesario iniciar sesión con privilegios de administrador para verificar el esquema de Oracle REST Data Services.

      Introduzca el nombre del usuario administrador: master_user

      Introduzca la contraseña de la base de datos para master_user: master_user_password

      Confirme la contraseña: master_user_password

      nota

      Especifique una contraseña distinta de la que se muestra aquí como práctica recomendada de seguridad.

    • Introduzca el espacio de tabla predeterminado de ORDS_METADATA [SYSAUX].

      Introduzca el espacio de tabla temporal de ORDS_METADATA [TEMP].

      Introduzca el espacio de tabla predeterminado de ORDS_PUBLIC_USER [USERS].

      Introduzca el espacio de tabla temporal de ORDS_PUBLIC_USER [TEMP].

    • Introduzca 1 si desea utilizar la gateway PL/SQL o 2 para omitir este paso. Si utiliza Oracle Application Express o migra desde mod_plsql, debe introducir 1 [1].

      Elija el valor predeterminado.

    • Escriba el nombre de usuario de la base de datos de la gateway PL/SQL [APEX_PUBLIC_USER]

      Elija el valor predeterminado.

    • Escriba la contraseña de la base de datos para APEX_PUBLIC_USER:

      Escriba la contraseña y, a continuación, confírmela.

    • Escriba 1 para especificar contraseñas para los usuarios de la base de datos de los servicios RESTful de Application Express (APEX_LISTENER, APEX_REST_PUBLIC_USER) o escriba 2 para omitir este paso [1]:

      Elija 2 para APEX 4.1.1.V1; elija 1 para todas las demás versiones de APEX.

    • [No es necesario para APEX 4.1.1.v1] Contraseña de la base de datos para APEX_LISTENER

      Escriba la contraseña (si es necesario) y, a continuación, confírmela.

    • [No es necesario para APEX 4.1.1.v1] Contraseña de la base de datos para APEX_REST_PUBLIC_USER

      Escriba la contraseña (si es necesario) y, a continuación, confírmela.

    • Escriba un número para seleccionar una característica para habilitar:

      Escriba 1 para habilitar todas las características: SQL Developer Web, SQL habilitado para REST y API de base de datos.

    • Escriba 1 si desea comenzar en modo autónomo o 2 para salir [1]:

      Escriba 1.

    • Escriba la ubicación de recursos estáticos de APEX:

      Si descomprimió los archivos de instalación de APEX en /home/apexuser, escriba /home/apexuser/apex/images. De lo contrario, escriba unzip_path/apex/images, donde unzip_path es el directorio donde descomprimió el archivo.

    • Escriba 1 si usa HTTP o escriba 2 si usa HTTPS [1]:

      Si escribe 1, especifique el puerto HTTP. Si escribe 2, especifique el puerto HTTPS y el nombre del host de SSL. La opción HTTPS le pide que especifique cómo proporcionará el certificado:

      • Escriba 1 para usar el certificado autofirmado.

      • Escriba 2 para proporcionar su propio certificado. Si escribe 2, especifique la ruta de acceso del certificado SSL y la ruta de acceso de la clave privada del certificado SSL.

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

  9. Inicie el agente de escucha ORDS. Ejecute el siguiente código.

    java -jar ords.war

    La primera vez que inicie ORDS, se le pedirá que proporcione la ubicación de los recursos estáticos de APEX. Esta carpeta de imágenes se encuentra en el directorio /apex/images en el directorio de instalación de APEX.

  10. 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 usuarioadmin

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

Instalación y configuración de ORDS 22 y versiones posteriores

Ahora está listo para instalar y configurar Oracle Rest Data Services (ORDS) para su uso con Oracle APEX. Para los ejemplos de esta sección, suponemos que el nombre del host independiente es myapexhost.example.com y que está ejecutando Linux. Las instrucciones de ORDS 22 difieren de las instrucciones de las versiones anteriores.

Instalación y configuración de ORDS 22 y versiones posteriores para usarse con Oracle APEX
  1. Visite Oracle REST data services y examine el archivo Readme de la versión de ORDS que tiene pensado descargar. Asegúrese de que tiene instalada la versión de Java necesaria.

  2. Cree un nuevo directorio para su instalación de ORDS.

    mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS
  3. Descargue el archivo ords.version.number.zip o ords-latest.zip de Oracle REST data services.

  4. Descomprima el archivo en el directorio /home/apexuser/ORDS.

  5. Conceda al usuario principal los privilegios necesarios para instalar ORDS.

    Una vez instalada la opción Amazon RDS APEX, conceda al usuario principal los privilegios necesarios para instalar el esquema de ORDS. Puede hacerlo conectándose a la base de datos y ejecutando los siguientes comandos. Sustituya MASTER_USER por el nombre del usuario principal en mayúsculas.

    importante

    Al ingresar el nombre de usuario, utilice mayúsculas, a menos que haya creado el usuario con un identificador que distingue entre mayúsculas y minúsculas. Por ejemplo, si ejecuta CREATE USER myuser o CREATE USER MYUSER, el diccionario de datos almacena MYUSER. Sin embargo, si utiliza comillas dobles en CREATE USER "MyUser", el diccionario de datos almacena MyUser. Para obtener más información, consulte Concesión de privilegios SELECT o EXECUTE para objetos SYS.

    exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_LOB', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_ASSERT', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_OUTPUT', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SCHEDULER', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('HTP', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('OWA', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPG_DOCLOAD', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_CRYPTO', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_METADATA', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SQL', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('UTL_SMTP', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_NETWORK_ACL_ADMIN', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('SESSION_PRIVS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_USERS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACL_PRIVILEGES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACLS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_REGISTRY', 'MASTER_USER', 'SELECT', true);
    nota

    Los comandos anteriores se aplican a las versiones 22 y posteriores de ORDS.

  6. Instale el esquema de ORDS mediante el script ords descargado. Especifique los directorios que deben contener los archivos de configuración y los archivos de registro. Oracle Corporation recomienda no colocar estos directorios dentro del directorio que contiene el software del producto ORDS.

    mkdir -p /home/apexuser/ords_config /home/apexuser/ords_logs /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config \ install --interactive --log-folder /home/apexuser/ords_logs

    Para las instancias de base de datos que ejecutan la arquitectura de base de datos de contenedores (CDB), utilice ORDS 23.2 y versiones posteriores y pase el argumento --pdb-skip-disable-lockdown al instalar ORDS.

    /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config \ install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown

    El programa le pedirá la siguiente información. Los valores predeterminados aparecen entre corchetes. Para obtener más información, consulte Introduction to Oracle REST Data Services en la documentación de Oracle.

    • Choose the type of installation:

      Elija 2 para instalar los esquemas de ORDS en la base de datos y crear un grupo de conexiones de base de datos en los archivos de configuración de ORDS locales.

    • Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:

      Elija el tipo de conexión deseado. En este ejemplo se supone que elige 1.

    • Enter the name of the database server [localhost]: DB_instance_endpoint

      Elija el valor predeterminado o introduzca el valor correcto.

    • Enter the database listener port [1521]: DB_instance_port

      Elija el valor predeterminado 1521 o introduzca el valor correcto.

    • Enter the database service name [orcl]:

      Introduzca el nombre de base de datos que utiliza la instancia de base de datos de RDS para Oracle.

    • Provide database user name with administrator privileges

      Introduzca el nombre de usuario maestro para la instancia de base de datos de RDS para Oracle.

    • Enter the database password for [username]:

      Introduzca la contraseña de usuario maestro para la instancia de base de datos de RDS para Oracle.

    • Enter the default tablespace for ORDS_METADATA and ORDS_PUBLIC_USER [SYSAUX]:

    • Enter the temporary tablespace for ORDS_METADATA [TEMP]. Enter the default tablespace for ORDS_PUBLIC_USER [USERS]. Enter the temporary tablespace for ORDS_PUBLIC_USER [TEMP].

    • Enter a number to select additional feature(s) to enable [1]:

    • Enter a number to configure and start ORDS in standalone mode [1]:

      Elija 2 para omitir inmediatamente el inicio de ORDS en modo independiente.

    • Enter a number to select the protocol [1] HTTP

    • Enter the HTTP port [8080]:

    • Enter the APEX static resources location:

      Introduzca la ruta a los archivos de instalación de APEX (/home/apexuser/apex/images).

  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. Ejecute ORDS en modo independiente mediante el script ords con el comando serve. Para las implementaciones de producción, plantéese la posibilidad de utilizar servidores de aplicaciones Java EE admitidos, como Apache Tomcat u Oracle WebLogic Server. Para obtener información, consulte Deploying and Monitoring Oracle REST Data Services en la documentación de Oracle Database.

    /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config serve \ --port 8193 \ --apex-images /home/apexuser/apex/images

    Si ORDS se está ejecutando pero no puede acceder a la instalación de APEX, es posible que aparezca el siguiente error, sobre todo en las instancias que no son CDB.

    The procedure named apex_admin could not be accessed, it may not be declared, or the user executing this request may not have been granted execute privilege on the procedure, or a function specified by security.requestValidationFunction configuration property has prevented access.

    Para corregir este error, cambie la función de validación de solicitudes utilizada por ORDS ejecutando el script ords con el comando config. De forma predeterminada, ORDS usa el procedimiento ords_util.authorize_plsql_gateway, que solo se admite en las instancias de CDB. En el caso de las instancias que no son de CDB, puede cambiar este procedimiento por el paquete wwv_flow_epg_include_modules.authorize. Consulte la documentación de Oracle Database y Oracle Support para conocer las mejores prácticas a la hora de configurar la función de validación de solicitudes adecuada para su caso de uso.

  9. 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 usuarioadmin

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

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 usuarioAPEX_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 usuarioadmin

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

Actualización de la versión de APEX

importante

Realice una copia de seguridad de la instancia de base de datos antes de actualizar APEX. Para obtener más información, consulte Creación de una instantánea de base de datos para una instancia de base de datos single-AZ y Prueba de una actualización de base de datos de Oracle.

Para actualizar APEX con la instancia de base de datos, realice lo siguiente:

  • Cree un nuevo grupo de opciones para la versión actualizada de la instancia de base de datos.

  • Añada las versiones actualizadas de APEX y APEX-DEV al nuevo grupo de opciones. Asegúrese de incluir todas las opciones que utiliza la instancia de base de datos. Para obtener más información, consulte Consideraciones relativas al grupo de opciones.

  • Al actualizar la instancia de base de datos, especifique el nuevo grupo de opciones para la instancia de base de datos actualizada.

Después de actualizar la versión de APEX, el esquema de APEX de la versión anterior puede seguir en la base de datos. Si ya no lo necesita, puede eliminar el antiguo esquema de APEX de la base de datos después de actualizar la versión.

Si actualiza la versión de APEX, pero los servicios RESTful no se habían configurado en la versión anterior de APEX, le recomendamos que configure los servicios RESTful. Para obtener más información, consulte Configuración de los servicios RESTful para Oracle APEX.

En algunos casos, cuando piensa realizar una actualización a la versión principal de su instancia de base de datos, puede que detecte que está usando una versión de APEX que no es compatible con su versión de base de datos de destino. En esos casos, puede actualizar su versión de APEX antes de actualizar su instancia de base de datos. Si actualiza APEX primero, puede reducirse el tiempo necesario para actualizar la instancia de base de datos.

nota

Tras actualizar APEX, instale y configure un elemento de escucha para usarlo con la versión actualizada. Para obtener instrucciones, consulte Configuración del agente de escucha de Oracle APEX.

Eliminación de la opción de APEX

Puede eliminar las opciones de APEX en Amazon RDS de una instancia de base de datos. Para eliminar las opciones de APEX de una instancia de base de datos, realice una de las siguientes operaciones:

  • Para eliminar las opciones de APEX de varias instancias de bases de datos, elimine las opciones de APEX del grupo de opciones al que pertenecen. Este cambio afecta a todas las instancias de base de datos que utilizan el grupo de opciones. Cuando elimine las opciones de APEX de un grupo de opciones que esté asociado a varias instancias de base de datos, se producirá una breve interrupción mientras se reinician todas las instancias de base de datos.

    Para obtener más información, consulte Quitar una opción de un grupo de opciones.

  • Para eliminar las opciones de APEX de una única instancia de base de datos, modifique la instancia y especifique un grupo de opciones distinto que no incluya las opciones de APEX. Puede especificar el grupo de opciones predeterminado (vacío) u otro grupo de opciones personalizado. Cuando se eliminan las opciones de APEX, 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.

Al eliminar las opciones de APEX de una instancia de base de datos, el esquema de APEX se elimina de la base de datos.