GeneXus Application Setup Wizard

Febrero 2002

Objetivo __________________________________________________________________ 3 Caractersticas implementadas _______________________________________________ 3

Versin 7.5 ______________________________________________________________________ 3 Versin 3.0 ______________________________________________________________________ 3 Versin 2.3 ______________________________________________________________________ 4

Aspectos a tener en cuenta para distribuir aplicaciones___________________________ 7

Vista rpida del Windows Installer ____________________________________________________ 7 Administracin de setups____________________________________________________________ 7 Generacin del Setup de un producto __________________________________________________ 8 Generacin del Setup de una actualizacin de un producto _________________________________ 8 Instalacin de un producto __________________________________________________________ 9 Actualizacin de un producto ________________________________________________________ 9 Instalacin de una aplicacin en red (instalacin administrativa) ____________________________ 10 Actualizacin de una aplicacin en red ________________________________________________ 12 Instalacin de una aplicacin Visual Basic con interface Web ______________________________ 12 Actualizacin de una aplicacin Visual Basic con interface Web____________________________ 13

Descripcin de la aplicacin ________________________________________________ 14

Source _________________________________________________________________________ 14 Setup __________________________________________________________________________ 15 Files to include __________________________________________________________________ 16 Call Program ____________________________________________________________________ 17 Applications and Program Group ____________________________________________________ 19 Setup Options ___________________________________________________________________ 19 Files to copy ____________________________________________________________________ 21

Consideraciones generales __________________________________________________ 22

Instalacin del Setup Wizard________________________________________________________ 22 Generacin de Setups _____________________________________________________________ 22 Instalacin/Desinstalacin de aplicaciones _____________________________________________ 23

Requerimientos importantes a partir de la version 1.4.3 _________________________ 25

Objetivo
El Setup Wizard provee una nica interfase para la exportacin de aplicaciones generadas para lenguajes visuales. Desde el Setup Wizard se pueden generar setups para aplicaciones FoxPro for Windows, Visual FoxPro y Visual Basic. Brinda la posibilidad de generar automticamente un setup profesional de la aplicacin generada. Permite realizar actualizaciones de la aplicacin, manteniendo el estado de la instalacin actualizado en las mquinas donde est instalado el producto.

Caractersticas implementadas
Versin 7.5
Generacin de instaladores para la Versin 7.5 de GeneXus De esta manera se incluyen todos aquellos archivos necesarios para trabajar con esta nueva versin de GeneXus. Generacin de instaladores para aplicaciones Visual Basic con interface Web Al momento de poner en produccin una aplicacin Web, se deben tener en cuenta un cierto numero de factores. En esta nueva versin del Setup Wizard se automatiza dicho proceso, haciendo ms accesible esta tarea. Posibilidad de generar instaladores en distintos idiomas Se incluyen la posibilidad de realizar instalaciones no solo en ingles, si no tambin en portugus, italiano y espaol. Soporte de Visual Fox Pro 7.0 A partir de esta versin se pueden hacer paquetes de instalacin de aplicaciones generadas con el generador Visual Fox Pro para el lenguaje Visual Fox Pro 7.0.

Versin 3.0
Generacin de instaladores para Windows Installer La generacin para Windows Installer tiene la ventaja que los instaladores corren sobre esta nueva tecnologa de Microsoft que es mucho ms robusta que las formas que hubo hasta ahora para realizar las instalaciones. Por ms informacin sobre el Windows Installer ver la seccin Vista rpida del Windows Installer en este mismo documento. Generacin de parches La generacin de parches de una aplicacin permite generar actualizaciones a medida de una aplicacin (llevando solo los archivos nuevos o actualizados). El SW resuelve automticamente cules archivos deben formar parte del parche, no siendo necesario por parte del usuario el preocuparse en determinar cules son los archivos que debe distribuir para actualizar su aplicacin.

Generacin de instaladores para aplicaciones que utilizan el formato de datos de Access 2000 A partir de la versin 7.0 de GeneXus, las aplicaciones generadas para Visual Basic utilizando base de datos Access pueden utilizar el formato de datos de Access 2000 (DAO 3.60). A partir de esta versin es posible generar setups de aplicaciones que utilicen esta versin del DAO. Generacin de instaladores para aplicaciones que utilizan la grilla Microsoft DataGrid Control A partir de la versin 7.0 de GeneXus, las aplicaciones generadas para Visual Basic pueden utilizar la grilla Microsoft DataGrid Control para manejar subfiles. A partir de esta versin es posible generar setups de aplicaciones que utilicen este control. Generacin de instalacin administrativa Las intalaciones administrativas son una nueva caracterstica del Windows Installer. Permiten mantener centralizada la administracin de un instalador y actualizar las estaciones de trabajo desde el mismo. Aprovechando esta funcionalidad se implementaron los setups de nodo (disponibles hasta ahora como instaladores independientes). Es as que desde ahora todo instalador generado por el Setup Wizard puede ser utilizado tanto para instalar localmente la aplicacin como para instalarla de forma de ejecutarla desde la red.

