Ver código fuente

<keywords content="keywords">Deployment, deployment, Bizagi, enterprise edition, edicion, enterprise, Glassfish, glassfish, JEE, WebLogic, Weblogic, weblogic, WebSphere, Websphere, websphere</keywords>&nbsp; 
<div align="center">
{| class="MsoNormalTableOutDate" border="1" cellspacing="0" cellpadding="0" width="422"
|-
| valign="top" width="100%" | 
'''<span style="padding-left: 60px; margin-bottom: -20px" lang="ES-CO">Aplica para EDICIÓN ENTERPRISE JEE</span>''' <br>

|}
</div>
= Deployment de la Aplicacion a un Servidor JEE  =


Cuando termina una fase de desarrollo de un proyecto Bizagi Enterprise JEE, los procesos deben ser llevados a un servidor JEE en Pruebas o Producción, empleando un Deployment avanzado de Bizagi y el uso de la Consola Administrativa JEE (JEEConsole Manager). 



Tenga en cuenta que si su proyecto utiliza Virtualizaciónn o Replicación, entonces deberá garantizar que las [[Como_configurar_la_virtualizacion_y_replicacion_en_un_Servidor_JEE|<u>fuentes de datos se hayan configurado previamente en su servidor de Aplicaciones JEE</u>]]. 



Este artículo describe cómo realizar ese paso adicional, a partir del ambiente de Pruebas o Producción para el despliegue a la aplicación web final, en el Servidor de Aplicaciones JEE de su elección: Weblogic, WebSphere, JBoss. 


== WebLogic  ==

Antes de desplegar la aplicación web revise la [[Configuracion de WebLogic para Trabajar con Bizagi|<u>Configuracion de WebLogic para Trabajar con Bizagi</u>]]. 

=== Instalación de la Aplicación Web  ===

El archivo requerido para instalar Bizagi es: &lt;PATH_CONFIGURATION_FILES&gt;\Bizagi\Bizagi-ear-Weblogic.ear. 

Los pasos necesarios para completar esta tarea son: 

1. Iniciar sesión en la Consola de Administración, utilizando el panel de navegación vaya a '''Domain Structure – Deployments'''. Hacer clic en '''Install (Instalar)'''. 

2. '''''Locate deployment to install and prepare for deployment (Localizar el despliegue a instalar y preparar para el despliegue)''''': Ubicar la distribución de Bizagi (Bizagi-ear-Weblogic.ear) que se desea instalar y hacer clic en '''Next (Siguiente)'''. 

<br>

[[Image:WebLogicConfigurationToWorkWithBizagi Image018.jpg|center]] 

<br>

3. '''''Choose targeting style (Escojer estilo del objetivo)''''': Seleccionar la opción '''Install this deployment as an application (Instalar este despliegue como una aplicación)''' y hacer clic en '''Next (Siguiente)'''. 

4. '''''Optional Settings (Configuración Opcional)''''': Clic en '''Finish (Finalizar)'''. 

5. Para verificar que la aplicacion Web fue instalada correctamente, ingrese la siguiente dirección en cualquier navegador: 

<nowiki>http://localhost:7001/Bizagi-war/</nowiki> 

<br>
<div align="center">
{| class="MsoNormalTableNota" border="1" cellspacing="0" cellpadding="0" width="434"
|-
| valign="top" width="100%" | 
<span>'''Nota''': Si durante la instalación de la aplicación web se presenta un error de memoria, es necesario realizar el siguiente procedimiento:</span> 

<span>1.Abrir el archivo: &lt;WEBLOGIC_HOME&gt;\user_projects\domains\Bizagi_domain\bin\setDomainEnv.cmd </span>

<span>2. Localizar la linea: @REM IF USER_MEM_ARGS the environment variable is set, use it to override ALL MEM_ARGS values</span> 

<span>3. Debajo de esta línea copiar la siguiente instrucción:</span> 

<span>''Windows:'' set USER_MEM_ARGS=-Xms256m -Xmx512m -XX:PermSize=128m -XX:MaxPermSize=256m </span>

<span>''Linux:'' USER_MEM_ARGS="-Xms256m -Xmx512m -XX:PermSize=128m -XX:MaxPermSize=256m"</span> 

<span>4. Guardar los cambios y reiniciar el servidor de aplicaciones.</span>

|}
</div>
<br>

=== Generación de Entidades  ===

