PUESTA EN PRODUCCIN DE APLICACIONES GX-JAVA

Alcance
Generador Java versiones 7.5 y 8.0

Introduccin
En este documento se describe como poner en produccin una aplicacin java. Con Java se pueden generar varios tipos de aplicacin, se ver como distribuir cada uno de ellos, estos son: Win 2 capas (GUI) Win 3 capas (GUI) Web (HTML) Programas de reorganizacin Base de Datos (GUI y/o WEB) Se ver claramente los pasos a seguir tanto para la primer instalacin de la aplicacin, asi como la actualizacin a nuevas versiones de la misma.

Modelos GeneXus
Como es conocido, en la metodologa de desarrollo con GeneXus se manejan modelos de prototipos para las etapas de test y desarrollo de una aplicacin y modelos de produccin para mantener en l una copia exacta de la ltima versin que el usuario tiene instalada y trabajando y realizar el ltimo test comnmente llamado preproduccin. Al desarrollar en Java uno se encuentra con N ambientes posibles, tomando combinaciones de motores de servlets, drivers JDBC, DBMSs, etc, etc. Lo que se recomienda es 1) Manejar modelos de prototipos y produccin sobre _exactamente_ el mismo ambiente. Esto es por ejemplo, no prototipar con un driver de x versin y despus en produccin ser otro diferente o con tal motor y en produccin ser otro, etc. 2) Por otro lado es real que hay ciertos ambientes de produccin que son realmente complejos, por ejemplo servidores de produccin que requieren autorizacin especial para grabar a tal directorio, o para bajar y subir el servidor web o de servlets, o para pruebas de impactos en base de test. Entonces si bien se respeta el punto 1, y se tiene un modelo de prototipo en las mismas condiciones, para estos casos complejos, es recomendable manejar un tercer modelo de prototipo con ambiente _todo_ local para facilitar y hacer mas rpidas las pruebas.

Puesta produccin Aplicacin Win 2 capas

Para la distribucin e instalacin de aplicaciones de este tipo se utiliza el GeneXus Web Start Deployment Wizard. Una vez cerrado el desarrollo de una versin de la aplicacin, se deben seguir los siguientes pasos desde el modelo de produccin: 1. Correr el Deployment Wizard y armar paquetes para cliente con Genexus Web Start Deployemnt. 2. Llevar (va FTP/Copy/disk) todos los archivos y estructuras copiadas al directorio especificado en el Target Directory del wizard. 3. Copiar estos archivos al servidor de deployment en produccin. 4. Si se trata de un web server, la instalacion de la aplicacin puede hacerse desde el browser en la URL del tipo: http://DeploymentServer/aplicN/AplicName.html

Cmo cambiar los datos de conexin al DBMS? La informacin de conexin a la base de datos en este tipo de aplicaciones (win dos capas) se encuentra en el archivo CLIENT.CFG Si se conocen los datos antes de armar el deployment, se puede editar el client.cfg del directorio del modelo y cambiar alli los datos. Pero si no se conocen, entonces hay que desmarcar la opcion Include Client.cfg del GXWS Deployment Wizard, y de esta manera, este archivo queda fuera del deployment. Entonces, _antes_ de mandar la url al cliente para que instale su aplicacin se debe cambiar en este archivo los datos necesarios, generalmente son los siguientes: Dato Usuario Password Nombre base de datos Servidor base de datos Puerto base de datos Key correspondiente en Client.CFG USER_ID USER_PASSWORD DB_URL DB_URL DB_URL

Encriptacin Usuario y Password Cuando se actualizan datos como usuario y password para la conexin, se notar que stos se encuentran encriptados Si estos datos a actualizar no se permiten dejar legibles, se pueden encriptar con un utilitario del generador.

Puesta produccin Aplicacin Web