Versin 2.3
Distribucin de fonts Se da la posibilidad de distribuir fonts con el setup. La utilidad de esta feature es distribuir fonts especiales. Hay que tener en cuenta que por lo general las fonts que usan las aplicaciones son instaladas por el propio Windows, por lo que normalmente no es necesario distribuir ninguna font. En caso de distribuir fonts, se incluyen tanto en el setup de la aplicacin como en el setup de nodo (en caso que se est generando este ltimo). Esto es debido a que ser necesario instalarlas en ambas instalaciones para que la aplicacin funcione correctamente. En el paso 2 del Setup Wizard, hay un list box titulado Special Fonts, que muestra la lista de fonts a distribuir con el setup. Hay dos botones, uno que permite agregar fonts a la lista (<) y otro que permite eliminar fonts de la misma (>). Para agregar fonts, se muestra un dilogo que muestra las fonts instaladas en la mquina. Las fonts aparecen por nombre de archivo y no por nombre de font, por lo que es necesario conocer el nombre de archivo de la font a distribuir (yendo a Fuentes en el Panel de Control, es posible obtener el nombre del archivo correspondiente a la fuente). Para eliminar una fuente, es necesario seleccionar la fuente de la lista y luego presionar el botn >. Posibilidad de llamar a un programa (.exe o .bat) al finalizar la ejecucin del setup Al finalizar la instalacin de la aplicacin, se da la posibilidad de llamar a un programa.

Por ejemplo, un programa que podra hacer configuraciones especiales, instalar o copiar controles adicionales, etc. Si se especifica tal opcin, el programa ser llamado tanto al finalizar un setup de aplicacin, como de un setup de nodo. En el paso 2 es posible ingresar el nombre del programa que ser llamado al finalizar la instalacin. Tambin se da la posibilidad de especificar parmetros que le sern pasados cuando ste sea ejecutado. Cuando se est instalando la aplicacin, al finalizar la copia y registracin de archivos, y creacin del grupo de programas e conos se ejecuta el programa. Esto se hace en forma sincrnica, o sea, se espera a que ste termine antes de que vuelva el control al setup que est siendo ejecutado. Es luego de que vuelve el control al setup, que se completa la instalacin pidiendo reiniciar el sistema si fuera necesario (en caso que hayan archivos en uso que deban ser actualizados). Es por esto que tal programa debe devolver el control al setup, no puede por ejemplo, reiniciar el sistema. Porque en tal caso la instalacin de la aplicacin no se realizara con xito. El programa es copiado en forma temporal al directorio de sistema de Windows (\Windows\System o similar). Soporte de modelos con n-generadores Se da la posibilidad de generar setups de aplicaciones visuales de modelos que tengan mas de un generador asociado (independientemente de cual sea el generador de la reorganizacin, el por defecto y los terciarios). En el paso 1 del Setup Wizard, se muestran en un combo box los generadores visuales que tiene el modelo seleccionado. Segn el generador que se elija, en el paso 3 se muestran los ejecutables que correspondan (solo los de ese generador). Generacin de archivos a una estructura de diskettes Cuando se genera el setup a disco, se da la posibilidad de organizar los archivos en directorios, como si fueran a copiarse a diskettes. Se genera una estructura \Disk1, \Disk2, bajo el directorio seleccionado. En el paso 1 del Setup Wizard hay un check box que permite seleccionar esta facilidad. Es posible seleccionar el tamao del diskette deseado, lo cual determina el tamao de los archivos CABs generados. La feature est implementada solo para aplicaciones 32 bits. Distribucin de Imgenes Es posible distribuir imgenes desde y hacia cualquier directorio. Ademas de los archivos con extensin .BMP y .ICO (como hasta la versin anterior), se consideran tambin los archivos con extensin .JPG, .TIF y .GIF. Por defecto se distribuyen desde/hacia el directorio del modelo/aplicacin. Hay dos grupos de imgenes que maneja el Setup Wizard: las que se encuentran en el directorio del modelo y las que estn en otro directorio que seleccione el usuario. Las del primer grupo siempre son exportadas hacia el directorio de la aplicacin.

En cambio, se da la posibilidad de instalar las del segundo grupo en un directorio diferente que el directorio origen (por defecto se instalan en el mismo directorio de donde se obtuvieron). Por ejemplo: Dir origen= dir modelo Dir origen= dir modelo\bmps Dir origen= dir c:\bmps Dir destino= dir aplicacin (no es posible cambiarlo) Dir destino= dir aplicacin\bmps (por defecto, es posible cambiarlo) Dir destino= dir c:\bmps (por defecto, es posible cambiarlo)

En el ejemplo, Dir origen se elige en el paso 2 del Setup Wizard y Dir destino se elige cuando se est instalando la aplicacin. En los dos ltimos casos tambin se distribuyen las imgenes que estn en el directorio del modelo y se instalan en el directorio de la aplicacin (siempre, no es posible cambiar este comportamiento).

