Java (G) - GeneXus Web Start Deployment http://www.gxtechnical.com/gxdlsp/pub/genexus/java/docum/manuals...

GeneXus Web Start Deployment

Introducción
GeneXus Web Start Deployment (GXWS Deployment) es un utilitario que aprovecha y ofrece la
tecnología Web Start de Java.

Este utilitario permite seleccionar objetos main, empaquetar todas las clases implicadas a los
mismos, y crear una página HTML con un link por cada objeto main.

Cuando el usuario final quiera ejecutar la aplicación, deberá seleccionar en la página HTML el
link al objeto main deseado, y en ese momento se verificará si la versión local de la aplicación
es la misma que la versión del servidor.

En caso de no coincidir las versiones, se transferirá desde el servidor, las partes de la

aplicación o dependencias que se hayan modificado y seguidamente, se procederá a la
ejecución del objeto Main seleccionado.

Tener en cuenta que no se transfiere al cliente toda la aplicación nuevamente, sino que se
bajan sólo aquellas clases que hayan sido actualizadas.

Cada vez que el desarrollador tiene una nueva versión de la aplicación Java para poner en
producción, realiza lo siguiente:

1. Con el GeneXus Web Start Deployment actualiza la versión del deployment en el

servidor.

2. El usuario final ejecuta la aplicación, y si es la primera vez, se baja toda, mientras que
las siguientes veces, se bajan solo las clases actualizadas; acto seguido a la actualización
de la aplicación en el cliente, se ejecuta la misma.

Configuración
El GeneXus Web Start Deployment consta de una sola pantalla con 2 TABS: General y
Advanced.

TAB GENERAL

1 de 6 23/09/2010 11:18 a.m.

PDF created with pdfFactory Pro trial version www.pdffactory.com
Java (G) - GeneXus Web Start Deployment http://www.gxtechnical.com/gxdlsp/pub/genexus/java/docum/manuals...

En el TAB General del GeneXus Web Start Deployment, se encuentran las siguientes opciones
a configurar:

VM Permite indicar la máquina virtual con la que se desea

ejecutar la aplicación, a partir del deployment que se
está armando. Las opciones son Microsoft y Sun. La
selección de una opción u otra es independiente de la
máquina virtual con la que se ejecute este wizard.
Include Dependencies Marcando esta opción, se permite agregar una lista de
archivos adicionales que sean necesarios para que
ejecute la aplicación.
Dependencies Si se selecciona Include Dependencies, se habilita
subpath este campo, para indicar el subpath al cual se
transferirán los archivos adicionales.
El subpath es con respecto al Target Directory que se
indica en el Deployment Wizard. Este subpath puede ser
compartido por varias aplicaciones, por lo cual los
archivos podrán ser compartidos entre las mismas. Si no
se especifica nada en este campo, se transferirán al
Target Directory seteado en el Deployment Wizard.

2 de 6 23/09/2010 11:18 a.m.

PDF created with pdfFactory Pro trial version www.pdffactory.com
Java (G) - GeneXus Web Start Deployment http://www.gxtechnical.com/gxdlsp/pub/genexus/java/docum/manuals...

Include ‘Client.cfg’ Permite indicar si el archivo Client.cfg será incluído

dentro del JAR de la aplicación o no. El archivo
Client.cfg contiene la información de conexión a la base
de datos, cuando se trata de aplicaciones en 2 capas, y
la información de conexión al servidor de aplicaciones
cuando se trata de aplicaciones en 3 capas. La
aplicación, en tiempo de ejecución, toma de este archivo
la información de conexión.
Si el archivo Client.cfg no se incluye dentro del JAR,
cada vez que se ejecute la aplicación, se obtendrá el
mismo del directorio donde quede el deployment armado
en el servidor.
Application name Es el nombre que se utiliza como clave para comparar
de qué aplicación se trata, y luego se pasa a comparar el
número de versión (entre servidor y cliente). No se
debe modificar este nombre cuando se arme cada vez el
deployment con los cambios de una aplicación, ya que si
se cambia, se debe tener claro que la siguiente vez se
instalará toda la aplicación, por tener un nombre nuevo,
que obviamente no existirá en el cliente.
Description Permite ingresar una descripcion de la aplicacion. Es
opcional.
Vendor Permite ingresar el nombre del responsable de la
aplicación. Es opcional.
Version Consta de 4 números, y es lo que permite realizar la
comparación de versiones del cliente y servidor,
determinando si se tiene que actualizar la aplicación, o
no.
Autoincrement Permite indicar que cada vez que se ejecute este wizard,
version se auto-incremente en uno el último número de la
versión. En general este es el comportamiento deseado,
dado que si no se cambia el número de la versión, no se
instalará la nueva versión en el cliente. Si por alguna
razón se desea dejar el número anterior, hay que
desmarcar esta opción.
Include Virtual Esta opción solo se muestra al seleccionar Microsoft
Machine como VM (máquina virtual / virtual machine) de
ejecución. Indica si se desea instalar la VM en el cliente.
Una vez seleccionada esta opción se puede elegir entre
instalar la VM actual (la versión que se esta utilizando
en ese momento) o una versión específica. Se debe
copiar manualmente al servidor el .exe de la misma.

TAB ADVANCED

3 de 6 23/09/2010 11:18 a.m.

