9.

0
Manual de instalacin
Enero, 2008

CHICAGO USA 400 N. Michigan Ave. Suite 1600 - (312) 836 9152 MONTEVIDEO URUGUAY Av. 18 de Julio 1645 P.4 - (5982) 402 2082 MEXICO CITY MEXICO Leibnitz N 20, Desp. 801 - Del Miguel Hidalgo - (5255) 5255 4733 SO PAULO BRAZIL Rua Samuel Morse 120 Conj. 141 - (5511) 5502 6722

Manual de instalacin Copyright Artech Consultores SRL 1988-2007. Todos los derechos reservados. El presente documento no puede ser duplicado de ninguna forma sin el expreso consentimiento de Artech Consultores SRL. La informacin contenida en este documento es para uso personal del lector. MARCAS REGISTRADAS GeneXus, GXflow y Artech son marcas o marcas registradas de Artech Consultores SRL. Todas las otras marcas citadas en este trabajo pertenecen a sus respectivos dueos.

Pgina 2 de 23

Manual de instalacin INDICE INTRODUCCIN ................................................................................................................................................................. 4 REQUERIMIENTOS DEL SISTEMA ........................................................................................................................................ 4 INSTALACIN ..................................................................................................................................................................... 5 SETUP WIZARD DE GXFLOW PROTECTION SERVICE............................................................................................................................ 6 SETUP WIZARD DE GXFLOW ....................................................................................................................................................... 10 AUTORIZACIN................................................................................................................................................................ 14 AUTORIZACIN DE GXFLOW PROTECTION SERVICE .......................................................................................................................... 14 AUTORIZACIN DE GXPM (GENEXUS PROCESS MODELER) .............................................................................................................. 22 CONSIDERACIONES LUEGO DE LA INSTALACIN .............................................................................................................. 22

Pgina 3 de 23

Manual de instalacin

Introduccin
Los objetivos de este documento son: Describir los requerimientos bsicos de software necesarios para la instalacin de GXflow Describir paso a paso el proceso de instalacin de GXflow

Requerimientos del Sistema

Sistemas Operativos: o IBM OS/400 o LINUX o UNIX o Windows NT/2000/2003 Servers o Windows NT (Service Pack 6 superior)/2000/XP/VISTA o Windows Mobile GeneXus Protection Server 5.3 instalado en forma local o en alguna mquina accesible a travs de la red. GeneXus 9.0 upgrade 3 superior, licencia full. GXpublic 9.0 superior. GXflow Protection Service 9.1 Microsoft .Net Framework 2.0. Plataformas de Ejecucin: o JAVA (generador U3 o superior) o Microsoft .NET (generador U3 o superior) Bases de Datos: o IBM DB2 UDB 8.1 o superior o IBM DB2 iSeries V5R2 o superior(se soportan nombres de atributos y tablas cortos y largos) o MySQL 5.0 o Microsoft SQL Server 2000 o superior o Oracle 9.0 o superior Servidores Web: o Microsoft IIS o Apache Tomcat o WebSphere

Nota IMPORTANTE!!:
Para esta versin no se soporta la integridad referencial en la base de datos.

Pgina 4 de 23

Manual de instalacin

Instalacin
La instalacin de GXflow se compone de 3 etapas. La primera etapa consiste en la instalacin del GXflow Protection Service 9.1. Este servicio de proteccin es necesario, debido a que el motor de workflow lo utiliza para verificar que los usuarios que acceden a las aplicaciones estn debidamente autorizados. Para el correcto funcionamiento de GXflow Protection Service es necesario que GeneXus Protection Server 5.2 o superior est instalado localmente o en alguna mquina accesible a travs de la red. La segunda etapa consiste en la instalacin de GXflow, el cual incluye el GXPM (GeneXus Process Modeler) y el motor de WorkFlow. Para cada una de estas 2 etapas etapas existe un Setup Wizard que lo guiar en el proceso de instalacin como se describe a continuacin. Para terminar debe consolidar los objetos de workflow en su base de conocimiento, el xpz lo puede encontrar en <dir_instalacin_GXflow>/KB. Si usted est utilizando DB2 iseries con nombre cortos (tablas = 8 , atributos = 10) debe consolidar de la siguiente forma: 1) Seleccionar el xpz que est en <dir_instalacin_GXflow>/KB 2) Presionar el botn Advanced y luego el botn Adapt From 3) Presionar el botn Open y elegir el archivo ShortNames.GMR que se encuentra en <dir_instalacin_GXflow>/KB para luego poder aplicar las reglas que contiene ese archivo 4) Presionar el botn Apply Rules y luego el botn OK para continuar con la consolidacin 5) Para iniciar la consolidacin presionar el botn OK Luego debe hacer un Build All de la KB. Algunas consideraciones: - Si se est generando para .NET, adems de compilar el web panel WFMain se debe compilar todos los objetos con prefijo WFWS. - Para trabajar con documentos en Java es necesario copiar las clases que se encuentran en <GXFlow90>GXFlowClientApplicationFilesJavaUpload (donde <Gxflow90> es el directorio de instalacin de GXflow 9.0) en el directorio donde se encuentran las clases de la aplicacin en el motor de servlets.