Aspectos a tener en cuenta para distribuir aplicaciones

Vista rpida del Windows Installer
El Windows Installer es un administrador de instalaciones, es el encargado de realizar las mismas y administrarlas. Esta tarea ya no es realizada por un programa instalador en particular. El Windows Installer es parte del sistema operativo en Windows 2000. Aunque tambin es posible utilizarlo bajo Windows 9x y Windows NT 4.0. Un instalador de una aplicacin consta de los archivos que forman parte de la misma y una base de datos que tiene toda la informacin de la instalacin. Con estos recursos el Windows Installer realiza la instalacin. Adems de esto, mantiene informacin de todas las aplicaciones que fueron instaladas en la mquina y el estado de cada una de ellas. De esta forma tiene el control de los archivos que son instalados y conoce el estado de cada una de las instalaciones realizadas. Otra caracterstica importante es que controla que los archivos esenciales del sistema no sean daados. Mediante la generacin de parches es posible realizar actualizaciones a las instalaciones manteniendo el estado de las mismas actualizado, permitiendo reparar una instalacin corrupta y realizar desinstalaciones correctamente. El installer cuenta con otras caractersticas interesantes, tales como la posibilidad de reflejar la jerarqua que puede haber entre las caractersticas de la aplicacin en el instalador de la misma, y permitir a la hora de la instalacin, el seleccionar las caractersticas que el usuario desea instalar. Por ejemplo, un procesador de texto puede contener un corrector ortogrfico y un analizador gramatical, que son caractersticas que pueden ser utilizadas o no dependiendo de las necesidades del usuario. El installer permite reflejar esa jerarqua en el instalador y da la posibilidad al usuario de instalar las caractersticas que desea. Tambin hace posible la publicacin de aplicaciones, lo cual consiste en poner disponible una aplicacin a un usuario pero instalarla en la mquina del mismo recin cuando el usuario la requiera y no antes. Las anteriores son algunas de las caractersticas con las que cuenta el Installer.

Administracin de setups
Un setup determinado por <KB/Modelo/Generador/Nombre de Setup> se corresponde con el instalador de un producto. Esto quiere decir que ese setup ser mediante el cual se instale el producto y se realicen las actualizaciones del mismo. La primera vez que se genera un instalador para un producto, se genera el instalador para el estado actual. A la hora de generar una actualizacin, se genera un parche que actualiza el estado anterior al estado actual del mismo.

Por ejemplo, si se gener el instalador de una primera versin de un producto y luego una actualizacin a una segunda versin del mismo, el SW generar los siguientes directorios y contenidos: Directorio_Destino\Build1\ Directorio_Destino\Build2\ (Los directorios ..... \Buildn\..... corresponden a la n-sima generacin.) El directorio ......\Build1 contiene el instalador original de la aplicacin. Los directorios ......\Build2 - Buildn contienen el parche que actualiza la instalacin de la generacin anterior a la n-sima. Este parche puede ser aplicado nicamente a un producto que se encuentra en el estado de la generacin anterior. Tambin se genera un directorio Swinfo con subdirectorios BUILDn que tienen la informacin que necesita el SW para generar el siguiente parche. El contenido de estos directorios no debe ser alterado.

Generacin del Setup de un producto

Algunos puntos importantes a tener en cuenta: 1- Siempre hay que ponerle un nombre al setup ya que junto con la KB/Modelo/Generador, identificar al producto a distribuir. De esta forma el wizard podr determinar cundo se est generando una distribucin de un nuevo producto y cundo se est generando una actualizacin de uno existente. 2- Para cada producto se debe definir un directorio propio donde se guardarn los archivos de distribucin, ya que deben ser conservados para que el wizard pueda generar correctamente las actualizaciones. Al culminar la generacin se habr creado, bajo el directorio especificado, un subdirectorio Build1 que contendr los archivos a llevar a la mquina del cliente.

Generacin del Setup de una actualizacin de un producto

Para generar una actualizacin se debe seleccionar el setup del producto correspondiente (cuyo nombre se defini al generar la primera versin del mismo) y luego proceder de la misma forma que en la generacin de un nuevo producto. Al culminar la generacin se habr creado, bajo el directorio del producto, un subdirectorio Buildn, donde n es el nmero de versin (generacin) del producto, que contendr los archivos necesarios para actualizar una instalacin anterior del producto a la nueva versin. El Setup Wizard determina los archivos que fueron actualizados y los incluye en el parche. Por ejemplo, si fue actualizado un ejecutable, archivos de imagen y al instalar un Service Pack del Visual Studio fueron actualizadas dlls y ocxs, los mismos sern includos automticamente. No se incluirn los ejecutables, imgenes y archivos de soporte que no cambiaron (aunque permanezcan marcados en la configuracin del setup). Notar que lo correcto es que todos los archivos que siguen perteneciendo al producto permanezcan