La primera vez que es instalada una distribución nueva de Bizagi, ésta provee una configuración básica del modelo de datos, por lo tanto es requerido llevar a cabo el procedimiento de generación de entidades para actualizar el componente asociado al modelo de datos. Los pasos necesarios son: 

1. Iniciar sesión en la Consola de Administración y, usando la panel de navegación vaya a '''Domain Structure – Deployments'''. Hacer clic en el nombre de la aplicacion web instalada (Bizagi-ear-Weblogic). 

2. Ubicar la pestaña '''Overview (Vista General)''', en la sección '''Modules and Components (Modulos y Componentes)''' navegar por la estructura de componentes hasta el item '''Web Services (Servicios Web)'''. Hacer clic en el servicio '''EntityProducerImplService'''. 

<br>

[[Image:WebLogicConfigurationToWorkWithBizagi Image019.jpg|center]] 

<br>

3. Localizar la pestaña '''Testing (Pruebas)''', abrir los items relacionados al servicio (haciendo clic en '''+''') y hacer clic sobre el punto de prueba '''Test Client (Cliente de Pruebas)'''. 

<br>

[[Image:WebLogicConfigurationToWorkWithBizagi Image020.jpg|center]] 

<br>

4. '''''WebLogic Test Client (Cliente de Pruebas de WebLogic)''''': Ejecutar la operacion "generateAllEntitites". Esta operacion es la encargada de generar el componente que contiene la metadata del nuevo modelo (Generated.jar). 

<br>

[[Image:WebLogicConfigurationToWorkWithBizagi Image021.jpg|center]] 

<br>

El archivo es generado en el directorio temporal de usuario del sistema operativo: <br>
<pre>Windows:&nbsp;%tmp%/Generated/Generated.jar
Linux: /tmp/Generated/Generated.jar
</pre>
<br>

5. Utilizar una herramienta para descomprimir archivos con el objetivo de abrir la distribución de Bizagi (Bizagi-ear-Weblogic.ear) y copiar el archivo de entidades generada: '''Generated.jar'''. Para este ejemplo se utilizo WinRAR. 

<br>

[[Image:WebLogicConfigurationToWorkWithBizagi Image022.jpg|center]] 

<br>

Para copiar el archivo simplemente se debe hacer clic sobre el botón "Añadir" y seleccionar el archivo "Generated.jar" del directorio temporal, otra opción sencilla es arrastrar el archivo hasta la ventana del WinRAR; en cualquiera de las dos opciones se muestra una ventana para confirmar esta accion, hacer clic sobre "OK". Verificar que el archivo fue adicionado correctamente a la distribución y luego cerrar la aplicación. 

6. Iniciar sesión en la Consola de Administración y, usando el panel de navegación vaya a '''Domain Structure – Deployments'''. Seleccionar la distribución de Bizagi instalada y hacer clic en '''Delete (Eliminar)'''. 

7. Instalar la aplicación Web nuevamente, utilizando la distribución que fue actualizada con el archivo '''Generated.jar''' 

<br>
<div align="center">
{| class="MsoNormalTableNota" border="1" cellspacing="0" cellpadding="0" width="434"
|-
| valign="top" width="100%" | 
<span>'''Nota''': El procedimiento de generacion de entidades e instalacion de la aplicacion Web también deber realizarse cuando el modelo de datos es modificado desde Bizagi Studio. </span>

|}
</div>
== WebSphere  ==

Revisar la [[Configuracion de WebSphere para Trabajar con Bizagi|<u>Configuración del Servidor WebSphere para Trabajar con Bizagi</u>]] antes de implementar la aplicación. 

=== Prerequisitos   ===

Bizagi Enterprise JEE ofrece una consola de administración de línea de comandos la cual permite ejecutar las tareas siguientes de una manera rápida y sencilla: 

*Iniciar y Detener el servidor de Aplicación. 
*Instalar y desinstalar Bizagi BPM (Aplicación Web).

Antes de iniciar el proceso de instalación de Bizagi BPM se debe asegurar que el servidor de aplicaciones se debe haber iniciado. 


=== Procedimiento ===

Debe haber un proyecto creado con la información de configuración de la base de datos y del servidor de aplicaciones. 

1. Para hacer esto, use la siguiente instrucción en línea de comandos: 

<br>
<pre>&lt;JEECONSOLE_HOME&gt;/bin/ JEEConsoleManager.bat createproject &lt;CONFIG_PATH&gt;
</pre>
<br>

&lt;CONFIG_PATH&gt; es la ruta donde se encuentra el archivo de configuración XML. 