Para la distribucin e instalacin de aplicaciones de este tipo se utiliza el War Deployment. Este tipo de aplicaciones es la ms facil de llevar a produccin. Solo debe generarse un WAR y copiarlo en el direcotorio \webapps del servidor de servlets de produccin. Este WAR se arma con el WAR Deployment. Se trata de un wizard, al que bsicamente se le debe especificar un nombre a la aplicacin, y el servidor de servlets en el cual se instalar (resin, tomcat, websphere, etc). El proceso es el mismo tanto para la primera instalacin como para las siguientes versiones, solo se debe copiar este WAR al directorio webapss. Puede depender del motor de servles, e incluso de su configuracin el si se actualizar automticamente con copiarlo alli, o bien se tenga que bajar y subir el server para que sean tomados en cuenta. Cmo cambiar los datos de conexin al DBMS? El archivo en el que se guarda esta informacin es el mismo que en el caso de aplicaciones win 2 capas: CLIENT.CFG, solo que en el caso de aplicaciones web se encuentra dentro del WAR. Para poder hacer los cambios, antes de copiar el war al \webapps, se debe abrir este war (con el winzip), y abrir el client.cfg para editar y cambiar los datos. Es importante que luego de los cambios, se vuelve a grabar y dejar en el war con el mismo nombre y en el mismo flder: \web-inf\classes.

Exportacin y ejecucin de programas de reorganizacin

Desde el modelo de produccin se puede crear un Jar con los proa ramas de reorganizacin mediante un utilitario que viene con el generador. Este se puede llamar de dos maneras, desde GeneXus y por fuera de GeneXus. La primera es F5 - Developer Menu - Utilities - Export Reorganization Tambin se puede llamar para crear desde la consola, posicionandose en el directorio del modelo, poner: Java com.genexus.gx.deployment.ReorganizationPacker <nombre del package> [<nombre del .jar>] Si no se pone nombre del .jar se crea un archivo reorganization.jar. Si no se pone nombre del package asume que es el package "" Con sto se consigue un jar con los programas. Para ejecutarlo se debe llevar este .jar, la gxclassr.zip, los drivers JDBC a un determinado directorio y poner lo siguiente:

Java -cp:p <nombre del .jar>;gxclassr.zip;<drivers jdbc> <nombre del package>.Reorganization force Cmo cambiar los datos de conexin al DBMS? Nuevamente, si la opciones del DBMS cambian, esto es nombre de la base de datos, usuario y password, se debe desmarcar el check de Include reorg.cfg al momento de armar el .jar Para ejecutar la reorg, ademas de este .jar, la gxclassr.zip y los drivers se debe llevar el archivo REORG.CFG Antes de ejecutarla, editar el reorg.cfg y cambiar las opciones con las especificaciones reales de la base de datos donde se va a correr la reorganizacin. Luego si, se ejecuta como se mencionaba antes: Java -cp:p <nombre del .jar>;gxclassr.zip;<drivers jdbc> <nombre del package>.Reorganization force

Puesta produccin Win 3 capas

Para la distribucin e instalacin de aplicaciones de este tipo se utiliza dos wizards, uno para la parte del cliente: GeneXus Web Start Deployment y otro para la parte del servidor. Este depender el protocolo que se este utlizando, en caso de http se usar el War Deployment, mientras que si se utiliza CORBA o RMI se utiliza el Jar Deployment. El Deployment Wizard guia en la creacin de estos deployments, por lo que automticamente si se trata de una aplicacin 3 capas http, presentar el WAR Deployment. El procedimiento para la puesta en produccin consiste en actualizar ambas partes: cliente y servidor. La parte del cliente se hace _exactamente_ igual que lo comentado para aplicaciones win 2 capas, con la salvedad que no hay que actualizar los datos del dbms en el client.cfg, sino los datos del servidor de aplicaciones. se debe hacer Llevar (va FTP/Copy/disk) los paquetes generados, a los directorios correspondientes en server de produccin. Se debBajar y subir el GeneXus Application Server. En caso de estar frente a la primera instalacin, es necesario instalar y configurar el servidor de aplicaciones. Ver pasos 3, 4, 5 y 6 del documento: http://www.artech.com.uy/gxdlsp/Docum/GeneXus/Java/Tips/Pasaje3capas.htm

Luego seguir estos mismos pasos con cada actualizacion de la aplicacin