# 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](https://apex.oracle.com/) en la documentación de Oracle. **Topics** + [ ## Componentes de Oracle APEX ](#Appendix.Oracle.Options.APEX.components) + [ # Requisitos y limitaciones ](Appendix.Oracle.Options.APEX.Requirements.md) + [ # Configuración de Oracle APEX y Oracle Rest Data Services (ORDS) ](Appendix.Oracle.Options.APEX.settingUp.md) + [ # Configuración de Oracle Rest Data Services (ORDS) ](Appendix.Oracle.Options.APEX.ORDSConf.md) + [ # Actualización y eliminación de Oracle APEX ](Appendix.Oracle.Options.APEX.UpgradeandRemove.md) ## Componentes de Oracle APEX Oracle APEX consta de los siguientes componentes principales: + Un *repositorio* que almacena los metadatos para las aplicaciones y los componentes de Oracle 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 Oracle 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 Oracle 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 Oracle 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](https://docs.oracle.com/database/apex-5.1/HTMIG/choosing-web-listener.htm#HTMIG29321) en la documentación de Oracle. Cuando se agregan las opciones de `APEX` y `APEX-DEV` a la instancia de base de datos de RDS para Oracle, Amazon RDS instala solo el repositorio de Oracle APEX. Instale su oyente en un host independiente. # Requisitos y limitaciones En el siguiente tema se muestran los requisitos y las limitaciones para Oracle APEX y ORDS. ## Requisitos de versiones de Oracle APEX La opción de `APEX` utiliza el almacenamiento en la clase de instancia de base de datos para la instancia de base de datos. Estas son las versiones admitidas y los requisitos de almacenamiento aproximados para Oracle APEX. **** | Versión de Oracle APEX | Requisitos de almacenamiento | Versiones de Oracle Database compatibles | Notas | | --- | --- | --- | --- | | Oracle APEX versión 24.2.v1 | 114 MiB | Todos | Esta versión incluye el parche 37885097: PSE BUNDLE FOR APEX 24,2 (PSES ON TOP OF 24,2.0), PATCH\$1VERSION 4. | | Oracle APEX versión 24.1.v1 | 112 MiB | Todos | Esta versión incluye el parche 36695709: PSE BUNDLE FOR APEX 24.1 (PSES ON TOP OF 24.1.0), PATCH\$1VERSION 3. Si necesita instalar exactamente la misma versión de imágenes APEX en la instancia EC2, descargue la revisión 37544819: 24.1.3 PAQUETE PSE PARA APEX 24.1 (PSES SOBRE 24.1.0). | | 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\$1VERSION 6. Si necesita instalar exactamente la misma versión de imágenes APEX en la instancia EC2, descargue la revisión 37593125: 23.2.6 PAQUETE PSE PARA APEX 23.2 (PSES SOBRE 23.2.0). | | 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\$1VERSION 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\$1VERSION 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\$1VERSION 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\$1VERSION 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\$1VERSION 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\$1VERSION 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\$1VERSION 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 Oracle APEX descargables, consulte los [archivos de versiones anteriores de Oracle APEX](https://www.oracle.com/tools/downloads/apex-all-archives-downloads.html) en el sitio web de Oracle. ## Requisitos previos para Oracle APEX y ORDS Tenga en cuenta los siguientes requisitos previos para Oracle 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\$1Plus 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 ## Limitaciones de Oracle APEX No puede modificar la cuenta de usuario `APEX_version`, que administra Amazon RDS. Por lo tanto, no puede aplicar perfiles de bases de datos ni imponer reglas de contraseñas a este usuario. Oracle y AWS predefinen la configuración de perfiles y contraseñas para `APEX_version`, que se ha diseñado para cumplir con los requisitos de seguridad de Amazon RDS. # 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. # Configuración de Oracle Rest Data Services (ORDS) En el siguiente tema se enumeran las opciones de configuración de ORDS 21 y 22: **Topics** + [ ## Instalación y configuración de ORDS 21 y versiones anteriores ](#Appendix.Oracle.Options.APEX.ORDS) + [ ## Instalación y configuración de ORDS 22 y versiones posteriores ](#Appendix.Oracle.Options.APEX.ORDS22) ## 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 Oracle 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](#Appendix.Oracle.Options.APEX.ORDS22). 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](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html) y examine el archivo Readme. Asegúrese de que tiene instalada la versión de Java necesaria. 1. Cree un nuevo directorio para su instalación de ORDS. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Descargue el archivo `ords.version.number.zip` en [Oracle REST data services](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html) (Servicios de datos REST de Oracle). 1. Descomprima el archivo en el directorio `/home/apexuser/ORDS`. 1. 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 ``` 1. Conceda al usuario principal los privilegios necesarios para instalar ORDS. Una vez instaladas las opciones para Oracle 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](Appendix.Oracle.CommonDBATasks.TransferPrivileges.md). ``` 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. 1. 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](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/20.2/aelig/installing-REST-data-services.html#GUID-6F7B4E61-B730-4E73-80B8-F53299123730) 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\$1de\$1enlace\$1de\$1instancia\$1de\$1base\$1de\$1datos* Elija el valor predeterminado o introduzca el valor correcto. + Escriba el puerto del agente de escucha de la base de datos [1521]: *puerto\$1de\$1instancia\$1de\$1base\$1de\$1datos* 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\$1PUBLIC\$1USER. + Escriba la contraseña de la base de datos para ORDS\$1PUBLIC\$1USER: 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\$1user* Introduzca la contraseña de la base de datos para *master\$1user*: *master\$1user\$1password* Confirme la contraseña: *master\$1user\$1password* **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\$1METADATA [SYSAUX]. Introduzca el espacio de tabla temporal de ORDS\$1METADATA [TEMP]. Introduzca el espacio de tabla predeterminado de ORDS\$1PUBLIC\$1USER [USERS]. Introduzca el espacio de tabla temporal de ORDS\$1PUBLIC\$1USER [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\$1plsql, debe introducir 1 [1]. Elija el valor predeterminado. + Escriba el nombre de usuario de la base de datos de la gateway PL/SQL [APEX\$1PUBLIC\$1USER] Elija el valor predeterminado. + Escriba la contraseña de la base de datos para APEX\$1PUBLIC\$1USER: 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\$1LISTENER, APEX\$1REST\$1PUBLIC\$1USER) 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\$1LISTENER 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\$1REST\$1PUBLIC\$1USER 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\$1path* 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. 1. Establezca una contraseña para el usuario `admin` de 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. 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. 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. ## 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](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html) 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. 1. Cree un nuevo directorio para su instalación de ORDS. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Descargue el archivo `ords.version.number.zip` o `ords-latest.zip` de [Oracle REST data services](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html). 1. Descomprima el archivo en el directorio `/home/apexuser/ORDS`. 1. Conceda al usuario principal los privilegios necesarios para instalar ORDS. Una vez instalada la opción `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](Appendix.Oracle.CommonDBATasks.TransferPrivileges.md). ``` 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. 1. 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.3 o 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](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/20.2/aelig/installing-REST-data-services.html#GUID-6F7B4E61-B730-4E73-80B8-F53299123730) 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\$1instance\$1endpoint*** Elija el valor predeterminado o introduzca el valor correcto. + `Enter the database listener port [1521]:` ***DB\$1instance\$1port*** 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:` Ingrese la ruta a los archivos de instalación de Oracle APEX (`/home/apexuser/apex/images`). 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. 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](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/23.1/ordig/deploying-and-monitoring-oracle-rest-data-services.html#GUID-6791F5DF-AC67-4885-BFFA-B80964C17EC9) 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 Oracle 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. 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. # Actualización y eliminación de Oracle APEX Para actualizar o eliminar Oracle APEX, siga las instrucciones de este tema: **Topics** + [ ## Actualización de la versión de Oracle APEX ](#Appendix.Oracle.Options.APEX.Upgrade) + [ ## Eliminación de las opciones de APEX y APEX-DEV ](#Appendix.Oracle.Options.APEX.Remove) ## Actualización de la versión de Oracle APEX **importante** Realice una copia de seguridad de la instancia de base de datos antes de actualizar Oracle 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 para Amazon RDS](USER_CreateSnapshot.md) y [Prueba de una actualización de base de datos de Oracle](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md). Para actualizar Oracle 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. + Agregue 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](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG). + 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 Oracle APEX, el esquema de Oracle APEX de la versión anterior puede seguir en la base de datos. Si ya no lo necesita, puede eliminar el antiguo esquema de Oracle APEX de la base de datos después de actualizar la versión. Si actualiza la versión de Oracle APEX, pero los servicios RESTful no se habían configurado en la versión anterior de Oracle APEX, le recomendamos que configure los servicios RESTful. Para obtener más información, consulte [Configuración de los servicios RESTful para Oracle APEX](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.ConfigureRESTful). En algunos casos, cuando piensa realizar una actualización a la versión principal de la instancia de base de datos, puede que detecte que está usando una versión de OracleAPEX que no es compatible con la versión de base de datos de destino. En esos casos, puede actualizar la versión de Oracle APEX antes de actualizar la instancia de base de datos. Si actualiza Oracle APEX primero, puede reducirse el tiempo necesario para actualizar la instancia de base de datos. **nota** Tras actualizar Oracle APEX, instale y configure un oyente para usarlo con la versión actualizada. Para obtener instrucciones, consulte [Configuración del agente de escucha de Oracle APEX](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.Listener). ## Eliminación de las opciones de APEX y APEX-DEV Puede eliminar las opciones de `APEX` y `APEX-DEV` de una instancia de base de datos. Para eliminar estas opciones de la instancia de base de datos, realice una de las siguientes operaciones: + Para eliminar las opciones de `APEX` y `APEX-DEV` de varias instancias de bases de datos, elimine las opciones 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 un grupo de opciones que esté asociado a varias instancias de base de datos, se producirá una breve interrupción mientras se reinician las instancias de base de datos. Para obtener más información, consulte [Quitar una opción de un grupo de opciones](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Para eliminar las opciones de `APEX` y `APEX-DEV` de una sola instancia de base de datos, modifique la instancia de base de datos y especifique otro grupo de opciones diferente que no incluya estas opciones. Puede especificar el grupo de opciones predeterminado (vacío) u otro grupo de opciones personalizado. Cuando se eliminan las opciones, 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). Al eliminar las opciones de `APEX` y `APEX-DEV` de una instancia de base de datos, el esquema de APEX se elimina de la base de datos.