marcados independientemente si fueron actualizados o no.

Instalacin de un producto
Se deben llevar a la mquina destino los archivos ubicados en el directorio \Build1 correspondiente al producto que se desea instalar. Estos archivos deben ser copiados a un directorio accesible desde la mquina destino y no deben borrarse luego de la instalacin. Luego se debe ejecutar el programa Setup.exe y seguir los pasos que se indican en pantalla.

Actualizacin de un producto
La actualizacin se realiza mediante la aplicacin de un parche. La forma de hacerlo es copiar al directorio donde se encuentran los archivos del instalador original, los archivos ubicados en ....\Buildn correspondientes a la generacin de la actualizacin deseada. Estos constan de un .ini y un archivo .msp. Luego, estando posicionado en el directorio donde est ubicado el instalador, ejecutar el siguiente comando: Setup <archivo.msp> donde <archivo.msp> es el nombre del archivo con extensin msp correspondiente al parche a aplicar. IMPORTANTE Hay que tener en cuenta que para aplicar un parche se necesitan tener los archivos de la instalacin anterior, por lo que no deben borrarse del directorio de instalacin una vez completado el setup. En los parches, por defecto los archivos que fueron actualizados son distribuidos enteros, no se genera un archivo que slo contenga las diferencias. Por defecto en un parche se llevan los archivos enteros (no slo las diferencias entre la instalacin anterior y la actual). Esto es debido a que en Winodws 9x y Windows NT no es posible generar el parche con las diferencias y tampoco instalar un parche que slo lleva las diferencias. Esto solo es posible si la mquina origen y destino es Windows 2000 (la mquina donde se genera el instalador y la mquina donde se va a instalar), en ese caso si se pueden generar parches solo con las diferencias, esto se hace configurando en el archivo gxw32.ini del directorio Windows la seccin, clave y valor siguientes: [GeneXus Application Setup Wizard] PatchFiles=1 Si no existe la clave PatchFiles o su valor es distinto de 1, o la seccin no existe, se generan los parches llevando los archivos actualizados completos (como se dijo, este es el funcionamiento por defecto).

Instalacin de una aplicacin en red (instalacin administrativa)

Esta caracterstica permite mantener centralizada la administracin del instalador de un producto. Se mantiene el instalador en la red (instalador administrativo) y las estaciones de trabajo instalan y actualizan el producto desde la red. Desde el instalador administrativo es posible instalar localmente el producto en las estaciones de trabajo, as como tambin instalar el mismo de forma tal de ejecutarlo desde la red. En el primer caso todos los archivos que son parte del producto son instalados localmente (exes, bases de datos, bmps, dlls, ocxs, etc.) y en el segundo es posible copiar nicamente los ocxs y dlls. Para realizar la instalacin administrativa se deben llevar a la mquina destino los archivos ubicados en el directorio \Build1 correspondiente al producto que se desea instalar. Estos archivos deben ser copiados a un directorio accesible desde la mquina destino y no deben borrarse luego de la instalacin. Luego se debe ejecutar el comando setup a y seguir los pasos que se indican en pantalla. Esto instalar el setup administrativo en el directorio especificado, incluyendo todos los archivos necesarios para ejecutar la aplicacin. Luego en cada estacin de trabajo se debe ejecutar el setup.exe que se encuentra en el directorio del setup administrativo y seleccionar la opcin Custom setup lo que le permitir ejecutar la aplicacin desde la red o instalarla localmente. Ejemplo: Se tiene una aplicacin generada para Visual Basic contra Access y dicha aplicacin tiene un ejecutable UPRINCIP.EXE, la base de datos y archivos de imgenes. Se genera un primer setup con el nombre Prueba, lo que dejar una serie de archivos en el directorio Build1 que se llevar al cliente. En el cliente se tienen cinco estaciones de trabajo y un servidor de archivos llamarado SRV, y se desea que las cinco estaciones ejecuten la aplicacin a travs de la red. Los pasos a seguir seran los siguientes: 1. Copiar los archivos que gener el Setup Wizard en el directorio Build1 a un directorio del servidor de archivos y ejecutar el comando: setup a 2. El instalador pedir un directorio donde instalar el setup administrativo. Seleccionar el directorio c:\app1 que est compartido con el nombre \\SRV\app1 (podra ser cualquier directorio compartido), el instalador continuar el proceso de instalacin y avisar al finalizar. 3. Desde la primer estacin de trabajo, y suponiendo que est mapeado el directorio \\SRV\app1 en la unidad R:, ejecutamos el setup.exe que se encuentra en R:\. Se desplegar la siguiente pantalla:

seleccionando la opcin Custom se muestra la siguiente pantalla:

