Avances Tecnológicos

Higieia

HIGEIA: Un EAI (Enterprise Application Integrator) bajo licencia de código abierto.

INTRODUCCIÓN

Representacion de Higieia, Klimt

"Por Apolo médico y Esculapio, juro: por Higeia, Panacea y todos los dioses y diosas a quienes pongo por testigos de la observancia de este voto, que me obligo a cumplir...", así comienza el juramento hipocrático, que es el juramento público tomado por los graduados de medicina, ante la comunidad y otros médicos. Tiene su origen fundado en orientar éticamente la práctica del oficio de médico.

Asímismo, HIGEIA ( también conocida como Higea o Hygieia) diosa de la salud, hija de Esculapio, dios de la medicina, personifica la valoración y la práctica de la salud pública en nuestro mundo de hoy; por otra parte, la dimensión de lo social y lo participativo, en donde la sociedad, y particularmente los ciudadanos, constituyen el origen y destino de la Salud Pública, su razón de ser.

Desde el Área de Tecnologías de la Información del Servicio de Salud de Castilla La Mancha (SESCAM) se ha impulsado el lanzamiento de proyectos de código abierto adecuados al entorno sanitario del SESCAM. La posibilidad legal de modificar y adaptar el software a las características de la organización es la ventaja más destacable de entre todas las ventajas que presenta este modelo.

Tras un riguroso estudio de diferentes soluciones existentes, el Centro de Innovación Sanitaria Open Source (CISOS), perteneciente al Área de TIC del SESCAM, concluyó que el EAI BIE (Bussiness Integration Engine) se presentaba como el EAI que mejor cumplía con las necesidades planteadas por el SESCAM y supuso el punto de partida en la apuesta por poseer un EAI propio y adaptado a su entorno. Este EAI está desarrollado bajo el estándar J2EE y liberado bajo licencia GPL. A pesar de la potencialidad del EAI BIE ha sido necesario llevar a cabo un proceso evolución, mejora y adaptación al entorno tecnológico del SESCAM. Como fruto de este trabajo ha surgido el proyecto HIGEIA.

DEFINICIÓN

HIGEIA es el resultado de la evolución realizada por el CISOS de BIE en su versión 6.0.5. disponible en SourceForge. Las ventajas que aporta HIGEIA respecto a su predecesor entre otras son:

Integración con el servidores de aplicaciones J2EE de Oracle OC4J y JBoss AS.
Integración con bases de datos OracleDB y PostgreSQL.
Arquitectura basada en servicios y componentes separados no dependientes del servidor de aplicaciones J2EE. Mayor capacidad de adaptación en entornos corporativos.
Incorporación de mecanismos de control de procesos que dotan de mayor estabilidad en entornos críticos (por ejemplo, entornos sanitarios).
Depuración y solución de errores y fallos que proceden de BIE.
Extensión funcional del entorno.

DESCARGA

A continuación están disponibles los enlaces a los recursos necesarios de HIGEIA para su puesta en marcha:
HIGEIA 1.0.0 R5 (29/06/2007). Preview bajo OC4J

HIGEIA 1.0.0 R5 para Oracle AS OC4J 10g (10.1.3) R5, OracleDB 9i y Linux. Incluye un shell instalador así como todos los recursos necesarios para su puesta en marcha. Descarga (89Mb)
Oracle AS OC4J 10g (10.1.3) R5 para Linux. Descargar desde la página oficial de Oracle.
Paquete de librerías de JORAM JMS Server versión 4.3.22 que deben ser copiadas en el directorio $OC4J_HOME/j2ee/home/applib de la instalación de Oracle AS OC4J 10g (10.1.3) R5. Descarga
Fuentes del aplicativo. Descarga

HIGEIA 1.0.0 R3 (06/11/2006). Preview bajo OC4J