Pgina 5 de 23

Manual de instalacin

Setup Wizard de GXflow Protection Service

Ejecute el setup wizard de GXflow Protection Service. Para ello ejecute la aplicacin GXFlowPrt91.exe GXFlowPrt91.msi. El primer paso de este setup wizard le mostrar una ventana de bienvenida, haga clic en el botn Next si desea continuar con la instalacin.

Luego podr visualizar el siguiente dilogo:

Pgina 6 de 23

Manual de instalacin

Este dilogo solicitar la informacin de usuario que le permitir personalizar la instalacin. Deber especificar el nombre de usuario, la organizacin a la que pertenece y si la instalacin ser utilizada slo por este usuario o por todas las personas que comparten la mquina en la cual se realiza la instalacin.

Pgina 7 de 23

Manual de instalacin

Una vez ingresados los datos mencionados, haga clic en el botn Next para mostrar el siguiente dilogo:

Este dilogo solicitar el directorio de instalacin de GXflow Protection Service. El servicio de proteccin debe ser instalado en el directorio raz del servidor web en el cual se ejecutar, el directorio raz del servidor web IIS es sugerido automticamente. Puede especificar otro haciendo clic en el botn Browse. En caso de que se quiera instalar el servicio de proteccin en otro servidor web distinto al IIS, es necesario configurar dicho servidor para que soporte CGI. Una vez elegido el directorio de instalacin y haciendo clic en el botn Next, se mostrar un dilogo avisando que se comenzar a instalar GXflow Protection Service. En este punto podr optar por reingresar la informacin que fue solicitada en los pasos anteriores, haciendo clic en el botn Back, confirmarla e iniciar la instalacin, haciendo clic en el botn Next.

Pgina 8 de 23

Manual de instalacin

Si la instalacin fue exitosa se mostrar un dilogo indicando que la instalacin ha culminado con xito. La instalacin crea un grupo de programas, llamado GXflow Protection Service 9.1, que contiene los siguientes elementos: GeneXus License Manager y una utilidad de test.

Pgina 9 de 23

Manual de instalacin Al finalizar la instalacin, se mostrar un mensaje advirtiendo que se debe tener instalado GeneXus Protection Server antes de empezar a utilizar GXflow.

Una vez finalizada la instalacin de GXflow Protection Service, verifique que el directorio virtual GXflowProtectionService9 no requiera autenticacin. Dicho directorio se puede localizar en: IISDir\wwwroot\GXflowProtectionService9, donde IISDir es el directorio de instalacin del servidor web IIS.

Setup Wizard de GXflow

Ejecute el setup wizard de GXflow. Para ello ejecute la aplicacin GXflow90. El primer paso de este setup mostrar un dilogo de bienvenida similar al del setup anterior.

Pgina 10 de 23

Manual de instalacin

Haciendo clic en Next se mostrar el dilogo para establecer la informacin de usuario.

Haga clic en el botn Next para seleccionar el directorio de instalacin.

Pgina 11 de 23

Manual de instalacin

Una vez establecido el directorio de instalacin haga clic en el botn Next para obtener el siguiente dilogo:

Pgina 12 de 23

Manual de instalacin En este dilogo deber especificar si desea actualizar GeneXus 9.0 con los tipos de datos workflow. Es necesario que GeneXus sea actualizado, si an no lo est, con estos tipos de datos, para poder desarrollar aplicaciones con GXflow. En caso de que decida actualizar una instalacin de GeneXus, deber marcar el check box correspondiente y especificar el directorio donde reside la instalacin de GeneXus 9.0. Automticamente se selecciona el directorio de instalacin de GeneXus 9.0 en la mquina local. Si este directorio no coincide con el de la instalacin a actualizar, haga clic en el botn Browse para seleccionarlo manualmente. Una vez establecida esta informacin haga clic en el botn Next para comenzar con el proceso de instalacin. Si la instalacin fue exitosa, se mostrar un dilogo indicando que la misma ha culminado con xito. La instalacin crea un grupo de programas, llamado GXflow 9.0, el cual incluye el GeneXus License Manager y GXPM (GeneXus Process Modeler), herramienta con la cual se modelan los procesos de workflow.

Pgina 13 de 23

Manual de instalacin

Autorizacin
Antes de poder usar GXflow se deber realizar la autorizacin del GXflow Protection Service y de GXPM (GeneXus Process Modeler). A continuacin se detallan los pasos que debe seguir para la autorizacin de ambos productos.

Autorizacin de GXflow Protection Service

