JWF Java WorkFlow Guía de Instalación Version 2.0 Diciembre 2002 IdeaSoft Uruguay s.r.l. 11300, Montevideo, Uruguay Tel:+598 (2) 7104372 www.isoft.com.uy
JWF 2.0 Guía de Instalación IdeaSoft Uruguay Marcas Registradas Java, EJB, JDBC, JNDI, JTA, Sun, Sun Microsystems son marcas registradas de Sun Microsystems, Inc. en los Estados Unidos y en otros paises. Castor es marca registrada de Exolab Group. XML, XML Schema, XSLT y estándares relacionados son marca registrada de MIT, INRIA, Keio u otros, y producto de World Wide Web Consortium. Jython, FOP y todos los nombres de otros productos mencionados de aquí en más son marcas registradas de su respectivos dueños Copyright 2002 IdeaSoft Uruguay S.R.L. 2
IdeaSoft Uruguay JWF 2.0 Guía de Instalación Tabla de Contenidos 1 Instalación y Configuración...5 1.1 Creación de la Base de Datos...5 1.1.1 Instalación de Base de Datos MySQL...5 1.1.1.1 Instalación sobre plataforma Windows...5 1.1.1.2 Creación de Base de Datos en MySQL...5 1.1.2 Creación de Base de Datos en SQLServer...6 1.2 Instalación del JWF Server...6 1.2.1 Instalación del Producto...6 1.2.1.1 Instalación sobre plataformas Windows...7 1.2.1.2 Registración de la Licencia...8 1.2.2 Configuración de la Base de Datos...8 1.2.2.1 Instalación Manual del Driver...8 1.2.2.2 Inicialización de la Base de Datos desde JWF...9 3
JWF 2.0 Guía de Instalación IdeaSoft Uruguay 4
IdeaSoft Uruguay JWF 2.0 Guía de Instalación 1 Instalación y Configuración 1.1 Creación de la Base de Datos El paso inicial en la configuración de la Base de Datos es precisamente la creación de la misma. Para ello se hace uso de la herramienta o los mecanismos provistos por el proveedor de la Base de Datos. Como ejemplo llamamos a la base con el nombre: JWF. En principio no es necesaria la definición de usuarios particulares de la base de datos, tan solo conocer un usuario con permisos suficientes y su respectiva contraseña al momento de la inicialización de la base de datos desde JWF. Se adjuntan las instrucciones de instalación y creación de la base de datos para los casos más típicos. 1.1.1 Instalación de Base de Datos MySQL 1.1.1.1 Instalación sobre plataforma Windows 1. Ejecutar el archivo de instalación incluido en la distribución de MySQL. Por ejemplo: D:\Setup.exe 2. Al comienzo se muestran los términos de la licencia del software. Presione el botón Next para continuar. 3. A continuación se muestra una nota de aclaración. Si la carpeta donde se pretende instalar MySQL difiere de C:\MySQL es necesario seguir las siguientes instrucciones para que MySQL pueda correr como servicio. Crear un archivo de configuración C:\My.cnf donde se indique en la sección [mysqld] las nuevas ubicaciones de la instalación. Por ejemplo: C:/Products/mysql. basedir = C:/Products/mysql/ datadir = C:/Products/mysql/data/ 4. Posteriormente se le pedirá que especifique la ruta de instalación de MySQL. En este paso de la instalación se sugiere una ruta por defecto C:\MySQL que podrá ser utilizada o no, teniendo en cuenta las nota anterior.presione el botón Next para continuar. 5. Por último se pide el tipo de Instalación a realizar. Se recomienda la opción Typical. Presione Next para continuar y finalizar la instalación. 1.1.1.2 Creación de Base de Datos en MySQL A continuación ejecutar el Administrador de MySQL. C:\MySQL\bin\winmysqladmin.exe Una vez en el Administrador, elegir la sección Database, botón derecho Create Database y se le 5
JWF 2.0 Guía de Instalación IdeaSoft Uruguay da nombre a la nueva base de datos (Por ejemplo: JWF, tal como se muestra en la siguiente figura). Nota: El usuario administrador por defecto de una base de datos MySQL es root con contraseña nula. 1.1.2 Creación de Base de Datos en SQLServer 1. Ejecutar el programa de Administración de SQLServer (SQL Server Enterprise Manager) desde el acceso directo provisto por la instalación del producto. Navegar a través del árbol (Tree) de la consola indicando el grupo y servidor donde se pretende crear la base de datos. Posicionarse sobre carpeta de base de datos (Databases) y presionar botón derecho para elegir la opción de crear una nueva base de datos (New Database). 2. A continuación se despliega un diálogo para la carga de las propiedades de la base de datos (Database Properties).Indicar el nombre (por ej: JWF) e indicar la ubicación de los archivos de datos y logs de transacciones (SQLServer sugiere ubicaciones por defecto para tales archivos). Por último presionar botón Aceptar (OK). Nota: El usuario administrador por defecto de una base de datos SQLServer es sa con contraseña nula. 1.2 Instalación del JWF Server 1.2.1 Instalación del Producto 6
IdeaSoft Uruguay JWF 2.0 Guía de Instalación 1.2.1.1 Instalación sobre plataformas Windows 1. Inserte el CD de distribución de JWF en la lectora CD-ROM. 2. La aplicación de instalación iniciará automáticamente. De no ser así, seleccione la opción Ejecutar desde el menú de Inicio de la barra de tareas de Windows y digite lo siguiente: D:\JWFSetup.exe Nota: En la instrucción anterior, D se refiere a la letra típicamente asignada a la lectora de CD-ROM, en caso de que su lectora tenga otra letra asignada deberá modificar la línea anterior con la letra correspondiente a su sistema. 3. Esto dará comienzo al proceso de instalación. El splash screen de JWF será desplegado mientras el instalador arma el ambiente necesario. Se pide el idioma a ser tenido en cuenta durante la instalación. Presione OK para continuar. 4. A continuación se desplegará un mensaje de Introducción al instalador. Presione el botón Siguiente para el siguiente paso. 5. Posteriormente se le pedirá que especifique la ruta de instalación del producto. En este paso de la instalación se sugiere una ruta por defecto C:\JWF. Presione el botón Siguiente para el siguiente paso. 6. El siguiente paso consiste en seleccionar la ubicación del acceso directo a la aplicación. Automáticamente el instalador seleccionará un lugar por defecto. Seleccione el lugar de su agrado y presione el botón Siguiente 7. A continuación se muestra un resumen de la información ingresada para la instalación. Si está de acuerdo y desea continuar presione el botón Siguiente. A partir de dicho instante se procede a instalar el JWF. 7
JWF 2.0 Guía de Instalación IdeaSoft Uruguay 8. Por último se muestra un mensaje de finalización de la instalación del producto. Presione el botón Terminado para salir del instalador. 1.2.1.2 Registración de la Licencia A continuación es necesario el ingreso de la licencia del producto. 1.2.2 Configuración de la Base de Datos 1.2.2.1 Instalación Manual del Driver Si la Base de Datos es MySQL o PostgreSql no es necesaria la instalación manual del driver. Para dichos casos la distribución de JWF contiene los archivos: mysql.jar y postgre.jar respectivamente. Si la Base de Datos es SQLServer es necesario ubicar manualmente los drivers JDBC. Ello consiste en copiar él ó los respectivos archivos a la carpeta classes bajo la carpeta de instalación de JWF. El caso habitual consiste en copiar los archivos: mssqlserver.jar, msutil.jar y msbase.jar; mientras que en el caso de utilizar el driver Opta basta con copiar el archivo opta2000.jar. 8
IdeaSoft Uruguay JWF 2.0 Guía de Instalación Si la Base de Datos es Oracle es necesario ubicar el archivo del driver JDBC en la carpeta classes. El nombre del archivo corresponde a oracle.jar. En caso de utilizar una Base de Datos distinta a las anteriores o en caso de utilizar otros drivers JDBC (archivos JAR distintos a los nombrados), corresponde modificar algunos archivos de configuración de JWF. Dichos archivos son: admserver.lax y gserver.lax ubicados en la carpeta de nombre bin bajo la carpeta de instalación. La modificación consiste en agregar la ubicación relativa de los drivers JDBC (archivos JAR) en la sección LAX.CLASS.PATH. Como ejemplo se muestra la referencia a los archivos de SQLServer. 1.2.2.2 Inicialización de la Base de Datos desde JWF 1. Levantar el servidor de JWF a través del acceso directo JavaWorkFlow Server. A continuación se muestra una consola con información propia del servidor. Es normal que la primera vez que se ejecuta despliegue mensajes de error, indicando que la base de datos no se encuentra inicializada. 2. Ejecutar el JWF Server Administrator a través del acceso directo. 3. A continuación y en la aplicación JWF Server Administrator se indica el servidor y su nombre. Para continuar presione el botón Conectar. Se solicita usuario y contraseña, indique system en ambos. 4. Una vez que el JWF Server Administrator está conectado al servidor se debe seleccionar el nodo Server. Allí se debe indicar el driver antes instalado con los valores adecuados de los parámetros según lo indique el proveedor. El caso general consiste en reemplazar las ocurrencias de HOST y DATABASE de la url. En HOST se debe indicar el nombre o dirección IP del servidor de Base de Datos, mientras que DATABASE corresponde al nombre de la Base de Datos. Cabe aclarar que el usuario indicado debe poseer los permisos suficientes para crear tablas y cargar información en la Base de Datos. 9
JWF 2.0 Guía de Instalación IdeaSoft Uruguay Una vez chequeada la conexión con la Base de Datos, aplicar los cambios presionando el botón Apply. A continuación se procede a generar la tablas. Presione el botón Generar Tablas y a continuación se muesta el log de la operación realizada. 5. El próximo paso consiste en Bajar el servidor desde el JWF Server Administrator (File/Shutdown Server). 6. Por último, es necesario volver a levantar el Server y ejecutar ya sea el JWF Server Admninistrator o el JWF Handler con usuario admin y sin contraseña para comenzar a utilizar el JWF. 10