Al hacer click sobre el cono a la izquierda del nombre de la aplicacin, se despliega una lista que permite seleccionar si se desea que la aplicacin se instale localmente o se ejecute desde la red. Para el ejemplo se selecciona esta ltima alternativa. 4. Seleccionar el botn Next y luego Install para completar el proceso de instalacin. Esto crear un acceso directo que apuntar al ejecutable de la red. 5. Realizar el mismo procedimiento en las restantes estaciones de trabajo.

Actualizacin de una aplicacin en red

Para aplicar un parche a una instalacin administrativa se deben copiar al directorio donde se encuentran los archivos de la instalacin en red (en el ejemplo anterior \\SRV\app1), los archivos ubicados en ....\Buildn correspondientes a la generacin de la actualizacin deseada. Estos constan de un .ini y un archivo .msp. Luego, estando posicionado en el directorio donde est ubicado el instalador, ejecutar el siguiente comando: Setup a <archivo.msp> donde <archivo.msp> es el nombre del archivo con extensin msp correspondiente al parche a aplicar. De esta forma se actualizarn los archivos de la instalacin de red. Finalmente se deben actualizar los archivos que van en cada estacin de trabajo (dlls, accesos directos, etc.) para lo cual se debe ejecutar: Setup <archivo.msp> en cada estacin de trabajo a actualizar, estando posicionado en el directorio de la instalacin de red. IMPORTANTE Para instalar una actualizacin de una instalacin en red, se debe ejecutar el comando: Setup a <archivo.msp> desde una estacin de trabajo que tenga la aplicacin ya instalada, ya sea local o para ejecutar desde la red, y con el ltimo patch aplicado. Si se desea instalar la aplicacin en una nueva estacin de trabajo, en la que no se haya instalado previamente dicha aplicacin, alcanza con ejecutar el setup.exe del directorio de la red. Esto instalar la aplicacin actualizada a la ltima versin (ltimos parches).

Instalacin de una aplicacin Visual Basic con interface Web

Cuando se instala una aplicacin con interfase Web en la mquina destino se generan los siguientes dos directorios: o Directorio de la aplicacin, que contiene las dlls y lo controles necesarios para el normal funcionamiento de la aplicacin. o Directorio con los ASP y JavaScript al cual va a puntar el directorio virtual cuyo

nombre se especifica al hacer el Setup. La instalacin de una aplicacin VB con interfase Web se realiza de la misma forma que la instalacin de aplicaciones GUI, salvo que se muestra la siguiente ventana:

Donde se muestran los 2 directorios explicados anteriormente. Sitio Es el directorio de la aplicacin, que contiene las dlls y lo controles necesarios para el normal funcionamiento de la aplicacin (Default Path). Sitio Web Files es el directorio con los ASP y JavaScript al cual va a puntar el directorio virtual cuyo nombre se especifica al hacer el Setup (Default WEB Path). En la parte inferior se permite elegir el directorio virtual que se va a utilizar, por defecto se muestra el que se configur al armar el Setup. Los pasos restantes son iguales que una instalacin de una aplicacin GUI.

Actualizacin de una aplicacin Visual Basic con interface Web

Si se desea hacer una actualizacin de una aplicacin Web es necesario bajar el servicio del Personal Web Server o Internet Information Server y desregitrar la dll de la aplicacin Web.

Descripcin de la aplicacin
El nombre del ejecutable es GxStWz32.exe. Al ejecutarlo se despliega la siguiente pantalla:

Los datos a completar son los siguientes:

Source
Knowledge Base Directory El directorio de la base de conocimiento en que est la aplicacin para la que se quiere generar el Setup. Por defecto se sugiere el directorio en de la ltima base de conocimiento que fue abierta por GeneXus. Nombre del modelo en que est la aplicacin para la que se quiere generar el Setup. Se despliega una lista con los nombres de los modelos de la base de conocimiento. Si la versin de GeneXus es anterior a 5.5 Patch 3, se desplegarn los nombres de los directorios de los modelos.

Model

Platform

Permite seleccionar la plataforma correspondiente a la aplicacin que se quiere distribuir. Aplica a modelos con ngeneradores.

Setup
Name Permite seleccionar un Setup anterior generado para la base de conocimiento/modelo/generador elegidos, a los efectos de generar una actualizacin para ese producto. El botn New Setup permite crear un nuevo setup. Indica el tipo de setup que se quiere generar. Si se selecciona Generate Setup Program, se generar un programa de setup. Si se selecciona Copy Files se copiarn los archivos a un directorio. Esta ltima opcin puede ser til si se quieren copiar los ejecutables y otros archivos auxiliares a un directorio en el que hay una aplicacin en produccin. Siempre es recomendable instalar un producto con un instalador para poder eliminar todos los archivos del mismo en el momento de la desinstalacin. Target Se puede seleccionar si se desean generar los archivos de setup a un directorio o a diskettes. Si se generan a un directorio, se debe ingresar el nombre del mismo. Con el checkbox Organize setup files in diskettes se indica si se desea crear una estructura de directorios similar a si se copiaran los archivos a diskette.

Type

