Você está na página 1de 23
9.0 Manual de instalación Enero, 2008 CHICAGO – USA MONTEVIDEO – URUGUAY Av. 18 de

9.0

Manual de instalación

Enero, 2008

9.0 Manual de instalación Enero, 2008 CHICAGO – USA MONTEVIDEO – URUGUAY Av. 18 de Julio

CHICAGO USA

MONTEVIDEO URUGUAY Av. 18 de Julio 1645 P.4 - (5982) 402 2082

MEXICO CITY MEXICO

SÃO PAULO BRAZIL Rua Samuel Morse 120 Conj. 141 - (5511) 5502 6722

400 N. Michigan Ave. Suite 1600 - (312) 836 9152

Leibnitz N° 20, Desp. 801 - Del Miguel Hidalgo - (5255) 5255 4733

Manual de instalación

Manual de instalación

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 información 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 dueños.

Manual de instalación

Manual de instalación

INDICE

INTRODUCCIÓN

4

REQUERIMIENTOS DEL SISTEMA

4

INSTALACIÓN

5

SETUP WIZARD DE GXFLOW PROTECTION SERVICE

6

SETUP WIZARD DE GXFLOW

10

AUTORIZACIÓN

14

AUTORIZACIÓN DE GXFLOW PROTECTION SERVICE

14

AUTORIZACIÓN DE GXPM (GENEXUS PROCESS MODELER)

22

CONSIDERACIONES LUEGO DE LA INSTALACIÓN

22

Manual de instalación

Manual de instalación

Introducción

Los objetivos de este documento son:

Describir los requerimientos básicos de software necesarios para la instalación de GXflow

Describir paso a paso el proceso de instalación 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 máquina accesible a través 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 Ejecución:

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 versión no se soporta la integridad referencial en la base de datos.

Manual de instalación

Manual de instalación

Instalación

La instalación de GXflow se compone de 3 etapas. La primera etapa consiste en la instalación del GXflow Protection Service 9.1. Este servicio de protección es necesario, debido a que el motor de workflow lo utiliza para verificar que los usuarios que acceden a las aplicaciones estén 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 máquina accesible a través de la red.

La segunda etapa consiste en la instalación 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 instalación como se describe

a continuación.

Para terminar debe consolidar los objetos de workflow en su base de conocimiento, el xpz lo puede encontrar en <dir_instalación_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_instalación_GXflow>/KB

2)

Presionar el botón “Advanced” y luego el botón “Adapt From”

3)

Presionar el botón “Open” y elegir el archivo “ShortNames.GMR” que se encuentra en

4)

<dir_instalación_GXflow>/KB para luego poder aplicar las reglas que contiene ese archivo Presionar el botón “Apply Rules” y luego el botón “OK” para continuar con la consolidación

5)

Para iniciar la consolidación presionar el botón “OK”

Luego debe hacer un Build All de la KB.

Algunas consideraciones:

- Si se está generando para .NET, además 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 instalación de GXflow 9.0) en el directorio donde se encuentran las clases de la aplicación en el motor de servlets.

Manual de instalación

Manual de instalación

Setup Wizard de GXflow Protection Service

el

GXFlowPrt91.msi”.

Ejecute

setup

wizard

de

GXflow

Protection

Service.

Para

ello

ejecute

la

aplicación

GXFlowPrt91.exe

ó

El primer paso de este setup wizard le mostrará una ventana de bienvenida, haga clic en el botón “Next” si desea continuar con la instalación.

botón “Next” si desea continuar con la instalación. Luego podrá visualizar el siguiente diálogo: Página 6

Luego podrá visualizar el siguiente diálogo:

Manual de instalación

Manual de instalación

Manual de instalación Este diálogo solicitará la información de usuario que le permitirá personalizar la

Este diálogo solicitará la información de usuario que le permitirá personalizar la instalación. Deberá especificar el nombre de usuario, la organización a la que pertenece y si la instalación será utilizada sólo por este usuario o por todas las personas que comparten la máquina en la cual se realiza la instalación.

Manual de instalación

Manual de instalación

Una vez ingresados los datos mencionados, haga clic en el botón “Next” para mostrar el siguiente diálogo:

en el botón “Next” para mostrar el siguiente diálogo: Este diálogo solicitará el directorio de instalación

Este diálogo solicitará el directorio de instalación de GXflow Protection Service. El servicio de protección debe ser instalado en el directorio raíz del servidor web en el cual se ejecutará, el directorio raíz del servidor web IIS es sugerido automáticamente. Puede especificar otro haciendo clic en el botón “Browse”. En caso de que se quiera instalar el servicio de protección en otro servidor web distinto al IIS, es necesario configurar dicho servidor para que soporte CGI.

Una vez elegido el directorio de instalación y haciendo clic en el botón “Next”, se mostrará un diálogo avisando que se comenzará a instalar GXflow Protection Service. En este punto podrá optar por reingresar la información que fue solicitada en los pasos anteriores, haciendo clic en el botón “Back”, ó confirmarla e iniciar la instalación, haciendo clic en el botón “Next”.

Manual de instalación

Manual de instalación

Manual de instalación Si la instalación fue exitosa se mostrará un diálogo indicando que la instalación

Si la instalación fue exitosa se mostrará un diálogo indicando que la instalación ha culminado con éxito. La instalación crea un grupo de programas, llamado “GXflow Protection Service 9.1”, que contiene los siguientes elementos: GeneXus License Manager y una utilidad de test.

Service 9.1 ”, que contiene los siguientes elementos: GeneXus License Manager y una utilidad de test.
Manual de instalación

Manual de instalación