PDF created with pdfFactory Pro trial version www.pdffactory.com
Java (G) - GeneXus Web Start Deployment http://www.gxtechnical.com/gxdlsp/pub/genexus/java/docum/manuals...

En el TAB Advanced del GeneXus Web Start Deployment, se encuentran las siguientes opciones
a configurar:

Create Setup Indica si se desea generar un setup para instalar el

deployment armado.
Target Directory Si se selecciona Create Setup, se habilita este campo,
para indicar el directorio donde se copiarán los archivos
del Setup. Si se desea copiar a un CD, se debe copiar todo
lo que queden en este directorio. Si se copia este
directorio en la raíz del CD, el setup se disparará
automáticamente al insertar el CD en el lector.
Install Virtual Si se selecciona Create Setup, se habilita este campo,
Machine para indicar si se desea instalar la máquina virtual en caso
de que no exista en el cliente (o de que tenga una versión
anterior). Esta opción que ofrece instalar la máquina
virtual es válida tanto para máquina virtual de MS como
de SUN.
VM Location Permite especificar la ubicación del ejecutable de
instalación de la máquina virtual. Este archivo será
transferido al Target Directory que se indica en el
Deployment Wizard.

4 de 6 23/09/2010 11:18 a.m.

PDF created with pdfFactory Pro trial version www.pdffactory.com
Java (G) - GeneXus Web Start Deployment
Application URL
Ask Application URL
Overwrite existing
GXWS
Interpreter Options
GXWS properties
Use Debug version of GX
standard classes
Use custom GXWS Client
Location
Install in ‘All users’
Split Main Jar in
classes
GXWS Client
Location
5 de 6
PDF created with pdfFactory Pro trial version www.pdffactory.com
http://www.gxtechnical.com/gxdlsp/pub/genexus/java/docum/manuals...
Permite especificar la URL del servidor HTTP donde va a
residir la aplicación y futuras acutalizaciones de la misma.
Si en el momento de crear el Setup no se conoce la
ubicación final del servidor, se debe dejar HTTP:// o
FILE://, y debe setearse Ask Application URL para que
la ingrese el usuario final.
Permite indicar si en el Setup se va a permitir que se
modifique la URL de la aplicación antes de instalarla.
Permite indicar si se desea sobreescribir la versión
instalada en el cliente, aunque sea una version más
nueva.
Permite especificar ciertas opciones de ejecución que se
deseen pasar al intérprete cada vez que se ejecute la
aplicación. El formato de esta lista de opciones debe ser el
siguiente: ‘opcion=argumento’, separados por punto y
coma. Por ejemplo: option1=data1;option2=data2
Esta lista de items, se pasa a la aplicación, cada vez que
se ejecute.
GXWS admite parámetros opcionales para configurar
propiedades. Por ejemplo, con ‘/W:autoclose’ se permite
indicar el autocierre de la ventana del browser luego de
levantar la aplicación.
Otra utilidad es que toda aplicación Java, sea generada
por GeneXus o no, tiene un conjunto de propiedades del
sistema. GXWS permite agregar una propiedad de nombre
ApplicationVersion cuyo valor es una secuencia de
caracteres que contiene la versión, por ejemplo ‘1.0.0.15’.
Esto puede ser útil para saber, por ejemplo, en qué
versión está actualmente cada cliente. Para aplicar esta
property, usar
‘/C:SetVersionInSystemProperty=true’
Permite indicar que la aplicación debe utilizar las classes
de runtime de debug (GXClassD) en vez de las normales,
con lo cual la aplicación va a generar logs.
Por defecto la instalación del GeneXus Web Start, en los
clientes, se efectúa bajo el directorio
‘$APP_DATA/GeneXus Web Start’, si bien la ubicación de
este directorio, depende de la versión de windows de cada
PC. Si por alguna otra razón se desea que la instalación se
realice en una ubicación específica, se debe activar este
checkbox, e indicar el path específico en el campo GXWS
Client Location.
En plataformas Microsoft con un esquema de usuarios
definido, ‘All Users’ es un directorio compartido sobre el
que todos los usuarios tienen permisos de lectura y
ejecución. Con esta opción, la instalación no se hace en el
directorio de trabajo del usuario de la aplicación, y se
logra que esté disponible para todos los usuarios.
Habilita que se copien las clases por separado en vez de
copiarse el .JAR de la aplicación al directorio destino.
Permite indicar el path de instalación en el cliente.
23/09/2010 11:18 a.m.
Java (G) - GeneXus Web Start Deployment http://www.gxtechnical.com/gxdlsp/pub/genexus/java/docum/manuals...

Custom directory Puede seleccionarse esta opción seleccionando Use

name in server custom directory name in server.

Botón DCOM Client Configuration

Cuando se hace un GXWS Deployment de una aplicacion 3 capas, y el protocolo utilizado es
DCOM, se permite configurar ciertos parámetros adicionales para esta tecnología.

En el TAB General, al hacer clic en el botón Build Archives, se da comienzo a la actualización

del .JAR de la aplicación y a la transferencia de los archivos al servidor.

Si ocurre algún error, se desplegará un mensaje en la Barra de Status.

6 de 6 23/09/2010 11:18 a.m.

PDF created with pdfFactory Pro trial version www.pdffactory.com