2. Inicie la consola de administración ejecutando el comando '''DEPLOY'''. Ingrese la siguiente instrucción en una interfaz de línea de comandos: 

<br>
<pre>&lt;JEECONSOLE_HOME&gt;/bin/ JEEConsoleManager.bat deploy -e -p &lt;PROJECT_NAME&gt; &lt;BIZAGI_PATH&gt;
</pre>
<br>

El elemento "-e" indica que, como parte del proceso de instalación, es necesario generar las entidades y actualizar el componente relacionado. 

==== Consola de Administración WebSphere  ====

El archivo necesario para instalar Bizagi es: &lt;PATH_CONFIGURATION_FILES&gt;\Bizagi\Bizagi-ear-Websphere.ear. 

Los pasos necesarios para completar esta tarea son: 

1. Ingresar a la Consola de Administración e ir a '''Applications – Application Types – WebSphere enterprise applications '''a través del panel de navegación . Hacer clic en '''Instalar'''. 

2. '''Prepararse para la instalación de la aplicación''': Encontrar la distribución de Bizagi (Bizagi-ear-Websphere.ear) que se va a instalar y hacer clic en '''Siguiente'''. 

<br>

[[Image:WebSphereConfigurationToWorkWithBizagi Image042.jpg|center]] 

<br>

3. En la opción Seleccionar para Instalación (Selected for installation) ingrese la opción '''Ruta Rápida (''''''Fast Path)''' y haga clic en '''Siguiente'''. 

4. '''Instalar Nueva Aplicación''/ Seleccionar las opciones de Instalación'': Mantener los valores por defectoy hacer clic en '''Siguiente'''. Esta configuración se puede modificar dependiendo del juicio del administrador del servidor de la aplicación.''' 

5. '''Instalar Nueva Aplicación''/ Relacionar modulos con servidores'': Hacer clic en '''Siguiente'''.''' 

6. '''''Instalar Nueva Aplicación/ Map&nbsp;virtual hosts for Web modules.''''' Hacer clic en '''Siguiente'''. 

7. '''''Instalar Nueva Aplicación/ Resúmen''''': Revisar los parámetros de configuración del proceso de instalación. Hacer clic en '''Terminar'''. 

8. Una vez se terminó de instalar la aplicación, hacer clic en '''Guardar '''para conservar los cambios en&nbsp;la configuración principal. 

<br>

[[Image:WebSphereConfigurationToWorkWithBizagi Image043.jpg|center]] 

<br>

9. Finalmente es necesario seleccionar la aplicación instalada y hacer clic en el botón '''Iniciar '''para cargar sus componentes. 

<br>

[[Image:WebSphereConfigurationToWorkWithBizagi Image044.jpg|center]] 

<br>

 [[Image:WebSphereConfigurationToWorkWithBizagi Image045.jpg|center]]
 

<br>

10. Para verificar que la aplicación web se ha instalado correctamente, ingrese la dirección siguiente en cualquier navegador: 

<nowiki>http://localhost:9080/Bizagi-war/</nowiki> 

<br>
<div align="center">
{| class="MsoNormalTableNota" border="1" cellspacing="0" cellpadding="0" width="434"
|-
| valign="top" width="100%" | 
<span>'''Nota''': Cuando se instala Bizagi BPM usando la Consola de Administración de WebSphere, se asume que la distribución (.EAR) ya tiene actualizado el componente asociado al modelo de datos (Generated.jar).</span>

|}
</div>
<br>

== JBoss  ==

Antes de llevar a cabo el despliegue de Bizagi (EAR) en el servidor de aplicaciones, es necesario ejecutar un procedimiento de pre-despliegue de la versión. Básicamente consiste en construir el módulo de entidades generadas a partir de la información del modelo de datos e integrarlo a la versión de Bizagi que se entrega. Para JBoss este procedimiento se debe realizar mediante una consola de administración la cual se detalla más adelante. De igual forma, antes de realizar este procedimiento, revise la [[Configuracion de JBoss para trabajar con Bizagi|<u>configuración de JBoss para trabajar con Bizagi</u>]]. 

=== Prerequisitos ===

Bizagi Enterprise JEE ofrece una consola administrativa que permite generar el archivo EAR para el despliegue de la aplicación web en el servidor JBoss.<br>

Antes de seguir con la instalación del proceso Bizagi BPM, se debe revisar que las siguientes condiciones se cumplan: 