Al finalizar la instalación, se mostrará un mensaje advirtiendo que se debe tener instalado “GeneXus Protection Server” antes de empezar a utilizar GXflow.

Protection Server” antes de empezar a utilizar GXflow. Una vez finalizada la instalación de GXflow Protection

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

Setup Wizard de GXflow

Ejecute el setup wizard de GXflow. Para ello ejecute la aplicación GXflow90. El primer paso de este setup mostrará un diálogo de bienvenida similar al del setup anterior.

GXflow90. El primer paso de este setup mostrará un diálogo de bienvenida similar al del setup
Manual de instalación

Manual de instalación

Haciendo clic en “Next” se mostrará el diálogo para establecer la información de usuario.

el diálogo para establecer la información de usuario. Haga clic en el botón “Next” para seleccionar

Haga clic en el botón “Next” para seleccionar el directorio de instalación.

Manual de instalación

Manual de instalación

Manual de instalación Una vez establecido el directorio de instalación haga clic en el botón “Next”

Una vez establecido el directorio de instalación haga clic en el botón “Next” para obtener el siguiente diálogo:

el directorio de instalación haga clic en el botón “Next” para obtener el siguiente diálogo: Página
Manual de instalación

Manual de instalación

En este diálogo deberá especificar si desea actualizar GeneXus 9.0 con los tipos de datos workflow. Es necesario que GeneXus sea actualizado, si aún no lo está, con estos tipos de datos, para poder desarrollar aplicaciones con GXflow. En caso de que decida actualizar una instalación de GeneXus, deberá marcar el check box correspondiente y especificar el directorio donde reside la instalación de GeneXus 9.0. Automáticamente se selecciona el directorio de instalación de GeneXus 9.0 en la máquina local. Si este directorio no coincide con el de la instalación a actualizar, haga clic en el botón “Browse” para seleccionarlo manualmente. Una vez establecida esta información haga clic en el botón “Next” para comenzar con el proceso de instalación.

Si la instalación fue exitosa, se mostrará un diálogo indicando que la misma ha culminado con éxito. La instalación 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.

y GXPM (GeneXus Process Modeler), herramienta con la cual se modelan los procesos de workflow. Página
Manual de instalación

Manual de instalación

Autorización

Antes de poder usar GXflow se deberá realizar la autorización del GXflow Protection Service y de GXPM (GeneXus Process Modeler).

A continuación se detallan los pasos que debe seguir para la autorización de ambos productos.

Autorización de GXflow Protection Service

1. 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”.

2. Solicite la clave al sitio de Artech

a. Haga clic en el botón “Authorize”

Protection Service”. 2. Solicite la clave al sitio de Artech a. Haga clic en el botón
Manual de instalación

Manual de instalación

b. Seleccione “Request Licenses” y haga clic en el botón “Next”

“Request Licenses” y haga clic en el botón “Next” c. Seleccione “Authorize Online” y haga clic

c. Seleccione “Authorize Online” y haga clic en el botón “Next”

Manual de instalación

Manual de instalación

Manual de instalación Página 16 de 23
Manual de instalación

Manual de instalación

d. Seleccione el item “GXflow Client Application” y haga clic en el botón “Finish”.

d. Seleccione el item “GXflow Client Application” y haga clic en el botón “Finish”. Página 17
Manual de instalación

Manual de instalación

e. En este punto se abrirá automáticamente un formulario web para realizar la solicitud de claves al sitio de ARTech. En particular deberá especificar una dirección de e-mail, la cual se utilizará para recibir las claves, y la cantidad de usuarios finales de la aplicación cliente de GXflow.

de usuarios finales de la aplicación cliente de GXflow. 3. Una vez que reciba las claves

3. Una vez que reciba las claves vía e-mail, haga doble clic en el archivo adjunto para completar la autorización.

Manual de instalación

Manual de instalación

4. Para que los usuarios puedan acceder a la aplicación cliente de GXflow, es necesario que sean nominados. Para ello nuevamente utilizaremos el License Manager de GXflow Protection Service:

a. Haga clic en el botón “Authorized users” del “GeneXus License Manager”

“ Authorized users” del “ GeneXus License Manager” b. Haga clic en el botón “Add” para
“ Authorized users” del “ GeneXus License Manager” b. Haga clic en el botón “Add” para

b. Haga clic en el botón “Add” para dar de alta nuevos usuarios. En “Unassigned users” podrá ver la cantidad de usuarios que todavía puede nominar. Esta cantidad depende del número de usuarios que solicitó a la hora de solicitar la clave de GXflow Protection Service.

Manual de instalación

Manual de instalación

Manual de instalación Página 20 de 23
Manual de instalación

Manual de instalación

c. Podrá realizar una prueba para ver si los usuarios que ingresó fueron debidamente nominados a través de la utilidad de test. Esta utilidad se incluye en el grupo de programas de la instalación de “GXflow Protection Service”.

Esta utilidad se incluye en el grupo de programas de la instalación de “GXflow Protection Service”.
Manual de instalación

Manual de instalación

Autorización 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 continuación siga los pasos para solicitar las claves como lo hizo para autorizar GXflow. Protection Service. Recuerde que GXPM no requiere el paso de nominación de usuarios.

Consideraciones luego de la instalación

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 tamaño de páginas sea de 8KB o mayor.

- Para poder impactar diagramas en DB2 UDB es necesario tener instalado, en la máquina 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 tamaño de heap de aplicación mayor, así como también un tamaño 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 máxima 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 consolidación 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 ubicación donde está instalado el servidor de MySQL y <GXflow85> el directorio de instalación de GXflow 8.5.

Otra alternativa

Manual de instalación

Manual de instalación

es registrar esa dll en la máquina 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" />