Oracle - Como instalar y configurar Oracle APEX Listener 2.0.5 con Oracle Glassfish Server 3.1.2.2 en Windows

El nuevo Oracle APEX Listener es una alternativa basada en J2EE para el Oracle HTTP Server (OHS) y mod_plsql. Esta aplicación J2EE ofrece una mayor funcionalidad, incluyendo una configuración basada en la web, seguridad mejorada, y el archivo de la memoria caché. El APEX Listener también proporciona flexibilidad soportando implementaciones utilizando Oracle Web Lógic Server (WLS) y Oracle GlassFish Server.

La arquitectura de Oracle Application Express requiere algún tipo de servidor Web para solicitudes de proxy entre el navegador web y el motor de Oracle Application Express. El APEX Listener fue creado para satisfacer esa necesidad, pero su uso va más allá de las configuraciones Application Express. El uso del Listener de Oracle APEX simplifica el proceso de implementación porque no se necesita ningún Oracle Home, la conectividad es proporcionada mediante un controlador JDBC incorporado.

Descarga de Archivos

Para realizar esta instalación y configuración debe tener el APEX Listener descargado de la página de oracle. Puede hacerlo desde aquí:  http://www.oracle.com/technetwork/developer-tools/apex-listener/overview/index.html

Para este ejemplo he descargado el APEX Listener Release 2.0.5 de octubre de 2013. El nombre del archivo es apex_listener.2.0.5.287.04.27.rar y lo he descomprimido en C:\apexlistener\

Se asume que :

• Oracle Application Express se encuentra instalado en una base de datos local Oracle Database XE 11g R2 (vea los post anteriores para conocer como realizar su instalación)
• Oracle Application Express utiliza PL/SQL Embebed Gateway configurado por el puerto 7700 y accesible por la URL: http://localhost:7700/apex
• Oracle GlassFish Server se encuentra instalado y funcionando correctamente en la misma maquina que la base de datos (vea el post anterior para conocer como realizar su instalación)

Instalación y configuración de APEX Listener en Oracle GlassFish Server

En primer lugar debemos pasar a Oracle GlassFish Server los componentes estáticos utilizados por Oracle Application Express, específicamente el directorio images el cual cuando se configura Oracle Application Express utilizando PL/SQL Embebed Gatewey se encuentra almacenado en la base de datos.

Para realizar esto siga los siguientes pasos:

1. Ingrese a la siguiente carpeta del Oracle GlassFish Server C:\glassfish3\glassfish\domains\apexdomain\docroot
2. Cree la sub-carpeta "i", quedaría asi: C:\glassfish3\glassfish\domains\apexdomain\docroot\i
3. Copie el contenido de la carpeta images que se encuentra en los archivos de instalación de Oracle Application Express dentro de la carpeta "i" que acaba de crear, en nuestro caso se encuentra en C:\Users\\Downloads\apex\images\

En segundo lugar debemos desplegar el APEX Listener en el Oracle GlassFish Server, para debemos generar la configuración para el APEX Listener y de los componentes estáticos para luego subirlas al GlassFish, para ello siga los siguientes pasos:

1. Desde la linea de comandos del sistema operativo, ubíquese en el directorio en el cual ha descomprimido el APEX Listener, en nuestro caso: C:\apexlistener\ ejecute el siguiente comando:

java -jar apex.war

2. Ingrese los datos solicitados
Nombre del servidor de base de datos: localhost
Puerto de la base de datos: 1521
servicio de la base de datos: XE
Nombre del usuario de la base de datos: APEX_PUBLIC_USER
Contraseña: (la que Ud indique, debe recordarla)
Indique ademas las contraseñas para los otros dos usuarios de base de datos
NO INICIAR EN MODO AUTONOMO, seleccione la opción 2

Genere la configuración para los componentes estáticos:

1. Desde la linea de comandos del sistema operativo, ubíquese en el directorio en el cual ha descomprimido el APEX Listener, en nuestro caso: C:\apexlistener\ y ejecute  el siguiente comando:

java -jar apex.war static C:\glassfish3\glassfish\domains\apexdomain\docroot\i

Se generará el archivo i.war

A continuación, despliegue la aplicacion apex.war e i.war en el Oracle GlassFish Server para ello siga los siguientes pasos:

1. Acceda a la consola de administración del Oracle GlassFish Server desde la URL: http://localhost:4848 y conectese con el usuario admin.
2. Ir al menu "Aplicaciones" y hacer clic en el botón "Desplegar" en Tareas Comunes de Oracle GlassFish Server.
2. Seleccionar el archivo .war de APEX Listener que se encuentra en el directorio desempaquetado del instalador, en nuestro caso en: C:\apexlistener\apex.war
3. Completamos los datos para desplegar la aplicación
Tipo: Aplicación Web
Raíz de Contexto: pls
Nombre de Aplicación: apex (dejar como esta, es el nombre del archivo .war seleccionado)
Descripción: APEX Listener
Dejamos los demás valores por defecto y hacemos clic en el botón "Aceptar" y esperamos al despliegue.
Aparecerá "apex" en la lista de Aplicaciones Desplegadas.


Repita los pasos para desplegar el i.war que ha generado, dejando en blanco el campo Raíz de Contexto:

1. Ir al menu "Aplicaciones" y hacer clic en el botón "Desplegar" en Tareas Comunes de Oracle GlassFish Server.
2. Seleccionar el archivo .war de los componentes estaticos que se encuentra en el directorio desempaquetado del instalador, en nuestro caso en: C:\apexlistener\i.war
3. Completamos los datos para desplegar la aplicación
Tipo: Aplicación Web
Raíz de Contexto: (dejar en blanco)
Nombre de Aplicación: i (dejar como esta, es el nombre del archivo .war seleccionado)
Descripción: Oracle APEX Image Directory
Dejamos los demás valores por defecto y hacemos clic en el botón "Aceptar" y esperamos al despliegue.
Aparecerá "i" en la lista de Aplicaciones Desplegadas.

Verifique que tanto la aplicación desplegada "apex" como "i" tienen la marca de "Activas" en la lista de aplicaciones desplegadas.

En tercer lugar debemos verificar el correcto funcionamiento del APEX Listener con Oracle Application Express, para ello siga los siguientes pasos:

1. Abra un navegador en una nueva ventana y acceda a Oracle Application Express via el PL/SQL Embebed Gateway original desde la dirección URL: http://localhost:7700/apex
2. Abra un navegador en una nueva ventana y acceda a Oracle Application Express via el APEX Listener desde la dirección URL: http://localhost:8080/pls

En ambos casos se debe poder acceder a Oracle Application Express sin inconvenientes. Notará que existe una la diferencia de velocidad que se nota entre ambas opciones.

Listo. Disfrute de Oracle Application Express servido a travez de APEX Listener y Oracle GlassFish Server.