Está en la página 1de 6

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 http://www.gxtechnical.com/gxdlsp/pub/genexus/java/docum/manuals...

Application URL 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.
Ask Application URL Permite indicar si en el Setup se va a permitir que se
modifique la URL de la aplicación antes de instalarla.
Overwrite existing Permite indicar si se desea sobreescribir la versión
GXWS instalada en el cliente, aunque sea una version más
nueva.
Interpreter Options 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 properties 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’
Use Debug version of GX Permite indicar que la aplicación debe utilizar las classes
standard classes de runtime de debug (GXClassD) en vez de las normales,
con lo cual la aplicación va a generar logs.
Use custom GXWS Client Por defecto la instalación del GeneXus Web Start, en los
Location 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.
Install in ‘All users’ 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.
Split Main Jar in Habilita que se copien las clases por separado en vez de
classes copiarse el .JAR de la aplicación al directorio destino.
GXWS Client Permite indicar el path de instalación en el cliente.
Location

5 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...

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