1. 2. Ejecute el GeneXus License Manager que se encuentra en el men de programas de GXflow Protection Service o el programa Gxlmgr.exe que se encuentra en el directorio donde se instal GXflow Protection Service. Solicite la clave al sitio de Artech a. Haga clic en el botn Authorize

Pgina 14 de 23

Manual de instalacin

b. Seleccione Request Licenses y haga clic en el botn Next

c.

Seleccione Authorize Online y haga clic en el botn Next

Pgina 15 de 23

Manual de instalacin

Pgina 16 de 23

Manual de instalacin

d. Seleccione el item GXflow Client Application y haga clic en el botn Finish.

Pgina 17 de 23

Manual de instalacin

e.

En este punto se abrir automticamente un formulario web para realizar la solicitud de claves al sitio de ARTech. En particular deber especificar una direccin de e-mail, la cual se utilizar para recibir las claves, y la cantidad de usuarios finales de la aplicacin cliente de GXflow.

3.

Una vez que reciba las claves va e-mail, haga doble clic en el archivo adjunto para completar la autorizacin.

Pgina 18 de 23

Manual de instalacin

4.

Para que los usuarios puedan acceder a la aplicacin cliente de GXflow, es necesario que sean nominados. Para ello nuevamente utilizaremos el License Manager de GXflow Protection Service: a. Haga clic en el botn Authorized users del GeneXus License Manager

b. Haga clic en el botn Add para dar de alta nuevos usuarios. En Unassigned users podr ver la cantidad de usuarios que todava puede nominar. Esta cantidad depende del nmero de usuarios que solicit a la hora de solicitar la clave de GXflow Protection Service.

Pgina 19 de 23

Manual de instalacin

Pgina 20 de 23

Manual de instalacin

c. Podr realizar una prueba para ver si los usuarios que ingres fueron debidamente nominados a travs de la utilidad de test. Esta utilidad se incluye en el grupo de programas de la instalacin de GXflow Protection Service.

Pgina 21 de 23

Manual de instalacin

Autorizacin de GXPM (GeneXus Process Modeler)

Ejecute el GeneXus License Manager que se encuentra en el men de programas de GXflow, el programa Gxlmgr.exe que se encuentra en el directorio donde se instal GXflow. A continuacin siga los pasos para solicitar las claves como lo hizo para autorizar GXflow. Protection Service. Recuerde que GXPM no requiere el paso de nominacin de usuarios.

Consideraciones luego de la instalacin

Impacto en DB2 UDB - Para poder hacer la reorg. GeneXus de las tablas de GXflow en una base de datos DB2 UDB, es necesario que dicha base posea un table space cuyo tamao de pginas sea de 8KB o mayor. - Para poder impactar diagramas en DB2 UDB es necesario tener instalado, en la mquina donde se ejecuta GXPM, el Proveedor de datos de IBM DB2 para .NET Framework 2.0. Este proveedor se incluye en el IBM DB2 Runtime Client 9.0. - Al hacer el impacto en DB2 UDB puede presentarse el error: "Not enough storage is available in the application heap to process the statement". En ese caso es necesario configurar la base de datos para que utilice un tamao de heap de aplicacin mayor, as como tambin un tamao de archivo de log mayor. Para ello se pueden ejecutar los siguientes comandos DB2 sobre dicha base: update database configuration for <NOMBRE_BD> using applheapsz 8192 update database configuration for <NOMBRE_BD> using app_ctl_heap_sz 8192 update database configuration for <NOMBRE_BD> using LOGFILSIZ 4000 Impacto en DB2 ISeries - Para que las tablas de GXflow se creen correctamente en una base DB2 ISeries es necesario modificar la longitud mxima de los dominios WFXML y CALvch a 26 KB. - Si se desea consolidar el XPZ de GXflow en una KB con nombres cortos, es necesario utilizar la regla de consolidacin ShortNames.gmr que se encuentra en el mismo directorio que el XPZ de la KB de workflow. Impacto en Oracle Antes de reorganizar la base de datos con las tablas de GXflow, se debe tener en cuenta lo que se comenta en el SAC# 19628. Impacto en MySQL - Para poder impactar en MySQL se deben seguir los siguientes pasos: - Copiar la biblioteca libmysql.dll incluida en el directorio <MySQL>/bin al directorio <GXflow85>/ri, donde <MYSQL> es la ubicacin donde est instalado el servidor de MySQL y <GXflow85> el directorio de instalacin de GXflow 8.5. Otra alternativa

Pgina 22 de 23

Manual de instalacin es registrar esa dll en la mquina donde est instalado GXflow. - Editar el archivo Machine.config ubicado en <.NET Framework 2.0>/CONFIG, debajo del elemento <system.data>/<DbProviderFactories> agregar lo siguiente: <add name="MySQLDriverCS" invariant="MySQLDriverCS" description="MySQDriverCS " type="MySQLDriverCS.MySQLFactory, MySQLDriverCS, Version=3.0, Culture=neutral" />

Pgina 23 de 23