Notas: Opcin Organize setup files in diskettes En esta versin se genera el instalador y luego se arman archivos comprimidos que lo contienen y son stos los que se copiarn a los diskettes, a diferencia de la versin anterior en la cual los propios archivos de la instalacin eran copiados a los diskettes. A la hora de instalar la aplicacin, se debe copiar manualmente el contenido de cada uno de los diskettes al disco duro y luego ejecutar el extract.exe (todos los .cab y el extract.exe debern estar en el mismo directorio). El utilitario pide un directorio donde descomprimir el instalador contenido en los cabs. Notar entonces que no es posible ejecutar el instalador directamente de los diskettes. No es posible hacer la instalacin directamente desde diskettes, debido a que hay varios componentes de Microsoft que deben ser instalados por instaladores independientes y ocupan ms de un diskette. Adems un parche generado por el Setup Wizard puede ocupar mas de un diskette. Opcin Diskette Drive

En Setups para aplicaciones 32 bits esta opcin no es vlida. Esto es porque tal cual estaba implementada, no se generaban los setups a disco y en Windows Installer es necesario hacerlo. Para aplicaciones 16 bits funciona igual que en las versiones anteriores. En aplicaciones 32bits se puede generar a estructura de diskette y luego copiar a mano a los diskettes. Con el botn Next se pasa al siguiente paso del Wizard. Si se quiere finalizar la ejecucin, se puede presionar el botn Exit en cualquiera de los pasos. En el segundo paso se despliega la siguiente pantalla:

Los datos a completar son los siguientes:

Files to include
Required files Source Files support Incluir las DLLs, OCXs, etc. que sean necesarios para ejecutar la aplicacin en la mquina destino. Incluir los fuentes de la aplicacin.

Include Database files

Yes Incluye los archivos en donde estn los datos. En el caso de que sea una aplicacin FoxPro o Visual FoxPro se copiarn los DBFs. Si es una aplicacin Visual Basic, los MDBs. Se debe tener cuidado con la inclusin de esta opcin, porque en caso de existir datos en la maquina destino, los mismos se sobrescriben. No No se incluyen los archivos de base de datos Always localy Los archivos de base de datos se instalan siempre localmente, es decir, aunque la aplicacin se instale para ser ejecutada desde la red, se crea en cada workstation una copia local de dichos archivos.

Data base instalation Directorio donde se encuentra la base de datos local de la aplicacin. Por defecto se toma el configurado en las preferencias directory del modelo. Images Se permite seleccionar un directorio de origen y otros de destino en el cual se copian todas las imgenes del directorio origen. Se considera imagen los archivos con una de las siguientes extensiones: .BMP, .ICO, .TIF, .JPG y .GIF. Por defecto se copian todas las imgenes del directorio del modelo al directorio donde se instale la aplicacin. Es posible indicar directorios de destino relativos al de instalacin y especificar la opcin Always localy en forma anloga a los archivos de base de datos. Indica la versin del runtime detectado para el modelo a distribuir. En el caso de Visual FoxPro, tambin indica el idioma del lenguaje. Permite incluir fonts en el setup, las que sern instaladas en la mquina destino al ejecutar el mismo.

Runtime detected

Special Fonts

Call Program
Name Parameters

Permite indicar un archivo .EXE o .BAT a ser ejecutado al finalizar la instalacin. Nombre del programa a ejecutar. Parmetros a ser pasados al programa. Se puede pasar uno o ms parmetros e incluso otros (texto fijo), separando con espacios u otro carcter cada uno (segn sea procesado por el programa llamado). Los parmetros pueden ser:

[INSTALLDIR] [SOURCEDIR]

[WindowsFolder] [SystemFolder] [CommonFilesFolder] [ProgramFilesFolder]

Se obtiene el directorio donde se instal la aplicacin Se obtiene el directorio desde donde se est instalando, es el directorio que contiene el instalador y/o el parche. Directorio de Windows Directorio Windows/System Directorio Common Files Directorio Program Files

Nota: Opcin Call Program Cuando se incluye un programa para ser llamado al finalizar la instalacin de la aplicacin, este programa se ejecutar en el instalador original y en los parches Si slo se quiere ejecutar al instalar la primer versin, cuando se genera el parche correspondiente no hay que incluir nada en este campo. Por ejemplo, sera posible ejecutar automticamente en un parche una reorganizacin de la siguiente forma: - Tener un script (.bat) en el directorio del modelo que tenga los siguientes comandos: cd %1 %1\rmenu.exe - En el campo Name hacer referencia al .bat - En Parameters poner [INSTALLDIR] (con comillas para recibir en %1 todo el path si tiene espacios) En el tercer paso se presenta la siguiente pantalla:

Los datos a completar son los siguientes:

Applications and Program Group

