Capitulo 2.

Instalacin

Gua de Usuario jBPM 5 Instalacin

Esta gua le ayudar a instalar y ejecutar una instalacin de demostracin de los diversos componentes del proyecto jBPM. Si tiene algn comentario sobre cmo mejorar esta gua, si se encuentra con problemas, o si usted quiere ayudar, no dude en ponerse en contacto con la comunidad jBPM como se describe en la seccin "Qu hacer si me encuentro con problemas o tengo preguntas? ". 2.1. Requisitos previos Este script se asume que tiene Java JDK 1.5 o superior (fijado como JAVA_HOME) y Ant 1.7 + instalado. Si no, utilice los siguientes enlaces para descargar e instalar: Java: http://java.sun.com/javase/downloads/index.jsp Ant: http://ant.apache.org/bindownload.cgi 2.2. Descarga el instalador En primer lugar, es necesario descargar el instalador: jBPM-{version}-install.zip Por ejemplo, puede encontrar la ltima versin instantnea aqu. http://hudson.jboss.org/hudson/job/jBPM5/lastSuccessfulBuild/artifact/target/ 2.3. Demostracin de instalacin La forma ms sencilla de empezar es simplemente ejecutar el script de instalacin para instalar el programa de instalacin de demostracin. Slo tienes que ir a la carpeta de instalacin y ejecutar:

ant install.demo

Esto realizar las siguientes tereas: Descarga de JBoss AS Descargar Eclipse Instalar Drools Guvnor en JBoss AS Instalar de Oryx de diseo en JBoss AS Instalar el GWT jBPM-consola en JBoss AS Instalar el plugin de Eclipse jBPM Instalar el plugin de Eclipse Drools

Capitulo 2. Instalacin
Esto podra tomar un tiempo (en realidad, no es broma, estamos descargando un servidor de aplicaciones y una instalacin de Eclipse). El script sin embargo, siempre muestra que archivo est descargando (puede para comprobar ejemplo, si todava se est descargando, verificar si el tamao del archivo en cuestin en la carpeta jbpm-installer/lib sigue aumentando). Si desea evitar la descarga especfica componentes (porque no los vaya a utilizar o que ya las han instalado en alguna parte otra cosa), marque a continuacin para ejecutar slo determinadas partes de la demo o direccione la instalacin de los componentes a instalar. Una vez que la instalacin de demostracin ha terminado, puede empezar a jugar con los distintos componentes de partida la instalacin de demostracin:

ant start.demo

