Revisin 051223

F. Entrega:23-12-05

Manual de Sistema

Contenido: 1. 2. 3. 4. 5. 6. 7. 8. 9. Introduccin Requerimientos Instalacin Iniciar OpenWFE Detener OpenWFE Reiniciar OpenWFE Respaldar Datos Logs de Informacin Referencia

Revisin 051223

F. Entrega:23-12-05

1. Introduccin Este manual presenta una completa descripcin de los mdulos con el fin que el administrador instale y mantenga el sistema. El sistema consta de dos mdulos principales: un cliente y un servidor.

El servidor contiene varios servicios que interactan entre si por medio de procesos diferentes. Todos ellos en ejecucin aseguran el correcto funcionamiento del servidor OpenWFE. Por otro lado el cliente LoopFlow se conecta al servidor para solicitar operaciones en l. Este manual contempla solo la instalacin y mantencin del servidor. Para mayor informacin se puede consultar el manual de OpenWFE.

Revisin 051223

F. Entrega:23-12-05

2. Requerimientos

Hardware: PC Intel x86 Pentium IV o Equivalente 512 MB Ram 1 Tarjeta Red 1 GB en HD

Software: Windows 2000/XP/2003 Java JDK 5 FTP FileZilla Server o Similar OpenWFE 1.6.1 LoopFlow Service para OpenWFE 1.6.1

3. Instalacin

Los pasos a seguir en la instalacin son los siguientes: Instalacin de OpenWFE: Una vez que se tiene el paquete de distribucin de OpenWFE se descomprime en la carpeta C:\ Una vez terminada esta operacin se debe cambiar el nombre por defecto del instalador a openwfe de tal forma que la ruta de acceso queda como c:\openwfe Creacin carpeta temporal: Se debe crear una carpeta llamada tmp en la ruta de OpenWFE quedando c:\openwfe\tmp. Modificar lanzador: se debe cambiar las lneas del archivo c:\openwfe\bin\owfe-suite.bat rem set JAVA_HOME=c:\j2sdk1.4.2_01 rem rem set OPENWFE_HOME=c:\openwfe-1.4.5 a

Revisin 051223

F. Entrega:23-12-05

set JAVA_HOME=C:\jdk1.5.0_05 set OPENWFE_HOME=c:\openwfe donde la variable JAVA_HOME hace referencia a la ubicacin de la instalacin del JDK de Java y OPENWFE hace referencia a la ruta donde se instal OpenWFE Copiar header-factory: Copiar el archivo contenido en LoopFlow Service header-factory.xml a c:\openwfe\etc\worklist Copiar loopflow-expression: Copiar el archivo contenido en LoopFlow Service loopflow-expression.jar a c:\openwfe\jar Copiar engine-policy: Copiar el archivo contenido en LoopFlow Service engine-policy.conf a c:\openwfe\etc\engine Copiar expression-map: Copiar el archivo contenido en LoopFlow Service expression-map.xml a c:\openwfe\etc\engine Borrado de Workflows: Borrar todo el contenido de definiciones workflows en la carpeta c:\openwfe\workflow-definitions Instalacion FTP Server: Se instalar un servidor de ftp en el servidor donde reside OpenWFE. Creacin cuenta loopflow: Se crea una cuenta ftp loopflow/loopflow que tenga acceso directo o Home en c:\openwfe\ con todos los permisos.

Opcionalmente tambin puede simplemente instalar OpenWFE en c:\openwfe, borrar la carpeta workflow-definitions, y luego descomprimir el archivo LoopFlowSRV-fast.rar en c:\openwfe. Solo es necesario cambiar el archivo c:\openwfe\bin\owfe-suite.bat si es que el JDK no est instalado en c:\jdk1.5.0_05\. Despus de hacer esto todava es necesario el servidor FTP y la creacin de la cuenta. Este ltimo archivo tambin incluye un agente de correo, y un agente SQL, como tambin la aplicacin de ejemplo inf.sol.

Revisin 051223

F. Entrega:23-12-05

4. Inicio de Servicios Para iniciar los servicios de OpenWFE se debe ejecutar el comando: C:\openwfe\bin\owfe-suite.bat Una vez ejecutado se vern 5 ventanas de consola mostrando los 5 servicios, estos son: APRE : Servicio de agentes automticos WebClient: Consultas al visor de diagramas Worklist: Servicio de datos. WfdServer: Servicio de definicin de workflows Engine: Motor Workflow

5. Detener los Servicios Para detener los servicios de OpenWFE se debe ejecutar el comando: C:\openwfe\bin\owfe-suite-stop.bat Este comando cerrar correctamente los servicios de OpenWFE asegurando su consistencia.

6. Reiniciar los Servicios Para reiniciar los servicios de OpenWFE se debe ejecutar primero el comando detener los servicios y una vez detenidos estos el comando para iniciar.

7. Respaldo de Datos Como se especifica en el manual de administracin de OpenWFE, las instancias de workflows terminadas no son persistentes por lo que el desarrollador de aplicaciones debe crear aplicaciones con lgicas finales. Por ejemplo el uso de un agente en el estado final del Workflow permitira enviar datos a una base de datos. Por otro lado los workflows que se encuentran en ejecucin guardan la informacin de sus formularios en los workitems. Su representacin fsica son

Revisin 051223

F. Entrega:23-12-05

mediante archivos XML que se guardan en la ruta C:\openwfe\work\worklist\store, por lo que bastara simplemente de hacer un respaldo de estos. En general se deben considerar las siguientes rutas como respaldo: Respaldo de formularios e informacin en ejecucin: C:\openwfe\work\worklist\store Respaldo de los archivos de configuracin: C:\openwfe\etc\ Respaldo de las definiciones de aplicaciones C:\openwfe\workflow-definitions Respaldo de Agentes Automaticos C:\openwfe\apre-scripts

8. Log de Informacin

OpenWFE tiene diferentes tipos de logs los cuales son separados por servicio. Cada actividad que hace OpenWFE es registrada en estos logs. Por lo tanto un error o mal funcionamiento es fcilmente detectable en estos como por ejemplo en una Exception. Para revisar los logs se debe ver la ruta: C:\openwfe\logs

9. Referencia Gran parte de la informacin proporcionada en este documento fue extrado del manual de OpenWFE que se encuentra en la ruta C:\openwfe\doc que puede ser ledo para detalles tcnicos de OpenWFE.