Executable Include Create Icon Description Create program proup Add Application Nombre del ejecutable. Indica si incluir o no el ejecutable en el setup. Indica si crea o no un tem para ese ejecutable en el grupo de programas. Descripcin del tem en el grupo de programas. Indica si se desea crear un grupo en el Program Manager de Windows 3.11, o en el Start Menu de Windows 95 o posterior. Permite seleccionar otros archivos a incluir en el setup.

Setup Options
Application Name Nombre de la aplicacin a instalar.

Default Path

Directorio por defecto donde se va a instalar la aplicacin en la mquina destino. Si se deja vaco este campo, la aplicacin ser instalada bajo el directorio Program Files, en un directorio con nombre igual al de la aplicacin. Esta es la forma recomendada de instalar la aplicacin.

Use always

Permite forzar que los archivos se instalen en el directorio por defecto, y que el usuario final no lo pueda cambiar. Esto se aplica tanto al Default Path como al Default WEB Path. Directorio por defecto donde se instalarn los ASP y JavaScript necesarios para ejecutar la aplicacin Web. Si se deja vaco este campo, los archivos sern instalados bajo el directorio Program Files en un directorio con nombre igual al de la aplicacin seguido de _WebFiles Se crea un directorio virtual con el nombre especificado, que apunta al directorio donde se instalan los ASP y JavaScript. El nombre definitivo del directorio virtual puede modificarse en tiempo de ejecucin del setup. Se permite escoger el lenguaje en que se har la instalacin. Estn disponibles, ingles (default), espaol, italiano, portugus.

Default WEB Path

Virtual Directory

Setup Language

Es posible agregar otros programas o archivos de forma de que aparezcan en el grupo de programas en la mquina del usuario final. Por ejemplo, se puede agregar un Readme.txt, de forma que al usuario final le aparezca en el grupo del programa un cono con el readme.txt, o se puede agregar un .BAT que haga un respaldo de los datos, etc. Para hacer esto, se debe presionar el botn Add Application, y seleccionar el archivo que se desea incluir. Al ir al siguiente paso el programa debe calcular todas las dependencias de los archivos que as lo requieran, por este motivo puede demorar un tiempo considerable, en el cual la aplicacin no responda. En el ltimo paso se presenta la siguiente pantalla:

Aqu se puede consultar la lista de archivos a copiar, y se permite agregar algn archivo que sea requerido por la aplicacin y no est dentro de los que el Setup Wizard deduce que debe incluir. Es el caso de archivos de documentacin como .txt o .htm.

Files to copy
Add File Permite agregar archivos a ser distribuidos. Los mismos sern copiados al directorio de la aplicacin, salvo que sean tomados del directorio Windows o System, en cuyo caso sern copiados al directorio correspondiente. Si se selecciona un OCX o una DLL que debe registrarse, el Setup realizar la registracin. Permite borrar archivos de la lista (solo aquellos agregados via botn Add File). Salva la configuracin con el nombre dado en el paso 1.

Remove File Save Setup

Consideraciones generales
Instalacin del Setup Wizard
Cuando se instala el Setup Wizard, el programa instalador pregunta en que directorio se tiene instalado GeneXus, y ubica al utilitario en un directorio GXSETWIZ debajo del directorio de aquel. Si se intenta instalar sobre un directorio donde no est instalado GeneXus se da un mensaje de error y termina el Setup. El mensaje que se da es el siguiente:

A partir de la versin 2.1, en el directorio Comp bajo el directorio del Setup Wizard, se encuentran algunos de los componentes utilizados por las aplicaciones. Son los componentes que son compartidos y por tanto pueden haber sido actualizados en la mquina donde se genera el setup por cualquier instalacin. Es de este directorio que se obtendrn estos componentes para la incorporacin a los setups que sean generados por el Setup Wizard. De esta manera se busca generar setups mas seguros, que no generen problemas de estabilidad en la instalacin donde se instala la aplicacin. Los componentes que se encuentran en este directorio deben estar actualizados respecto a la liberacin de versiones y Services Packs por parte de Microsoft. Cuando estas liberaciones tengan lugar, los componentes mencionados sern actualizados en nuestra pgina Web, de manera que los usuarios puedan tener acceso a los mismos para la incorporacin al Setup Wizard. Con la versin 7.5 del Setup Wizard los archivos que se encuentran en el directorio Comp se corresponden con el Service Pack 5 del Visual Studio 6.0. Es debido a estos componentes que se incorporan que el Setup del Setup Wizard aumenta su tamao.

Generacin de Setups
Si se va a instalar una aplicacin que utiliza ActiveX , es recomendable instalar en la maquina destino el setup que el fabricante del ActiveX provee. El Setup Wizard lleva los archivos necesarios, pero puede darse el problema de archivos cruzados segn los distintos sistemas operativos. La utilizacin del Windows Installer para la instalacin de las aplicaciones solo afecta a las aplicaciones 32 bits, las aplicaciones 16 bits se siguen generando como hasta el momento. Cuando se selecciona que se incluyan los fuentes en una aplicacin FoxPro o Visual