Esta sentencia realizar las siguientes tareas: Iniciar la base de datos h2 Iniciar el JBoss AS Iniciar Eclipse Iniciar el servicio de Human Task Una vez que todo se inicia, puede empezar a jugar con las herramientas de Eclipse, Guvnor y gwt-console, como se explica en las tres secciones siguientes. 2.4. Uso de herramientas de Eclipse El siguiente screencast [http://people.redhat.com/kverlaen/install-eclipse-jbpm.swf] provee informacin general sobre cmo ejecutar un proceso de demostracin simple en Eclipse. Este le muestra: Cmo importar un proyecto de ejemplo existente en el rea de trabajo, que contiene un ejemplo de proceso BPMN2 para solicitar una evaluacin del desempeo una clase Java de ejemplo para iniciar el proceso Cmo iniciar los procesos Una vez que ha abierto Eclipse, realice una importacin simple (utilizando "File -> Import ..." y luego seleccione Existing Projects into Workspace en el proyecto de ejemplo existente (en el directorio jbpm/installer/sample/evaluation). Esto debe agregar el proyecto de muestra, incluyendo un sencillo proceso BPMN2 y un archivo de Java para iniciar el proceso. Usted puede abrir el proceso de BPMN2 haciendo doble clic en l. Para ejecutar el proceso, haga clic en ProcessTest.java en el paquete com.sample (en "src/main/java") y seleccione "Run AsJava Application". En este caso, simplemente se iniciar el proceso, que dar lugar a la creacin de una tarea de usuario nueva para el usuario "krisv" en el servicio human task despus el proceso estar a la esperar para su ejecucin. Le mostraremos ms adelante cmo se puede completar las human tasks como est usando un cliente de human task con el jbpmconsole.

Capitulo 2. Instalacin
Tambin puede crear un nuevo proyecto mediante el asistente de proyecto jBPM. Este proyecto muestra contiene un proceso simple de BPMN2 con un ejemplo HelloWorld y un archivo asociado de Java para iniciar el proceso. Simple mente seleccione "File - New ... Project..." y bajo la categora "jBPM", seleccione "jBPM Project" y haga clic en "Next". D un nombre al proyecto y haga clic en "Finish". Usted debe poder ver a un nuevo proyecto que contiene un "sample.bpmn" y una clase Java "com.sample.ProcessTest". Puede abrir el proceso BPMN2 por el doble clic en l. Para ejecutar el proceso, haga clic derecho en ProcessTest.java y seleccione "Run As - Java Application". Usted debe ver una declaracin "Hello World" en la salida de la consola. 2.5. Uso de la gestin web de consolas Abra la consola de gestin de procesos con: http://localhost:8080/jbpm-console Regstrese utilizando krisv/krisv como nombre de usuario / contrasea. El screencast siguiente [http://people.redhat.com/kverlaen/install-gwt-console-jbpm.swf] nos dar una visin general de cmo manejar las distintas instancias del proceso. Este le muestra: Cmo iniciar un nuevo proceso Cmo consultar el estado actual de una instancia de proceso en ejecucin Cmo buscar sus tareas Cmo realizar una tarea Cmo generar informes para supervisar su ejecucin del proceso Para administrar las instancias de proceso, haga clic en la pestaa "Procesos" a la izquierda con la seleccin de "Proceso Informacin general". Despus de un ligero retraso (si est utilizando la aplicacin por primera vez, debido al perodo de sesiones de inicializacin, etc), el lista "Process" debera mostrar todos los procedimientos conocidos. En el jbpm-console la instalacin de demostracin en la actualidad todo el proceso de carga en la carpeta de la evaluacin "src/main/resources" muestra en "jbpm-installer/sample/evaluation". Si hace clic en el proceso, se le mostrar todas las instancias actuales en ejecucin. Dado que no existen instancias que se ejecutan en este momento, la tabla "instancia" permanecer vaco. Puede iniciar una nueva instancia de proceso haciendo clic en el botn "Start". Despus de confirmar que desea para iniciar una nueva ejecucin de este proceso, podr ver un formulario proceso en el que usted necesita para llenar la informacin necesaria para iniciar el proceso. En este caso, tendr que rellenar su nombre de usuario "krisv", despus de lo cual usted puede llenar el formulario y cerrar la ventana. Una nueva instancia debe aparecer en la tabla "Instance". Si hace clic en la instancia del proceso, usted puede comprobar sus datos a continuacin haciendo clic en los botones Diagram y Instance Data respectivamente. La instancia de proceso que acaba de comenzar es solicitar previamente una autoevaluacin del usuario y es esperando hasta que el usuario ha completado esta tarea.

Capitulo 2. Instalacin
Para ver las tareas que se han asignado a usted, elija la opcin "Tareas" ficha a la izquierda y seleccione "Personal de tareas" (es posible que tenga que hacer clic en Actualizar para actualizar la vista de tareas). Las tareas personales tabla debe mostrar el resultado de una "Evaluacin del Desempeo" tarea para usted. Puede completar esta tarea seleccionarlo y hacer clic en el botn "Ver". Esto abrir el formulario de tareas para las evaluaciones de desempeo. Puede rellenar los datos necesarios y completar el formulario y cerrar la ventana. Despus de completar la tarea, se puede consultar la "Descripcin general del proceso" una vez ms para comprobar el progreso de la instancia de proceso. Usted debe ser capaz de ver que el proceso est a la espera de su FC gerente y jefe de proyecto para llevar a cabo tambin una evaluacin. Usted puede entrar como "john" / "john" y "mary" / "marya" para completar estas tareas. Despus de iniciar y / o completar un proceso de pocos casos y las tareas humanas, puede generar un informe de lo sucedido hasta ahora. En la seccin "Informes", seleccionar "Informe de plantillas". De forma predeterminada, el consola tiene dos plantillas de informes, uno para generar una visin genrica para todos los procesos y un proceso para la inspeccin de una definicin especfica. Si selecciona este ltimo, asegrese de ingresar "com.sample.evaluation" como la definicin del proceso de identificacin para ver la actividad relacionada con la evaluacin proceso. Haga clic en "Crear informe" para generar un informe en tiempo real de la situacin actual. Tome en cuenta que la inicializacin de los informes pueden tardar un poco, sobre todo la primera vez que utilice la aplicacin. 2.6. Usando el repositorio Guvnor El repositorio Guvnor se puede utilizar como un proceso de depsito para almacenar los procesos de negocio. Tambin ofrece una interfaz basada en web para gestionar sus procesos. Este incluye un editor basado en web para visualizacin y edicin de los procesos. Abrir Drools Guvnor: http://localhost:8080/drools-guvnor Registrarse, usando cualquier nombre de usuario no-vaco / contrasea (que tiene la autenticacin deshabilitada para propsitos del demo ). El screencast siguiente [http://people.redhat.com/kverlaen/install-guvnor-jbpm.swf] nos da una visin general de cmo administrar su repositorio. Este le muestra: Cmo importar un proceso existente (en este caso el proceso de evaluacin) del Eclipse en guvnor? Cmo abrir el proceso de evaluacin en el editor web? Cmo crear un paquete para que pueda ser utilizado para la creacin de una sesin Si quiere saber ms, le recomendamos que eche un vistazo al resto de la documentacin Guvnor Drools. Una vez que hayas terminado de probar se finaliza con:

ant stop.demo

Capitulo 2. Instalacin
2.7. Qu hacer si me encuentro con problemas o tengo preguntas? Siempre puedes ponerte en contacto con la comunidad jBPM para obtener ayuda. email: jbpm-dev@lists.jboss.org IRC: # jbpm en irc.codehaus.org jBPM User Forum [http://community.jboss.org/en/jbpm?view=discussions] 2.8. Preguntas ms frecuentes Algunos problemas comunes se explican a continuacin. Q: Qu pasa si el instalador se queja de que no se puede descargar componente X? R: Est conectado a Internet? Tienes un firewall activado? Necesita un proxy? Podra ser posible que uno de los lugares que estamos descargando los componentes de se encuentre temporalmente fuera de lnea. Trate de descargar los componentes de forma manual (posiblemente a partir de ubicaciones alternativas) y ponerlos en la carpeta jbpminstaller/lib. Q: Qu pasa si el instalador se queja de que no se puede extraer / descomprimir un archivo jar/war/zip? R: Si el proceso de descarga falla al descargar un componente, es posible que el programa de instalacin est intentando el uso de un archivo incompleto. Trate de eliminar el componente en cuestin de la carpeta jbpm-installer/lib y vuelva a instalar, por lo que el archivo se volver a descargar. Q: Qu pasa si he ido cambiando mi instalacin (y que ya no funciona) y quiero volver a empezar de nuevo con una instalacin limpia? R: Puede utilizar ant clean.demo para eliminar todos los componentes instalados, para que pueda iniciar con una nueva instalacin. Q: Algunas veces aparecen excepciones cuando se trata de detener o reiniciar ciertos servicios, qu debo hacer? R: Si ve errores durante el cierre de este, ests seguro de que los servicios estn an en marcha? Si usted ve excepciones en el reinicio, est seguro el servicio que inici antes se cerr con xito? Tal vez debe intentar matar a los servicios manualmente si es necesario. Q: Algo parece ir mal cuando se ejecuta Eclipse, pero no tengo idea que. Qu puedo hacer? R: Siempre revise las consolas de salida, como mensajes de error o trazas de pila. Tambin puede consultar el Eclipse registro de errores para las excepciones. Trate de aadir un registrador de la auditora a la sesin de averiguar lo que est sucediendo en tiempo de ejecucin, o tratar de depurar la aplicacin. Q: Algo parece ir mal cuando se ejecuta una aplicacin basada en web en como el jbpmconsole, Guvnor y el Designer. Qu puedo hacer? R: Puede comprobar el registro del servidor para posibles excepciones en el directorio de jbpm-installer/jboss-4.2.3.GA / server/default/log. Para todas las otras preguntas, trate de ponerse en contacto con la comunidad jBPM como se describe anteriormente.

Traduccin: Marcelo Cceres Fuente: jbpm-docs-flow.pdf