DEV Community: Jean C. Omobono Z.

Servidor Oracle DB + APEX + ORDS + JasperReports desde cero (Parte 4)

Jean C. Omobono Z. — Thu, 17 Feb 2022 22:28:23 +0000

En la que sería ya la última publicación de esta serie, veamos los pasos para la instalación de JasperReports y su integración con la base de datos.

Jasper Reports Integration 2.7

Permite la integración de APEX con el motor de reportes Jasper. La versión más reciente de JRI se encuentra aquí y las instrucciones para la instalación están aquí

Como usuario root creamos un nuevo directorio para almacenar los binarions de las aplicacion

mkdir -p /u01/JasperReportsIntegration
chown tomcat:tomcat /u01/JasperReportsIntegration/

Usarmos el comando tar para extraer el contenido del archivo que descargamos y lo copiamos al directorio

tar xvf jri-2.7.0-jasper-6.16.0.tar
cp -R jri-2.7.0-jasper-6.16.0/* /u01/JasperReportsIntegration/

Agregramos al archivo .bash_profile del usuario tomcat

export OC_JASPER_CONFIG_HOME=/u01/JasperReportsIntegration

Cerramos sesión del usuario tomcat, volvemos a iniciarla y reiniciamos el servicio.

Modificamos el archivo /u01/JasperReportsIntegration/conf/application.properties para indicar los parámetros de conexión a la base de datos. Buscamos la sección [datasource:default] y modificamos los campos necesarios

[datasource:default]
type=jdbc
name=default
url=jdbc:oracle:thin:@//orcl-server:1521/XEPDB1
username=testing
password=Password01

Finalmente copiamos el archivo /u01/JasperReportsIntegration/webapps/jri.war en el directorio webapps de Tomcat

cp jri.war $CATALINA_BASE/webapps/.

El despliege de la aplicación debería hacerse de forma automática y a partir de este momento debería ser posible ingresar a la página de inicio en http://ip-servidor:8080/jri

El siguiente paso es instalar los objetos de base de datos, este proceso se divide en dos, una parte se ejecuta con el usuario SYS y el otro con el usuario dueño de la aplicación.

Descomprimimos el archivo que descargamos en algún sitio que sea accesible por el usuario oracle e ingresamos al directorio sql. Allí ingresamos a la base de datos usando SQL*Plus

sqlplus sys@localhost:1521/XEPDB1 as sysdba

Ejecutamos los siguientes comandos (en este caso testing es el esquema de base de datos dueño de la aplicación, deberá cambiarse por el nombre de esquema correcto en producción)

@sys_install testing
@sys_install_acl_12_and_above.sql testing orcl-server

Luego iniciamos una nueva conexión a la base de datos, esta vez con el usuario dueño de la aplicación.

sqlplus testing@localhost:1521/XEPDB1

Y ejecutamos

@user_install.sql

En una próxima publicación les mostraré cómo crear reportes PDF con JasperReports y APEX

Servidor Oracle DB + APEX + ORDS + JasperReports desde cero (Parte 3)

Jean C. Omobono Z. — Sat, 12 Feb 2022 15:15:18 +0000

En la publicación anterior hicimos la instalación del servidor de aplicaciones Tomcat. En esta nueva publicación avanzaremos con la instalación de la base de datos, APEX y ORDS.

Oracle XE 21c

La guía para realizar esta instalación se puede encontrar aquí. También sugiero la lectura de este artículo

La primera tarea es descargar el archivo RPM de instalación de XE desde aquí y colocar el archivo descargado en la carpeta home del usuario root. Allí procedemos a ejecutar el siguiente comando para realizar la instalación (este proceso se debe ejecutar como usuario root)

dnf -y localinstall oracle-database-xe-21c-1.0-1.ol8.x86_64.rpm

El proceso de instalación creará de manera automática el usuario y grupos así como hará las adecuaciones necesarias a los parámetros del kernel.

Una vez terminado el proceso de instalación y continuando como el usuario root ejecutamos el siguiente comando

/etc/init.d/oracle-xe-21c configure

Se solicitarán las contraseñas para los usuarios SYS, SYSTEM y PDBADMIN. Una vez completada la instalación es posible bajar/subir la base de datos y el listener con los siguientes comandos (como root):

/etc/init.d/oracle-xe-21c start
/etc/init.d/oracle-xe-21c stop

Oracle APEX 21.1

La guía oficial para la instalación de APEX se puede encontrar aquí sin embargo preferimos usar la versión resumida que se encuentra aquí.

Creamos un nuevo tablespace para almacenar los objetos de APEX

CREATE TABLESPACE apex DATAFILE '/opt/oracle/oradata/XE/XEPDB1/apex01.dbf' SIZE 100M AUTOEXTEND ON NEXT 1M;

Luego procedemos con la instalación, ingresamos al directorio en el servidor donde descargamos y descomprimimos el software de APEX. Iniciamos sesión con el usuario oracle que fue creado durante la instalación de XE.

Una vez allí nos conectamos a la base de datos usando SQL*Plus con el usuario SYS y ejecutamos el script de instalacion en el contenedor XEPDB1

cd /home/oracle/apex
sqlplus sys@localhost:1521/XEPDB1 as sysdba

(en este caso tuve que usar la sintaxis Easy Connect porque tengo otra BD en el servidor y SQL*Plus trataba de conectarse a esa, en otras circunstancias debería ser tan simple como ejecutar sqlplus / as sysdba)

ALTER SESSION SET CONTAINER=XEPDB1;
@apexins.sql APEX APEX TEMP /i/

Una vez completada la instalación cerramos la sesión de SQL*Plus y volvemos a ingresar con SYS para ejecutar unos comandos finales. Recomiendo cerrar SQL*Plus al ejecutar cada comando y volver a ingresar, ya que cada script hace cambios en la configuración de la aplicación que podrían afectar la ejecución de los scripts.

Cambiar la contraseña del usuario ADMIN de APEX (la contraseña debe tener caracteres especiales o fallará la creación)

ALTER SESSION SET CONTAINER=XEPDB1;
@apexchpwd.sql

Crear los usuarios APEX_LISTENER y APEX_REST_PUBLIC_USER

ALTER SESSION SET CONTAINER=XEPDB1;
@apex_rest_config.sql

ORDS

Para la instalación de ORDS tomaremos como base los pasos de esta guía. Descargaremos la última versión de ORDS desde este enlace.

Antes de iniciar la instalación nos conectaremos a base de datos para asegurar que los usuarios de conexión de ORDS están desbloqueados y que conocemos sus contraseñas.

ALTER SESSION SET CONTAINER = XEPDB1;
ALTER USER APEX_LISTENER IDENTIFIED BY Password01 ACCOUNT UNLOCK;
ALTER USER APEX_PUBLIC_USER IDENTIFIED BY Password01 ACCOUNT UNLOCK;
ALTER USER APEX_REST_PUBLIC_USER IDENTIFIED BY Password01 ACCOUNT UNLOCK;

Iniciamos sesión con el usuario tomcat y ejecutamos los siguientes comandos para crear el directorio y descomprimir el archivo que descargamos

mkdir /u01/ords
cd /u01/ords
unzip ords-latest.zip
mkdir -p /u01/ords/conf

Crearemos un directorio para almacenar la configuración de ORDS

mkdir -p /u01/ords/conf

Editaremos el archivo /u01/ords/params/ords_params.properties para indicar los parametros de la instalación

db.hostname=orcl-server.localdomain
db.port=1521
db.servicename=XEPDB1
db.sid=
db.username=APEX_PUBLIC_USER
db.password=Password1
migrate.apex.rest=false
plsql.gateway.add=true
rest.services.apex.add=true
rest.services.ords.add=true
schema.tablespace.default=APEX
schema.tablespace.temp=TEMP
standalone.mode=false
user.tablespace.default=APEX
user.tablespace.temp=TEMP
user.apex.listener.password=Password1
user.apex.restpublic.password=Password1
user.public.password=Password1
sys.user=SYS
sys.password=Password
restEnabledSql.active=true
feature.sdw=true
database.api.enabled=true

Indicamos la ubicación del directorio de configuración

$JAVA_HOME/bin/java -jar ords.war configdir /u01/ords/conf/

Iniciamos el proceso de instalación:

$JAVA_HOME/bin/java -jar ords.war

Realizamos el despliegue al servidor Tomcat

mkdir $CATALINA_BASE/webapps/i/
cp -R /tmp/apex/images/* $CATALINA_BASE/webapps/i/
cd /u01/ords
cp ords.war $CATALINA_BASE/webapps/

Iniciamos el servicio Tomcat en caso que este detenido. Si todo está bien deberíamos poder ingresar a APEX en http://ip-servidor:8080/ords.

En la próxima publicación culminaremos con la instalación de la integración con JasperReports.

Servidor Oracle DB + APEX + ORDS + JasperReports desde cero (Parte 2)

Jean C. Omobono Z. — Tue, 08 Feb 2022 20:06:05 +0000

En la primera parte completamos la instalación de un servidor Oracle Linux 8 listo para empezar a ser configurado con el resto de los componentes. Ahora veamos la instalación de nuestro middleware que sería Apache Tomcat

Apache Tomcat 9

Tomcat será el servidor de aplicaciones sobre el que desplegaremos ORDS. Para la instalación de Tomcat usaremos como base los pasos indicados aquí

Debemos descargar dos componentes:

Como usuario root crearemos el usuario tomcat y el directorio donde se instalará el software.

useradd tomcat
mkdir -p /u01
chown tomcat:tomcat /u01

Instalaremos OpenJDK en el directorio /u01/java

su - tomcat
mkdir -p /u01/java
cd /u01/java
tar xzf openjdk-17_linux-x64_bin.tar.gz
ln -s jdk-17 latest

Procederemos a instalar Tomcat en el directorio /u01/tomcat

mkdir -p /u01/tomcat
cd /u01/tomcat
tar xzf apache-tomcat-9.0.54.tar.gz
ln -s apache-tomcat-9.0.54 latest

Siguiendo las recomendaciones del artículo, procederemos a separar los binarios de Tomcat de la configuración para que los futuros procesos de actualización sean más simples. Para esto crearemos un nuevo directorio que servirá como ubicación para CATALINA_BASE y en este copiaremos los archivos relevantes.

mkdir -p /u01/config/instance
cp -r /u01/tomcat/latest/conf /u01/config/instance
cp -r /u01/tomcat/latest/logs /u01/config/instance
cp -r /u01/tomcat/latest/temp /u01/config/instance
cp -r /u01/tomcat/latest/webapps /u01/config/instance
cp -r /u01/tomcat/latest/work /u01/config/instace

Agregaremos las siguientes líneas al archivo /home/tomcat/.bash_profile

export JAVA_HOME=/u01/java/latest
export CATALINA_HOME=/u01/tomcat/latest
export CATALINA_BASE=/u01/config/instance

Cerramos la sesión del usuario tomcat y la volvemos a iniciar para que tome los cambios en este archivo. Luego de esto ya podemos iniciar/detener Tomcat con los siguientes comandos (habiendo iniciado sesión con el usuario tomcat):

$CATALINA_HOME/bin/startup.sh
$CATALINA_HOME/bin/shutdown.sh

Si todo finalizó de manera correcta podemos ingresar al portal de Tomcat en http://ip-servidor:8080/.

En la próxima parte haremos la instalación de la base de datos.

Servidor Oracle DB + APEX + ORDS + JasperReports desde cero (Parte 1)

Jean C. Omobono Z. — Mon, 07 Feb 2022 18:18:42 +0000

En mis publicaciones anteriores les he mostrado como hacer la instalación de una base de datos XE o de APEX usando herramientas como Vagrant o Docker, que permiten realizar el proceso con mucha facilidad. Esto está muy bien cuando quieren hacer pruebas en sus máquinas locales o tienen que hacer una instalación muy rápida y pequeña. ¿Qué hacemos si necesitamos hacer la instalación en un servidor de manera directa (no virtualizado) porque las exigencias del proyecto son un poco más altas?

En esta serie de publicaciones les mostraré mi experiencia instalando un servidor desde cero con las siguientes características:

Oracle Linux 8
Apache Tomcat 9
Oracle XE 21c
ORDS 21.3
JasperReports Integration 2.7

Comencemos con la instalación del sistema operativo

Oracle Linux 8

La primera tarea es instalar el sistema operativo en el equipo. Para asegurar la máxima compatibilidad con la base de datos y el resto de los componentes procederemos a instalar Oracle Linux 8, el cual se puede descargar desde aquí. En esta página seleccionaremos la última versión disponible de Boot ISO (esta es una versión más pequeña, el resto de los paquetes se descargaran en el momento de la instalación).

Una vez que tengamos el archivo ISO procedemos a usar una herramienta como Rufus (si estamos en Windows) para crear un USB booteable. Ingresamos el USB en el computador donde instalaremos el sistema operativo y al momento de arrancar le indicaremos al computador que haga el arranque desde el USB, esto iniciará el proceso de instalación de Oracle Linux.

A partir de este momento podemos seguir la guía de instalación en modo gráfico para hacer la instalación. Hay que poner especial cuidado en la sección 3.1.3 donde se explica como configurar los repositorios desde los cuales se descargarán los paquetes del sistema operativo.

Sobre la configuración de red: Por defecto la interface de red está deshabilitada, se debe habilitar manualmente para que pueda conectarse a los repositorios.

Sobre la particiones del disco duro: Por defecto la instalación del sistema operativo crea un filesystem en root y un /home que puede ocupar todo el disco. Es importante revisar esta configuración para asegurar que /home no sea tan grande y que se deje suficiente espacio para /opt que es donde se instala XE y se crean por defecto sus archivos de datos. Aunque no es obligatorio, sugiero dejar /opt como un punto de montura fuera de root para que sea más fácil de manipular en caso de ser necesario. Por supuesto tota la instalación se debe hacer sobre LVM.

Sobre la selección de software: Sugiero que se seleccione la opción Server (sin GUI) ya que no se requiere una interface gráfica para la instalación y administración de la base de datos.

Sobre los usuarios iniciales: Es obligatorio asignar una contraseña al usuario root, se sugiere que sea una contraseña fuerte. Además se sugiere crear otro usuario diferente a root que tenga privilegios de administración (que pueda usar sudo)

Tareas posteriores a la instalación

Es necesario hacer algunas configuraciones a nivel de red para asegurar que las conexiones se realizan de manera correcta. Para esto utilizaremos la aplicación nmtui conectados con el usuario root.

Al ingresar a la aplicación realizaremos los siguientes pasos:

Seleccionar la opción Edit a connection
Seleccionar la interface asociada a la tarjeta de red (por lo general eth1 o eno1)
En la sección IPv4 Configuration seleccionaremos la opción Manual y asignaremos una dirección IP fija dentro del rango de la red, recuerde que también debe indicar la máscara de red (por lo general es /24 en redes pequeñas), la colocaremos en el campo Addresses
En el campo Gateway colocaremos la IP de la pueta de enlace, por lo general es la IP del modem/router dado por el proveedor de internet.
En el campo DNS servers colocaremos las direcciones IP de los servidores DNS, por lo general son asignados por el proveedor de internet. También es posible utilizar servidores DNS externos como los de Google o Cloudflare.
Dejamos el resto de los campos con sus valores por defecto y bajamos hasta el final de la pantalla y presionamos OK.
Presionamos el botón Back para volver a la pantalla inicial.
Seleccionamos la opción Set system hostname.
Asignamos un nombre al servidor, sugiero algo como orcl-server.localdomain (en caso que la red del cliente no tenga un dominio creado).
Presionamos el botón OK
Presionamos el botón Quit
Reiniciar el equipo para aplicar los cambios.

En la próxima publicación veremos cómo hacer la instalación de Tomcat 9

Instalar las aplicaciones de ejemplo en Oracle APEX 21 o superior

Jean C. Omobono Z. — Sun, 06 Feb 2022 19:03:38 +0000

Ya hemos visto varias formas de instalar Oracle APEX, ya sea utilizando Vagrant o haciendo uso de las plataformas de Oracle que pueden ser apex.oracle.com o la versión Always Free en Oracle Cloud. Ahora bien, si instalaron la versión 21 o superior notarán que la página de Galeria de aplicaciones cambió por completo y ya no trae las aplicaciones de ejemplo instaladas por defecto.

Ahora nos presenta tres opciones para descargar:

Samples (Ejemplos): Nos muestran las funcionalidades más interesantes de APEX en aplicaciones específicas para cada una.
Plug-ins: Nos permiten extender la funcionalidad de Oracle APEX.
Apps: Son aplicaciones completamente funcionales para diferentes tipos de casos de uso (manejo de clientes, calendarios, encuestas, etc) y que podemos personalizar según nuestras necesidades.

En esta oportunidad vamos a instalar una aplicación de ejemplo, para ello haremos clic en Samples, lo que nos llevará a la página con el listado de aplicaciones de ejemplo.

Vamos a descargar la aplicación Sample Charts, que nos muestra algunos ejemplos de las gráficas que es posible construir en Oracle APEX. Haciendo clic en el enlace nos llevará a la página de GitHub donde se hospeda la aplicación.

Importante: Verifiquen que están en la rama apropiada del repositorio según la versión de Oracle APEX que tengan instalada, esta la encontarán en la esquina superior izquierda sobre la lista de archivos. Para descargar la aplicación hagan clic sobre el archivo con extensión zip y en la siguiente pantalla hagan clic en Download y finalmente seleccionen una carpeta en su equipo para guardar el archivo.

Ya con el archivo en nuestro equipo volveremos a la página principal de APEX, en la sección App Builder seleccionaremos Import

En la siguiente pantalla se nos pedirá que subamos el archivo de la aplicación. Podemos arrastrarla desde la carpeta o hacer clic sobre la sección Drag and Drop y luego seleccionar el archivo. Dejamos el resto de las opciones con sus valores por defecto y presionamos el botón Next.

En la siguiente pantalla se solicitará la confirmación de la tarea de importación. Hagan clic en Next

APEX les solicitará entonces la información sobre la aplicación que desean instalar, dejen los valores por defecto a menos que tengan una buena razón para cambiar alguno, y hagan clic en Install Application.

La siguiente pantalla les pedirá indicar si desean instalar los objetos de soporte, estos son los objetos de base de datos que tienen los datos que serán presentando por la aplicación. Mantengan las opciones por defecto y hagan clic en Next.

Finalmente verán una pantalla de confirmación, hagan clic en Install.

Importante: Si están haciendo uso de la versión Always Free de Oracle Cloud asegurense que el usuario de base de datos dueño del workspace tenga privilegios para usar el tablespace DATA.

Si todo está bien se mostará una nueva pantalla donde se indica que la instalación fue exitosa. Hagan clic en Run Application para ejecutar la aplicación.

Posiblemente les solicite el usuario y contraseña para acceder al workspace, luego de eso podrán ver la aplicación totalmente funcional.

Pueden repetir estos pasos para instalar las otras aplicaciones de ejemplo, las mismas quedarán instaladas en su workspace y podrán editarlas desde el App Builder

Instalando ORDS

Jean C. Omobono Z. — Sun, 21 Feb 2021 21:20:54 +0000

Hasta este punto ya tenemos disponibles dos servidores, uno con las base de datos XE 18c con APEX instalado y otro con Apache Tomcat. Ahora procederemos a instalar ORDS en la base de datos y a desplegarlo en Tomcat.

Primero verifiquemos que todos los usuarios de la base de datos que son requeridos estén desbloqueados y que conocemos sus contraseñas.

ALTER USER APEX_LISTENER IDENTIFIED BY SomePassword1 ACCOUNT UNLOCK;
ALTER USER APEX_PUBLIC_USER IDENTIFIED BY SomePassword1 ACCOUNT UNLOCK;
ALTER USER APEX_REST_PUBLIC_USER IDENTIFIED BY SomePassword1 ACCOUNT UNLOCK;

ORDS lo instalaremos en el servidor ubuntu que creamos previamente, por lo que tomaremos los archivos que descargamos desde la pagina de Oracle (tanto el archivo ords-19.2.0.199.1647.zip como el archivo apex_20.1.zip, de este ultimo vamos a necesitar un directorio) y los pondremos en el directorio donde se encuentra el archivo Vagrantfile de nuestra VM.

Luego ingresamos a la VM y los copiaremos desde el directorio /vagrant hasta el directorio ~/ (el home de nuestro usuario)

cd /vagrant/
cp ords-19.2.0.199.1647.zip ~/
cp apex_20.1.zip ~/
cd ~
mkdir ords
mv ords-19.2.0.199.1647.zip ords
cd ords/
unzip ords-19.2.0.199.1647.zip

Al finalizar de descomprimir, vamos a crear un directorio para almacenar la configuracion

mkdir conf

Para hacer mas sencilla la instalación, vamos a modificar el archivo ords/params/ords_params.properties donde colocaremos los parametros requeridos por el proceso de instalación de ORDS

db.hostname=192.168.56.3
db.port=1521
db.servicename=XEPDB1
db.sid=
db.username=APEX_PUBLIC_USER
db.password=SomePassword1
migrate.apex.rest=false
plsql.gateway=true
rest.services.apex.add=true
rest.services.ords.add=true
schema.tablespace.default=APEX
schema.tablespace.temp=TEMP
standalone.mode=false
user.tablespace.default=USERS
user.tablespace.temp=TEMP
user.apex.listener.password=SomePassword1
user.apex.restpublic.password=SomePassword1
user.public.password=SomePassword1
user.tablespace.default=APEX
user.tablespace.temp=TEMP
sys.user=SYS
sys.password=SomePassword1
restEnabledSql.active=true

Ahora utilizaremos el archivo ords.war para configurar el directorio donde se almacenara la configuracion de ORDS (que sería el directorio que creamos hace unos momentos)

vagrant@localhost:~/ords$ java -jar ords.war configdir /home/vagrant/ords/conf
Feb 16, 2021 7:40:10 PM  
INFO: Set config.dir to /home/vagrant/ords/conf in: /home/vagrant/ords/ords.war

Y finalmente ejecutamos la instalacion con el siguiente comando (todos los parametros se leeran del achivos que editamos más arriba, si algún parametro falta o esta incorrecto entonces el proceso de instalación lo solicitará)

java -jar ords.war
vagrant@localhost:~/ords$ java -jar ords.war 

Retrieving information.
Enter 1 if you want to use PL/SQL Gateway or 2 to skip this step.
If using Oracle Application Express or migrating from mod_plsql then you must enter 1 [1]:
Feb 16, 2021 7:43:00 PM  
INFO: reloaded pools: []
Installing Oracle REST Data Services version 19.2.0.r1991647
... Log file written to /home/vagrant/ords_install_core_2021-02-16_194301_00301.log
Warning: Nashorn engine is planned to be removed from a future JDK release
... Verified database prerequisites
... Created Oracle REST Data Services proxy user
... Created Oracle REST Data Services schema
... Granted privileges to Oracle REST Data Services
... Created Oracle REST Data Services database objects
... Log file written to /home/vagrant/ords_install_datamodel_2021-02-16_194355_00262.log
... Log file written to /home/vagrant/ords_install_apex_2021-02-16_194359_00566.log
Completed installation for Oracle REST Data Services version 19.2.0.r1991647. Elapsed time: 00:01:03.64

Ahora descomprimimos el archivo de apex y procedemos a copiar el directorio de imagenes en el directorio webapps de Tomcat, asi como el archivo ords.war

sudo mkdir /var/lib/tomcat8/webapps/i
sudo cp -R apex/images/* /var/lib/tomcat8/webapps/i/
sudo cp ords/ords.war /var/lib/tomcat8/webapps/
sudo service tomcat8 restart

Y finalmente pueden ingresar a localhost:8080/ords para ingresar a su instancia de APEX instalada sobre Tomcat.

Para ingresar simplemente coloquen INTERNAL como workspace, usuario ADMIN y la contraseña que ingresaron al correr el script apxchpwd.sql cuando instalamos APEX.

En caso de problemas
El error más común que he encontrado al hacer esta instalación es que los usuarios de BD no se encuentran desbloqueados o que la contraseña que colocamos en el archivo de configuración no es la correcta. Si este fuera el caso recuerden que deben borrar el contenido del directorio conf antes de intentar nuevamente la instalación.

También es importante que vean el contenido del archivo /var/lib/tomcat8/logs/catalina.out (probablemente deban ingresar como root) y ver los mensajes de error que allí se muestren al momento de levantar el proceso.

Referencias
Este artículo sobre la instalación de APEX y este sobre la instalación de ORDS fueron imprescindibles para crear esta serie.

Instalando Tomcat

Jean C. Omobono Z. — Tue, 16 Feb 2021 22:14:04 +0000

Para hacer más interesante este ejercicio, vamos a crear nuestro propio archivo Vagrantfile para crear la VM que tendrá instalado Apache Tomcat. Usaremos como base una image de Ubuntu 18.04 (aunque puede ser otra versión o distribución diferente, deberán cambiar el archivo Vagrantfile de manera acorde).

Para crear una VM con vagrant lo primero será crear un nuevo directorio y allí crear el archivo Vagrantfile. En mi caso particular aproveché el directorio ~/vagrant que ya existe y creé un nuevo directorio apache-server.

Veamos el archivo completo

# -*- mode: ruby -*-
# vi: set ft=ruby :

Vagrant.configure("2") do |config|
  NAME = "ubuntu-apache"
  config.vm.box = "ubuntu/bionic64"
  config.vm.define NAME
  # Provider-specific configuration
  config.vm.provider "virtualbox" do |v|
    v.memory = 2048
    v.name = NAME
  end

  config.vm.hostname = "localhost"

  config.vm.network "forwarded_port", guest: 8080, host: 8080
  config.vm.network "private_network", ip: "192.168.56.2", virtualbox__inet: "vboxnet0"
  config.vm.provision "shell", path: "scripts/install.sh"
end

Por supuesto, este archivo es mucho más sencillo que el que encuentran en los directorios de Oracle, pero es que la instalación es mucho más simple. Básicamente estamos definiendo un archivo Vargrantfile que creará una VM basada en Ubuntu Bionic Beaver, con 2GB de memoria RAM, con el nombre "ubuntu-apache" y con una red interna configurada tal como se hizo en la instalación de la VM para Oracle XE, solo que en este caso le asigamos la IP 192.168.56.2, además de hacer un redireccionamiento al puerto 8080 (estándar de Tomcat)

Aparte también creamos un nuevo directorio llamado scripts y crearemos dentro un archivo install.sh, que tendrá los comando para instalar los paquetes que necesitaremos en la VM.

#/bin/bash
echo 'INSTALLER: Started up'
sudo apt-get update -y
sudo apt-get upgrade -y
sudo apt-get -y install tomcat8 tomcat8-admin unzip

Una vez que esté listo el archivo volvemos a ~/vagrant/apache-server y ejecutamos el comando vagrant up. Si es la primera vez que descargamos la imagen entonces el proceso puede tomar algo de tiempo. Al finalizar podemos ingresar a la VM usando el comando vagrant ssh.

También podemos verificar si Tomcat está funcionando adecuadamente ingresando a la http://localhost:8080

Al finalizar deberíamos poder usar el comando ping (ingresando previamente a la VM) para verificar que ambas máquinas pueden responderse mutuamente.

Actualización: Apenas me estoy dando cuenta que utilicé el nombre "apache" en vez de "tomcat" en todas las referencias de la VM. Esto realmente no tiene importante a nivel técnico, pero es importante que las nomenclaturas que usemos para nuestros servicios se correspondan con lo que en verdad están sirviendo.

Configurando la red

Jean C. Omobono Z. — Tue, 16 Feb 2021 21:31:24 +0000

En la publicación anterior les había indicado que hacía falta solo instalar APEX a la instalación de XE que ya teníamos, sin embargo nos falta un paso más, este tiene más que ver con la configuración de la red de las VM.

Por defecto, las VMs creadas con Vagrant/VirtualBox se configuran con una interface de red que hace un NAT entre el VM y el equipo anfitrión (obviamente esta es una explicación extremadamente simplista, pueden ver más detalles aquí) y esto hace que la VM tenga acceso a internet pero no tiene acceso a otras VM dentro del mismo anfitrión. Como en nuestro caso Tomcat/ORDS estarán desplegados en otro servidor entonces debemos hacer la configuración necesaria tanto en VirtualBox como en los archivos Vagrantfile de nuestas VMs.

Lo primero será configurar una nueva red en VirtualBox, para esto abran la aplicación e ingresen a File -> Host Network Manager

Allí presionaremos el botón Create y colocaremos los datos de la red que queremos crear. Por lo general la configuración por defecto es suficiente, en mi caso cree una nueva red llamada vboxnet0 con una red 192.168.56.1/24 y con DHCP habilitado.

Al finalizar simplemente hagan clic en Close. Ya con esto tenemos una red configurada para ser utilizada por nuestras VMs; ahora toca hacer el cambio en los archivos Vagrantfile para que hagan uso de la misma. Para ello utilizaremos el editor de texto de preferencia y buscaremos la siguiente sección

  # Oracle port forwarding
  config.vm.network "forwarded_port", guest: VM_LISTENER_PORT, host: VM_LISTENER_PORT
  config.vm.network "forwarded_port", guest: VM_EM_EXPRESS_PORT, host: VM_EM_EXPRESS_PORT

Y justo al final agregaremos config.vm.network "private_network", ip: "192.168.56.3", virtualbox__inet: "vboxnet0" para que quede

  # Oracle port forwarding
  config.vm.network "forwarded_port", guest: VM_LISTENER_PORT, host: VM_LISTENER_PORT
  config.vm.network "forwarded_port", guest: VM_EM_EXPRESS_PORT, host: VM_EM_EXPRESS_PORT
  config.vm.network "private_network", ip: "192.168.56.3", virtualbox__inet: "vboxnet0"

La IP seleccionada puede ser cualquiera que esté dentro del rango de la red que creamos en Virtualbox. Ya con este cambio procederemos a reiniciar la VM con el comando vagrant reload. Al reiniciar la VM debería seguir funcionando como lo estaba antes del cambio, solo que ahora tendrá una nueva interface de red que le permitirá conectarse con otras VM en el equipo anfitrión.

En la siguiente parte de esta serie continuaremos con la creación de la VM para instalar Tomcat.

Instalando APEX

Jean C. Omobono Z. — Tue, 16 Feb 2021 21:31:03 +0000

En un artículo anterior expliqué como hacer la instalación de APEX en sus equipos locales usando VirtualBox y Vagrant, y esto funciona muy bien para hacer desarrollos sencillos de manera local o en ambientes de desarrollo. Sin embargo, lo más probable es que en ambientes productivos encuentren que APEX se encuentra desplegado sobre algún servidor de aplicaciones (como Tomcat o WebLogic) junto con ORDS. En esta publicación vamos a hacer la instalación de una instancia de Tomcat en una VM en la que también desplegaremos ORDS y lo configuraremos en una base de datos XE 18c en otra VM (tecnicamente es posible hacer la instalación en una sola VM, pero por temas de seguridad se separa siempre la base de datos del servidor de aplicaciones).

Instalación de XE/APEX

Ya la instalación de XE la cubrimos en este artículo sin embargo necesitamos agregar un paso más, que es la instalación de APEX.

Lo primero que haremos será descargar la última versión de APEX desde la página de Oracle; este archivo lo dejaremos en el directorio desde donde arrancamos la VM, ya que este directorio está visible para el sistema operativo de dicha VM en el directorio /vagrant.

 ~/vagrant/oracle/vagrant-projects/OracleDatabase/18.4.0-XE> ls -l 
total 160780
-rwxrwxr-x 1 jean jean 164603415 feb 11 17:04 apex_20.1.zip
drwxr-xr-x 2 jean jean      4096 jul 29  2020 ora-response
-rw-r--r-- 1 jean jean      5713 jul 29  2020 README.md
drwxr-xr-x 2 jean jean      4096 jul 29  2020 scripts
drwxr-xr-x 2 jean jean      4096 jul 29  2020 userscripts
-rw-r--r-- 1 jean jean      4826 feb 11 15:54 Vagrantfile

Asi se ve cuando vemos el directorio desde la VM (en mi caso tenía disponible el archivo de la versión 20.1, podría ser diferente cuando lean esta publicación)

~/vagrant/oracle/vagrant-projects/OracleDatabase/18.4.0-XE> vagrant ssh
Last login: Tue Feb 16 12:56:08 2021 from 10.0.2.2

Welcome to Oracle Linux Server release 7.9 (GNU/Linux 5.4.17-2036.102.0.2.el7uek.x86_64)

The Oracle Linux End-User License Agreement can be viewed here:

  * /usr/share/eula/eula.en_US

For additional packages, updates, documentation and community help, see:

  * https://yum.oracle.com/

[vagrant@localhost ~]$ cd /vagrant
[vagrant@localhost vagrant]$ ls -l
total 160780
-rwxrwxr-x. 1 vagrant vagrant 164603415 Feb 11 17:04 apex_20.1.zip
drwxr-xr-x. 1 vagrant vagrant      4096 Jul 29  2020 ora-response
-rw-r--r--. 1 vagrant vagrant      5713 Jul 29  2020 README.md
drwxr-xr-x. 1 vagrant vagrant      4096 Jul 29  2020 scripts
drwxr-xr-x. 1 vagrant vagrant      4096 Jul 29  2020 userscripts
-rw-r--r--. 1 vagrant vagrant      4826 Feb 11 15:54 Vagrantfile

Vamos a copiar al archivo que descargamos al directorio home del usuario oracle y a descomprimirlo

[vagrant@localhost vagrant]$ sudo su - oracle
Last login: Tue Feb 16 14:42:14 -06 2021 on pts/0
[oracle@localhost ~]$ cp /vagrant/apex_20.1.zip .
[oracle@localhost ~]$ unzip apex_20.1.zip

Finalmente tendremos al menos estos archivos y directorios

[oracle@localhost ~]$ ls -l
total 160756
drwxr-xr-x. 6 oracle oinstall      4096 Apr 17  2020 apex
-rwxr-xr-x. 1 oracle oinstall 164603415 Feb 16 14:43 apex_20.1.zip
-rwxr--r--. 1 oracle oinstall       758 Feb 16 10:57 setPassword.sh

Ahora que ya tenemos el instalador en nuestra VM, procedamos a preparar la base de datos y a hacer la instalación. Lo primero será ir al directorio que acabamos de descomprimir y allí iniciaremos SQL*Plus como SYSDBA

[oracle@localhost ~]$ cd apex
[oracle@localhost apex]$ sqlplus / as sysdba

SQL*Plus: Release 18.0.0.0.0 - Production on Tue Feb 16 14:47:38 2021
Version 18.4.0.0.0

Copyright (c) 1982, 2018, Oracle.  All rights reserved.


Connected to:
Oracle Database 18c Express Edition Release 18.0.0.0.0 - Production
Version 18.4.0.0.0

SQL>

Para mantener los objetos de APEX organizados en la base de datos, vamos a crear un nuevo tablespace donde almacenarlos (este paso es opcional, es posible almacenar los objetos de APEX en el tablespace SYSAUX).

SQL> ALTER SESSION SET CONTAINER=XEPDB1;
SQL> CREATE TABLESPACE apex DATAFILE '/opt/oracle/oradata/XE/XEPDB1/apex01.dbf' SIZE 100M AUTOEXTEND ON NEXT 1M;

El primer comando cambia el contenedor sobre el que voy a trabajar. Recuerden que a partir de 12c Oracle introdujo el concepto de multitenant en la que es posible tener varias BD "virtuales" dentro de una gran instancia. Les recomiendo su lectura ya que será el estándar de las base de datos Oracle de ahora en adelante.

Seguidamente ejecutaremos el instalador de APEX

SQL> @apexins.sql APEX APEX TEMP /i/

Si decidieron no crear otra tablespace simplemente cambien APEX por SYSAUX o el nombre del tablespace que hayan creado. El proceso de instalación puede durar unos minutos dependiendo de la capacidad de su equipo.

Si finalmente la instalación no dio ningún error pueden proceder a crear el usuario ADMIN para administrar la instancia de APEX. Para esto ejecutaremos:

SQL> @apxchpwd.sql

El script les solicitará el nombre del usuario, correo y contraseña, esta última debe cumplir con los estándares básicos de seguridad o no será aceptada por la base de datos (al menos una mayúscula, números y simbolos especiales).

Y finalmente ejecutamos el script para la creacion de los usuarios APEX_LISTENER y APEX_REST_USER, estos son necesarios para la conexión entre ORDS y la base de datos. El script les solicitará las contraseñas para estos nuevos usuarios.

SQL> @apex_rest_config.sql

Configuración del servidor de base de datos

Más arriba había indicado que hacía falta solo instalar APEX a la instalación de XE que ya teníamos, sin embargo nos falta un paso más, este tiene más que ver con la configuración de la red de las VM.

Esto lo explicaré en la próxima publicación de esta serie.

Oracle APEX con Vagrant

Jean C. Omobono Z. — Mon, 15 Feb 2021 03:29:04 +0000

En la publicación anterior donde les explicaba como hacer la instalación de Oracle XE 18c usando Vagrant y VirtualBox, les presentaba mi opinión de por qué me parece más apropiado usar la virtualización para la creación de estos ambientes de trabajo. En esta oportunidad vamos a usar la misma metodología para hacer la instalación de Oracle APEX.

Oracle Application Express

O simplemente APEX, es una plataforma de desarrollo de código bajo (low-code) desarrollada por Oracle para interactuar directamente con la base de datos, y que además permite crear aplicaciones completas en muy poco tiempo. Es una plataforma donde casi todo el desarrollo se realiza de forma declarativa (cambiando propiedades a los elementos de la aplicación) con una interface muy intuitiva, y que a su vez permite hacer personalizaciones más avanzadas ya sea mediante PL/SQL o JavaScript.

Hay diversas formas de empezar a trabajar con APEX:

Instalación de APEX en la base de datos de tu compañía (on-premise)
Solicitar un espacio de trabajo gratuito en apex.oracle.com
Crear una cuenta en la capa gratuita de Oracle Cloud
Instalar una VM con todo lo necesario para trabajar de manera local

Cada una de estas opciones tiene sus ventajas y características. En este artículo veremos la última opción, trabajar de manera local.

Preparar los archivos

En esta oportunidad asumiré que ya tienen instalado Virtualbox y Vagrant en sus equipos y que ya descargaron o clonaron el repositorio de los scripts preparados por Oracle. Nuevamente el ejemplo lo haremos sobre un equipo anfitrión con Ubuntu 20.04, sin embargo estas instrucciones deberían funcionar igual en otros sistemas operativos.

Lo primero es conseguir desde la página web de Oracle los instaladores de cada uno de los componentes (esto deben hacerlo solo una vez):

Archivo rpm para la instalación de Oracle XE: https://www.oracle.com/technetwork/database/database-technologies/express-edition/downloads/index.html
Oracle APEX: https://www.oracle.com/tools/downloads/apex-downloads.html
Oracle Rest Data Services (ORDS): https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads.html

ORDS, por si no lo han visto antes, crea un puente entre HTTP y tu base de datos, te permite crear REST API endpoints sobre los que puedes crear solicitudes en tus aplicaciones y extraer o procesar información de la base de datos.

Al finalizar la descarga deben colocar todos los archivos en vagrant-projects/OracleAPEX.

Una vez que los archivos estén en su sitio, solo deben ejecutar el comando vagrant up.

El proceso de instalación puede tardar un buen rato dependiendo de su conexión a internet, la capacidad del equipo, etc.

Una vez terminado el proceso de instalación, tomen nota de la información de conexión, recuerden que las contraseñas son autogeneradas pero se pueden cambiar luego de terminar el proceso.

Abran su navegador de preferencia y vayan a la URL indicada en el instalador, por lo general será http://localhost:8080/ords

Si todo está bien, deberían ver la página inicial de APEX en su equipo. La primera vez, dado que aun no han creado un espacio de trabajo, deben ingresar la siguiente información:

Workspace: internal
Username: admin
Password: la contraseña generada por el instalador

La primera vez que ingresen les pedirá que cambien la contraseña, asegúrense que sea una contraseña segura con al menos una mayúscula, números y un signo de puntuación. Una vez que hagan el cambio los llevará a la pantalla de bienvenida para crear su primer espacio de trabajo.

En APEX un espacio de trabajo es un compartimento lógico, una especie de base de datos privada que permite a los desarrolladores trabajar con una misma aplicación de APEX manteniendo privados sus propios objetos, datos y aplicaciones. El primer espacio de trabajo creado por defecto se llama internal, es un espacio de trabajo especial donde no se pueden crear aplicaciones ya que es el sitio de administración de APEX.

Pudieran crear un espacio de trabajo por usuario, o por proyecto, eso dependerá totalmente de sus necesidades.

Hagan clic en Create Workspace, esto los llevará a la pantalla donde deben indicar los datos básicos del espacio de trabajo.

En mi caso simplemente voy a crear un espacio de trabajo llamado testing. Presionen Next para continuar a la siguiente pantalla.

Un espacio de trabajo está asociado a un esquema de la base de datos. Pueden reutilizar un esquema ya existente (seleccionando Yes en Re-use existing schema?) o pueden crear un nuevo esquema y en esta pantalla colocaran los datos del mismo. En mi caso particular crearé un esquema con el mismo nombre del espacio de trabajo (recuerden que el nombre del esquema debe seguir las reglas de nombres de cualquier esquema/usuario que creen en la base de datos). Al introducir todos los datos presionen Next para continuar a la siguiente pantalla.

Luego deben dar los datos del administrador del espacio de trabajo. En el campo Username coloquen el nombre de usuario que usaran para conectarse como administrador (por lo general es admin pero pueden poner lo que quieran), una contraseña, nombre, apellido y dirección de correo electrónico.

La pantalla final les mostrará un resumen de los datos que colocaron para crear el espacio de trabajo, simplemente hagan clic en Create Workspace para finalizar.

Luego de un pequeño instante les mostrará la confirmación de la creación del espacio de trabajo, junto con la información sobre las estructuras de almacenamiento del usuario recién creado.

Al presionar el botón Done los llevará a la página de administración de los espacios de trabajo. Ya pueden cerrar esta sesión para ingresar al espacio de trabajo recién creado. Simplemente hagan clic en la parte superior derecha, donde aparece el nombre del usuario y en el menú emergente hagan clic en Sign out. Al salir, hagan clic en el botón verde para volver a la pantalla de inicio y ahora coloquen la información que usaron para crear su propio espacio de trabajo.

Es muy probable que la primera vez que ingresen les solicite que cambien la contraseña.

¡Y ya está! Finalmente están en un espacio de trabajo en blanco donde pueden empezar a crear aplicaciones desde cero. Si lo desean pueden ingresar a App Gallery para ver aplicaciones de demostración totalmente funcionales y que pueden servirles de base para sus propios proyectos.

Oracle XE con Vagrant

Jean C. Omobono Z. — Mon, 15 Feb 2021 02:46:18 +0000

Usar una VM en lugar de tu equipo

He visto muchos blogs en español en los que explican cómo realizar la instalación de Oracle XE 18c en diversos sistemas operativos y todos ellos asumen que la instalación se realizará directamente sobre tu equipo de trabajo. Aunque esto no está mal, mi experiencia me ha enseñado que no es una buena idea instalar XE directamente en el sistema operativo de tu computador principal: las configuraciones del equipo pueden cambiar a medida que vas instalando nuevas aplicaciones y/o servicios, haciendo que tu instalación de XE se pueda volver inestable (o de hecho todo tu sistema operativo, sobre todo en las instalaciones en Windows).

El proceso que voy a explicarles es muy similar a usar virtualenv en Python para crear ambientes virtuales para las librerías que utilizarás en tus aplicaciones, o a la creación de contenedores con Docker para crear máquinas de desarrollo completas. De esta forma tienen un ambiente dedicado exclusivamente al servicio con el que desean trabajar.

Vagrant para aliviar el proceso

No es necesario reinventar la rueda. Por lo general los tutoriales en español nos guían por el proceso completo de configuración del sistema operativo donde instalaremos la base de datos, incluyendo la instalación de paquetes, apertura de puertos, etc. Sin embargo ya Oracle ha publicado scripts que pueden aliviar la tarea.

Vagrant es una herramienta para construir y administrar máquinas virtuales. Básicamente nos permite utilizar scripts con una configuración predefinida para la creación de una máquina virtual. La ventaja principal es que es posible usar estos scripts para crear tantas máquinas virtuales como necesites y todas ellas tendrán la misma configuración.

En este procedimiento utilizaremos VirtualBox para administrar la máquina virtual de Oracle XE, si aun no tienen instalado VirtualBox pueden seguir las instrucciones de instalación para su sistema operativo. Además, también debe instalar Vagrant siguiendo estas instrucciones.

Iniciar la instalación

Una vez que VirtualBox y Vagrant están instalados procederemos a descargar los scripts de Oracle que se encuentran en este repositorio en GitHub. Pueden clonarlo o descargarlo totalmente y luego descomprimir el archivo en un directorio local de su preferencia.

En este ejemplo usaré un equipo con Ubuntu 20.04 como anfitrión, aunque las instrucciones son las mismas para cualquier sistema operativo.

En mi caso hice una clonación del repositorio, en la imagen anterior se ve el contenido del directorio.

Antes de iniciar la creación de la máquina virtual, es importante hacer notar que si es la primera vez que estamos ejecutando Vagrant en nuestro equipo es recomendable tener una buena conexión a internet, ya que el script descargará tanto la imagen del sistema operativo (Oracle Linux 7) y el instalador de la base de datos XE.

Para iniciar la creación de la máquina virtual de Oracle XE 18c procederemos al directorio vagrant-projects/OracleDatabase/18.4.0-XE y ejecutaremos el comando vagrant up.

El proceso de instalación se encargará de:

Descargar e instalar el sistema operativo (Oracle Linux 7)
Descargar e instalar las dependencias necesarias para la instalación de Oracle XE 18c.
Descargar e instalar Oracle XE 18c.
Configurar el redireccionamiento IP necesario para poder comunicarse con la VM desde el equipo anfitrión.

El proceso de instalación puede tomar varios minutos dependiendo del ancho de banda de su conexión y/o de la potencia de su equipo; en la consola verán el progreso de la misma.

Al finalizar el proceso tomen nota del usuario y contraseña de los usuarios sys, system y pdbadmin que aparecerán en la consola. (Si no pudieron tomar nota tampoco hay que entrar en pánico, es muy sencillo cambiar estas contraseñas y lo explicaré un poco más abajo)

¡Y eso es todo! Ya tienen una base de datos Oracle XE 18c funcional en su equipo. Para configurar un cliente como SQL Developer utilicen los siguientes datos:

Hostname: localhost
Port: 1521
SID: XE
PDB: XEPDB1
Usen las contraseñas generadas automáticamente

Si prefieren cambiar la contraseña pueden ingresar a la máquina usando el comando vagrant ssh estando en el mismo directorio desde el que ejecutaron vagrant up.

Una vez hayan ingresado a la máquina virtual ejecuten estos comandos:

sudo su - oracle

/home/oracle/setPassword.sh <nuevoPassword>

Donde <nuevoPassword> es la nueva contraseña que quieren utilizar. Recuerden que es posible que la base de datos exija que la contraseña cumpla con ciertos parámetros de complejidad.