FoxPro, se copian todos los PRGs aunque no estn involucrados en las aplicaciones seleccionadas. Si es una aplicacin Visual Basic, solo se copian los fuentes involucrados en las aplicaciones seleccionadas. Cuando se genera un setup de una aplicacin 16 bits a diskette, en el primer diskette siempre se reserva un espacio libre, que por defecto son 100Kb, pero que se puede configurar en la seccin Genexus Setup Wizard del gxw.ini que est en el directorio de windows, poniendo FreeSpaceDisk1 = NNNN donde NNNN es la cantidad de bytes. Esto es asi porque se debe generar un archivo llamado setup.lst que debe entrar siempre en el primer diskette, y que debe generarse luego de haber comprimido y partido los archivos. Entonces hay que estar seguro de que entra en el primer diskette, por eso se deja el espacio libre. En general dicho archivo no supera los 10k. El limite de 100k es para asegurarse de que nunca lo sobrepase, pero en caso de que esto ocurra o en caso de que se quiera aprovechar dicho espacio, se puede cambiar el setting. Para el caso de aplicaciones 32 bits, el espacio reservado es de 140Kb, y no es configurable. Si en la generacin de un Setup se seleccion la opcin Required support files, en las generaciones de los patches para esa generacin no es posible desmarcarla. El resto de las opciones si es posible desmarcarlas. Lo recomendable es no desmarcar opciones ya que el dejarlas marcadas no implica que el SW incluya nuevamente archivos que ya incluy en generaciones anteriores, sino que solamente sern includos los archivos que fueron actualizados y los nuevos. El demarcar una opcin significara por ejemplo que un ejecutable ya no es parte del producto, o al desmarcar los archivos de imgenes, que stos ya no son parte del mismo. No es posible cambiar el campo Application name cuando se genera una actualizacin de una aplicacin. No es posible cambiar el campo Target directory cuando se genera una actualizacin de una aplicacin. Si el nombre de los archivos .msi o .msp tienen espacios, hay que pasarlos con comillas al programa Setup.exe. Si se realiza la generacin del parche nmero N, y luego se decide que esa generacin no estaba bien (faltaba algn archivo o se recompil un exe, cualquier cambio que haga que se deba regenerarese parche), se puede borrar el directorio SWINFO\BuildN y volver a generarlo. Se debe tener en cuenta que las actualizaciones se generan contra el ltimo BuildN, que eventualmente es la versin que tiene algn cliente instalada. Por lo tanto si se elimina ese directorio, se pierde la posibilidad de generar una nueva actualizacin para ese cliente.

Instalacin/Desinstalacin de aplicaciones
Instalacin del Runtime de Visual Basic 6.0 o del DAO 3.6 (dao360.dll) en un parche. Cuando se genera un parche de una aplicacin, estos archivos no son instalados. Hay dos formas para hacer la instalacin manual de los mismos: - Generar un nuevo instalador - Generar un parche y seguir las siguientes indicaciones: o Runtime de Visual Basic 6.0 - Hay que llevar el instalador (archivo

VBrun60.exe que se encuentra bajo el directorio Comp del Setup Wizard) y ejecutarlo en la mquina destino antes de aplicar el parche. DAO 3.6 - Hay que llevar los archivos mdac_typ.exe y dcom95.exe a la mquina del cliente y ejecutarlos antes de aplicar el parche. El DCOM es necesario slo si el sistema operativo es Windows 95.

La desinstalacin de la aplicacin puede hacerse a travs de la opcin Add/Remove Programs del Panel de Control de Windows. Tambin es posible hacerlo ejecutando el setup.exe de la aplicacin y seleccionando Remove. El Windows Installer tambin permite desinstalar el producto dando botn derecho sobre el .msi.

Requerimientos importantes a partir de la version 1.4.3

No se puede usar el Setup Wizard para instalar aplicaciones en Windows NT 4.0 con un service pack anterior al 4 instalado, necesariamente hay que instalar el service pack 4 de Win NT 4.0. Para Windows NT se usa una funcin del API de Win NT que permite sustituir dlls que estn en uso por el sistema operativo. Hasta el service pack 4 de Win NT 4.0, esta funcin corrompe el registro de Windows NT. Este es un problema reconocido por Microsoft y que tiene resuelto en los ltimos service packs del Win NT 4.0 (referirse al articulo Q160658 de Microsoft). Instalacin en Windows NT 3.5 o 3.51 SP4 puede quedar mal instalada. Microsoft confirm que hay un problema con la funcin que se usa para resolver el problema de instalacin de archivos en uso en Windows NT versiones 3.5 y 3.51 SP4, tanto Workstation como Server. Esto va a traer el problema que las aplicaciones no van a quedar bien instaladas en el caso que se necesite instalar un archivo que este siendo usado. La forma de resolver el problema (se va a dar solo si se tiene instalado el SP4) es instalar un service pack posterior al 4 (referirse al articulo Q149857 de Microsoft).