HIGEIA 1.0.0 R3 para Oracle AS OC4J 10g (10.1.3) R3, OracleDB 9i y Linux. Incluye un shell instalador así como todos los recursos necesarios para su puesta en marcha. Descarga (78Mb)
Oracle AS OC4J 10g (10.1.3) R3 para Linux. Descargar desde la página oficial de Oracle.
Paquete de librerías de JORAM JMS Server versión 4.3.21 que deben ser copiadas en el directorio $OC4J_HOME/j2ee/home/applib de la instalación de Oracle AS OC4J 10g (10.1.3) R3. Descarga
Fuentes del aplicativo. Descarga

PROCEDIMIENTO DE INSTALACION

El instalador incluido en la distribución de HIGEIA está diseñado como un asistente que guía al administrador paso a paso en cada fase de la instalación además de aportar la información necesaria para su puesta en marcha. Se aconseja seguir los siguientes pasos:

Instalar el servidor J2EE Oracle AS OC4J 10g (10.1.3) en una ubicación definida ($OC4J_HOME).
Desenpaquetar y copiar las librerías de JORAM JMS Server en el directorio $OC4J_HOME/j2ee/home/applib.
Aplicar el parche del core de OC4J proporcionado sustituyendo la librería oc4j.jar de $OC4J_HOME/j2ee/home/oc4j.jar por la suministrada con el mismo nombre.
Obtener los parámetros de conexión con la base de datos (futura) de HIGEIA necesarios en el procedimiento de instalación.
Desenpaquetar y ejecutar el instalador de HIGEIA 1.0.0 desde un directorio arbritario y seguir los pasos indicados.
Crear la base de datos de HIGEIA mediante los scripts SQL suministrados por el instalador.
Iniciar el servidor de aplicaciones OC4J con la opción -userThreads habilitada. Esta opción permite la creación de múltiples hilos (o threads) necesarios para que HIGEIA pueda atender múltiples mensajes de forma simultánea. Un ejemplo puede ser este:
cd $OC4J_HOME/j2ee/home
java -Xms256m -Xmx1024m -jar oc4j.jar -userThreads
Desplegar utilizando el Enterprise Manager de OC4J la aplicación higeia.ear suministrada por el instalador. En el momento de especificar el nombre bajo el cual queremos desplegar la aplicación en el contenedor éste debe ser obligatoriamente "bie", mientras que el nombre del módulo web será "higeia" tal y como aparece por defecto.
Una vez desplegada la aplicación es conveniente comprobar el correcto funcionamiento de la fuente de datos que apunta a la base de datos de HIGEIA y que ha sido configurada automáticamente según los parámetros proporcionados al instalador de HIGEIA. Podemos usar la sentencia sql "select * from users" para testear esta conexión mediante el Enterprise Managar de OC4J.
En este momento HIGEIA está desplegada en el servidor de aplicaciones pero NO está en funcionamiento. Para ello es necesario acceder al panel de control de HIGEIA (dashboard) vía web. La url será http://$nombre_servidor:8888/higeia . El login y password de acceso por defecto como usuario administrador de HIGEIA es "admin" y "123qwe" respectivamente. 10. Una vez estemos en el panel de control como usuario administrador iremos a la opción "Global Settings" donde pulsaremos el botón "Start up" para activar el motor de HIGEIA y esperaremos (entre 2 y 3 minutos máximo) hasta obtener el mensaje "BIE is started". Antes de apagar OC4J o desinstalar HIGEIA del mismo es muy importante acceder al panel de control de HIGEIA y desactivar el motor pulsando el botón de "Shut down" en la sección "Global Settings". Este procedimiento siempre permitirá que HIGEIA despache los mensajes pendientes.
Para aprovechar todas las capacidades asociadas a los servicios Web que proporciona Higeia se debe configurar el core de OC4J para que permita instanciar a cualquier aplicación desplegada bajo su entorno clases de la librería WSIF (Web Services Invocation Framework) de Apache (http://www.apache.org), ya que el core de OC4J depende de ésta y por defecto no lo permite.

SOPORTE

Para cualquier cuestión sobre la puesta en marcha, uso, evolución y detección de fallos de HIGEIA ponerse en contacto con el CISOS a través de su dirección de correo electrónico cisos@sescam.jccm.es