1. El servidor de aplicaciones debe estar iniciado. <br>2. La consola administrativa JEE llamada "JEEConsoleManager" debe estar instalada. Esta instalación se realiza descomprimiendo el .rar entregado por Bizagi en una ruta local.<br>Esta ruta se refencia en esta guía como &lt;JEECONSOLE_HOME&gt;. 

=== Procedimiento  ===

Asegúrese previamente de que el archivo de configuración XML del proyecto, contenga la configuración de la base de datos y el servidor de aplicación (este archivo debe ser creado a partir de la plantilla "ProjectTemplate.xml" que se encuentra en el directorio &lt;JEECONSOLE_HOME&gt;).<br>

Para iniciar la generación del .EAR para los procesos, utilice los comandos de consola indicados.<br>

1. Para crear los archivos de proyecto: <br>
<pre>#&lt;JEECONSOLE_HOME&gt;/bin/JEEConsoleManager.bat createproject &lt;CONFIG_PATH&gt;
</pre>
<br>

Nótese que &lt;CONFIG_PATH&gt; es la ruta donde el archivo de configuración XML se encuentra ubicado. Este archivo de configuración del proyecto contiene la información del nombre del proyecto, entre otras. 

2. Para generar la versión: <br>
<pre>#&lt;JEECONSOLE_HOME&gt;/bin/JEEConsoleManager.bat predeploy -o &lt;OUTPUT_PATH&gt; -p &lt;PROJECT_NAME&gt; &lt;FILE_PATH&gt;


</pre>
<br>

&lt;OUTPUT_PATH&gt; es la ruta opcional para especificar dónde se generará la versión de Bizagi.<br>&lt;PROJECT_NAME&gt; es el nombre del proyecto tal como se especifica en el xml del &lt;CONFIG_PATH&gt;. <br>&lt;FILE_PATH&gt; es la ruta donde queda ubicado el archivo .EAR que servirá de entrada para la generación de la aplicación web (despliegue) en JBoss. 

<br>

==== Despliegue en JBoss  ====

JBoss permite que las aplicaciones web se instalen simplemente copiando el archivo de distribución (.EAR) en el folder de despliegue ("deploy") del servidor. Este folder se encuentra en: &lt;JBOSS_HOME&gt;/server/default/deploy/ 

Esto se puede realizar mientras el servidor esté iniciado y corriendo (en caliente), o si el servidor está detenido. 

Nótese que cuando el proyecto BPM Bizagi se instala de esta manera, se asume que el archivo de distribución (.EAR) ya cuenta con el componente (Generated.jar) actualizado, de acuerdo al modelo de datos.<br>

<br>
<div align="center">
{| class="MsoNormalTableAlert" border="1" cellspacing="0" cellpadding="0" width="600"
|-
| valign="top" width="100%" | 
<span>'''Alerta:''' Es posible editar el archivo run.conf para modificar los parámetros de memoria para el servidor. Esto es útil especialmente en caso que el servidor muestra un error de restricción de memoria ejecutando los pasos anteriores. Para hacer esto, edite el archivo “&lt;JBOSS_HOME&gt;\bin\run.conf.bat” (para sistemas operativos Windows); o “&lt;JBOSS_HOME&gt;\bin\run.conf” (en Linux) como se describe a continuación:
Incluya la línea: set "JAVA_OPTS=-Xms512m -Xmx1024m -XX:MaxPermSize=512m" debajo de la línea que comienza así: “rem # JVM memory allocation pool parameters - modify as appropriate.” (En Windows)
Para Linux, edite los parámetros: –Xms512m –Xmx1024m -XX:MaxPermSize=512m debajo de la línea: “# Specify options to pass to the Java VM”.</span>

|}
</div>
<br>

<br>Finalmente, para iniciar y verificar la instalación de la aplicación web, ingrese la siguiente dirección en un browser: 

<nowiki>[http://localhost:8080/Bizagi-war/ http://localhost:8080/Bizagi-war/]</nowiki><br>

== Artículos relacionados  ==

*[[Instalando Bizagi Xpress|Instalando la Edición Xpress de Bizagi]] 
*[[Instalando Bizagi Enterprise .NET|Instalando la Edición Enterprise .NET de Bizagi]] 
*[[Instalando Bizagi Enterprise JEE|Instalando la Edición Enterprise JEE de Bizagi]] 
*[[Configuracion de WebSphere para Trabajar con Bizagi|Configuración de WebSphere para Trabajar con Bizagi]] 
*[[Configuracion de WebLogic para Trabajar con Bizagi|Configuración de WebLogic para Trabajar con Bizagi]] 

<br>

<comments />