En la máquina donde se va a realizar la instalación del ORDS debemos tener configurado lo siguiente:
- Sistema operativo linux 6 o 7
- Java 1.8 en adelante
- Weblogic 12.2.1.2 o superior
- Oracle APEX 18, 19 o 20 en cualquier release
Nota: Para este laboratorio usaremos la versión 18c del ORDS sin embargo el proceso funciona igual para las versiones 19c y 20c.
Primero debemos asegurarnos que los siguientes usuarios se encuentren desbloqueados y abiertos con su respectiva contraseña en la base de datos:
- APEX_PUBLIC_USER
- ORDS_PUBLIC_USER
Procederemos a descargar el ORDS del siguiente enlace:
https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads.html
Descomprimir el ords, nuestra ruta de descompresión será la siguiente /wls/ords:
unzip ords.zip
Al archivo descomprimido le cambiaremos el nombre de ords.war a apex.war, esto hará que el url aparezca de la siguiente manera: http://ip:puerto/apex en caso de mantener el nombre ords.war, el url aparecerá de la siguiente forma: http://ip:puerto/ords
Debemos ir a la base de datos y ejecutar el siguiente script de apex para crear los usuarios:
- APEX_LISTENER
- APEX_REST_PUBLIC_USER
Este es el script:
@apex_rest_config.sql
Luego de haber creado los usuarios debemos ejecutar el siguiente comando en el servidor del ords:
java -jar apex.war install advanced
java -jar apex.war map-url --type base-path /wls/ords/config XE
Colocamos la ruta donde tendremos nuestra carpeta de configuración del ords en este caso:
/wls/ords/config
XE es el SID de nuestra base de datos.
java -jar apex.war configdir /wls/ords/config
Por último, vamos a ejecutar el comando para crear i.war, nuestra instalación de APEX esta en la siguiente ruta /wls/apex/apex:
Nota: En caso de tener las imágenes de Oracle APEX en otro servidor, se deben pasar al servidor donde esté el ORDS y utilizar la ruta donde queden las imágenes para ejecutar el siguiente comando.
java -jar apex.war static /wls/apex/apex/images
Esto nos generará un archivo i.war.
Luego de esto debemos crear un manage server en el servidor de weblogic y ahí desplegar los 2 .war tanto apex.war como i.war.
Primero se despliega apex.war y luego i.war
Luego realizamos la prueba de acceso al apex usando el puerto del manage server donde desplegamos nuestro ORDS, en mí caso le coloqué el puerto 8080:
http://10.10.192.4:8080/apex/f?p=4550
De esta manera se completa la instalación y configuración del ORDS, ahora ya es posible utilizar servicios REST en APEX.
hola me da error:
Error: Unable to access jarfile ords.war
cuando ejecute : java -jar ords.war
Debes posicionarte en la carpeta donde se encuentre el jar descomprimido y ahí ejecutar el comando
tengo un problema cuando instalo ords, al poner la clave de sys, me sale el error Error. La version ORDS_VERSION no existe. no se que estoy haciendo mal.
Recuerda que la versión del ORDS debe ser la misma que la versión del APEX o superior, no puedes configurar un ORDS de una versión menor en un APEX de una mayor versión, verifica eso.
Adicionalmente, si está realizando la instalación en una base de datos con container y base de datos pluggable, recuerde que la instalación y el string de conexión siempre debe ser hacia la base de datos pluggable no en el container.