ANEXO 5. MANUAL DE INSTALACIÓN Y DESPLIEGUE DE PROCESOS JBPM Página 1
CONTENIDO 1 INSTALACIÓN DEL SERVIDOR DE APLICACIONES...3 2 CONFIGURACIÓN DEL SERVIDOR DE APLICACIONES...4 3 DESPLIEGUE DE UN PROCESO JBPM EN OPENKM...5 4 REFERENCIAS...7
1 INSTALACIÓN DEL SERVIDOR DE APLICACIONES La aplicación utilizada para el despliegue de los procesos jbpm es OpenKM. A su vez, esta aplicación debe ser desplegada en el servidor de aplicaciones JBoss 4.2.3- Con el fin de facilitar la instalación del servidor de aplicaciones se recomienda descargar la versión disponible en, provista por OpenKM [1], ya que viene algunas configuraciones predefinidas. La instalación del servidor, consiste en descomprimir el archivo descargado y ubicarlo en el directorio deseado y requiere el JDK 1.6 o posterior instalado. Para el presente documento se asume que el servidor fue descomprimido en el disco local C en el sistema operativo Windows, aunque la instalación en sistemas operativos Linux es similar. Para correr el servidor basta con ejecutar el archivo por lotes run.bat ubicado en C:\jboss-4.2.3.GA\bin. En la Ilustración 1.1 se muestra el proceso de ejecución del archivo por lotes run.bat en Windows. Para la subir el servidor en alguna distribución de Linux se debe ejecutar el archivo run.sh. El manual de instalación en Linux se encuentra en [2]. Cabe anotar que para el despliegue total de la aplicación en el marco de una infraestructura de red, el comando de arranque del servidor es \bin\run.bat b 0.0.0 en Windows y en Linux bin\run.sht b 0.0.0 [3]. ILUSTRACIÓN 1.1. EJECUCIÓN DE JBOSS 4.2.3 EN LA CONSOLA DE COMANDOS DE WINDOWS. Para que el servidor suba correctamente, se debe asegurar que el archivo OpenKM.war se encuentre en C:\jboss-4.2.3.GA\server\default\deploy, el cual ya viene ubicado allí por Página 3
2 CONFIGURACIÓN DEL SERVIDOR DE APLICACIONES Para configurar el servidor de aplicaciones basta con reemplazar la siguiente lista de archivos en el directorio indicado. Archivo Ubicación Descripción OpenKM.cfg mail-service.xml jbpm.cfg.xml C:\jboss-4.2.3.GA defecto. Cuando el servidor termina de subir, es posible ingresar a OpenKM en la dirección http://localhost:8080/openkm. El puerto 8080 viene configurado por defecto pero puede ser modificado en el archivo C:\jboss-4.2.3.GA\server\default\deploy\jbossweb.deployer\server.xml. C:\jboss- 4.2.3.GA\server\default\deploy C:\jboss- 4.2.3.GA\server\default\deploy\O penkm.war\web-inf\classes Es donde se establecen propiedades principalmente relacionadas con los documentos manejados al in-terior del proceso como notificaciones de adición, modificación y eliminación de documentos. Contiene la configuración del servidor SMTP para las notificaciones por correo electrónico realizadas a través de JBoss. En este archivo se encuentran los servicios que jbpm utilizará, por ejemplo las propiedades del servidor SMTP, propiamente para las notificaciones por correo electrónico realizadas durante el proceso jbpm. Adicionalmente se pueden in-cluir otras propiedades como beans y jobs personalizados, así como referencias a otros archivos de configuración. El archivo de configuración por defecto se puede encontrar en el directorio de instalación de las librerías jbpm (\jbpm 3.3.1.GA\config), pero para la configuración de OpenKM, este se encuentra en jboss- 4.2.3.GA\server\default\deploy\OpenKM. war\web-inf\classes TABLA 2.1. ARCHIVOS DE CONFIGURACIÓN DEL SERVIDOR DE APLICACIONES.
3 DESPLIEGUE DE UN PROCESO JBPM EN OPENKM Para desplegar un proceso jbpm en OpenKM, es necesario cargarlo primero, lo cual se realiza en la vista Administración mostrada en la Ilustración 3.1. Esta vista cual solo es visible por usuarios con privilegios de administrador. ILUSTRACIÓN 3.1. VISTA DE ADMINISTRACIÓN EN OPENKM. Mediante la selección de la opción Workflow es posible cargar el proceso. Esta opción despliega la pantalla mostrada en la Ilustración 3.2, que contiene la lista de procesos cargados en OpenKM. El proceso corresponde a un archivo de extensión.par el cual empaqueta los diferentes componentes del mismo, como el diagrama, las clases Java utilizadas para la implementación, el archivo forms.xml que contiene las formas de las tareas humanas y la definición del proceso en JPDL. ILUSTRACIÓN 3.2. LISTA DE PROCESOS JBPM EN CARGADOS EN OPENKM. Para iniciar el despliegue del proceso previamente cargado debemos ir a la vista Escritorio, seleccionar un documento que será la base del proceso y seleccionar la opción, que despliega una lista de selección con los procesos previamente cargados en OpenKM, la cual es mostrada en la Ilustración 3.3. Página 5
ILUSTRACIÓN 3.3. LISTA DE SELECCIÓN DE PROCESOS JBPM A DESPLEGAR EN OPENKM. Tras la selección del proceso a desplegar y de la opción Iniciar, una nueva instancia del proceso es creada. Para acceder al estado de una instancia de proceso se selecciona la opción examinar que aparece en la columna Actions de la pantalla mostrada en la Ilustración 3.2. Esto, despliega la pantalla mostrada en la Ilustración 3.4, que contiene el estado de la instancia del proceso y en donde se puede examinar, eliminar, detener y pausar o reanudar dicha instancia mediante las acciones respectivamente. Si la el proceso no ha sido iniciado, no habrá información acerca de su(s) instancia(s). ILUSTRACIÓN 3.4. ESTADO DE LA INTANCIA DE PROCESO Si se elige examinar la instancia del proceso mediante la opción examinar de la columna Actions de la pantalla anterior, se despliega la pantalla mostrada en Ilustración 3.5, que posibilita la asignación dinámica de tareas, e incluso la exanimación, pausa y omisión de las mismas, mediante las opciones respectivamente.
ILUSTRACIÓN 3.5. ESTADO DETALLADO DE UNA INSTANCIA DE PROCESO. Por último y para el caso particular de los procesos implementados para el presente trabajo de grado, es necesario ubicar el archivo actores.xml en el directorio C:\jboss-4.2.3.GA\bin, del cual se extraen los usuarios del proceso para el módulo de notificaciones del procesos. Previamente se requiere la modificación de este archivo, ingresando usuarios consistentes con los creados en OpenKM. Cabe resaltar que los datos de los usuarios introducidos en este archivo (nombre, correo e id) deben coincidir con los datos registrados en OpenKM, con el fin de asegurar la consistencia de la información y el correcto funcionamiento del proceso. 4 REFERENCIAS [1] sourceforge.net, «Download OpenKM Document Management - DMS from SourceForge.net». [Online]. Available: http://sourceforge.net/projects/openkm/files/5.1/openkm-5.1.8_jboss- 4.2.3.GA.zip/download. [Accessed: 24-Ene-2012]. [2] openkm.com, «Quick Install - OpenKM Documentation». [Online]. Available: http://wiki.openkm.com/index.php/quick_install. [Accessed: 24-Ene-2012]. [3] openkm.com, «Basic application knowledge - OpenKM Documentation». [Online]. Available: http://wiki.openkm.com/index.php/basic_application_knowledge. [Accessed: 28- Ene-2012]. Página 7