Administración Del Sistema Bizagi PDF

Bizagi BPM Suite
Gua de Usuario
Tabla de Contenido
5
Parte I Administracin del Sistema Bizagi
Configuracin de la base de datos

................................................................................................................................... 6
Requisitos de la..........................................................................................................................................................
base de datos
7
Requisitos .........................................................................................................................................................
al utilizar SQL Server
7
Requisitos.........................................................................................................................................................
al utilizar Oracle
19
Instalacin de Oracle
.........................................................................................................................................
Data Provider para .NET
24
Configuracin..........................................................................................................................................................
de Bizagi ODS
27
Definicin.........................................................................................................................................................
del ODS en el Servidor de Aplicaciones JEE
33
Configuracin del servidor BPM

................................................................................................................................... 38
Configuracin..........................................................................................................................................................
de Bizagi Engine sobre plataforma .NET
39
Instalacin.........................................................................................................................................................
del IIS
40
Configuracin
.........................................................................................................................................................
del sistema Bizagi
64
Administracin
.........................................................................................................................................................
de Servidores y Clsters
81
Recomendaciones
.........................................................................................................................................................
de seguridad en la configuracin
103
Configuracin
..........................................................................................................................................................
de Bizagi Engine sobre plataforma JEE
110
Configuracin
.........................................................................................................................................................
del Servidor de Aplicacin JEE para trabajar con Bizagi
111
Configuracin .........................................................................................................................................
de WebSphere
112
Configuracin...................................................................................................................................
de WebSphere en clster
112
Preconfiguracin
...................................................................................................................................
de WebSphere para soporte a clster
113
Configuracin de WebSphere en clster para trabajar con
................................................................................................................................... 133
Bizagi
Configuracin...................................................................................................................................
del Scheduler en WebSphere
181
Configuracin...................................................................................................................................
estndar de WebSphere
183
Configuracin .........................................................................................................................................
de Weblogic
235
Configuracin...................................................................................................................................
de Weblogic para soporte a clster
235
Preconfiguracin
...................................................................................................................................
de Weblogic para soporte a clster
236
Configuracin de Weblogic en clster para trabajar con Bizagi
................................................................................................................................... 248
Configuracin...................................................................................................................................
del Scheduler en Weblogic
283
Configuracin...................................................................................................................................
estndar de Weblogic
285
Configuracin .........................................................................................................................................
de JBoss
322
Configuracin...................................................................................................................................
de JBoss para soporte a clster
323
Configuracin...................................................................................................................................
de JBoss en clster para trabajar con Bizagi
324
Configuracin...................................................................................................................................
del Scheduler en JBoss
346
Configuracin...................................................................................................................................
estndar de JBoss
348
Configuracin
.........................................................................................................................................................
de la arquitectura del sistema
373
Configuracin .........................................................................................................................................
del balanceo de cargas
374
Balanceo de cargas
...................................................................................................................................
con WebSphere
375
Balanceo de cargas
...................................................................................................................................
con Weblogic
380
Balanceo de cargas
...................................................................................................................................
con JBoss
383
Configuracin...................................................................................................................................
de Replicacin y Virtualizacin
387
Configuracin...................................................................................................................................
de Replicacin y Virtualizacin en JBoss
388
Despliegue
.........................................................................................................................................................
a un Servidor de Aplicacin JEE
395
Despliegue hacia
.........................................................................................................................................
WebSphere
395
Despliegue hacia
.........................................................................................................................................
Weblogic
404
Despliegue hacia
.........................................................................................................................................
JBoss
410
Otras opciones de configuracin

................................................................................................................................... 420
Copyright 2014 - Bizagi
Configuracin
..........................................................................................................................................................
de Bizagi en Amazon WS
420
Configuracin
..........................................................................................................................................................
de Bizagi para el acceso seguro desde Internet
420
Deployment de Procesos ................................................................................................................................... 428

Consideraciones
..........................................................................................................................................................
y requerimientos
433
Deployment
.........................................................................................................................................................
de los objetos
440
Relacionar
.........................................................................................................................................................
objetos
448
Deployment a..........................................................................................................................................................
Pruebas
453
Release Candidate
.........................................................................................................................................................
en Deployment a Pruebas
473
Deployment a..........................................................................................................................................................
Produccin
476
Mejoramiento
.........................................................................................................................................................
continuo
487
Gua para nueva
.........................................................................................................................................
versin de Proceso
493
Deployment Avanzado
.......................................................................................................................................................... 497
Ejemplo de
.........................................................................................................................................................
Deployment Avanzado
513
Mantenimiento y administracin
...................................................................................................................................
de proyectos
524
Backups de base
..........................................................................................................................................................
de datos
528
Backups .........................................................................................................................................................
y su restauracin en SQL Server
528
Export e .........................................................................................................................................................
Import en Oracle
545
Mantenimiento
..........................................................................................................................................................
de la base de datos
556
Monitoreo de..........................................................................................................................................................
servidores
558
Administracin
..........................................................................................................................................................
del entorno
560
Management
.........................................................................................................................................................
Console
560
Configuracin
.........................................................................................................................................................
de parmetros
568
Administracin
.........................................................................................................................................................
de Actividades Asncronas
575
Administracin
.........................................................................................................................................................
de sistemas externos
580
Administracin.........................................................................................................................................
de interfaces
581
Verificar Replicacin
......................................................................................................................................... 586
Administracin
.........................................................................................................................................................
de trabajos programados
589
Diagnstico
.........................................................................................................................................................
y control de errores
595
Diagnstico y control
.........................................................................................................................................
de errores para servicios Web
603
Versiones y actualizaciones
.......................................................................................................................................................... 608
Actualizacin
.........................................................................................................................................................
de Bizagi
609
Actualizacin de
.........................................................................................................................................
edicin Xpress a Enterprise
609
Actualizacin de
.........................................................................................................................................
versin
629
Actualizacin menor
...................................................................................................................................
de versin
631
Actualizacin de
...................................................................................................................................
versin en la Enterprise JEE
634
Actualizacin mayor
...................................................................................................................................
de versin
638
Desinstalacin
.........................................................................................................................................................
de Bizagi Engine
639
Parte I
Administracin del Sistema Bizagi
Administracin del Sistema Bizagi

Tenga en cuenta que dentro del sistema Bizagi hacen parte los siguientes componentes:
1. Un repositorio de Procesos.
La base de datos (un RDBMS) donde Bizagi almacena la informacin de los procesos y sus modelos.
El repositorio de procesos se configura en un servidor de base de datos y se soporta clster para
medidas de tolerancia a fallos.
2. El Portal de trabajo Bizagi.
Bizagi provee una aplicacin web como portal de trabajo para que los usuarios finales trabajen en sus
procesos. Bizagi ejecuta los procesos en un servidor de aplicaciones .NET o JEE.
Para un esquema de alta disponibilidad, se soporta configuracin en clster donde cada nodo del
servidor BPM tendr una aplicacin de Bizagi.
3. Un servicio Programador llamado Scheduler.
Bizagi provee un servicio que se encarga de ejecutar tareas fuera de lnea del sistema, como por
ejemplo: tareas de mantenimiento, tareas peridicas especficas de la solucin, tareas personalizadas
o aquellas
integraciones con otros sistemas que se definan de manera asncrona, entre otras.
4. Infraestructura adicional
Cada proyecto puede contar con varias opciones de hardware o software para la configuracin del
sistema, por ejemplo:
Un esquema de tolerancia a fallos para la capa de datos, que debe estar configurado
adecuadamente cuando se involucre ms de 1 nodo en un esquema activo-pasivo o activo-activo.
Un esquema de ODS opcional, configurada para el mdulo de Anlisis de Procesos con el fin de
mejorar la disponibilidad y operacin del Portal de trabajo de Bizagi.
Un servidor Http opcional, sea para la distribucin de los recursos estticos Web usados
por el Portal de trabajo de Bizagi o configurado con capacidades de proxy inverso para el acceso del
portal desde Internet.
Un balanceador de cargas opcional, por hardware o software, que debe estar configurado
adecuadamente cuando se utiliza una solucin de Bizagi en clster.
Un ESB (bus) que facilita servicios integrados.
5. Otros sistemas
Otros sistemas externos integrados en el proyecto de Bizagi Studio incluye:
Un servidor LDAP para el manejo de la autenticacin.
Un servidor SMTP para las notificaciones.
Un sistema ECM utilizado como gestor documental.
Uno o ms sistemas ofreciendo servicios Web a los procesos.
Una o ms bases de datos integradas a travs la Virtualizacin o Replicacin.
Perfiles requeridos
De acuerdo a los componentes que hacen parte de la solucin Bizagi, para la administracin y
mantenimiento se debe contar con los siguientes perfiles:
1. Administrador de Bases de datos (DBA).

Debe tener conocimiento experto en el motor de Base de datos especfico (Oracle o SQL Server).
2. Administrador de plataforma de la solucin.
Debe tener conocimiento experto para el manejo del servidor de Aplicaciones utilizado por el proyecto
(WebSphere, Weblogic, JBoss o IIS), as mismo como del sistema operativo sobre el cual este se
ejecuta (p.e, Windows o Linux).
3. Administrador de Procesos.
Debe tener conocimiento del negocio y de la solucin Bizagi.
Debe estar en capacidad de liderar el plan de despliegue as mismo como gestionar los cambios y
actualizaciones sobre los ambientes de la solucin.
Debe contar con acceso a las opciones de administracin en Bizagi y el uso de sus herramientas.
Mayor informacin
Consulte los captulos de esta seccin para ms informacin relacionada a los requisitos configuracin
y administracin del sistema Bizagi:
1. Para informacin sobre los requisitos, configuracin y opciones para el servidor de base de datos,
consulte Configuracin del Servidor de Base de Datos (aplica para todos los ambientes: Desarrollo,
Pruebas y Produccin).
2. Para informacin sobre la configuracin involucrada en el servidor BPM, consulte la Configuracin
del Servidor BPM.
3. Para conocer sobre otras opciones de infraestructura, como la posibilidad de configurar un proxy
inverso para el acceso seguro a Bizagi desde Internet, o la configuracin de Bizagi en servicios de
Amazon AWS, consulte Otras opciones de configuracin.
4. Para informacin sobre el despliegue de procesos (es decir, publicar los procesos o nuevas
versiones de proceso a produccin bajo mejoramiento continuo), para lograr alinear las expectativas
del rea de TI y las necesidades de negocio, consulte Deployment de procesos.
5. Para informacin sobre las tareas de mantenimiento de los proyectos Bizagi, consulte
Mantenimiento de proyectos.
Configuracin de la base de datos

Bizagi Engine utiliza una base de datos como el repositorio de procesos.
Para configurar su servidor de base de datos, deber contar con una instancia de base de datos
previamente instalada y revisar que est configurada para trabajar con Bizagi.
La capa de datos contiene el servidor de base de datos y soporta una configuracin en clster para
la tolerancia a fallos.
Debe asegurarse de configurar su base de datos en clster si desea utilizar dicha medida.
Para procesos de misin crtica (para una configuracin orientada a alta disponibilidad), se
recomienda utilizar esta medida de tolerancia a fallos (soportada tanto como en un esquema
pasivo-activo o activo-activo).
Consulte los captulos en esta seccin para ms informacin acerca de:

1. Requerimientos de la base de datos.
2. Configuracin de Bizagi ODS, como una medida opcional para mejorar la disponibilidad y
rendimiento de la aplicacin.
Requisitos de la base de datos

Para mayor informacin acerca de los requerimientos y configuracin cuando se utiliza SQL Server,
consulte Configuracin y requerimientos de SQL Server.
Para mayor informacin acerca de los requerimientos y configuracin cuando se utiliza Oracle,
consulte Configuracin y requerimientos de Oracle.
Requisitos al utilizar SQL Server
Introduccin
Bizagi Engine requiere de una instancia de base de datos para el repositorio de sus procesos.
Microsoft SQL Server es soportado como motor de base de datos para este fin.
Versiones y ediciones soportadas

Bizagi soporta las siguientes versiones:
VERSIN
NMERO
SQL Server 2012
11.0.2100 o superior
SQL Server 2008 R2, service pack 1
SQL Server 2008, service pack 1
SQL Server 2005, service pack 2
Todas las ediciones se soportan: Enterprise, Standard o Express.
La base de datos debe instalarse con una intercalacin (collation) que cumpla lo siguiente:
Sea sensible a maysculas, osea "case-insensitive" (CI).
No sea una intercalacin del idioma turco.
Configuracin requerida
La configuracin de una instancia SQL Server para trabajar con Bizagi, requiere lo siguiente:
Autenticacin tipo SQL Server
Deber habilitar la autenticacin tipo SQL Server para esa instancia de base de datos.
Protocolo TCP/IP
Deber asegurarse de habilitar el protocolo TCP/IP, y de revisar que ste se configure bajo prcticas
recomendadas como: un puerto explcito TCP/IP (no utilizando puertos dinmicos), y permitir las
conexiones remotas.
Login de usuario autorizado
Deber contar con un login de usuario (inicio de sesin), que utilice la autenticacin SQL Server y que
tenga los permisos necesarios.
Verificando la configuracin en SQL Server

Lleve a cabo los siguientes pasos, para asegurarse de que su instancia SQL Server tenga la
configuracin requerida.
Antes de comenzar
Para verificar la configuracin apropiada de su instancia SQL Server, necesitar las herramientas de
configuracin y herramientas cliente de SQL Server.

Las herramientas utilizadas para los siguientes pasos son SQL Server Management Studio y SQL Server
Configuration Manager.
Tenga en cuenta que ambas herramientas las puede instalar la base de datos SQL Server. En caso de
que su base de datos no haya incluido estas herramientas, tambin puede instalarlas y descargarlas
desde las pginas oficiales de Microsoft (sin costo).
Qu versin tengo?
Para determinar la versin de SQL Server y su detalle (p.e, la edicin), ejecute el siguiente comando
desde SQL Server Management Studio (habindose conectado a su instancia):
Select @@version
Esta consulta debe mostrar el detalle completo de la instancia:

El nombre oficial del producto y el service pack
El nmero exacto de versin y su fecha
Detalla adicional acerca de la edicin de SQL Server y bits soportados.
Revisando la configuracin
Revise o configure como se indica a continuacin.
1. Autenticacin tipo SQL Server
Ejecute el SQL Server Management Studio.
Conctese a su instancia, y d clic derecho sobre sta para seleccionar sus propiedades (properties):
Luego, en las opciones de Seguridad, asegrese de est marcado Autenticacin SQL Server y
Windows.
10
2. TCP/IP protocol
Ejecute el SQL Server Configuration Manager.
11
En la instancia especfica de Base de datos (bajo SQL Server Network Configuration), habilite el
protocolo TCP/IP haciendo clic derecho sobre l, y seleccionando Habilitar:
En las propiedades TCP/IP, se recomienda seleccionar un puerto TCP explcitamente (por defecto es
1433) de manera que se garantice que no se utilizarn puertos dinmicos:
12
En la misma configuracin a travs de SQL Server Configuration Manager, podr asegurarse tambin
de tener en un estatus de iniciado el servicio SQL Server Browser.
Si realiz cambios en esta configuracin, es posible que se deba reiniciar el servicio de la instancia.
Ntese que la configuracin anterior requiere que no hayan firewalls (cortafuegos) o bloqueos para
el puerto de servicio TCP de esa instancia.
13
Para permitir conexiones remotas, en el tem Conexiones, revise la propiedad Permitir conexiones
remotas a este servidor:
3. Login de usuario autorizado

Ejecute SQL Server Management Studio y asegrese de estar conectado a su instancia con un login de
usuario con privilegios de administrador (p.e, con el login de usuario sa).
Con este usuario, verifique que el login de usuario que utilizar para Bizagi Engine cumpla lo siguiente:
El login de usuario debe usar autenticacin tipo SQL Server:
14
Asegrese de que tenga el rol sysadmin:
15
Debe incluir los siguientes mapeos (user mapping) para la base de datos especfica del proyecto:
db_datareader, db_datawriter, public, rlBA_SQL_BizagiWebApp y rlBA_SQL_ExecuteBizagiSPs.
16
Verifique que este login de usuario est habilitado y permitido para conectarse, bajo sus opciones
de Status:
17
Podr modificar o revisar que este login de usuario SQL Server se utilice en el string de conexin que
se configura para el Portal de trabajo de Bizagi y para el servicio Scheduler, al editar los archivos de
configuracin.
Cuando se ejecutan los procesos sobre una plataforma .NET, considere:

La configuracin de la conexin que utiliza el Portal de trabajo se modifica editando el archivo de
configuracin web.config ubicado en la carpeta Web application de la ruta del proyecto (por
defecto en C:\Bizagi\Projects\[su_proyecto]\WebApplication).
La configuracin de la conexin que utiliza el servicio Scheduler se modifica editando el archivo de
configuracin Bizagi.Scheduler.Services.exe.config ubicado en la carpeta Scheduler de la ruta del
proyecto (por defecto en C:\Bizagi\Projects\[su_proyecto]\Scheduler).
La conexin se configura para ambos archivos anteriomente mencionados, a travs del la
siguiente llave:
18
<add key="DSNDB" value="Current Language=us_english;Initial

Catalog=[MY_PROJECT_DATABASE];Data Source=[MY_SQL_SERVER_INSTANCE];User
ID=[MY_NEW_LOGIN];Password=[MY_LOGIN_PASSWORD];" />
Cuando se ejecutan los procesos sobre una plataforma .NET, considere:
La configuracin de la conexin que utiliza el Portal de trabajo se modifica a travs de la
configuracin de la fuente de datos de Bizagi, cuando se define a nivel del servidor de
Aplicaciones JEE.
La configuracin de la conexin que utiliza el servicio Scheduler toma por defecto la misma
configuracin definida para el Portal de trabajo.
Requisitos al utilizar Oracle
Introduccin
Bizagi Engine requiere de una instancia de base de datos para el repositorio de sus procesos.
Oracle es soportado como motor de base de datos para este fin.
Versiones y ediciones soportadas

Bizagi soporta las siguientes versiones:
VERSIN
NMERO
Oracle 11g R2
11.2.0.1 o superior
Oracle 10g R2
10.2.0.1 o superior
Las ediciones soportadas son la Estndar y la Enterprise (la edicin Express de Oracle XE no est
soportada).
La instancia debe tener un set de caracteres (NLS_CHARACTERSET) que no sea Unicode (se soporta
una configuracin de single-byte).
Para mayor informacin sobre los set de caracteres que no sean de multiple byte, consulte la
documentacin oficial de Oracle.
Prerrequisitos y recomendaciones
En la configuracin de una base de datos Oracle 11g, tenga en cuenta:
1. Si utiliza archiving (habilita el modo Archive), se recomienda utilizar dos destinos para archivelog.
2. Se recomienda utilizar un manejo de memoria compartido (Automatic Shared Memory
Management).
Tambin se recomienda que asigne como mnimo:
4 Giga bytes para el tamao de la memoria SGA.
3 Giga bytes para el tamao de la memoria PGA.
19
3. Se recomienda asignar como mnimo al tamao de bloque 8000 bytes (block size), y 300 procesos
20
4. Se recomienda utilizar 4 grupos de logs "redo", cada uno asignado con 3 Giga bytes.
Recuerde que lo anterior considera estrictamente los requisitos mnimos para la configuracin de su
instancia de Oracle 11g.
Consideraciones adicionales sobre el dimensionamiento dependen de las caractersticas de su
proyecto, y por lo tanto, se recomienda tambin realizar un anlisis detallado cubriendo la
escalabilidad y exigencias de su proyecto.
Configuracin requerida para Bizagi

Para configurar una instancia de Oracle para trabajar con Bizagi, necesitar crear el usuario que utiliza
Bizagi en su instancia de Oracle, ejecutando un script.
Este usuario se conoce como el usuario BizagiAdmon.
En proyectos que se ejecuten sobre una plataforma de .NET, necesita adicionalmente instalar el
conector ODP.NET en el servidor BPM.
Verificando la configuracin en Oracle

Lleve a cabo los siguientes pasos, para asegurarse de que su instancia de Oracle tenga la
configuracin requerida.
Qu versin tengo?
Usted puede verificar la versin de base de datos Oracle y release ejecutando:
select * from v$version;
Si utiliza Oracle 11g R2, deber asegurarse de tener una versin 11.2.0.3.x o superior:
Si utiliza Oracle 10g R2, deber asegurarse de tener una versin 10.2.0.1.x o superior:
21
Revisando la configuracin
Cree el usuario especfico que utiliza Bizagi.
Bizagi se apoya en un usuario en Oracle para realizar tareas de administracin y del proyecto (p.e,
para crear la metadata y estructura inicial de un proyecto de Bizagi, para crear backups, etc).
Este usuario se conoce como BizagiAdmon y su creacin es prerequisito para trabajar con una base
de datos Oracle.
Para crear el usuario ejecutando un script SQL, siga estas instrucciones:
Conctese a su instancia de Oracle como el usuario sys (sysdba)
Edite el script ConfigureInstanceForBizAgi-[Oracle_Version].sql.
22
Ubique la ruta de instalacin de Bizagi Studio y dentro de esta, la ruta del modelo de proyecto donde
est la carpeta de archivos de base de datos (por defecto en C:\Archivos de programa\BizAgi
\ProjectModel\Database\).
Si usted utiliza Oracle 11g R2, edite el script llamado ConfigureInstanceForBizAgi-11g.sql.
Si usted utiliza Oracle 10g R2, edite el script llamado ConfigureInstanceForBizAgi-10g.sql.
Para editar este script, asegrese de remover las lneas comentareadas que definen las variables, y
seguidamente edite sus valores:
BA_TABLES_DATAFILES_DIR: La ruta donde Bizagi crear los datafiles de los tablespaces.
BA_INDEXES_DATAFILES_DIR: La ruta donde Bizagi crear los datafiles de los ndices.
BA_BACKUP_PATH: La ruta donde Bizagi almacenar los respaldos (backups).
BA_BIZAGIADMON_PASSWORD: La contrasea para el usuario BizagiAdmon.
Ejecute el script.
Ejecute el script asegurndose que la operacin sea existosa.
23
El script anterior puede cambiar en cada versin de Bizagi.

Por lo tanto, siempre debe tomar el script en cuestin que corresponda a la versin instalada de
Bizagi.
Paso adicional
Si su proyecto se ejecuta en una plataforma de .NET, deber instalar el conector ODP.NET como se
describe en Instalacin de Oracle Data Provider.
Instalacin de Oracle Data Provider para .NET
Introduccin
Bizagi Engine utiliza el conector de Oracle Data Provider para .NET (ODP.NET), para conectarse con
bases de datos Oracle, cuando los procesos de Bizagi se ejecutan sobre una plataforma de .NET.
El conector se requiere cuando Oracle se usa como la base de datos de los procesos de Bizagi, o
tambin cuando se integran bases de datos externas de Oracle (mediante la Virtualizacin o
Replicacin de Bizagi).
Este conector se requiere sobre el servidor de base de datos sino en el servidor BPM donde se
ejecuta el proyecto de Bizagi.
La siguiente tabla ilustra en qu escenarios se requiere este conector y en qu servidores instalarlo:
Instalacin ODAC requerida?
Servidor BPM
Servidor donde se ejecuta el

Programador (usualmente el
mismo Servidor BPM)
Usando Oracle como la base de datos de Bizagi
Si
Si
Usando Virtualizacin para integrar Oracle
Si
No
No
Si
Usando Replicacin para integrar Oracle
24
Para instalar el componente siga estas instrucciones.
1. Escoger el instalador adecuado

El conector Oracle Data Provider para .NET se instala a travs de los componentes para el acceso de
datos a Oracle (ODAC).
Bizagi utiliza la versin ODAC 11g, la cual puede ser descargada directamente desde el sitio oficial de
Oracle.
Para una configuracin de Bizagi con soporte a 64 bits, descargue la versin 11.2.0.3.0 x64 para el
framework 4.0, desde:
http://www.oracle.com/technetwork/database/windows/downloads/index-090165.html
2. Instalar ODAC y su conector ODP.NET

Ejecute el instalador donde tenga instalado Bizagi Studio, y asegrese de seleccionar la opcin Oracle
Data Access Components for Oracle Client:
Seguidamente, asegrese de marcar Oracle-Data-Provider for .NET:
25
D clic en Instalar para completar el procedimiento.

Una vez completado, ser notificado que puede cerrar el instalador.
Vea mayor informacin sobre este conector, e instrucciones detalladas del ODAC en: http://
www.oracle.com/technology/software/tech/windows/odpnet/install1110720.html.
3. Repita la instalacin en otros servidores, segn aplique

Si usted cuenta con un clster de BPM o si tiene el servicio Scheduler instalado en un servidor
diferente, asegrese de instalar el conector en estas los otros servidores .
Cuando se configura un entorno de trabajo colaborativo, los usuarios de Bizagi Studio tambin
debern instalar este conector en sus estaciones de trabajo.
Este conector tambin es necesario si se utiliza la Virtualizacin o Replicacin de datos como
caractersticas de integracin en Bizagi, para conectar el proyecto a una fuente externa de Oracle.
Ntese que:
El servidor de base de datos no requiere de este componente.
No se requiere que las estaciones de los usuarios finales instalen este componente.
Los usuarios finales acceden al portal de Bizagi, por lo que nicamente requieren de un navegador.
26
Configuracin de Bizagi ODS
Introduccin
Bizagi ODS presenta la opcin de configurar un Almacn de datos operacionales (ODS), para que las
consultas usen esta conexin y as mejorar la disponibilidad y rendimiento de los Procesos
ejecutndose sobre el Servidor BPM.
El concepto detrs del ODS de Bizagi, es separar los recursos involucrados en las opciones de Anlisis
y BAM del Portal de Trabajo, de los dems recursos empleados en las actividades del da a da de los
Procesos.
Vea ms informacin sobre las opciones de Anlisis e indicadores.
Esta funcionalidad es especialmente poderosa y til en aplicaciones de misin crtica, donde se maneja
un gran volumen de datos dentro de la informacin de solicitudes de consultas de anlisis, y no
debemos afectar el rendimiento de la ejecucin de los Procesos en la aplicacin.
Cmo funciona?
A travs del ODS de Bizagi, las opciones de Anlisis y BAM utilizarn una conexin diferente, a una
Base de datos replicada con respecto a la Base de datos donde se realizan las transacciones diarias.
Esto permite que las solicitudes realizadas sobre opciones de anlisis (opciones enfocadas a
monitoreo, reportes, mejora continua e indicadores) donde se maneja un gran volumen de datos, se
lleven a cabo sin competir con los recursos asignados a la ejecucin como tal de los Procesos.
El siguiente diagrama ilustra el diseo en Bizagi ODS:
Lo que debe hacer

Para utilizar el ODS de Bizagi, como prerrequisito, se debe configurar la replicacin de la Base de
datos repositorio de los Procesos (Base de datos del Proyecto de Bizagi).
27
Esta configuracin de replicacin se realiza desde las opciones del manejador de la instancia de la
Base de datos como tal, donde dichas opciones difieren de acuerdo al motor de Base de datos (SQL
Server u Oracle)
Una vez que se establezca la replicacin de acuerdo a las recomendaciones enumeradas a

continuacin, la configuracin del ODS en Bizagi es muy simple: se especifican los parmetros de
conexin a la Base de datos rplica.
Ms informacin sobre cmo llevar a cabo la replicacin, se puede revisar en los enlaces externos:
Sobre SQL Server 2008 o 2008 R2: http://technet.microsoft.com/en-us/library/ms151198.aspx.
Sobre SQL Server 2005: http://technet.microsoft.com/en-us/sqlserver/bb895875.
Sobre Oracle: http://www.orafaq.com/wiki/Advanced_Replication_FAQ
La siguientes recomendaciones se presentan como gua para enumerar los aspectos importantes que
se deben tener en cuenta en la configuracin de la replicacin de la Base de datos de Bizagi. Para una
gua detallada sobre los pasos para realizar esto, por favor dirjase a la documentacin de la base de
datos en:
http://www.sql-server-performance.com/2010/transactional-replication-2008-r2/
Lista gua para la configuracin de la replicacin

Cabe mencionar que la configuracin apropiada de una replicacin de Base de datos, as como su
configuracin de seguridad, son responsabilidad del DBA.
Esta gua y recomendaciones se enfoca en buenas prcticas y requerimientos de cara a la
configuracin del ODS en Bizagi.
1. La Base de datos de Bizagi es la nica que publica informacin.

Esto significa que sin importar cuntos distribuidores intermediarios se utilicen, la Base de datos de los
28
Procesos de Bizagi debe ser la nica de la cul proviene realmente la replicacin de datos.
2. Replicacin en tiempo real.

Para lograr la actualizacin de informacin de la manera ms acertada, y que se refleje la totalidad de
los datos al consultar las opciones de Anlisis y BAM, se debe transmitir rpidamente la informacin en
la replicacin. Por ejemplo y si se utiliza SQL Server, la replicacin transaccional cubre este
requerimiento.
3. Replicacin en una sola va.
Las operaciones en el ODS no deben afectar la Base de datos principal de Bizagi. En las consultas
sobre el ODS, puede guardarse informacin sobre las mismas, e internamente se manejan
agregaciones, datos temporales, tablas intermedias y otra informacin no relevante para la ejecucin
de Procesos. Por lo tanto, esto no debe verse reflejado hacia la Base de datos principal. Por ejemplo y
si se utiliza SQL Server, nuevamente la replicacin transaccional cubre este requerimiento.
4. Estimacin apropiada de bloques de replicacin.
Dado que hay transacciones de escritura en la Base de datos que pueden llegar a involucrar una gran
cantidad de datos (por ejemplo, cuando se adjuntan archivos en las instancias de Proceso), se
recomienda que se realice una estimacin adecuada de los artculos de replicacin y su configuracin.
Esta estimacin puede realizarse sobre el ambiente de pruebas de la solucin.
Por ejemplo y si se utiliza SQL Server, el parmetro de Max Text replication Data define el tamao
que en trminos de Bizagi, es apropiado usualmente de 3 a 5 MB.
5. Credenciales apropiadas para la replicacin.
Es frecuente y obedece a una buena prctica, que la Base de datos principal y el ODS se ubiquen en
Servidores de Base de datos diferentes.
Siendo as, asegrese de tener las cuentas del dominio para ejecutar las tareas y servicios de
replicacin, como por ejemplo las que inician el Agente de SQL Server.
Evite utilizar cuentas como la del sistema local ("Local System"), dado que estas credenciales no tienen
el acceso a otras ubicaciones en la red, e igualmente no se autentica frente a la red.
Definir el ODS en Bizagi

Una vez que se haya configurado la replicacin de la Base de datos hacia el ODS, la configuracin de
la conexin hacia el ODS en Bizagi se realiza a travs del Management Console para cualquier
ambiente (produccin, pruebas, desarrollo), como se describe a continuacin:
1. Edite las opciones del entorno.
Ejecute el Management Console y abra su proyecto Bizagi en el ambiente de pruebas o produccin.
Vaya a la pestaa Avanzado, d clic sobre Opciones para abrir la configuracin del entorno.
29
Esta opcin tambin est disponible a travs de Bizagi Studio para el ambiente de desarrollo:
30
2. Ubique la configuracin del ODS.

Debajo de las opciones avanzadas, ubique la seccin del Almacn de datos operacional, y configure la
conexin hacia su Base de datos replicada.
3. Configure la conexin.
Para configurar la conexin, primero escoja el tipo de Proveedor.
Cuando se utiliza en Bizagi una plataforma .NET considere lo siguiente:

Para SQL Server, ingrese los detalles de la cadena de conexin teniendo en cuenta:
Servidor: El Servidor e instancia donde se encuentra la Base de datos replicada.
Base de datos: La Base de datos replicada (ODS).
Usuario: La cuenta para acceder a la instancia de SQL Server.
Contrasea: La contrasea para esa cuenta de login.
31
Para Oracle, ingrese los detalles de la cadena de conexin teniendo en cuenta:

Servicio: La cadena de conexin a la instancia de Oracle. Debe tener el siguiente formato:
[ServidorBD]:[puerto]/[servicio]
Usuario: El esquema de usuario que representa la Base de datos replicada.
Contrasea: La contrasea para ese esquema de usuario.
Ejecucin
Una vez que esta informacin est configurada, las opciones de Anlisis y BAM del Portal de Trabajo
utilizarn inmediatamente la conexin al ODS y sin usar diferentes fuentes que involucren las
actividades diarias de los usuarios.
32
Definicin del ODS en el Servidor de Aplicaciones JEE
Introduccin
Si su proyecto se ejecuta sobre una plataforma JEE, al usar la opcin del ODS en Bizagi, deber definir
la fuente de datos a nivel de su servidor de aplicaciones JEE.
Esta posibilidad es opcional aunque recomendada para la mejora en el rendimiento y disponibilidad
de los servicios del servidor BPM.
Para mayor informacin sobre el uso del ODS con Bizagi Engine, consulte Configuracin de Bizagi ODS.
Definicin de la fuente de datos del ODS

Una vez haya configurado la replicacin a su fuente de datos, asegrese de registrar y definir la fuente
de datos en su servidor de aplicaciones JEE.
Este paso difiere ligeramente segn el servidor de aplicaciones JEE que utilice (WebSphere, Weblogic,
JBoss).
Configuracin en WebSphere
Para definir y registrar la fuente de datos al ODS en WebSphere, tenga en cuenta que puede utilizar el
Proveedor JDBC que se tenga previamente definido para la conexin al Portal de Bizagi.
Al reutilizar este proveedor, solamente se debe crear una nueva fuente de datos (un Data Source).
Para ello, acceda a la consola administrativa y ubique el panel a la izquierda para ir rpidamente al
enlace de Fuentes de datos (Data sources), ubicado todava bajo la seccin de recursos (Resources)
sobre el item JDBC.
33
Asegrese de seleccionar el scope que incluye la instancia del servidor (o el clster si tiene una
configuracin en clster).
Cree una fuente de datos haciendo clic sobre el botn Nuevo (New).
En la configuracin de la nueva fuente de datos, ingrese la siguiente informacin:
Data source name (nombre de la fuente de datos): Ingrese un nombre nico.
Tenga presente que este nombre ser el que debe referenciar para el registro del ODS en la
configuracin desde Bizagi.
JNDI name (nombre JNDI): Puede ingresar el mismo nombre que asign en la anterior propiedad (el
nombre de la fuente de datos).
Asegrese de usar Select an existing JDBC Provider el proveedor de datos JDBC de acuerdo a su
motor de Base de datos (Oracle o SQL Server).
34
Si usted utiliza una Base de datos Oracle, d clic en Siguiente (Next) y asegrese de editar la URL de
la cadena de conexin.
Para el valor de la URL, ingrese la informacin de conexin a su instancia de Oracle. Esta conexin
debe tener el siguiente formato:
jdbc:oracle:thin:@[database_server]:[port_number]:[service_name]
Considere:
o database_server: El Servidor de Base de datos. Puede utilizar el SID en cambio.
o port_number: El puerto bajo el cual el servicio de la Base de datos atiende. En Oracle por defecto, es
el puerto 1521.
o service_name: El nombre del servicio de la instancia Oracle.
Una vez que haya configurado la conexin a su instancia Oracle, d clic en Siguiente (Next ) en las
ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en
Finalizar --Finish-- para crear la fuente de datos).
Por otro lado, y si usted utiliza una Base de datos SQL Server, d clic en Siguiente (Next) en las
ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic
en Finalizar --Finish-- para crear la fuente de datos).
No se requiere configuracin adicional e igualmente se pueden mantener los valores por defecto de
WebSphere.
D clic sobre la fuente de datos creada (independientemente del motor de Base de datos: Oracle o
SQL Server), para configurar las propiedades adicionales.
Para ello, d clic en el enlace de propiedades personalizadas (Custom properties) ubicado en la
seccin de Propiedades adicionales (Additional Properties).
35
Edite las propiedades como se describe a continuacin (de acuerdo a su motor de Base de datos), y
asigne los valores correspondientes de la conexin.
Para Oracle:
Cree 2 nuevas propiedades: usuario (user) y contrasea (password). Para sus valores considere:
o user: El esquema de usuario que representa el proyecto Bizagi.
o password: La contrasea de ese esquema de usuario.
Para SQL Server:
Edite las siguientes propiedades.
o serverName: El nombre del Servidor de Base de datos.
o portNumber: El puerto bajo el cual la instancia atiende. En SQL Server y por defecto, es el puerto
1433.
o databaseName: El nombre de la Base de datos que corresponde al proyecto.
o user: La cuenta login para acceder a la Base de datos.
o password: La contrasea de esa cuenta login.
Al finalizar con la edicin de propiedades, haga clic en Guardar(Save) para aplicar los cambios.
Configuracin en Weblogic
Para definir y registrar la fuente de datos del ODS en Weblogic, tenga en cuenta que solamente se
debe crear la fuente de datos (se selecciona un proveedor de datos existente).
Para ello, acceda a la consola administrativa y vaya a la seccin de Servicios (Services) y d clic sobre
fuentes de datos (Data Sources).
36
Cree una nueva fuente de datos dando clic sobre Nuevo (New) y especificando que es una fuente de
datos de tipo genrica (Generic Data Source).
Para la fuente de datos, especifique:
Data source name (nombre de la fuente de datos): Ingrese un nombre nico.
Tenga presente que este nombre ser el que debe referenciar para el registro del ODS en la
configuracin desde Bizagi.
JNDI name (nombre JNDI): Puede ingresar el mismo nombre que asign en la anterior propiedad (el
nombre de la fuente de datos).
Seguidamente, y para una Base de datos replicada en Oracle, seleccione Oracle como el tipo de Base
de datos (Database type).
D clic en Siguiente (Next) y seleccione el driver Oracles Driver (Thin) for instance
connections; Versions: 9.0.1 and later (Database Driver).
Si est utilizando una Base de datos replicada en SQL Server, entonces seleccione MS SQL Server
como el tipo de Base de datos (Database type). D clic en Siguiente (Next) y seleccione el driver
Microsoft's MS SQL Server Driver (Type 4) Versions:2005 and later (Database
Driver).
D clic en Siguiente (Next) para especificar los detalles de la conexin, independientemente de si su

motor de Base de datos es Oracle o SQL Server. En ello, asegrese de editar y revisar la URL de la
conexin.
Finalice la configuracin cerciorndose que la fuente de datos aplique al contexto de su instancia (o de
su clster, si utiliza una configuracin con esquema de alta disponibilidad).
Finalmente, asegrese de activar los cambios realizados.
37
Qu sigue?
Una vez haya finalizado, asegrese de configurar la fuente de datos del ODS en Bizagi (como se
describe en Configuracin del ODS en el Servidor de aplicaciones JEE), teniendo en cuenta el uso del
nombre exacto de la fuente de datos que se defini en esta seccin.
Configuracin del servidor BPM

Para configurar el servidor BPM de Bizagi Engine, asegrese de contar previamente con una base de
datos ya instalada.
Para ms informacin sobre este requerimiento, consulte Configuracin del servidor de base de datos.
La capa BPM soporta una configuracin de balanceo de cargas para la escalabilidad de la solucin
(usando configuracin enc clster con nodos adicionales).
Bizagi BPM Suite soporta la ejecucin de procesos en una plataforma .NET o una plataforma JEE.
Para plataformas en .NET, un entorno Windows es utilizado con Internet Information Services (IIS) como
Servidor Web.
Si usted ejecuta sus procesos sobre una plataforma .NET, consulte Configuracin de Bizagi Engine
spbre plataforma .NET.
38
Para la plataforma JEE, los Servidores de Aplicacin ms representativos del mercado son soportados:
WebLogic, WebSphere, y JBoss.
Si usted ejecuta sus procesos sobre una plataforma JEE, consulte Configuracin de Bizagi Engine sobre
plataforma JEE.
Configuracin de Bizagi Engine sobre plataforma .NET
Introduccin
Cuando se ejecutan los procesos sobre una plataforma de .NET, Bizagi configura automticamente su
proyecto para los ambientes: desarrollo, pruebas y produccin.
La configuracin del ambiente de ejecucin de Bizagi Engine (Servidor BPM y Servidor de Base de
datos) se realiza como se describe a continuacin:
1. En el ambiente de desarrollo, esto lo realiza Bizagi cuando se crea el proyecto.
Para este ambiente, primero se instala Bizagi asegurndose de incluir los componentes para la
automatizacin (Bizagi Studio).
Esta instalacin garantizar que los componentes adicionales requeridos por Bizagi Studio o la
ejecucin de los procesos (p.e el framework de .NET) sean incluidos.
2. En el ambiente de pruebas o de produccin, esto lo realiza Bizagi a travs d la funcionalidad de
Deployment en un clic,que se presenta desde Bizagi Studio.
Esto significa, que cuando se haya completado las fases de implementacin y automatizacin de
procesos, se publican los procesos a un ambiente de pruebas o produccin con esta opcin Bizagi
configura el ambiente.
Para ms informacin acerca del Deployment en un clic, consulte el Deployment de los procesos.
Para utilizar el Deployment en un clic, deber tener instalado Bizagi en su servidor BPM de pruebas o
produccin.
Tenga en cuenta que para esta instalacin, no requiere de Bizagi Studio y nicamente requiere instalar
los componentes de ejecucin para pruebas o produccin.
instalacin garantizar que los componentes adicionales requeridos por la ejecucin de los procesos
(p.e el framework de .NET) sean incluidos.
39
En escenarios sofisticados, donde no sea viable instalar los componentes usados por Bizagi a travs
de su instalador, o donde el uso del Deployment en un clic no aplique, entonces podr configurar de
manera manual el ambiente de ejecucin de pruebas o de produccin.
Estos escenarios son principalmente cuando:
El Deployment en un clic no satisface las necesidades porque el servidor de produccin no est en la
misma red del servidor de desarrollo (y se requiere un Deployment offline).
Es estrictamente requerido instalar y desplegar Bizagi (aplicar paquetes de Deployment) de manera
manual, debido a polticas corporativas).
Si desea realizar una configuracin manual del sistema Bizagi en un ambiente de Pruebas o de
Produccin, siga las instrucciones de las siguientes secciones.
Instalacin del IIS
Introduccin
Bizagi Engine provee un Portal de trabajo como aplicacin web final a los usuarios para que hagan
login, accedan a los procesos y trabajen en sus actividades diarias.
En proyectos de Bizagi ejecutndose sobre una plataforma .NET, este portal de trabajo se configura
sobre Microsoft Internet Information Services (IIS).
Versiones soportadas
Las siguientes versiones son soportadas:
VERSIN IIS
SISTEMA OPERATIVO
8.5
Windows Server 2012, Windows 8.1
8.0
Windows Server 2012, Windows 8
7.5
Windows Server 2008 R2, Windows 7
7.0
Windows Server 2008, Windows 7, Windows Vista
6.0
Windows Server 2003, Windows XP
Configuracin requerida
Para configurar que IIS funcione con Bizagi, necesita habilitarlo en su sistema operativo Windows y
asegurarse de que activ las siguientes funcionalidades del mismo:
GRUPO DE FUNCIN DE
IIS
FUNCIN DE IIS
APLICA PARA...
40
Web Management Tools
IIS 6 Metabase compatibility
IIS versions 7 o superior.
IIS Metabase y IIS 6

configuration compatibility
IIS Management Console
.NET Extensibility
IIS versions 7 o 7.5.
.NET Extensibility 4.5
ASP.NET
IIS versions 7 o 7.5.
ASP.NET 4.5
Funcionalidades comunes
de HTTP
Contenido Esttico
Funcionalidades de
desempeo
Compresin de Contenido
Esttico
IIS versions 7 o superior, para

mejoras en el rendimiento.
Contenido Esttico dinmico
IIS versions 7 o superior, para

mejoras en el rendimiento.
Autenticacin de Windows
IIS versions 7 o superior, cuando se

usa autenticacin Windows.
Servicios World Wide Web
Seguridad
Verificar la configuracin del IIS

Siga las instrucciones para verificar una correcta instalacin y configuracin del IIS para trabajar con
Bizagi.
Consulte la seccin que corresponda a su sistema operativo.
Windows Server 2012

Windows Server 2012 trabaja con Internet Information Services en su versin 8.5 o 8.0.
Para revisar la instalacin del servidor y los componentes que requiere Bizagi, siga los pasos a
continuacin.
1. Ubique las opciones de administracin de servidor.
Esta administracin est disponible dando clic derecho sobre Mi PC y seleccionando Administrar o
sobre el cono de acceso rpido:
41
Ntese que para ello, se requiere de permisos de administrador.

2. En la ventana de administracin (Server Manager), ubique la opcin rpida desde el Dashboard y
utilice Adicionar roles y caractersticas (Add Roles and features).
Esta opcin inicia un asistente para configurar el IIS seleccionando los tems y componentes.
Ntese que cuando se inicie el asistente de instalacin, se mostrar una pgina de introduccin
informativa y para que se revise lo siguiente:
La cuenta del administrador tiene una contrasea segura.
Las direcciones IP y dems temas de red ya estn configurados.
Se tienen las ltimas actualizaciones de Windows para el sistema operativo.
Puede escoger saltarse esta pgina para las configuraciones a futuro.
3. Seleccione Role-based or feature-based installation y d clic en Siguiente (Next).
42
4. Utilice la opcin de seleccionar el servidor Web desde el pool (Select the Web Server from the
server pool), de manera que se ubique el servidor local para la instalacin y se adicionen los roles
requeridos.
43
D clic en Siguiente (Next).

5. Marque la opcin del Servidor Web (IIS) como los roles del servidor que va a instalar.
44

Cuando se le pregunte por las caractersticas requeridas, asegurese de adicionar los requerimientos
(haciendo clic en Adicionar caractersticas).
45
Asegrese de marcar las casillas como se ensea a continuacin:
46
47
D clic en Siguiente y revise la configuracin general de roles del servidor Web. D clic en Siguiente.
6. Confirme la seleccin de configuracin para la instalacin y d clic en Finalizar (Finish) para iniciar
con la instalacin:
Una vez finalizada la instalacin, una ventana mostrar el xito del procedimiento y qu roles y
servicios fueron instalados.
Note que el enlace de exportar la configuracin le permite opcionalmente reutilizar esta configuracin
a travs de PowerShell en algn otro equipo.
48
Haga clic en Cerrar (Close).
Windows 8.1 o Windows 8

Windows 8.1 incluye Internet Information Services en su versin 8.5.
Windows 8 incluye Internet Information Services en su versin 8.0.
En estos sistemas operativos, la instalacin del IIS no se incluye por defecto, por loq que de igual
manera no cuenta con los componentes requeridos habilitados.
Para revisar la instalacin y adicionar los componentes que hacen falta, se deben activar los
componentes de Windows desde el Panel de control como se muestra a continuacin.
1. Vaya al Panel de Control\Programas\Programas y componentes, y d clic en Habilitar/deshabilitar
componentes de windows.
49
2. Asegrese de marcar las casillas de los componentes como se ensea a continuacin.

Ntese que algunas casillas ya estn marcadas por defecto, y estas deben mantenerse activas,
50
51
3. D clic en OK para finalizar la configuracin.

Ntese que esto puede tardar algunos minutos y que estos cambios muy posiblemente requieran
reiniciar la mquina.
Windows Server 2008 R2 o Windows Server 2008

Windows Server 2008 y Windows Server 2008 R2 incluyen Internet Information Services en su versin
7.5.
En estos sistemas operativos, la instalacin del IIS se realiza como un rol, y se configura con estos
pasos:
1. Vaya a Inicio\Programas\Herramientas administrativas\Administrador del servidor.
Esta administracin tambin esta disponible desde las opciones del clic derecho sobre Mi PC. Ntese
que para ello, se requiere de permisos de administrador.
2. En la ventana de administracin del Servidor, ubique el item de roles, y seleccione la opcin de

Adicionar Roles.
52
Esta opcin inicia un asistente para configurar el IIS seleccionando los items y componentes.
53
Ntese que cuando se inicie el asistente de instalacin, se mostrar una pgina de introduccin
informativa y para que se revise lo siguiente:
La cuenta del administrador tiene una contrasea segura.
Las direcciones IP y dems temas de red ya estn configurados.
Se tienen las ltimas actualizaciones de Windows para el sistema operativo.
Puede escoger saltarse esta pgina para las configuraciones a futuro.
3. Marque la opcin del Servidor Web (IIS) para que los componentes del IIS se muestren a
continuacin.
Esto permite la adicin de sus roles.
Haga clic en Siguiente.

En la siguiente ventana se muestra la informacin general del IIS, donde no se requiere accin alguna.
Haga clic en Siguiente cuando haya revisado la informacin.
54
4. Seleccione los servicios de rol que se requiere para el Portal de Trabajo de Bizagi.
55
56
Haga clic en Siguiente despus de asegurarse que haya marcado todos los componentes y subcomponentes.
Ntese que para marcar algunos componentes, se requiere la adicin de algunos roles.
Para ello, el asistente le avisar, y debe asegurarse de adicionar los requerimientos de estos roles
(haciendo clic en Adicionar los servicios de roles requeridos).
5. Una ventana de confirmacin aparece con el resumen de los roles y servicios que se instalarn.
57
Una vez que proceda y de el visto bueno, comenzar la instalacin.
6. Una vez finalizada la instalacin, una ventana mostrar el xito del procedimiento y qu roles y
servicios fueron instalados.
Este cambio requiere que se reinicie el Servidor.
Windows Vista o Windows 7

Windows Vista y Windows 7 incluyen Internet Information Services en su versin 7.0.
En tales sistemas operativos, la instalacin del IIS se incluye por defecto pero no cuenta con todos los
componentes habilitados.
Para revisar la instalacin y adicionar los componentes que hacen falta, se deben activar los
componentes de Windows desde el Panel de control como se muestra a continuacin.
1. Vaya al Panel de Control\Programas\Programas y componentes, en el men de izquierda, y d clic
en Habilitar/deshabilitar componentes de windows.
58
2. Asegrese de marcar las casillas de los componentes como se ensea a continuacin.

Ntese que algunas casillas ya estn marcadas por defecto, y estas deben mantenerse activas ya que
hacen parte de la configuracin.
59
3. D clic en OK para finalizar la configuracin.
60
Ntese que esto puede tardar algunos minutos y que estos cambios muy posiblemente requieran
reiniciar la mquina.
Windows Server 2003 o Windows XP

Windows Server 2003 y Windows XP no incluyen por defecto el IIS.
En estos sistemas operativos, para instalar el IIS se requiere del CD de instalacin de Windows.
1. Vaya al Panel de control y seleccione la opcin de Agregar o remover programas.
En esta ventana, seleccione Adicionar/remover componentes de Windows desde el botn del panel a
la izquierda.
2. Se muestra una nueva ventana donde los componentes adicionales disponibles de Windows se
pueden seleccionar.
Seleccione el componente Servidor de aplicacin en la ventana donde se listan los componentes a
instalar. D clic en Detalles.
61
3. Marque la casilla del componente Internet Information Server(IIS).
62
D clic en OK y despus en Siguiente para iniciar la instalacin.

4. Una vez se complete la instalacin, el sistema le notificar que debe reiniciar el equipo.
Despus de configurar el IIS 5 o 6, es posible que requiera de configuracin adicional para cada
aplicacin Web que crea Bizagi.
Esto significa que despus de crear un proyecto Bizagi, debe revisar los pasos siguientes para cada
proyecto.
Crear un mapeo de ISAPI (ISAPI Wildcard mapping) que referencie el filtro ASP.NET ISAPI:
Abra el administrador del IIS (IIS Manager) y ubique su sitio web (expanda los items para
navegar).
En IIS 5, d clic derecho sobre su directorio virtual (de la aplicacin) y seleccione las propiedades.
En IIS 6, d clic derecho sobre su sitio y seleccione las propiedades.
En IIS 5, seleccione la pestaa del directorio virtual. En IIS 6, seleccione la pestaa del directorio de
inicio Home.
D clic en el botn de configuracin.
La pestaa para el mapeo a nivel de aplicaciones debe estar visible.
D clic en el botn de insertar.
En el texto de ejecutable (Executable), digite la ruta completa al ensamblado del filtro ISAPI
(ASP.NET ISAPI filter DLL).
Para ASP.NET 4, esta ruta usualmente es: "C:\Windows\Microsoft.NET\Framework\v4.0.30319
\aspnet_isapi.dll"
En el texto de extensin (Extension), digite: .*
Importante: Desmarque la opcin de verificar (Verify).
D clic en Ok en ambos dilogos para retornar al administrador del IIS (IIS Manager). Hemos
finalizado los cambios.
Ejecute un iisreset
Importante
Tenga en cuenta:
1. Si se instala el IIS despus de instalar el Framework de .NET de Microsoft, es posible que tenga que
registrar dicho framework en el IIS de manera manual.
Para ello, se puede utliizar el comando aspnet_regiis -i desde la ruta del framework (por defecto en
C:\Windows\Microsoft.NET\Framework\[version]\.
2. Si se instala el IIS despus de haber instalado Bizagi (el servicio Server Operations Service), entonces
deber reinstalar dicho servicio o ejecutar los siguientes comandos:
%systemroot%\system32\inetsrv\APPCMD
httpCompression
serverRuntime
unlock
config
-section:system.webServer/
unlock
config
3. El IIS debe tener el sitio por defecto llamado Default Web site, ya que all Bizagi crear el Portal de
63
Trabajo para los proyectos.
Configuracin del sistema Bizagi
Introduccin
Esta seccin describe cmo configurar Bizagi Engine manualmente para un ambiente de pruebas o de
produccin que se ejecuta sobre una plataforma de .NET.
Tenga en cuenta que estos pasos de configuracin no se requieren cuando se utiliza el Deployment en
un clic de Bizagi.
Para ms informacin sobre en qu escenarios es til realizar esta configuracin manual, consulte
Configuracin de Bizagi Engine sobre plataforma .NET.
Para llevarlo a cabo, se parte de que en el ambiente de desarrollo se han implementado los procesos.
La ruta
donde Bizagi se instal en el ambiente de desarrollo, ser referenciada como
<BIZAGI_PATH> a partir de este momento (la ruta por defecto es C:\Program Files\BizAgi
\[edicin_Bizagi]\).
Prerrequisitos
La instalacin de Bizagi incluye los componentes bsicos que requiere el Servidor BPM.
Ntese que Bizagi no requiere de componentes adicionales en el servidor de Base de datos.
Al instalar de manera manual el ambiente de ejecucin de Bizagi, deber asegurarse de que el
Servidor BPM cuente con estos componentes instalados:
1. Microsoft .NET Framework 4.0 full.

Puede descargar e instalar este componente directamente desde los sitios oficiales de Microsoft en:
http://www.microsoft.com/en-us/download/details.aspx?id=17718.
2. Componentes habilitados del Internet Information Services.
Para asegurarse de que su Servidor BPM cuenta con una versin soportada de IIS y tiene habilitados
los componentes necesarios, consulte la Instalacin del IIS.
3. Componentes adicionales segn su proyecto.
Si usted utiliza una base de datos Oracle como repositorio de sus procesos, o utiliza la
Virtualizacin/Replicacin de Bizagi para conectarse a una fuente de datos externa Oracle, entonces
deber instalar el componente ODP.NET como se describe en Instalar ODP.NET de Oracle.
Si su proyecto fue creado en versiones anteriores a Bizagi 10.x (y ahora ha sido actualizada a una
versin de Bizagi 10.x) - por ejemplo un proyecto creado originalmente en Bizagi 9.1.x-, entonces
deber instalar el componente Microsoft Visual J# 2.0 SE.
Para ms informacin sobre los requerimientos de sistema, consulte Requerimientos de Bizagi.
64
Otros componentes como los provistos por SQL Server 2005 y Visual C++ 2008, no son requeridos
en el ambiente de ejecucin dado que se usan nicamente por Bizagi Studio en el ambiente de
desarrollo.
Antes de comenzar
Antes de configurar Bizagi en un ambiente de produccin, tenga en cuenta que debe contar con las
licencias correspondientes para activar el Portal de trabajo.
Esta licencia deber tenerse a la mano para ser activada en el Servidor BPM de produccin, de lo
contrario, el Portal de Bizagi no quedar operativo.
Para ms informacin sobre el licenciamiento por favor contctenos a sales@Bizagi.com.
Si su configuracin incluye una configuracin en clster de su Servidor BPM (mltiples nodos para
soportar el balanceamiento de cargas), entonces usted podr llevar a cabo los pasos descritos a
continuacin pero deber contactar a nuestro equipo de soporte para la activacin de la licencia en
su ambiente en clster.
Lo que debe hacerse

Una vez que haya revisado que se cumplan los prerrequisitos, para configurar su ambiente de pruebas
o de produccin de Bizagi, siga estos pasos (detalle y gua completa proporcionada en la seccin de
Procedimiento):
1. Crear la base de datos del ambiente de produccin o de pruebas
En este paso, se publican aquellos procesos que ya han sido implementados en su etapa de
desarrollo, y se publican a una base de datos diferente a la que se usa en el ambiente de desarrollo.
2. Crear la estructura de carpetas de su proyecto
En este paso, se crea un directorio y su estructura de sub directorios relevantes para el proyecto de
Bizagi.
3. Instalar y configurar el Portal de trabajo
En este paso, se instala el Portal de trabajo en el servidor Web (IIS).
4. Instalar y configurar el servicio programador
En este paso, se instala el servicio programador como un servicio Windows (el servicio programador
est a cargo de ejecutar tareas offline o en lote que realiza el sistema).
5. Activar la licencia.
En este paso, se activa la licencia ya comprada para soportar sus usuarios de pruebas o de
produccin.
Procedimiento
Lleve a cabo lo siguiente:
65
1. Crear la base de datos del ambiente de produccin o de pruebas

Cuando no se utiliza la funcionalidad del Deployment en un clic, deber entonces crear la base de
datos de su ambiente de pruebas o produccin.
La creacin de esta base de datos se lleva a cabo mediante el uso de la herramienta de Deployment
avanzado.
Para ms informacin consulte el Deployment avanzado.
Una vez que haya completado este paso, asegrese de conocer los detalles de conexin a la base de
datos de pruebas o de produccin creada (estos detalles sern necesarios para configurar el Portal de
trabajo y el servicio programador).
2. Crear la estructura de carpetas de su proyecto

Antes de instalar los componentes del ambiente Bizagi, asegrese de asignar una ruta en el servidor
BPM Server, en la cual se ubicarn la estructura y archivos relevantes al proyecto de Bizagi.
Tenga en cuenta:
La ruta, a partir de la cual se crea un directorio, ser referenciada como <RUTA_PROYECTO> a partir
de este momento.
Cree un directorio en el, cuyo nombre sea igual al del proyecto.
Dentro del directorio que haya creado, deber igualmente crear los siguientes sub directorios:
Backups, ComponentLibrary, Database, Docs, Domains, EntityManager, Resources, SOA, Temporary,
Tools, y Trace.
La estructura de <RUTA_PROYECTO>\[Su_proyecto]\ en este punto deber ser como se ilustra:
66
3. Instalar y configurar el Portal de trabajo

Para instalar el Portal de trabajo de Bizagi, deber copiar la estructura y archivos web de Bizagi hacia
<RUTA_PROYECTO>\[Su_proyecto]\.
Esto paso en particular se realiza en ms de un servidor BPM si su solucin va a ser configurada en

clster, para soportar el balanceo de cargas.
Por lo tanto para un ambiente en clster, asegrese de instalar y configurar el Portal en cada nodo.
3.1. Copie la carpeta Web application.
Tome una copia de la carpeta llamada WebApp que se encuentra en la ruta de instalacin de Bizagi
(por defecto ubicada como <BIZAGI_PATH>\ProjectModel\WebApp\), y ubquela en la ruta
asignada para su proyecto Bizagi (bajo <RUTA_PROYECTO>\[Su_proyecto]).
3.2 Revise los permisos del folder para el Portal.

Una vez que haya copiado la carpeta WebApp en la ruta local, asegrese de que no quede marcada
como slo lectura.
Para revisar los permisos, haga clic derecho sobre la carpeta y seleccione sus propiedades donde la
casilla read-only deber estar desmarcada:
67
Seguidamente, asegrese tambin de otorgar permisos de full control:

CUENTA
PRIVILEGIOS
NETWORK SERVICE
Full control
Ntese que ac utilizamos la cuenta Network service, pero igual se recomienda utilizar una cuenta de
servicio que tenga estos permisos y est validada ante la red.
68
D clic en Ok para guardar los cambios.

3.3 Preconfigure el Portal de trabajo.
Edite el archivo de configuracin del portal de manera que incluya el detalle de la conexin a la base
de datos de su proyecto.
Para hacerlo, ubique el archivo <RUTA_PROYECTO>\[Su_proyecto]\WebApp\web.config y edite
sus elementos: DSNDB, PROVIDERTYPE y PROJECT de acuerdo a la conexin a la base de datos de
pruebas o de produccin. Realice estos cambios como se describe a continuacin:
Si usted utiliza SQL Server:
<add
key="DSNDB"
value="Persist
ID=[cuenta_login];Password=[contrasea];Data
Catalog=[base_de_datos];" />
Security
Info=True;User
Source=[instancia_bd];Initial
<add key="PROVIDERTYPE" value="MSSqlClient" />

<add key="Project" value="[nombre_proyecto]"/>
Considere:
o [instancia_bd]: La instancia de la base de datos que incluye el nombre del servidor.
o [base_de_datos]: El nombre de la base de datos de su proyecto en este ambiente.
o [cuenta_login]: La cuenta de usuario para autenticarse ante la instancia de base de datos.
o [contrasea]: La contrasea de la cuenta de usuario. Esta informacin podr definirse de manera
69
encriptada.
o [nombre_proyecto]: El nombre del proyecto de Bizagi para este ambiente.
Ntese que este detalle deber corresponder a la base de datos generada a travs del Deployment
Avanzado.
Si usted utiliza Oracle:
<add
key="DSNDB"
value="Data
Source=[servidor_bd]:[puerto]/
[nombre_servicio];User ID=[esquema];Password=[contrasea];Unicode=True;" />
<add key="PROVIDERTYPE" value="Oracle" />
Consider:
o [servidor_bd]: El Servidor de base de datos.
o [puerto]: El nmero del puerto sobre el cual la instancia de base de datos atiende.
o [nombre_servicio]: El identificador del servicio de la instancia de base de datos.
o [esquema]: El nombre de su proyecto Bizagi (visto como esquema de usuario).
o [contrasea]: La contrasea para ese esquema de usuario.
Avanzado.
La siguiente imagen ilustra el cambio en el archivo de configuracin del Portal, para conectarse a una
base de datos SQL Server:
Guarde los cambios y cierre el archivo.
70
Es fundamental asegurarse que el valor de la llave Project (<add key="Project"

value="[su_proyecto]"/>) corresponda al nombre de su proyecto el cual tendr el mismo
nombre del directorio definido como <RUTA_PROYECTO>\[Su_proyecto]\.
Si su servidor BPM utiliza IIS 7 o superior, tenga en cuenta que deber habilitar la funcionalidad de
compresin HTTP para utilizar las mejoras de rendimiento de la aplicacin (como se menciona en la
Instalacin del IIS).
Podr revisar que el archivo web.config contenga la especificacin <httpCompression> (definido
dentro de <system.webServer>) :
3.4 Cree la aplicacin Web del Portal

Para instalar el Portal de trabajo, deber crear su aplicacin Web. Para ello, primero asegrese de
crear un pool de aplicacin dedicado al Portal de trabajo.
Para ello, inicie ejecutando el administrador del IIS (inetmgr).
En el listado de pools de aplicacin, utilice la opcin de adicionar uno nuevo (Add application pool...)
para crear un pool con las siguientes caractersticas:
Name (Nombre): De un nombre nico a este pool.
Si usted utiliza un sistema con soporte a 64 bits, se sugiere que se nombre el pool como Bizagi 64Bit ASP.NET v4.0.
De lo contrario y si usted utiliza un sistema con soporte a 32 bits, se sugiere que se nombre el pool
como Bizagi 32-Bit ASP.NET v4.0.
.NET Framework version (versin del framework de .NET): 4.0.
Manage pipeline mode: Integrated (Integrado).
71
D clic en Ok.
Luego, edite la configuracin del pool para asignar los siguientes valores a sus propiedades:
Enable 32-Bit Applications (Habilitar aplicaciones en modo 32 bits): False (si usted utiliza una
instalacin de 64 bits de Bizagi).
Para instalaciones de 32 bits de Bizagi, seleccione verdadero (True).
Identity (Identidad): Network service
Asegrese de seleccionar la cuenta de que se configur en el paso 3.
Note que ac tomamos la cuenta Network service, ya que esta tiene permisos sobre:
La carpeta WebApp del portal de trabajo ubicada como: <RUTA_PROYECTO>\[Su_proyecto]
\WebApp\
Las carpetas temporales que utiliza el framework de .NET como por ejemplo C:\Windows\Temp o C:
\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files\
Recomendamos usar una cuenta de servicio con permisos y que est validada ante la red.
72
D clic en Ok.
Una vez que se haya configurado el pool de aplicacin, adicione una nueva aplicacin Web mediante la
opcin de Add application...:
73
Ntese que se recomienda que esta aplicacin Web se cree bajo el Default Web site. Si usted un sitio
Web diferente, deber considerar el nmero del puerto bajo el cual sube la aplicacin.
Asegrese de configurar:
Un Alias para su referenciacin.
El uso del pool de aplicacin configurado previamente.
La ruta fsica a la carpeta WebApp ubicada como <WEB_PATH>\WebApp
74
D clic en Ok.
Por defecto la configuracin de autenticacin para la aplicacin Web quedarn con la posibilidad
annima (Anonymous authentication) habilitada, y con la autenticacin tipo Windows deshabilitada.
Deber revisar o editar esta configuracin si su proyecto utiliza autenticacin integrada de Windows.
Si este es su caso, esta configuracin se lleva a cabo como se describe en Usando autenticacin tipo
Windows.
Finalmente, ejecute los siguientes comandos en una consola:
httpCompression
serverRuntime
unlock
config
unlock
config
En este punto, el Portal de trabajo ha sido configurado para su ambiente de Bizagi.

Para configurar medidas de seguridad adicionales (recomendado), consulte Configuracin adicional de
seguridad.
4. Instalar y configurar el servicio programador

Para instalar el servicio programador de Bizagi (Scheduler), deber copiar la estructura y archivos del
mismo hacia <RUTA_PROYECTO>\[Su_proyecto]\.
4.1 Copie la carpeta Scheduler.

Tome una copia de la carpeta llamada Scheduler que se encuentra en la ruta de instalacin de Bizagi
(por defecto ubicada como <BIZAGI_PATH>\ProjectModel\Scheduler\), y ubquela en la ruta
asignada para su proyecto Bizagi (bajo <RUTA_PROYECTO>\[Su_proyecto]).
4.2 Revise los permisos del folder para el programador.

Una vez que haya copiado la carpeta Scheduler en la ruta local, asegrese de que no quede marcada
como slo lectura.
Para revisar los permisos, haga clic derecho sobre la carpeta y seleccione sus propiedades donde la
casilla read-only deber estar desmarcada:
75
Seguidamente, asegrese tambin de otorgar los siguientes permisos a estas cuentas:

USUARIO
PERMISOS
ASPNET
Modify, Write
NETWORK SERVICE
Modify, Write
SYSTEM user
Full control
76
D clic en Ok para guardar los cambios.

4.3 Preconfigure el programador.
Edite el archivo de configuracin del programador de manera que incluya el detalle de la conexin a la
base de datos de su proyecto.
Para
hacerlo,
ubique
el
archivo
<RUTA_PROYECTO>\[Su_proyecto]\Scheduler
\BizAgi.Scheduler.Services.exe.config y edite sus elementos: DSNDB, PROVIDERTYPE y
PROJECT de acuerdo a la conexin a la base de datos de pruebas o de produccin. Realice estos
cambios como se describe a continuacin:
Si usted utiliza SQL Server:
<add
key="DSNDB"
value="Persist
ID=[cuenta_login];Password=[contrasea];Data
Catalog=[base_de_datos];" />
Security
Info=True;User
Source=[instancia_bd];Initial

Considere:
o [instancia_bd]: La instancia de la base de datos que incluye el nombre del servidor.
77
o [base_de_datos]: El nombre de la base de datos de su proyecto en este ambiente.

o [cuenta_login]: La cuenta de usuario para autenticarse ante la instancia de base de datos.
o [contrasea]: La contrasea de la cuenta de usuario. Esta informacin podr definirse de manera
encriptada.
Avanzado.
Si usted utiliza Oracle:
<add
key="DSNDB"
value="Data
Source=[servidor_bd]:[puerto]/
[nombre_servicio];User ID=[esquema];Password=[contrasea];Unicode=True;" />
Consider:
o [servidor_bd]: El Servidor de base de datos.
o [puerto]: El nmero del puerto sobre el cual la instancia de base de datos atiende.
o [nombre_servicio]: El identificador del servicio de la instancia de base de datos.
o [esquema]: El nombre de su proyecto Bizagi (visto como esquema de usuario).
o [contrasea]: La contrasea para ese esquema de usuario.
Avanzado.
La siguiente imagen ilustra el cambio en el archivo de configuracin del programador, para conectarse
a una base de datos SQL Server:
78
Es fundamental asegurarse que el valor de la llave Project (<add key="Project"

value="[su_proyecto]"/>) corresponda al nombre de su proyecto el cual tendr el mismo
nombre del directorio definido como <RUTA_PROYECTO>\[Su_proyecto]\.
Guarde los cambios y cierre el archivo.
La estructura dentro de <RUTA_PROYECTO>\[Su_proyecto]\ deber verse como se ilustra:
4.4 Instale el servicio programador.

Para instalar el programador, deber crear un servicio de Windows. Para ello, primero asegrese de
crear un archivo .bat llamado BizAgi_[nombre_proyecto]_Scheduler_Service_Install.bat con el siguiente
contenido.
CD /D "%~dp0"
C:\WINDOWS\Microsoft.NET\[version_framework]\v4.0.30319\installutil
name=BizAgi[project_name]SchedulerService BizAgi.Scheduler.Services.exe
NET START "BizAgi[nombre_proyecto]SchedulerService"
pause
Considere:
79
[nombre_proyecto]: Es el nombre de su proyecto Bizagi en este ambiente.

[version_framework]: Deber ser framework64 o framework segn su instalacin (32 o 64 bits).
Una vez que haya creado este archivo, ejectelo bajo una cuenta de administrador para instalar el
servicio. Podr revisar el log y los servicios de la mquina para asegurarse que el servicio se haya
creado exitosamente y se liste en los servicios de Windows:
Ntese que el servicio que quedar registrado como BizAgi[nombre_proyecto]SchedulerService

tendr que estar en un status de iniciado.
5. Activar la licencia
Active su licencia siguiendo los pasos descritos en Activacin de licencias, que para este escenario de
configuracin manual, deber hacerse a travs de una instalacin de Bizagi que tenga acceso por red
al Servidor BPM de pruebas o de produccin en cuestin.
Si usted est configurando un ambiente en clster (con ms de un nodo para el Servidor BPM), por
favor contacte a nuestro equipo de soporte.
En este punto, usted tendr configurado el ambiente de ejecucin de Bizagi.
Pasos adicionales
Para la administracin de su ambiente operativo, recuerde que podr utilizar Bizagi Management
Console para la configuracin de ciertos parmetros como: el servidor SMTP, la URL y sistema de
servicios Web externos, sistemas ECM y virtualizados, entre otros (para mayor informacin sobre estas
opciones consulte Bizagi Management Console).
Para utilizar el Management Console, debe instalarlo en un servidor que tenga acceso a la base de
datos del proyecto.
80
Administracin de Servidores y Clsters
Introduccin
Bizagi ofrece una consola administrativa llamada Management Console, la cual permite realizar tareas
administrativas en cualquier ambiente del proyecto (Desarrollo, produccin o pruebas).
Dentro de estas tareas administrativas, hay un mdulo de administracin de servidores el cual permite
administrar la infraestructura especfica del ambiente de produccin. Dentro de estas opciones
encontramos: la configuracin de un clster para el Servidor BPM, mover el Servidor BPM, la
posibilidad de recrear el ambiente a partir de una base de datos (el Portal de Trabajo y el servicio
Programador).
Montar la solucin en un clster est soportado en la edicin Bizagi JEE, sin embargo los pasos que se
llevan a cabo para dicha edicin difieren a los presentados en este documento, el cual usa
Management Console.
Si usted est utilizando la edicin Bizagi JEE y desea montar su solucin en clster, consulte
Configuracin Servidor de Aplicacin JEE.
Antes de iniciar
Por defecto, Bizagi se podr configurar para utilizar las capacidades de balanceo de carga del sistema
operativo (p.e Network Load Balancing para Servidores Windows). Sin embargo, se soporta utilizar
cualquier Balanceador de cargas a nivel de Hardware (recomendado para ambientes de alta
disponibilidad y misin crtica).
Para configurar el clster en Bizagi, se debe:
1. Llevar a cabo los pasos desde la Consola Administrativa (como se describen en esta seccin).
Mediante estos, se define en Bizagi los nodos que hacen parte de la solucin, y se permitir que
compartan la informacin de la licencia activa.
2. Asegurarse de contar con un Balanceador de cargas.
ste se debe configurar para que considere los nodos de la solucin (en este paso se define el
balanceo como una tarea externa a Bizagi).
Este paso vara de acuerdo al Balanceador de cargas utilizado (en esta seccin no se entrar en ese
detalle).
Prerrequisitos
Para utilizar cualquiera de las opciones descritas a continuacin (incluye el paso #1 mencionado en la
seccin anterior), asegrese de:
1. Tener credenciales autorizadas para acceder a los Servidores involucrados en los procedimientos
especficos.
Esto significa, tener a la mano una cuenta de acceso de los servidores que estn tanto dentro del
grupo Administrador, como del grupo Bizagi.
81
2. Tener la informacin relacionada a sus licencias activas (para casos donde se mueva esta
informacin de las licencias).
Esto significa que para opciones donde se migre el servidor de produccin, debe validar que la
informacin sobre las licencias sea correcta.
Otras consideraciones adicionales al realizar operaciones que involucren licencias son:
El nuevo servidor no debe tener ya otra licencia activa.
El servidor desde donde se mueve una licencia, debe tener acceso a Internet (especficamente a
www.bizagi.com).
El nuevo servidor debe cumplir con los requerimiento tcnicos, tal como el Servidor de produccin.
3. Configure la ruta Bizagi para almacenar adjuntos adecuadamente.

Si est configurando un clster, deber asegurarse de que su ruta para almacenar los adjuntos de
Bizagi se configure en una carpeta compartida de un servidor de archivos (si no se utiliza integracin
con sistemas ECM).
Esto se debe a que todos los nodos BPM debern tener un acceso a un repositorio compartido de los
documentos adjuntos.
82
Si usted nicamente est moviendo el servidor, entonces deber asegurarse que: la configuracin de
esta ruta corresponda a la que espera sea la ruta accesible por el nuevo servidor, y que dicha carpeta
contenga los documentos que hayan sido adjuntados previamente.
Mdulo de administracin de Servidores

Este mdulo est disponible en el Management Console para ambientes de produccin.
Las opciones descritas a continuacin varan ligeramente dependiendo de si se maneja un ambiente en
clster o no.
Opciones para clsters
En proyectos de Bizagi donde se esperan una gran cantidad de usuarios concurrentes, y un alto
nmero de solicitudes en el Portal de Trabajo, Bizagi ofrece la posibilidad de configurar el Servidor
BPM como un clster.
Esto es una medida de escalamiento horizontal que permite mejorar la disponibilidad y el rendimiento
de la solucin BPM, dado que permite agregar cualquier nmero adicional de nodos dentro del clster
83
(para as lograr balanceo de carga).

De acuerdo a lo anterior, Bizagi manejar automticamente las licencias que estn activas en el
Servidor.
El ambiente de produccin seguir teniendo lgicamente un Servidor principal (el que se lista de
primero en la lista de Servidores). A este Servidor principal se le hace referencia como el Nodo
maestro.
Para configurar un clster, registramos nodos adicionales al Servidor BPM actual utilizando las
opciones de Admin. Servidores. Para ello, se requiere:
1. Previamente haber hecho un Deployment desde el ambiente de desarrollo al de produccin.
De esta manera, en el Deployment se habr definido cul es el Servidor BPM de produccin principal
(el Nodo maestro).
Para mayor informacin, consulte el Deployment de Bizagi.
2. Adicionar servidores como nodos nuevos dentro de la configuracin de produccin.
Este paso se debe hacer para cada nodo que se desee adicionar.
Ntese que en cualquier momento se podr eliminar un nodo del ambiente en clster.
84
Adicionar un Servidor
Para adicionar un nuevo Servidor, primero asegrese de tener instalado Bizagi Engine en una mquina
la cual tenga acceso al servidor que se va a adicionar, y al servidor que es el Nodo maestro.
Tenga en cuenta que debe instalar la misma versin de Bizagi Engine que corresponda a la que est
usando actualmente su ambiente de produccin.
Abra Bizagi Management Console y seleccione la opcin de Abrir proyecto existente desde la ventana
inicial.
Seleccione el servidor local en la lista desplegable, y luego seleccione el nombre del proyecto en
produccin.
Haga clic en Finalizar para abrir el proyecto.
Para cada nodo que se desee agregar, siga los siguientes pasos:
1. Haga clic en la opcin de Adicionar servidor. Esta opcin se encuentra como un botn en la cinta
del men principal, o desde las opciones del clic derecho sobre el Nodo maestro.
85
De manera similar a las opciones presentadas en la configuracin de un Deployment, una ventana

ensear la lista de servidores en la red los cuales cuentan con Bizagi instalado.
2. Seleccione el servidor nuevo que se incluir como nodo y haga clic en Siguiente.
Si su servidor no aparece listado a pesar de que exista la conexin a l, puede optar por digitar el
nombre del servidor (en la opcin de Ingresar un nuevo servidor).
Tambin es posible ingresar directamente la direccin IP (en vez del nombre), sin embargo tenga en
cuenta que debe ser una IP no dinmica. En otras palabras, los servidores configurados en Bizagi no
deben tener una IP variable dado que son referenciados por el Deployment.
86
Recuerde que si la cuenta de Windows con la que inici el Management Console no es la autorizada en
el Servidor objetivo, entonces deber proporcionar unas credenciales autorizadas para el registro del
nuevo nodo (como se describe en los Prerrequisitos).
Asegrese de entender y confirmar que est de acuerdo con el concepto que involucra la adicin de
un nuevo nodo dentro del clster.
87
3. Especifique si desea crear un servicio adicional tambin del Programador en dicha mquina.
Ntese que esto es opcional, y por lo tanto se puede optar por balancear la carga del Programador
tambin, especialmente si sus Procesos utilizan muchos trabajos programados o ciertos trabajos en
lote que sean de alta demora y exigencia en el procesamiento.
Los trabajos en lote y programados representarn principalmente la ejecucin de Actividades

Asncronas, la sincronizacin de la Replicacin, Trabajos personalizados, y sincronizacin con LDAP,
entre otros.
88
Haga clic en Siguiente para continuar.

Al finalizar, Bizagi mostrar la confirmacin del xito en la operacin. De ocurrir algn error, ser
enseado en esta ventana.
89
Haga clic en Finalizar.

En la lista de Servidores, se podr apreciar el nuevo nodo registrado (el refresco de esta vista puede
tardar unos segundos).
90
Eliminar un Servidor
Esta opcin permite remover el registro de un nodo asociado a una configuracin en clster.
Esta opcin es til cuando:
1. Se desea dejar de usar un servidor dado, dentro de un esquema de balanceo de cargas al Servidor
BPM.
2. Se desea cambiar el nodo (usar otro servidor para este propsito). Para ello, se debe eliminar el
nodo registrado, y luego registrar el nuevo nodo (mediante la opcin de Adicionar nuevo servidor,
como se describe en la seccin anterior).
Si desea mover su Nodo maestro, de manera que no desea utilizar el actual y desea usar otro
Servidor, use la opcin de Mover Nodo maestro.
Dicha opcin funciona de manera similar a la que se describe acerca de Mover un Servidor, en la
seccin ms abajo.
Para remover un servidor registrado en la configuracin del clster, primero asegrese de tener
instalado Bizagi, en una mquina la cual tenga acceso al servidor que se va a eliminar, y al servidor que
es el Nodo maestro.
91
inicial.
produccin.
Luego, ubique el servidor y desde sus opciones del clic derecho, seleccione la opcin de Eliminar
servidor.
Tambin puede hacer esto seleccionando los servidores y haciendo clic en la botn correspondiente
de la cinta.
Ntese que esta opcin elimina el Portal de Trabajo y/o servicio de Programador. Por lo tanto, si
desea eliminar ambos, deber hacerlo para cada uno de los dos componentes.
92
Confirme esta accin.
Esta opcin no elimina archivos del servidor.

Por lo tanto, tenga en cuenta que el servidor tendr localmente la informacin pertinente a cuando
haca parte del clster.
Mover un Servidor (aplica tambin a Mover un Nodo maestro)

Esta opcin permite mover el servidor BPM a uno diferente.
Mediante esta, Bizagi crear automticamente el Portal de Trabajo y el servicio Programador en un
servidor diferente, y mover igualmente la licencia activada.
Esta opcin no mueve la Base de datos en s.

Si desea mover la Base de datos a un nuevo Servidor, debe hacer esto mediante la restauracin de
un backup.
Para ver ms informacin al respecto, consulte las secciones segn su motor de Base de datos:
Backups y su restauracin en SQL Server, o Export e Import en Oracle.
Cuando se tiene una configuracin de clster para el Servidor BPM (ms de un nodo para el Portal de
93
Trabajo), se visualiza la opcin de Mover el Nodo maestro.

Se recomienda realizar este procedimiento en un horario no laboral, principalmente porque con dicho
procedimiento se reinician los servicios en el Servidor.
Para mover el ambiente de produccin a un servidor BPM diferente, los siguientes pasos se llevan a
cabo:
1. Instale Bizagi Engine en una mquina con acceso en red.

Instale Bizagi Engine en una mquina la cual tenga acceso al servidor que se va a mover, y al servidor
que ser el nuevo Servidor.
Note que si la configuracin del Servidor BPM usa clster, esto implica que la mquina tenga acceso al
Nodo maestro y los dems nodos.
2. Abra el proyecto desde el Management Console.

inicial.
produccin.
94
3. Use la opcin de Mover Servidor.

Cuando el proyecto est abierto, vaya al mdulo de Administracin de Servidores, haga clic en el
botn Mover Servidor o d clic directamente en el tem Servidores y seleccione esta opcin.
95
Tenga en cuenta que este procedimiento tambin mueve la licencia activada en el Servidor BPM y por
lo tanto Bizagi ensear esta informacin involucrada al mover el servidor.
96
Revise y asegrese de acordar con el procedimiento que se va a realizar.

4. Seleccione el Servidor destino.

Seleccione el Servidor BPM de la lista de Servidores que cuentan con Bizagi instalado.
Si su servidor no aparece listado a pesar de que exista la conexin a l, puede optar por digitar el
nombre del servidor (en la opcin de Ingresar un nuevo servidor).
Tambin es posible ingresar directamente la direccin IP (en vez del nombre), sin embargo tenga en
cuenta que debe ser una IP no dinmica. En otras palabras, los servidores configurados en Bizagi no
deben tener una IP variable dado que son referenciados por el Deployment.
97
Recuerde que si la cuenta de Windows con la que inici el Management Console no es la autorizada en
el Servidor objetivo, entonces deber proporcionar unas credenciales autorizadas para el registro del
nuevo nodo (como se describe en los Prerrequisitos).
Una vez que el procedimiento haya finalizado, la licencia activa, el Portal de Trabajo, el servicio
Programador y los adjuntos de casos existentes (documentos en el servidor BPM), sern eliminados
del servidor anterior, y sern movidos hacia el nuevo servidor.
98
Finalice dando clic en Cerrar.
Recrear desde Base de datos

Esta opcin permite crear de nuevo un ambiente a partir de una base de datos existente.
Con ella, Bizagi crear de manera automtica el Portal de Trabajo y el servicio Programador en un
servidor.
Esta opcin es til especialmente cuando hubo un factor externo que imposibilita el uso o
recuperacin de configuracin de los componentes Programador y Portal de Trabajo.
Ntese que esta opcin no activa de manera automtica una licencia que posiblemente haya tenido el
servidor anterior.
Por lo tanto, es recomendado que tenga a la mano la informacin sobre sus licencias si desea activar
su ambiente de produccin.
Contacte nuestra rea de soporte si tiene dudas al respecto.
Para usar la opcin de recrear desde Base de datos, siga estos pasos:
1. Instale Bizagi Engine en una mquina con acceso en red.
Instale Bizagi Engine en una mquina la cual tenga acceso al servidor BPM.
Note que este Servidor BPM requiere acceso al servidor de base de datos.
2. Abra Bizagi Management Console

Abra Bizagi Management Console y en la primera ventana de bienvenida, seleccione la opcin de
Proyectos.
99
3. Use la opcin de Recrear desde Base de datos.

D clic en la opcin sobre la mano izquierda, identificada con el cono de una Base de datos:
100
Bizagi iniciar un asistente para este procedimiento.

Ingrese el detalle de la conexin a la Base de datos existente.
101
En esta ventana, ingrese la siguiente informacin (de manera similar a cuando se crea un nuevo
proyecto):
Si utiliza una Base de datos SQL Server:
Servidor: El nombre de la Base de Datos que contiene la instancia del Servidor SQL.
Base de Datos: El nombre de su proyecto. Bizagi crear una Base de Datos con su nombre.
Nombre de Usuario: Una cuenta de usuario para acceder a la instancia del Sevidor SQL.
Contrasea: La contrasea para el nombre de usuario especificado.
Si utiliza una Base de datos Oracle:
Servicio: Acceso a su instancia de Oracle especificado
nombreServicio".
Contrasea: Contrasea para el usuario BizagiAdmon.
como
"servidorBaseDatos:puerto/
Ingrese la siguiente informacin sobre el esquema existente (Base de datos):

Usuario: El nombre del esquema de usuario existente.
Contrasea: Contrasea para el esquema de usuario existente.
Confirmar contrasea: Confirme la misma contrasea anterior.
Haga clic en Siguiente para iniciar con el procedimiento. Asegrese de confirmar el inicio del mismo.
102
Recuerde que requiere de una cuenta autorizada en el servidor de destino, ya que Bizagi crea de
manera automtica los componentes: Portal de Trabajo y servicio Programador.
Bizagi mostrar un mensaje al finalizar la operacin. Haga clic en Finalizar.
Recomendaciones de seguridad en la configuracin
Introduccin
Cuando se configura Bizagi Engine en un ambiente de produccin, existen medidas de seguridad
adicionales que se recomiendan para todos los proyectos.
Tal configuracin para procesos que se ejecutan sobre una plataforma de .NET, se llevan a cabo
directamente en el IIS.
El objetivo de estas recomendaciones, es configurar tanto el Portal de trabajo de Bizagi como tambin
sus servicios Web de manera segura.
Siga estas recomendaciones para contar con medidas de seguridades adicionales en su ambiente de
103
ejecucin de procesos Bizagi.
Recomendaciones de seguridad
Las siguientes recomendaciones estn orientadas a fortalecer la seguridad del Portal de Bizagi y sus
servicios:
1. Configuracin del firewall

Se recomienda enfticamente asignar reglas en el cortafuegos corporativo (firewall) para que se limite
el acceso a Bizagi a las direcciones IPs no autorizadas. Para ello, se deben autorizar las IPs y los
puertos relevantes.
Al emplear una zona desmiliarizada (DMZ), asegrese que tanto el firewall interno como el externo no
permitan el acceso indiscriminado en su configuracin.
Puede tambin considerar polticas corporativas de seguridad especialmente cuando Bizagi se publica
para acceso mediante Internet.
2. Configuracin HTTPS
Se recomienda enfticamente configurar el Portal de trabajo bajo el protocolo HTTPS.
Para hacelo, asegrese de contar con un certificado vlido para su servidor, y que registre su dominio.
Una vez que cuente con el certicado de su servidor, regstrelo para el uso del Portal de Bizagi
utilizando la opcin de certificados del servidor (Server certificates) que presenta el IIS:
Al registrarlo, asegrese de especificar los bindings en el sitio web (por defecto para Default Web
site):
104
Ntese que para estos bindings, deber especificar el uso explcito deHTTPS, con su puerto asignado,
y seleccionar el certificado.
D clic en Ok para guardar la configuracin.
3. Configuracin de los servicios Web

Por defecto Bizagi incluye sus servicios Web preconstruidos en la carpeta.\WebApplication
\WebServices\ (por defecto, la ruta es C:\Bizagi\[Bizagi_edition]\Projects\[su_proyecto]\).
Esto servicios Web se despliegan automticamente para permitir una fcil integracin con cualquier
aplicacin externa, y para proveer cierta funcionalidad que es utilizada internamente por Bizagi.
Adems de configurar el uso de HTTPS (como se indic anteriormente) que ya provee una seguridad
adicional, se recomienda enfticamente configurar de manera explcita los servicios Web y su acceso,
con medidas de seguridad complementarias.
Estas medidas incluyen:
Autenticacin bsica para aquellos servicios Web que van a ser invocados por aplicaciones externas
(en escenarios de integracin con otros sistemas).
Definir una lista autorizada de direcciones IP (IP whitelist) las cuales autoricen nicamente a los
servidores BPM de Bizagi, de manera que se tenga el acesso restringido a aquellos servicios Web
que slo utiliza Bizagi en su manejo interno.
Para llevar a cabo lo anterior, siga estos pasos:
3.1 Separar los servicios Web
Primero deber separar aquellos servicios internos usados por Bizagi, de los que proveen
capacidades de integracin.
Los servicios Web que se usan por Bizagi son: Cache.asmx yWFAsynch.asmx.
Para separalos, cree una nueva carpeta en la estructura de la aplicacin Web del Portal de trabajo (por
defecto en C:\Bizagi\[Bizagi_edition]\Projects\[su_proyecto]\WebApplication\).
105
Podr nombrar esta carpeta como SOAPservices (o un nombre de su eleccin):
Mueva todos los archivos ubicados en .\WebApplication\WebServices\, excepto Cache.asmx y

WFAsynch.asmx, hacia la nueva carpeta que ha creado en el paso anterior:
106
Una vez que haya movido los archivos, podr verificar que solo Cache.asmx y WFAsynch.asmx, se
encuentren en la carpeta original.\WebApplication\WebServices\.
3.2 Asignar autenticacin bsica para los servicios Web de integracin
Configure en el IIS la autenticacin bsica para la carpeta .\WebApplication\SOAPservices\ que
contiene los servicios Web que otras aplicaciones podrn invocar (p.e, los servicios de
WorkflowEngineSOA, EntityManagerSOA, QuerySOA, RenderSOA).
A travs de esta configuracin, los aplicativos externos que utilicen estos servicios debern
proporcionar credenciales vlidas para la autenticacin bsica (usuario, contrasea).
Para hacerlo, habilite la opcin Basic Authentication y deshabilite la opcin que permite autenticacin
annima (Anonymous authentication) para esa carpeta:
Seguidamente, asegrese que los usuarios autorizados tengan privilegios sobre la carpeta fsica y su
contenido (de acuerdo a los usuarios permitidos de su dominio).
Para este escenario, se deben otorgar permisos a la carpeta SOAPservices:
107
Tenga en cuenta que para usar esta posibilidad, debe habilitar el componente del IIS llamado World
Wide Services -> Security -> Basic Authentication , al realizar la instalacin del IIS.
3.3 Definir una lista autorizada de IP para los servicios Web internos
Asegrese de configurar a nivel del IIS, que la carpeta .\WebApplication\WebServices\ que contiene
los servicios provistos por Cache.asmx yWFAsynch.asmx, sea accesible solo por direcciones IP
permitidas.
Estas direcciones IP deben corresponder a las asignadas a los Servidores BPM de Bizagi (implica al
servidor local, adems de cualquier otro nodo asignado al clster BPM cuando se cuente con balanceo
de cargas).
Para hacerlo, incluya de manera explcita las direcciones IP que pueden acceder a la carpeta (ntese
que podr especificar un dominio tambin):
108
Para que la lista autorizada funcione, asegrese de configurar que el manejo por defecto a las
direcciones no-incluidas sea de carcter de negacin de servicio (en edit feature settings, especifique
Deny para el acceso no especficado):
Es muy importante que tenga siempre en cuenta la configuracin de sus servicios Web antes de
realizar una actualizacin de versin de Bizagi.
Esto significa que deber actualizar el contenido de las carpetas con servicios Web de manera
manual; para que al usar versiones ms recientes de Bizagi usted tenga el control sobre cules
109
archivos deben ir a cada una de las carpetas separadamente.
Configuracin de Bizagi Engine sobre plataforma JEE
Introduccin
Los Procesos en Bizagi Engine se pueden configurar para ejecucin sobre una plataforma JEE.
Al ejecutar los procesos sobre una plataforma de JEE, y para la configuracin de los mismos en un
ambiente de pruebas y produccin, deber seguir los pasos en esta seccin.
Cuando el proyecto se ejecuta en el ambiente de desarrollo, no se requiere configuracin alguna o

despliegue de aplicacin.
Esto lo realiza Bizagi de manera automticamente por medio del servidor JBoss que incluye Bizagi
Studio.
Lo que debe hacer

En los ambientes de pruebas o produccin de una plataforma JEE, se debe tener una Base de datos
del ambiente de pruebas o produccin con los Procesos implementados.
Despus de que se haya completado la implementacin de un proyecto con Bizagi JEE, y una vez se
hayan probado satisfactoriamente los Procesos en el ambiente de desarrollo, se publican los procesos
a la base de datos por medio del Deployment Avanzado.
Solo en caso de que no desee que su ambiente de desarrollo utilice la instancia de JBoss incluida
por defecto, puede realizar los pasos #2 y #3 del listado siguiente para usar Weblogic o
WebSphere.
Sin embargo, tenga en cuenta que lo recomendado es utilizar la instancia de JBoss en desarrollo por
motivos de agilidad en la implementacin (dado que es un Servidor ms ligero e inicia ms rpido, y
no requiere de configuracin adicional).
Con el Advanced Deployment se llevan los Procesos desde la Base de datos de desarrollo hacia la
Base de datos de pruebas o produccin.
Una vez que se tengan estos cambios listos, se genera el Portal de Trabajo como una aplicacin Web
en el Servidor de Aplicaciones JEE.
Para generar el Portal de Trabajo se requiere: contar con el Servidor de Aplicaciones JEE previamente
configurado para trabajar con Bizagi, y tener la consola JEE de Bizagi.
En resumen, estos son los pasos a seguir:
110
1. Realizar un Deployment de Bizagi.

Con procesos ejecutndose sobre una plataforma JEE, utilice la herramienta del Deployment Avanzado
para este Deployment de Bizagi.
2. Configurar la arquitectura del sistema y los servidores JEE para pruebas y produccin.
En este paso asegrese de tener el Servidor de Aplicaciones JEE configurado para trabajar con Bizagi
(sea Weblogic, WebSphere o JBoss).
Para ms informacin, consulte Configuracin de un Servidor de Aplicaciones JEE donde podr ver la
gua de configuracin para una solucin en clster o standalone.
Para ms informacin sobre otras configuraciones en la arquitectura, como el uso de balanceador de
cargas al tener un clster BPM, consulte Configurar la arquitectura del sistema.
3. Despliegue de aplicacin JEE.
Genere el Portal de trabajo de Bizagi haciendo un despliegue de aplicacin JEE (sobre el Servidor de
aplicaciones).
Esto se realiza de una manera asistida, a travs de la consola JEE de Bizagi.
Para ms informacin, consulte Despliegue hacia un Servidor de Aplicaciones JEE.
Cada vez que se deseen publicar cambios (por ejemplo nuevas versiones de proceso) al ambiente de
pruebas o produccin, deber realizar este paso.
Configuracin del Servidor de Aplicacin JEE para trabajar con Bizagi
Para configurar la ejecucin de los Procesos, con Bizagi Engine sobre una plataforma JEE, debe
configurar el Servidor de Aplicaciones JEE para que trabaje con Bizagi.
Esto aplica para cualquiera de los siguientes escenarios:
1. Se desea montar un ambiente de pruebas en plataforma JEE para los Procesos.
2. Se desea montar un ambiente de produccin en plataforma JEE para los Procesos.
3. Se desea montar un ambiente de desarrollo con un Servidor de Aplicaciones JEE diferente al que
Bizagi usa por defecto (una instalacin local de JBoss).
Se recomienda que previo a esta configuracin, se cuente con el repositorio de Procesos, el cual ser
utilizado para la configuracin del ambiente destino.
En otras palabras, para esta configuracin se debe tener la Base de datos de Bizagi creada a partir del
Deployment Avanzado.
Tenga en cuenta que estos pasos son parte de lo requerido para configurar el Portal de trabajo en
JEE.
Siga las instrucciones de las secciones a continuacin (de acuerdo al Servidor de Aplicaciones JEE que
se desea usar):
Configurar WebSphere para trabajar con Bizagi
Configurar Weblogic para trabajar con Bizagi
Configurar JBoss para trabajar con Bizagi
111
Configuracin de WebSphere
La configuracin de un servidor WebSphere hace parte de la configuracin para Configurar un
Servidor de Aplicaciones JEE, como un paso requerido al momento de generar el Portal de trabajo de
Bizagi, para que sus procesos se ejecuten sobre una plataforma JEE.
La configuracin de WebSphere vara de acuerdo a si la configuracin de la solucin tendr un
esquema de alta disponibilidad o no (si se involucra o no ms de una instancia de WebSphere en un
clster).
Para una gua sobre cmo configurar WebSphere para trabajar con Bizagi en un esquema de alta
disponibilidad (para aplicaciones de misin crtica), consulte la Configuracin en clster de WebSphere.
Para una gua sobre cmo configurar WebSphere para trabajar con Bizagi como instancia standalone
(estndar setup), consulte Configuracin estndar de WebSphere.
Configuracin de WebSphere en clster
Introduccin
Cuando se configura Bizagi Engine para utilizar una plataforma JEE, la ejecucin del Portal de trabajo
se configura sobre diferentes Servidores de Aplicacin JEE como WebSphere, WebLogic, o JBoss.
El procedimiento de configuracin de cada Servidor de Aplicaciones para trabajar con Bizagi, vara
ligeramente de acuerdo a las diferencias en s de cada uno de los servidores.
Esta seccin se enfoca en la configuracin de WebSphere para trabajar con Bizagi, en un esquema de
alta disponibilidad, donde se hace uso de un clster para contar con el balanceo de cargas en la
aplicacin.
112
Si desea configurar WebSphere a modo standalone (solamente empleando un servidor BPM; sin
esquema de balanceo de cargas), consulte la Configuracin estndar de WebSphere.
Lo que debe hacerse

Para la configuracin en clster de Bizagi, debe realizar estos pasos:
1. Seguir los requisitos para usar WebSphere y WASND.
Estas directrices y pasos se indican en la Preconfiguracin de WebSphere para soporte a clster, e
incluyen la creacin de perfiles y el registro del clster y de sus nodos.
2. Configurar WebSphere en clster para trabajar en Bizagi.
Estos pasos se describen en la Configuracin en clster de WebSphere.
3. Configurar el servicio Scheduler (Programador) para una solucin en clster.
Estos pasos se describen en la Configuracin del Scheduler en WebSphere.
4. Configurar otros componentes que hacen parte de la solucin, como el balanceador de cargas.
Para ello, se recomienda revisar lo descrito en Configurar la arquitectura del sistema, donde se
presenta la posibilidad de una instalacin de la solucin en 3 capas, y las directrices para la
configuracin del balanceo de cargas.
Esta seccin describe los pasos y directrices a seguir para la configuracin de clsters en WebSphere.
Esto es un prerrequisito para llevar a cabo la configuracin de WebSphere para trabajar con Bizagi en
clster.
Para ms informacin sobre los pasos que se llevan a cabo, consulte Configurar WebSphere en
clster.
Objetivos
La configuracin de un clster de WebSphere para la alta disponibilidad, involucra ciertos pasos de
preconfiguracin (se llevan a cabo antes de la configuracin orientada a los procesos de Bizagi), de
manera que se tenga una administracin centralizada de los nodos del clster.
Dentro de esta administracin centralizada, se consideran las siguientes capacidades:
1. Cada nodo estar disponible para ser asignado con requests, e igualmente procesarlos.
2. Cada nodo reportar cambios para que estos sean propagados a los dems nodos.
3. Si por algn motivo, el nodo no tiene disponibilidad de servicio, los requests sern manejados y
distribuidos apropiadamente entre los dems nodos.
Prerrequisitos
Para configurar su instancia de WebSphere en un ambiente de pruebas o produccin, se requiere:
Tener instalado el JDK de JAVA en cada nodo del clster. Se recomienda enfticamente utilizar el JDK
6, update 45.
La variable de entorno JAVA_HOME configurada previamente en cada nodo (se recomienda que sea
113
en una ruta sin espacios).

Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWebsphere-dist.zip).
Tener instalado el Servidor WebSphere en cada nodo que har parte del clster. Las versiones
soportadas son las pertenecientes a WebSphere V7.
Tener instalado WebSphere Application Server Network Deployment (WASND) instalado en un
Servidor con acceso a los nodos que harn parte del clster (puede ser incluso, un servidor que
contenga nodos del clster).
Debe ser la versin que corresponda a la versin del Servidor WebSphere (por ejemplo WASND v7
para WebSphere v7).
WebSphere puede ser descargado o solicitado directamente desde la pgina oficial de IBM.
Tenga presente que debe tener el instalador apropiado a su sistema, y que para su instalacin, debe
seguir tanto los requisitos de WebSphere, como los lineamientos presentados en la seccin de
Requisitos para usar WebSphere y WASND.
Los nodos con instancias de WebSphere pueden estar en un mismo servidor o en diferentes
servidores.
Bizagi soporta el uso de WebSphere en clster tanto horizontal como vertical.
Se recomienda la configuracin de clster horizontal, de manera que se tenga un servidor dedicado
para cada nodo de WebSphere.
Requisitos para usar WebSphere y WASND

Tenga en cuenta que WebSphere requiere de lo siguiente para la configuracin con Bizagi en clster:
1. Asegurar que se instalen los componentes necesarios de WebSphere (y WASND) y que se cuente
con las ltimas actualizaciones de fix packs del fabricante.
Mayor detalle se describe a continuacin en la seccin Directrices de instalacin y actualizacin.
2. Crear los perfiles para el manejo del clster a travs del WASND.
Mayor detalle se describe en la seccin Requerimientos del clster: creacin de perfiles.
3. Crear el clster, definiendo los nodos que hacen parte del mismo.
Mayor detalle se describe en la seccin Creacin del clster.
1. Directrices de instalacin y actualizacin

Se recomienda que WASND se instale en una ruta sin espacios.
Para instalar WebSphere (una vez que haya cubierto todos los prerrequisitos), asegrese de
considerar lo siguiente:
Instalar los componentes de Servidor de Aplicacin (Application Server) de WebSphere.
Habilitar la seguridad administrativa (Administrative security), y definir un usuario y contrasea para
la misma.
114
Dentro de la instalacin asistida de WASND, se recomienda indicar que no se incluyan perfiles por
defecto y de esta manera poderlos crear manualmente despus de la instalacin, como se indica en la
siguiente seccin.
Una vez que haya instalado WebSphere Application Server y WASND, tenga presente que se
recomienda enfticamente aplicar las ltimas actualizaciones y paquetes de mejoras (feature packs)
del proveedor. Para hacerlo, recomendamos utilizar el Actualizador IBM Update Installer para
WebSphere, y descargar igualmente los fix packs ms recientes para su instancia de WebSphere
Application Server V7.0 (esto es, instalar los paquetes de mantenimiento), y tambin descargar y
aplicar fix packs para WASND (por ejemplo, el fix pack 27 contiene mejoras que reducen el tiempo
de despliegue de las aplicaciones).
115
La ruta de instalacin de WASND ser referenciada como <WAS_HOME> a partir de este momento.
2. Requerimientos del clster: creacin de perfiles

Sobre el uso de WASND, tenga presente que se deben crear 2 tipos de perfiles para la configuracin
de la solucin en clster: un tipo de perfil que se crea para la administracin y configuracin
centralizada del clster, y otro tipo de perfil que se debe crear tantas veces como la cantidad de
nodos que hagan parte del clster.
Estos perfiles son:
Deployment Manager (DM): Es el perfil principal desde el cual se administra y se configura el
clster (incluye el uso de la consola administrativa y despliegue de las aplicaciones).
Custom: Es un perfil de ejecucin que se debe crear en cada nodo que haga parte del clster.
Contiene la instancia del servidor de aplicaciones, de manera que el nodo queda federado al
Deployment Manager (para que ste realice la distribucin y configuracin de las aplicaciones).
Para la creacin de los perfiles, se utiliza la herramienta Profile Management Tool incluida en la
instalacin del WASND.
116
Creacin del perfil DM

Para crear este perfil, realice lo siguiente:
D clic sobre el botn de Crear para definir un nuevo perfil (Create).
Seguidamente un asistente guiar las caractersticas del perfil.
Seleccione Management como el tipo de entorno (Environment) y d clic en Siguiente (Next):
Seleccione la opcin de Deployment Manager para el tipo de servidor (Server type) y d clic en
Siguiente (Next):
117
Seleccione la opcin Advanced profile creation para una configuracin avanzada del perfil,
y d clic en Siguiente (Next):
En la siguiente pantalla se requiere nicamente verificar que si se incluya la consola administrativa (la
casilla Deploy the administrative console debe estar marcada). D clic en Siguiente (Next).
Defina las propiedades del perfil.
Ingrese el nombre del mismo (Profile name), la ruta donde este perfil quedar instalado (Profile
118
directory), y verifique que no se utilice como perfil por defecto (la casilla Make this profile the default
debe quedar sin marcarse).
Marque la casilla que habilita la seguridad administrativa (la opcin Enable administrative
security debe quedar marcada).
A partir de ello, ingrese las credenciales del usuario administrador (usuario, contrasea y su
confirmacin).
Tenga en cuenta que este usuario ser utilizado para la administracin del clster (p.e llevar a cabo la
federacin de los nodos), por lo que se deber usar estas credenciales en la configuracin de perfiles
tipo Custom.
Una vez haya ingresado estos datos, d clic en Siguiente (Next):
119
En las siguientes dos pantallas, se presenta configuracin opcional relacionada a certificados de

seguridad de la organizacin. Puede dejar estos valores por defecto cuando no se tienen
certificados en el servidor (no realizar accin alguna), y d clic en Siguiente (Next):
Asigne los puertos para los servicios listados (en la pantalla de Port values assignment).
Tenga en cuenta que de este listado de puertos, es importante que tenga presente e asignado a
Administrative console secure port. Se debe recordar este puerto ya que se utilizar para
las tareas de distribucin y despliegue (por medio de la consola administrativa).
Una vez haya ingresado estos datos, d clic en Siguiente (Next):
120
Seleccione si desea que el servidor se ejecute como un servicio (p.e como un servicio de Windows).
Tenga en cuenta que esta opcin no se recomienda para entornos de pruebas ni de Desarollo.
Finalmente, se mostrar una pantalla con el resumen de la configuracin que se asignar al nuevo
perfil.
Revise que estas opciones sean consistentes y d clic en el botn de Crear (Create).
121
Ntese que dentro de la informacin de resumen, ver tambin el Nombre del host (Host name) que
contempla este clster.
Una vez que se finalice el asistente, debe iniciar el perfil. Para ello, abra una consola de comandos y
ubquese en la ruta del perfil:
<WAS_HOME>\AppServer\profiles\[Nombre_perfil]\bin
Una vez all ejecute el comando startManager para iniciarlo (startManager.sh en Linux OS o
startManager.sh en Windows):
Creacin del perfil Custom

Tenga en cuenta que este paso se debe realizar para cada nodo que haga parte del clster.
122
Para crear este perfil, realice lo siguiente:

D clic sobre el botn de Crear para definir un nuevo perfil (Create).
Seguidamente un asistente guiar las caractersticas del perfil.
Seleccione Custom profile como el tipo de entorno (Environment) y d clic en Siguiente (Next):
Seleccione la opcin Advanced profile creation para una configuracin avanzada del perfil,
y d clic en Siguiente (Next):
123
Defina las propiedades del perfil.

Ingrese el nombre del mismo (Profile name) teniendo en cuenta que ste debe ser nico, la ruta
donde este perfil quedar instalado (Profile directory), y verifique que no se utilice como perfil por
defecto (la casilla Make this profile the default debe quedar sin marcarse).
124
Ingrese la informacin relevante a la configuracin de su entorno de WebSphere: Nombre del nodo

(Node name) y nombre del Host (Host name) del que hace parte (segn se configur el perfil DM).
125
Ingrese la informacin para la federacin de nodos (configuracin que establezca que los nodos
pertenecen a un clster en WebSphere). Para ello, considere:
o Nodo DM (Deployment Manager host name or IP address): El nodo el cual fue configurado con el
perfil DM, como se indica en la seccin anterior.
o Puerto para el manejo del DM (Deployment Manager SOAP port number): El nmero de puerto bajo
el cual se ejecuta la federacin de los nodos.
o Deployment Manager authentication: El nombre de usuario y su contrasea para autenticarse en el
nodo que es DM; tal como se especifica en la seccin anterior al momento de configurar el perfil
DM y la seguridad administrativa.
o Federar el nodo despus (Federate this node later): Asegrese de dejar esta casilla desmarcada
para llevar a cabo la federacin del nodo. Tenga en cuenta que para la federacin se requiere que
el nodo DM se est ejecutando.
En las siguientes dos pantallas, se presenta configuracin opcional relacionada a certificados de

seguridad de la organizacin. Puede dejar estos valores por defecto cuando no se tienen
certificados en el servidor (no realizar accin alguna), y d clic en Siguiente (Next).
De igual manera, en la configuracin de los puertos que se utilizan puede dejar tambin los que se
sugieren por defecto y continuar hasta la pgina de resumen para revisar que la configuracin sea la
126
deseada.
Una vez haya revisado esto, haga clic en Crear (Create) para finalizar la configuracin para este nodo.
Recuerde que este paso de la Creacin del perfil Custom debe hacerse para cada nodo que haga
parte del clster. Para las siguientes configuraciones, tenga presente que el nombre del perfil no
debe repetirse.
Una vez que se finalice el asistente, debe iniciar el servicio de cada nodo. Para ello, abra una consola
de comandos desde cada servidor donde est el nodo y ubquese en la ruta:
<WAS_HOME>\profiles\[Nombre_nodo]\bin
Una vez all ejecute el comando startNode.bat
startNode.sh en Windows):
para iniciarlo (startNode.sh en Linux OS o
Verificacin de perfiles
Una vez que haya configurado los perfiles, puede verificar que la configuracin sea correcta y que la
federacin de nodos se lleve a cabo sin inconvenientes. Para ello, ingrese a la consola administrativa
desde en un navegador con la siguiente URL:
http://[Servidor_DM]:[puerto_DM]/admin
Dentro de las opciones de administracin del sistema (System administration), seleccione la opcin
Node agents donde podr ver el listado de los nodos que se federan al clster:
127
3. Creacin del clster

Para definir el clster de WebSphere, realice lo siguiente:
3.1 Vaya a la consola administrativa y ubique la opcin Servers.
Dentro de ella, expanda el tem Clusters y haga clic sobre la opcin WebSphere application server
clusters.
128
3.2 Haga clic sobre el botn Nuevo (New) para definir el clster.
En la informacin bsica del mismo, ingrese el nombre (Cluster name) y verifique que estn marcadas
las 2 casillas: Prefer local y Configure HTTP session memory-to-memory replication.
3.3 Ingrese la informacin del servidor de aplicaciones. Incluya:
Member name: Ingrese el nombre del servidor de aplicaciones.
Select node: Seleccione el nodo al que corresponde al servicio.
Weight: Conserve el valor por defecto.
Generate unique HTTP ports: Asegrese que esta casilla est marcada.
Create the member using the application server template: Conserve el valor por defecto default.
129

3.4 Ingrese la informacin de los nodos que hacen parte del clster. Para ello, d clic sobre Add
Member para adicionar cada nodo:
130
Repita este paso hasta asegurarse de que los nodos que hacen parte de su clster aparezcan listados
en la lista de miembros del clster. Este listado se aprecia en la parte inferior de la pantalla.
Ntese que sus nodos deben tener un nombre nico pero deben conservar el mismo valor para las
preferencias: Weight y Generate unique HTTP ports.
Una vez que haya ingresado todos sus nodos, d clic en Siguiente (Next).
Verifique la informacin de la configuracin que es presentada a travs de la pantalla de resumen, y
d clic en Finalizar (Finish) para la creacin del clster.
Sincronizacin de cambios en el clster

Una vez se realice la configuracin del clster, o cada vez que se realicen cambios en l (por ejemplo,
se adicione un nuevo nodo), se debe sincronizar la configuracin central hacia los nodos.
Para realizar una sincronizacin de cambios, ubique la opcin de administracin del sistema (System
administration), y seleccione la opcin Nodes donde podr ver el listado de los nodos actuales del
clster.
Marque los nodos y haga clic en Synchronize:
131
Ntese que una vez se finalice la sincronizacin, la columna Status mostrar un cono verde.
Si el cono del Status del nodo aparece con un signo de interrogacin, deber cerciorarse de que el
servicio del nodo se encuentre iniciado y sea accesible para que se complete la sincronizacin.
Una vez que complete estos pasos, consulte la Configuracin de WebSphere en clster para trabajar
con Bizagi.
Escalabilidad
Si usted ya tiene configurado su clster de WebSphere y se encuentra ejecutndose con un nmero
dado de nodos, entonces en cualquier momento podr adicionar nuevos nodos a su clster, como
medida de escalabilidad.
Para hacerlo, asegrese de:
1. Registrar el nuevo nodo en el clster.
En WebSphere, esto incluye la creacin del perfil personalizado del nodo, y registrar el nodo en el
clster a travs de las opciones de la consola administrativa.
2. Sincronizar los cambios al nuevo nodo.
3. Realizar la configuracin de WebSphere para trabajar con Bizagi.
Esto significa configurar para el nuevo nodo, las libreras y pasos necesarios para el servicio en
WebSphere.
Ntese que Bizagi recomienda el escalamiento horizontal.
4. Revise la configuracin del balanceador de cargas para que considere el nuevo nodo.
132
Para la configuracin de WebSphere para trabajar con Bizagi en un esquema de clster (ms de un
nodo en la capa BPM), se debe contar con ciertas configuraciones previas del lado de WebSphere.
Por lo tanto, antes de continuar, asegrese de haber seguido las instrucciones descritas en
Preconfigurar WebSphere para soporte a clster.
Para ms informacin sobre el procedimiento completo, consulte Configurar WebSphere en clster.
Esta seccin indica qu configuraciones debe realizar para que su cluster en WebSphere trabaje con el
proyecto de Bizagi.
Una vez que haya cumplido con lo descrito anteriormente, se realiza lo siguiente:
1. Extraer los archivos usados por Bizagi hacia WebSphere.
2. Configurar las variables de entorno.
Esto incluye las variables para el manejo del cach distribuido en una instalacin en clster.
3. Configurar los siguientes mdulos en WebSphere:
Autenticacin
Acceso a datos
Servicio de mensajera (JMS)
Libreras compartidas como un concepto de repositorio reutilizable
Otros, tales como el Timeout de las transacciones y el usuario administrador por defecto
Opcin de compresin HTTP
Estos mdulos se configuran en WebSphere utilizando su Consola de administracin, y utilizan a su vez
los archivos de Bizagi que se extraen en el primer paso.
Despus de estos pasos, su instancia de WebSphere estar configurado para que los Procesos de
Bizagi se desplieguen en una aplicacin JEE (el Portal de Trabajo).
Procedimiento
Los siguientes pasos describen a detalle cmo configurar y editar las preferencias de una instalacin
de WebSphere por defecto.
Realice la configuracin como se indica a continuacin, teniendo en cuenta que los nombres usados
son sensibles a maysculas.
1. Extraer los archivos usados por Bizagi hacia WebSphere

En este paso, se incluyen archivos usados por Bizagi en la instancia de WebSphere (son archivos que
no vienen por defecto en la instalacin limpia).
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-Webspheredist.zip).
Este paso que contempla ubicar los archivos de configuracin de Bizagi, deber hacerlo para cada
nodo que haga parte del clster.
1.1 Extraer el contenido de este .zip hacia una ruta local. Esta ruta ser referenciada como
<PATH_CONFIGURATION_FILES> a partir de este momento.
133
1.2 Copiar las libreras para el modulo de Autenticacin (bizagi-websphere-security-[version].jar,

bizagi-remote-[version].jar, bizagi-security-common-[version].jar) que se entregan en los archivos de
configuracin, desde esta ruta:
<PATH_CONFIGURATION_FILES>\security\
Hacia el repositorio de las libreras de WebSphere en:
<WAS_HOME>\lib\ext\
1.3 Copiar la librera que se utiliza para el registro de logs llamada log4j-[version].jar que se entrega
en los archivos de configuracin.
Copiarla de esta ruta:
<PATH_CONFIGURATION_FILES>\configuration\
<WAS_HOME>\lib\ext\
1.4 Si utiliza una Base de datos Oracle, edite el archivo de configuracin web.config.xml ubicado en
<PATH_CONFIGURATION_FILES>\JiNET\config\,
de manera que la llave PROVIDERTYPE apunte al uso de Oracle:
1.5 Copiar las libreras que se utilizan para el acceso a datos, que son: la librera bizagi-jdbc-driver[version].jar y la librera eclipselink-[version].jar (que se usa para la persistencia de datos) y que se
entregan en los archivos de configuracin.
Copiarlas de esta ruta:
<WAS_HOME>\lib\ext\
2. Configurar las variables de entorno

Para configurar las variables que sern referenciadas como parmetros de ejecucin en el Servidor,
primero inicie el servicio de su instancia de WebSphere.
Seguidamente, acceda a la Consola de administracin.
134
Ntese que cuando se realizan cambios a travs de la Consola de administracin, deber

guardarlos en la configuracin maestra. Para ello, se usa el enlace de Guardar (Save) que persiste
los cambios.
Este enlace aparecer en la parte superior siempre que se haya dado clic en OK o en Aplicar
(Apply).
Vaya a la seccin de administracin del sistema (System administration) y expndala para ubicar el
DM (Deployment Manager.
Ubique la seccin de Infraestructura del servidor (Server Infrastructure) , localizada en la segunda
columna.
En ella, expanda el tem Java and Process Management y d clic sobre la definicin de Procesos
(Process definition).
D clic sobre el enlace de la configuracin de mquina virtual de Java (Java Virtual Machine), ubicada
en la seccin de Propiedades adicionales (Additional Properties).
135
Ingrese los siguientes valores para las variables y propiedades como se ensea a continuacin:
Initial heap size (tamao inicial de pila de memoria): Por defecto es 256.
Se recomienda usar: 768
Maximum heap size (tamao mximo de pila de memoria): 1024
D clic en OK y luego en Guardar (Save) para aplicar los cambios.
Vaya a la seccin de Servidores (Servers) y expndala para ubicar los tipos de Servidores (Server
Types). Expanda esta seccin y d clic sobre WebSphere application servers.
All aparecern los nodos que hacen parte de su clster.
Ahora vamos a configurar las variables de entorno para todos los nodos.
Por lo tanto, los siguientes pasos de configuracin deber repetirlos para cada nodo que hace parte
de su clster.
Para esta configuracin, haga clic sobre cada nodo.
Al seleccionar un nodo, navegue hacia la seccin de Infraestructura del servidor (Server Infrastructure),
localizada en la segunda columna.
136
Navegue hacia el enlace Java Virtual Machine (ubicado en las propiedades adicionales --Additional
Properties--).
Initial heap size (tamao inicial de pila de memoria): Por defecto es 256.
Se recomienda usar: 768
Generic JVM arguments (argumentos genricos de la mquina virtual de Java):
-DiNET_HOME=<PATH_CONFIGURATION_FILES>\JiNET
-Duser.language=en
Duser.country=us -Dfile.encoding=UTF-8
Ntese que deber reemplazar <PATH_CONFIGURATION_FILES> con la ruta correspondiente en su
instalacin.
Tenga en cuenta que en Sistemas operativos Linux, debe utilizar el caracter de separacin de carpetas
apropiado (en vez del "\").
137
Haga clic sobre el enlace de propiedades personalizadas (Custom properties).

A continuacin, se deben crear las siguientes propiedades:
APP_SERVER: Propiedad usada internamente por Bizagi para manejo acorde al servidor JEE.
bizagi.cache.multicast.enabled: Propiedad booleano para habilitar el manejo del cach distribuido.
bizagi.cache.multicast.address: Propiedad de tipo cadena (string) que permite especificar la
direccin IP de broadcast para la sincronizacin en los diferentes nodos. Por defecto se toma
224.2.2.3.
bizagi.cache.multicast.port: Propiedad de tipo numrico para especificar el puerto sobre el cul se
lleva a cabo la sincronizacin en los diferentes nodos. Por defecto se toma 7777.
bizagi.cache.multicast.type: Propiedad de tipo cadena (string) que permite especificar el protocolo
que se usa para la sincronizacin. Los valores permitidos son UDP (valor por defecto) y DB.
Para crear estas propiedades, d clic sobre el botn de Nuevo (New) para registrar una propiedad
personalizada.
Nombre esta propiedad con: APP_SERVER, y especifique para su valor: WEBSPHERE.
D clic en Ok y despus nuevamente sobre el botn de Nuevo (New) para registrar otra propiedad
personalizada.
Nombre esta propiedad como: bizagi.cache.multicast.enabled, y especifique para su valor:
true.
personalizada.
Nombre esta propiedad como: bizagi.cache.multicast.address, y especifique la direccin IP.
138
personalizada.
Nombre esta propiedad como: bizagi.cache.multicast.port, y asigne el puerto.
personalizada.
Nombre esta propiedad como: bizagi.cache.multicast.type, y especifique para su valor: UDP.
Recuerde que estos ltimos pasos deber hacerlos para cada nodo que hace parte de su clster.
Al finalizar con la totalidad de los nodos, reinicie el servicio.
3. Configurar los mdulos de WebSphere

Se deben configurar algunos mdulos en WebSphere a travs de la Consola de administracin, como
se indica a continuacin.
3.1 Autenticacin
Acceda a la Consola de administracin, y vaya a la seccin de Seguridad (Security) y de expanda el
item de Seguridad global (Global Security).
Seleccione la casilla de Habilitar la seguridad a nivel de aplicacin (Enable application security) y d
clic sobre Aplicar (Apply).
D clic sobre Dominios de seguridad (Security domains) , en la misma seccin de Seguridad

(Security).
D clic sobre el botn Copy Global Security.. para registrar un dominio de seguridad.
139
Ingrese BizagiDomain en el Nombre (Name) del nuevo dominio:
D clic en OK.
D clic sobre el dominio recin creado (BizagiDomain), que aparecer listado:
140
En sus propiedades, asegrese de marcar la casilla que del scope que incluye el clster (debe
visualizarse bajo Clusters como [Nombre_clster]).
Realice esto expandiendo los tems necesarios en en la seccin de los scopes asignados (Assigned
Scope):
En la seccin de atributos de seguridad (Security Attributes):
141
Expanda el tem de Seguridad a nivel de aplicacin (Application Security). Revise que la casilla
(Enabled application security) est marcada (para el valor de Personalizar este dominio --Customize
this domain--).
Expanda el tem de logins de JAAS (JAAS System logins), y d clic sobre el enlace de logins del
sistema (System logins), nuevamente para el valor de Use global and domain-specific logins.
142
143
Para esta definicin, haga clic en WEB_INBOUND:
Haga clic en Nuevo (New) para crear un login de JAAS. Asegrese de especificar:
Module class name: com.bizagi.security.jaas.BizAgiLoginModule.
Authentication strategy (Estrategia de autenticacin): REQUIRED
144
D clic en OK.
Ntese que el nuevo mdulo ser listado dentro de los mdulos usados bajo cierto orden
predeterminado.
D clic sobre el botn de Determinar el orden (Set order... ) para una re-ordenacin.
A travs de esta opcin, asegrese de listar este nuevo mdulo de primero en la lista (utilizando el
botn de Mover hacia arriba --Move up--).
145
D clic en OK, y revise que BizAgiLoginModule sea el primero de los mdulos de WEB_INBOUND
(module order = 1).
146
Finalmente, d clic en Guardar (Save) para persistir los cambios.

En este punto el Servidor requiere de un reinicio.
3.2 Acceso a datos

Antes de continuar, tenga en cuenta que si utiliza una base de datos SQL Server, deber requerir que
el servicio no se inicie bajo un puerto dinmico.
Se requiere que se use un puerto TCP/IP explcitamente (p.e el 1433 que es el usado por defecto).
147
Para la siguiente configuracin, acceda la Consola de administracin y realice los siguientes pasos.
Ntese que para algunos de ellos, debe tener a la mano los valores de acuerdo a su motor de Base
de datos (Oracle o SQL Server).
Primero, vamos a registrar un Proveedor de datos JDBC.
Para ello, vaya a la seccin de recursos (Resources) y expanda el item JDBC. D clic sobre los
Proveedores JDBC (JDBC Providers).
Asegrese de seleccionar
Cluster=[Nombre_clster]).
el
scope
que
incluye
el
clster
(debe
listarse
como
148
Cree un Provider haciendo clic sobre el botn Nuevo (New).

En la configuracin del nuevo Proveedor (que se realiza a travs de 3 pasos asistidos), ingrese la
informacin correspondiente a su motor de Base de datos.
o
o
o
o
Para Oracle:
Database type (tipo de Base de datos): Oracle
Provider type (tipo de Proveedor de datos): Oracle JDBC Driver
Implementation type (tipo de implementacin): Connection pool data source
Name (Nombre): Oracle JDBC Driver
149
D clic en Siguiente (Next) y especifique la ruta completa al driver de conexin de Oracle (ojdbc):
Ntese que debe renombrar el archivo ojdbc , para que no se incluya la versin menor especfica
dentro de su nombre (debe quedar como ojdbc6.jar), de manera que pueda ser referenciado por
este nombre genrico y WebSphere lo encuentre.
150
D clic en Siguiente (Next) y revise la informacin de resumen. D clic sobre Finalizar (Finish).
Para SQL Server:
o Database type (tipo de Base de datos): User-defined
o Implementation class name (Nombre de la clase de la implementacin):
com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
o Name (Nombre): SQLServerProvider
151
D clic en Siguiente (Next) y especifique la ruta completa hacia el driver de conexin de SQL Server
(sqljdbc).
Ntese que este .jar est contenido en los archivos de configuracin de Bizagi, dentro de
<PATH_CONFIGURATION_FILES>.
152
Una vez se haya creado el Proveedor, ste aparecer listado en la tabla (sea Oracle o SQL Server).
Tenga en cuenta que debe dar clic sobre Guardar (Save) para aplicar los cambios en la configuracin
maestra.
Ahora vamos a crear y registrar una fuente de datos para la conexin a la Base de datos del proyecto.
Para ello, ubique el panel a la izquiera para ir rpidamente al enlace de Fuentes de datos (Data
sources), ubicado todava bajo la seccin de recursos (Resources) sobre el item JDBC.
Asegrese de seleccionar el scope que incluye el clster (debe listarse como
153
Data source name (nombre de la fuente de datos): BizAgiJava
JNDI name (nombre JNDI): BizAgiJava
D clic en Siguiente (Next) y marque la opcin de seleccionar un Proveedor JDBC existente (Select an
existing JDBC Provider).
De esta manera, seleccione el Proveedor de acuerdo a su motor de Base de datos (Oracle o SQL
Server, tal como se cre el Proveedor previamente).
154
Si usted utiliza una Base de datos SQL Server d clic en Siguiente (Next) en las ventanas a
continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar
--Finish-- para crear la fuente de datos).
No se requiere configuracin adicional para esta fuente de datos en Bizagi cuando se utiliza SQL
Server, e igualmente se pueden mantener los valores por defecto de WebSphere.
Si usted utiliza una Base de datos Oracle, d clic en Siguiente (Next) y asegrese de: editar la URL de
la cadena de conexin y de seleccionar Oracle data store helper para la configuracin del
Data Store helper class name.
Considere:
el puerto 1521.
155
Una vez que haya configurado la conexin a su instancia, d clic en Siguiente (Next) en las ventanas a
continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar -Finish-- para crear la fuente de datos).
D clic sobre la fuente de datos creada BizAgiJava para configurar las propiedades adicionales, la cul
aparecer listada en la tabla sea Oracle o SQL Server.
D clic en el enlace de propiedades personalizadas (Custom properties) ubicado en la seccin de
Propiedades adicionales (Additional Properties).
Para Oracle:
o webSphereDefaultIsolationLevel: Asgnelo a 2. Este valor indicar un nivel llamado READCOMMITTED.
Adicional, cree 2 nuevas propiedades: usuario (user) y contrasea (password). Para sus valores
considere:
156
Para SQL Server:

1433.
o webSphereDefaultIsolationLevel: Asgnelo a 1. Este valor indicar un nivel READ-UNCOMMITTED.
157
Despus de editar estas propiedades, asegrese de dar clic en Guardar (Save) para aplicar los
cambios.
Una vez se haya configurado la fuente de datos, puede dar clic directamente sobre ella (BizAgiJava)
para ir a la ventana anterior y utilizar la opcin de verificar la conexin (Test connection):
3.3 Servicio de mensajera (JMS)
En los siguientes pasos configuraremos un Servidor JMS que es utilizado por Bizagi para ejecutar
Actividades Asncronas.
En la configuracin de clster, es muy importante crear tambin un recurso adicional que se encarga
del manejo de la memoria cach sin afectar recursos o desempeo involucrado en las dems tareas
(Mensajera para el manejo de cach).
Para crear los recursos involucrados, acceda la Consola de administracin y vaya a la seccin de
Integracin del servicio (Service integration) y d clic sobre Buses.
158
Bus de integracin del servicio

D clic sobre Nuevo (New) para crear un bus que permita la activacin de los servicios de mensajera.
Ingrese BizAgiBus como su nombre (Name), y asegrese de desmarcar la casilla de Seguridad a
nivel de Bus (Bus security).
D clic en Siguiente (Next), y luego en Finalizar (Finish) para crear el bus.
159
D clic sobre el bus recientemente creado (BizAgiBus) y luego d clic sobre el enlace de Miembros del
Bus (Bus members) en la seccin de Topologa (Topology).
Asocie la instancia del servidor como miembro, haciendo clic en Adicionar (Add).
En el nuevo miembro del bus, asegrese de habilitar Cluster y seleccionar de la lista, el nombre de
su clster.
160

Marque la casilla de Enable Messaging engine policy assitance? y seleccione
Scalability with high availability como el tipo de poltica a utilizar (policy type).

Seleccione File store como el tipo de almacenamiento de mensajera a utilizar y d clic en
Siguiente (Next).
161
Ntese que aparece el listado de motores de mensajera que se crean por defecto, y que no estn
configurados an (Is the message store configured = No).
D clic sobre el nombre (Name) del motor de mensajera para configurarlo (y deber repetir el paso
para configurar cada motor).
Para configurar cada motor de mensajera, conserve los valores por defecto para las propiedades,
pero asegrese de ingresar:
Log directory path: El directorio donde quedan los logs asociados al nodo.
Debe referenciar <WAS_HOME>\profiles\<NODE_NAME>\logs
Permanent store directory path: El directorio donde queda el almacen de archivo.
Debe referenciar <WAS_HOME>\profiles\<NODE_NAME>\filestores
162

Recuerde repetir este paso para el otro motor de mensajera, y despus revisar que los dos hayan
quedado configurados (Is the message store configured = Yes).
Configure el uso de memoria. Se recomienda incrementar la memoria sugerida por defecto a los
siguientes valores:
Initial JVM heap size: 768
Maximum JVM heap size: 1024
Adicionalmente, marque la casilla Change heap size y d clic en Siguiente (Next) .
Verifique en el resumen de la configuracin que la informacin sea la correcta y d clic en Finalizar
(Finish) .
Asegrese de dar clic en Guardar (Save) para aplicar los cambios.
Recursos destino
De vuelta en la informacin del bus, d clic sobre el enlace de Destinos (Destinations), ubicado bajo la
seccin de los recursos destino (Destination resources ) para crear y asociar una cola (queue).
163
D clic en Nuevo (New ) para crear la cola (destination type = Queue).
D clic en Siguiente (Next) e ingrese BizagiQueue como identificador (identifier) de la cola.

Ingrese una descripcin tambin.
164
D clic en Siguiente (Next) y asegrese de seleccionar el miembro de bus como se configur

anteriormente (para incluir la configuracin que abarca el clster):
D clic en Siguiente (Next ) y luego en Finalizar (Finish) para registrar el destino. Esta informacin
aparecer listada en la tabla de recursos destino.
165
D clic sobre la cola recin creada (BizAgiQueue) para editar su configuracin de reintentos.
En el detalle de la cola, edite el nmero mximo de intentos fallidos del mensaje (Maximum failed
deliveries per message), para que tenga un valor igual a 1 (el Servidor de Aplicaciones hara un
reintento para las Actividades Asncronas a nivel de colas, lo cual quiere decir que se respetara la
configuracin de reintentos de la Asncrona en Bizagi).
166
D clic en OK. Recuerde dar clic en Guardar (Save) para aplicar los cambios igualmente.
Fbrica de conexiones JMS
Ahora crearemos una Fbrica de conexiones para JMS.
Navegue a la seccin de Recursos (Resources) y expanda el item JMS. D clic sobre Queue Connection
factories.
Cluster=[Nombre_clster]) y de clic en Nuevo (New) para crear una fbrica de conexin de colas
(Queue Connection factory).
167
Para el nuevo recurso, mantenga el Proveedor de mensajera por defecto: Default messaging
provider, y d clic en OK.
Esto nos lleva a definir las propiedades principales de la nueva fbrica de conexiones.
Ingrese AsyncControllerFactory tanto para el Nombre (Name) como para el Nombre JNDI (JNDI
Name).
Asegrese de seleccionar el bus creado para Bizagi (BizAgiBus).
168
D clic en Ok.
D clic en la Fbrica creada recin AsyncControllerFactory (la cual aparecer listada en la tabla), para
editar el parmetro de timeout de la conexin.
169
D clic en las propiedades del Pool de conexiones (Connection pool properties) ubicado bajo la
Asigne el timeout de la conexin (Connection timeout) a 120 segundos y d clic en OK.
170
Recuerde guardar (dar clic en Save) para aplicar los cambios.

Recurso de colas
Ahora crearemos un recurso de colas. Para hacerlo, ubique el panel a la izquierda para seleccionar
rpidamente el enlace de colas (Queues) , ubicado en la seccin de recursos (Resources) bajo el item
JMS.
D clic en Nuevo (New) para crear este recurso. Mantenga el Proveedor de mensajera por defecto:
Default messaging provider y d clic en OK.
171
Ingrese la siguiente informacin para el recurso de colas :

Name (Nombre): AsyncController
JNDI Name (Nombre JNDI): jms/AsyncController
Bus name (Nombre del bus): seleccione el bus para Bizagi: BizAgiBus.
Queue name (Nombre de la cola): seleccione la cola creada anteriormente: BizAgiQueue.
172
Ahora crearemos otro recurso para la especificacin de las activaciones (Activation specification).
Para hacerlo, ubique el panel a la izquierda para seleccionar rpidamente el enlace Activation
specifications , ubicado en la seccin de recursos (Resources) bajo el item JMS.
Ingrese el siguiente detalle para la especificacin:

Name (Nombre): AsyncControllerActivationSpec
JNDI Name (Nombre JNDI) : eis/AsyncControllerActivationSpec
Destination type (tipo de destino): seleccione cola: Queue
Destination JNDI Name (Nombre JNDI del destino): jms/AsyncController
173
Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus

Mensajera para el manejo de cach
La capa de acceso a datos de Bizagi est basada en el framework JPA (Java Persistence API). En el
manejo de esta capa Bizagi utiliza EclipseLink y se involucra una optimizacin en cach orientada a
mejorar el desempeo de las aplicaciones.
Es importante que este cach est replicado en todos los nodos que hacen parte de un clster, para lo
cual se crea una Fbrica de tpicos y un tpico.
Ubique el panel a la izquierda para seleccionar rpidamente la opcin Topic Connection factories ,
ubicada en la seccin de recursos (Resources) bajo el item JMS.

Name (Nombre): EclipseLinkTopicConnectionFactory
174
JNDI Name (Nombre JNDI) : jms/EclipseLinkTopicConnectionFactory

D clic en OK.
Para crear el tpico, ubique el panel a la izquierda para seleccionar rpidamente la opcin Tpico
(Topics) , ubicada en la seccin de recursos (Resources) bajo el item JMS.

Name (Nombre): EclipseLinkTopic
JNDI Name (Nombre JNDI) : jms/EclipseLinkTopic
Topic Name (Nombre del tpico): EclipseLinkTopic
Topic space (Nombre de espacio al que pertenece el tpico: Default.Topic.Space
JMS delivery modo (Modo de entrega): Nonpersistent
175

3.4 Libreras compartidas como un concepto de repositorio reutilizable
Configure el concepto de libreras compartidas en WebSphere para que el despliegue de la aplicacin
de Bizagi sea ms rpido y se tenga la opcin de utilizar libreras que potencialmente se usen por
otros aplicativos.
Para ello, navegue a la seccin del Entorno (Environment) y d clic sobre Libreras compartidas
(Shared libraries).
De clic en Nuevo (New) para registrar las libreras compatidas. Tenga en cuenta que este paso se
repite para registrar 3 libreras:
BizagiLibs-ear
BizagiLibs-war
Eclipselink.jar
Para la primera librera compartida, ingrese el siguiente detalle para la especificacin:
Name (Nombre): BizagiLibs-ear
Classpath: <PATH_CONFIGURATION_FILES>/libs/earLib
Ntese que <PATH_CONFIGURATION_FILES> hace referencia a la ruta donde se encuentran los
archivos de configuracin de Bizagi.
176
D clic en Ok y repita este paso para crear otra librera compartida.

Para la segunda, ingrese el siguiente detalle para la especificacin:
Name (Nombre): BizagiLibs-war
Classpath: <PATH_CONFIGURATION_FILES>/libs/warLib
D clic en Ok y repita nuevamente este paso para crear la tercer librera compartida.
Para la tercera, ingrese el siguiente detalle para la especificacin:
Name (Nombre): Eclipselink
Classpath: <PATH_CONFIGURATION_FILES>/libs/elLib
Adicionalmente, tenga presente que la librera de eclipselink tendr que referenciarse como
eclipselink.jar (sin el detalle de la versin) y por lo tanto, el archivo .jar fsicamente debe ser
renombrado para que no incluya la versin.
Si usted utiliza Oracle como la Base de datos de Bizagi, deber asegurase de tener en la ruta del
Classpath la siguiente librera:
xmlparserv2.jar (12g)
Esta librera se puede encontrar como parte de la distribucin Oracle Toplink.
Las 3 libreras compartidas saldrn listadas al finalizar este paso.
177

3.5 Timeout de las transacciones y usuario administrador por defecto
Para definir el timeout de las transacciones, incrementamos la cantidad empleada por defecto para
permitir transacciones de mayor duracin (p.e til en la sincronizacin de usuarios LDAP).
Para hacerlo, acceda a la Consola de administracin y vaya a la seccin de Servidores (Servers).
Expanda el item tipos de servidores (Server types) y d clic sobre el enlace WebSphere Application
Servers.
Asegrese de realizar estos cambios para los nodos de su clster.
Expanda el item de Servicios del contenedor (Container Services) bajo la seccin de Configuracin del
contenedor (Container settings), y d clic sobre Servicio de la transaccin (Transaction service).
178
Edite las propiedades: Tiempo de espera del ciclo de la transaccin total (Total transaction lifetime
timeout) y Tiempo de espera mximo de la transaccin (Maximum transaction timeout). Asigne
3600 segundos a ambas propiedades.

Usuario administrador
La configuracin del usuario administrador por defecto de Bizagi se realiza estrictamente para el
usuario llamado admon del dominio por defecto llamado domain.
Para la configuracin de este usuario, acceda la Consola de administracin y vaya a la seccin de
Usuarios y grupos (Users and groups) , y d clic sobre el enlace de Administrar usuarios (Manage
users ).
179
D clic en el botn de crear (Create... ) para registrar el usuario administrador por defecto.
Ingrese la siguiente informacin:
User ID (id de usuario): domain\admon
First name (nombre): BizAgi
Last name (apellido): BizAgi
Password (contrasea): Ingrese el password de su preferencia.
D clic sobre Crear (Create). WebSphere notificar que la operacin ha sido exitosa, y podr hacer clic
sobre Cerrar (Close).
En este punto su WebSphere deber ser reiniciado.
Una vez que complete estos pasos, consulte la Configuracin de el Scheduler en WebSphere.
180
Escalamiento
En cualquier momento que se desee escalar la solucin (agregar ms nodos de manera horizontal o
vertical al clster), puede hacerlo asegurndose de: crear el perfil de tipo custom en el nodo, y
agregarlo al clster. Deber cerciorarse tambin de incluir los archivos de configuracin de Bizagi en el
nuevo nodo y llevar a cabo los pasos que apliquen a nivel de nodo.
En resumen, al ingresar un nuevo nodo debe:
1. Crear el perfil custom para ese nodo.
2. Agregar el nodo al clster.
3. Copiar los archivos de configuracin de Bizagi hacia el nuevo nodo (paso 1 del procedimiento).
4. Configurar las variables de entorno para ese nodo (paso 2 del procedimiento).
Adicional a lo anterior, debe asegurarse de que el nodo quede registrado en el balanceador de
cargas.
Esto puede implicar actualizar cambios a nivel del Servidor de Aplicaciones, como por ejemplo en
WebSphere como se indica en
Configurar el balanceo de cargas.
Introduccin
Para ambientes de alta disponibilidad donde se tiene Bizagi en un ambiente de clster, Bizagi ofrece la
posibilidad de configurar su servicio de Scheduler (programador) de manera que se tenga un
esquema de:
Tolerancia a fallos en el programador (para que ste se pueda ejecutar sobre cualquier nodo de la
solucin).
Administracin del programador para que se pueda detener, iniciar o reiniciar el servicio de manera
independiente en cualquier momento.
Prerrequisitos
Para configurar del servicio de Scheduler de WebSphere asegrese de cumplir con los siguientes
prerrequisitos:
Se debe haber configurado la solucin de Bizagi en WebSphere.
Para ms informacin sobre ello, consulte Configuracin en clster de WebSphere.
Tenga a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWebsphere-dist.zip). Estos archivos deben haber sido descomprimidos en los pasos de
configuracin de WebSphere y ubicados en una ruta que ser referenciada como
<PATH_CONFIGURATION_FILES> en esta seccin.
Configuracin
Ubique la siguiente ruta local:
<PATH_CONFIGURATION_FILES>/BizagiSchedulerService/
1. En esa ruta, configure el archivo de propiedades scheduler_configuration.properties
Para ello, considere:
bizagi.scheduler.timer: Propiedad utilizada para indicar al temporizador el intervalo de tiempo en
el cual debe ser ejecutado el scheduler de Bizagi. Por defecto el valor asignado es de 30 Segundos.
bizagi.scheduler.connection.port: Nmero de puerto asignado al servicio por el cual sern
181
recibidas las peticiones. Por defecto el valor asignado es 5681.

bizagi.scheduler.remote.connection.retries: Propiedad que define en caso de presentarse un
problema de conexin, el nmero de reintentos mximo para establecer una comunicacin con el
servidor de aplicaciones. Por defecto el valor asignado es 3.
2. Copie las libreras cliente para EJB en la ruta <PATH_CONFIGURATION_FILES>/

BizagiSchedulerService/lib/ext/
Estas se encuentran en la ruta de instalacin del servidor de aplicaciones:
<WAS_HOME>/runtimes/com.ibm.ws.ejb.thinclient_[VERSION].jar
<WAS_HOME>/runtimes/com.ibm.ws.orb_[VERSION].jar
3. Configure el archivo de propiedades custom_jndi.properties:

java.naming.factory.initial: Propiedad de uso exclusivo de Bizagi que define el contexto del
componente cliente que ser utilizado para establecer comunicacin con el servidor de aplicaciones
WebSphere.
El
valor
asignado
a
esta
propiedad
es:
com.ibm.websphere.naming.WsnInitialContextFactory
java.naming.provider.url: Propiedad configurable en la cual se especifica el nombre o direccin IP
del servidor de aplicaciones. El valor asignado debe cumplir con el siguiente formato:
o Configuracin para un ambiente distribuido, clster horizontal: Se define la lista de servidores que
hacen parte del clster con su respectivo puerto.
corbaloc:iiop:[SERVER_NAME1]:[PORT1],:[SERVER_NAME2]:[PORT2],:
[SERVER_NAME3]:[PORT3]
o Configuracin para un ambiente distribuido, clster vertical: Se utiliza el mismo nombre de
servidor y simplemente cambia el nmero de puerto que le fue asignado a cada nodo virtual.
corbaloc:iiop:[SERVER_NAME]:[PORT1],:[SERVER_NAME]:[PORT2],:
[SERVER_NAME]:[PORT3]
java.naming.security.principal: Esta propiedad por defecto se encuentra deshabilitada (#). Si en el
servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer comunicacin
con componentes externos, se bebe especificar el nombre del usuario creado.
java.naming.security.credentials: Esta propiedad por defecto se encuentra deshabilitada (#). Si en
el servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer
comunicacin con componentes externos, se bebe especificar la contrasea del usuario creado.
ejb.remote.jndi: Propiedad de uso exclusivo de Bizagi en la cual se especifica la direccin (JNDI)
utilizada para acceder al servicio remoto de Scheduler que se encuentra en el servidor de
aplicaciones WebSphere. Se debe cambiar el token [CLUSTER_NAME] por el valor asignado
durante la creacin del clster:
cell/clusters/[CLUSTER_NAME]/
BizAgiSchedulerBean#com.vision.bizagi.scheduler.BizAgiSchedulerRemote
Operacin del servicio

Tenga presente que para la operacin del servicio deben estar correctamente definidas las variables
de
entorno:
bizagi.cache.multicast.enabled,
bizagi.cache.multicast.address,
bizagi.cache.multicast.port, y bizagi.cache.multicast.type (como se indica en la seccin de
configuracin de variables de entorno para configurar WebSphere para trabajar en clster).
182
Para iniciar el servicio, ejecute el archivo start-service como usuario administrador.

En Linux OS, este archivo ser:
<PATH_CONFIGURATION_FILES>/BizagiSchedulerService/bin/start-service.sh
En Windows, este archivo ser:
<PATH_CONFIGURATION_FILES>\BizagiSchedulerService\bin\start-service.bat
sta operacin crea un proceso javaw.exe el cual se mantiene en ejecucin utilizando el puerto (por
defecto 5681) configurado en el archivo scheduler_configuration.properties.
Para detener el servicio, simplemente se debe ejecutar el archivo shutdown-service como usuario
administrador.
<PATH_CONFIGURATION_FILES>/BizagiSchedulerService/bin/shutdown-service.sh
<PATH_CONFIGURATION_FILES>\BizagiSchedulerService\bin\shutdown-service.bat
Una vez que complete estos pasos, consulte la Configuracin de la arquitectura del sistema.
Configuracin estndar de WebSphere
Introduccin
Esta seccin se enfoca en la configuracin de WebSphere para trabajar con Bizagi, dirigida a un
ambiente de pruebas o de produccin y bajo una configuracin standalone (usando un nico servidor
BPM y sin balanceo de cargas).
183
Si desea configurar WebSphere en un esquema de alta disponibilidad y con la posibilidad de balanceo

de cargas, consulte la Configuracin en clster de WebSphere.
Ntese que para el ambiente de desarrollo (con Bizagi Studio), no se requieren pasos de
configuracin dado que la edicin de Bizagi JEE incluye una instancia de Servidor JBoss, el cual es
embebido y configurado de manera automtica.
Tenga en cuenta que lo recomendado es utilizar la instancia por defecto de JBoss en desarrollo, dado
que se promueve la agilidad en la implementacin (JBoss es un Servidor ms ligero e inicia o reinicia
ms rpido, y para su proyecto no requiere de configuracin adicional).
Sin embargo, si su proyecto requiere estrictamente que se utilice WebSphere en el ambiente de
desarrollo, siga los pasos a continuacin para ese ambiente tambin.
Prerrequisitos
Para configurar su instancia de WebSphere en un ambiente de pruebas o produccin, se requiere:
Tener instalado el JDK de JAVA. Se recomienda enfticamente utilizar el JDK 6, update 45.
La variable de entorno JAVA_HOME configurada previamente (se recomienda que sea en una ruta
sin espacios).
Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWebsphere-dist.zip).
Tener instalado el Servidor WebSphere. Las versiones soportadas son las pertenecientes a
WebSphere V7.
WebSphere puede ser solicitado directamente desde la pgina oficial de IBM.
Tenga presente que debe tener el instalador apropiado a su sistema, y que para su instalacin, debe
seguir tanto los requisitos de WebSphere, como los lineamientos presentados en la siguiente seccin.
184
Requisitos de WebSphere
Para instalar WebSphere (una vez que haya cubierto todos los prerrequisitos), asegrese de
considerar lo siguiente:
Instalar los componentes de Servidor de Aplicacin (Application Server) de WebSphere.
Habilitar la seguridad administrativa (Administrative security), y definir un usuario y contrasea para

la misma.
185
Una vez que haya instalado WebSphere Application Server, tenga presente que debe aplicar las
ltimas actualizaciones y paquetes de mejoras (feature packs) del proveedor. Para hacerlo,
recomendamos utilizar el Actualizador IBM Update Installer para WebSphere, y descargar igualmente
los fixes ms recientes para su instancia de WebSphere Application Server V7.0 (esto es, instalar los
paquetes de mantenimiento).
La ruta de instalacin, que incluye la instancia del servidor creada (server1), ser referenciada a partir
de este momento como <WEBSPHERE_HOME> en esta seccin.
Opciones de WebSphere
Para ms informacin acerca de como iniciar, detener o acceder a las opciones de administracin de
la consola en WebSphere, consulte la informacin a continuacin.
Iniciar el Servidor (domain)

Para iniciar el servicio de WebSphere, ejecute el siguiente archivo desde una consola de comandos:
En Linux:
<WEBSPHERE_HOME>/profiles/AppSrv01/bin/startServer.sh server1
En Windows:
<WEBSPHERE_HOME>\profiles\AppSrv01\bin\startServer.bat server1
Ntese que server1 es la instancia instalada por defecto de WebSphere Application Server.
186
En sistemas operativos Windows, puede tambin optar por iniciar el servicio desde la opcin del
men (p.e. IBM WebSphere -> Application Server V7.0 -> Profiles -> AppSrv01 -> Start the Server).
Detener el Servidor (domain)

Para detener los servicios de WebSphere, execute el siguiente archivo en un smbolo del sistema.
En Linux:
<WEBSPHERE_HOME>/profiles/AppSrv01/bin/stopServer.sh server1
En Windows:
<WEBSPHERE_HOME>\profiles\AppSrv01\bin\stopServer.bat server1
Ntese que server1 es la instancia instalada por defecto de WebSphere Application Server.
En sistemas operativos Windows, puede tambin optar por iniciar el servicio desde la opcin del
menu (p.e. IBM WebSphere -> Application Server V7.0 -> Profiles -> AppSrv01 -> Stop the Server).
Acceder a la Consola de administracin

Para acceder a la Consola de administracin de WebSphere, ingrese la siguiente URL en un
navegador:
https://localhost:9043/ibm/console/logon.jsp
187
Lo que debe hacer

Para la configuracin de WebSphere para trabajar con Bizagi, el siguiente procedimiento se lleva a
cabo:
1. Extraer los archivos usados por Bizagi hacia WebSphere.
3. Configurar los siguientes mdulos en WebSphere:
Autenticacin
Acceso a datos
Otros, tales como el timeout en transacciones, y el usuario administrador por defecto
Estos mdulos se configuran en WebSphere utilizando su Consola de administracin, y utilizan a su vez
Despus de estos pasos, su instancia de WebSphere estar configurado para que los Procesos de
Bizagi se desplieguen en una aplicacin JEE (el Portal de Trabajo).
Procedimiento
de WebSphere por defecto.
188
1. Extraer los archivos usados por Bizagi hacia WebSphere

En este paso, se incluyen archivos usados por Bizagi en la instancia de WebSphere (son archivos que
no vienen por defecto en la instalacin limpia).
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-Webspheredist.zip).
1.2 Copiar las libreras para el modulo de Autenticacin (bizagi-websphere-security-[version].jar,
bizagi-remote-[version].jar, bizagi-security-common-[version].jar) que se entregan en los archivos de
configuracin, desde esta ruta:
<WEBSPHERE_HOME>\lib\ext\
1.3 Copiar la librera que se utiliza para el registro de logs llamada log4j-[version].jar y la librera
eclipselink-[version].jar (que se usa para la persistencia de datos), que se entregan en los archivos de
configuracin.
Copiarlas de esta ruta:
<WEBSPHERE_HOME>\lib\ext\
1.4 Si utiliza una Base de datos Oracle, edite el archivo de configuracin web.config.xml ubicado en
<PATH_CONFIGURATION_FILES>\JiNET\config\, de manera que la llave PROVIDERTYPE apunte
al uso de Oracle:
189
primero inicie el servicio de su instancia de WebSphere.
Seguidamente, acceda a la Consola de administracin.
Ntese que cuando se realizan cambios a travs de la Consola de administracin, deber

guardarlos en la configuracin maestra. Para ello, se usa el enlace de Guardar (Save) que persiste
los cambios.
Este enlace aparecer en la parte superior siempre que se haya dado clic en OK o en Aplicar
(Apply).
Vaya a la seccin de Servidores (Servers) y expndala para ubicar los tipos de Servidores (Server
Types). Expanda nuevamente esta seccin y d clic sobre WebSphere application servers.
Haga clic sobre su instancia del Servidor, que por defecto es server1.
Ubique la seccin de Infraestructura del servidor (Server Infrastructure) , localizada en la segunda

columna.
190
D clic sobre el enlace de la configuracin de mquina virtual de Java (Java Virtual Machine), ubicada
en la seccin de Propiedades adicionales (Additional Properties).
Initial heap size (tamao inicial de pila de memoria): 768
Generic JVM arguments (argumentos genricos de la mquina virtual de Java):
-Duser.language=en
Duser.country=us -Dfile.encoding=UTF-8
191
Tenga en cuenta que en Sistemas operativos Linux, debe utilizar el caracter de separacin de carpetas
apropiado (en vez del "\").
Ntese que debe reemplazar <PATH_CONFIGURATION_FILES> con el valor correspondiente a esta

ruta de archivos de configuracin.
192
Navegue nuevamente hacia el enlace Java Virtual Machine (ubicado en las propiedades adicionales -Additional Properties--), pero esta vez, haga clic sobre el enlace de propiedades personalizadas
(Custom properties).
D clic sobre el botn de Nuevo (New) para registrar una propiedad personalizada.
Nombre esta propiedad con: APP_SERVER, y especifique para su valor: WEBSPHERE.
193

Reinicie el servidor una vez haya finalizado este paso.
3. Configurar los mdulos de WebSphere

Se deben configurar algunos mdulos en WebSphere a travs de la Consola de administracin, como
3.1 Autenticacin
Acceda a la Consola de administracin, y vaya a la seccin de Seguridad (Security) y expanda el tem
de Seguridad global (Global Security).
Seleccione la casilla de Habilitar la seguridad a nivel de aplicacin (Enable application security) y d
clic sobre Aplicar (Apply).
194
D clic sobre Dominios de seguridad (Security domains) , en la misma seccin de Seguridad

(Security).
D clic sobre el botn Copy Global Security.. para registrar un dominio de seguridad.
Ingrese BizagiDomain en el Nombre (Name) del nuevo dominio:
195
D clic en OK.
D clic sobre el dominio recin creado (Bizagidomain), que aparecer listado:
En sus propiedades, asegrese de marcar la casilla de la instancia del Servidor (server1).

Realice esto expandiendo el tem de Nodo (Node), despus expanda el tem de [su_servidor], y el de
Servidores (Servers).
Esta configuracin se encuentra en la seccin de los scopes asignados (Assigned Scope).
196
En la seccin de atributos de seguridad (Security Attributes):

Expanda el tem de Seguridad a nivel de aplicacin (Application Security). Revise que la casilla
(Enabled application security) est marcada (para el valor de Personalizar este dominio --Customize
this domain--).
Expanda el tem de logins de JAAS (JAAS System logins), y d clic sobre el enlace de logins del
sistema (System logins), nuevamente para el valor de Use global and domain-specific logins.
197
198
Para esta definicin, haga clic en WEB_INBOUND:
Haga clic en Nuevo (New) para crear un login de JAAS. Asegrese de especificar:
com.bizagi.security.jaas.BizAgiLoginModule como el nombre de la clase del mdulo
(Module class name).
REQUERIDO como la estrategia de Autenticacin (Authentication strategy= REQUIRED).
199
D clic en OK. Ntese que el nuevo mdulo ser listado dentro de los mdulos usados bajo cierto
orden predeterminado.
D clic sobre el botn de Determinar el orden (Set order... ) para una reordenacin.
A travs de esta opcin, asegrese de listar este nuevo mdulo de primero en la lista (utilizando el
botn de Mover hacia arriba --Move up--).
200
D clic en OK, y revise que BizAgiLoginModule sea el primero de los mdulos de WEB_INBOUND
(module order = 1).
201
Finalmente, d clic en Guardad (Save) para persistir los cambios.

En este punto el Servidor requiere de un reinicio.
3.2 Acceso a datos
Antes de continuar, tenga en cuenta que si utiliza una base de datos SQL Server, deber requerir que
el servicio no se inicie bajo un puerto dinmico.
Se requiere que se use un puerto TCP/IP explcitamente (p.e el 1433 que es el usado por defecto).
202
Para la siguiente configuracin, acceda la Consola de administracin y realice los siguientes pasos.
Ntese que para algunos de ellos, debe tener a la mano los valores de acuerdo a su motor de Base
de datos (Oracle o SQL Server).
Primero, vamos a registrar un Proveedor de datos JDBC.
Vaya a la seccin de recursos (Resources) y expanda el item JDBC. D clic sobre los Proveedores JDBC
(JDBC Providers).
Seleccione el scope que incluye la instancia del servidor (debe listarse como Node=[su_servidor],
Server=server1):
203
Cree un Provider haciendo clic sobre el botn Nuevo (New).

En la configuracin del nuevo Proveedor (que se realiza a travs de 3 pasos asistidos), ingrese la
informacin correspondiente a su motor de Base de datos.
o
o
o
o
Para Oracle:
Database type (tipo de Base de datos): Oracle
Provider type (tipo de Proveedor de datos): Oracle JDBC Driver
Implementation type (tipo de implementacin): Connection pool data source
Name (Nombre): Oracle JDBC Driver
204
D clic en Siguiente (Next) y especifique la ruta completa al driver de conexin de Oracle (ojdbc):
Ntese que debe renombrar el archivo ojdbc , para que no se incluya la versin menor especfica
dentro de su nombre (debe quedar como ojdbc6.jar), de manera que pueda ser referenciado por
este nombre genrico y WebSphere lo encuentre.
205
Para SQL Server:
o Database type (tipo de Base de datos): User-defined
o Implementation
class
name
(Nombre
de
la
clase
de
la
implementacin):
com.microsoft.sqlserver.jdbc.SQLServerConnectionPoolDataSource
o Name (Nombre): SQLServerProvider
206
D clic en Siguiente (Next) y especifique la ruta completa hacia el driver de conexin de SQL Server
(sqljdbc).
Ntese que este .jar est contenido en los archivos de configuracin de Bizagi, dentro de
<PATH_CONFIGURATION_FILES>.
207
Una vez se haya creado el Proveedor, ste aparecer listado en la tabla (sea Oracle o SQL Server).
Tenga en cuenta que debe dar clic sobre Guardar (Save) para aplicar los cambios en la configuracin
maestra.
208
Ahora vamos a crear y registrar una fuente de datos para la conexin a la Base de datos del proyecto.
Para ello, ubique el panel a la izquierda para ir rpidamente al enlace de Fuentes de datos (Data
sources), ubicado todava bajo la seccin de recursos (Resources) sobre el item JDBC.
Server=server1):
209
Data source name (nombre de la fuente de datos): BizAgiJava
JNDI name (nombre JNDI): BizAgiJava
D clic en Siguiente (Next) y marque la opcin de seleccionar un Proveedor JDBC existente (Select an
210
existing JDBC Provider).

De esta manera, seleccione el Proveedor de acuerdo a su motor de Base de datos (Oracle o SQL
Server, tal como se cre el Proveedor previamente).
Si usted utiliza una Base de datos SQL Server, d clic en Siguiente (Next) en las ventanas a
continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en Finalizar
--Finish-- para crear la fuente de datos).
No se requiere configuracin adicional para esta fuente de datos en Bizagi cuando se utiliza SQL
Server, e igualmente se pueden mantener los valores por defecto de WebSphere.
Si usted utiliza una Base de datos Oracle, d clic en Siguiente (Next) y asegrese de editar la URL de
la cadena de conexin.
Considere:
el puerto 1521.
Una vez que haya configurado la conexin a su instancia Oracle, d clic en Siguiente (Next ) en las
ventanas a continuacin (hasta que se llegue al final de los pasos asistidos, donde se debe dar clic en
Finalizar --Finish-- para crear la fuente de datos).
D clic sobre la fuente de datos creada BizAgiJava para configurar las propiedades adicionales, la cul
211
aparecer listada en la tabla sea Oracle o SQL Server.
D clic en el enlace de propiedades personalizadas (Custom properties) ubicado en la seccin de

Propiedades adicionales (Additional Properties).
212
Para Oracle:
o webSphereDefaultIsolationLevel: Asgnelo a 2. Este valor indicar un nivel llamado READCOMMITTED.
Adicional, cree 2 nuevas propiedades: usuario (user) y contrasea (password). Para sus valores
considere:
Para SQL Server:

1433.
o webSphereDefaultIsolationLevel: Asgnelo a 1. Este valor indicar un nivel READ-UNCOMMITTED.
213
Despus de editar estas propiedades, asegrese de dar clic en Guardar (Save) para aplicar los
cambios.
Una vez se haya configurado la fuente de datos, puede dar clic directamente sobre ella (BizAgiJava)
para ir a la ventana anterior y utilizar la opcin de verificar la conexin (Test connection):
214

En los siguientes pasos configuraremos un Servidor JMS que es utilizado por Bizagi para ejecutar
Para ello, acceda la Consola de administracin y vaya a la seccin de Integracin del servicio (Service
integration) y d clic sobre Buses.
Bus de integracin del servicio

D clic sobre Nuevo (New) para crear un bus que permita la activacin de los servicios de mensajera.
Ingrese BizAgiBus como su nombre (Name), y asegrese de desmarcar la casilla de Seguridad a
nivel de Bus (Bus security).
215
D clic en Siguiente (Next), y luego en Finalizar (Finish) para crear el bus.
D clic sobre el bus recientemente creado (BizAgiBus) y luego d clic sobre el enlace de Miembros del
Bus (Bus members) en la seccin de Topologa (Topology).
216
Asocie la instancia del servidor como miembro, haciendo clic en Adicionar (Add).
En el nuevo miembro del bus, asegrese que la instancia del servidor est incluida en la seleccin de la
propiedad Server (desde las opciones del combo).
D clic en Siguiente (Next). Seleccione File store como el tipo de almacenamiento de mensajera a
utilizar.
217
En los siguientes 2 pasos, d clic en Siguiente (Next) para dejar los valores por defecto.
No se requiere configuracin adicional para el almacn de archivos (file store), y su configuracin
podr ser revisada o editada posteriormente por el administrador del Servidor de Aplicaciones.
D clic en Finalizar (Finish) para crear el miembro del bus.
Recursos destino
De vuelta en la informacin del bus, d clic sobre el enlace de Destinos (Destinations), ubicado bajo la
seccin de los recursos destino (Destination resources ) para crear y asociar una cola (queue).
218
D clic en Nuevo (New ) para crear la cola (destination type = Queue).
D clic en Siguiente (Next) e ingrese BizagiQueue como identificador (identifier) de la cola.

Ingrese una descripcin tambin.
219
D clic en Siguiente (Next) y asegrese de seleccionar el miembro de bus como se configur

anteriormente (para incluir la instancia del servidor):
D clic en Siguiente (Next ) y luego en Finalizar (Finish) para registrar el destino. Esta informacin
aparecer listada en la tabla de recursos destino.
220
D clic sobre la cola recin creada (BizAgiQueue) para editar su configuracin de reintentos.
En el detalle de la cola, edite el nmero mximo de intentos fallidos del mensaje (Maximum failed
deliveries per message), para que tenga un valor igual a 1 (el Servidor de Aplicaciones hara un
reintento para las Actividades Asncronas a nivel de colas, lo cual quiere decir que se respetara la
configuracin de reintentos de la Asncrona en Bizagi).
221
D clic en OK. Recuerde dar clic en Guardar (Save) para aplicar los cambios igualmente.
Fbrica de conexiones JMS
Ahora crearemos una Fbrica de conexiones para JMS.
Navegue a la seccin de Recursos (Resources) y expanda el item JMS. D clic sobre Queue Connection
factories.
222
Server=server1) y de clic en Nuevo (New) para crear una fbrica de conexin de colas (Queue
Connection factory).
Para el nuevo recurso, mantenga el Proveedor de mensajera por defecto: Default messaging
provider, y d clic en OK.
223
Esto nos lleva a definir las propiedades principales de la nueva fbrica de conexiones.
Ingrese AsyncControllerFactory tanto para el Nombre (Name) como para el Nombre JNDI (JNDI
Name).
Asegrese de seleccionar el bus creado para Bizagi (BizAgiBus).
D clic en OK.
D clic en la Fbrica creada recin AsyncControllerFactory (la cual aparecer listada en la tabla), para
editar el parmetro de timeout de la conexin.
224
D clic en las propiedades del Pool de conexiones (Connection pool properties) ubicado bajo la
Asigne el timeout de la conexin (Connection timeout) a 120 segundos y d clic en OK.
225
Recuerde guardar (dar clic en Save) para aplicar los cambios.

Recurso de colas
Ahora crearemos un recurso de colas. Para hacerlo, ubique el panel a la izquierda para seleccionar
rpidamente el enlace de colas (Queues), ubicado en la seccin de recursos (Resources) bajo el item
JMS.
Server=server1), y de esta manera los Proveedores JMS sern filtrados:
226
Ingrese la siguiente informacin para el recurso de colas :

Name (Nombre): AsyncController
JNDI Name (Nombre JNDI): jms/AsyncController
Bus name (Nombre del bus): seleccione el bus para Bizagi: BizAgiBus.
Queue name (Nombre de la cola): seleccione la cola creada anteriormente: BizAgiQueue.
227
228
Ahora crearemos otro recurso para la especificacin de las activaciones (Activation specification).
Para hacerlo, ubique el panel a la izquierda para seleccionar rpidamente el enlace Activation
specifications, ubicado en la seccin de recursos (Resources) bajo el item JMS.
Server=server1):
D clic en Nuevo (New) para crear la especificacin. Mantenga el Proveedor de mensajera por
229
defecto: default messaging provider y d clic en OK.

Name (Nombre): AsyncControllerActivationSpec
JNDI Name (Nombre JNDI) : eis/AsyncControllerActivationSpec
Destination type (tipo de destino): seleccione cola: Queue.
Destination JNDI Name (Nombre JNDI del destino): jms/AsyncController
Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus.
230

3.4 Timeout de las transacciones y usuario administrador por defecto
Para definir el timeout de las transacciones, incrementamos la cantidad empleada por defecto para
permitir transacciones de mayor duracin (p.e til en la sincronizacin de usuarios LDAP).
Para hacerlo, acceda a la Consola de administracin y vaya a la seccin de Servidores (Servers).
Expanda el item tipos de servidores (Server types) y d clic sobre el enlace WebSphere Application
Servers.
231
D clic sobre la instancia nombrada del servidor (server1).

Expanda el item de Servicios del contenedor (Container Services) bajo la seccin de Configuracin del
contenedor (Container settings), y d clic sobre Servicio de la transaccin (Transaction service).
Edite las propiedades: Tiempo de espera del ciclo de la transaccin total (Total transaction lifetime
timeout) y Tiempo de espera mximo de la transaccin (Maximum transaction timeout). Asigne 3600
segundos a ambas propiedades.
232

La configuracin del usuario administrador por defecto de Bizagi se realiza estrictamente para el
usuario llamado admon del dominio por defecto llamado domain.
Para la configuracin de este usuario, acceda la Consola de administracin y vaya a la seccin de
Usuarios y grupos (Users and groups), y d clic sobre el enlace de Administrar usuarios (Manage users).
233
D clic en el botn de crear (Create... ) para registrar el usuario administrador por defecto.
User ID (id de usuario): domain\admon
First name (nombre): Bizagi
Last name (apellido): Bizagi
Password (contrasea): Ingrese el password de su preferencia.
D clic sobre Crear (Create). WebSphere notificar que la operacin ha sido exitosa, y podr hacer clic
sobre Cerrar (Close).
En este punto su WebSphere deber ser reiniciado.
Qu sigue?
234
Despus de estos pasos, su instalacin de WebSphere est configurada para albergar Procesos Bizagi!
Puede ahora iniciar su servidor y hacer generar el Portal de Trabajo (un despliegue de aplicacin).
Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia WebSphere.
Configuracin de Weblogic
La configuracin de un servidor Weblogic hace parte de la configuracin para Configurar un Servidor
de Aplicaciones JEE, como un paso requerido al momento de generar el Portal de trabajo de Bizagi,
para que sus procesos se ejecuten sobre una plataforma JEE.
La configuracin de Weblogic vara de acuerdo a si la configuracin de la solucin tendr un esquema
de alta disponibilidad o no (si se involucra o no ms de una instancia de Weblogic en un clster).
Para una gua sobre cmo configurar Weblogic para trabajar con Bizagi en un esquema de alta
disponibilidad (para aplicaciones de misin crtica), consulte la Configuracin en clster de Weblogic.
Para una gua sobre cmo configurar Weblogic para trabajar con Bizagi como instancia standalone
(estndar setup), consulte Configuracin estndar de Weblogic.
Configuracin de Weblogic para soporte a clster
Introduccin
Esta seccin se enfoca en la configuracin de Weblogic para trabajar con Bizagi, en un esquema de
alta disponibilidad, donde se hace uso de un clster para contar el balanceo de cargas en la
aplicacin.
235
Si desea configurar Weblogic a modo standalone (solamente empleando un servidor BPM; sin
esquema de balanceo de cargas), consulte la Configuracin estndar de Weblogic.
Lo que debe hacerse

1. Seguir los requisitos para usar Weblogic.
Estas directrices y pasos se indican en la Preconfiguracin de Weblogic para soporte a clster, e
incluyen la defincin de un dominio y el registro del clster y de sus nodos.
2. Configurar Weblogic en clster para trabajar en Bizagi.
Estos pasos se describen en la Configuracin en clster de Weblogic.
Estos pasos se describen en la Configuracin del Scheduler en Weblogic.
Esta seccin describe los pasos y directrices a seguir para la configuracin de clsters en Weblogic.
Esto es un prerrequisito para llevar a cabo la configuracin de Weblogic para trabajar con Bizagi en
clster.
Para ms informacin sobre los pasos que se llevan a cabo, consulte Configurar Weblogic en clster.
236
Objetivos
La configuracin de un clster de Weblogic para la alta disponibilidad, involucra ciertos pasos de
preconfiguracin (se llevan a cabo antes de la configuracin orientada a los procesos de Bizagi), de
manera que se tenga una administracin centralizada de los nodos del clster.
Dentro de esta administracin centralizada, se consideran las siguientes capacidades:
1. Cada nodo estar disponible para ser asignado con requests, e igualmente procesarlos.
2. Cada nodo reportar cambios para que estos sean propagados a los dems nodos.
3. Si por algn motivo, el nodo no tiene disponibilidad de servicio, los requests sern manejados y
distribuidos apropiadamente entre los dems nodos.
Prerrequisitos
Para configurar su instancia de Weblogic en un ambiente de pruebas o produccin, se requiere:
6, update 45.
sin espacios).
Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWeblogic-dist.zip).
Tener instalado el Servidor Weblogic en los nodos que harn parte del clster.
Las versiones soportadas son las pertenecientes a Weblogic 11g: 10.3.6.0.
Weblogic puede descargarse o solicitarse directamente desde la pgina oficial de Oracle.
Tenga presente que debe tener el instalador apropiado a su sistema (p.e wls[version]_linux32.bin,
wls[version]_win32.exe), y que para su instalacin debe seguir tanto los requisitos de Weblogic, como
los lineamientos presentados en la siguiente seccin (p.e la creacin de un dominio y el registro del
clster y los servidores involucrados).
Los nodos con instancias de Weblogic pueden estar en un mismo servidor o en diferentes
servidores.
Bizagi soporta el uso de Weblogic en clster tanto horizontal como vertical.
Se recomienda la configuracin de clster horizontal, de manera que se tenga un servidor dedicado
para cada nodo de Weblogic.
Requerimientos de Weblogic
Para instalar Weblogic (una vez que haya cubierto todos los prerrequisitos), asegrese de considerar
lo siguiente:
237
Instalar todos los componentes del Servidor Weblogic.
Seleccionar un JDK pre-instalado (Java home). No se debe instalar el java embebido en el instalador,
dado que se debe tener controlado que sea un JDK de versin soportada por Bizagi.
238
Instalar el servicio de Windows (cuando aplica para el sistema operativo utilizado).

Esta ruta de instalacin ser referenciada como <WEBLOGIC_HOME> a partir de este momento.
Para una gua completa sobre la instalacin de Weblogic, consulte la documentacin oficial de Oracle.
Tenga presente que deber realizar la instalacin para cada servidor que vaya a contener un Nodo de
Weblogic.
Configuracin del clster

Una vez que se haya instalado Weblogic en cada servidor que tendr un nodo, deber tener un
dominio de usuario creado para Bizagi y registrar el clster y sus nodos.
Para ello, puede utilizar las opciones del Inicio rpido (Run Quickstart) para que Weblogic asista dicha
configuracin.
Este paso solo se requiere una vez (a diferencia de instalar Weblogic para cada nodo).
Dentro de estas opciones asistidas, ubique la opcin de Empezar a utilizar Weblogic (Getting started
with Weblogic Server ) y seleccione la opcin de Crear un nuevo dominio (Create a new Weblogic
domain).
239
Puede optar por usar la opcin de Generar el dominio configurado automticamente (Generate a
domain configured automatically).
Tenga presente que en la configuracin de dominio deber ingresar un usuario y contrasea que
deber recordar para el acceso a la consola administrativa.
En las opciones de configuracin, para configurar automticamente las opciones de clster se debe
seleccionar: Servidor de administracin (Administration Server) y Servidores gestionados, clsters y
mquinas (Managed Servers, clusters and machines).
En la configuracin del Administration server, ingrese lo siguiente:
Name (Nombre): AdminServer
Listen address (Direccin de recepcin): La direccin IP del servidor.
Listen port (Puerto de recepcin): Puerto utilizado por el servidor de administracin. Por defecto es
el 7001.
En las opciones para configurar los servidores administrados, asegrese de registrar el detalle de los
nodos de Weblogic que harn parte del clster. Para ello, ingrese un registro para cada nodo con la
siguiente informacin:
Name (Nombre): El nombre del nodo de Weblogic.
Listen address (Direccin de recepcin): La direccin IP del nodo.
Listen port (Puerto de recepcin): Puerto utilizado por el nodo.
Ntese que en caso de utilizar SSL, deber activar la casilla de SSL y especificar el puerto de recepcin
240
SSL.
En la opcin para configurar el clster, registre el clster ingresando los siguientes detalles:
Name (Nombre): El nombre del clster.
Message mode (Modo de mensajes de clster): Seleccione Unicast.
Cluster address (Direccin del clster): Las direcciones IP de los nodos (asociadas al clster). Estas se
deben ingresar separadas por comas de la siguiente manera: [IP_Nodo1], [IP_Nodo2],[IP_NodoN].
En la configuracin siguiente, asegrese de asignar los nodos al clster de manera explcita
(incluyndolos en el listado del clster.
En las opciones de configuracin de mquinas, asegrese de ingresar las mquinas donde los nodos
del clster se encuentran. La direccin IP de ellas deber corresponder a lo definido previamente para
los nodos.
Adicionalmente, puede especificar el puerto bajo el cul se realizar la sincronizacin del clster.
Tenga en cuenta que la configuracin deber hacerse en la pestaa correspondiente al tipo de sistema
operativo (Windows o Unix).
Finalmente, en las opciones para asociar las instancias de los servidores a las mquinas, asegrese de
incluir la totalidad de las instancias a las mquinas a las cuales pertenecen, e igualmente definir la
ubicacin del AdminServer que se encarga de la administracin del clster sea vertical u horizontal.
Para mayor informacin acerca de estos temas de instalacin y primeros pasos consulte la
documentacin oficial de Weblogic.
Una vez haya finalizado con la creacin del dominio para un ambiente en clster, podr revisar que la
configuracin sea exitosa, iniciando el servicio de su dominio.
Sincronizacin de cambios en el clster

Una vez se realice la configuracin del clster, o cada vez que se realicen cambios en l (por ejemplo,
se adicione un nuevo nodo), se debe sincronizar la configuracin central hacia los nodos.
Para realizar una sincronizacin de cambios, se replican manualmente los cambios a travs de una
plantilla que se ejecuta en cada nodo.
Para hacerlo, lleve a cabo lo siguiente:
1. Abra una consola de comandos y ubquese en el directorio common\bin de la ruta de instalacin
de Weblogic: <WEBLOGIC_HOME>\wlserver_10.3\common\bin\.
Debe ser en la mquina donde se realizaron los cambios.
2. Desde esa ubicacin ejecute el siguiente comando.
Para Linux OS:
pack.sh
-managed=true
-domain=<WEBLOGIC_HOME>/user_projects/domains/
[CLUSTER_DOMAIN] -template=template.jar -template_name="[CLUSTER_DOMAIN]"
Para Windows:
pack.cmd
-managed=true
-domain=<WEBLOGIC_HOME>\user_projects\domains
\[CLUSTER_DOMAIN] -template=template.jar -template_name="[CLUSTER_DOMAIN]"
241
Esto exporta una plantilla .jar con el nombre del dominio del clster para la replicacin de la
configuracin.
Por defecto, esta plantilla queda en la misma ruta <WEBLOGIC_HOME>\wlserver_10.3\common\bin\.
3. Copie esta plantilla [CLUSTER_DOMAIN].jar hacia las mquinas donde hay nodos del clster que no
han sido sincronizados.
Ntese que este paso deber repetirse segn la cantidad de nodos, para que la totalidad de ellos
tomen los cambios.
Ubquela en una ruta sin espacios (puede ser en la ruta home de instalacin de Weblogic <WEBLOGIC_HOME>).
4. Abra una consola de comandos y ubquese en el directorio common\bin de la ruta de instalacin
de Weblogic: <WEBLOGIC_HOME>\wlserver_10.3\common\bin\.
Recuerde que debe ser en la mquina donde no se han replicados los cambios.
5. Desde esa ubicacin ejecute el siguiente comando.
Para Linux OS:
unpack.sh
-template=<WEBLOGIC_HOME>/[CLUSTER_DOMAIN].jar
domain=<WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]
Para Windows:
unpack.cmd
-template=<WEBLOGIC_HOME>\[CLUSTER_DOMAIN].jar
domain=<WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN]
6. Seguidamente, revise el archivo de propiedades de configuracin ubicado como

<WEBLOGIC_HOME>\wlserver_10.3\common\nodemanager\nodemanager.properties.
En l, asegrese de tener:
StartScriptName: Asignado al ejecutable startWebLogic.
Tenga presente el sistema operativo; en caso de ejecutarse sobre Windows ser:
StartScriptName=startWebLogic.cmd
Para Linux OS ser: StartScriptName=startWebLogic.sh
StartScriptEnabled: Asignado con verdadero.
Deber quedar: StartScriptEnabled=true
Guarde los cambios y cierre el archivo de propiedades.
7. Para verificar que se haya sincronizado la configuracin, primero ejecute el manejador de cada
nodo, a travs de una consola de comandos (el uso del NodeManager se instancia con el siguiente
comando):
Para Linux OS:
<WEBLOGIC_HOME>/wlserver_10.3/server/bin/startNodeManager.sh
Para Windows:
<WEBLOGIC_HOME>\wlserver_10.3\server\bin\startNodeManager.cmd
La ejecucin deber mostrar que el manejador inicia bajo el puerto 5556:
242
8. Una vez el manejador de cada nodo est operando, inicie el servicio de Weblogic desde el
comando startWebLogic
Para ello, ejectelo desde una consola segn el sistema operativo.
Para Linux:
<WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]/bin/startWebLogic.sh
Para Windows:
<WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN]\bin
\startWebLogic.cmd
De esta manera, podr acceder a la Consola de administracin de Weblogic con la siguiente direccin
URL en un navegador y validar que sus nodos hagan parte del clster:
http://localhost:7001/console/login/LoginForm.jsp
243
En la seccin de Entorno (Environment), podr ubicar la opcin Servers y verificar los nodos del
clster (p.e iniciarlos a travs de la pestaa de Control):
Ntese que la columna State mostrar si cada nodo se encuentra en ejecucin (RUNNING) o no
(SHUTDOWN).
Una vez que complete estos pasos y la verificacin, puede detener los nodos (desde las opciones de
Shutdown) y el servicio de Weblogic (a travs de stopWebLogic como se describe en las Opciones de
Weblogic).
Para continuar con la configuracin como tal de Weblogic y Bizagi consulte la Configuracin de
Weblogic en clster para trabajar con Bizagi.
Escalabilidad
Si usted ya tiene configurado su clster de Weblogic y se encuentra ejecutndose con un nmero dado
de nodos, entonces en cualquier momento podr adicionar nuevos nodos a su clster, como medida
de escalabilidad.
Para hacerlo, asegrese de:
1. Registrar el nuevo nodo en el clster.
2. Sincronizar los cambios al nuevo nodo.
3. Realizar la configuracin de Weblogic para trabajar con Bizagi.
Esto significa configurar para el nuevo nodo, las libreras y pasos necesarios para el servicio en
Weblogic.
Ntese que Bizagi recomienda el escalamiento horizontal.
4. Revise la configuracin del balanceador de cargas para que considere el nuevo nodo.
244
Opciones de Weblogic
Para iniciar, detener o acceder a la Consola de administracin de Weblogic, consulte la informacin a
continuacin.
Ntese que en este ejemplo nuestro dominio se llama bizagi_domain.
Iniciar el servidor (dominio)

Para iniciar Weblogic, execute the following file in a command prompt:
En Linux:
<WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]/bin/startWebLogic.sh
En Windows:
<WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN]\bin
\startWebLogic.cmd
En Windows, tambin se puede optar por usar las opciones del men (Oracle Weblogic > User
Projects > [cluster_domain] > Start Admin Server).
245
Asegrese de especifica el usuario y contrasea (tal como fue especificado cuando se cre el dominio
de Weblogic).
Detener el servidor (dominio)

Para detener Weblogic, ejecute el siguiente archivo en una consola de smbolo del sistema:
En Linux:
<WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]/bin/stopWebLogic.sh
En Windows:
<WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN]\bin\stopWebLogic.cmd
Projects > [cluster_domain] > Start Admin Server).
246

Para acceder a la Consola de administracin de Weblogic, ingrese la siguiente direccin URL en un
navegador:
Recuerde que igualmente requerida ingresar el usuario y contrasea autorizado del dominio.
247
Para la configuracin de Weblogic para trabajar con Bizagi en un esquema de clster (ms de un nodo
en la capa BPM), se debe contar con ciertas configuraciones previas del lado de Weblogic.
Por lo tanto, antes de continuar, asegrese de haber seguido las instrucciones descritas en
Preconfigurar Weblogic para soporte a clster.
Para ms informacin sobre el procedimiento completo, consulte Configurar Weblogic en clster.
Esta seccin indica qu configuraciones debe realizar para que su clster en Weblogic trabaje con el
proyecto de Bizagi.
Una vez que haya cumplido con lo descrito anteriormente, se realiza lo siguiente:
1. Extraer los archivos usados por Bizagi hacia Weblogic.
3. Configurar los siguientes mdulos en Weblogic:
Autenticacin
Acceso a datos
Libreras compartidas (JSTL, JSF)
Estos mdulos se configuran en Weblogic utilizando su Consola de administracin, y utilizan a su vez
Despus de estos pasos, su instancia de Weblogic estar configurado para que los Procesos de Bizagi
se desplieguen en una aplicacin JEE (el Portal de Trabajo).
Procedimiento
de Weblogic por defecto.
248
1. Extraer los archivos usados por Bizagi hacia Weblogic

En este paso, se incluyen archivos usados por Bizagi en la instancia de Weblogic (son archivos que no
vienen por defecto en la instalacin limpia).
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-Weblogic-dist.zip).
Este paso que contempla configurar los archivos utilizados por Bizagi, deber hacerlo para cada nodo
que haga parte del clster.
1.2 Copie las libreras del mdulo de Autenticacin (bizagi-security-provider-[version].jar, bizagiremote-[version].jar, bizagi-security-common-[version].jar) de los archivos de configuracin, desde
esta ruta:
Hacia la ruta de libreras de Weblogic en:
<WEBLOGIC_HOME>\wlserver_10.3\server\lib\mbeantypes\
1.3 Copie los driveres para el acceso a datos, segn el motor de Base de datos (los drivers
entregados en los archivos de configuracin), desde esta ruta:
Hacia la ruta de libreras de Weblogic como se describe a continuacin.
Si utiliza Weblogic 10.3.6.0, la ruta de destino es:
<WEBLOGIC_HOME>\wlserver_10.3\server\lib\
Si su proyecto utiliza Oracle, entonces no requiere copiar el driver (ya que el ojdbc6 est incluido
por defecto en Weblogic). Lo que si debe hacer, es editar el archivo web.config.xml ubicado en
<PATH_CONFIGURATION_FILES>\JiNET\config\ de manera que la llave PROVIDERTYPE est
asignada al uso de Oracle:
249
Si su proyecto utiliza Microsoft SQL Server, copie el driver sqljdbc-4.0.jar.

1.4 Copie la librera utilizada para el registro de logs, que se llama log4j-[version].jar (tambin
entregada en los archivos de configuracin).
Copie la librera de esta ruta:
<WEBLOGIC_HOME>\user_projects\domains\[your_domain]\lib\
1.5 Copie las libreras compartidas, principalmente: jsf-myfaces-1.2.8.war y eclipselink-[version].jar (que
se entrega en los archivos de configuracin).
Copiela de esta ruta:
<WEBLOGIC_HOME>\wlserver_10.3\common\deployable-libraries\

primero asegrese de que sus instancias de Weblogic no estn iniciadas (deben estar detenidas).
Este paso que contempla configurar las variables utilizadas por Bizagi, deber hacerlo para cada nodo
que haga parte del clster.
Seguidamente, edite el archivo de inicio del servicio de Weblogic para asignar las variables necesarias.
En Linux:
Ubique la siguiente lnea en el archivo <WEBLOGIC_HOME>/user_projects/domains/[USER_DOMAIN]/
bin/startWebLogic.sh:
JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"
Adicione lo siguiente al final de la lnea, asegurndose que todo el contenido quede en una misma
lnea:
-DiNET_HOME=<PATH_CONFIGURATION_FILES>/JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC Dbizagi.cache.multicast.enabled=true Dbizagi.cache.multicast.address=224.2.2.3 Dbizagi.cache.multicast.port=7777 -Dbizagi.cache.multicast.type=UDP
Considere que debe asignar el valor correspondiente a la ruta <PATH_CONFIGURATION_FILES>, y
que debe utilizar "/" como el caracter de separacin de ruta.
250
Adicional a lo anterior, incremente la memoria utilizada en los parmetros por defecto para un mejor
desempeo y tiempo de despliegue.
Para ello, ubique la siguiente lnea en el mismo archivo: USER_MEM_ARGS=
Asigne los siguientes valores:
USER_MEM_ARGS="-Xms768m -Xmx2048m -XX:PermSize=768m -XX:MaxPermSize=2048m"
Guarde los cambios y reinicie su Servidor Weblogic.
Si est utilizando Weblogic 10.3.6.0 y una Base de datos SQL Server, deber entonces hacer una
modificacin adicional a los parmetros de ambiente compartidos, de maneera que se incluya el
driver sqljdbc-4.0.jar en el CLASSPATH de Weblogic.
Para hacerlo, edite el archivo <WEBLOGIC_HOME>/wlserver_10.3/common/bin/
commEnv.sh y ubique la lnea que contiene WEBLOGIC_CLASSPATH="${JAVA_HOME} . Adicione:
${WL_HOME}/server/lib/sqljdbc-4.0.jar como una dependencia en el archivo (usando el caracter
apropiado de separacin cuando se definen mltiples parmetros).
En Windows:
Ubique la siguiente lnea en el archivo <WEBLOGIC_HOME>\user_projects\domains\[USER_DOMAIN]
\bin\startWebLogic.cmd:
set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%
Adicione lo siguiente al final de la lnea, asegurndose que todo el contenido quede en una misma
251
lnea:
-DiNET_HOME=<PATH_CONFIGURATION_FILES>\JiNET -Duser.language=en Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC Dbizagi.cache.multicast.enabled=true Dbizagi.cache.multicast.address=224.2.2.3 Dbizagi.cache.multicast.port=7777 -Dbizagi.cache.multicast.type=UDP
Para ello, ubique la siguiente lnea en el mismo archivo: set USER_MEM_ARGS=
set
USER_MEM_ARGS=-Xms768m
XX:MaxPermSize=2048m
-Xmx2048m
-XX:PermSize=768m
Para hacerlo, edite
el
archivo
<WEBLOGIC_HOME>\wlserver_10.3\common\bin
\commEnv.cmd y ubique la lnea que contiene WEBLOGIC_CLASSPATH=%JAVA_HOME% .
Adicione: %WL_HOME%\server\lib\sqljdbc-4.0.jar como una dependencia en el archivo (usando el
caracter apropiado de separacin cuando se definen mltiples parmetros).
252
3. Configurar los mdulos de Weblogic

Se deben configurar algunos mdulos en Weblogic a travs de la Consola de administracin, como se
indica a continuacin.
Ntese que para editar esta configuracin, puede requerir primero utilizar el botn de Desbloqueo
y edicin (Lock & Edit button) ubicado en la esquina superior izquierda.
Al final de los pasos, igualmente asegrese de aplicar los cambios y liberar el bloqueo (haciendo clic
en Activate changes y al finalizar, clic en Release configuration).
Despus de realizar cambios, Weblogic puede indicar que se requiere de un reinicio del servicio.
3.1 Autenticacin
Acceda la Consola de administracin, y vaya a la seccin SecurityRealms y seleccione el tem del
mbito de dominio (myrealm).
253
Seleccione la pestaa de Proveedores Providers y luego la pestaa de Autenticacin (Authentication).

Cree un nuevo tem dando clic sobre el botn Nuevo (New).
Ingrese BizagiAuthenticator como el Nombre (Name) del Proveedor

BizagiAuthenticator como el tipo (Type) de Proveedor de Autenticacin.
seleccione
254
D clic en OK. De vuelta en la lista de Proveedores de Autenticacin, asegrese de seleccionar

BizAgiAuthenticator para que sea el primer item.
Esto se requiere dado que el nuevo Proveedor opera en un contexto compartido.
Use la opcin de reordenar (botn Reorder) para mover BizAgiAuthenticator hasta la cima de la lista.
255
D clic en OK. BizAgiAuthenticator debe aparecer de primero, y d clic sobre l.

Cambie la configuracin de control (Control Flag) a el valor: SUFFICIENT (seleccinelo del combo de
opciones y d clic en Guardar --Save--).
256
Finalmente, active los cambios.

3.2 Acceso de datos
Antes de continuar con esta configuracin, tenga presente que al utilizar una Base de datos SQL Server,
se requiere que el servicio de la instancia no se inicie bajo un puerto dinmico.
Se requiere que el puerto TCP/IP del servicio est predefinido explcitamente (p.e el 1433 por defecto).
Para la siguiente configuracin, acceda la Consola de administracin y tenga en cuenta que la

configuracin vara ligeramente de acuerd al motor de Base de datos de su proyecto (Oracle o SQL
Server).
Vaya a la seccin de Servicios (Services) y d clic sobre fuentes de datos (Data Sources).
257

Primero ingrese BizAgiJava tanto para el Nombre (Name) como para el Nombre JNDI (JNDI Name).
258
Para Oracle
Seleccione Oracle como el tipo de Base de datos (Database type). D clic en Siguiente (Next) y
seleccione el driver Oracles Driver (Thin) for instance connections; Versions:
9.0.1 and later (Database Driver).
259

Para SQL Server
Seleccione MS SQL Server como el tipo de Base de dato (Database type). D clic en Siguiente (Next)
y seleccione el driver Microsoft's MS SQL Server Driver (Type 4) Versions:2005 and
later (Database Driver).
260

En las opciones de transaccin (Transaction Options), tanto para Oracle como para SQL Server,
asegrese de desmarcar la casilla de Supports Global Transactions.
D clic en Siguiente (Next) y especifique el detalle de conexin a su Base de datos. D clic nuevamente
en Siguiente (Next).
Verifique la conexin a su Base de datos, utilizando la opcin de Probar (Test Configuration). Ntese
que tambin puede revisar la URL de la cadena de conexin.Una vez que esta verificacin sea exitosa,
d clic en Siguiente (Next).
261
Revise que esta fuente de datos sea aplicada en su configuracin de clster.

Para ello, asegrese de marcar la casilla del clster e incluir All servers in the cluster para la
configuracin del destino (Select Target) y d clic en Finalizar (Finish):
Finalmente, asegrese de aplicar los cambios.
262

En los siguientes pasos vamos a configurar un Servidor JMS que se utiliza por Bizagi para las
Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios (Services). D clic
sobre el enlace de Mensajera (Messaging).
Servidor JMS
Para la configuracin en clster, se debe crear un Servidor JMS con su respectivo File Store, para cada
nodo de Weblogic que haga parte del clster.
Para crear un Servidor JMS, d clic en Servidores JMS (JMS Servers) y sobre Nuevo (New).
A travs de las opciones del nuevo Servidor JMS, cree un nuevo almacn de persistencia dando clic
sobre Create a New Store .
263
Para el tipo de almacn, seleccione File Store. D clic en Siguiente (Next).
En sus propiedades, ingrese el nombre (Name): FileStore-BizAgi.

Seleccione la instancia de Weblogic (para el primero que cree, escoja AdminServer como destino -Target--), y especifique un directorio vlido para persistir la informacin.
Haga clic en Ok.
264
Regrese a la informacin del nuevo Servidor JMS (habiendo creado ya el almacn de persistencia tipo
archivo), ingrese: JMSServer-BizAgi para el Nombre (Name) y seleccione el almacn creado de las
opciones del combo.
265
Finalmente, seleccione la instancia del servidor destino (Target) .

Para el primero, seleccione AdminServer.
D clic en Finalizar (Finish).
Tenga en cuenta que debe repetir este paso de creacin de Servidor JMS para cada nodo de su
clster (y cada Servidor JMS con su respectivo File Store). Es decir, en el ltimo paso deber asignar la
instancia del servidor destino (bajo Target).
Recuerde que los nombres de los Servidores JMS y los File Stores deben ser nicos (puede utilizar un
266
nombrado: JMSServer-Bizagi2, JMSServer-BizagiN).

Al finalizar, ver el listado de los mltiples Servidores JMS con sus Stores, incluyendo el que se registra
para la instancia AdminServer:
En esta lista de Servidores JMS, d clic cada uno de los creados anteriormente (p.e JMSServer-BizAgi)
para editar su propiedad Expiration Scan Interval.
Asgnele el valor de 120 segundos.
D clic en Guardar (Save).

Asegrese de asignar este valor para cada uno de los Servidores JMS creados anteriormente.
Recuerde activar los cambios una vez haya finalizado con todos los Servidores JMS.
Mdulo JMS
Navegue a la seccin de Servicios (Services) y expanda la opcin de Mensajera (Messaging). .
267
D clic sobre JMS Modules y en Nuevo (New) para registrar un mdulo JMS.
Ingrese: SystemModule-BizAgi en el nombre (Name).

No se requiere informacin adicional; d clic en Siguiente (Next).
Asegrese de marcar la casilla del clster (en Select Target) e incluir All servers in the
cluster para aplicar a la configuracin a todos los nodos.
268
Recursos adicionales
En la lista de mdulos JMS, d clic sobre el recin creado SystemModule-BizAgi para editar sus
propiedades,
Dentro de las mismas opciones, vamos a crear 4 nuevos recursos (Connection Factory para colas,
Distributed Queue, Connection Factory para tpicos, Distributed Topic).
Para crear y asociar un recurso, d clic sobre Nuevo (New) desde la tabla de resumen de recursos
(Summary of Resources).
Para el primer recurso, seleccione Connection Factory como el tipo (Type).
269
D clic en Siguiente (Next) e ingrese: AsyncControllerFactory tanto en el Nombre (Name), como

en el Nombre JNDI (JNDI Name).
270
Asegrese de marcar la casilla que activa el uso de XA Connection Factory Enabled y d clic en
Finalizar (Finish).
Para el segundo recurso que se crea, seleccione Distributed Queue como el tipo (Type).
271
D clic en Siguiente (Next) e ingrese: AsyncController en el Nombre (Name).

Ingrese jms/AsyncController en el Nombre JNDI (JNDI Name) y d clic en Siguiente (Next).
D clic en Siguiente (Next) y en Finalizar (Finish). Este recurso debe quedar asociado de manera
distribuida al clster.
Para el tercer recurso, seleccione Connection Factory como el tipo (Type).
272
D clic en Siguiente (Next) e ingrese: EclipseLinkTopicConnectionFactory en el Nombre

(Name).
Ingrese jms/EclipseLinkTopicConnectionFactory en el Nombre JNDI (JNDI Name) y d clic
Asegrese de marcar la casilla que activa el uso de XA Connection Factory Enabled y d clic en
Finalizar (Finish).
273
Para el cuarto recurso, seleccione Distributed Topic como el tipo (Type).
D clic en Siguiente (Next) e ingrese: EclipseLinkTopic en el Nombre (Name).

Ingrese jms/EclipseLinkTopic en el Nombre JNDI (JNDI Name) y d clic en Siguiente (Next).
274
D clic en Siguiente (Next) y en Finalizar (Finish). Este recurso debe quedar asociado de manera
distribuida al clster.
Al finalizar, los 4 nuevos recursos quedarn listados y aplicarn al clster:
En la lista de los recursos, d clic sobre la cola distribuida creada como AsyncController (la cola
distribuida) para editar sus propiedades,
D clic en la pestaa de manejo de fallas en la entrega (Delivery Failure) para configurar el manejo de
reintentos cuando algn mensaje no pueda ser entregado.
Especifique 1 como el lmite de reintentos (Redelivery Limit) y d clic en Guardar (Save).
De esta manera, el Servidor de Aplicaciones hara un reintento para las Actividades Asncronas a nivel
de colas (lo cual quiere decir que se respetara la configuracin de reintentos de la Asncrona en
Bizagi).
275
Finalmente, recuerde activar los cambios.
3.4 Libreras compartidas

Acceda la Consola de administracin y vaya a la seccin de despliegues (Deployments).
Instale 4 libreras compartidas (jstl-1.2.war, jsf-1.2.war, jsf-myfaces-1.2.8.war y eclipselink-2.5.0.jar) como
Para la primera, d clic en Instalar (Install) y navegue hacia la ruta donde se encuentran estas librerias
desplegables. La ruta es la correspondiente a
<WEBLOGIC_HOME>\wlserver_10.3\common
276
\deployable-libraries\.
Marque la librera jsf-1.2.war .

Seleccione la opcin de Instalarla como una librera (Install this deployment as library).

Asegrese de marcar la casilla del clster (en Select Target) e incluir All servers in the
cluster para aplicar a la configuracin a todos los nodos.
277

Para la segunda, repita los pasos de Instalacin (la opcin Install) pero esta vez marque la librera jsfmyfaces-1.2.8.war (ubicada en la misma ruta:
\deployable-libraries\).
Para la tercera, repita los pasos de Instalacin (la opcin Install) pero esta vez marque la librera jstl1.2.war (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3\common\deployablelibraries\).
278
Para la cuarta, repita los pasos de Instalacin (la opcin Install) pero esta vez marque la librera
eclipselink-2.5.0.jar (ubicada en la misma ruta:
279
Una vez haya instalado estas 4 libreras desplegables, se listarn inmediatamente:
Recuerde activar los cambios.
3.5 Parmetros de transaccin (JTA) y usuario administrador por defecto

Para la configuracin de parmetros de transaccin (Java Transaction API) slo necesitamos aumentar
el tiempo lmite asignado por defecto de la transaccin (timeout).
Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios (Services).
280
Seleccione JTA y edite la propiedad Timeout seconds para asignarle 120 segundos.
D clic en Guardar (Save) y active los cambios.

En este punto, debe reiniciar su servicio de Weblogic.
Para configurar el usuario administrador por defecto de Bizagi, es necesario crear el usuario admon
del dominio domain.
Para ello, acceda la Consola de administracin y vaya a la seccin Security realms y d clic en el
Ubique la pestaa de Usuarios y grupos (Users and Groups), y cree el nuevo usuario dando clic sobre
Nuevo (New).
281
Ingrese la siguiente informacin para el usuario administrador

Name: Si utiliza Weblogic 10.3.6.0, el nombre del usuario deber ser: admon.
Description: Bizagi administrator user
Provider: DefaultAuthenticator
Password: bizagi$91
282
D clic en OK.
Una vez que complete estos pasos, consulte la Configuracin de el Scheduler en Weblogic.
Introduccin
esquema de:
solucin).
Prerrequisitos
Para configurar del servicio de Scheduler de Weblogic asegrese de cumplir con los siguientes
283
prerrequisitos:
Se debe haber configurado la solucin de Bizagi en Weblogic.
Para ms informacin sobre ello, consulte Configuracin en clster de Weblogic.
Tenga a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWeblogic-dist.zip). Estos archivos deben haber sido descomprimidos en los pasos de configuracin
de Weblogic y ubicados en una ruta que ser referenciada como <PATH_CONFIGURATION_FILES>
en esta seccin.
Configuracin
2. Copie las libreras cliente para EJB en la ruta <PATH_CONFIGURATION_FILES>/

BizagiSchedulerService/lib/ext/
Estas se encuentran en la ruta de instalacin del servidor de aplicaciones:
<WEBLOGIC_HOME>/server/lib/wlclient.jar
3. Configure el archivo de propiedades custom_jndi.properties:

java.naming.factory.initial: Propiedad de uso exclusivo de Bizagi que define el contexto del
componente cliente que ser utilizado para establecer comunicacin con el servidor de aplicaciones
WebSphere. El valor asignado a esta propiedad es:
weblogic.jndi.WLInitialContextFactory
java.naming.security.principal: Esta propiedad por defecto se encuentra deshabilitada (#). Si en el
servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer comunicacin
con componentes externos, se bebe especificar el nombre de usuario creado.
java.naming.security.credentials: Esta propiedad por defecto se encuentra deshabilitada (#). Si en
el servidor de aplicaciones se configur seguridad a nivel de aplicacin para establecer
comunicacin con componentes externos, se bebe especificar el password de usuario creado.
aplicaciones Weblogic.
o Valor utilizado en la configuracin, tanto para un solo servidor o en un ambiente distribuido:
BizAgiSchedulerBean#com.vision.bizagi.scheduler.BizAgiSchedulerRemote
284
java.naming.provider.url: Propiedad configurable en la cual se especifica el nombre o

direccin IP del servidor de aplicaciones. El valor asignado debe cumplir con el siguiente formato: Se
define la lista de servidores que hacen parte del clster con su respectivo puerto, todos separados
por
coma
(,):
t3://[SERVER_NAME1]:[PORT1],:[SERVER_NAME2]:[PORT2],:
[SERVER_NAME3]:[PORT3]
Debe ser remplazado [SERVER_NAME1] por el nombre del servidor o direccin IP donde se
encuentra una instancia, sea Stand-Alone o Cluster. Igualmente, para [PORT1] por el nmero de
puerto de recepcin de peticiones de la instancia del servidor.

de
entorno:
bizagi.cache.multicast.enabled,
bizagi.cache.multicast.address,
configuracin de variables de entorno para configurar Weblogic para trabajar en clster).

administrador.
Configuracin estndar de Weblogic
Introduccin
285
Esta seccin se enfoca en la configuracin de Weblogic para trabajar con Bizagi, dirigida a un
ambiente de pruebas o de produccin, y en un montaje standalone (sin balanceo de cargas).
Si desea configurar Weblogic en un esquema de alta disponibilidad y con la posibilidad de balanceo

de cargas, consulte la Configuracin en clster de Weblogic.
Tenga en cuenta que lo recomendado es utilizar la instancia por defecto de JBoss en desarrollo, dado
que se promueve la agilidad en la implementacin (JBoss es un Servidor ms ligero e inicia o reinicia
ms rpido, y para su proyecto no requiere de configuracin adicional).
Sin embargo, si su proyecto requiere estrictamente que se utilice Weblogic en el ambiente de
desarrollo, siga los pasos a continuacin para ese ambiente tambin.
Prerrequisitos
Para configurar su instancia de Weblogic en un ambiente de pruebas o produccin, se requiere:
sin espacios).
Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWeblogic-dist.zip).
Tener instalado el Servidor Weblogic. Las versiones soportadas son las pertenecientes a Weblogic
11g 10.3.6.0.
Weblogic puede descargarse directamente desde la pgina oficial de Oracle.
Tenga presente que debe tener el instalador apropiado a su sistema (p.e wls[version]_linux32.bin,
286
wls[version]_win32.exe), y que para su instalacin debe seguir tanto los requisitos de Weblogic, como
los lineamientos presentados en la siguiente seccin (p.e la creacin de un dominio).
Requerimientos de Weblogic
Para instalar Weblogic (una vez que haya cubierto todos los prerrequisitos), asegrese de considerar
lo siguiente:
Instalar todos los componentes del Servidor Weblogic.
Seleccionar un JDK pre-instalado (Java home). No se debe instalar el java embebido en el instalador,
dado que se debe tener controlado que sea un JDK de versin soportada por Bizagi.
287
Instalar el servicio de Windows (cuando aplica para el sistema operativo utilizado).

Esta ruta de instalacin ser referenciada como <WEBLOGIC_HOME> a partir de este momento.
Para una gua completa sobre la instalacin de Weblogic, consulte la documentacin oficial de Oracle.
Crear un dominio de usuario
Una vez que se haya instalado Weblogic debe tener un dominio de usuario creado para Bizagi.
Para ello, puede utilizar las opciones del Inicio rpido (Run Quickstart) para que Weblogic asista dicha
configuracin.
Dentro de estas opciones asistidas, ubique la opcin de Empezar a utilizar Weblogic (Getting started
with Weblogic Server ) y seleccione la opcin de Crear un nuevo dominio (Create a new Weblogic
domain).
288
Puede optar por usar la opcin de Generar el dominio configurado automticamente (Generate a
domain configured automatically).
Tenga presente que en la configuracin de dominio deber ingresar un usuario y contrasea que
deber recordar para el acceso a la consola administrativa.
Para mayor informacin acerca de estos temas de instalacin y primeros pasos consulte la
documentacin oficial de Weblogic.
Ntese que en este ejemplo nuestro dominio se llama bizagi_domain.
Opciones de Weblogic
Para iniciar, detener o acceder a la Consola de administracin de Weblogic, consulte la informacin a
continuacin.
Iniciar el servidor (dominio)

Para iniciar Weblogic, execute the following file in a command prompt:
En Linux:
<WEBLOGIC_HOME>/user_projects/domains/<USER_DOMAIN>/bin/startWebLogic.sh
289
En Windows:
<WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\startWebLogic.cmd
Projects > [user_domain] > Start Admin Server).
Asegrese de especifica el usuario y contrasea (tal como fue especificado cuando se cre el dominio
de Weblogic).
290
Detener el servidor (dominio)

Para detener Weblogic, execute the following file in a command prompt:
En Linux:
<WEBLOGIC_HOME>/user_projects/domains/<USER_DOMAIN>/bin/stopWebLogic.sh
En Windows:
<WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\stopWebLogic.cmd
Projects > [user_domain] > Start Admin Server).

Para acceder a la Consola de administracin de Weblogic, ingrese la siguiente direccin URL en un
navegador:
Recuerde que igualmente requerida ingresar el usuario y contrasea autorizado del dominio.
291
Lo que debe hacer

Para la configuracin de Weblogic para trabajar con Bizagi, el siguiente procedimiento se lleva a cabo:
1. Extraer los archivos usados por Bizagi hacia Weblogic.
3. Configurar los siguientes mdulos en Weblogic:
Autenticacin
Acceso a datos
Libreras compartidas (JSTL, JSF)
Estos mdulos se configuran en Weblogic utilizando su Consola de administracin, y utilizan a su vez
Despus de estos pasos, su instancia de Weblogic estar configurado para que los Procesos de Bizagi
se desplieguen en una aplicacin JEE (el Portal de Trabajo).
Procedimiento
de Weblogic por defecto.
292
1. Extraer los archivos usados por Bizagi hacia Weblogic

En este paso, se incluyen archivos usados por Bizagi en la instancia de Weblogic (son archivos que no
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-Weblogic-dist.zip).
1.2 Copie las libreras del mdulo de Autenticacin (bizagi-security-provider-[version].jar, bizagiremote-[version].jar, bizagi-security-common-[version].jar) de los archivos de configuracin, desde
esta ruta:
<WEBLOGIC_HOME>\wlserver_10.3\server\lib\mbeantypes\
1.3 Copie los driveres para el acceso a datos, segn el motor de Base de datos (los drivers
entregados en los archivos de configuracin), desde esta ruta:
Hacia la ruta de libreras de Weblogic.
Si utiliza Weblogic 10.3.6.0, la ruta de destino es:
<WEBLOGIC_HOME>\wlserver_10.3\server\lib\
Si su proyecto utiliza Oracle, entonces no requiere copiar el driver (ya que el ojdbc6 est incluido
por defecto en Weblogic). Lo que si debe hacer, es editar el archivo web.config.xml ubicado en
<PATH_CONFIGURATION_FILES>\JiNET\config\ de manera que la llave PROVIDERTYPE est
asignada al uso de Oracle:
Si su proyecto utiliza Microsoft SQL Server, copie el driver sqljdbc-4.0.jar.

1.4 Copie la librera utilizada para el registro de logs, que se llama log4j-[version].jar (tambin
entregada en los archivos de configuracin).
Ntese que este paso NO es requerido si se utiliza una Base de datos Oracle (dado que en este
293
escenario, dicha librera se incluye por defecto).

De no ser este su caso, entonces copie la librera de esta ruta:
<WEBLOGIC_HOME>\user_projects\domains\[your_domain]\lib\
1.5 Copie las libreras compartidas, principalmente: jsf-myfaces-1.2.8.war y eclipselink-[version].jar (que
se entrega en los archivos de configuracin).
Copiela de esta ruta:
<WEBLOGIC_HOME>\wlserver_10.3\common\deployable-libraries\

primero asergrese de que su instancia de Weblogic no est iniciada (debe estar detenido).
Seguidamente, edite el archivo de inicio del servicio de Weblogic para asignar las variables necesarias.
En Linux:
Ubique la siguiente lnea en el archivo <WEBLOGIC_HOME>/user_projects/domains/<USER_DOMAIN>/
bin/startWebLogic.sh:
JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"
Adicione lo siguiente al final de la misma lnea:
-DiNET_HOME=<PATH_CONFIGURATION_FILES>/JiNET
-Duser.language=en
Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC
Para ello, ubique la siguiente lnea en el mismo archivo: USER_MEM_ARGS=
294

USER_MEM_ARGS="-Xms768m -Xmx2048m -XX:PermSize=768m -XX:MaxPermSize=2048m"
modificacin adicional a los parmetros de ambiente compartidos, de manera que se incluya el
Para hacerlo, edite el archivo
<WEBLOGIC_HOME>/wlserver_10.3/common/bin/
commEnv.sh y ubique la lnea que contiene WEBLOGIC_CLASSPATH="${JAVA_HOME} . Adicione:
${WL_HOME}/server/lib/sqljdbc-4.0.jar como una dependencia en el archivo (usando el caracter
apropiado de separacin cuando se definen mltiples parmetros).
En Windows:
Ubique la siguiente lnea en el archivo <WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>
\bin\startWebLogic.cmd:
set JAVA_OPTIONS=%SAVE_JAVA_OPTIONS%
Adicione lo siguiente al final de la misma lnea:
-Duser.language=en
Duser.country=us -Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC
295
Para ello, ubique la siguiente lnea en el mismo archivo: set USER_MEM_ARGS=
set
USER_MEM_ARGS=-Xms768m
XX:MaxPermSize=2048m
-Xmx2048m
-XX:PermSize=768m
Note
Para hacerlo, edite
el
archivo
<WEBLOGIC_HOME>\wlserver_10.3\common\bin
\commEnv.cmd y ubique la lnea que contiene WEBLOGIC_CLASSPATH=%JAVA_HOME% .
Adicione: %WL_HOME%\server\lib\sqljdbc-4.0.jar como una dependencia en el archivo (usando el
caracter apropiado de separacin cuando se definen mltiples parmetros).
3. Configurar los mdulos de Weblogic
296
Se deben configurar algunos mdulos en Weblogic a travs de la Consola de administracin, como se

indica a continuacin.
Ntese que para editar esta configuracin, puede requerir primero utilizar el botn de Desbloqueo
y edicin (Lock & Edit button) ubicado en la esquina superior izquierda.
Al final de los pasos, igualmente asegrese de aplicar los cambios y liberar el bloqueo (haciendo clic
en Activate changes y al finalizar, clic en Release configuration).
Despus de realizar cambios, Weblogic puede indicar que se requiere de un reinicio del servicio.
3.1 Autenticacin
Acceda la Consola de administracin, y vaya a la seccin SecurityRealms y seleccione el item del
Seleccione la pestaa de Proveedores Providers y luego la pestaa de Autenticacin (Authentication).

Cree un nuevo tem dando clic sobre el botn Nuevo (New).
297
Ingrese BizagiAuthenticator como el Nombre (Name) del Proveedor

BizagiAuthenticator como el tipo (Type) de Proveedor de Autenticacin.
seleccione
298
D clic en OK. De vuelta en la lista de Proveedores de Autenticacin, asegrese de seleccionar

BizAgiAuthenticator para que sea el primer item.
Esto se requiere dado que el nuevo Proveedor opera en un contexto compartido.
Use la opcin de reordenar (botn Reorder) para mover BizAgiAuthenticator hasta la cima de la lista.
299
D clic en OK. BizAgiAuthenticator debe aparecer de primero, y d clic sobre l.

Cambie la configuracin de control (Control Flag) a el valor: SUFFICIENT (seleccinelo del combo de
opciones y d clic en Guardar --Save--).
300
Finalmente, active los cambios.

3.2 Acceso de datos
Antes de continuar con esta configuracin, tenga presente que al utilizar una Base de datos SQL Server,
se requiere que el servicio de la instancia no se inicie bajo un puerto dinmico.
Se requiere que el puerto TCP/IP del servicio est predefinido explcitamente (p.e el 1433 por defecto).
Para la siguiente configuracin, acceda la Consola de administracin y tenga en cuenta que la

configuracin vara ligeramente de acuerd al motor de Base de datos de su proyecto (Oracle o SQL
Server).
Vaya a la seccin de Servicios (Services) y d clic sobre fuentes de datos (Data Sources).
301

Primero ingrese BizAgiJava tanto para el Nombre (Name) como para el Nombre JNDI (JNDI Name).
302
Para Oracle
Seleccione Oracle como el tipo de Base de datos (Database type). D clic en Siguiente (Next) y
seleccione el driver Oracles Driver (Thin) for instance connections; Versions:
9.0.1 and later (Database Driver).
303

Para SQL Server
Seleccione MS SQL Server como el tipo de Base de dato (Database type). D clic en Siguiente (Next)
y seleccione el driver Microsoft's MS SQL Server Driver (Type 4) Versions:2005 and
later (Database Driver).
304

En las opciones de transaccin (Transaction Options), asegrese de marcar la casilla de Supports
Global Transactions.
Seleccione igualmente lo siguiente de acuerdo a su versin de Weblogic:
Si utiliza Weblogic 10.3.6.0, marque Emulate Two-Phase Commit.
D clic en Siguiente (Next) y especifique el detalle de conexin a su Base de datos. D clic nuevamente
Verifique la conexin a su Base de datos, utilizando la opcin de Probar (Test Configuration). Ntese
que tambin puede revisar la URL de la cadena de conexin.Una vez que esta verificacin sea exitosa,
d clic en Siguiente (Next).
305
Revise que esta fuente de datos sea aplicada en su Servidor de aplicaciones y d clic en Finalizar
(Finish).
Finalmente, asegrese de aplicar los cambios.
En los siguientes pasos vamos a configurar un Servidor JMS que se utiliza por Bizagi para las
Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios (Services). D clic
sobre el enlace de Mensajera (Messaging).
306
Servidor JMS
D clic en Servidores JMS (JMS Servers) y sobre Nuevo (New).
A travs de las opciones del nuevo Servidor JMS, cree un nuevo almacn de persistencia dando clic
sobre Create a New Store.
Para el tipo de almacn, seleccione File Store. D clic en Siguiente (Next).
En sus propiedades, ingrese el nombre (Name): FileStore-BizAgi.

Seleccione AdminServer (como el destino --Target--), y especifique un directorio vlido para
persistir la informacin.
Haga clic en Ok.
307
D vuelta en la informacin del nuevo Servidor JMS (habiendo creado ya el almacn de persistencia
tipo archivo), ingrese: JMSServer-BizAgi para el Nombre (Name) y seleccione el almacn creado
de las opciones del combo.
308
Finalmente, seleccione AdminServer como la instancia de servidor destino(Target) . D clic en

Finalizar (Finish).
En la lista de Servidores JMS, d clic sobre el recin creado JMSServer-BizAgi para editar su
propiedad Expiration Scan Interval.
Asgnele el valor de 120 segundos.
309
D clic en Guardar (Save) y active los cambios..

Mdulo JMS
Navegue a la seccin de Servicios (Services) y expanda la opcin de Mensajera (Messaging). .
D clic sobre JMS Modules y en Nuevo (New) para registrar un mdulo JMS.
Ingrese: SystemModule-BizAgi en el nombre (Name).

No se requiere informacin adicional; d clic en Siguiente (Next).
310
Marque la casilla de la instancia de Servidor AdminServer.
D clic en Siguiente (Next) y en Finalizar (Finish) en este siguiente paso.

En la lista de mdulos JMS, d clic sobre el recin creado SystemModule-BizAgi para editar sus
propiedades,
Dentro de las mismas, cree 2 nuevos recursos de la siguiente manera.
311
Para crear y asociarle el recurso, d clic sobre Nuevo (New) desde la tabla de resumen de recursos
(Summary of Resources).
Para el primer recurso, seleccione Connection Factory como el tipo (Type).
D clic en Siguiente (Next) e ingrese: AsyncControllerFactory tanto en el Nombre (Name), como

en el Nombre JNDI (JNDI Name). Asegrese de marcar la casilla que activa el uso de XA Connection
Factory Enabled y d clic en Finalizar (Finish).
312
Para el segundo recurso que se crea, seleccione Queue como el tipo (Type).
313
D clic en Siguiente (Next) e ingrese: AsyncController en el Nombre (Name).

Ingrese jms/AsyncController en el Nombre JNDI (JNDI Name) y d clic en Siguiente (Next).
D clic en Siguiente (Next) y cree una configuracin de subdeployment (clic sobre Create a New
Subdeployment en la opcin de Subdeployments).
Para la configuracin del Subdeployment, ingrese AsyncController en el Nombre (Name) y d clic
en OK.
314
Asegrese de que el nuevo Subdeployment sea seleccionado en el combo, y marque la casilla del
servidor destino JMSServer-BizAgi (JMS Server target)
En la lista de los recursos, d clic sobre el recin creado AsyncController Queue para editar sus
propiedades,
D clic en la pestaa de manejo de fallas en la entrega (Delivery Failure) para configurar el manejo de
reintentos cuando algn mensaje no pueda ser entregado.
315
Especifique 1 como el lmite de reintentos (Redelivery Limit) y d clic en Guardar (Save).

De esta manera, el Servidor de Aplicaciones hara un reintento para las Actividades Asncronas a nivel
de colas (lo cual quiere decir que se respetara la configuracin de reintentos de la Asncrona en
Bizagi).
Finalmente, recuerde activar los cambios.

3.4 Libreras compartidas
Acceda la Consola de administracin y vaya a la seccin de despliegues (Deployments).
Instale 4 libreras compartidas (jstl-1.2.war, jsf-1.2.war, jsf-myfaces-1.2.8.war y eclipselink-2.5.0.jar) como
316
Para la primera, d clic en Instalar (Install) y navegue hacia la ruta donde se encuentran estas librerias
desplegables. La ruta es la correspondiente a
\deployable-libraries\.
Marque la librera jsf-1.2.war.

Seleccione la opcin de Instalarla como una librera (Install this deployment as library).
D clic en Siguiente (Next y luego en Finalizar (Finish).
317
Para la segunda, repita los pasos de Instalacin (la opcin Install) pero esta vez marque la librera jsfmyfaces-1.2.8.war (ubicada en la misma ruta:
Para la tercera, repita los pasos de Instalacin (la opcin Install) pero esta vez marque la librera jstl1.2.war (ubicada en la misma ruta: <WEBLOGIC_HOME>\wlserver_10.3\common\deployablelibraries\).
318
Para la cuarta, repita los pasos de Instalacin (la opcin Install) pero esta vez marque la librera
eclipselink-2.5.0.jar (ubicada en la misma ruta:
Una vez haya instalado estas 4 libreras desplegables, se listarn inmediatamente.

Recuerde activar los cambios.
3.5 Parmetros de transaccin (JTA) y usuario administrador por defecto

Para la configuracin de parmetros de transaccin (Java Transaction API) slo necesitamos aumentar
el tiempo lmite asignado por defecto de la transaccin (timeout).
Para hacerlo, acceda la Consola de administracin y vaya a la seccin de Servicios (Services).
Seleccione JTA y edite la propiedad Timeout seconds para asignarle 120 segundos.
319
D clic en Guardar (Save) y active los cambios.

En este punto, debe reiniciar su servicio de Weblogic.
Para configurar el usuario administrador por defecto de Bizagi, es necesario crear el usuario admon
del dominio domain.
Para ello, acceda la Consola de administracin y vaya a la seccin Security realms y d clic en el
Ubique la pestaa de Usuarios y grupos (Users and Groups), y cree el nuevo usuario dando clic sobre
Nuevo (New).
320
Ingrese la siguiente informacin para el usuario administrador

Name:
Si utiliza Weblogic 10.3.6.0, el nombre del usuario deber ser: admon.
Description: Bizagi administrator user
Provider: DefaultAuthenticator
Password: bizagi$91
321
D clic en OK.
Qu sigue?
Despus de estos pasos, su instalacin de Weblogic est configurada para albergar Procesos Bizagi!
Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia Weblogic.
Configuracin de JBoss
La configuracin de un servidor JBoss hace parte de la configuracin para Configurar un Servidor de
Aplicaciones JEE, como un paso requerido al momento de generar el Portal de trabajo de Bizagi, para
que sus procesos se ejecuten sobre una plataforma JEE en un ambiente de pruebas o de produccin.
La configuracin de JBoss vara de acuerdo a si la configuracin de la solucin tendr un esquema de
alta disponibilidad o no (si se involucra o no ms de una instancia de JBoss en un clster).
322
Para una gua sobre cmo configurar JBoss para trabajar con Bizagi en un esquema de alta
disponibilidad (para aplicaciones de misin crtica), consulte la Configuracin en clster de JBoss.
Para una gua sobre cmo configurar JBoss para trabajar con Bizagi como instancia standalone (setup
estndar), consulte Configuracin estndar de JBoss.
Configuracin de JBoss para soporte a clster
Introduccin
Esta seccin se enfoca en la configuracin de JBoss para trabajar con Bizagi, en un esquema de alta
disponibilidad, donde se hace uso de un clster para contar el balanceo de cargas en la aplicacin.
Si desea configurar JBoss a modo standalone (solamente empleando un servidor BPM; sin esquema de
balanceo de cargas), consulte la Configuracin estndar de JBoss.
323
Lo que debe hacerse

1. Configurar JBoss en clster para trabajar en Bizagi.

Estos pasos se describen en la Configuracin en clster de JBoss.
Estos pasos se describen en la Configuracin del Scheduler en JBoss.
Con la edicin Bizagi JEE, sus Procesos se pueden montar sobre diferentes Servidores de Aplicacin
JEE (p.e. WebSphere, WebLogic, o JBoss).
Para mayor informacin sobre JBoss EAP 6.2 y sus requerimientos de sistema, consultar la
documentacin oficial de JBoss.
Para mayor informacin sobre el procedimiento e informacin general de esta seccin, consulte
Configuracin de JBoss para soporte a clster.
Prerrequisitos
Para configurar su instancia de JBoss en un ambiente de pruebas o produccin, se requiere:
6, update 45.
sin espacios).
Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earJBoss-dist.zip).
Tener instalado el Servidor JBoss. La versin soportada es JBoss EAP 6.2. Mayor informacin en la
pgina oficial de JBoss (p.e de requerimientos de sistema).
La variable de entorno JBOSS_HOME configurada previamente.
Sobre JBoss
Una vez revisados los prerrequisitos, la instalacin de JBoss solamente requiere de extraer el
contenido del zip (jboss-eap-6.2.0.zip) a una ruta local del servidor.
324
Se requiere que esta ruta no contenga espacios en blanco.

La ruta donde se extrae JBoss ser referenciada como <JBOSS_HOME> a partir de este momento.
Para conocer ms acerca de la instalaci o troubleshooting de JBoss, le recomendamos consultar las
guas del producto, disponibles en su sitio oficial.
Lo que debe hacerse

Para configurar una instancia de JBoss EAP 6.2, siga estos pasos:
1. Extraer los archivos usados por Bizagi hacia JBoss.
Este paso se debe realizar para cada nodo de su clster.
2. Configuracin de un dominio para el clster JBoss.
Este paso se debe realizar para cada nodo de su clster.
3. Creacin de usuarios de administracin y de aplicacin.
Los pasos en este punto difieren para cada tipo de nodo, como se indica a detalle en esa seccin.
4. Configuracin de host (para el nodo maestro y nodos esclavos).
Los pasos en este punto difieren para cada tipo de nodo, como se indica a detalle en esa seccin.
Procedimiento
Los siguientes pasos describen a detalle cmo configurar una instalacin de JBoss por defecto.
1. Extraer los archivos usados por Bizagi hacia JBoss

En este paso, se incluyen archivos usados por Bizagi en la instancia de JBoss (son archivos que no
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-JBoss-dist.zip).
1.1 Extraer el contenido de este .zip hacia una ruta local sin espacios. Esta ruta ser referenciada
como <PATH_CONFIGURATION_FILES> a partir de este momento.
Esto crear una carpeta llamada BizagiBPMJEE, que provee la siguientes estructura y archivos:
325
Ntese que en nuestro caso <PATH_CONFIGURATION_FILES> referencia la ruta C:\BizagiJEE\.
Una vez que los archivos de configuracin estn en su ruta local, ubquelos en la ruta respectiva de
JBoss, como se indica a continuacin.
1.2 Copie las libreras de los mdulos tomando toda la carpeta com (y sus carpetas y archivos
internos), que se proveen en los archivos de configuracin de Bizagi.
Copielos desde esta ruta:
<PATH_CONFIGURATION_FILES>\configuration\modules\com
Y ubquelos en esta ruta de JBoss:
<JBOSS_HOME>\modules\
Por medio de esta accin se copian las libreras de autenticacin (bizagi-jaas-[version].jar, bizagiremote-[version].jar, bizagi-security-common-[version].jar), los JDBC y drivers de bases de datos
(ojdbc6-[version].jar, ojdbc6-[version].jar, sqljdbc-[version].jar), al igual que utilitarios adicionales (p.e,
tools-[version].jar).
Al finalizar este paso, en los mdulos de JBoss, se debe tener toda la estructura de la carpeta com, sus
sub-directorios y libreras:
326
Ntese que esta accin tambin copiar los archivos module.xml para cada set de libreras.
Es importante revisar que en este archivo de definicin se referencien las libreras correspondientes
con su nmero de versin exacto (includo en su nombre):
1.3 Copie la librera del framework de persistencia que se llama eclipselink-[version].jar y tambin su
archivo de definicin xml (module.xml). Ambos se proveen desde los archivos de configuracin de
Bizagi.
Copielos desde esta ruta:
327
<PATH_CONFIGURATION_FILES>\configuration\modules\org\eclipse\persistence
\main\
Y ubquelos en esta ruta de JBoss:
<JBOSS_HOME>\modules\org\eclipse\persistence\main\
El archivo module.xml que queda ubicado en <JBOSS_HOME>\modules\org\eclipse
\persistence\main\ deber tener el siguiente contenido:
2. Configuracin de un dominio para el clster JBoss.

Al apoyarse en un dominio de clster, se logra una administracin centralizada de los nodos. Dentro
de esta administracin centralizada, se consideran las siguientes capacidades:
Cada nodo estar disponible para ser asignado con requests, e igualmente procesarlos.
Cada nodo reportar cambios para que estos sean propagados a los dems nodos.
Si por algn motivo, el nodo no tiene disponibilidad de servicio, los requests sern manejados y
distribudos apropiadamente entre los dems nodos.
Para configurar un dominio, lleve a cabo los siguientes pasos (para cada nodo de JBoss en su clster):
2.1 Ubique el archivo domain.xml ubicado como <JBOSS_HOME>\domain\configuration y edite
el archivo de acuerdo a las instrucciones especficas a continuacin.
2.2 Incluya ajustes globales.
Ingrese 2 propiedades de sistema ubicando el elemento <system-properties> y asegurndose de
328
incluir las siguientes lneas:

<property name="com.arjuna.ats.arjuna.allowMultipleLastResources"
value="true"/>
<property name="org.jboss.as.logging.per-deployment" value="false"/>
El archivo domain.xml en este punto se ver como:
Especifique las propiedades de autenticacin y single sign-on, ubicando el elemento <virtual-server>

dentro del subsistema web (correspondiente a <subsystem xmlns="urn:jboss:domain:web).
Realice este paso para cada elemento al incluir la siguiente lnea:
<sso cache-container="web" cache-name="sso" reauthenticate="false"/>
El archivo en este punto se ver como:
Ntese que deber hacer esta modificacin para cada perfil (aproximadamente 4 veces).
329
2.3 Edite el perfil de alta disponibilidad para incluir los drivers de bases de datos.
Realice esto ubicando el perfil llamado HA profile dentro del elemento <profiles>, y con las siguientes
modificaciones:
Ubique el subsistema de datasources dentro de este perfil HA profile (correspondiente a <subsystem
xmlns="urn:jboss:domain:datasources:1.1">").
Si usted utiliza SQL Server, reemplace la definicin del elemento <datasources> por la siguiente:
<datasources>
<xa-datasource jndi-name="java:/BizAgiJava" pool-name="BizAgiJava"
enabled="true" use-java-context="false" use-ccm="true">
<xa-datasource-property name="ServerName">[Database_Server]</xadatasource-property>
<xa-datasource-property name="DatabaseName">[Database_Name]</xadatasource-property>
<xa-datasource-property name="User">[Database_User]</xa-datasourceproperty>
<xa-datasource-property name="Password">[Database_Password]</xadatasource-property>
<driver>MICROSOFTSQLSERVERXA</driver>
</xa-datasource>
<drivers>
<driver name="MICROSOFTSQLSERVER" module="com.microsoft.sqlserver">
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driverclass>
</driver>
<driver name="MICROSOFTSQLSERVERXA" module="com.microsoft.sqlserver">
<xa-datasource-class>
com.microsoft.sqlserver.jdbc.SQLServerXADataSource
</xa-datasource-class>
</driver>
<driver name="ORACLE" module="com.oracle.ojdbc6">
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
</driver>
<driver name="BIZAGI" module="com.bizagi.jdbc">
<driver-class>bizagi.jdbc.BizAgiDriver</driver-class>
</driver>
</drivers>
</datasources>
Considere:
[Database_Server]: El nombre o IP del servidor de Base de datos SQL Server, con el nombre de la
instancia si aplica.
[Database_Name]: El nombre de la Base de datos que corresponde al proyecto de Bizagi.
[Database_User]: La cuenta login para acceder a la instancia de SQL Server.
[Database_Password]: La contrasea para la cuenta login.
El archivo en este punto al utilizar SQL Server se ver como:
330
Si usted utiliza Oracle, reemplace la definicin del elemento <datasources> por la siguiente:
<datasources>
<xa-datasource jndi-name="java:/BizAgiJava" pool-name="BizAgiJava"
enabled="true" use-java-context="false" use-ccm="true">
<xa-datasource-property
name="URL">jdbc:oracle:thin:@[Database_Server]:[Port_Number]:
[Database_Identification]</xa-datasource-property>
<xa-datasource-property name="User">[Database_User]</xa-datasourceproperty>
<xa-datasource-property name="Password">[Database_Password]</xadatasource-property>
<driver>ORACLE</driver>
</xa-datasource>
<drivers>
</driver>
<driver name="MICROSOFTSQLSERVERXA" module="com.microsoft.sqlserver">
<xa-datasource-class>
com.microsoft.sqlserver.jdbc.SQLServerXADataSource
</xa-datasource-class>
</driver>
331

</driver>
</driver>
</drivers>
</datasources>
Considere:
[Database_Server]: El nombre o IP del servidor de Base de datos de la instancia Oracle.
[Port_Number]: El nmero del puerto bajo el cual el servicio atiende (por defecto es el 1521).
[Database_Identification]: El ID de la instancia de Oracle.
[Database_User]: El nombre del esquema de usuario en Oracle, que representa el proyecto de Bizagi.
[Database_Password]: La contrasea para ese esquema de usuario.
El archivo en este punto al utilizar Oracle se ver como:
2.4 Edite el perfil de alta disponibilidad (el mismo HA profile) para definir configuracin adicional.
Para ello:
Incluya una definicin de <mdb> dentro del subsistema de EJB (correspondiente a
xmlns="urn:jboss:domain:ejb3).
Podr hacer esto entre los elementos <session-bean> y <pools>.
<mdb>
<resource-adapter-ref resource-adaptername="hornetq-ra"/>
<bean-instance-pool-ref pool-name="mdbstrict-max-pool"/>
332
</mdb>
Edite las ltimas lneas de este mismo subsistema (xmlns="urn:jboss:domain:ejb3.), para configurar
BizAgiRealm como el dominio de seguridad por defecto, y para contemplar un manejo por
defecto.
Al editar estas lneas, ubique los elementos default-security-domain y default-missing-methodpermissions-deny-access para editar sus valores. Configrelas como:
<default-security-domain value="BizAgiRealm"/>
<default-missing-method-permissions-deny-access value="false"/>
333
Incluya la siguiente definicin de mensajera, como el elemento <subsystem> de mensajera seguido

del elemento de definicin de mail (correspondiente a xmlns="urn:jboss:domain:mail).
<subsystem xmlns="urn:jboss:domain:messaging:1.2">
<hornetq-server>
<clustered>true</clustered>
<persistence-enabled>false</persistence-enabled>
<security-enabled>false</security-enabled>
<cluster-password>newClusterPassword</cluster-password>
<allow-failback>true</allow-failback>
<shared-store>true</shared-store>
<journal-type>NIO</journal-type>
<journal-file-size>102400</journal-file-size>
<journal-min-files>2</journal-min-files>
<connectors>
<netty-connector name="netty" socket-binding="messaging"/>
<netty-connector name="netty-throughput" socket-binding="messagingthroughput">
<param key="batch-delay" value="50"/>
</netty-connector>
334
<in-vm-connector name="in-vm" server-id="0"/>

</connectors>
<acceptors>
<acceptor name="stomp-acceptor">
<factoryclass>org.hornetq.core.remoting.impl.netty.NettyAcceptorFactory</factoryclass>
<param key="protocol" value="stomp"/>
<param key="port" value="61613"/>
</acceptor>
<netty-acceptor name="netty" socket-binding="messaging"/>
<netty-acceptor name="netty-throughput" socket-binding="messagingthroughput">
<param key="direct-deliver" value="false"/>
</netty-acceptor>
<in-vm-acceptor name="in-vm" server-id="0"/>
</acceptors>
<broadcast-groups>
<broadcast-group name="bg-group1">
<group-address>231.7.7.7</group-address>
<group-port>9876</group-port>
<broadcast-period>1000</broadcast-period>
<connector-ref>netty</connector-ref>
</broadcast-group>
</broadcast-groups>
<discovery-groups>
<discovery-group name="dg-group1">
<group-address>231.7.7.7</group-address>
<group-port>9876</group-port>
<refresh-timeout>1000</refresh-timeout>
</discovery-group>
</discovery-groups>
<cluster-connections>
<cluster-connection name="my-cluster">
<address>jms</address>
<connector-ref>netty</connector-ref>
<discovery-group-ref discovery-group-name="dg-group1"/>
</cluster-connection>
</cluster-connections>
<security-settings>
<security-setting match="#">
<permission type="send" roles="rmirole guest"/>
<permission type="consume" roles="rmirole guest"/>
<permission type="createNonDurableQueue" roles="guest"/>
<permission type="deleteNonDurableQueue" roles="guest"/>
</security-setting>
</security-settings>
<address-settings>
<address-setting match="#">
<dead-letter-address>jms.queue.DLQ</dead-letter-address>
<expiry-address>jms.queue.ExpiryQueue</expiry-address>
<redelivery-delay>0</redelivery-delay>
335
<max-size-bytes>10485760</max-size-bytes>
<address-full-policy>BLOCK</address-full-policy>
<message-counter-history-day-limit>10</message-counter-history-daylimit>
</address-setting>
</address-settings>
<jms-connection-factories>
<connection-factory name="InVmConnectionFactory">
<connectors>
<connector-ref connector-name="in-vm"/>
</connectors>
<entries>
<entry name="java:/ConnectionFactory"/>
</entries>
</connection-factory>
<connection-factory name="RemoteConnectionFactory">
<connectors>
<connector-ref connector-name="netty"/>
</connectors>
<entries>
<entry name="RemoteConnectionFactory"/>
<entry name="java:jboss/exported/jms/RemoteConnectionFactory"/>
</entries>
<connection-factory name="AsyncControllerFactory">
<connectors>
</connectors>
<entries>
<entry name="/AsyncControllerFactory"/>
</entries>
<connection-factory name="EclipseLinkTopicConnectionFactory">
<factory-type>TOPIC</factory-type>
<connectors>
</connectors>
<entries>
<entry name="java:jboss/exported/jms/
EclipseLinkTopicConnectionFactory"/>
</entries>
<pooled-connection-factory name="hornetq-ra">
<transaction mode="xa"/>
<connectors>
</connectors>
<entries>
<entry name="java:/JmsXA"/>
</entries>
</pooled-connection-factory>
</jms-connection-factories>
<jms-destinations>
336
<jms-queue name="testQueue">
<entry name="queue/test"/>
</jms-queue>
<jms-queue name="AsyncController">
<entry name="jms/AsyncController"/>
</jms-queue>
<jms-topic name="testTopic">
<entry name="topic/test"/>
</jms-topic>
<jms-topic name="EclipseLinkTopic">
<entry name="java:jboss/exported/jms/EclipseLinkTopic"/>
</jms-topic>
</jms-destinations>
</hornetq-server>
</subsystem>
El archivo con esta definicin, tendr el fragmento inicial como se muestra a continuacin:
Asegrese de que el subsistema modcluster se defina explcitamente como:

<subsystem xmlns="urn:jboss:domain:modcluster:1.1">
<mod-cluster-config advertise-socket="modcluster"
connector="ajp">
<dynamic-load-provider>
<load-metric type="busyness"/>
</dynamic-load-provider>
</mod-cluster-config>
</subsystem>
Incluya la definicin del dominio de seguridad dentro del subsistema de seguridad (correspondiente
a <subsystem xmlns="urn:jboss:domain:security:1.2">).
Para ello, ingrese este elemento security-domain dentro de la lista de <security-domains>:
<security-domain name="BizAgiRealm" cache-type="default">
337
<authentication>
<login-module code="com.bizagi.security.jaas.BizAgiLoginModule"
flag="required"
module="com.bizagi.security"/>
</authentication>
</security-domain>
Especifique uso de sockets y sus bindings, para el servicio de mensajera, primero ubicando el
elemento <socket-binding-groups>.
Para el grupo a su interior que se ubica como <socket-binding-group name="ha-sockets" defaultinterface="public">, adicione lo siguiente:
<socket-binding name="messaging" port="5445"/>
<socket-binding name="messaging-group" port="0"
multicast-address="${jboss.messaging.group.address:231.7.7.7}"
multicast-port="${jboss.messaging.group.port:9876}"/>
<socket-binding name="messaging-throughput" port="5455"/>
338
Ajuste los parmetros de la JVM ubicando el elemento <server-groups> al final del archivo, y
reemplace la definicin existente por la que proveemos a continuacin:
<server-groups>
<server-group name="main-server-group" profile="ha">
<jvm name="default">
<heap size="64m" max-size="512m"/>
<permgen size="256m" max-size="768m"/>
</jvm>
<socket-binding-group ref="ha-sockets"/>
</server-group>
</server-groups>
339
3. Creacin de usuarios de administracin y de aplicacin.

Para la configuracin de Bizagi en JBoss EAP, es estrictamente necesario crear mnimo un usuario
administrador para la instancia en JBoss (usuario de JBoss).
Al configurar un clster en JBoss, necesitar de usuarios adicionales para la comunicacin entre los
nodos.
Antes de continuar, ntese que en los siguientes pasos se ilustrar la creacin de estos usuarios y su
referenciacin desde archivos.
Para el clster, necesitamos definir previamente cul de los nodos ser el nodo maestro (master) que
es controlador del dominio.
Los dems nodos sern nodos esclavos (slave).
3.1 Cree un usuario administrador para cada uno de los nodos.
Este usuario administrador ser encargado de la administracin del nodo, y se requiere por JBoss
para el manejo de las instancias EAP.
Podr hacer esto desde el nodo, a travs una consola con las opciones de JBoss.
Utilice:
<JBOSS_HOME>\bin\add-user [usuario] [contrasea]
Para ello, asegrese de especificar el nombre del usuario, seguido por una contrasea que contenga
mnimo un nmero y un caracter especial.
Para la configuracin de Bizagi es requerido que por lo menos cree el usuario administrador conla
siguiente informacin:
Username: bizagi
Password: password1!
340
3.2 Cree un usuario de aplicacin para cada nodo de su clster.

En este punto asegrese de saber qu nodo de su clster ser el nodo maestro.
Para ello utilice desde el nodo maestro:
<JBOSS_HOME>\bin\add-user
Asegrese de:
Seleccionar la opcin b) que determina que sea un usuario de aplicacin.
Apruebe la escogencia de ApplicationRealm.
Darle un nombre en comn, tal como en los dems nodos (p.e, ejbcaller).
Proveer una contrasea que contenga mnimo un nmero y un caracter especial (p.e, password1!).
Ignore la configuracin de grupos de usuario (solamente dar enter en este item).
Confirmar la accin (ingresando yes).
Especificar que si (yes) a la pregunta Is this user going to be used for one AS process to connect to
another AS process?.
De esta manera usted obtendr una llave encriptada que debe reemplazar en cada nodo esclavo.
Esto se realiza en el elemento <secret> ubicado dentro del archivo <JBOSS_HOME>\domain
\configuration\host-slave.xml.
341
4. Configuracin de host (para el nodo maestro y nodos esclavos).

Una vez que haya creado sus usuarios, edite el archivo host.xml ubicado en la ruta <JBOSS_HOME>
\domain\configuration.
Para cada uno de sus nodos, asegrese de realizar estos ajustes:
Ubique el elemento<interfaces>, y configure alli la direccin IP de su nodo maestro, en el valor de
<inet-address>:
342
Ubique el elemento <jvms>, y ajuste la configuracin de parmetros de la JVM para que se utilice lo
siguiente:
<heap size="256m" max-size="512m"/>
<permgen size="256m" max-size="768m"/>
Ubique el elemento <servers>, y ajuste la configuracin de parmetros de la JVM para que sus
nodos referencien en su variable de entorno, a Bizagi JiNET:
343
Si usted utiliza una configuracin de clster vertical, ntese que deber incluir sus nodos adicionales en
el mismo grupo de servidor (server group).
Realice esto registrando sus nodos como elementos <server> con la misma definicin de grupo, y
revisando que se usen un port-offset en los posteriores nodos para evitar conflictos por nmero de
puerto en el mismo equipo.
Finalmente, asigne un nombre a sus nodos esclaves (slave), para que utilicen uno propio y no el
nombre de master. Realice esto en el elemento <host>:
Solamente se debe conservar el nombre master para el nodo maestro:
344
Iniciar el servicio en clster de JBoss

Al completar estos pasos, usted podr iniciar el servicio de su clster de JBoss iniciando cada nodo.
Para el nodo maestro (master), utilice el siguiente comando.
En Windows:
<JBOSS_HOME>\bin\domain.bat -b [IP_Nodo_Maestro] Djboss.bind.address.management=[IP_Nodo_Maestro]
En Linux:
<JBOSS_HOME>/bin/domain.sh -b [IP_Nodo_Maestro] Djboss.bind.address.management=[IP_Nodo_Maestro]
En cada uno de los nodos esclavos (slave), utilice el siguiente comando.

En Windows:
<JBOSS_HOME>\bin\domain.bat -b [IP_Nodo_Actual] Djboss.domain.master.address==[IP_Nodo_Maestro] --host-config=hostslave.xml
En Linux:
<JBOSS_HOME>/bin/domain.sh -b [IP_Nodo_Actual] Djboss.domain.master.address==[IP_Nodo_Maestro] --host-config=hostslave.xml
Qu sigue?
Despus de estos pasos, su instalacin de JBoss est configurada para albergar Procesos Bizagi!
Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia JBoss.
Tenga en cuenta que si su proyecto utiliza Replicacin o Virtualizacin (como mtodos de integracin
en la solucin Bizagi), entonces para su ambiente de produccin deber configurar la Replicacin o
Virtualizacin directamente en el Servidor de Aplicaciones JEE.
Para ms informacin sobre esta opcin, consulte Cmo configurar Replicacin o Virtualizacin en un
345
Servidor de Aplicaciones JEE.
Introduccin
esquema de:
solucin).
Prerrequisitos
Para configurar del servicio de Scheduler de JBoss asegrese de cumplir con los siguientes
prerrequisitos:
Se debe haber configurado la solucin de Bizagi en JBoss.
Para ms informacin sobre ello, consulte Configuracin en clster de JBoss.
Tenga a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earJBoss-dist.zip). Estos archivos deben haber sido descomprimidos en los pasos de configuracin de
JBoss y ubicados en una ruta que ser referenciada como <PATH_CONFIGURATION_FILES> en
esta seccin.
Configuracin
2. Configure el archivo de propiedades custom_jndi.properties

java.naming.factory.url.pkgs: Propiedad de uso exclusivo de Bizagi que define el contexto del
componente cliente (jboss-client) que ser utilizado para establecer comunicacin con el servidor de
aplicaciones. El valor asignado a esta propiedad es:
org.jboss.ejb.client.naming
aplicaciones JBoss. El valor asignado a esta propiedad es:
346
ejb:BizAgi-ear-JBoss/bizagi-scheduler//
BizAgiSchedulerBean!com.vision.bizagi.scheduler.BizAgiSchedulerRemote
3. Configure el archivo de propiedades custom-jboss-ejb-client.properties:

endpoint.name: Propiedad de uso exclusivo de Bizagi y debe tomar el valor client-endpoint.
remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLED: Propiedad de uso
exclusivo de Bizagi y debe tomar el valor false.
remote.connections: Nombre de la conexin. Por defecto el valor asignado es default.
remote.connection.default.host: Nombre o direccin IP del servidor de aplicaciones.
remote.connection.default.port: Nmero de Puerto asignado al servidor de aplicaciones para
atender las peticiones RMI.
remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS:
Propiedad de uso exclusivo de Bizagi y debe tomar el valor false.
Propiedades requeridas en la configuracin de un ambiente distribuido: Este conjunto de propiedades
vienen por defecto deshabilitadas (#).
remote.clusters: Nombre utilizado en la configuracin del controlador de dominio para especificar
el cluster de EJB. Por defecto el valor asignado es EJB.
remote.cluster.ejb.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS: Propiedad
de uso exclusivo de Bizagi y debe tomar el valor false.
remote.cluster.ejb.connect.options.org.xnio.Options.SSL_ENABLED: Propiedad de uso exclusivo
de Bizagi y debe tomar el valor false.
remote.cluster.ejb.username: Si en el servidor de aplicaciones se configur seguridad a nivel de
aplicacin para establecer comunicacin con componentes externos, se bebe especificar el nombre
del usuario creado.
remote.cluster.ejb.password: Si en el servidor de aplicaciones se configur seguridad a nivel de
aplicacin para establecer comunicacin con componentes externos, se bebe especificar la
contrasea del usuario creado.

de entorno: bizagi.cache.multicast.enabled, bizagi.cache.multicast.address,
configuracin de variables de entorno para configurar JBoss para trabajar en clster).

347
administrador.
Configuracin estndar de JBoss
Introduccin
El procedimiento de configuracin de un Servidor de Aplicaciones para trabajar con Bizagi puede
variar ligeramente de acuerdo a las diferencias de cada uno de los servidores.
Esta seccin se enfoca en la configuracin de JBoss para trabajar con Bizagi, dirigida a un ambiente de
pruebas o de produccin, o en un montaje standalone (sin balanceo de cargas).
348
Si desea configurar JBoss en un esquema de alta disponibilidad y con la posibilidad de balanceo de

cargas, consulte la Configuracin en clster de JBoss.
configuracin dado que la edicin de Bizagi JEE incluye una instancia del Servidor JBoss, el cual es
Para ms informacin sobre JBoss EAP 6.2 y sus requerimientos del sistema, consulte la pgina de la
Comunidad Oficial de JBoss.
Prerrequisitos
Para configurar su Servidor de Aplicaciones de JBoss en un ambiente de pruebas o produccin, se
requiere lo siguiente:
La variable de entorno JAVA_HOME configurada previamente (La ruta no debe contener espacios).
Los archivos de configuracin y de despliegue entregados por Bizagi (BizAgi-ear-JBoss-dist.zip).
JBoss EAP 6.2 instalado. Mayor informacin en la pgina oficial de JBoss (p.e de requerimientos de
sistema). JBoss puede ser descargado directamente desde Sourceforge.net.
La variable de entorno JBOSS_HOME configurada previamente.
Acerca de JBoss
Instalar JBoss (una vez se tengan cubiertos los prerrequisitos) solo requiere de extraer el contenido del
archivo de JBoss (jboss-eap-6.2.0.zip) en una carpeta local de su Servidor.
Es importante que el nombre y la ruta de esta carpeta local, no contenga espacios.
Vamos a llamar a la ruta local escogida para extraer JBoss como <JBOSS_HOME> a partir de este
punto.
Para conocer ms detalle sobre el proceso de instalacin de JBoss, consulte la documentacin oficial
de JBoss.
Antes de usar JBoss, vamos a revisar rpidamente algunos comandos bsicos para iniciar o detener el
servicio.
Iniciar el servidor
Para iniciar el Servidor de Aplicaciones JBoss, ubique la carpeta <JBOSS_HOME>/bin y ejecute el
archivo standalone.
En Linux, ejecute standalone.sh en una consola de comandos con los siguientes parmetros:
standalone.sh -b 0.0.0.0
En Windows, ejecute standalone.bat en una consola de comandos con los siguientes parmetros:
standalone.bat -b 0.0.0.0
349
Se puede validar que JBoss se haya iniciado y se est ejecutando, ingresando la siguiente URL en un
navegador:
http://localhost:8080/
La siguiente pgina inicial debe cargarse:
Ntese que el 8080 corresponde al puerto configurado para atender las solicitudes HTTP.
350
Detener el servidor
Para detener el Servidor de Aplicaciones JBoss, existen 2 opciones:
Opcin 1
Presione CTRL+C en la consola de comandos donde se est ejecutando JBoss.
Opcin 2
Primero, ubique la carpeta <JBOSS_HOME>/bin y ejecutar el archivo jboss-cli .
Para esta segunda opcin, en Linux:
Ejecute jboss-cli.sh en una consola de comando con los siguientes parmetros:
jboss-cli.sh --connect command=:shutdown
Para esta segunda opcin, en Windows:
Ejecute jboss-cli.bat en una consola de comando con los siguientes parmetros:
jboss-cli.bat --connect command=:shutdown
Lo que debe hacer

Para configurar que JBoss EAP 6.2 trabaje con Bizagi, se deben ejecutar los siguientes pasos:
1. Extraer los archivos usados por Bizagi hacia JBoss.
3. Configurar los siguientes mdulos en JBoss:
Esto considera los siguientes mdulos:
Autenticacin
Acceso a datos
Parmetros de transaccin (JTA)
Opcin de compresin HTTP
Estos mdulos se configuran en JBoss utilizando los archivos de Bizagi que se extraen en el primer
paso.
4. Crear el usuario administrador de JBoss.
Despus de estos pasos, su instalacin de JBoss estar configurada para los Procesos de Bizagi y
listos para que se desplieguen en una aplicacin JEE (el Portal de Trabajo).
Procedimiento
Los siguientes pasos describen a detalle cmo configurar y modificar la configuracin estndar de la
instalacin de JBoss para que el servicio pueda trabajar con Bizagi.
Siempre use los nombres y la informacin tal u como se muestra a continuacin y recuerde que
ambos distinguen entre minsculas y maysculas
351
1. Extraer los archivos usados por Bizagi hacia JBoss

En este paso, se incluyen archivos usados por Bizagi en la instancia de JBoss estos archivos no vienen
por defecto en una instalacin limpia de JBoss EAP 6.2.
1.1 Extraer el contenido de BizAgi-ear-JBoss-dist.zip.
Extraiga BizAgi-ear-JBoss-dist.zip en una carpeta local de su servidor.
Es importante que el nombre de esta carpeta local y su ruta, no contengan espacios.
Esta ruta ser referenciada como <BIZAGI_JEE_HOME> a partir de este momento. En ella, se crear
una carpeta llamada BizagiBPMJEE:
En nuestro caso <BIZAGI_JEE_HOME> referencia la ruta C:\BizagiJEE\. El archivo zip descomprimido

debe contener la siguiente estructura y archivos:
352
1.2 Extraer el contenido de BizagiJbossModules.zip

Ubique el archivo BizagiJbossModules.zip contenido dentro de la carpeta BizagiBPMJEE/
configuration dentro de la carpeta <BIZAGI_JEE_HOME>.
353
Seleccione Extraer Todos y escoja la carpeta <JBOSS_HOME>/modules/system/layers/base/

como el destino donde se extraern los archivos.
Usted podr ver que en la carpeta <JBOSS_HOME>/modules/system/layer/base/, sern

agregados archivos adicionales a las carpetas "com" y "org" de la instalacin original de JBoss:
354
La siguiente imagen ilustra el detalle de los nuevos archivos y carpetas extrados hacia JBoss. En la
vista de la izquierda (1), se aprecia la estructura por defecto:
355

En una instalacin por defecto de JBoss, su servicio iniciar con algunas variables configuradas de
manera predeterminada.
Sin embargo, cuando se se realiza para procesos de Bizagi se requiere:
Incluir JiNet para el inicio de servicio de JBoss y
Ajustar la asignacin de memoria usada por JBoss para su servicio.
Esto se hace editando el archivo de configuracin del ejecutable.
356
En linux, este archivo se encuentra en

<JBOSS_HOME>/bin/standalone.conf.
En Windows, este archivo se encuentra en
<JBOSS_HOME>/bin/standalone.conf.
Los detalles de cmo editar este archivo para su sistema operativo, se especifican a continuacin.
En Linux
Edite el archivo <JBOSS_HOME>/bin/standalone.conf para iniciar JBoss, incluyendo lo siguiente al final
del archivo:
# Bizagi Configuration
JAVA_OPTS="$JAVA_OPTS -DiNET_HOME=<PATH_CONFIGURATION_FILES>/BizagiBPMJEE/
JiNET DAPP_SERV=JBOSS"
JAVA_OPTS="$JAVA_OPTS -Xms512m -Xmx1024m -XX:MaxPermSize=1024m"
Recuerde reemplazar <BIZAGI_JEE_HOME> con la ruta de su instalacin de JBoss.
Adems, tenga en cuenta que se debe utilizar slash (/) como separador de ruta, en cambio del backslash.
Como puede observar en la segunda lnea, el mnimo de memoria requerida para el inicio es de 1G
para el primer y segundo parmetro y 512M para el otro.
Usted puede incrementar la memoria asignacin de memoria como sea requerido pero, debe tener en
consideracin la capacidad de hardware de su servidor.
Al finalizar, el archivo <JBOSS_HOME>/bin/standalone.conf deber verse as:
357
En Windows
Para editar el archivo <JBOSS_HOME>/bin/standalone.conf.bat en Windows para iniciar JBoss, siga
estos pasos:
1. Edite este archivo modificando la memoria para el inicio del servicio despus de la lnea que
contiene "JVM memory allocation" (aproximadamente sobre la lnea nmero 49).
Como puede observar en la segunda lnea, el mnimo de memoria requerida para el inicio es de 1G
para el primer y segundo parmetro y 512M para el otro.
set "JAVA_OPTS=-Xms512M -Xmx1024M -XX:MaxPermSize=1024M"
Usted puede incrementar la memoria asignacin de memoria como sea requerido pero, debe tener en
consideracin la capacidad de hardware de su servidor.
2. Edite el archivo incluyendo lo siguiente en la ultima parte de la lnea, despus de la lnea que
contiene "Reduce the RMI GCs...":
-DiNET_HOME=<PATH_CONFIGURATION_FILES>/BizagiBPMJEE/JiNET DAPP_SERV=JBOSS
Recuerde reemplazar <BIZAGI_JEE_HOME> con la ruta de su instalacin de JBoss.
Tenga en cuenta que se debe utilizar slash (/) como separador de ruta, en cambio del back-slash.
Al incluir esta parte, la lnea completa quedar como:
set "JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true DiNET_HOME=<BIZAGI_JEE_HOME>/ DAPP_SERV=JBOSS
3. Edite el archivo incluyendo las siguientes lneas antes del fin de la declaracin de variables
:JAVA_OPTS_SET para agregar el lenguaje predeterminado y la codificacin de caracteres de Bizagi.
rem # JDK default language required by Bizagi (English)
set "JAVA_OPTS=%JAVA_OPTS% -Duser.language=en -Duser.country=us"
rem # Configuring character encoding
set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8"
358
Al finalizar, el archivo <JBOSS_HOME>/bin/standalone.conf.bat deber verse as:
3. Configurar los mdulos de JBoss

Para el servicio standalone de JBoss, Bizagi requiere cambiar configuraciones, mdulos, propiedades, la
fuente de datos del proyecto as como otros elementos.
Para hacer esto, ubique el archivo standalone.xml en <JBOSS_HOME>/standalone/configuration/
standalone.xml y edtelo siguiendo los pasos a continuacin:
3.1 Autenticacin
Para incluir el mdulo de Autenticacin en el servicio de JBoss, incluya las siguientes lneas en el
archivo standalone.xml:
<security-domain name="BizAgiRealm" cache-type="default">
<authentication>
<login-module code="com.bizagi.security.jaas.BizAgiLoginModule"
flag="required" module="com.bizagi.security"/>
</authentication>
</security-domain>
359
Estas lneas deben ser agregadas dentro del elemento <security-domains> dentro de la seccin
<subsystem xmlns="urn:jboss:domain:security:1.2">.
En este punto, el archivo standalone.xml debe verse as:
3.2 Acceso a datos

Para incluir los drivers para el acceso a datos en JBoss, incluya las siguientes lneas en el archivo
standalone.xml:
Si su base de datos es Microsoft SQL Server, incluya:
</driver>
Si su base de datos es Oracle, incluya:
</driver>
En cualquier caso, incluya el siguiente driver:
</driver>
Estas lneas deben ser agregadas al elemento <drivers>.
En este punto, el archivo standalone.xml se ver as:
360
3.3 Incluya la fuente de datos de su proyecto

El siguiente paso vara ligeramente de acuerdo al motor de Base de datos usado por el proyecto de
Bizagi (Oracle o SQL Server).
o Para Oracle
Para incluir una fuente de datos especfica de Oracle para su proyecto en JBoss, primero incluya las
siguientes lneas en el archivo standalone.xml:
<datasource jta="true" jndi-name="java:/BizAgiJava" pool-name="BizAgiJava"
enabled="true" use-ccm="true">
<connection-url>jdbc:oracle:thin:@//[databaseServer]:[servicePort]/
[serviceName]</connection-url>
<driver>ORACLE</driver>
<transaction-isolation>TRANSACTION_READ_COMMITTED</transactionisolation>
<security>
<user-name>[schemaUser]</user-name>
<password>[schemaUserPassword]</password>
</security>
<validation>
<validate-on-match>false</validate-on-match>
<background-validation>false</background-validation>
</validation>
<statement>
<share-prepared-statements>false</share-prepared-statements>
</statement>
</datasource>
Estas lneas deben ser agregadas en elemento <datasources> de la seccin <subsystem
xmlns="urn:jboss:domain:datasources:1.1">.
Asigne los valores correctos para los siguientes:
[databaseServer]: El nombre o IP del servidor de Base de datos de la instancia Oracle.
[servicePort]: El nmero del puerto bajo el cual el servicio atiende.
[serviceName]: El ID de la instancia del servicio.
361
[schemaUser]: El nombre del esquema de usuario en Oracle, que representa el proyecto de Bizagi.
[schemaUserPassword]: La contrasea para ese esquema de usuario.
En este punto, el archivo standalone.xml se debe ver as:
o Para SQL Server

Para incluir una fuente de datos especfica de SQL Server para su proyecto en JBoss, primero incluya
las siguientes lneas en el archivo standalone.xml:
<datasource jta="true" jndi-name="java:/BizAgiJava" pool-name="BizAgiJava"
enabled="true" use-ccm="true">
<connection-url>jdbc:sqlserver://[databaseServerInstance]:
[instancePort];databaseName=[SQLdatabase]</connection-url>
<driver>MICROSOFTSQLSERVER</driver>
<transaction-isolation>TRANSACTION_READ_COMMITTED</transactionisolation>
<security>
<user-name>[userLogin]</user-name>
<password>[userLoginPassword]</password>
</security>
<validation>
<validate-on-match>false</validate-on-match>
<background-validation>false</background-validation>
</validation>
<statement>
<share-prepared-statements>false</share-prepared-statements>
</statement>
</datasource>
Estas lneas deben ser agregadas en elemento <datasources> de la seccin <subsystem
362
xmlns="urn:jboss:domain:datasources:1.1">.
Asigne los valores correctos para los siguientes:
[databaseServerInstace]: El nombre o IP del servidor de Base de datos SQL Server, con el nombre de
la instancia si aplica.
[instancePort]: El nmero del puerto bajo el cual la instancia SQL Server atiende (por defecto es el
1433).
[SQLdatabase]: El nombre de la Base de datos que corresponde al proyecto de Bizagi.
[userLogin]: La cuenta login para acceder a la instancia de SQL Server.
[userLoginPassword]: La contrasea para la cuenta login.
En este punto, el archivo standalone.xml se debe ver as:

Para incluir el servicio de mensajera en JBoss, se necesitan varias adiciones.
Primero, incluya la siguiente lneaFirst include the following lines in the standalone.xml file:
<extension module="org.jboss.as.messaging"/>
Estas lnea deben ser agregada en el elemento <extensions>.
Esta parte del archivo standalone.xml se ver de la siguiente manera:
363
Seguidamente, incluya las siguientes lneas dentro de la seccin <subsystem

xmlns="urn:jboss:domain:ejb3:1.4">:
<mdb>
<resource-adapter-ref resource-adapter-name="hornetq-ra"/>
<bean-instance-pool-ref pool-name="mdb-strict-max-pool"/>
</mdb>
364
Para prevenir los potenciales errores, debemos agregar estas dos lneas al final del elemento as:
<default-security-domain value="BizAgiRealm"/>
<default-missing-method-permissions-deny-access value="false"/>
Luego, incluya estas lneas de registro del subsistema dentro del elemento <profile>:
<subsystem xmlns="urn:jboss:domain:messaging:1.4">
<hornetq-server>
<persistence-enabled>false</persistence-enabled>
<security-enabled>false</security-enabled>
<journal-type>NIO</journal-type>
<journal-file-size>102400</journal-file-size>
<journal-min-files>2</journal-min-files>
<connectors>
<netty-connector name="netty" socket-binding="messaging"/
>
<netty-connector name="netty-throughput" socket-
365
binding="messaging-throughput">
</netty-connector>
<in-vm-connector name="in-vm" server-id="0"/>
</connectors>
<acceptors>
<acceptor name="stomp-acceptor">
<factoryclass>org.hornetq.core.remoting.impl.netty.NettyAcceptorFactory</factoryclass>
<param key="protocol" value="stomp"/>
<param key="port" value="61613"/>
</acceptor>
<netty-acceptor name="netty" socket-binding="messaging"/
>
<netty-acceptor name="netty-throughput" socketbinding="messaging-throughput">
<param key="direct-deliver" value="false"/>
</netty-acceptor>
<in-vm-acceptor name="in-vm" server-id="0"/>
</acceptors>
<security-settings>
<security-setting match="#">
<permission type="send" roles="guest"/>
<permission type="consume" roles="guest"/>
<permission type="createNonDurableQueue"
roles="guest"/>
<permission type="deleteNonDurableQueue"
roles="guest"/>
</security-setting>
</security-settings>
<address-settings>
<address-setting match="#">
<dead-letter-address>jms.queue.DLQ</dead-letteraddress>
<expiry-address>jms.queue.ExpiryQueue</expiryaddress>
<redelivery-delay>0</redelivery-delay>
<max-size-bytes>10485760</max-size-bytes>
<address-full-policy>BLOCK</address-full-policy>
<message-counter-history-day-limit>10</messagecounter-history-day-limit>
</address-setting>
</address-settings>
<jms-connection-factories>
<connection-factory name="InVmConnectionFactory">
<connectors>
</connectors>
<entries>
<entry name="java:/ConnectionFactory"/>
</entries>
366
<connection-factory name="RemoteConnectionFactory">
<connectors>
</connectors>
<entries>
<entry name="RemoteConnectionFactory"/>
</entries>
<connection-factory name="AsyncControllerFactory">
<connectors>
</connectors>
<entries>
<entry name="/AsyncControllerFactory"/>
</entries>
<pooled-connection-factory name="hornetq-ra">
<transaction mode="xa"/>
<connectors>
</connectors>
<entries>
<entry name="java:/JmsXA"/>
</entries>
</pooled-connection-factory>
</jms-connection-factories>
<jms-destinations>
<jms-queue name="testQueue">
<entry name="queue/test"/>
</jms-queue>
<jms-queue name="AsyncController">
<entry name="jms/AsyncController"/>
</jms-queue>
<jms-topic name="testTopic">
<entry name="topic/test"/>
</jms-topic>
</jms-destinations>
</hornetq-server>
</subsystem>
367
368
Finalmente, incluya las siguientes lneas dentro del elemento <socket-binding-group>:

<socket-binding name="messaging" port="5445"/>
<socket-binding name="messaging-throughput" port="5455"/>
En este punto, el archivo standalone.xml se ver de la siguiente manera:
3.5 Parmetros de transaccin (JTA)

Para incluir el la configuracin del Java Transaction API (JTA) en JBoss, incluya las siguientes lneas en el
archivo standalone.xml:
<system-properties>
<property name="com.arjuna.ats.arjuna.allowMultipleLastResources"
value="true"/>
</system-properties>
Estas lneas deben ser agregadas en el elemento <extensions>.
Guarde los cambios.
369
3.6 Compresin HTTP

Como caracterstca adicional, usted podr elegir habilitar el uso de la compresin HTTP para
contenido esttico y dinmico del portal de Bizagi.
De esta manera, se optimizan los recursos al mejorar el desempeo y el rendimiento en el cargue y
visualizacin del portal. Esto es especialmente til para los dispositivos mviles.
Para hacer uso esta opcin, ubique las mismas propiedades de sistema (<system-properties>) en
el archivo standalone.xml, modificadas anteriormente.
Asegrese de incluir estas propiedades:
<property name="org.apache.coyote.http11.Http11Protocol.COMPRESSION"
value="on"/>
<property
name="org.apache.coyote.http11.Http11Protocol.COMPRESSION_MIME_TYPES"
value="text/javascript,text/css,text/html,text/xml,text/json"/>
370
Hemos terminado la edicin del archivo standalone.xml.
4. Crear el Usuario Administrador de JBoss

JBoss necesita un usuario para administrar la consola y ejecutar Bizagi. La creacin de este usuario es
obligatoria y el procedimiento para crearlo, se explica a continuacin.
Localice la carpeta <JBOSS_HOME>/bin y ejecute el archivo add-user.
En Linux, ejecute add-user.sh en el smbolo del sistema:
add-user.sh
En Windows, ejecute add-user.bat en el smbolo del sistema:
add-user.bat
Escoja el tipo de usuario a agregar, como estamos creando un usuario administrador, se debe
seleccionar Management User. Para hace esto, digite 'a'.
371
Cree las credenciales para el usuario, estas deben ser las siguientes
Username: bizagi
Password: password1!
El usuario no puede ser cambiado, use las credenciales presentadas.

Se debe incluir el smbolo de exclamacin en la contrasea, use minsculas para el nombre de
usuario y la contrasea.
Para el siguiente paso, presione Enter cuando se le pregunte por los grupos donde ser agregado
el usuario.
Digite 'y' para las dos opciones posteriores para finalizar el proceso.
372
Qu sigue?
Despus de estos pasos, su instalacin de JBoss est configurada para albergar Procesos Bizagi!
Puede ahora iniciar su servidor lo que generar sus procesos de Bizagi el Portal de Trabajo (un
despliegue de aplicacin).
Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia JBoss.
Tenga en cuenta que si su proyecto utiliza Replicacin o Virtualizacin (como mtodos de integracin
en la solucin Bizagi), entonces para su ambiente de produccin deber configurar la Replicacin o
Virtualizacin directamente en el Servidor de Aplicaciones JEE.
Para ms informacin sobre esta opcin, consulte Cmo configurar Replicacin o Virtualizacin en un
Configuracin de la arquitectura del sistema
Introduccin
Bizagi Engine cuenta con una arquitectura la cual ofrece los componentes necesarios para instalar la
solucin en una arquitectura de alta disponibilidad o una arquitectura estndar.
Al ejecutar sus procesos en una plataforma JEE, considere los siguientes aspectos en su arquitectura
de sistema.
Servidor de Base de datos (capa de acceso de datos).

En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se
recomienda configurar ms de un nodo para la Base de datos, de manera que se cuente con
tolerancia a fallos.
Las posibilidad de la tolerancia a fallos y su configuracin (p.e, tener un esquema activo-pasivo) es
provista por los diferentes motores de Base de datos.
Servidor BPM Bizagi (capa BPM).
En aplicaciones de misin crtica y para un esquema de alta disponibilidad de la solucin, se
recomienda configurar ms de un nodo para el Servidor BPM, de manera que se cuente con
capacidades de balanceo de cargas.
Para configurar los componentes de Bizagi en el Servidor BPM, configure su Servidor de Aplicaciones
JEE de acuerdo a Configurar un Servidor de Aplicaciones JEE para trabajar con Bizagi.
Balanceador de cargas (capa BPM).
Para el balanceo de cargas, Bizagi soporta tanto balanceadores en hardware o software, y se
recomienda el uso de un balanceador de cargas por hardware (p.e F5).
Bizagi no provee como tal el balanceador de cargas.
Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin se
realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas (sticky
sessions).
Para ver un ejemplo sobre la configuracin del balanceador de cargas, consulte Configuracin de
balanceo de cargas, donde se utiliza un Apache HTTP Server para ilustrar la funcionalidad en la
arquitectura descrita.
373
Tenga en cuenta que adems de lo anterior, tambin puede utilizar un servidor Web como proxy
inverso, para configurar Bizagi de manera que se acceda tambin desde Internet de una manera
segura.
El proxy inverso se configura en la DMZ y puede configurase tambin a travs de una instalacin de
Apache HTTP server, como se describe en Configurar Bizagi para acceso seguro a Internet.
Si su proyecto integra fuentes de datos externas a travs de la Virtualizacin o Replicacin de datos

de Bizagi, deber configurar estas fuentes de datos externas en el servidor de aplicaciones, como
se describe en Configuracin de Replicacin o Virtualizacin.
Configuracin del balanceo de cargas
Introduccin
En aplicaciones de misin crtica y para una arquitectura de alta disponibilidad de Bizagi Engine, se
recomienda el uso de un clster para el servidor BPM (ms de un nodo para el servidor de aplicacin,
de manera que se cuente con capacidades de balanceo de cargas).
Bizagi soporta la configuracin de balanceo de cargas a travs de las capacidades del sistema
operativo (p.e Network Load Balancing en Sistemas operativos Windows Server).
Es decir, Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el uso de un
balanceador de cargas por hardware (p.e F5).
374
A continuacin presentamos los lineamientos para la configuracin del balanceo de cargas en la

edicin Bizagi JEE y con el uso de un Servidor de Aplicaciones JEE, en donde se utilizar como ejemplo
Apache HTTP Server.
Tenga en cuenta que Apache HTTP Server cuenta con un mdulo que se encarga de balancear cargas.
Prerrequisitos
Se debe cumplir con los siguientes prerrequisitos:
1. Tener instalado el balanceador de cargas.
2. Tener Bizagi configurado en clster.
Los enlaces de gua sobre cmo configurar la solucin Bizagi en un esquema de clster, se encuentran
segn el Servidor de Aplicaciones JEE que se emplee (WebSphere, Weblogic o JBoss) en Configurar el
Lo que debe hacerse

Para configurar el balanceo de cargas en Bizagi, lleve a cabo lo siguiente:
1. Configurar el balanceador para que contemple los mltiples nodos del clster.
2. Configurar el Servidor de Aplicaciones para soportar el balanceo.
Ejemplos
Para ms informacin y ejemplo puntual a travs del uso de Apache HTTP Server, consulte los enlaces
a continuacin:
Balanceo de cargas con WebSphere (ejemplo).
Balanceo de cargas con Weblogic (ejemplo).
Balanceo de cargas con WebSphere
La siguiente seccin ilustra un ejemplo donde se configura balanceo de cargas para el Servidor BPM
de Bizagi.
Este ejemplo aplica para la edicin Enterprise JEE donde se utiliza configuracin de WebSphere en
clster y el balanceo de cargas a travs de los mdulos de Apache HTTP Server.
Por lo tanto y antes de continuar, asegrese de haber configurado su clster de WebSphere como se
describe en Configuracin de WebSphere en clster.
Tenga en cuenta que Bizagi soporta tanto balanceadores en hardware o software, y se recomienda el
uso de un balanceador de cargas por hardware (p.e F5). Para ms informacin sobre las directrices
del balanceo de cargas, consulte Configurar el balanceo de cargas.
Ejemplo
Para ilustrar la configuracin de un balanceo de cargas, en esta seccin se describen los cambios que
375
se deben realizar utilizando los servicios de Apache HTTP Server.

Por lo tanto, en el siguiente ejemplo se parte del uso de un servidor Web con una instancia de Apache
HTTP Server.
La descarga de este servidor se puede hacer directamente desde la pgina oficial de Apache HTTP
Server donde se selecciona la ltima versin disponible de acuerdo a su plataforma.
En este ejemplo, se toma la versin 2.2 de Apache (httpd-2.2).
La ruta donde se instala Apache HTTP Server ser referenciada a partir de este momento como
<APACHE_HOME>.
Configurar el balanceador para que contemple los mltiples nodos del clster.
En nuestro ejemplo que utiliza Apache HTTP Server y WebSphere, se especifica que nodos hacen parte
de la solucin al editar el archivo de configuracin <APACHE_HOME>\conf\httpd.conf
Para ello, asegrese de tener habilitados los mdulos requeridos como se describe a continuacin.
Incluya las siguientes lneas (o revise que estn habilitadas y no comentareadas).
Para el manejo de balanceo de cargas:
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule headers_module modules/mod_headers.so
Adicione las siguientes lneas dentro de la definicin del VirtualHost:
ProxyRequests OFF
376
ServerName [Servidor_Balanceador]:80
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/"
env=BALANCER_ROUTE_CHANGED
<Proxy balancer://[Nombre_cluster]>
BalancerMember http://[Nombre_Nodo1]:[Puerto1] route=1
BalancerMember http://[Nombre_Nodo2]:[Puerto2] route=2
Order Deny,Allow
Deny from none
Allow from all
ProxySet lbmethod=byrequests
ProxySet stickysession=ROUTEID
</Proxy>
<Location /balancer-manager>
SetHandler balancer-manager
Order deny,allow
Allow from localhost
</Location>
ProxyPass /balancer-manager !
ProxyPass /BizAgi-war/ balancer://[Nombre_cluster]/BizAgi-war/
ProxyPassReverse /BizAgi-war/ http://[Nombre_Nodo1]:[Puerto1] route=1
ProxyPassReverse /BizAgi-war/ http://[Nombre_Nodo2]:[Puerto2] route=2
Considere:
[Servidor_Balanceador]: Nombre del servidor (o IP) que ejerce el balanceo (en este ejemplo
ser el servidor local que tiene instalado Apache).
[Nombre_cluster]: Nombre del servidor (o IP) que representa el clster.
[Nombre_Nodo1]: Nombre del servidor (o IP) donde se encuentra el Nodo1 que hace parte del
clster.
[Puerto1]: Nmero de puerto sobre el cual atiende el servicio del Nodo1.
[Nombre_Nodo2]: Nombre del servidor (o IP) donde se encuentra el Nodo2 que hace parte del
clster.
[Puerto2]: Nmero de puerto sobre el cual atiende el servicio del Nodo2.
Ntese que la lnea BalancerMember http://[Nombre_NodoN]:[PuertoN] route=N deber
agregarse para cada miembro del clster involucrado en el balanceo, al igual que la lnea
ProxyPassReverse /BizAgi-war/ http://[Nombre_NodoN]:[PuertoN] route=N.
En el siguiente ejemplo vemos que se tiene balanceo de cargas para 2 servidores: MyServer01 y
MyServer02 (por el puerto 9082 y 9083 respectivamente).
La definicin completa del VirtualHost en Apache de este ejemplo es:
<VirtualHost *:80>
ProxyRequests OFF
ServerName MyApacheServer:80
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/"
env=BALANCER_ROUTE_CHANGED
<Proxy balancer://WASCluster>
BalancerMember http://MyServer01:9082 route=1
BalancerMember http://MyServer02:9083 route=2
Order Deny,Allow
Deny from none
Allow from all
ProxySet lbmethod=byrequests
377
</Proxy>
<Location /balancer-manager>
SetHandler balancer-manager
Order deny,allow
Allow from localhost
</Location>
ProxyPass /balancer-manager !
ProxyPass /BizAgi-war/ balancer://WASCluster/BizAgi-war/
ProxyPassReverse /BizAgi-war/ http://MyServer01:9082/BizAgi-war/
ProxyPassReverse /BizAgi-war/ http://MyServer02:9083/BizAgi-war/
</VirtualHost>
Bizagi soporta cualquier algoritmo que se configure para el balanceo de cargas (esta configuracin
se realiza de manera independiente), y se requiere que se habilite el uso de sesiones pegajosas
(sticky sessions) como se observa en la lnea
Una vez haya editado la informacin, guarde los cambios y cierre el archivo.
Verificar la configuracin
Para revisar que el balanceador de Apache est operacional y que los nodos involucrados estn listos
para atender las peticiones, ingrese la siguiente URL en un navegador:
http://[Servidor_Balanceador]/balancer-manager
All se ver el status de los nodos:
Configurar el Servidor de Aplicaciones JEE para soportar el balanceo

Asegrese que el Servidor de Aplicaciones JEE soporte el balanceo de cargas en la aplicacin.
Esto puede implicar la instalacin de algunos plug-ins dependiendo del Servidor de Aplicaciones JEE y
su versin.
En este ejemplo de WebSphere usando Apache HTTP Server, realice lo siguiente:
Acceda a la Consola de administracin, y vaya a la seccin de Servidores (Servers) y expanda el item
378
de tipos de servidores (Server types).

D clic sobre Web servers y sobre el botn Nuevo (New) para registrar el servidor Web que balancea
las cargas.

o Select node: Seleccione el primer nodo de su clster.
o Server name: Ingrese un nombre para identificar el servidor.
Ingrese ApacheLoadBalancer.
o Type: Seleccione Apache HTTP Server de la lista desplegable.
En la seleccin de plantillas, puede dejar los valores por defecto y dar clic en Siguiente (Next).
En la siguiente ventana de definicin de ubicacin, ingrese la siguiente informacin:
o Port (Puerto): Ingrese el valor del puerto por el cual atiende el servidor Web que balancea cargas.
Para nuestro ejemplo con Apache HTTP Server, el puerto es 80.
o Plug-in installation location (Ubicacin de la ruta de instalacin del plug-in): Ingrese cualquier
ubicacin en disco para la instalacin del plug-in que no contenga espacios.
Puede aceptar la ruta por defecto.
o Application mapping to the Web server (Aplicacin que se mapea en el servidor Web): Seleccione
All de la lista desplegable.
379

Verifique en el resumen de la configuracin que la informacin sea la correcta y d clic en Finalizar
(Finish) .
De regreso en la lista de Web servers, marque la casilla del recientemente creado y d clic en el botn
de Generar plug-in (Generate plug-in).
Una vez se complete la accin, d clic sobre el botn de propagar los cambios (Propagate plug-in):
Con ello, esta configuracin aplicar a todos los nodos del clster.
Finalmente, asegrese de dar clic en Guardar (Save) para aplicar los cambios.
Balanceo de cargas con Weblogic
La siguiente seccin
de Bizagi.
Este ejemplo aplica
clster y el balanceo
Por lo tanto y antes
ilustra un ejemplo donde se configura balanceo de cargas para el Servidor BPM

para la edicin Enterprise JEE donde se utiliza configuracin de Weblogic en
de cargas a travs de los mdulos de Apache HTTP Server.
de continuar, asegrese de haber configurado su clster de Weblogic como se
380
describe en Configuracin de Weblogic en clster.
Ejemplo
HTTP Server.
La descarga de este servidor se puede hacer directamente desde la pgina oficial de Apache HTTP
Server donde se selecciona la ltima versin disponible de acuerdo a su plataforma.
<APACHE_HOME>.
En nuestro ejemplo que utiliza Apache HTTP Server y Weblogic, se especifica que nodos hacen parte
de la solucin al editar el archivo de configuracin <APACHE_HOME>\conf\httpd.conf
Al editar este archivo, habilite el servicio incluyendo:
Listen [Nombre_Servidor_Balanceador]:[Puerto]
381
Asegrese tambin de habilitar los mdulos necesarios de la siguiente manera:

LoadModule weblogic_module modules/mod_wl[cifrado]_[version].so
<IfModule mod_weblogic.c>
WebLogicCluster [Nodo1:Puerto1], [Nodo2:Puerto2]
MatchExpression /*
</IfModule>
<Location /weblogic>
SetHandler weblogic-handler
WebLogicCluster [Nodo1:Puerto1], [Nodo2:Puerto2]
PathTrim /weblogic
</Location>
Para lo anterior, considere:
[Nombre_Servidor_Balanceador]: El nombre del servidor local el cul ejerce el balanceo de cargas.
[Puerto]: El nmero de puerto bajo el cual el balanceador atiende las peticiones.
[Nodo1] : El nombre del servidor (o IP) en donde est el servicio del Nodo1.
[Puerto1] : El nmero de puerto bajo el cual el Nodo1 atiende las peticiones.
[version]: Ingrese 20 o 22, segn la versin de Apache HTTP Server que est utilizando (versin 2.0.x
o 2.2.x respectivamente.
[cifrado]: El nmero de bits cifrado que se usa en la transferencia de manera opcional.
Puede dejar el valor vaco en cuyo caso un ejemplo de esta informacin sera:
LoadModule weblogic_module modules/mod_wl_22.so
Ntese que para cada nodo adicional que se tenga en la instalacin del clster de Weblogic, deber
tener repetidas occurrencias de:
,[NodoN:PuertoN]
(sticky sessions).
Configurar el Servidor de Aplicaciones JEE para soportar el balanceo

Asegrese que el Servidor de Aplicaciones JEE soporte el balanceo de cargas en la aplicacin.
Esto puede implicar la instalacin de algunos plug-ins dependiendo del Servidor de Aplicaciones JEE y
su versin.
En este ejemplo de Weblogic usando Apache HTTP Server, realice lo siguiente:
1. Verifique la versin de Weblogic que tiene instalada.
Para las versiones de Weblogic 11g, en la ruta <WEBLOGIC_HOME>\wlserver_10.3\server
\plugin\ encontrar los archivos necesarios que se deben incorporar a manera de plugins para la
compatibilidad con el mdulo de balanceo de Apache HTTP Server.
382
2. Copie el archivo plugin hacia la ruta de instalacin del Apache HTTP Server en <APACHE_HOME>
\modules.
Tenga presente que deber considerar el plugin apropiado de acuerdo al sistema operativo y
plataforma de Weblogic.
Estos plugins estn dentro de una estructura referente al sistema operativo.
Los plugins son nombrados de la siguiente manera: mod_wl[cifrado]_[version].so
Donde:
[version]: Define la versin de Apache con la que es compatible (p.e. version 2.0.x o 2.2.x).
[cifrado]: Define si utiliza una transferencia de datos con un nmero de bits cifrado (p.e. 128).
Puede tomar los plugins que no tienen este detalle (p.e mod_wl_22.so).
Finalizada esta configuracin, se recomienda reiniciar el servicio de Apache HTTP Server.
Balanceo de cargas con JBoss
La siguiente seccin ilustra un ejemplo donde se configura balanceo de cargas para el Servidor BPM
de Bizagi.
Este ejemplo aplica para la edicin Enterprise JEE donde se utiliza configuracin de JBoss en clster y
el balanceo de cargas a travs de los mdulos de Apache HTTP Server.
Por lo tanto y antes de continuar, asegrese de haber configurado su clster de JBoss como se
describe en Configuracin de JBoss en clster.
Ejemplo
HTTP Server.
Para JBoss, la descarga de este servidor se puede hacerla directamente desde la pgina oficial de
Apache HTTP Server, y seleccionar la inclusin del mdulo mod_cluster-1.2.0 module para versiones de
Apache 2.2.x.
En una instalacin de Apache sobre un sistema operativo Windows, descargue y utilice el

mod_cluster-1.2.0.Final-windows-x86-ssl.zip, como aparece disponible desde el sitio oficial de
383
Apache HTTP Server.

Con esto tendr el servidor instalado con los mdulos necesarios para JBoss.
<APACHE_HOME>.
Una vez instalado Apache, podr asegurarse de que el mdulo de configuracin se encuentre iniciado,
utilizando el ejecutable ubicado como :
<APACHE_HOME>\bin\installconf
En nuestro ejemplo que utiliza Apache HTTP Server y JBoss, se especifica que nodos hacen parte de la
solucin al editar el archivo de configuracin <APACHE_HOME>\conf\httpd.conf
Al editar este archivo, habilite los mdulos necesarios habilitando las siguientes lneas:
LoadModule slotmem_module
modules/mod_slotmem.so
LoadModule manager_module
modules/mod_manager.so
LoadModule proxy_cluster_module modules/mod_proxy_cluster.so
LoadModule advertise_module
modules/mod_advertise.so
Incluya las siguientes definiciones para el balanceo de cargas entre sus nodos:
<IfModule manager_module>
Listen [Servidor_Balanceador]:[Puerto]
ManagerBalancerName mycluster
<VirtualHost [Nodo_Maestro]:[Puerto_Nodo_Maestro]>
<Location />
384
Order deny,allow
Deny from all
Allow from 127.0.0.1
Allow from [Nodo1]:[Puerto1]
</Location>
KeepAliveTimeout 300
MaxKeepAliveRequests 0
AdvertiseFrequency 5
ServerAdvertise On
AdvertiseGroup 224.0.1.105:23364
AllowDisplay On
EnableMCPMReceive
<Location /mod_cluster_manager>
SetHandler mod_cluster-manager
Order deny,allow
Deny from all
Allow from 127.0.0.1
</Location>
</VirtualHost>
</IfModule>
Considere:
[Servidor_Balanceador]: El nombre/IP del servidor local el cul ejerce el balanceo de cargas.
[Puerto]: El nmero de puerto bajo el cual el balanceador atiende las peticiones.
[Nodo_Maestro]: El nombre/IP del nodo maestro.
Usualmente corresponder a la IP del servicio de alguno de los nodos.
[Puerto_Nodo_Maestro]: El nmero de puerto bajo el cual el nodo maestro atiende las peticiones.
Usualmente corresponder al puerto del servicio de alguno de los nodos.
Ntese que para cada nodo adicional del clster de JBoss, usted podr incluir ocurrencias adicionales
de:
Allow from [NodoN]:[PuertoN]
(sticky sessions).
385
Asegrese que sus nodos de JBoss referencien la IP del balanceador dentro de la configuracin del
subsistema modcluster (del perfil llamado HA profile).
Para ello, revise la siguiente configuracin dentro del archivo domain.xml de cada nodo:
<subsystem xmlns="urn:jboss:domain:modcluster:1.1">
<mod-cluster-config advertise-socket="modcluster" proxy-list="[Servidor_Balanceador]:[Puerto]"
balancer="mycluster" connector="ajp">
<dynamic-load-provider>
<load-metric type="busyness"/>
</dynamic-load-provider>
</mod-cluster-config>
</subsystem>
Una vez finalizada la configuracin, podr iniciar el servicio y revisar que los nodos de su clster se
visualicen correctamente desde el siguiente mdulo accedido por un navegador:
http://[Balancer_Server]:[Port]/mod_cluster-manager
386
Configuracin de Replicacin y Virtualizacin
Resumen
Cuando se realiza el despliegue de su proceso al ambiente de Pruebas o Produccin y se usa
Replicacin o Virtualizacin de datos en Bizagi, usted necesitar configurar la conexin a cada fuente
externa de datos integrada.
Para realizar esto, tenga en cuenta que necesitar usar las mismas propiedades que fueron
previamente configuradas en Bizagi Studio durante las etapas de automatizacin de su proyecto.
Usted necesitar usar las propiedades de su proveedor de datos.
Para encontrar estas propiedades, vaya a la vista de Mdulos y seleccione Sistemas, expanda el
sistema externo que haya configurado y despus expanda Proveedores. Haga clic derecho y
seleccione Propiedades.
Una vez se muestre la ventana de Propiedades, dirjase a la pestaa de acuerdo al ambiente que
desea configurar.
387
Con estos datos, siga la configuracin detalla en las siguientes secciones (de acuerdo a su Servidor de
Aplicaciones JEE)
Configuracin de Replicacin o Virtualizacin en JBoss
Resumen
El procedimiento presentado en esta seccin, explica cmo configurar las fuentes de datos externas in
un servidor de Aplicaciones JEE para ambientes de Bizagi de Pruebas o Produccin.
Esto solo es requerido si su proyecto de Bizagi usa caractersticas de Virtualizacin o Replicacin de
datos.
Este paso no es requerido en el ambiente de Desarrollo de su proyecto de Bizagi, debido a que Bizagi
configura automticamente la integracin de las fuentes de datos en el servidor JBoss empaquetado.
Prerrequisitos
Antes de continuar, asegrese de que ya haya configurado su Servidor de Aplicaciones para trabajar
con Bizagi.
Para revisar este prerrequisito, consulte configuracin de JBoss para trabajar con Bizagi.
Tambin se requiere que se haya verificado y asegurado que la configuracin de Virtualizacin o
Replicacin funcione correctamente en el ambiente de desarrollo.
Qu se necesita hacer?
Para configurar la Virtualizacin o la Replicacin su Servidor de Aplicaciones JEE, necesita configurar la
fuente de datos. Esto se puede realizar: Configurando un archivo externo donde se establezcan todas
388
las conexiones o configurando la fuente de datos en el archivo standalone.xml.
Ejemplo
El siguiente ejemplo muestra cmo configurar la Virtualizacin y la Replicacin en un ambiente JBoss
de Produccin o Pruebas. En ambos, es necesario cambiar la URL de conexin de la fuente de datos
principal. Por lo tanto, abra el archivo standalone.xml localizado en la carpeta <JBOSS_HOME>/
standalone/configuration y busque la etiqueta <datasource jta="true" jndiname="java:/BizAgiJava"
pool-name="BizAgiJava"
enabled="true"
useccm="true">.
Configurando un archivo externo
Este paso requiere agregar una fuente externa donde cada conexin de base de datos sea
configurada. Para crear el archivo externo, use la plantilla bizagidriver_datasource_template.xml
localizada en la carpeta <BIZAGI_HOME>\BizagiConsoleManagerJEE\config\templates
\JDBC_Driver.
Elimine los comentarios en este archivo y llene los valores de las siguientes etiquetas por cada fuente
de datos:
providerName: nombre del proveedor configurado en Bizagi Studio.
dataSourceName: nombre de la fuente de datos.
mainDS: este atributo es opcional e indica si la fuente de datos es la principal (fuente de datos de
Bizagi), su valor por defecto es false.
containerManager: indica si las conexiones ser administradas por Bizagi (valor: false) o por el
contenedor (valor: true).
transactional: indica si esta fuente de datos es transaccional. Su valor por defecto es true.
customProperties: Esta etiqueta tendr la informacin para crear las conexiones. Esta etiqueta
389
contiene la siguiente estructura.

<entry>
<key xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xsi:type="xs:string">user</key>
<value xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:type="xs:string">[userLogin]</value>
</entry>
<entry>
xsi:type="xs:string">password</key>
xsi:type="xs:string">[userLoginPassword]</value>
</entry>
<entry>
xsi:type="xs:string">url</key>
xsi:type="xs:string">[connectionURL]</value>
</entry>
<entry>
xsi:type="xs:string">driverclass</key>
xsi:type="xs:string">[driverClass]</value>
</entry>
Edite las lneas anteriores de acuerdo con los siguientes valores:
[userLogin]: El usuario de la base de datos.
[userLoginPassword]: La contrasea del usuario de la base de datos.
[connectionURL]: La cadena de conexin a la fuente de datos externa.
[driverClass]: El driver de conexin de la fuente de datos externa.
Para bases de datos ORACLE:
El driver debe ser:
oracle.jdbc.driver.OracleDriver
La cadena de conexin debe ser:
jdbc:oracle:thin:@//[databaseServer]:[servicePort]/[serviceName]
Para bases de datos SQL Server:
El driver debe ser:
390
com.microsoft.sqlserver.jdbc.SQlServerDriver
jdbc:sqlserver://[databaseServerInstance]:
[instancePort];databaseName=[SQLdatabase]
En la cual:
[databaseServer]: El nombre del servidor de base de datos Oracle o el nombre de la base de datos
SQL Server y la instancia si es una instancia con nombre.
[servicePort]: El puerto por el que escucha la base de datos Oracle o SQL Server.
[serviceName]: El identificador del servicio de la instancia de la base de datos. (Para Oracle)
[SQLdatabase]: El nombre del proyecto de bizagi que corresponde al nombre de la base de datos.
(Para SQL Server)
Guarde el archivo en una ubicacin disponible y agregue la ruta completa a la etiqueta
<connection-url> en el archivo standalone.xml, Esta etiqueta ahora ser as:
<connection-url>jdbc:bizagi:mainDS=@url=[ExternalFile]</connection-url>
Al final de este paso, su archivo debe verse as:
391
392
Configurando la fuente de datos en el archivo standalone.xml

En este paso, todas las fuentes de datos son agregadas a la fuente "BizAgiJava", esta opcin crea una
sola cadena de conexin con cada proveedor (Principal y externos).
El valor de la etiqueta <connection-url>, debe ser reemplazado con la siguiente cadena de
conexin:
jdbc:bizagi:mainDS=BTDS#user@[userLogin]:password[userLoginPassword]:url@"[
connectionURL]":[driverClass]#:external={[prov1]:
[prov1ConMan]:user@[prov1user]:password@[prov1Password]:url@"[prov1connecti
onURL]":driverclass@[prov1DriverClass]};{[prov2]:
[prov2ConMan]:user@[prov2user]:password@[prov2Password]:url@"[prov2connecti
onURL]":driverclass@[prov2DriverClass]};...;{[provN]:
[prov1ConMan]:user@[provNuser]:password@[provNPassword]:url@"[provNconnecti
onURL]":driverclass@[provNDriverClass]}
Edite la cadena de conexin de acuerdo con los siguientes valores:
[userLogin]: El usuario de la base de datos.
[prov(1...N)]: El nombre del proveedor de la base de datos externa.
[prov(1..N)user]: El usuario de cada base de datos externa.
[userLoginPassword]: El usuario de esta base de datos.
[[prov(1..N)Password]: La contrasea de cada usuario de cada base datos externa.
[prov(1...N)ConMan]: Indica si las conexiones sern manejadas por Bizagi o por el contenedor.
Agregue BTDS (Bizagi Transactional Data Source) si la conexin ser manejada por Bizagi, de lo
contrario BNTDS (Bizagi Non Transactional Data Source).
[connectionURL]: La cadena de conexin de la fuente de datos principal.
[prov(1...N)connectionURL]: Las cadenas de conexin de las fuentes de datos externas.
[driverClass]: El driver registrado de la fuente de datos principal.
[prov(1...N)driverClass]: Los drivers registrados de las fuentes de datos externas.
Para bases de datos ORACLE:

El driver debe ser:
oracle.jdbc.driver.OracleDriver
jdbc:oracle:thin:@//[databaseServer]:[servicePort]/[serviceName]
Para bases de datos SQL Server:
El driver debe ser:
com.microsoft.sqlserver.jdbc.SQlServerDriver
jdbc:sqlserver://[databaseServerInstance]:
[instancePort];databaseName=[SQLdatabase]
En la cual:
393
[databaseServer]: El nombre del servidor de base de datos Oracle o el nombre de la base de datos
SQL Server y la instancia si es una instancia con nombre.
[servicePort]: El puerto por el que escucha la base de datos Oracle o SQL Server.
[serviceName]: El identificador del servicio de la instancia de la base de datos. (Para Oracle)
[SQLdatabase]: El nombre del proyecto de bizagi que corresponde al nombre de la base de datos.
(Para SQL Server)
Al final del proceso, la fuente de datos "BizAgiJava" debe verse as:
Al final de cualquiera de los procesos anteriores, el ultimo paso es cambiar el driver le la fuente de
datos "BizAgiJava". Reemplace la etiqueta <driver> con la siguiente lnea:
<driver>BIZAGI</driver>
Usando la propiedad JDataSource (aplica para Replicacin)
Si est usando Replicacin, tenga en cuenta que necesita especificar la propiedad JDataSource para el
proveedor a travs del modulo de Sistemas externos.
Esto se puede realizar directamente en la Consola de Administracin:
Observe que el valor de esta propiedad debe corresponder al nombre del [externalDS] en el archivo
editado previamente.
394
Despliegue a un Servidor de Aplicacin JEE
El Portal de Trabajo se genera en el Servidor JEE como el despliegue de la aplicacin, una vez que ya
se hayan completado estas tareas:
La implementacin de los Procesos actualizada en una Base de datos de pruebas o produccin.
Para ms informacin sobre cmo publicar la implementacin de los Procesos en un ambiente de
pruebas o de produccin, consulte el Deployment Avanzado.
La configuracin del Servidor de Aplicaciones JEE para trabajar con Bizagi (para el ambiente de
pruebas o produccin).
Para ms informacin sobre cmo configurar un Servidor de Aplicaciones JEE, consulte Configurar el
Servidor de Aplicacin JEE para trabajar con Bizagi.
Para ello, siga la configuracin detallada en las secciones a continuacin (de acuerdo al Servidor de
Aplicaciones JEE que se desea usar):
Despliegue hacia WebSphere.
Despliegue hacia Weblogic.
Despliegue hacia JBoss.
Despliegue hacia WebSphere
Introduccin
Esta seccin describe cmo generar el Portal de Trabajo para los Procesos de Bizagi en WebSphere
(haciendo un despliegue de la aplicacin JEE).
Lo siguiente aplica tanto para el despliegue de soluciones configuradas en clster (con ms de un
nodo de WebSphere) tanto como para soluciones en modo standalone (configuracin estndar).
Prerrequisitos
Asegrese de cumplir con:
Tener la Base de datos del ambiente de produccin (o de pruebas) con la publicacin de Procesos
desde el ambiente de desarrollo (a travs de la herramienta de Deployment Avanzado).
Tener WebSphere configurado para trabajar con Bizagi. WebSphere debe estar iniciado.
Para ms informacin, consulte la Configuracin de WebSphere
Tener acceso al archivo .ear distribuible que se encuentra en <PATH_CONFIGURATION_FILES>
\Bizagi\Bizagi-ear-Websphere.ear.
Ms informacin sobre esta ruta y archivo se referencia en la configuracin de WebSphere.
Tener instalada la Consola Bizagi JEE (Bizagi JEE Console). La ruta de la esta consola ser refenciada
como <JEECONSOLE_HOME> a partir de este momento.
Lo que debe hacer

Para desplegar la aplicacin debe:
1. Configurar la plantilla XML del proyecto.
2. Generar el archivo .EAR final.
3. Instalar el Portal de Trabajo.
395
Procedimiento
Los siguientes pasos describen en detalle cmo hacer un despliegue de aplicacin hacia WebSphere.

Para la generacin del .EAR final, debe primero configurar un archivo XML con la informacin del
proyecto.
La plantila XML de esta configuracin la puede encontrar dentro de la ruta de la Consola Bizagi JEE,
ubicada como <JEECONSOLE_HOME>\ProjectTemplate.xml.
Por lo tanto, asegrese de copiar y pegar esta plantilla para crear una nueva para su proyecto.
Tenga en cuenta:
1. Las rutas se separan con el caracter slash ("/").
2. Este archivo XML de configuracin no debe contener lineas comentareadas.
Las lineas comentreadas slo sirven para proveer un ejemplo ilustrativo de las configuraciones
posibles.
3. Asegrese de renombrar el archivo XML de configuracin, de manera que se llame como su
proyecto (as mismo como se instanciar desde los comandos de la Consola administrativa JEE).
Para WebSphere, asegrese que su archivo de configuracin especifique el uso de WebSphere:
Si su proyecto utiliza un clster de base de datos, el cul es configurado por medio de un RAC de
Oracle (para base de datos Oracle), entonces deber asegurarse de asignar el valor de verdadero
(true) a la propiedad <isRac>, y de considerar la conexin a su RAC en las propiedades de
conexin.
2. Generar el archivo .EAR final
396
Una vez que tenga configurado el archivo XML de configuracin, ejecute el siguiente comando de
registro de proyecto a travs de la consola Bizagi JEE:
En Linux utilice:
sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh createproject -f
<CONFIG_PATH>
En Windows utilice:
<JEECONSOLE_HOME>\bin\JEEConsoleManager.bat createproject -f <CONFIG_PATH>
Considere que <CONFIG_PATH> es la ruta donde se encuentra el archivo de configuracin XML.
Ntese que este comando crear la siguiente ruta: <JEECONSOLE_HOME>\projects
\[NOMBRE_PROYECTO]
Una vez que este comando sea exitoso, ejecute el comando de pre-despliegue (predeploy) con la
misma consola Bizagi JEE:
En Linux utilice:
sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh predeploy -o <OUTPUT_PATH> -p
[PROJECT_NAME] -f <FILE_PATH>
En Windows utilice:
<JEECONSOLE_HOME>\bin\JEEConsoleManager.bat predeploy -o <OUTPUT_PATH> -p
Considere:
<OUTPUT_PATH> es la ruta opcional para especificar dnde se genera el archivo EAR. No utilice o si no desea incluir esta ruta (por defecto quedar como <JEECONSOLE_HOME>\projects
\[NOMBRE_PROYECTO]\dist\BizAgi-ear-WebSphere.ear).
[PROJECT_NAME] es el nombre el proyecto tal como se especific en el archivo XML de
configuracin en <CONFIG_PATH>. El uso de -p con el nombre del proyecto es obligatorio.
<FILE_PATH> es la ruta opcional de donde se toma el archivo de distribucin .EAR (se debe
referenciar para la generacin de la aplicacion final). No utilice -f si no desea incluir esta ruta. Al
no especificar la ruta, se tomar la ruta especificada en el archivo de configuracin
projectemplate.xml.
Si su configuracin de WebSphere utiliza ms de un nodo (configuracin en clster), deber utilizar c para especificar el modo clster.De lo contrario, la ausencia de este parmetro indicar que es un
despliegue a un servicio standalone.
Puede encontrar ms detalle tcnico sobre la Consola (Bizagi JEE Console) en su archivo local
Readme-console.txt file.
Consideracin en ambientes de desarrollo

Si usted utiliza WebSphere en su ambiente de Desarrollo (en vez del JBoss que viene embebido con
Bizagi Studio), entonces hay escenarios donde puede optar por refrescar la informacin en cach en
vez de volver a generar la aplicacin.
397
Para ello, existe el comando cleancache de la consola de JEE para refrescar cambios sencillos,
nicamente cuando el modelo de datos no haya sido modificado. Por ejemplo para cambios sencillos
de reglas o en las formas.
Este comando se utiliza de la siguiente manera:
cleancache -p [NOMBRE_PROYECTO] -host [SERVIDOR] -port [PUERTO]
NOMBRE_PROYECTO: Es el nombre del proyecto. Su definicin debe ir con el parmetro -p.
SERVIDOR: Es el nombre o la direccin IP del servidor en el cual se quiere limpiar el cache interno
de Bizagi. Su definicin debe ir con el parmetro -host.
PUERTO: Es el puerto sobre el cual atiende el Servidor de Aplicaciones. Su definicin debe ir con el
parmetro -port.
3. Instalar el Portal de Trabajo

Los pasos requeridos para la instalacin del Portal de Trabajo difieren ligeramente si su Servidor de
Aplicaciones WebSphere
est configurado para utilizar ms nodo (configuracin de clster).
Siga los pasos de la seccin Instalacin para clster o de la seccin Instalacin en modo
standalone, segn su configuracin.
Instalacin para clster

1. Ingrese a la consola de administracin de WebSphere, y utilice el panel a la izquierda para ir a la
opcin: Applications Application Types WebSphere enterprise applications.
D clic en Instalar (Install).
2. Utilice la opcin de Preparacin (Preparing for the application installation option) para ubicar el
archivo .ear final (el BizAgi-ear-WebSphere.ear generado) que se instala y luego d clic en Siguiente
(Next).
3. Digite la opcin Fast Path para la seleccin de la instalacin y d clic en Siguiente (Next).
4. Asegurese de marcar la casilla de desplegar los servicios Web (Deploy Web services) en las
opciones de instalar la aplicacin (Install New Application / Select installation).
Los otros parmetros de configuracin podrn ser modificados a criterio del administrador del
398
Servidor de aplicaciones.
Sin embargo, puede dejar los valores por defecto y dar clic en Siguiente (Next).
5. Verifique que se tenga asignado el valor All security domains en la lista de Display clusters
and servers in the following security domain.
En la lista de clsters y servidores (Clusters and servers), asegrese de incluir tanto los nodos que
hacen parte del clster, como tambin el servidor Web donde se ejerce el balanceo de cargas.
Marque las casillas de todos los mdulos listados en la tabla y d clic sobre el botn de Aplicar
(Apply).
399

6. Revise los parmetros del proceso de instalacin en la ventana de resumen (Summary), y d clic en
Finalizar (Finish).
7. Una vez que se haya instalado la aplicacin, d clic en Guardar (Save) para aplicar los cambios.
8. Seleccione la aplicacin instalada haciendo clic sobre ella (Bizagi-ear).
400
Haga clic sobre la opcin de administracin de la sesin (Session management) ubicada bajo la
seccin Web Module properties.
Ubique las propiedades adicionales (Additional properties) y d clic sobre la opcin de configuracin
de un ambiente distribuido (Distributed environment settings). En ella, d clic sobre la opcin
Memory-to-memory replication y configure para la aplicacin lo siguiente:
Replication domain: Seleccione su clster de WebSphere.
Replication mode: Seleccione Both client and server.
D clic en Ok.
9. De regreso en el listado de aplicaciones instaladas, marque la casilla de la aplicacin (Bizagi-ear) y
utilice el botn de Iniciar (Start ) para cargar sus componentes e iniciar el Portal de Trabajo.
401
10. Asegrese de propagar los cambios en todos los nodos de la configuracin de su clster.
Para ello, d clic sobre la opcin Update global Web server plug-in configuration en la seccin de
entorno (Environment).
Para verificar que el Portal de Trabajo se instal correctamente, ingrese la siguiente direccin URL en
un navegador (tenga en cuenta que estas direcciones son sensibles a maysculas):
http://[Servidor_Balanceador]:[Puerto]/BizAgi-war/
Instalacin en modo standalone (configuracin estndar de WebSphere)

1. Ingrese a la consola de administracin de WebSphere, y utilice el panel a la izquierda para ir a la
opcin: Applications Application Types WebSphere enterprise applications.
D clic en Instalar (Install).
2. Utilice la opcin de Preparacin (Preparing for the application installation option) para ubicar el
archivo .ear final (el BizAgi-ear-WebSphere.ear generado) que se instala y luego d clic en Siguiente
(Next).
3. Digite la opcin Fast Path para la seleccin de la instalacin y d clic en Siguiente (Next).
4. Ensure you mark the Deploy Web services checkbox in the Install New Application / Select
installation options.
The other configuration may be modified depending on the Application Server's administrator criteria,
but you may leave the defaults and click Next.
402
5. D clic en Siguiente (Next) en la opcin: Map modules to servers.

6. D clic en Siguiente (Next) en la opcin: Map virtual hosts for Web modules.
7. Revise los parmetros del proceso de instalacin en la ventana de resumen (Summary), y d clic en
Finalizar (Finish).
8. Una vez que se haya instalado la aplicacin, d clic en Guardar (Save) para aplicar los cambios.
9. Seleccione la aplicacin instalada y utilice el botn de Iniciar (Start ) para cargar sus componentes e
iniciar el Portal de Trabajo.
403
Se recomienda reiniciar la aplicacin una vez que se hayan realizado cambios.

http://[Servidor]:[Puerto]/BizAgi-war/
Pasos adicionales
Si su proyecto se est configurando para un ambiente de pruebas o produccin y ste utiliza
Virtualizacin o Replicacin, deber registrar en su Servidor de Aplicaciones JEE, la fuente de datos
externa que se integra en la solucin.
Para ms informacin acerca de este paso, consulte cmo configurar la Replicacin o Virtualizacin en
la JEE.
Tambin puede optar por activar la funcionalidad del ODS de Bizagi para mejorar la disponibilidad y el
rendimiento de los Procesos. Para ms informacin sobre esta opcin, consulte Configuracin de ODS
para el anlisis de Procesos.
Despliegue hacia Weblogic
Introduccin
Esta seccin describe cmo generar el Portal de Trabajo para los Procesos de Bizagi en Weblogic
Lo siguiente aplica tanto para el despliegue de soluciones configuradas en clster (con ms de un
nodo de Weblogic) tanto como para soluciones en modo standalone (configuracin estndar).
404
Prerrequisitos
Tener Weblogic configurado para trabajar con Bizagi. Weblogic debe estar iniciado.
Para ms informacin, consulte la Configuracin Weblogic.
\Bizagi\Bizagi-ear-Weblogic.ear.
Ms informacin sobre esta ruta y archivo se referencia en la configuracin de Weblogic.
Lo que debe hacer

Procedimiento
Los siguientes pasos describen en detalle cmo hacer un despliegue de aplicacin hacia Weblogic.

proyecto.
llamada como ProjectTemplate.xml.
Tenga en cuenta:
Las lineas comentreadas slo sirven para proveer un ejemplo ilustrativo de las configuraciones
posibles.
Para Weblogic, asegrese que su archivo de configuracin especifique el uso de Weblogic:
405
conexin.

En Linux utilice:
<CONFIG_PATH>
En Windows utilice:
\[NOMBRE_PROYECTO]
En Linux utilice:
En Windows utilice:
Considere:
406
\[NOMBRE_PROYECTO]\dist\BizAgi-ear-Weblogic.ear).
projectemplate.xml.
Si su configuracin de Weblogic utiliza ms de un nodo (configuracin en clster), deber utilizar c para especificar el modo clster.De lo contrario, la ausencia de este parmetro indicar que es un
despliegue a un servicio standalone.
Consideracin en ambientes de desarrollo
Si usted utiliza Weblogic en su ambiente de Desarrollo (en vez del JBoss que viene embebido con
Bizagi Studio), entonces hay escenarios donde puede optar por refrescar la informacin en cach en
vez de volver a generar la aplicacin.
Para ello, existe el comando cleancache de la consola de JEE para refrescar cambios sencillos,
nicamente cuando el modelo de datos no haya sido modificado. Por ejemplo para cambios sencillos
de reglas o en las formas.
Este comando se utiliza de la siguiente manera:
cleancache -p [NOMBRE_PROYECTO] -host [SERVIDOR] -port [PUERTO]
NOMBRE_PROYECTO: Es el nombre del proyecto. Su definicin debe ir con el parmetro -p.
SERVIDOR: Es el nombre o la direccin IP del servidor en el cual se quiere limpiar el cache interno
de Bizagi. Su definicin debe ir con el parmetro -host.
PUERTO: Es el puerto sobre el cual atiende el Servidor de Aplicaciones. Su definicin debe ir con el
parmetro -port.

Los pasos requeridos para la instalacin del Portal de Trabajo siguientes aplican tanto para su
Servidor de Aplicaciones Weblogic configurado para utilizar ms de un nodo (configuracin de clster)
o para un Servidor configurado para ejecucin en modo standalone (sin balanceo de cargas).
La nica diferencia radica en el ltimo paso, donde se especifica el alcance y destino (Target) de la
aplicacin.
1. Acceda a la Consola de administracin y utilice el panel de navegacin a la izquierda para ubicar

rpidamente la seccin Domain Structure Deployments.
Tenga presente que si una versin anterior de la aplicacin de Bizagi ya estaba instalada, entonces
para actualizarla con la recientemente generada deber eliminar (a travs de Delete) la aplicacin
existente.
407
D clic sobre Instalar (Install).

2. Navegue hacia la ruta de <PATH_CONFIGURATION_FILES>, donde se encuentra el archivo EAR
generado de la aplicacin Weblogic.
Seleccione este archivo (Bizagi-ear-Weblogic.ear).
3. En la opcin de Choose targeting style option seleccione Instalar este despligue como una
aplicacin (Install this deployment as an application) y d clic en Siguiente (Next).
408
4. Si usted cuenta con una configuracin de Weblogic en clster, asegrese de marcar la casilla del
clster e incluir All servers in the cluster para aplicar la configuracin al clster (Select
Target) y d clic en Finalizar (Finish):
Si por el contrario, su configuracin de Weblogic es en modo standalone, d clic en Finalizar (Finish).

Se recomienda reiniciar la aplicacin una vez que se hayan realizado cambios.
http://localhost:7001/BizAgi-war/
Pasos adicionales
la JEE.
409
Despliegue hacia JBoss
Introduccin
Esta seccin describe cmo generar el Portal de Trabajo para los Procesos de Bizagi en JBoss
Prerrequisitos
Tener JBoss configurado para trabajar con Bizagi (su ruta ser referenciada en este documento
como <JBOSS_HOME>). JBoss debe estar iniciado.
Para ms informacin, consulte la Configuracin de JBoss.
\Bizagi\Bizagi-ear-JBoss.ear.
Ms informacin sobre esta ruta y archivo se referencia en la configuracin de JBoss.
Lo que debe hacer

Procedimiento
Los siguientes pasos describen en detalle cmo hacer un despliegue de aplicacin hacia WebSphere.
410

proyecto.
llamada como ProjectTemplate.xml.
Tenga en cuenta:
Las lineas comentareadas slo sirven para proveer un ejemplo ilustrativo de las configuraciones
posibles.
Para JBoss, asegrese que su archivo de configuracin especifique el uso de JBoss:
conexin.

En Linux utilice:
<CONFIG_PATH>
411
En Windows utilice:
\[NOMBRE_PROYECTO]
En Linux utilice:
En Windows utilice:
Considere:
\[NOMBRE_PROYECTO]\dist\BizAgi-ear-JBoss.ear).
projectemplate.xml.

El siguiente paso difiere si usted tiene JBoss instalado a modo standalone o si lo ha configurado en
clster.
Consulte el procedimiento para cada escenario, descrito en las siguientes secciones.
Para instalaciones JBoss standalone
JBoss permite que las aplicaciones Web se instalen simplemente compiando el EAR generado en la
carpeta de despliegue (carpeta deploy) del Servidor.
Esta carpeta se encuentra ubicada como: <JBOSS_HOME>/standalone/deployments
Por lo tanto, para este paso, slo copie el archivo EAR generado en esta carpeta.
Ntese que esto se puede realizar en caliente (cuando el servicio del Servidor est arriba), o tambin
412
cuando JBoss est detenido.

Sin embargo, se recomienda reiniciar la aplicacin una vez que se hayan realizado cambios.
Es posible editar el archivo run.conf para modificar los parmetros de memoria del Servidor.
Esto es especialmente til en caso de que el Servidor presente un error de memoria (permGen) al
hacer el despliegue de la aplicacin (dado que por defecto la asignacin de memoria en JBoss no
es amplia).
Para hacerlo, ubique el archivo <JBOSS_HOME>\bin\run.conf.bat (en Windows); o el archivo
<JBOSS_HOME>\bin\run.conf (en sistemas operativos Linux).
Edite,este archivo teniendo en cuenta:
Editar los parmetros de memoria inicial y memoria mxima para Linux agregando:
Xms512m Xmx1024m -XX:MaxPermSize=512m
debajo de la lnea que contiene: # Specify options to pass to the Java VM.
Editar los parmetros de memoria inicial y memoria mxima para Windows agregando:
set "JAVA_OPTS=-Xms512m -Xmx1024m -XX:MaxPermSize=512m"
debajo de la lnea que contiene: rem # JVM memory allocation pool parameters - modify as
appropriate.
Para instalaciones JBoss en clster
Cuando se utiliza una configuracin en clster de JBoss, lo ideal para realizar el despliegue de la
aplicacin de Bizagi es utilizar las opciones de administracin de dominio que provee JBoss mediate
interfaz grfica Web.
Para ello, siga estos pasos:
1. Haga login a las opciones de administracin del dominio, ingresando la siguiente URL en un
navegador de su eleccin:
http://[IP_Nodo_Maestro]:[9990]
Ntese que deber utilizar el usuario de administracin de el nodo maestro, tal como se cre en la
configuracin del clster JBoss.
Deber poder ver los nodos que hacer parte de su clster, listados como instancias.
413
2. Haga clic en la opcin de administrar deployments (Manage Deployments), ubicada debajo de los
tems de dominio (Domain).
Utilice el botn de adicionar (Add) para registrar un nuevo contenido de despliegue.
414
3. Ubique el archivo .ear generado (BizAgi-ear-JBoss.ear) y d clic en Siguiente (Next).

Para confirmar la configuracin d clic sobre Guardar (Save).
415
4. Una vez que se haya realizado esta accin, podr ver la aplicacin de Bizagi listada.
Utilice la opcin de adicionar a los grupos (Add to groups) para asegurarse que su grupo de servidor
est configurado adecuadamente en este dominio.
416
Ntese que el grupo de este ejemplo (tal como se defini en el archivo host.xml durante la
configuracin del clster), se llama main-server-group.
Asegrese de marcar este grupo, e igualmente marcar la casilla para habilitar este .ear (Enable BizAgiear-JBoss.ear ):
417
D clic en Guardar (Save).

5. Una vez desplegado, podr ver la aplicacin de Bizagi bajo los despliegues por grupo (group
deployments), con sus componentes internos.
418
Para verificar la instalacin de la aplicacin, ingrese la siguiente URL en su navegador (tenga en cuenta
que esta direccion es sensible a maysculas y minsculas):
Otras opciones
Cuando se utiliza una plataforma JBoss como aplicacin de los procesos de Bizagi, puede utilizar
opciones de la consola para iniciar o detener el servicio de JBoss.
Para detener el servicio utilice:
<JEECONSOLE_HOME>\bin\JEEConsoleManager.bat stopappserver -p
[NOMBRE_PROYECTO]
Para iniciar el servicio utilice:
<JEECONSOLE_HOME>\bin\JEEConsoleManager.bat startappserver -p
[NOMBRE_PROYECTO]
Pasos adicionales
419
la JEE.
Otras opciones de configuracin

Consulte las siguientes secciones de este captulo para ms informacin acerca de posibilidades en la
infraestructura y configuracin del sistema Bizagi.
Para ver un ejemplo sobre la configuracin de procesos Bizagi sobre un proveedor de servicios en
la nube, consulte Configuracin de Bizagi en Amazon AWS.
Para informacin sobre la configuracin de los procesos Bizagi para el acceso seguro desde
internet, consulte Configuracin de Bizagi para el acceso seguro desde intenet.
Configuracin de Bizagi en Amazon WS

Bizagi soporta ser configurado en instancias de los servicios de Amazon en la web (cuentas AWS), de
manera que los procesos de Bizagi estn disponibles en la nube.
Encuentre aqu una gua en ingls en PDF, escrita por Timothy Olsen y Richard Welke de la Universidad
de Georgia.
Este documento describe la instalacin del ambiente de una instancia de Amazon, y Bizagi para su
acceso en la nube.
Al tener una configuracin de este estilo sobre la nube, se recomienda llevar a cabo el deployment
de los processes a travs de la herramienta de Deployment Avanzado.
Y de esta manera, el deployment se realiza por medio de paquetes aplicados a produccin de una
manera offline.
Configuracin de Bizagi para el acceso seguro desde Internet
Introduccin
Esta seccin describe cmo configurar un Servidor HTTP para que sus procesos de Bizagi puedan ser
accedidos de manera segura desde internet.
Bizagi Engine soporta una configuracin para el acceso tanto desde la intranet como la extranet, con
las medidas de seguridad apropiadas donde se considera un proxy inverso.
A travs de esta guia se ilustra cmo configurar un Servidor HTTP Apache, con la posibilidad de utilizar
SSL, y activando el mdulo del proxy inverso de manera que desde cualquier dispositivo (porttiles,
telfonos inteligentes, tabletas) se acceda al Portal de trabajo de Bizagi.
420
Lo siguiente representa la arquitectura considerada:
1. Este servidor se monta para redirigir el acceso desde Internet hacia el servidor BPM de Bizagi con
protocolos seguros.
2. Los usuarios en la intranet continuarn accediendo el Portal de Trabajo de Bizagi de igual manera.
Utilizar el Servidor HTTP Apache

Para utilizar el Servidor HTTP Apache, instlelo en el Servidor dentro de la Zona desmilitarizada (DMZ)
y configrelo de acuerdo a como se indica en las secciones inferiores.
Instalar el Servidor HTTP Apache

Para instalar Apache, lleve a cabo estos pasos:
1. Descargue el instalador del Servidor HTTP Apache desde la pgina oficial.
2. Instale el Servidor. Ntese que los parmetros configurados al momento de la instalacin pueden
modificarse ms adelante. La ruta que se seleccione para instalar el Servidor ser referenciado en este
documento como <APACHE_HOME>.
421
Configuracin de seguridad
Para habilitar los mdulos avanzados de seguridad en Apache, los cuales incluyen el proxy inverso,
siga estos pasos:
1. Ubique el archivo de configuracin de Apache.
Realice esto, editando el archivo httpd.conf ubicado en la ruta <APACHE_HOME>\conf\.
Este archivo puede editarse en sistemas operativos Windows a travs de la opcin en Inicio ->
Programas -> Apache HTTP Server -> Configure Apache Server -> Editar el archivo de configuracin
httpd.conf.
422
2. Habilitar los mdulos requeridos.

Habilite los mdulos involucrados en la funcionalidad del proxy, removiendo el caracter "#" de las
siguientes lneas:
LoadModule
LoadModule
LoadModule
LoadModule
LoadModule
LoadModule
proxy_module modules/mod_proxy.so
proxy_ajp_module modules/mod_proxy_ajp.so
proxy_balancer_module modules/mod_proxy_balancer.so
proxy_connect_module modules/mod_proxy_connect.so
proxy_ftp_module modules/mod_proxy_ftp.so
proxy_http_module modules/mod_proxy_http.so
Si desea habilitar y utilizar el protocolo de Secure Socket Layer (SSL), remueva el caracter "#" de la
siguiente lnea:
LoadModule ssl_module modules/mod_ssl.so
423
Para ms informacin detallada sobre este mdulo de Apache, consulte la documentacin oficial.
En caso de habilitar y querer utilizar SSL, habilite el puerto del SSL incluyendo la siguiente lnea,
ubicado debajo de las opciones donde escucha el servicio (Listen).
Listen 443
Ntese que el puerto por defecto para el servicio es el por defecto del navegador (80), pero 8080
tambin es frecuentemente utilizado.
424
3. Configurar el proxy inverso.

Incluya la definicin de redireccin del proxy, segn si se utiliza SSL o no.
Si el Servidor HTTP Apache no utiliza un certificado digital y no se habilita el SSL, entonces incluya las
siguientes lneas al final del archivo:
<VirtualHost [APACHE_IP]:[APACHE_PORT]>
ServerName [BPM_SERVER]
# Proxy configuration
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /[SU_PROYECTO]/jquery http://[BPM_SERVER]/[SU_PROYECTO]/jquery
ProxyPass /[SU_PROYECTO]/Charts http://[BPM_SERVER]/[SU_PROYECTO]/Charts
ProxyPass /[SU_PROYECTO]/css http://[BPM_SERVER]/[SU_PROYECTO]/css
ProxyPass /[SU_PROYECTO]/img http://[BPM_SERVER]/[SU_PROYECTO]/img
ProxyPass /[SU_PROYECTO]/js http://[BPM_SERVER]/[SU_PROYECTO]/js
ProxyPass /[SU_PROYECTO]/Localization http://[BPM_SERVER]/[SU_PROYECTO]/
Localization
ProxyPass /[SU_PROYECTO] http://[BPM_SERVER]/[SU_PROYECTO]
ProxyPassReverse /[SU_PROYECTO] http://[BPM_SERVER]/[SU_PROYECTO]
</VirtualHost>
En estas lneas, considere reemplazar los valores correspondientes:
[APACHE_IP]: La direccin IP bajo la cual se accede al servicio de Apache.
[APACHE_PORT]: El puerto HTTP bajo el cual escucha el servicio de Apache.
[BPM_SERVER]: El servidor BPM que alberga su proyecto Bizagi.
[SU_PROYECTO]: El directorio virtual de su proyecto Bizagi.
Por ejemplo, si su proyecto de Bizagi se llama "MyProject" entonces se debe configurar el archivo
425
como se ilustra a continuacin (partiendo tambin de un Apache instalado en el puerto 80):
Por otro lado, si se configur el Servidor HTTP Apache para que utilice un certificado digital, por
medio de SSL, entonces es necesario configurar el host virtual incluyendo las siguientes lneas:
NameVirtualHost *:443
<VirtualHost *:443>
DocumentRoot "<APACHE_HOME>/htdocs"
ServerName [BPM_SERVER]
<Directory "<APACHE_HOME>/htdocs">
Options Indexes FollowSymLinks MultiViews
AllowOverride None
SSLRequireSSL
Order allow,deny
Allow from all
</Directory>
SSLProxyEngine on
ProxyRequests Off
ProxyPreserveHost On
ProxyPass /[SU_PROYECTO]/jquery http://[BPM_SERVER]/[SU_PROYECTO]/jquery
ProxyPass /[SU_PROYECTO]/Charts http://[BPM_SERVER]/[SU_PROYECTO]/Charts
426
ProxyPass /[SU_PROYECTO]/css http://[BPM_SERVER]/[SU_PROYECTO]/css

ProxyPass /[SU_PROYECTO]/img http://[BPM_SERVER]/[SU_PROYECTO]/img
ProxyPass /[SU_PROYECTO]/js http://[BPM_SERVER]/[SU_PROYECTO]/js
ProxyPass /[SU_PROYECTO]/Localization http://[BPM_SERVER]/[SU_PROYECTO]/
Localization
ProxyPass /[SU_PROYECTO] http://[BPM_SERVER]/[SU_PROYECTO]
ProxyPassReverse /[SU_PROYECTO] http://[BPM_SERVER]/[SU_PROYECTO]
SSLEngine on
SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:
+eNULL
SSLCertificateFile "<LOCAL_PATH>/public.crt"
SSLCertificateKeyFile "<LOCAL_PATH>/ApachePrivateKey.key"
SSLCertificateChainFile "<LOCAL_PATH>/intermediate.crt"
<FilesMatch "\.(cgi|shtml|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory "[BPM_SERVER]/cgi-bin">
SSLOptions +StdEnvVars
</Directory>
BrowserMatch ".*MSIE.*" \
nokeepalive ssl-unclean-shutdown \
downgrade-1.0 force-response-1.0
</VirtualHost>
En estas lneas, considere reemplazar los valores correspondientes para:

<APACHE_HOME>: La ruta de instalacin de Apache. Tenga en cuenta que el formato en este
archivo espera "/" (en vez de "\") como el caracter separador de carpeta.
<LOCAL_PATH>: La ruta donde se encuentran los archivos del certificado a usar por el SSL.
[APACHE_IP]: La direccin IP bajo la cual se accede al servicio de Apache.
[APACHE_PORT]: El puerto HTTP bajo el cual escucha el servicio de Apache.
[BPM_SERVER]: El servidor BPM que alberga su proyecto Bizagi.
[SU_PROYECTO]: El directorio virtual de su proyecto Bizagi.
Para ms informacin y documentacin sobre las directivas y parmetros de SSL, consulte este enlace
externo.
Guarde los cambios de este archivo y reinicie su Servidor HTTP Apache.
En este punto hemos terminado la configuracin para acceder Bizagi desde internet de una manera
segura, desde cualquier dispositivo!
Importante
En esta configuracin, es necesario que el portal de Bizagi permita la autenticacin annima.
Es decir, si se utiliza autenticacin integrada (p.e Windows) o tipo Bizagi, a nivel de servidor BPM
427
(especficamente en el IIS para la edicin .NET), se debe tener habilitada la autenticacin annima.
Punto de chequeo
Para verificar la configuracin, y acceder al servicio, digite en un navegador desde afuera de la
intranet:
http://[APACHE_IP]:[APACHE_PORT]/[SU_PROYECTO]
Con lo que esta solicitud se redirigir al Portal de Trabajo de Bizagi de manera segura.
Deployment de Procesos
Introduccin
Una vez que el ciclo de automatizacin se ha completado, Bizagi ofrece la posibilidad de publicar los
Procesos para su ejecucin y puesta en marcha.
El Deployment de Bizagi consiste en publicar la implementacin de los Procesos hacia un ambiente de
pruebas o produccin.
Bizagi BPM Suite promueve el gil manejo del mejoramiento continuo.

Nuevas versiones de proceso se pueden liberar fcilmente cuando se requiera por el negocio.
Ambientes en Bizagi
Un proyecto de Bizagi tiene varios ambientes. Un ambiente lo definimos como una aplicacin
independiente del proyecto, que cuenta con su propia Base de datos, Portal de Trabajo y servicio
Programador.
De cara al Deployment de Bizagi, se recomienda utilizar los 3 ambientes que se crean por defecto
(desarrollo, pruebas y produccin).
desarrollo: Es el ambiente de construccin e implementacin. Es el nico ambiente donde se
modelan e implementan los Procesos. Las fases de diseo y construccin hacen parte en l: se
define el modelo de datos, las formas, las reglas de negocio, interfaces y participantes, entre otros.
Es trabajado mediante Bizagi Studio.
pruebas: Este ambiente es usado para simular un ambiente de produccin. Mediante l, se llevan a
cabo pruebas de aceptacin de usuario en la funcionalidad de los Procesos (su certificacin). Los
Procesos que se lleven al ambiente de pruebas se pueden marcar como "Release Candidate", de
manera que los mismos queden bloqueados en el ambiente de desarrollo (para no permitir
modificaciones hasta que se complete el ciclo de Deployment). Se administra mediante Bizagi
428
Management Console.
produccin: Este es el ambiente donde operan los Procesos de manera productiva. En l, los
usuarios finales son quienes realizan su trabajo. En este ambiente y mediante Bizagi Management
Console, es posible realizar tareas administrativas y de mantenimiento como: editar las polticas del
negocio, administrar los usuarios y sus permisos sobre el Portal, revisar o reconfigurar el servidor
SMTP para notificaciones, reconfigurar sistemas ECM, etc.
Opciones en el Deployment
Para el fcil Deployment de los procesos, Bizagi ofrece el Deployment en un clic.
A travs de l, se tiene la posibilidad de publicar los Procesos de manera automtica (asistida por
Bizagi) hacia los dems ambientes.
En este procedimiento, Bizagi crea o actualiza el ambiente destino de manera automtica.
Para escenarios ms sofisticados, Bizagi presenta tambin una herramienta de Deployment Avanzado.
Esta opcin es til en los siguientes escenarios:
1. Proyectos de Bizagi JEE (aquellos que no utilizan el IIS).
2. Proyectos que requieren un Deployment de manera offline.
3. Proyectos con mltiples desarrolladores realizando cambios en paralelo.
4. Proyectos con ms de 3 ambientes.
5. Proyectos con software o polticas de despliegue que requieran realizar el procedimiento
manualmente (aplicando paquetes).
Para mayor informacin sobre esta herramienta, consulte el Deployment Avanzado.
Si su proyecto est en Bizagi JEE, el Deployment de los Procesos se realiza por medio del Deployment
Avanzado de Bizagi.
Deployment en un clic
Bizagi Studio presenta un asistente de Deployment llamado Deployment en un clic, el cual permite
publicar y poner en marcha los Procesos de una manera rpida y amigable.
El Deployment es un procedimiento asistido por el asistente mediante unas configuraciones muy
sencillas (disponible para la edicin Bizagi .NET).
La configuracin en un Deployment involucra: seleccionar los Procesos y sus versiones que sern
publicadas, y seleccionar el ambiente de destino (pruebas o produccin), con otras preferencias
especficas para cada ambiente.
El Deployment en un clic crear automticamente el ambiente de destino (si es el primer Deployment a
ese ambiente), donde quedar con su propia Base de datos, Portal de Trabajo y servicio Programador.
429
En los siguientes Deployment, Bizagi actualizar la informacin de los Procesos a ese ambiente
existente.
Ejecutar el Deployment
El Deployment en un clic se accede mediante Bizagi Studio, y se ejecuta desde el paso 7 del Asistente
de Proceso (con la opcin Ejecute y Deployment).
Ntese que esta opcin estar disponible una vez que por lo menos un Proceso ya haya completado
el Paso 6 (haber dado Siguiente) desde el Asistente de Proceso.
Alternatively, the deployment window and procedure can be launched too from the Process module (in
the Modules View) by right-clicking on a specific Process version:
Qu pasa con los casos existentes?

Con el Deployment de Bizagi, los casos existentes de los Procesos (instancias de Proceso) del ambiente
de desarrollo nunca son llevados al ambiente ed produccin ni al ambiente de pruebas (Bizagi no
traslada valores almacenados en Entidades Maestras).
Cuando se realiza un Deployment a un ambiente ya existente de produccin (no es el primer
Deployment), entonces los casos previos se siguen ejecutando de manera consistente en ese ambiente
con las siguientes caractersticas:
Si se hace Deployment de una nueva versin de Proceso a produccin, los casos existentes de ese
Proceso continuarn trabajando bajo la versin en la cual fueron creados.
Por otro lado, los casos nuevos que se creen en produccin a partir de ese momento, trabajarn en
la nueva versin.
430
Ntese que tambin puede optar por realizar ajustes pequeos a un Proceso cuya versin ya est en
produccin (y por ende hacer que los casos existentes tomen los nuevos cambios). En este escenario
que involucra por ejemplo: adicionar un nuevo atributo, modificar una regla de negocio, o una
asignacin de participante, se requiere hacer los cambios directamente sobre la misma versin de
Proceso en produccin y publicarla de nuevo.
Cmo hacer un Deployment?

El Deployment de los Procesos en Bizagi debe realizarse una vez se cumplan los prerrequisitos y
siguiendo el ciclo recomendado de Deployment.
Prerrequisitos
Para revisar las condiciones que deben cumplirse previo a un Deployment, consulte las
Consideraciones y requerimientos para un Deployment.
Ciclo recomendado de Deployment

El siguiente diagrama ilustra el ciclo recomendado para el Deployment de Procesos:
1. Primero, se realizan Deployments al ambiente de pruebas de manera iterativa para identificar

cualquier ajuste o modificacin en los Procesos. Estos se deben realizar en el ambiente de desarrollo.
Estas iteraciones deben hacerse primero sin la marca de Release Candidate, de manera que en el
ambiente de pruebas se ejecuten inicialmente las pruebas unitarias.
431
2. Cuando no hay ms ajustes o modificaciones pendientes de los resultados del ambiente de pruebas,
un nuevo Deployment al mismo ambiente de pruebas debe ser realizado pero esta vez especificando
que los Procesos deben marcarse como Release Candidate.
De requerirse cualquier ajuste, entonces ser necesario cancelar el Release Candidate, llevar a cabo los
cambios en desarrollo, y repetir el Deployment con Release Candidate.
3. Una vez que los Procesos con la marca de Release Candidate sean aprobados y certificados en
pruebas, y se garantice que su comportamiento es el adecuado, entonces el Release Candidate podr
ser aplicado en el ambiente de produccin.
4. Cualquier Deployment posterior (sea de nuevos Procesos, o enfocado al mejoramiento continuo de
los Procesos), debe seguir este mismo ciclo recomendado.
Vea ms informacin acerca del mejoramiento continuo de los Procesos y el desarrollo despus de un
Deployment.
Deployment al ambiente de pruebas

Se recomienda enfticamente utilizar el ambiente de pruebas, y siempre realizar Deployments en l,
antes de un Deployment a produccin.
Para ello, tambin se debe optar por tener un ambiente de pruebas con caractersticas similares al
ambiente de produccin, de manera que las pruebas de aceptacin de usuario puedan garantizar que
los Procesos ya estn listos para ponerse en marcha en produccin (tienen un comportamiento
esperado).
Para mayor informacin acerca del Deployment al ambiente de pruebas y la opcin del Release
Candidate, consulte el Deployment a pruebas.
Deployment al ambiente de produccin

Una vez que el Deployment a pruebas se haya hecho hasta que no se requieran modificaciones en
desarrollo, puede optar por llevar los Procesos al ambiente de produccin.
Para mayor informacin, consulte el Deployment a produccin.
432
Consideraciones y requerimientos
Antes de iniciar un Deployment en Bizagi, las siguientes consideraciones y requerimientos deben
tenerse en cuenta:
1. Check-in de los Procesos

Asegrese que las versiones de los Procesos que quiere publicar mediante el Deployment no estn en
un estatus de check-out (en edicin).
Para ello, vaya al Mdulo de Procesos en la vista de Mdulos de Bizagi Studio.
Revise que los Procesos (en sus versiones activas), estn en estatus de check-in (esto puede
confirmarse si nadie est trabajando en el modelo del Proceso, y por lo tanto tienen visible la opcin
de hacer check-out):
Se recomienda coordinar con su equipo de trabajo del proyecto, que cualquier usuario en Bizagi
Studio est al tanto de que se va a realizar un Deployment, y cules versiones de Procesos involucra.
2. Revisar metadata desde Management Console

433
Abra su proyecto con Bizagi Management Console y utilice la opcin de Revisar metadata para que
Bizagi ejecute unas validaciones para detectar si hay errores en el modelamiento y detalles de
implementacin de los Procesos.
De presentarse algn error, Bizagi indicar que debe ajustarse.

Para ms informacin acerca de esta opcin, consulte Management Console.
3. Revisar los objetos que se van a desplegar

Tenga en cuenta que Bizagi tiene un tratamiento especial para los objetos a nivel de un proyecto que
se publican en los dems ambientes.
Por lo tanto, es importante conocer y entender cul es este tratamiento ya que vara segn los
diferentes objetos en los mdulos de Bizagi (Entidades, Seguridad, Sistemas, etc.).
Por ejemplo, las Entidades de Parametrizacin presentan una configuracin especfica para decidir si
cada una de ellas debe trasladar sus valores o no.
Para ms informacin acerca de este tratamiento, consulte Objetos que ya han tenido Deployment.
4. Requisitos tcnicos
Los siguientes son los requerimientos tcnicos para utilizar el Deployment en un clic que ofrece Bizagi
Studio:
Bizagi Engine instalado en los ambientes destino
434
Para realizar un Deployment a pruebas o produccin, se requiere instalar Bizagi Engine en el servidor
BPM de Produccin o Pruebas.
Este Bizagi Engine debe sere la misma versin que corresponda al Bizagi Studio que tiene instalado en
el ambiente de desarrollo.
Para ms informacin, consulte Instalar Bizagi Engine.
Los ambientes actualizados a la misma versin de Bizagi

Cuando se ha hecho ya un Deployment a pruebas o produccin, se requiere que estos ambientes
existentes se encuentren actualizados a la misma versin de Bizagi en el ambiente de desarrollo.
Para revisar la versin en la que se encuentra el ambiente del proyecto, use las opciones de
administrar los proyectos registrados a travs de Bizagi Management Console:
Base de datos de la misma versin en los diferentes Servidores

Se requiere que la instancia de la Base de datos en los Servidores de pruebas y produccin, tenga la
misma versin de Base de datos que se utiliza por el ambiente de desarrollo.
Cuando se utiliza Microsoft SQL Server, esto significa revisar que sea la misma versin y service packs
aplicados:
435
Cuando se utiliza Oracle, esto significa revisar que sea la misma versin y release:
Base de datos con la misma configuracin de caracteres en los diferentes

Servidores
Se requiere que la instancia de la Base de datos en los Servidores de pruebas y produccin, tenga la
misma configuracin de caracteres soportados para la Base de datos que se utiliza por el ambiente de
desarrollo.
Cuando se utiliza Microsoft SQL Server, esto significa revisar que la intercalacin (collation) sea el
mismo:
436
Cuando se utiliza Oracle, esto significa revisar que la configuracin del set de caracteres sea el mismo:
437
Contar con credenciales autorizadas en el Servidor del ambiente

Se requieren crendenciales autorizadas para crear o actualizar el ambiente en pruebas o produccin.
Esto se debe a que para crear el servicio Programador y el Portal de Trabajo se usan privilegios de
adminstrador.
Para ello, revise que la cuenta utilizada para iniciar Bizagi Studio se encuentre dentro del grupo de
Administradores y del grupo Bizagi en el Servidor BPM. De lo contrario, requiere tener a la mano las
credenciales de una cuenta con estos privilegios.
438
Para ms informacin, consulte Autorizacin para trabajar en un servidor remoto.
Acceso desde el Servidor de desarrollo a los dems servidores

Dado que el Deployment en un clic se realiza de una manera en-lnea, en este procedimiento se
requiere que el Servidor BPM de desarrollo tenga acceso a los Servidores de pruebas o produccin.
Adicionalmente, se recomienda revisar que no haya una configuracin de firewall (o cortafuegos) que
bloquee los puertos utilizados en el transporte de datos del Deployment.
Para la conexin desde el Servidor BPM de Desarrollo al Servidor BPM de Pruebas:
UDP 50051, 50052
El puerto TCP que se define para la notificacin de respuesta (desde pruebas o produccin hacia
desarrollo).
Este puerto se puede cambiar explcitamente en el archivo BizagiStudio.exe.config file (ubicado en la
ruta de instalacin de Bizagi Studio, por defecto: "C:\Program Files\Bizagi\Bizagi Enterprise\Studio").
Por defecto, este puerto TCP est especificado como 0, lo cual implica un puerto aleatorio.
Para cambiar este valor, ubique el elemento channel del archivo de configuracin. Asegrese de
utilizar un nmero de puerto que est permitido por la configuracin de red e infraestructura
corporativa.
Para la conexin hacia la Base de datos, asegrese que el puerto del servicio de la Base de datos est
habilitado desde el servidor BPM de pruebas o produccin.
El puerto por defecto para una instancia SQL Server es 1433, mientras que el puerto por defecto para
una instancia Oracle es 1521.
439
Deployment de los objetos

El Deployment en un clic de Bizagi publica los Procesos con las siguientes caractersticas y tratamiento:
1. Validaciones del motor de dependencias

Bizagi cuenta con un motor de dependencias el cual detecta las Entidades, formas, reglas de negocio,
etc, que estn siendo utilizadas por los Procesos involucrados en el Deployment.
De esta manera, Bizagi incluye la informacin y objetos relevantes de manera automtica en el
Deployment.
De manera similar, Bizagi identifica esas Entidades, formas, reglas de negocio, etc, en el ambiente de
desarrollo que no estn siendo utilizadas, sea por ningn objeto o no estn siendo utilizadas por los
Procesos seleccionados en el Deployment.
Estos que no se utilizan, no son incluidos por Bizagi en el Deployment.
Sin embargo, tambin es posible como una opcin avanzada, forzar de manera manual que un objeto
adicional se incluya en el Deployment.
Los elementos que se definen de manera global (p.e, funciones scripting o expresiones a nivel de la
Entidad de Aplicacin) no pertenecen a los Procesos en s, y por lo tanto, no son detectados para
ser incluidos en el Deployment por el motor de Dependencias.
Para asegurarse de publicar estos elementos en el Deployment, junto con los Procesos que los
utilizan, debe asegurarse de manualmente relacionar los elementos usando la opcin de Relacionar
objetos.
2. Validaciones de integridad
Bizagi tambin ejecuta una serie de validaciones de integridad de los datos, para detectar si hay
inconvenientes en el diseo, o errores en el modelamiento que deben ajustarse de cara al Deployment.
Dentro de estas validaciones, Bizagi tambin detecta si hay posible conflictos con la informacin de los
metadatos en produccin (cuando se realizan cambios y se publican hacia un ambiente de produccin
ya existente).
Es posible que estas validaciones arrojen:
Mensajes de advertencia (warnings), que son idenfiticados con un cono amarillo.
Mensajes de errores de integridad, que requiered de ajuste inmediato y son identificados con una
equis roja.
Los mensajes de advertencia no son errores como tal, y por lo tanto no detendrn la ejecucin del
Deployment.
Este tipo de alertas ensean temas sujetos a mejores prcticas, como por ejemplo cuando se modela
una entidad con demasiados atributos (ms de 50). En este caso particular, no hay un error, sin
embargo Bizagi previene que puede haber un tema de rendimiento si se hacen muchas consultas
sobre esa entidad especfica.
Por otro lado, los errores de integridad deben solucionarse para poder permitir el Deployment:
440
Cuando se presenta un error de integridad, puede dar clic sobre l para ver mayor detalle:
441
Ntese que puede almacenar este log como un archivo XML.
3. Administracin de Entidades de Parametrizacin

Cada Entidad de Parametrizacin tiene propiedades avanzadas, dentro de las cuales se define si la
Entidad est diseada para que sus valores se administren directamente en el ambiente de produccin
(o si por el contrario, sus valores se definen nicamente desde el ambiente de desarrollo).
Por lo tanto, se recomienda revisar detalladamente esta definicin para las Entidades de
Parametrizacin que se van a incluir en el Deployment.
Ntese que es necesario ser consciente de esta definicin, ya que es exclusivo si la administracin de
sus valores (ingresar, modificar o deshabilitarlos) debe hacerse en desarrollo o en produccin.
442
Solamente para el primer Deployment, se presenta la opcin de decidir si los valores de las Entidades
de Parametrizacin se deben incluir, de manera que se lleven de desarrollo a produccin sin importar
la propiedad mencionada anteriormente.
En los Deployments posteriores, (cuando el ambiente de produccin ya exista), slo los valores de las
Entidades de Parametrizacin que sean administrables en desarrollo sern actualizados en el ambiente
de produccin.
Para ms informacin sobre esta propiedad, consulte Dnde administrar las Entidades de
Parametrizacin.
4. Configuracin en produccin
Tenga en cuenta que existen diferentes configuraciones asociadas a los distintos mdulos de un
proyecto Bizagi.
Para cada mdulo, los diferentes valores se manejan por el Deployment con un tratamiento es
especial.
Es posible definir los valores para el ambiente de pruebas siempre desde Bizagi Studio.
Esto implica que estos valores se actualizan en el ambiente de pruebas siempre al momento de hacer
Deployment.
Para el ambiente de produccin, se definen los valores inicialmente cuando todava este ambiente no
existe, (no se ha realizado Deployment a produccin).
Para los Deployment posteriores, la admnistracin de estos valores se realiza directamente sobre el
ambiente especfico (usando Bizagi Management Console).
Este concepto y tratamiento aplica para los siguientes mdulos y configuraciones:
4.1 Opciones de entorno

En el ambiente de desarrollo, es posible definir los valores iniciales que debe tomar el ambiente de
pruebas o produccin en cuanto a la configuracin de las Opciones de entorno.
443
Para el ambiente de produccin, esto solamente es definible antes del primer Deployment.
Esto se debe a que una vez que esta configuracin sea llevada a produccin, la edicin de estos
valores debe hacerse directamente sobre el ambiente (usando Bizagi Management Console).
Para ms informacin sobre esta configuracin especficamente, consulte Configuracin de entorno.
4.2 Propiedades de interfaces (Sistemas)

Cuando se define una interfaz para la invocacin de un servicio Web o REST, se definen inicialmente los
valores para dicha configuracin (por ejemplo, la URL, el mtodo, las credenciales autorizadas, etc).
Una vez que ya se haya hecho un Deployment a produccin, esta configuracin no es editable desde el
ambiente de desarrollo (debe realizarse de manera separada a travs del Management Console).
Para el ambiente de pruebas, los valores si se pueden redefinir nuevamente desde el ambiente de
desarrollo (a travs de Bizagi Studio) para que el Deployment los actualice.
444
En resumen, cambios en la configuracin de invocacin a servicios externos Web o REST, que ya est
en produccin, deben hacerse directamente sobre ese ambiente.
4.3 Propiedades de Proveedores de datos (Sistemas)

Cuando se crea un nuevo Proveedor de datos (para la Virtualizacin o Replicacin), se definen sus
parmetros iniciales (de conexin, como la cadena o el login con permisos) para los dems ambientes:
pruebas y produccin.
445
En resumen, cambios en la configuracin de sistemas con Proveedores de datos, que ya est en

produccin, debe hacerse directamente sobre ese ambiente.
4.4 Propiedades ECM (Sistemas)

Al crear un nuevo repositorio, se definen las propiedades de la carpeta y del mismo, para cada
ambiente.
Una vez que esta configuracin ya ha sido llevada a produccin, los valores de configuracin para este
repositorio no son editables desde el ambiente de desarrollo (deben hacerse directamente en el
ambiente a travs del Management Console).
En resumen, cambios en la configuracin de sistemas ECM que ya est en produccin, debe hacerse
directamente sobre ese ambiente.
El mismo concepto aplica This same concept applies for the folders definition in the ECM integration.
4.5 Autenticacin y configuracin con LDAP

Las opciones presentadas en el mdulo de Seguridad tienen un manejo especial.
La configuracin de Autenticacin y sincronizacin con LDAP se define inicialmente en el ambiente de
desarrollo (por ejemplo, el mtodo de Autenticacin usado en el Portal de Trabajo o si se importan
usuarios desde un Servidor LDAP).
446
En resumen, cambios en la configuracin de Autenticacin y LDAP que ya est en produccin, debe

hacerse directamente sobre ese ambiente.
Lo anterior no incluye la configuracin de autorizaciones la cual puede ser administrada tanto:

directamente en produccin con el Management Console, o sobre el ambiente de desarrollo y
ejecutar un Deployment para actualizar la configuracin.
4.6 Usuarios (WFUser)

Solamente para el primer Deployment al ambiente de produccin, se presenta la opcin de incluir los
usuarios que se hayan creado en el ambiente de desarrollo (hacia produccin).
Despus del primer Deployment, la administracin de usuarios en produccin se realiza de manera
separada (independientemente a travs de las opciones del Portal de Trabajo).
Para los Deployments al ambiente de pruebas, siempre se presenta la opcin de incluir los usuarios
desde desarrollo.
4.7 Grupos de usuarios (Desde la definicin de Organizacin)

447
La definicin de los elementos de la Organizacin en un proyecto (tal como: areas, posiciones,

habilidades, roles, grupos de usuario, etc...), se realiza nicamente desde el ambiente de desarrollo.
Los grupos de usuario en particular, a pesar de que son definidos desde desarrollo, se pueden
configurar directamente en el ambiente produccin solo para incluir o excluir usuarios.
Esta edicin no incluye la redefinicin, eliminacin, o creacin de grupos de usuario.
Relacionar objetos
Cuando se hace Deployment de los Procesos al ambiente de pruebas o produccin, Bizagi ejecutar
las validaciones de su motor de dependencias para determinar qu objetos especficamente se debe
llevar a estos ambientes (los que se usan por los Procesos seleccionados en el Deployment).
A travs de estas validaciones Bizagi incluye de manera automtica los objetos como Entidades,
formas y reglas de negocio, entre otros.
De manera similar, Bizagi identifica esas Entidades, formas, reglas de negocio, etc, en el ambiente de
desarrollo que no estn siendo utilizadas, sea por ningn objeto o no estn siendo utilizadas por los
Procesos seleccionados en el Deployment.
Estos que no se utilizan, no son incluidos por Bizagi en el Deployment.
Sin embargo, tambin es posible de manera manual decidir que un objeto se incluya adicionalmente
en el Deployment.
Esta opcin es especialmente til para incluir objetos tales como: Formas de consulta de entidades
(consultas de entidades), que no estn necesariamente atadas a un Proceso en particular.
Definir los objetos relacionados

Para definir y configurar qu objetos adicionales se relacionan a ciertas versiones de Proceso, hay 2
maneras: previamente desde las propiedades del Proceso, o desde el Deployment en un clic asistido
(durante la configuracin de un Deployment).
Desde las propiedades del Proceso

Cuando se est trabajando en los detalles de implementacin de los Procesos en un proyecto Bizagi,
se puede optar por ir relacionando los objetos recin creados a un Proceso especfico (el Proceso que
principalmente utiliza estos objetos).
De esta manera, cuando el Proceso se lleva a produccin mediante el Deployment, se tendr certeza
de que estos objetos siempre se incluyan tambin.
448
Por ejemplo, cuando se crea un consulta a nivel de Entidad, es til definirlo explcitamente como un
objeto relacionado a un Proceos, para que ste sea llevado y actualizado en el ambiente de
produccin siempre que se seleccione dicho Proceso en el Deployment.
Desde el Deployment Asistido

Cuando se configura y se ejecuta un Deployment, es posible incluir manualmente los objetos que se
deseen atar forsozamente a un determinado Proceso.
Es recomendado realizar esto con los objetos que se observe que no son necesariamente
pertenecientes al Proceso como tal (y que Bizagi no los detecta dentro de los objetos que debe llevar
en el Deployment).
449
Por ejemplo, cuando se crea un consulta a nivel de Entidad, es til definirlo explcitamente como un
objeto relacionado a un Proceos, para que ste sea llevado y actualizado en el ambiente de
produccin siempre que se seleccione dicho Proceso en el Deployment.
Esto se puede realizar desde el Deployment con la opcin desde el clic derecho del Proceso
seleccionado.
Objects to relate
Para relacionar objetos, haga clic en la opcin Relacionar objetos desde las propiedades del Proceso
o desde la configuracin del Deployment.
En esta opcin, podr relacionar: Entidades, Formas de consulta, o Reglas de negocio (incluye
funciones).
Entities
Haga clic en el tem de Entidades para marcar las Entidades Maestras o de Parametrizacin las cuales
se relacionan al determinado Proceso.
450
En la imagen superior, las 2 Entidades: Customer y CustomerType son marcadas como objetos
relacionados.
Formas de consulta
Haga clic en el tem de Formas de consulta para marcar aquellas formas de consulta (sea a nivel de
aplicacin o a nivel de Entidad) las cuales se relacionan al determinado Proceso.
451
En la imagen superior, la forma de consulta de Entidad llamada Ticket Response Query es marcada
como un objeto relacionado.
Reglas de negocio
Haga clic en el tem de Regla de negocio para marcar aquellas reglas (sean de scripting o de tipo
Booleano) y funciones las cuales se relacionan al determinado Proceso.
452
En la imagen superior, la regla de negocio llamada AssignStatus (que se encuentra a nivel de la

aplicacin) y la funcin llamada myFunction, son marcadas como objetos relacionados.
Deployment a Pruebas
Introduccin
El Deployment de los Procesos hacia un ambiente de pruebas es enfticamente recomendado para
realizar las pruebas de aceptacion necesarias que determinen que los Procesos se comportan
adecuadamente.
En esta seccin ilustramos cmo realizar un Deployment al ambiente de pruebas.
453
Prerrequisitos
Antes de continuar leyendo este documento, asegrese de conocer y revisar los requisitos para un
Deployment de Bizagi.
Para ms informacin, consulte las Consideraciones y requerimientos del Deployment.
Deployment a pruebas
Tenga en cuenta que los pasos y opciones mencionados a continuacin, sern enfocados y clasificados
si se trata del primer Deployment que se efecta a este ambiente, o si por el contrario no es un primer
Deployment (se considera como un Deployment posterior).
Esto se debe a que las opciones que se presentan en la configuracin del Deployment en un clic
difieren ligeramente dependiendo de si el ambiente ya existe o no.
De igual manera, las configuraciones tienen tambin diferencias con respecto a las que se presentan
cuando se realiza un Deployment a produccin.
Primer deployment a pruebas (deployment inicial)

En el primer Deployment a cualquier ambiente, Bizagi crea de manera automtica el ambiente y sus
componentes en los Servidores destino (por ejemplo, se crea el Portal de Trabajo y el servicio
Programador en el Servidor BPM, y las Base de datos en el Servidor de Base de datos).
Por lo tanto, para crear el ambiente, debe asegurarse de tener la configuracin y requisitos
apropiados tal como se deben tener para crear un proyecto de Bizagi en el ambiente de desarrollo.
Para realizar un primer Deployment al ambiente de pruebas, se llevan a cabo los siguientes pasos.
454
1. Ejecute el Deployment en un clic.

Vaya al paso # 7 del Asistente de Proceso (opcin Ejecutar) y d clic sobre Hacer Deployment del
Proceso.
2. Seleccione el ambiente.
Bizagi inicia el asistente del Deployment en un clic.
Marque el ambiente a dnde va a realizar el Deployment de sus Procesos.
Ntese que para el ambiente de pruebas, adicionalmente se puede escoger la opcin de Release
Candidate para bloquear la edicin de los Procesos en desarrollo (para dejarlos es un estatus similar
al de produccin).
Para ms informacin sobre esta opcin, consulte Release Candidate.
455
Seleccione el ambiente de pruebas, y d clic en Siguiente.

3. Seleccione el Servidor BPM
De la lista de servidores disponibles que se muestran, seleccione su Servidor de pruebas.
Ntese que en la lista aparecen aquellos que cuenten con los componentes de Servidor de Bizagi
instalados (y que sean visibiles dentro de la red del Servidor de desarrollo).
Es posible seleccionar el Servidor local de desarrollo como Servidor de pruebas, sin embargo tenga
en cuenta que esto no es lo recomendado para llevar a cabo ptimas pruebas de aceptacin de
usuario o pruebas enfocadas al rendimiento de la aplicacin, y tampoco es lo ideal por buenas
prcticas de autorizacin a usuarios.
Una vez seleccione su servidor, d clic en Siguiente.
En dado caso en el que su servidor no aparezca en la lista (pero si se tenga acceso y este tiene
instalado Bizagi), puede ingresar directamente el nombre del servidor en el primer cono.
456
Tambin puede seleccionar la ruta en el servidor donde se almacenarn los archivos del ambiente de
pruebas.
Tambin es posible digitar directamente la direccin IP en vez del nombre del servidor, sin embargo
si se especifica de esta manera, debe asegurarse que la direccin IP no sea dinmica (es decir, que
la IP no cambie).
Tenga presente que al seleccionar un Servidor de pruebas, debe asegurarse que se cuenten con las
credenciales autorizadas de acceso a ese servidor.
Esto se cumple con 2 posibilidades: o la cuenta de Windows que se usa para el Deployment (con la
que se abri Bizagi Studio) pertenece al grupo de Bizagi y al grupo de Administradores del Servidor
de pruebas, o se tienen a la mano las credenciales de una cuenta autorizada para ese servidor (que
pertenezca a los grupos mencionados anteriormente).
457
4. Seleccione el Servidor de Base de datos

Seguidamente, Bizagi presentar las instancias de Base de datos que encuentre instaladas en el
servidor.
Seleccione o digite directamente el nombre del Servidor de Base de datos y la instancia de Base de
datos a usarse para el ambiente.
Para el ambiente de pruebas, por defecto se nombra la Base de datos como "Test_[miProyecto]" pero
es posible editar este nombre.
458
Ingrese la cuenta y contrasea para la Base de datos y d clic en Siguiente.

5. Configure las opciones avanzadas.
Revise las opciones avanzadas de acuerdo a si desea incluir esas posibilidades:
Relacionar objetos: Puede optar por marcar objetos adicionales (como reglas, entidades o formas
de consulta) para que sean forzosamente incluidos en el Deployment (as no se usen por los
Procesos seleccionados).
459
Para ms informacin acerca de esta opcin, consulte Relacionar objetos.

Agregar ms Procesos: Puede optar por incluir ms Procesos en el mismo Deployment.
460
Incluir usuarios en el ambiente destino: Puede optar por trasladar los usuarios que se crearon en el
ambiente de desarrollo hacia el ambiente de pruebas.
Incluir registros de entidades de Parametrizacin administradas en produccin: Puede optar por
incluir los valores (registros) de aquellas entidades de Parametrizacin que fueron definidas como
administrables nicamente en produccin.
Cuando no se incluyen los usuarios de desarrollo hacia pruebas (se deja sin marcar la opcin Incluir
usuarios en el ambiente destino), Bizagi igualmente crear el usuario por defecto (slamente crear
este usuario) en el ambiente de pruebas (el cual es domain\admon).
Siendo as, tenga en cuenta que el usuario domain\admon debe tener los permisos necesarios para
crear ms usuarios.
6. Confirme la configuracin del Deployment.
En la ventana de resmen y confirmacin, se vern los Procesos que se seleccionaron para el
Deployment, al igual que la configuracin relacionada al ambiente de pruebas (Servidor BPM y de Base
de datos).
En esta ventana es igualmente posible revisar si hay o se necesitan objetos adicionales relacionados.
461
Para iniciar el Deployment, d clic en Finalizar.

Bizagi notificar que debe cerrar otras ventanas de Bizagi Studio o Management Console que pueda
tener abiertas con el mismo proyecto.
7. Finalice el Deployment.
El Deployment en un clic de Bizagi ejecutar las validaciones y el Deployment.
Dado que es el primer Deployment, Bizagi crear el ambiente y sus componentes de manera
automtica.
462
Bizagi notifica cuando se complete el Deployment satisfactoriamente.
463
Haga clic en Cerrar.
464
Al finalizar el Deployment, los Procesos en el ambiente de pruebas podrn probarse y ejecutarse

inmediatamente.
Para iniciar el Portal de Trabajo del ambiente de pruebas, puede usar la opcin Ejecutar desde el
asistente de Procesos, en la cual se podr observar su URL.
Haga clic en el cono o etiqueta del mismo para iniciar el Portal de Trabajo:
465
Deployments posteriores a pruebas (deployments incrementales)

El concepto de un Deployment posterior aplica a aquellos Deployments que se realicen despus del
primer Deployment.
Las opciones de los Deployments posteriores varan ligeramente con respecto a las presentadas en un
primer Deployment.
En estos Deployments posteriores, Bizagi ubicar el ambiente existente para actualizar lleva la
informacin de los Procesos. Esto significa que por defecto no se crea un proyecto nuevo, a menos
que se escoja la opcin de cambiar el ambiente.
El procedimiento involucra los siguientes pasos:
Proceso.
466
Tenga presente que si su Deployment ms reciente fue hecho precisamente al ambiente de pruebas
con la marca de Release Candidate (y todava no se ha aplicado a produccin), entonces deber
primero decidir si llevar estos Procesos a produccin o cancelar el Release Candidate.
Para ms informacin sobre esta opcin, consulte Release Candidate.
2. Seleccione el ambiente.
Bizagi inicia el asistente del Deployment en un clic.
Marque el ambiente a dnde va a realizar el Deployment de sus Procesos.
Ntese que para el ambiente de pruebas, adicionalmente se puede escoger la opcin de Release
Candidate para bloquear la edicin de los Procesos en desarrollo (para dejarlos es un estatus similar
al de produccin).
467
Seleccione el ambiente de pruebas, y d clic en Siguiente.

3. Defina las opciones con respecto al ambiente de produccin.
Bizagi ensea una opcin adicional cuando ya existe un ambiente de produccin.
En este escenario, la opcin permite: Hacer el Deployment a pruebas nicamente con los Procesos
seleccionados desde desarrollo (de una manera aislada), o cargar inicialmente en pruebas los
Procesos que ya estn en produccin (y adicionarle los Procesos que vienen desde desarrollo).
468
Sin los Procesos en produccin: Con esta opcin, el ambiente de pruebas se crea slo con los
Procesos que se seleccionaron para el Deployment.
Incluir los Procesos en produccin: Con esta opcin, el ambiente de pruebas tendr tanto los
Procesos que se seleccionaron para el Deployment, como los Procesos que estn operativos en el
ambiente de produccin.
Con cualquiera de las opciones anteriores, tenga en cuenta que no habrn casos poblados en el
ambiente de pruebas (de produccin tambin solamente se traeran los Procesos y no los datos).
469
Relacionar objetos: Puede optar por marcar objetos adicionales (como reglas, entidades o formas
de consulta) para que sean forzosamente incluidos en el Deployment (as no se usen por los
Procesos seleccionados). Para ms informacin acerca de esta opcin, consulte Relacionar objetos.
Agregar ms Procesos: Puede optar por incluir ms Procesos en el mismo Deployment.
ambiente de desarrollo hacia el ambiente de pruebas.
Cuando no se incluyen los usuarios de desarrollo hacia pruebas (se deja sin marcar la opcin Incluir
usuarios en el ambiente destino), Bizagi igualmente crear el usuario por defecto (slamente crear
este usuario) en el ambiente de pruebas (el cual es domain\admon).
crear ms usuarios.
Deployment, al igual que la configuracin relacionada al ambiente de pruebas (Servidor BPM y de Base
de datos).
470
En esta ventana es igualmente posible revisar si hay o se necesitan objetos adicionales relacionados.
Cuando no se est ejecutando un primer Deployment, se presenta en este punto la posibilidad de
cambiar el ambiente actual de pruebas (esto es, seleccionar un Servidor BPM o de Base de datos
diferente al existente).
Para ello, utilice la opcin de Cambiar servidor, con la que se presentarn las ventanas de
configuracin para escoger los servidores (similar a cmo se realiza en un primer Deployment).
Si se cambia el ambiente de pruebas (se seleccionan otros servidores), Bizagi crear el ambiente
nuevo en el servidor nuevo y actualizar la informacin en su ambiente de desarrollo.
Sin embargo, Bizagi no eliminar el ambiente anterior.
471
Previo a ello, realiza de manera automtica un backup de los componentes del ambiente: la Base de
datos, las carpetas del Portal de Trabajo y del servicio Programador.
El backup automtico de la Base de datos se almacena segn el escenario:

Cuando se utiliza SQL Server de manera local (el Servidor de Base de datos es el mismo Servidor
BPM), entonces la ruta es "C:\Bizagi\[edicion_Bizagi]\Projects\[su_proyecto]\Backups\".
Cuando se utiliza SQL Server en un Servidor remoto, la ruta es la de los backups de la instancia (por
defecto "C:\Program Files (x86)\Microsoft SQL Server\[instancia_MSSQL]\MSSQL\Backup\").
Cuando se utiliza Oracle, esta ruta es la predefinida para la instancia; tal como se configura en el
472
momento de crear el proyecto en Oracle.
Al finalizar el Deployment, haga clic en Cerrar.
Qu pasa con los casos existentes en pruebas?

Cuando se realiza un Deployment al ambiente de pruebas, los casos previos del ambiente de pruebas
no se conservan (esto no sucede con el ambiente de produccin).
Lo anterior obedece a la buena prctica de llevar a cabo pruebas de aceptacin de usuario de punta a
punta, garantizando que se prueben los Procesos con nuevos casos (desde el comienzo del flujo).
Release Candidate en Deployment a Pruebas

En el Deployment al ambiente de pruebas, Bizagi presenta una opcin para marcar los Procesos
seleccionados como Release Candidate.
Cuando se usa esta opcin, los Procesos sern tratados por Bizagi de manera especial en el ambiente
de desarrollo (con el mismo tratamiento que tienen los Procesos que ya se estn ejecutando en
produccin).
473
Cuando utilizar el Release Candidate

Un Deployment de Procesos que se lleven al ambiente de pruebas sin utilizar la opcin Release
Candidate, es til para:
1. Ejecutar pruebas unitarias
2. Detectar posibles temas de configuracin que requieran ajustes
3. Ejecutar una demo (una presentacin).
Por otro lado, cuando los Procesos se llevan al ambiente de pruebas con la marca de Release
Candidate, Bizagi har lo siguiente:
1. Un bloqueo de los mismos en el ambiente de desarrollo, para evitar que sean modificados.
En otras palabras, Bizagi congela el modelo del Proceso (flujo) y dems objetos que estn siendo
utilizados por el Proceso (p.e formas, atributos, etc) para garantizar que el Proceso que se prueba en
el ambiente de pruebas es tal como se llevaran los Procesos a produccin.
2. Mantendr el grupo de Procesos en Release Candidate Processes en un estatus "en espera", con
toda la informacin de los mismos listo para ser llevado a produccin si las pruebas de certificacin
de calidad son exitosas.
De requerirse cualquier ajuste al Proceso o sus objetos, se debe cancelar el Release Candidate para
que Bizagi levante el bloqueo de edicin en desarrollo.
De esta manera, debe repetirse el Deployment a pruebas con Release Candidate despus de los
ajustes.
474
Cmo funciona el concepto Release Candidate?

Los Procesos marcados como Release Candidate tendrn sus objetos bloqueados para edicin en el
ambiente de desarrollo. Dicho bloqueo de edicin es diferente para los distintos tipos de objetos (el
tratamiento que se da como si el objeto estuviera ya en produccin), segn lo descrito en Mejora
continua y desarrollo despus de Deployments.
Si las pruebas de aceptacin de usuario no son exitosas y se detecta que se debe realizar alguna
modificacin, entonces se debe cancelar el Release Candidate iniciando el asistente de Deployment
(con Bizagi Studio).
El Deployment en un clic, mostrar el Release Candidate pendiente y se debe escoger la opcin de
Cancelar el Release Candidate:
Al cancelarlo, Bizagi pedir confirmacin del procedimiento:
475
Despus de realizar las modificaciones o ajustes identificados, se debe repetir el Deployment a

pruebas con la marca de Release Candidate. Este procedimiento se repite hasta que las pruebas de
aceptacin de usuario sean existosas y se certifique que los Procesos se comportan adecuadamente y
estn listos para el ambiente de produccin.
De esta manera, al iniciar el asistente de Deployment nuevamente desde Bizagi Studio, se escoge que
Bizagi debe aplicar el Release Candidate en produccin.
Para ello, seleccione la opcin Aplicar Release Candidate:
Con esto, Bizagi iniciar la configuracin del Deployment al ambiente de produccin con los Procesos
aprobados y certificados.
En resumen de este ltimo concepto, cuando se tienen unos Procesos marcados como Release
Candidate, el Deployment en un clic de Bizagi avisar que se debe resolver dicho Release Candidate
(sea aplicarlo a produccin o cancelarlo) antes de cualquier otra opcin de Deployment.
Deployment a Produccin
Introduccin
Bizagi presenta un asistente de Deployment con una configuracin amigable para publicar los
Procesos a un ambiente productivo.
Este Deployment se lleva a cabo con el Deployment en un clic, de una manera en-lnea y sencilla.
476
En esta seccin ilustramos cmo realizar un Deployment de los Procesos al ambiente de produccin.
Prerrequisitos
Antes de continuar leyendo este documento, asegrese de haber revisado:
1. Los prerrequisitos generales del Deployment en Bizagi.
Para ms informacin, consulte las Consideraciones y requerimientos del Deployment.
2. Cmo realizar un Deployment a pruebas, y el uso del Release Candidate.
Para ms informacin, consulte el Deployment a pruebas.
Adicional a lo anterior, asegrese de:

1. Tener a la mano la licencia para su ambiente de produccin Bizagi (para el Portal de Trabajo se
requiere licenciar el Servidor BPM segn el nmero de usuarios finales).
Ms informacin sobre licenciamiento.
2. Tomar previamente backups de los ambientes de desarrollo y produccin, ya que el Deployment a
produccin es un procedimiento que no puede deshacerse desde Bizagi.
Es recomendado que un Deployment se programe con anticipacin y se notifique debidamente.

El Deployment en un clic detiene de manera temporal los servicios del servidor, por lo que es
recomendado realizarlo en horas no laborales.
Deployment a produccin
El Deployment a produccin debe hacerse siempre despus de haber probado y garantizado que los
Procesos se comportan adecuadamente en un ambiente dedicado a pruebas.
Tenga presente que para ello, se debe haber realizado un Deployment a pruebas con la marca de
Release Candidate.
Los Deployments realizados directamente desde desarrollo hacia produccin (sin pasar por el
ambiente de pruebas) son soportados y se llevan a cabo de manera similar a un Deployment a
pruebas, sin embargo tenga en cuenta que este no es el procedimiento recomendado.
477
Primer deployment a produccin (deployment inicial)

De acuerdo a la idea presentada anteriormente, los siguientes pasos se llevan a cabo para un primer
Deployment a produccin (a partir de un Release Candidate).
Proceso.
2. Aplique el Release Candidate.

Dado que el Deployment ms reciente fue el realizado al ambiente de pruebas con la marca de
Release Candidate, Bizagi notificar que se debe resolver el Release Candidate pendiente.
478
Haga clic en Aplicar a produccin y en Siguiente.

3. Seleccione el Servidor BPM
Bizagi presenta una lista de servidores disponibles para el ambiente de produccin.
De la lista que se muestra, seleccione su Servidor de produccin.
Ntese que en la lista aparecen aquellos que cuenten con los componentes de Servidor de Bizagi
instalados (y que sean visibiles dentro de la red del Servidor de desarrollo).
Una vez seleccione su servidor, d clic en Siguiente.
En dado caso en el que su servidor no aparezca en la lista (pero si se tenga acceso y este tiene
instalado Bizagi), puede ingresar directamente el nombre del servidor en el primer cono.
479
Tambin puede seleccionar la ruta en el servidor donde se almacenarn los archivos del ambiente de
produccin.
Tambin es posible digitar directamente la direccin IP en vez del nombre del servidor, sin embargo
si se especifica de esta manera, debe asegurarse que la direccin IP no sea dinmica (es decir, que
la IP no cambie).
Tenga presente que al seleccionar un Servidor de produccin, debe asegurarse que se cuenten con las
credenciales autorizadas de acceso a ese servidor.
Esto se cumple con 2 posibilidades: o la cuenta de Windows que se usa para el Deployment (con la
que se abri Bizagi Studio) pertenece al grupo de Bizagi y al grupo de Administradores del Servidor
de produccin, o se tienen a la mano las credenciales de una cuenta autorizada para ese servidor (que
pertenezca a los grupos mencionados anteriormente).
480
4. Seleccione el Servidor de Base de datos

Bizagi presentar las instancias de Base de datos que encuentre instaladas en el servidor.
Seleccione o digite directamente el nombre del Servidor de Base de datos y la instancia de Base de
datos a usarse para el ambiente.
Para el ambiente de pruebas, por defecto se nombra la Base de datos como "[miProyecto]" pero es
posible editar este nombre.
Ingrese la cuenta y contrasea para la Base de datos y d clic en Siguiente.
481

ambiente de desarrollo hacia el ambiente de produccin.
Cuando no se incluyen los usuarios de desarrollo hacia produccin (se deja sin marcar la opcin
Incluir usuarios en el ambiente destino), Bizagi igualmente crear el usuario por defecto (slamente
crear este usuario) en el ambiente de produccin (el cual es domain\admon).
crear ms usuarios.
Deployment, al igual que la configuracin relacionada al ambiente de produccin (Servidor BPM y de
482
Base de datos).
Ntese que esta informacin es solo para confirmar que la configuracin es la esperada; ya que en
este punto no se pueden realizar cambios sobre el Release Candidate que se aprob en el ambiente
de pruebas (no ser posible adicionar Procesos ni relacionar ms objetos).
483

Dado que es el primer Deployment, Bizagi crear el ambiente y sus componentes de manera
automtica.
Bizagi notifica cuando se complete el Deployment satisfactoriamente. Haga clic en Cerrar.
484
Al finalizar el Deployment, los Procesos en el ambiente de produccin podrn ejecutarse

inmediatamente.
Para iniciar el Portal de Trabajo del ambiente de produccin, puede usar la opcin Ejecutar desde el
asistente de Procesos, en la cual se podr observar su URL.
Haga clic en el cono o etiqueta del mismo para iniciar el Portal de Trabajo:
485
Deployments posteriores a produccin (deployments incrementales)

El concepto de un Deployment posterior aplica a aquellos Deployments que se realicen despus del
primer Deployment.
Las opciones de los Deployments posteriores varan ligeramente con respecto a las presentadas en un
primer Deployment.
En estos Deployments posteriores, Bizagi ubicar el ambiente existente para actualizar lleva la
informacin de los Procesos y no se crear un nuevo proyecto.
Las diferencias principales en Deployments posteriores involucran:
1. Bizagi crea backups de la Base de datos de produccin antes de iniciar el Deployment.
El backup automtico de la Base de datos se almacena segn el escenario:
Cuando se utiliza SQL Server de manera local (el Servidor de Base de datos es el mismo Servidor
BPM), entonces la ruta es "C:\Bizagi\[edicion_Bizagi]\Projects\[su_proyecto]\Backups\".
Cuando se utiliza SQL Server en un Servidor remoto, la ruta es la de los backups de la instancia (por
defecto "C:\Program Files (x86)\Microsoft SQL Server\[instancia_MSSQL]\MSSQL\Backup\").
Cuando se utiliza Oracle, esta ruta es la predefinida para la instancia; tal como se configura en el
momento de crear el proyecto en Oracle.
2. Bizagi no presenta opciones de reconfiguracin de la infraestructura del ambiente (Servidor BPm o
Servidor de Base de dato).
Tenga presente que si requiere mover su ambiente de produccin (moverlo a un Servidor diferente),
entonces esto debe hacerse previamente con las opciones de Administracin de servidores.
486
Solo cuando el Deployment de Bizagi no logre ubicar la Base de datos de produccin (dado que se
haya movido a otro servidor manualmente), se pedir que se reconfigure dicha informacin (se debe
especificar cul es la nueva ubicacin de la Base de datos).
Al reconfigurar la ubicacin de la Base de datos de produccin en caso de que haya cambiado de

ubicacin, recuerde que es estrictamente requerido que se configure la ubicacin acertada de la
Base de datos de produccin. Bizagi valida que realmente corresponda al estado y al ambiente
correcto.
3. Bizagi no presenta opciones para una carga inicial de datos en el ambiente de produccin.
Las opciones para incluir los usuarios o los registros de las entidades de Parametrizacin
administrables en produccin no estn disponibles dado que el ambiente de produccin ya tiene sus
propios datos.
4. Los casos existentes del ambiente de produccin se mantienen de manera consistente en cuento a la
versin del Proceso.
Esto quiere decir que los casos (instancias de Procesos) seguirn trabajndose bajo la versin de
Proceso en la cual fueron creados.
5. Tenga presente el manejo de Bizagi para los objetos que ya estn en produccin y su tratamiento; al
igual que cmo se deben manejar las nuevas versiones de Proceso, segn lo descrito en Mejoramiento
continuo.
Mejoramiento continuo
Introduccin
Como parte de la mejora continua en los Procesos, Bizagi ofrece la posibilidad de realizar ajustes
sobre los Procesos que les permitan su evolucin a medida que el mismo negocio evoluciona.
A menudo, estos ajustes involucran cambios a los datos y reglas del negocio, las interfaces
predefinidas o incluso el mismo flujo del Proceso.
Dependiendo de los cambios requeridos, se recomienda generar una nueva versin del Proceso que
ya se encuentra ejecutndose en produccin.
Esto obedece a una manera segura de implementar cambios sin comprometer la informacin de los
casos existentes (instancias de Proceso) en el ambiente de produccin.
487
Por otro lado, en escenarios donde se requieren solamente cambios menores a los Procesos
existentes, tambin es posible optar por que los casos existentes tomen ese ajuste en produccin.
Esta seccin ilustra a manera de gua, cundo deben crearse nuevas versiones de Proceso y cundo se
pueden manejar los cambios menores dentro de las versiones de Proceso ya existentes.
Mejora continua
Antes que nada, recuerde que cualquier cambio estructural que se desee hacer a un Proceso en
produccin, debe hacerse en el ambiente de desarrollo y actualizarse por medio del Deployment.
Tipos de cambios estructurales son: nuevas transiciones y Actividades en el flujo, nuevas formas o
cambios en ellas, ajustes en las reglas de negocio, nuevas asignaciones a participantes o definiciones
de integracin, entre otras.
Tales cambios estructurales no incluyen las tareas administrativas, las cuales si se pueden llevar a cabo
directamente sobre el Portal de Trabajo en produccin. Tales tareas son por ejemplo: editar polticas
del negocio, la administracin de usuarios y sus configuraciones de autorizacin, o la administracin
de la configuracin del Servidor SMTP o de sistemas externos como ECMs, entre otras.
Tenga en cuenta que de igual manera se debe seguir el ciclo recomendado del Deployment, donde se
utiliza primero el ambiente de pruebas para verificar que los Procesos se comportan adecuadamente y
estn listos para ser llevados a produccin.
Deployments incrementales
488
Para Deployments posteriores al primer Deployment a Produccipon, y para realizar cambios enfocados
en el mejoramiento de Procesos que se encuentran operativos, tenga en cuenta las siguientes
recomendaciones:
1. Los objetos en produccin deben conservarse siempre

Una vez que un Proceso haya sido llevado al ambiente de produccin (aplica tambin cuando un
Proceso est marcado como Release Candidate en pruebas), no es posible eliminar en el ambiente de
desarrollo cualquier objeto que sea utilizado por este Proceso.
Entre tales objetos, se consideran: entidades, atributos y relaciones, formas, reglas de negocio y
definicin de participantes (reglas de asignacin), definicin de sistemas y de elementos de la
organizacin.
De manera similar, no es posible modificar el nombre de estos objetos en produccin (la propiedad
Nombre). Esto es una restriccin para garantizar la estabilidad del ambiente de produccin en
Deployments posteriores.
2. Versionamiento de Procesos
Proceso est marcado como Release Candidate en pruebas), no es posible editar su flujo. Dicho
Proceso queda bloqueado en desarrollo, de manera que si se requiere un cambio en el flujo (una
nueva tarea, una nueva transicin, etc), se requiere crear una nueva versin de ese Proceso.
Esto significa que a partir del primer Deployment de un Proceso, no se puede utilizar el Paso 1 del
Asistente de Proceso (para la adicin o edicin de elementos BPMN en el flujo) para la versin del
Proceso que est en produccin. Para ello, se debe crear una nueva versin del Proceso y de los Sub
Procesos que utilice.
489
Por otro lado, los siguientes cambios no requieren que se cree una nueva versin del Proceso:
Adicionar un nuevo atributo o entidad.
Adicionar o editar una regla de negocio (sea como accin de Actividad, regla de asignacin, o para
la invocacin de servicios Web o REST).
Crear una nueva forma de consulta a nivel de aplicacin o entidad.
En otras palabras, no se requiere una nueva versin del Proceso si se van a hacer cambios que se
realizan desde el paso 2 en adelante del Asistente de Proceso. Ms informacin sobre este tema se
detalla en la siguiente seccin.
Los cambios que se hagan sobre la versin de Proceso actual (sin crear una nueva), aplicaran
directamente sobre los casos existentes del ambiente de produccin.
Por lo tanto, en este escenario es muy importante tener en cuenta las medidas, pruebas y
consideraciones necesarias que garanticen que no se presenten problemas de consistencia en los
casos nuevos y existentes.
490
Para ms informacin sobre las recomendaciones en este aspecto, consulte la gua para nueva versin
de Proceso.
3. Posibilidades de edicin de los objetos en produccin

Proceso est marcado como Release Candidate en pruebas), Bizagi Studio controlar en el ambiente
de desarrollo, las posibilidades para editar los objetos usados por ese Proceso.
Esto es una restriccin para garantizar la estabilidad del ambiente de produccin en Deployments
posteriores.
Por lo tanto, para un Proceso que est en produccin, es recomendado crear una nueva versin de
Proceso para realizar cambios que no sean ajustes menores.
Ajustes menores se pueden realizar a la versin actual del Proceso si involucran cambios puntuales
sobre ciertos objetos que se usan por esos Procesos, como se detalla en la siguiente tabla:
Objeto
Opciones
Entidades y atributos
No ser posible editar las siguientes

propiedades de las entidades y atributos (incluye
relaciones) : nombre, tipo o fuente.
Solo se puede editar su nombre para mostrar.
Formas
No ser posible editar las formas (adicionar,

modificar o eliminar controles, o sus expresiones,
validaciones o acciones asociadas).
Sin embargo, las formas pueden clonarse o
versionarse de por si, de manera que se puede
cambiar la forma que se usa en cierta Actividad.
Expresiones (booleanas y de tipo scripting)
Su cdigo podr ser editado (junto con otras

propiedades como el nombre de mostrar o su
descripcin).
Al hacerlo, se debe tener cuidado en no alterar el
buen funcionamiento de los casos existentes.
Funciones personalizadas
Su cdigo podr ser editado (junto con su

descripcin).
Widgets de Bizagi
Su cdigo podr ser editado (junto con su

descripcin).
Definicin de participantes (reglas de asignacin)
Todas sus propiedades y condiciones podrn ser

editadas. Esto implica las definiciones del criterio
y reglas de asignacin.
Definicin de la organizacin
Solo el nombre de mostrar podr ser editado

para los elementos de la organizacin
previamente definidos (reas, Roles, habilidades,
grupos de usuario).
491
Esquemas de festivos (en el esquema de horario

de trabajo)
Solo la descripcin del esquema de dias no

laborales podr ser editado.
Seguridad
Cambios en la configuracin de Autenticacin y

LDAP, debern hacerse directamente en el
ambiente de produccin con el Management
Console.
Los cambios realizados en el ambiente de
desarrollo para la configuracin de
autorizaciones sern siempre actualizados por el
Deployment hacia produccin.
Notificaciones por correo (e-mails)
Nuevos mensajes (cuando se utiliza la posibilidad

de mltiples correos) se pueden incluir en la
configuracin de notificaciones.
Los mensajes existentes no se podrn eliminar.
Dentro de la definicin del mensaje, su asunto,
destinatario ("Para", "CC", y "BCC"), y contenido
del cuerpo, podrn ser editado.
Las condiciones de envo de los correos podrn
ser editadas tambin pero no eliminadas.
Cartas
Su contenido podr ser editado.
Invocaciones de interfaces
La configuracin de la invocacin a un servicio

Web o REST puede cambiarse tal como lo
permite el asistente de interfaces en Bizagi.
Los ajustes de parmetros (por ejemplo, de
conexin, y dems que no requieran un nuevo
mapeo de datos), podrn realizarse
directamente sobre produccin con el
Management Console.
Dimensiones
Todas sus propiedades podrn ser editadas

(excepto el nombre).
Componentes en la Librera de componentes
Ser posible cambiar el archivo o ensamblado

asociado al componente.
Trabajos personalizados
Se podrn adicionar nuevos Pasos y

Programaciones a los trabajos personalizados.
Cualquier otro cambio que no se encuentre listado en la tabla anterior, requerir crear una nueva
versin de Proceso que utilice otro objeto diferente al que ya exista en produccin.
4. Nuevas llaves de negocio

Cuando se definen nuevas llaves de negocio, se recomienda revisar que los datos en produccin son
compatibles con las nuevas caractersticas o restricciones (constraints).
De lo contrario, si se aplican llaves de negocio en desarrollo que no se dan con los datos en
produccin, se tendr un error de integridad advertido por Bizagi durante el Deployment.
492
Para ilustrar lo anterior, supongamos que se tiene una entidad llamada Producto, la cual ya fue llevada
al ambiente de produccin sin definicin de llaves de negocio. Entonces, no se debe redefinir
posteriorment en la entidad Producto que su llave de negocio es el atributo NombreProducto si se
detecta: que hay ms de un registro en produccin con NombreProducto=Crdito (ms de un
producto con el mismo nombre)..
Para ms informacin sobre estas definiciones, consulte predefiniendo llaves de negocio.
5. Las configuraciones previas deben permanecer compatibles

No se deben alterar las configuraciones que ya se tenan anteriormente a nivel de infraestructura.
Esto significa que las caracteristicas de los prerrequisitos tcnicos del Deployment no deben
cambiarse.
Lo anterior incluye no cambiar la intercalacin de la instancia de Base de datos (si es SQL Server), o de
manera similar no cambiar la configuracin del set de caracteres en una instancia de Oracle.
Si requiere cambiar su Servidor de produccin, asegrese de utilizar las opciones del Management
Console.
Gua para nueva versin de Proceso
Introduccin
La administracin de versiones de Proceso en Bizagi, ofrecen la flexibilidad de implementar mejoras a
los Procesos.
Estas mejoras que son producto del anlisis de indicadores o debido a la evolucin de los Procesos
(por polticas de mejoramiento continuo), se incluyen gilmente en nuevas versiones de Procesos en
Bizagi.
Es recomendado que se evalen previamente las mejoras requeridas, para determinar si los ajustes
deben realizarse o no sobre una nueva versin de Proceso.
Esto se debe a que a menudo se pueden detectar ajustes muy puntuales que no necesariamente
requieren una nueva versin, en cuyo caso, se debe de igual manera analizar que estos cambios sean
compatibles con los casos existentes.
Cundo crear una nueva versin?

Tenga presente que Bizagi maneja mltiples versiones de Procesos: los casos (instancias de Proceso)
que se estn ejecutando en el momento en que una nueva versin de Proceso se publique a
produccin, seguirn ejecutndose sobre esa versin en la cual fueron creados.
Solamente los casos nuevos sern creados siempre en la ltima versin del Proceso.
La siguiente tabla ilustra escenarios comunes de ajustes a Procesos en produccin.
SE REQUIERE NUEVA VERSIN
NO SE REQUIERE NUEVA VERSIN
Cambios en el flujo del proceso: incluir o eliminar

elementos en el modelo, o cambiar los nombres,
493
duracin, notificaciones, etc de los mismos.

Incluir o eliminar atributos (o controles en
formas) que sern evaluados en una regla de
negocio.
Incluir o eliminar atributos (o controles en

formas) que solo son informativos, ms no sern
evaluados en una regla de negocio.
Cambios sobre reglas de negocio que ser

evaludas en algn punto del proceso y que
podran producir inconsistencias con instancias
de proceso en produccin.
Cambios sobre reglas de negocio que se prevee

no podran producir inconsistencias con
instancias de proceso en produccin.
Cambios en las configuraciones de acciones de

actividad (notificaciones, decisiones, etc) que
afecten la lgica de enrutamiento del proceso.
Cambios en las configuraciones de acciones de

actividad (notificaciones, decisiones, etc) que se
preevea no afecten la lgica de enrutamiento del
proceso.
Cambios en la configuracin de los sub

procesos.
Nuevas transiciones en el proceso a partir de
compuertas inclusivas o exclusivas.
Recomendaciones
Antes de crear una nueva versin de Proceso, tenga en cuenta:
1. Los criterios anteriormente mencionados, y qu posibilidad tiene de editar ciertos objetos en
produccin.
Para ms informacin sobre la posibilidad de edicin de objetos en produccin, consulte el
Mejoramiento continuo.
2. Bizagi ofrece tambin la posibilidad de clonar Procesos basado en uno existente de la misma
Aplicacin de Proceso.
Esto significa que si realmente es una mejora a un Proceso en produccin, puede optar por crear una
nueva versin, pero tambin puede darse el caso de querer crear un nuevo Proceso a partir de otro
muy similar (a travs de la clonacin de Procesos).
3. Se recomienda tomar backups de la base de datos antes de crear una nueva versin del proceso.
Crear una nueva versin de Proceso

1. En la vista de Mdulos haga cliic derecho sobre la versin del Proceso que quiere versionar y
seleccione la opcin de Nueva versin.
494
2. Un nueva ventana muestra la estructura de la aplicacin que contiene el Proceso. Seleccione la

versin exacta del Proceso o Procesos para los que se generar nueva versin.
3. Recomendamos acceder a las opciones avanzadas (a travs del botn ubicado en la parte inferior
izquieda). Estas le permiten incluir tambin versiones nuevas de los Sub Procesos que utiliza ese
Proceso.
495
4. Haga clic en Nueva versin para iniciar la generacin. Se mostrar un mensaje de confirmacin;
haga clic en OK.
Una ventana le mostrar el estado del proceso.
Tan pronto como se termine el procedimiento, Bizagi notificar el xito.
Solo los objetos relacionados al Proceso se copiarn:
Fases, Actividades, Transiciones, Eventos,
496
Formas, Reglas etc. Los objetos compartidos no se copian: Entidades (Atributos), Formas de entidad.
De presentarse algn error, aparecer un log con el detalle sobre lo que debe ajustarse en la versin
del Proceso actual (y repetir el procedimiento una vez que se solucione el problema).
Deployment Avanzado
Introduccin
Bizagi presenta una herramienta de Deployment Avanzado como alternativa al Deployment-en-un-clic
que se ofrece desde Bizagi Studio, para realizar el Deployment de los Procesos en situaciones donde
hay requerimientos sofisticados.
Para ms informacin sobre el Deployment-en-un-clic (donde Bizagi asiste y realiza automticamente el
despliegue de paquetes de informacin), consulte el Deployment de sus procesos.
Cundo utilizar el Deployment Avanzado?

El Deployment de los Procesos se realiza una vez se haya completado la fase de automatizacin, para
publicar uno o ms Procesos implementados hacia el ambiente de pruebas y el ambiente de
produccin.
El Deployment Avanzado cubre escenarios avanzados con requerimientos de Deployment tales como:
1. Proyectos ejecutndose sobre una plataforma JEE.
El Deployment-en-un-clic realiza validaciones y se apoya en servicios de un sitio web IIS.
Los proyectos que se ejecuten sobre una plataforma JEE no utilizan el IIS y por lo tanto, debern
497
utilizar el Deployment Avanzado.

2. Proyectos que requieren de un Deployment fuera de lnea (offline).
Llevar a cabo un Deployment offline se requiere cuando no hay conexin de red entre el ambiente de
desarrollo (donde est Bizagi Studio), y el ambiente final de produccin (p.e, podr ubicarse en un
servicio en la nube, en un data center en otro dominio y red, etc).
3. Proyectos con automatizacin de procesos en un cronograma en paralelo.
Aplica para proyectos a gran escala con un gran nmero de desarrolladores que automatizan varios
procesos los cuales van quedando completos en diferentes momentos.
Este caso aplica cuando se quieran publicar unos procesos listos mientras se contina la
implementacin de otros, y no se quiere detener su avance mientras se realiza el deployment.
4. Proyectos que manejan ms de los 3 ambientes por defecto.
Aplica dependiendo de la naturaleza de los procesos, y para aquellos que son de misin crtica y que
a nivel corporativo exigen que se utilicen ms de los 3 ambientes que se presentan por defecto.
El Deployment-en-un-clic de Bizagi considera el ambiente de desarrollo, junto con un ambiente de
pruebas y uno de produccin.
Al utilizar ambientes adicionales como por ejemplo una rplica de produccin, o staging, deber
utilizar el Deployment Avanzado.
5. Proyectos donde se desee conservar cierta informacin.
El Deployment Avanzado provee un procedimiento ms flexible que el deployment tradicional, dado
que habilita una serie de opciones para revisar o modificar la informacin que ser llevada desde
desarrollo hacia el ambiente destino (pruebas o produccin).
Es muy til cuando los usuarios avanzados conocen bien qu necesitan publicar y qu no.
De esta manera, todos los objetos de Bizagi (Entidades, reglas, formas, etc) pertenecientes a uno o
ms Procesos pueden seleccionarse de manera explcita, o desmarcarse (para no ser tenidos en
cuenta) en el deployment.
Esto incluye la posibilidad de preservar los casos de prueba de un ambiente de pruebas.
Cmo funciona?
En breve, el Deployment Avanzado mediante su herramienta, le permitir seleccionar los procesos y
sub-procesos a publicar al ambiente de pruebas o de produccin, a travs de un set de 4 archivos
ejecutables:
Puede de manera opcional:
Incluir otros objetos (no necesariamente atados a los Procesos seleccionados), para llevarlos en el
deployment.
Excluir objetos para los cuales tiene la certeza que no desea llevarlos en el deployment.
Esta informacin es exportada a un paquete de Deployment de Bizagi (un archivo utilizando una
extensin .bex).
El archivo .bex se lleva al ambiente de produccin, y es utilizado para analizar y previsualizar lo que se
va a importar al ambiente destino (se pueden revisar los objetos que sern llevados en el deployment),
de manera que se pueda asegurar que la estructura e informacin que va a quedar en pruebas o
produccin sea la adecuada.
Este anlisis realiza una comparacin contra la Base de datos de destino sin modificarla en este punto.
498
Finalmente, cuando el anlisis y las revisiones han sido efectuadas, puede escoger exportar el paquete
revisado como un archivo .bim, el cual puede ser aplicado directamente a la Base de datos de destino.
Importante
Antes de continuar, considere las siguientes implicaciones:
1. Deployment inicial podr hacerse con el Deployment-en-un-clic
Cuando ejecuta sus procesos sobre una plataforma de .NET, se recomienda realizar el primer
Deployment (puesta en marcha inicial) a travs del Deployment-en-un-clic.
De esta manera Bizagi asistir en la creacin del ambiente destino (el Portal, servicio Scheduler y la
Base de datos), y permitir que Bizagi valide ciertos objetos y la existencia del ambiente de
produccin.
Si definitivamente no es viable utilizar el Deployment-en-un-clic incluso para el primer Deployment,
entonces tendr que crear la base de datos en blanco del modelo de Bizagi a travs del Deployment
Avanzado.
2. Si utiliza el Deployment Avanzado, deber seguir utilizndolo siempre
Es posible decidir utilizar el Deployment Avanzado (su herramienta), an si se ha utilizado el
Deployment en un clic de Bizagi (pero no
viceversa).
Esto significa que una vez que se decida utilizar el Deployment Avanzado para su proyecto, no ser
posible cambir y volver a utilizar el Deployment en un clic (el Deployment tradicional presentado en
Bizagi Studio).
Para los proyectos que hayan usado la herramienta para el Deployment Avanzado, cualquier
Deployment a futura deber seguirse realizando por medio del Deployment Avanzado.
3. Siempre cree sus backups
Las herramientas de Deployment Avanzado no crean backups de manera automtica de ninguna Base
de datos.
Recuerde que como medida de contingencia, se recomienda siempre tomar backups de sus distintos
ambientes del proyecto, antes de realizar cambios significativos en ellos. El Deployment realiza
cambios significativos, sea por medio del Deployment en un clic o el Deployment Avanzado.
Esto implica que si se utiliza el Deployment Avanzado, se debe tomar un backup del ambiente destino
(pruebas o produccin), por lo menos antes de aplicar cualquier cambio (p.e antes de importar
paquetes).
4. No eliminar los objetos en el ambiente de Desarrollo a menos que no se utilicen en produccin
Es muy importante que tenga en cuenta que al usar el Deployment Avanzado, Bizagi Studio no podr
realizar sus validaciones de dependencias.
Es decir, si un objeto ya existe en produccin.
Ante esto, es sumamente indispensable que no se eliminen objetos en desarrollo que estn siendo
usados en produccin y que se creen nuevas versiones de Proceso cuando se requieran realizar
cambios sobre los Procesos.
499
5. Planee y coordine el Deployment

Al igual que con el Deployment en un clic, se recomienda programar y llevar a cabo el Deployment
Avanzado en un horario no laboral.
Esto promueve poder tener rpidas medidas de contigencia como la restauracin de backups, en caso
de que los resultados del Deployment no sean los esperados.
6. Considere ambientes adicionales si aplica
Dependiendo de la criticidad de los Procesos y si se deben hacer pruebas sobre las instancias
existentes (casos en produccin) o dependiendo del tipo de cambios que se realizaron en desarrollo,
se puede optar por usar un ambiente alterno (de Staging o Rplica de produccin), para llevar a cabo
pruebas de aceptacin de usuario rigorosas enfocadas a los casos de produccin.
Esto significa crear de antemano un ambiente temporal slo con el propsito de probar cmo se
comportara el Deployment final en produccin.
Al realizar esto mediante la restauracin de un backup, se tendra una forma de revisar si algn cambio
o informacin adicional debe llevarse en el Deployment.
Al utilizar este ambiente temporal, tenga en cuenta cambiar la configuracin del Servidor SMTP,
cualquier interfaz configurada, ECMs o Proveedores de datos, las direcciones de correo configuradas
para usuarios o en el negocio, etc, para que no se disparen servicios reales de produccin.
Perfil requerido
El usuario que lleve a cabo un Deployment Avanzado, debe contar con el siguiente perfil:
1. Tener un conocimiento bsico sobre la estructura de un XML (para editar los archivos de
configuracin).
2. Tener acceso a las Base de Datos involucradas (con credenciales de super usuario).
3. Tener conocimiento sobre automatizacin de Procesos en Bizagi (conceptos y mdulos de Bizagi
Studio).
Para ms informacin sobre el tratamiento que Bizagi da a los objetos en un deployment, consulte el
Deployment de los objetos.
4. Tener un entendimiento sobre los Procesos implementados en particular, en el proyecto.
Esto implica conocer sobre el propsito de los Procesos involucrados, sus versiones, modelo de
datos, integraciones, configuracin de sseguridad, parmetros de ambiente y su administracin (p.e
polticas, alarmas, valores de entidades de parametrizacin), y el funcionamiento del Proceso en
general.
Tenga en cuenta que para llevar a cabo pruebas adecuadas (de aceptacin de usuario), se debe poder
determinar cul es el comportamiento esperado de los Procesos en el Portal de Trabajo de acuerdo a
las diferentes posibilidades de negocio.
Archivos ejecutables del Deployment Avanzado

El Deployment Avanzado provee 4 archivos ejecutables diferentes, cada uno con su archivo de
configuracin y con un fin especfico.
Estos archivos ejecutables vienen instalados por defecto en la ruta del Management Console (en C:
\Archivos de Programa\BizAgi\Bizagi Enterprise\MC\).
500
El propsito de cada ejecutable y dnde debe utilizarse se describe en la tabla a continuacin (este
aarchivo se ubica bajo el nombre que listamos, con la extensin .exe).
Ejecutable
Propsito
Dnde debe utilizarse?
CreateDatabase.
exe
Crea una base de datos en blanco con el modelo

de Bizagi, justo como lo realiza Bizagi Studio o el
Management Console cuando se crea un proyecto
nuevo.
Se requiere especialmente porque a travs del
Advanced Deployment no se crea una base de
datos sino que se parte de una base de datos
existente a donde se van a aplicar los objetos de su
implementacin (entidades, formas, reglas, etc).
En una mquina que tenga

acceso al servidor de base
de datos de Produccin.
Export.exe
Crea un archivo de exportacin .bex export donde

tendr el paquete de objetos de su ambiente de
Desarrollo.

de datos del ambiente de
Desarrollo.
Podr usarlo directamente
desde donde se encuentra
Bizagi Studio.
CreateImport.ex
e
Crea un paquete de importacin .bim donde tendr

los objetos finales que llevar a su ambiente de
Produccin. Se realiza despus del anlisis al
archivo .bex para considerar si debe haber un

501
manejo especial en la informacin de los 2

ambientes (p.e hacer merge).
ApplyImport.exe
Aplica el archivo .bim hacia la base de datos

destino, donde se completa el Deployment.

Archivos de configuracin
La configuracin de los ejecutables mencionados anteriomente se realiza a travs de sus archivos con
extensin .config.
Estos archivos de configuracin continene formato XML y corresponden de la siguiente manera:
CreateDatabase.exe.config para CreateDatabase.exe
Export.exe.config para Export.exe
CreateImport.exe config para CreateImport.exe
ApplyImport.exe config para ApplyImport.exe
Todos los archivos de configuracin contienen la siguiente estructura, donde requieren configuracin
de 3 llaves dentro del elemento <appSettings>:
ProofConcept_Utility: Contiene el nombre del utilitario, al archivo ejecutable que referencia.
DSNDB: Contiene el string de conexin a la base de datos al cul el ejecutable se conecta. En el
caso del CreateDatabase.exe, la conexin representa la base de datos que an no ha sido creada.
PROVIDERTYPE: Especifica el proveedor de datos para esa conexin (SQL Server o Oracle).
Para configurar un ejecutable, deber incluir el detalle de la conexin a la base de datos y del
proveedor.
Al utilizar SQL Server:
<add key="DSNDB" value="Persist Security Info=True;User
ID=[SQL_Login];Password=[Login_password];Data Source=[DB_Server]
\[Named_instance];Initial Catalog=[Database];" />
Considere:
[SQL_Login]: La cuenta de login que se utiliza para conectarse a una instancia SQL Server.
[Login_password]: La contrasea de la cuenta de login de la conexin.
[DB_Server]: Nombre o direccin IP del servidor de base de datos. Utilice \[nombre_instancia] si
502
aplica (si no es la instancia sin nombre por defecto).

[Database]: El nombre de la base de datos del ambiente de su proyecto. Recuerde que para el
CreateDatabase particularmente, esta base de datos es la que an no ha sido creada.
Al utilizar Oracle:
<add key="DSNDB" value="Data Source=[DB_Server]:[Port_number]/
[Service];User
ID=[User_schema];Password=[User_schema_password];Unicode=True;" />
Considere:
[DB_Server]: Nombre o direccin IP del servidor de base de datos.
[Port_number]: El nmero de puerto utilizado para la conexin a ese servicio.
[Service]: El identificador de servicio usado para su base de datos Oracle.
[User_schema]: El nombre de la base de datos del ambiente de su proyecto (esquema de usuario).
Recuerde que para el CreateDatabase particularmente, esta base de datos es la que an no ha sido
creada.
[User_schema_password]: La contrasea para ese esquema de usuario.
CreateDatabase.exe
Utilice este ejecutable si su proyecto se ejecuta sobre una plataforma de JEE, o si va a realizar un
deployment inicial a un determinado ambiente (p.e, el primer deployment a ambiente de pruebas o de
produccin).
Deber crear una base de datos en blanco del modelo de Bizagi nicamente la primera vez para que
el Deployment Avanzado aplique scripts sobre una base de datos existente.
Significa que para deployments siguientes (incrementales), no necesita utilizar este ejecutable.
Recuerde que para los proyectos que se ejecutan sobre una plataforma de .NET platform, podr
considerar el uso del Deployment-en-un-clic para el primer deployment.
De ser as, entonces no necesitar del CreateDatabase.exe.
Tenga en cuenta:
Si usted crea una Base de datos SQL Server, deber asegurarse que la instancia tenga un puerto
TCP/IP explcito.
Para mayor informacin sobre los requisitos y configuracin de SQL Server, consulte Configuracin
de SQL Server.
Si usted crea una Base de datos Oracle, deber asegurarse de haber creado previamente el
usuario BizagiAdmon.
La nueva Base de datos quedar con la misma contrasea del usuario BizagiAdmon, de manera que
deber especificar la contrasea de BizagiAdmon para la nueva configuracin.
Para mayor informacin sobre los requisitos y configuracin de Oracle, consulte Crear un proyecto
utilizando Oracle.
Para utilizar CreateDatabase.exe, previamente asegrese de haber copiado la carpeta completa del
MC en una ruta local de una mquina con acceso a la base de datos de produccin (la carpeta MC
contiene los 4 archivos ejecutables y las dlls necesarias).
Seguidamente:
503
1. Edite el archivo CreateDatabase.exe.config para especificar el detalle de la conexin a la base de

datos que desea crear.
2. Ejecute el CreateDatabase.exe.
La interfaz de usuario le presentar lo siguiente:
Target (destino): Ensea la base de datos y el servidor de base de datos configurado, al cul se est
conectado.
Unicode support (soporte a Unicode): Asegrese de marcar la casilla para el soporte a Unicode de
acuerdo a su proyecto en el ambiente de desarrollo (dependiendo de si ste soporta Unicode o no).
3. Cree la base de datos.

Para ello, utilice una de las 2 opciones:
Create Bizagi Test database (Crear la base de datos para ambiente de pruebas): Haga clic en este
enlace para comenzar la creacin de la base de datos en blanco, que quedar inicialmente marcada
como ambiente de pruebas.
Create Bizagi Production database (Crear la base de datos para ambiente de produccin): Haga clic
en este enlace para comenzar la creacin de la base de datos en blanco, que quedar inicialmente
marcada como ambiente de produccin.
Una vez que confirme la accin, el progreso de la creacin de base de datos se ensea:
504
Tan pronto finaliza exitosamente, podr cerrar el ejecutable.
Export.exe
Utilice este ejecutable para generar el paquete inicial de objetos que se extraen desde el ambiente de
desarrollo.
Este ejecutable es el nico que se configura apuntando a la base de datos del ambiente de desarrollo.
Para utilizar Export.exe:
1. Edite el archivo Export.exe.config para especificar el detalle de la conexin a la base de datos de
desarrollo.
2. Ejecute el Export.exe.
505

conectado.
Panel principal: Lista todos los procesos y sus versiones. Asegrese de marcar la casilla de los cuales
desea incluir.
Ntese que podr hacer clic derecho sobre la versin de proceso para utilizar la opcin Define
additional dependencies para definir dependencias adicionales y forzar la inclusin de ciertos objetos
independientes en el deployment.
Para definir objetos adicionales, podr marcar registros especficos de las tablas de Bizagi.
Realice esto adicionando la tabla desde la lista desplegable y marcando las casillas de esos registros:
506
Set Advanced Import-export (Marcar el uso del import-export): Se recomienda dar clic en esta
opcin para marcar explcitamente en el proyecto que se est utilizando el deployment Avanzado.
De esta manera, desde Bizagi se pueden realizar validaciones adicionales para proteger la integridad,
y se pueden llevar a cabo las actualizaciones de versin con un mejor enfoque.
Advanced options (Opciones avanzadas): Ofrecen las posibilidades para excluir o incluir objetos del
sistema, administrados por Bizagi.
507
OPCIN
CUNDO UTILIZARLA?
Incluir sub procesos
Puede inicialmente y explcitamente marcar todos

los procesos y sub-procesos que desea
considerar en el deployment.
Cuando marque solo procesos, podr basarse
en esta opcin para asegurarse de incluir todos
los sub procesos que puedan referenciar esos
procesos.
Incluir valores de parmetros de ambiente
Puede incluir valores que se administran de

manera diferente en sus ambientes. Se
recomienda sin embargo, cerciorarse de que
dichos valores de parmetros (p.e el servidor
SMTP, las URL de las interfaces, etc)
correspondan correctamente a su ambiente.
Incluir los objetos de sistema
Se recomienda conservar este tem marcado

para que Bizagi se encargue de los objetos de
sistema.
Incluir trabajos personalizados
Si su proyecto utiliza trabajos personalizados y

desea llevarlos en el deployment, asegrese de
marcar esta casilla.
Incluir elmentos de la organizacin (posiciones,

roles, habilidades, etc).
Se recomienda incluir la definicin de su

organizacin dado que estos elementos se crean
508
siempre en el ambiente de desarrollo.

Incluir instancias de las entidades
Se recomienda inicialmente validar y revisar que

registros se llevan en el deployment de las
entidades de parametrizacin.
Si tiene entidades de este tipo donde su valor no
ser administrado desde produccin, asegrese
que esta casilla est marcada.
Incluir la definicin del esquema de festivos
Si su proyecto tiene una definicin y

personalizacin del calendario de festivos para la
organizacin, marque esta casilla para incuir esta
informacin en el deployment.
Include LDAP configuration
Si su proyecto utiliza configuracin LDAP para

sincronizar los usuarios, puede utilizar esta casilla
para llevar los cambios.
3. De clic sobre el botn Export.

Esta accin generar el paquete con los objetos seleccionados de sus versiones de proceso y lo
almacenar como un archivo .bex.
En este punto ya el Export se ha utilizado pero puede usar las opciones presentadas para "despus
del export" para revisar qu contiene exactamente su paquete y evaluar si requiere volver a crear uno.
Podr ver de qu tablas se tienen objetos completamente o parcialmente.
CreateImport.exe
Utilice este ejecutable para analizar el paquete que cre previamente a travs de Export.
El anlisis que se lleva a cabo en este punto considera cmo se manejara la aplicacin de este
paquete sobre el ambiente de produccin (manejo de conflictos, merge) sin hacer cambios algunos
an.
Al finalizar el anlisis usted podr confirmar cmo ser el paquete final que se produce como un .bim
para produccin con el CreateImport.
Para utilizar CreateImport.exe, previamente asegrese de haber copiado la carpeta MC en una
mquina que tenga acceso a la base de datos del ambiente de produccin (esta carpeta contiene los 4
ejecutables y las dlls que se utilizan).
Seguidamente:
1. Edite el archivo de configuracin CreateImport.exe.config de manera que especifique la cadena de
conexin a su base de datos del ambiente de produccin.
2. Ejecute CreateImport.exe.
509

conectado.
Load file (cargar archivo): Utilice esta opcin para iniciar con el uso de CreateImport. Deber cargar
el paquete .bex que se cre previamente a travs del Export.exe
Export file details (Detalle de exportacin): Podr utilizar las opciones: View additional entities
used by processes (Ver entidades adicionales), View process objects to import (Ver objetos de proceso
a importar), o View entities to import (Ver entidades a importar) para revisar la informacin que se
incluye en el paquete (tal como se presentan dichas opciones desde el Export).
View additional entities used by processes (Ver entidades adicionales): lista las entidades que se
incluyen como dependencia adicional (forzada), adems de las que ya se toman directamente por uso
desde el proceso.
View process objects to import (Ver objetos de proceso a importar): lista las entidades internas (del
sistema) que tienen la informacin del proceso y que sern incluidas en el deployment.
View entities to import (Ver entidades a importar): ista las entidades de parametrizacin que
contienen registros que sern insertados o actualizados en produccin.
Process import analysis (Anlisis de la importacin): Una vez que haya importando el archivo bex,
realice el anlisis para validar si van a haber conflictos o problemas potenciales cuando se aplique
este paquete en el ambiente de produccin.
510
3. Revise los objetos a incluir en el deployment.

Una vez que el anlisis sea exitoso, utilice las opciones View/edit process objects to import (Ver/editar
los objetos de proceso) y View/edit entity objects to import (Ver/editar los objetos de entidades) para
explcitamente excluir aquellos objetos que no desee incluir en el ambiente final de produccin.
A travs de ambas opciones podr utilizar filtros y desmarcar exactamente los registros que no desee
considerar en el paquete:
4. De clic en Generar el archivo import (Generate Import file).

Con esta accin generar el paquete final revisado para aplicarlo en el deployment. .
En este punto ya cuenta con el archivo .bim creado a partir del CreateImport, listo para su ambiente de
produccin.
511
ApplyImport.exe
Utilice este ejecutable para aplicar el paquete final que se cre a travs de CreateImport.
La aplicacin de este paquete involucra la ejecucin de scripts sobre la base de datos, por lo que es
fundamental que en este punto se tomen medidas adecuadas.
Para utilizar ApplyImport.exe:
1. Edite el archivo de configuracin ApplyImport.exe.config de manera que especifique la cadena de
conexin a su base de datos del ambiente de produccin.
2. Ejecute ApplyImport.exe.

conectado.
Load file (cargar archivo): Utilice esta opcin para iniciar con el uso de ApplyImport. Deber cargar
el paquete .bim que se cre previamente a travs del CreateImport.exe
Import config (Configuracin de importacin): Podr utilizar sus opciones para revisar que est
aplicando el paquete correcto.
A travs de las opciones View process objects to import (Ver objetos de proceso), y View entity objects
to import (Ver objetos de entidades) podr ver exactamente qu informacin se incluye en el paquete
tal como cuando se incluyeron con el CreateImport.
3. Haga clic en Aplicar a la base de datos (Apply into target database).

Esta opcin da inicio al procedimiento de aplicar el paquete, para el cual debe confirmar:
512
Este podr tardar un par de minutos y recuerde que en este punto se ejecutarn scripts a nivel de
base de datos.
Una vez haya finalizado, se notificar el xito de la operacin:
Ejemplo de Deployment Avanzado
Introduccin
Bizagi presenta una herramienta de Deployment Avanzado como alternativa al Deployment-en-un-clic
para realizar el Deployment de los Procesos en situaciones sofisticadas.
Para ms informacin sobre el Deployment-en-un-clic (donde Bizagi asiste y realiza automticamente el
despliegue de paquetes de informacin), consulte el Deployment de sus procesos.
Para informacin general consulte el Deployment Avanzado.
En esta seccin ilustraremos un ejemplo sobre el uso del Deployment Avanzado para publicar
procesos al ambiente de produccin.
Configurar el Deployment Avanzado

Para configurar el Deployment Avanzado, tenga en cuenta que esta herramienta provee 4 ejecutables
diferentes (1 de ellos debe usarse en el ambiente de desarrollo, y los otros 2 en una mquina donde
haya acceso a la Base de datos del ambiente destino (p.e una mquina que acceda a produccin que
no necesariamente est en la misma red del ambiente de desarrollo).
513
Para la configuracin, realice lo siguiente:

1. Tenga a la mano la herramienta con los ejecutables del Deployment Avanzado.
Los ejecutables del Deployment Avanzado se encuentran en la carpeta del Management Console
dentro de la ruta de instalacin de Bizagi (por defecto en "C:\Program Files (x86)\BizAgi\Bizagi
Enterprise\MC\").
2. Asegrese que esta carpeta completa est en una mquina que tenga acceso en red a las Bases de
datos de los ambientes.
No se requiren pasos de instalacin adicionales.
Ntese que es posible que requiera duplicar esta carpeta y ubicarla en 2 mquinas diferentes, dado el
caso en el que su ambiente destino (p.e. produccin) no sea visible desde la misma mquina donde se
accede al ambiente de desarrollo.
3. Configure los archivos para los ejecutables.
Dentro de la estructura de la carpeta del Deployment Avanzado, se encuentran los siguientes
ejecutables: Export.exe, CreateImport.exe, y ApplyImport.exe, cons sus respectivos archivos de
configuracin: Export.exe.config, CreateImport.exe.config, y ApplyImport,exe.config.
Para configurar estos archivos, siga estas instrucciones:
Primero configure el Export.exe, mediante la edicin de su archivo de configuracin
Export.exe.config. De esta manera, especifique la conexin a la Base de datos de desarrollo (desde
donde se va a obtener la informacin).
Seguidamente configure CreateImport.exe y ApplyImport.exe, editando sus archivos de
configuracin CreateImport.exe.config y ApplyImport.exe.config respectivamente. De esta manera,
especifique la conexin a la Base de datos destino (hacia donde se publicarn los cambios: pruebas
o produccin).
Para configurar el detalle de conexin en estos archivos, ubique los elementos DSNDB y
PROVIDERTYPE (las llaves), y utilice:
Para SQL Server:
<add key="DSNDB" value="Persist Security Info=True;User
ID=[login_user];Password=[login_password];Data
Source=[database_instance];Initial Catalog=[database_name];" />
Para Oracle:
<add key="DSNDB" value="Data Source=[connection_to_service];User
ID=[schema_name];Password=[schema_password];Unicode=True;"/>
<add key="PROVIDERTYPE" value= "Oracle" />
En el escenario en el que se realiza un primer Deployment hacia el ambiente de pruebas o de

produccin (la Base de datos destino todava no ha sido creada), entones deber utilizar un
ejecutable adicional de la carpeta, llamado CreateDatabase.exe.
Para hacerlo, configure el archivo CreateDatabase.exe.config con la informacin con la cual ser
creada la Base de datos.
Esta Base de datos ser creada como modelo en blanco de Bizagi, y estar configurada para uso
514
exclusivo de ambiente de pruebas o de produccin.

Tenga en cuenta:
Si usted crea una Base de datos SQL Server, deber asegurarse que la instancia tenga un puerto
TCP/IP explcito.
Para mayor informacin sobre los requisitos y configuracin de SQL Server, consulte Configuracin
de SQL Server.
Si usted crea una Base de datos Oracle, deber asegurarse de haber creado previamente el
usuario BizagiAdmon.
La nueva Base de datos quedar con la misma contrasea del usuario BizagiAdmon, de manera que
deber especificar la contrasea de BizagiAdmon para la nueva configuracin.
Para mayor informacin sobre los requisitos y configuracin de Oracle, consulte Crear un proyecto
utilizando Oracle.
Preparar el Deployment Avanzado

La primera tarea del Deployment Avanzado es crear el paquete del Export (archivo .bex), dado que
este archivo contiene los cambios e informacin que se va a llevar al ambiente destino.
Por lo tanto, antes de exportar los Procesos ys sus objetos, asegrese de cumplir con estas
condiciones:
1. Todos los cambios en el ambiente de desarrollo deben haber sido guardados. En este punto,
deberan conocerse los Procesos (y sub Procesos) que se van a publicar, y stos mismos deben haber
tenido un check-in en Bizagi Studio (y que ningn miembro del equipo se encuentre trabajando sobre
ellos).
2. Asegrese que para sus ambientes la ejecucin de validaciones de Revisar metadata sea exitosa y
no arroje ningn error.
3. Considere los datos y la configuracin administrable que se llevar directamente desde desarrollo
(versus la que ser administrada en produccin).
Es muy importante revisar los datos en cuanto a Entidades de Parametrizacin, para determinar cules
registros de ellas deben ser llevados desde desarrollo, o cuales deben ser administrados directamente
en produccin.
Adems de esto, y en general, se recomienda enfticamente asegurarse de conocer lo que se debe
llevar desde desarrollo tales como: configuracin de seguridad, de interfaces y sistemas externos,
parmetros de ambiente, etc.
Para ms informacin sobre estas consideraciones consulte las Consideraciones previas a un
Deployment.
Utilizar el Deployment Avanzado

La utilizacin del Deployment Avanzado est dividido en 2 tareas principales: Primero se ejecuta la
utilidad Export para generar el paquete con la informacin del Deployment, y luego se utilizan los
otros ejecutables en el ambiente destino (pruebas o produccin) para aplicar el paquete de
Deployment con sus cambios.
515
Utilizar el Export en el ambiente de desarrollo

1. Ejecute el Export.exe.
ste le mostrar la siguiente informacin y opciones:
Opcin- Nmero en la
imagen
Descripcin
Ensea el nombre de la Base de datos del proyecto, junto con su

Servidor de Base de datos.
Debe apuntar a su ambiente de desarrollo.
Lista las aplicaciones del proyecto.
Lista los Procesos (y sub Procesos) por cada aplicacin que son
seleccionables para el Deployment.
Lista las versiones de los Procesos que se pueden marcar para el

Deployment. Al hacer clic derecho sobre una versin, aparece la
posibilidad de incluir dependencias de manera manual.
Permite configurar las opciones para la exportacin del paquete.
Crea el archivo de exportacin (.bex).
Presenta la posibilidad de revisar la informacin que se incluy en

el archivo de exportacin.
516
Existen unas tareas adicionales, las cuales puede revisarse despus de la generacin del archivo de
exportacin.
Sin embargo, estas opciones tambin estn presentes en los ejecutables de importacin.
2. Marque los Procesos y sub Procesos a exportar.
Recuerde que hay una opcin sobre el clic-derecho de la versin de Proceso, para definir
manualmente dependencias adicionales, para que hayan ciertos objetos que se incluyan en el
Deployment.
Para ms informacin sobre este concepto, consulte Relacionar objetos.
Puede tambin optar por editar los objetos de sistema que se incluyen en el Deployment.
Para ello, utilice el botn Avanzado (Advanced).
3. Genere el archivo .bex haciendo clic en el botn de Exportar (Export).
Seleccione la ruta donde guardar este archivo.
Usted necesitar este archivo para la ejecucin del Import (en el ambiente de pruebas o produccin).
Si aparece algn error, entonces deber ajustarlo en el ambiente de desarrollo, y repetir el

procedimiento hasta que no hayan errores.
517
Utilizar las utilidades del Import en el ambiente destino

Antes de ejecutar las utilidades de Import, asegrese que la Base de datos destino exista.
Si es un primer Deployment en donde todava no hay dicho ambiente de pruebas o de produccin,
utilice el ejecutable CreateDatabase.exe para crear un modelo de Base de datos de Bizagi en blanco.
Una vez haya revisado lo anterior, recuerde tomar backups de su ambiente destino antes de proceder
con estos pasos:
1. Ejecute el CreateImport.exe.
ste mostrar las siguientes opciones:
Opcin- Nmero en la
imagen
Descripcin
Muestra el nombre de la Base de datos del proyecto en el

ambiente destino, al igual que el nombre del Servidor de Base de
datos.
Debe referenciar al ambiente de pruebas o produccin (segn el
caso),
Presenta la opcin de cargar el archivo .bex del Export.
Presenta la informacin sobre cmo se realiz el paquete de

exportacin.
Ejecuta una serie de validaciones para analizar potenciales

conflictos.
518
Esto no realiza ningn cambio a la Base de datos destino.

5
Permite revisar y decidir si desmarcar o no, cada uno de los

objetos (informacin del sistema) que sern llevados con el
Deployment.
Permite revisar y decidir si desmarcar o no, cada uno de los

registros de las entidades de Parametrizacin que sern llevados
con el Deployment.
Crea el archivo de importacin final (.bim).
2. Cargue el archivo .bex (creado previamente en el Export) utilizando el botn de cargar archivo (Load
File).
Una vez se cargue, ejecute un anlisis usando la opcin de anlisis (Process Import analysis).
Si aparece algn error, entonces deber ajustarlo (en este punto, la mayora de estos errores deben
ajustarse en el ambiente de desarrollo).
Una vez se hayan hecho ajustes, se debe repetir el procedimiento hasta que no hayan errores.
3. Utilice la opcin para revisar los objetos a importar (view/edit process objects to import). De esta
manera puede decidir desmarcar aquellos objetos bajo informacin detallada.
519
Dentro de los objetos que se pueden revisar, se inclluye un filtro para revisar los objetos del sistema
que sea actualizados, eliminados o adicionados.
Este paso es realmente importante dado que permitir excluir cualquier informacin a nivel de
registros, para no llevarla en el paquete del Deployment.
Al hacer clic en esta opcin, la siguiente ventana se mostrar:
Opcin- Nmero en la
imagen
Descripcin
Lista los objetos a nivel de tablas, que se incluyen en el Import.

Seleccione cualquier tabla, para visualizar en el panel derecho, sus
registros y poder desmarcarlos en caso de que aplique.
No aplica ningn filtro para visualizar las tablas las cuales

contienen informacin de registros (muestra todas).
Filtra las tablas para mostrar nicamente aquellas que tienen

registros que no han cambiado.

registros nuevos que sern adicionados.

registros que sern eliminados. Este filtro es muy importante, para
revisar que efectivamente se eliminen registros de la forma
520
esperada.
6

registros que sern actualizados.
Este filtro es muy importante, para revisar que efectivamente se
actualice informacin de la forma esperada.
Permite excluir cualquier registro que se detecte como no

necesario o acertado en trminos de llevarlo en el Deployment.
Provee detalle sobre lo que va a quedar diferente. Es

especialmente til para revisar la informacin a nivel de registro
que va a ser actualizada.
Filtra la informacin de manera similar a lo especificado en los

nmeros 2-6. Es especialmente til revisar la informacin a detalle
que va a ser actualizada, adicionada o eliminada.
10
Guarda los cambios una vez que haya finalizado con la revisin de
excluir objetos.
Una vez haya finalizado, proceda al siguiente paso.

4. Utilice la opcin para revisar los registros a importar (view/edit entity objects to import) .De esta
manera puede decidir desmarcar aquellos registros bajo informacin detallada.
Dentro de los registros que se pueden revisar, se inclluye un filtro para revisar aquellos que sern
actualizados, eliminados o adicionados.
Este paso es realmente importante dado que permitir excluir cualquier informacin a nivel de
registros, para no llevarla en el paquete del Deployment.
Al hacer clic en esta opcin, la siguiente ventana se mostrar:
521
Opcin- Nmero en la
imagen
Descripcin
Lista las Entidades de Parametrizacin que sern incluidas en el

Import. Seleccione cualquiera de ellas, para visualizar en el panel
derecho, sus registros y poder desmarcarlos en caso de que
aplique.
No aplica ningn filtro para visualizar las entidades las cuales

contienen informacin de registros (muestra todas aquellas
administrables en desarrollo que tengan registros).
Filtra las entidades para mostrar nicamente aquellas que tienen

registros que no han cambiado.

registros nuevos que sern adicionados.

registros que sern eliminados. Este filtro es muy importante, para
revisar que efectivamente se elimine informacin de la forma
esperada.

registros que sern actualizados. Este filtro es muy importante,
para revisar que efectivamente se actualice informacin de la
522
forma esperada.
7
Permite excluir cualquier registro que se detecte como no

necesario o acertado en trminos de llevarlo en el Deployment.
Provee detalle sobre lo que va a quedar diferente. Es

especialmente til para revisar la informacin a nivel de registro
que va a ser actualizada.
Filtra la informacin de manera similar a lo especificado en los

nmeros 2-6. Es especialmente til revisar la informacin a detalle
que va a ser actualizada, adicionada o eliminada.
10
Guarda los cambios una vez que haya finalizado con la revisin de
excluir objetos.
Una vez haya finalizado, proceda al siguiente paso.

5. Genere el archivo de importacin .bim haciendo clic en el botn de generar (Generate Import file).
Seleccione la ruta donde guardar este archivo.
Usted necesitar este archivo para aplicar finalmente el paquete del Import (en el ambiente de pruebas
o produccin) a travs del utilitario ApplyImport.exe.
6. Ejecute ApplyImport.exe.
ste mostrar las siguientes opciones:
Opcin- Nmero en la
imagen
1
Descripcin
Muestra el nombre de la Base de datos del proyecto en el

ambiente destino, al igual que el nombre del Servidor de Base de
523
datos.
Debe referenciar al ambiente de pruebas o produccin (segn el
caso), de manera igual que el CreateImport.exe.
2
Presenta la opcin de cargar el archivo .bim.
Presenta la informacin sobre cmo se realiz el paquete de

importacin.
Aplica el paquete de Deployment hacia la Base de datos destino.
7. Cargue el archivo .bim (creado previamente en el Import), usando el botn de cargar (Load File ).
Una vez que cargue, puede revisar que los objetos que se importan y cualquier modificacin, sean los
esperados para aplicar en el ambiente destino.
8. Ejecute el Deployment utilizando el botn de Aplicar hacia la Base de datos (Apply into target
Database).
Esto har que se ejecuten las modificaciones en la Base de datos destino.
Una vez se realice, asegrese de llevar a cabo una revisin de lo llevado por el Deployment.
Qu sigue?
Despus de realizar un Deployment de Procesos hacia una Base de datos de ambiente de pruebas o
de produccin, asegrese de actualizar la informacin que carga su Servidor BPM.
En Bizagi .NET, esto significa reiniciar los servicios del IIS para que el Portal de Trabajo tome los
cambios.
En Bizagi JEE, esto significa: generar el Portal de Trabajo, haciendo despliegue de la aplicacin (el
archivo .EAR) hacia el Servidor de Aplicaciones JEE; y reiniciar el servidor.
Para ms informacin sobre este paso, consulte Despliegue a un Servidor de Aplicaciones JEE.
Mantenimiento y administracin de proyectos

Una tarea comn en la administracin de proyectos, es garantizar la disponibilidad de la informacin y
as evitar interrupciones en el servicio a los usuarios finales.
Estas tareas administrativas de mantenimiento del proyecto son tiles como una medida de
contingencia cuando algo no sucede como se plane, o cuando hay un evento externo el cual
interrumpe el servicio de la aplicacin o su informacin.
Recomendaciones para el mantenimiento

Para contar con la opcin de revertir su proyecto a un estado previo (si algn evento inesperado
sucede) lea con atencin las siguientes recomendaciones.
1. Crear backups de manera frecuente

Los backups (o archivos de respaldo) brindan la posibilidad de no perder informacin, y asegurar que
siempre re-establezcamos acceso a los datos en el menor tiempo posible ante eventualidades. Los
backups son el elemento principal para las medidas y planes de contingencia.
524
Es por ello que stos se deben crear de manera frecuente.

Es tambin recomendado que se identifiquen los riesgos principales (los cuales pueden causar eventos
inesperados), para que de esta manera se generen backups justo antes.
De suceder algn evento inesperado, la solucin de Bizagi podr volver a un estado anterior con la
restauracin de estos backups.
2. Crear backups de la base de datos y de los archivos

En las soluciones de Bizagi se deben crear backups contemplando los siguientes elementos:
La Base de datos.
Archivos del Programador (Scheduler).
Archivos de la aplicacin Web.
Adjuntos de los casos (archivos que se hayan adjuntado a las instancias de Proceso).
Backups de la Base de datos

Para crear backups de manera manual, siga el procedimiento indicado en Backups y restauracin en
SQL Server o en Export e Import de Oracle.
Backups de la aplicacin Web y del Programador (Scheduler)

Cree copias de la estructura de carpetas y archivos que se utilizan en la configuracin del Portal de
trabajo de Bizagi y los componentes adicionales de Bizagi, como su servicio Scheduler.
Si su proyecto se ejecuta sobre una plataforma .NET, deber copiar las carpetas (y su contenido) del
Servidor BPM donde estn los ensamblados usados por el Portal de Trabajo (la aplicacin Web) y por
el servicio del Programador (Scheduler).
Aplicacin Web: Los archivos que se encuentran en
C:\Program Files\[edicin_bizagi]\Projects\[su_proyecto]\Web Application\
Programador: Los archivos que se encuentran en
C:\Program Files\[edicin_bizagi]\Projects\[su_proyecto]\Scheduler\
525
Para crear backups de estos archivos y su configuracin, basta con crear una copia de estas carpetas
en otra ubicacin segura (preferiblemente en dispositivos externos o en la nube).
Si su proyecto se ejecuta sobre una plataforma JEE, usted deber crear un backup del archivo .ear
generado.
Backups de los adjuntos

Los archivos y documentos adjuntos a los casos (instancias de Procesos) se almacenan por defecto en
el Servidor BPM (la ruta "C:\BizAgi\[edicin_bizagi]\Projects\[su_proyecto]\Docs\").
Esta ruta de almacenamiento est definida por la configuracin del valor "upload path", que puede ser
cambiada en cualquier momento.
526
Asegrese de respaldar estos archivos de los casos, sea si esta configuracin define que la ruta de
almancenamiento es un ECM u otro Servidor de archivos.
Para crear backups de estos archivos y su configuracin, basta con crear una copia de estas carpetas
en otra ubicacin segura (preferiblemente en dispositivos externos o en la nube).
3. Realizar mantenimiento a la base de datos

Es muy importante siempre monitorear la base de datos y realizar tareas de afinamiento.
Para ms informacin sobre las recomendaciones para estas tareas, consulte Mantenimiento de la
base de datos.
4. Monitorear sus servidores y la aplicacin

Es muy importante siempre monitorear los servidores involucrados en la solucin, e igualmente
monitorear el desempeo de la aplicacin de Bizagi en servidor de aplicaciones.
Para ms informacin sobre las recomendaciones para estas tareas, consulte Monitoreo de servidores.
5. Revisar los parmetros de ambiente y otros sistemas de la solucin

Se recomienda una revisin peridica y monitoreo de los parmetros y variables que afectan o
527
intervienen con los procesos de Bizagi.

Es importante garantizar que las notificaciones, puntos de integracion y otros aspectos de la
implementacin como tal, mantengan un ptimo funcionamiento y desempeo.
Dentro de estos aspectos, asegrese de que la configuracin de negocio estn correctamente
configuradas y que los sistemas integrados en la solucin (por medio de servicios Web, autenticacin
LDAP, ECM o por medio de Virtualizacin y Replicacin), no presenten inconvenientes.
De manera similar, y para una configuracin en clster, deber asegurarse de haber configurado los
nodos y el balanceador de cargas.
Para ms informacin acerca de la revisin y administracin de estos aspectos, consulte la
Configuracin de entorno.
6. Actualizar la versin de Bizagi

Bizagi libera nuevas versiones de manera peridica. Estas versiones incluyen nuevas funcionalidades
poderosas y ajustes o mejoras a las funcionalidades existentes.
Recomendamos que se siempre realice la actualizacin a la nueva versin, de manera que sus
proyectos puedan contar con todos los beneficios de las nuevas mejoras y funcionalidades.
Es muy importante que usted planee y coordine esta actualizacin, y que se lleven a cabo pruebas de
aceptacin de usuario apropiadas.
Recomendamos seguir los lineamientos y procedimiento de actualizacin de version de Bizagi, como
se describe en Actualizacin de Bizagi.
Backups de base de datos

Para ms informacin acerca de cmo crear backups (archivos de respaldo) o cmo restaurar los
mismos, siga las secciones de acuerdo aal motor de base de datos de su proyecto:
Si usted utiliza SQL Server, consulte Backups y su restauracin en SQL Server.
Si usted utiliza Oracle, consulte Export e import de Oracle .
Backups y su restauracin en SQL Server

Un requerimiento y una tarea administrativa frecuente, es tener la posibilidad de crear backups para
una eventual restauracin a un estado anterior del proyecto Bizagi.
Los backups en este tipo de tareas se crean principalmente como una medida de contingencia, o
tambin para mover o copiar un proyecto en etapa de desarrollo.
Todo esto es muy sencillo para la solucin Bizagi dado que es orientado al modelo.
Cuando se usa una Base de datos SQL Server, las tareas de crear backups y restaurarlos, se realizan a
travs de SQL Server Management Studio.
La restauracin de backups debe usarse slo para mover una base de datos o como medida de
528
contingencia para restaurar el estado anterior de un mismo ambiente. Es decir que un backup del
ambiente de desarrollo slo debe ser restaurado en el ambiente de desarrollo. Para crear
ambientes, se debe usar la funcionalidad del Deployment de Bizagi.
En esta seccin ilustramos cmo realizar backups y cmo restaurarlos para proyectos de Bizagi que
usen Microsoft SQL Server.
Si su proyecto utiliza Oracle, consulte Export e Import de Oracle.
Prerrequisitos
Para crear un backup o restaurarlo, se requiere:
1. Tener instalado Microsoft SQL Server Management Studio para la conexin a la instancia de Base de
datos (segn sea 2012, 2008 R2, 2008, 2005).
Mas informacin en enlaces externos de Microsoft: http://www.microsoft.com/en-us/download/
details.aspx?id=22985.
2. Tener instalada una misma versin e intercalacin (collation) de SQL en los Servidores involucrados
(donde se va a restaurar el backup y de donde se obtuvo el backup).
Consideraciones adicionales
Si usted est moviendo un proyecto que se encuentra en fases de automatizacin (ambiente de
529
desarrollo), hacia un servidor diferente (pero igual de desarrollo) y desea conservar las instancias de
Proceso (casos), tenga en cuenta que los adjuntos de estos casos no estarn dentro de la informacin
del backup.
Por lo tanto en el hipottico escenario en el que desee trasladar los casos de un ambiente de
desarrollo, deber considerar mover tambin la ubicacin de stos (sea el Servidor BPM, un Servidor
diferente de archivos, o un ECM).
Crear un Backup
Para crear un backup de su Base de datos:
1. Autentquese en su instancia de SQL Server (login) a travs de SQL Server Management Studio.
2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin Backup... desde las
tareas:
530
3. Especifique que el backup se realice completo (modo FULL).
531
Ntese que debe seleccionar una ruta vlidad para almacenar el archivo resultante (.bak).
Si no desea utilizar la ruta por defecto, puede navegar y seleccionar otro directorio. Si utiliza otro
directorio, asegrese de contar con los permisos de escritura sobre l.
532
4. Haga clic en OK cuando la operacin se haya completado:
533
Importante
Ntese que podr crear 2 tipos bsicos de Backups:
Full Backup: Esta opcin crea un backup completo (de toda la Base de datos). Con esta opcin se
limpian las transacciones almacenadas en el log de transacciones.
Differential Backup: Es un backup diferencial, donde se almacena la parte que ha cambiado con
respecto al ltimo backup completo (Full Backup). El log de transacciones tambin es truncado.
Para restaurar un proyecto de Bizagi a su ltimo estado por medio de un backup, se recomienda crear
y utilizar los backups en modo Full backup.
Por ejemplo, los backups automticos que toma Bizagi los realiza de esta manera.
534
Si desea programar Backups, de manera que se generen de manera automtica, puede revisar otros
enlaces externos como http://support.microsoft.com/kb/930615.
Restaurar un Backup
Antes de comenzar
Antes de restaurar un backup en una base de datos en uso, asegrese que no hayan conexiones
activas (requisito de la restauracin).
Si su proyecto se ejecuta sobre una plataforma .NET, tenga en cuenta que el servicio del Programador
(Scheduler) muy probablemente tendr una conexin a la base de datos.
Por lo tanto, deber previamente detener este servicio.
Puede detener el Programador por medio de Bizagi Management Console:
535
Si su proyecto se ejecuta sobre una plataforma JEE, el servicio Programdor (Scheduler) debe detenerse
desde el Servidor de aplicaciones JEE.
Restauracin
Una vez que garantice que no hay conexiones activas (la Base de datos donde se va a restaurar un
backup no est en uso), restaure un backup con los siguientes pasos:
1. Autentquese en su instancia de SQL Server (login) a travs de SQL Server Management Studio.
536
2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin de Restaurar -> Base de
datos:
537
3. Especifique que la Base de datos ser restaurada desde un dispositivo.

Navegue hasta seleccionar el archivo .bak de origen:
538
539
Tenga en cuenta que SQL Server mantiene la compatibilidad hacia atrs. Esto significa que un
backup de SQL 2005 o SQL 2008 puede restaurarse dentro de una instancia SQL 2008 R2, pero no
en sentido contrario (un backup generado no podr restaurarse en una instancia con una versin
menos reciente).
4. Marque el archivo con la opcin de Restaurar:
540
5. Vaya al tab de Opciones, y marque la opcin de Sobrescritura (Overwrite the existing database).
541
Asegrese de seleccionar el destino de los archivos usados por la Base de datos (.dat y .log).
542
Ntese que estos archivos se ubican por defecto en la siguiente ruta:

"C:\Bizagi\Projects\[su_proyecto]\Database\", si el Servidor de Base de datos es el mismo Servidor
BPM (el proyecto usa una Base de datos local).
En la ruta de la instancia SQL Server (por defecto "C:\Program Files (x86)\Microsoft SQL Server
\[instancia]\MSSQL\Data\"), si el Servidor de Base de datos no es el mismo Servidor BPM.
6. Haga clic en OK cuando la operacin de restauracin se haya completado.
543
Importante
Despus de restaurar un backup en un proyecto de Bizagi, se debe refrescar la memoria cach del
servidor Web.
Si su proyecto se ejecuta en una plataforma .NET, esto se logra ejecutando un IISReset, y reiniciando
el servicio Scheduler.
Si su proyecto se ejecuta en una plataforma JEE, entonces al re-iniciar el Servidor de aplicaciones
JEE, se iniciar automticamente el servicio Scheduler.
544
Export e Import en Oracle

Un requerimiento y una tarea administrativa frecuente, es tener la posibilidad de crear backups para
una eventual restauracin a un estado anterior del proyecto Bizagi.
Los backups en este tipo de tareas se crean principalmente como una medida de contingencia, o
tambin para mover o copiar un proyecto en etapa de desarrollo.
Todo esto es muy sencillo para la solucin Bizagi dado que es orientado al modelo.
Cuando se usa una Base de datos Oracle, las tareas de crear backups y restaurarlos, se realizan a
travs (y se mencionan como) de los utilitarios de Oracle de Import y Export.
La restauracin de backups debe usarse slo para mover una base de datos o como medida de
contingencia para restaurar el estado anterior de un mismo ambiente. Es decir que un backup del
ambiente de desarrollo slo debe ser restaurado en el ambiente de desarrollo. Para crear
ambientes, se debe usar la funcionalidad del Deployment de Bizagi.
En esta seccin ilustramos cmo ejecutar el Export e Import de una base de datos Oracle de Bizagi.
Si su proyecto utiliza SQL Server, consulte Backups y su restauracin en SQL Server.
Prerrequisitos
Para usar los utilitarios Export o Import en Oracle, se requiere:
1. Tener instalado el cliente de Oracle donde se va a realizar el Export e Import.
Se requiere que la versin del cliente sea igual a la versin instalada en el Servidor (incluyendo los bits
soportados).
Tenga en cuenta que en Bizagi, se soportan instancias Oracle 10g R2.
2. Tener ya sea los mismos set de caracteres, o unos sets compatibles (en los configurados en las
mquinas clientes y en los servidores involucrados en el Export e Import).
Debe asegurarse que los sets de caracteres configurados sean los mismos o compatibles en las
mquinas involucradas. Esto es un requisito directamente el Export e Import de Oracle para mantener
la integridad de la informacin.
3. No tener ms de una definicin activa del Oracle home.
Esto significa que si tiene ms de un cliente Oracle instalado (de donde se va a ejecutar el Export o
Import), deber asegurrse de que la variable de entorno ORACLE_HOME est definida adecuadamente
para apuntar al cliente de Oracle que utiliza Bizagi.
Consideraciones adicionales
Si usted est moviendo un proyecto en ambiente de desarrollo a un servidor diferente y desea
conservar las instancias de Proceso (casos), tenga en cuenta que los adjuntos de estos casos no
estarn dentro de la informacin del backup.
545
Por lo tanto en el hipottico escenario en el que desee trasladar los casos de un ambiente de
desarrollo, deber considerar mover tambin la ubicacin de stos (sea el Servidor BPM, un Servidor
diferente de archivos, o un ECM).
Tambin se recomienda que el uso de Export e Import lo realice un usuario experimentado y con
conocimiento del tema (por ejemplo un dba). Esto se debe a 3 razones principales:
1. El Export e Import se lleva a cabo con linea de comandos y especificacin de parmetros (los cuales
son conocidos por un dba).
2. Se requiere en algn momento (de acuerdo a ciertas instrucciones), tener a la mano las credenciales
de un esquema de usuario con privilegios (por ejemplo, el uso del usuario BizagiAdmon).
3. Despus de un Export o Import, se requiere revisar los logs de ejecucin de la operacin, y as
determinar si hubo errores o advertencias que requieren de solucin inmediata. Por ejemplo, puede
darse que en medio de una operacin de Import, los tablespaces se queden sin espacio. Este tipo de
errores no detendrn la operacin, son ajenos a Bizagi, pero deben solucionarse de manera que la
informacin no quede incompleta (se garantice integridad de los datos).
Se requiere adems que el usuario BizagiAdmon ya se haya creado en la instancia de Oracle. Este es
un requerimiento en s de la creacin de proyectos Bizagi sobre Oracle.
Vea ms informacin acerca de la configuracin de Oracle para trabajar con Bizagi.
Ejecutar el Export de DataPump (expdp)

Ilustraremos cmo utilizar el utilitario Export de DataPump para crear un backup con la informacin de
la Base de datos del proyecto Bizagi en un archivo dmp.
Para utilizar el Export de Oracle, se llevan a cabo los siguientes pasos:
1. Consulte el directorio de backups
Para utilizar el Export de DataPump, necesitar especificar el directorio donde podr almacenar el
archivo dmp del backup.
Para hacerlo, primero conctese a su instancia de Oracle con el usuario BizagiAdmon a travs de
sqlplus:
sqlplus BizagiAdmon/%BIZAGIADMON_USER_PASSWORD%@%DATABASE_SERVER%:%
SERVICE_PORT%/%SERVICE_NAME%
En este comando, considere:
%BIZAGIADMON_USER_PASSWORD% es la contrasea del usuario BizagiAdmon.
%DATABASE_SERVER% es el nombre del Servidor de la instancia de Oracle.
%SERVICE_PORT% es el nmero del puerto sobre el cual el servicio atiende.
%SERVICE_NAME% es el alias de la instancia de Oracle.
546
Por lo tanto, puede optar por consultar los directorios creados para su instancia (y decidir si usar la
ruta por defecto de backups definida en Bizagi o usar otra).
Si desea usar otro directorio y crearlo manualmente puede hacerlo mediante el comando a
continuacin:
547
Luego de tener a la mano el nombre del directorio que va a utilizar, desconctese de la sesin
BizagiAdmon en la instancia.
2. Abra una consola de comandos
Vaya a Inicio de Windows, y ejecute una consola de comandos DOS:
548
Seguidamente, navegue hacie la ruta del cliente de Oracle, y dentro de la carpeta bin:
3. Ejecute el Export de DataPump

Para ejecutar el Export tenga en cuenta que debe usar parmetros.
Para ello, ingrese la siguiente lnea:
expdp USERID=BizAgiAdmon/%SCHEMA_USER_PASSWORD% SCHEMAS=%
549
SCHEMA_USER_TO_EXPORT% DIRECTORY=%BIZAGI_BACKUP_PATH% DUMPFILE=%EXPORT_FILE

% LOGFILE=%EXPORT_LOG%
En el comando anterior, considere:
%SCHEMA_USER_PASSWORD% es la contrasea de este esquema de usuario con privilegios system
(BizAgiAdmon).
%SCHEMA_USER_TO_EXPORT% es el nombre del proyecto en Bizagi.
%BIZAGI_BACKUP_PATH% debe corresponder a "BizAgiBackupPath" por defecto, de acuerdo a lo
mencionado en el paso #1 (este parmtero define la ubicacin del backup).
%EXPORT_FILE% es la ruta y archivo que se generar con el backup. Este archivo utiliza comnmente
la extensin .dmp.
%EXPORT_LOG% es la ruta y archivo que se generar con el log del backup. Este archivo utiliza
comnmente la extensin .log.
Para ver ms informacin acerca del Import o Export de DataPump (disponible en versiones de Oracle
10g), consulte enlaces externos de Oracle como: http://www.orafaq.com/wiki/Data_Pump.
4. Revise el log
Despus del Export, se debe revisar y/o resolver los errores no esperados en la operacin.
Para hacerlo, revise detalladamente el log tal donde se especific su ruta en el paso anterior.
El log quedar segn la definicin de "%EXPORT_LOG%".
Tenga en cuenta que el Export utilizar los sets de caracteres definidos en el cliente de Oracle.
Por lo tanto, y como se mencion en los prerrequisitos, se debe garantizar que sea un set de
caracteres igual o compatible al del Servidor, y a los que se usen en el cliente y Servidor al momento
de hacer un Import.
Ejecutar el Import de DataPump (impdp)

Ilustraremos cmo utilizar el utilitario Import de DataPump para restaurar un backup de la Base de
datos del proyecto Bizagi.
Estas instrucciones aplican cuando:
El archivo dmp ha sido creado a travs del Export de DataPump (manualmente con el comando
expdp).
El archivo dmp ha sido creado automticamente por Bizagi. Esto lo realiza Bizagi en escenarios tales
como: antes de un Deployment, o antes de una actualizacin de versin.
Los dmp de backup que Bizagi crea de manera automtica, quedan ubicados en la ruta de backups
configurada al momento de crear proyectos en Oracle (como prerrequisito de configuracin de la
instancia).
550
Tenga en cuenta que este procedimiento no aplica si el backup se ha generado a travs del utilitario
de Export exp. Si este es el escenario, el backup se debe restaurar con el uso del Import imp
(descrito en la seccin previa).
Para utilizar el Import de DataPump de Oracle, se llevan a cabo los siguientes pasos:
1. Asegrese de que no hayan conexiones activas
Para restaurar un backup, se requiere que el esquema de usuario no se encuentre en uso.
Tenga en cuenta que el servicio de Programador de Bizagi (Scheduler) muy posiblemente estar en un
estatus de iniciado y por ende tendr conexiones abiertas. Si este es el caso, deber detener primero
el Programador.
Deber ser cauteloso al momento de garantizar que no hayan conexiones abiertas. Esto quiere decir
que podr verificar que conexiones abiertas hay con BizagiAdmon, mediante el comando:
SELECT s.sid, s.serial#, s.username FROM
gv$session s
JOIN gv$process p ON p.addr = s.paddr AND p.inst_id = s.inst_id
WHERE s.type != 'BACKGROUND' and s.username = '[su_esquema]'
As como tambin podr cerrarlas forzosamente (con el comando siguiente) pero bajo su
responsabilidad y con el control sobre qu sesiones se estn cerrando, y con previa validacin de
que no hayan usuarios trabajando en ese esquema de usuario o proyecto de Bizagi.
ALTER SYSTEM DISCONNECT SESSION '[sid],[serial#]' IMMEDIATE;
2. Elimine el esquema de usuario
Para restaurar, primero eliminamos el esquema de usuario mismo que representa el proyecto.
Para hacerlo, primero conctese a su instancia de Oracle con el usuario BizagiAdmon a travs de
sqlplus:
sqlplus BizagiAdmon/%BIZAGIADMON_USER_PASSWORD%@%DATABASE_SERVER%:%
SERVICE_PORT%/%SERVICE_NAME%
En este comando, considere:
%BIZAGIADMON_USER_PASSWORD% es la contrasea del usuario BizagiAdmon.
%DATABASE_SERVER% es el nombre del Servidor de la instancia de Oracle.
%SERVICE_PORT% es el nmero del puerto sobre el cual el servicio atiende.
551
Seguidamente, ejecute el siguiente comando para eliminar el esquema de usuario en cascada

(cascade):
drop user %SCHEMA_USER_TO_IMPORT% cascade;
Note que %SCHEMA_USER_TO_IMPORT% corresponde al nombre del proyecto.
3. Cree el esquema de usuario de nuevo

Esta vez, creamos el esquema de usuario en blanco.
Para ello, usamos un procedimiento almacenado de Bizagi.
En la misma sesin que tenemos abierta, ejecute el procedimiento "spBA_ORA_CreateAppUser" de
Bizagi:
exec spBA_ORA_CreateAppUser('%SCHEMA_USER_TO_IMPORT%','%
SCHEMA_USER_PASSWORD%');
Ntese que deberamos nombrar con el mismo nombre anterior al proyecto eliminado.
4. Consulte el directorio de backups
Para utilizar el Import de DataPump, necesitar especificar el directorio donde se encuentra el archivo
dmp del backup.
Por lo tanto, puede optar por consultar los directorios creados para su instancia (y decidir si usar la
ruta por defecto de backups definida en Bizagi o usar otra).
552
Si desea usar otro directorio y crearlo manualmente puede hacerlo mediante el comando a
continuacin:
Luego de tener a la mano el nombre del directorio que va a utilizar, desconctese de la sesin
BizagiAdmon en la instancia.
5. Abra una consola de comandos

Vaya a Inicio de Windows, y ejecute una consola de comandos DOS:
553
Seguidamente, navegue hacia la ruta del cliente de Oracle, y dentro de la carpeta bin:
6. Ejecute el Import de DataPump

Para ejecutar el Import de DataPump tenga en cuenta que debe usar parmetros.
554
Estos parmetros son completamente diferentes a los que se utilizaban en el Import imp.
Para ello, ingrese la siguiente lnea:
impdp %SCHEMA_USER_TO_IMPORT%/%SCHEMA_USER_PASSWORD%@%SERVICE_NAME%
REMAP_SCHEMA=%SCHEMA_USER_TO_EXPORT%:%SCHEMA_USER_TO_IMPORT% DIRECTORY=%
BIZAGI_BACKUP_PATH% DUMPFILE=%EXPORT_FILE% LOGFILE=%IMPORT_LOG%
En el comando anterior, considere:
%SCHEMA_USER_TO_EXPORT% es el nombre del esquema de usuario involucrado en el momento de
haber generado el Export.
%SCHEMA_USER_TO_IMPORT% es el nombre del proyecto de Bizagi (donde vamos a restaurar).
%SCHEMA_USER_PASSWORD% es la contrasea de este esquema de usuario (el proyecto donde
vamos a restaurar).
%BIZAGI_BACKUP_PATH% debe corresponder a "BizAgiBackupPath" por defecto, de acuerdo a lo
mencionado en el paso #4 (este parmtero define la ubicacin del backup).
%EXPORT_FILE% es la ruta y archivo donde se encuentra el backup (el .dmp creado con el Export).
%IMPORT_LOG% es la ruta y archivo donde se generar el log de la operacin. Utiliza comnmente
la extensin .log.
Para ver ms informacin acerca del Import o Export de DataPump (disponible en versiones de Oracle
10g), consulte enlaces externos de Oracle como: http://www.orafaq.com/wiki/Data_Pump.
7. Revise el log DataPump

Despus del Import con DataPump, se debe revisar y/o resolver los errores no esperados en la
operacin (no deben haber errrores en un import de Base de datos en Bizagi).
Para hacerlo, revise detalladamente el log tal donde se especific su ruta en el paso anterior.
555
El log quedar segn la definicin de "%IMPORT_LOG%".

El Import debe finalizar notificando que no hubo advertencias si quiera, y que se han habilitado los
constraints de Bizagi.
Tenga en cuenta que el Import de DataPump utilizar los sets de caracteres definidos en el cliente
de Oracle.
Por lo tanto, y como se mencion en los prerrequisitos, se debe garantizar que sea un set de
caracteres igual o compatible al del Servidor, y a los que se usaron en el cliente y Servidor al
momento de hacer el Export de DataPump.
8. Revise la metadata (check metadata)

Para validar que la totalidad de los objetos y registros hayan sido importados, se recomienda utilizar
la opcin de Bizagi para una revisin de la metadata.
Esta opcin esta disponible desde Bizagi Management Console, a travs del botn check metadata:
Mantenimiento de la base de datos

Una tarea muy importante en la administracin de proyectos, es realizar un afinamiento peridico a la
base de datos que sirve de repositorio de procesos de Bizagi.
556
Tenga en cuenta que cada motor de base de datos (SQL Server u Oracle) ofrece las herramientas
necesarias para realizar monitoreo preventivo, diagnsticos (herramientas de perfilamiento), o
acciones de afinamiento sobre la base de datos.
Ante esto, recomendamos al DBA lo siguiente:
1. Monitorear los logs de la base de datos.
2. Utilizar las herramientas especializadas de las bases de datos para realizar perfilamiento y grabar
trazas. Con ello se puede monitorear ciertos comportamientos de las transacciones en la base de
datos y tambin llevar a cabo diagnsticos sobre los aspectos ms relevantes (p.e, el rendimiento).
De esta manera, el monitoreo de la instancia puede anticipar una situacin no deseable (bloqueos,
demoras, etc), y tambin conllevar a
una indicacin sobre las tareas de afinamiento.
3. Llevar a cabo un afinamiento de base de datos peridico.
Los siguientes lineamientos proveen un punto de partida as como tambin recomendaciones tiles
para las tareas de monitoreo, diagnstico y afinamiento de base de datos.
Sin embargo, estos lineamientos no abarcan extensivamente todas las tareas que un DBA debe
realizar para un mantenimiento de la base de datos (la informacin siguiente es enunciativa y no
exhaustiva o taxativa).
Lineamientos para el monitoreo y diagnstico

1. No ejecutar el perfilamiento (profiler) desde el mismo servidor de base de datos.
2. Ejecute un perfilamiento que deje la traza cuando el servidor no se encuentre en horas muy
ocupadas (horario crtico de operaciones).
Podr ser til generar una traza sobre el horario crtico si el escenario lo amerita, sin embargo,
considere un muestreo para evitar afectar el rendimiento del servidor.
3. Incluya filtros en el perfilamiento (por ejemplo, inicialmente slo registre la actividad de su base de
datos).
4. Capture solamente la informacin relevante y necesaria en las trazas en cuanto a los eventos de
informacin que se graban.
Por ejemplo, en SQL Server, podr considerar los procedimientos almacenados: RPC:Completed y
TSQL--SQL:BatchCompleted.
5. Capture solamente la informacin relevante y necesaria en las trazas en cuanto a las columnas de
informacin.
Analice qu aspectos son clave para indicar el estatus del rendimiento de su base de datos.
Por ejemplo, en SQL Server, podr considerar: el consumo de CPU, la cantidad de escrituras
writes-, lecturas, y el tiempo de inicio y de fin.
6. De acuerdo a lo anterior, tambin podr usar filtros para alertar las transacciones potencialmente
problemticas.
Por ejemplo, puede iniciar por obtener slo aquellas cuya duracin es mayor a 3 segundos o cuyo
557
nmero de registros afectados es muy alto.
No se recomienda que los software Antivirus realicen un escaneo sobre los archivos fsicos de la
base de datos.
Lo anterior puede conllevar a bloqueos y demoras de la aplicacin al intentar persistir la
informacin a la base de datos.
Lineamientos de afinamiento
Las tareas de afinamiento se deben realizar en horarios no laborales, y considere que tambin pueden
tomar un tiempo significativo.
1. Verifique la integridad de la base de datos.
2. Reorganice y mantenga los ndices actualizados.
Dentro de esta tarea, asegrese de recrear indices los cuales estn altamente fragmentados, o
reordenar su definicin de acuerdo al orden las columnas consultadas (especialmente cuando
hablamos de ndices compuestos).
3. Actualice las estadsticas de la base de datos.
4. Realice de manera peridica tareas para reducir la base de datos (shrink) .
5. Monitoree el crecimiento y comportamiento de las siguientes tablas de Bizagi:
Workitem
Workitemcl
Wfcase
Wfcasecl
De acuerdo a lo observado, podr revisar cmo est fragmentada la informacin (p.e, los filegroups
en SQL Server o los tablespaces en Oracle).
6. Lleve a cabo tareas adicionales de afinamiento como las recomienda el motor de base de datos y
sus herramientas especficas (o de lo observado a partir de las trazas y logs).
Monitoreo de servidores
Una tarea muy importante en la administracin de proyectos, es monitorear los servidores
involucrados en el sistema Bizagi.
El administrador de plataforma deber mantenerse alerta a cambios significativos o anormalidades en
el comportamiento o rendimiento de los servidores.
558
Los siguientes lineamientos proveen un punto de partida as como tambin recomendaciones tiles
para las tareas de monitoreo y diagnstico de los servidores.
Sin embargo, estos lineamientos no abarcan extensivamente todas las tareas que un administrador
de plataforma debe realizar en cuanto a mantenimiento (la informacin siguiente es enunciativa y no
exhaustiva o taxativa).
Lineamientos
1. Se recomienda utilizar los contadores para el anlisis de desempeo de todos los servidores y en
los chequeos de salud (server health checks).
Para ello, se pueden utilizar las herramientas especializadas del sistema operativo (por ejemplo, en
Windows el Performance Monitor).
2. Monitoree la siguiente informacin de los contadores:
Memory (Available bytes, Pages/sec).
Network interface (Bytes total/sec, Output queue length).
Paging file (% Usage).
Physical disk (% disk time).
Logical disk (% processor time).
Processor (% Privileged time, % Processor time).
System (Processor queue length).
3. Mantenga actualizada la hoja de vida del servidor en cuanto a sus cambios.
Adems de trazas de auditoria o de actualizaciones (p.e service packs), tenga en cuenta que los
cambios importantes en general deben ser registrados (fecha de cambio vs el cambio).
4. Monitoree el servidor de aplicaciones.
Sea si utiliza WebSphere, Weblogic, JBoss o IIS, es recomendado revisar los logs de ejecucin del
servidor donde incluso pueden haber indicaciones del rendimiento involucrado en el mismo.
Adicional a estos logs, monitoree los eventos registrados por Bizagi tambin (por ejemplo, en
Windows, los eventos que se registran en el visor de eventos).
Para los servidores de aplicacin JEE, monitoree los logs del servidor mismo al igual que logs de tipo
FFDC.
La siguiente tabla ilustra los logs de cada servidor donde se puede hacer seguimiento:
SERVIDOR
LOG
WebSphere
SystemErr.log, SystemOut.log, StartServer.log, y StopServer.log
Weblogic
AdminServer.log, [su_domino_Weblogic].log
JBoss
Server.log
IIS
Logs registrados por el visor de eventos
5. Monitoree la ejecucin del servicio programador de Bizagi.

Tenga en cuenta que el servicio se debe estar ejecutando para que las tareas de mantenimiento del
559
sistema se efecten diariamente.

De igual manera, monitoree este servicio para revisar que otras tareas fuera de lnea se realicen de
acorde a las caractersticas del proyecto.
6. Preste atencin al manejo de colas que se presenta en el servidor de aplicaciones para las
ejecuciones asncronas y sus reintentos.
Si cuenta con actividades asncronas, se recomienda revisar con frecuencia el procesamiento de dichas
actividades.
Administracin del entorno

Consulte los captulos de esta seccin para mayor informacin acerca de la administracin
configuracin y parmetros del sistema Bizagi.
Dentro de esta configuracin y parmetros, podr tener en cuenta variables de negocio involucradas
en sus procesos de Bizagi.
Management Console
Introduccin
La consola de administracin de Bizagi (Management Console) es la aplicacin que se utiliza por Bizagi
Engine para la administracin de los proyectos en su ambiente de produccin o pruebas (para las
tareas de mantenimiento como: seguimiento de trabajos programados, el posible cambio de un
servidor SMTP para las notificaciones, habilitaciones de log y trazas, o revisin de parmetros de
conectividad con sistemas externos (integrados en la solucin), o administracin de licencias y montaje
de un clster en el ambiente de produccin, entre otros.
Bizagi Management Console es instalado junto con Bizagi Engine para administrar proyectos en
ambientes de produccin, pero, tambin se instala junto con Bizagi Studio para manejar proyectos en
ambientes de Desarrollo y de Pruebas.
Para abrir Bizagi Management Console, acceda desde la ruta de instalacin del ejecutable (por defecto
en C:\Program Files\BizAgi\BizAgi Studio\MC\BizAgiMC.exe).
560
Interfaz de usuario
Al abrir Bizagi Management Console, la ventana inicial provee atajos para las opciones ms usadas:
561
Entre ellas, es posible:

Crear un proyecto nuevo.
Abrir un proyecto existente.
Administrar los proyectos registrados.
Acceder a la documentacin y guas para comenzar a utilizar Bizagi.
Instalar las plantillas disponibles de nuestra Central de Procesos.
Administrar las licencias del ambiente de produccin.
Note que algunas de estas opciones son las mismas que se presentan desde Bizagi Studio.
Opciones de administracin
Al abrir el proyecto existente en el ambiente de pruebas o produccin, se podrn utilizar las siguientes
opciones de administracin generales o de los mdulos.
Opciones generales
Las opciones generales se presentan desde la cinta de opciones en la aplicacin:
Pestaa en la cinta
Archivo
Opcin
Nuevo
Abrir proyecto
Descripcin
Crea un nuevo proyecto
Abre un proyecto existente
562
Proyectos
Permite
administrar
los
proyectos
registrados(para
actualizarlos, separarlos, etc).
Para
mayor
informacin,
consulte proyecto registrados.
Home
En esta pestaa se presentan

opciones de rpido acceso
segn el mdulo seleccionado.
Consulte las opciones del men

en las secciones de abajo para
las
caractersticas
de
su
proyecto.
Herramientas
Revisar Metadata
Ejecuta en Bizagi una validacin

para detectar errores en la
implementacin del proyecto.
El diagnstico y las validaciones
son especialmente tiles para
validar
la
implementacin
(reglas de negocio, modelo de
datos,
etc)
de
cara
al
Deployment de sus Procesos.
Para mayor informacin sobre
esta opcin, consulte la seccin
inmediatamente abajo.
Configuracin
Entorno
Ensea las configuraciones y

opciones de preferencias en el
ambiente dado.
Para
mayor
informacin,
consulte la configuracin de
Entorno.
Segimiento
Permite habilitar o deshabilitar

las diferentes trazas en la
ejecucin de los Procesos.
Para
mayor
informacin,
consulte Diagnstico y control
de errores.
Borrar casos
Elimina
todos
los
casos
existentes en el ambiente
determinado (aplica solamente
para pruebas o desarrollo).
Contrasea de administracin
Permite cambiar la contrasea

del super usuario Admon. Si la
contrasea no se ha definido
explcitamente, entonces ser
por defecto en blanco.
Ayuda
Presenta
la
opcin
de
descargar como PDF, o navegar
nuestra documentacin oficial.
Ayuda
563
Foros de Soporte
Dirige a nuestro sitio de

soporte, donde se accede a la
plataforma de tickets o a
nuestros foros.
Central de Procesos
Dirige a nuestras plantillas de

Proceso gratuitas de la Central
de Procesos (para descarga e
instalacin de Procesos).
Comentarios
Dirige
a
nuestros
gratuitos de soporte.
Contarle a un amigo
Comparte la informacin y
funcionalidad de Bizagi con un
amigo.
Notas de la versin
Dirige a las notas de la versin

oficiales en nuestro sitio Web.
Administracin de licencias
Permite administrar su licencia

de Bizagi.
Para
mayor
informacin,
consulte sobre Licencias.
Acerca de
Ensea la versin actual de su

proyecto en Bizagi.
foros
Revisar metadata
Revisar la metadata en un proyecto es una buena prctica en etapas de implementacin en el ambiente
de desarrollo.
Esto se debe a que con dicha opcin, se puede detectar de manera temprana cualquier error de
modelamiento que el Deployment de Bizagi detecte en sus validaciones.
Errores que se pueden detectar en la metadata involucran:
La informacin que define los datos del negocio (Entidades, Atributos, Hechos).
La informacin que define todas las rutas posibles que puede tomar un caso de proceso (Procesos,
Fases, reas Funcionales, Tareas, Transiciones).
Las reglas de negocio que definen la ruta que cada caso toma en cada actividad (Expresiones,
Condiciones de Transicin, Reglas de Asignacin, Componentes, Interfases).
Las acciones que se tomaron en cada actividad del proceso (Alarmas, Cartas, Notificaciones,
Interfases).
La informacin que define la estructura de la organizacin (reas, Ubicaciones, Trabajos, Roles,
Habilidades, Calendarios).
La informacin de la interfaz de usuario utilizada en cada actividad de proceso (Formas, Renders,
Validaciones).
La informacin que define los parmetros de negocio (Instancias de Entidades Paramtricas).
En resumen, todo lo que define la manera en la que opera el negocio y describe los datos (pero no
son los datos de casos en s).
564
Para usar la opcin, haga clic en Revisar metadata dentro de la pestaa de herramientas:
Una nueva ventana mostrar los errores que se detecten.
Mdulos
Las opciones en los mdulos permiten tareas de administracin tales como: el Programador y sus
trabajos, Sistemas externos, un ambiente en clster, configuracin en la seguridad y definicin de
grupos de usuarios en la organizacin.
565
Programador
Este mdulo presenta las opciones para administrar el Programador y sus trabajos.
El Programador es un servicio creado en cada proyecto de Bizagi, el cual lleva a cabo ciertas tareas
como: el envo de alarmas, activacin de temporizadores, la ejecucin de la Replicacin, ejecucin de
trabajos personalizados y Actividades asncronas.
En Bizagi JEE, el inicio del servicio Programador es controlado por el Servidor de aplicaciones JEE en
si. Las opciones para iniciar, reiniciar o detener el Programador aplican para Bizagi .NET.
Para mayor informacin, consulte la Administracin de trabajos programados.
Sistemas
Este mdulo presenta las opciones para revisar o reconfigurar los parmetros de conectividad con
sistemas externos integrados a la solucin.
Dentro de tales opciones encontramos: configuracin de Proveedores de datos usados en la
Replicacin y Virtualizacin, interfaces usadas en invocacin de servicios Web o REST, y configuracin
de repositorios ECM.
Para mayor informacin sobre estas opciones, consulte Administracin de sistemas externos.
566
Administracin de sistemas externos.
Organizacin
Este mdulo presenta las opciones para administrar los grupos de usuario o el esquema de tiempo de
trabajo.
Esquema de tiempo de trabajo: Con esta opcin disponible desde el tem de Organizacin, se
mostrar el asistente para configurar el horario y das de trabajo y de festivos. Ms opciones sobre
la definicin de la organizacin se deben editar desde Bizagi Studio y llevadas al ambiente de
produccin mediante el Deployment.
Grupos de usuario: A travs de esta opcin, se puede incluir o excluir usuarios dentro de los grupos
de usuario predefinidos en el proyecto. De requerirse nuevos grupos de usuario, o la redefinicin de
los existentes, se debe hacer en el ambiente de desarrollo con Bizagi Studio.
Cualquier cambio en este mdulo que se realice directamente en el ambiente de produccin, no ser
aplicar en el ambiente de desarrollo. Se recomienda que estos cambios estn sincronizados,
realizndolos en el ambiente de desarrollo y llevndolos a los dems ambientes por medio del
Deployment.
Seguridad
Este mdulo presenta las opciones en la configuracin de Autenticacin, Autorizacin e importar
usuarios LDAP.
Desde el primer Deployment, la configuracin de estos elementos definida desde Bizagi Studio
aplicar en produccin. A partir de ese momento, en el ambiente de desarrollo esta configuracin ser
a modo de lectura.
Cualquier cambio en la Autenticacin o en la importacin de usuarios LDAP deber hacerse por
separado en cada ambiente (mediante estas opciones del Management Console).
Cualquier cambio directamente para las Autorizaciones, si deben hacerse en el ambiente de desarrollo
y ser actualizadas en los dems ambientes mediante el Deployment.
Administracin de Servidores
567
Este mdulo se presenta nicamente en el ambiente de produccin.

Provee la posibilidad de utilizar opciones como: adicionar nuevos nodos a un ambiente en clster,
mover el Servidor de produccin (con licencias y adjuntos).
Para mayor informacin, consulte la Administracin de servidores.
Configuracin de parmetros
La Configuracin de Entorno determina la forma en la que se configura el envo de correos, scheduler
y autenticacin. Esta opcin se encuentra en la pestaa de Configuracin en el men de Bizagi
Management Console.
La configuracin de entorno posee tres opciones:

Popular
Avanzado
Personalizado
568
Antes del el primer deployment, la configuracin de TODOS los ambientes puede ser realizada en el
ambiente de desarollo en Bizagi Studio. El primer deployment se llevar esta configuracin a cada
ambiente. A partir de ese momento los cambios son locales, es decir son independientes para cada
ambiente, desde el Management Console. Si desea que los cambios sean permanentes y sean parte
del diseo del proceso, realice igualmente el cambio en el ambiente de desarrollo.
Popular
Desde esta opcin usted puede configurar los parmetros para envo de correo electrnico en cada
ambiente (desarrollo, Test, produccin)
569
Los parmetros para configurar son

OPCIN
DESCRIPCIN
Habilitar Email
Habilita o deshabilita el envo de correos automticos. Si se habilita, se

enviarn correos electrnicos. De lo contrario, los correos electrnicos se
ignorarn.
Servidor SMTP
Define el nombre del servidor SMTP. El SMTP puede ser local (localhost) para
propsitos de prueba en el ambiente de desarrollo.
Para los ambientes de pruebas y produccin el servidor debe ser el servidor
de la compaa desde donde se envan los correos electrnicos.
Cuenta de Servidor
SMTP
Define la cuenta SMTP (o direccin) utilizada para el envo de correos

electrnicos. Debe ser una direccin de correo vlida en el servidor SMTP.
Si se utiliza un servidor local (localhost) la direccin de correo electrnico
puede ser una que no vlida. Si se utiliza el servidor SMTP real, las direcciones
deben pertenecer al dominio.
Enviar copia de
Define una cuenta de correo electrnico a la cual se enviarn las copias de
570
OPCIN
DESCRIPCIN
Email a
todos los correos enviados por la aplicacin.
Enviar copia Oculta

a
Define una cuenta de correo electrnico a la cual ser enviada una copia
OCULTA de todos los correos enviados por la aplicacin.
Avanzado
Desde esta opcin usted puede configurar los parmetros de caractersticas avanzadas, para cada
ambiente (desarrollo, pruebas, produccin).
Los parmetros que pueden ser configurados son:

OPCIN
DESCRIPCIN
OPCIONES DE SCHEDULER
Intervalo
Configura el intervalo (en horas, minutos y segundos), para cuan
571
OPCIN
DESCRIPCIN
frecuente el servicio de Scheduler monitorear para ver si hay
trabajos pendientes.
OPCIONES DE UPLOAD
Directorio de Upload
Define el directorio fsico donde los archivos subidos por el cliente se

almacenan.
El directorio por defecto en Bizagi Enteprise .NET es: C:\BizAgi
\Enterprise\Projects\[Project name]\Docs
La ruta por defecto en Bizagi Enteprise JEE es el directorio ./
BizAgiDocs ubicado en el home del usuario (p.e. C:\Users\[user]
\BizAgiDocs en Windows).
Tenga presente que [user] corresponde al usuario que inicia el
Servicio del Servidor de Aplicaciones (p.e, usuario root en Linux).
Tamao mximo de Upload
Define el tamao mximo que puede tener un archivo para ser subido
a la aplicacin Bizagi (bytes).
OPCIONES SOA
Forzar llave de negocio de
SOA
La opcin de deshabilitar esta configuracin, aplica para las edicin

Bizagi .NET.
Si est marcado, Bizagi mostrar una excepcin para la actualizacin
de registros por medio de la Capa SOA cuando se intente registrar
una llave de negocio apuntando a una entidad paramtrica, cuyo valor
no exista en Bizagi.
Si no est marcado el valor que no exista quedar en nulo.
OPCIONES DE LOG
Habilitar registro de Jobs
Permite el registro de la informacin en todos los trabajos en

ejecucin.
Habilitar registro Entidades
Permite el registro de informacin en las entidades y el registro de

cambios en la configuracin de usuarios.
Habilitar registro de
relaciones M-M
Si est habilitado, Bizagi crea un registro en la base de datos

(Attriblog) con cualquier cambio (relacionar o des-relacionar)
relaciones M-M (mltiple-a-mltiple)
OPCIONES DE ENTIDAD
(1) Lmite mximo de
longitud de Atributo Y (2)
Lmite de instancias de
Entidades
Las Entidades Paramtricas en el Portal de Trabajo se manejan en

cach si el nmero de atributos es menor que el primer parmetro y
el nmero de registros es menor que el segundo parmetro.
Las Entidades Paramtricas que tengan ms atributos o ms registros
que los umbrales se cargarn por la demanda (acceso a la base de
datos).
Estos parmetros se usan para afinar el rendimiento de la aplicacin
cuando hay un gran volumen de datos.
572
OPCIN
DESCRIPCIN
OPCIONES DE INTERFAZ DE SERVICIOS WEB

Tiempo de Espera
Sirve para configurar un TimeOut para los WebServices sincrnicos. Si

el valor especificado es menor o igual a cero, se ignorar,
comportndose por defecto: el llamado espera una respuesta con
xito o con error, sin importar el tiempo que tome. Dado que esto
puede generar bloqueos y se sugiere configurar un valor.
Umbral para registro
Threshold time in seconds to log interfaces that last more than this
time.
OPCIONES DE NOTIFICACIN DE ANULACIN

Deshabilitar notificaciones
de anulacin
Si se selecciona desactiva la notificacin de los casos que sean

anulados.
Estas notificaciones se envan a todas las personas que tengan tareas
pendientes en el caso en cuestin.
ALMACENAMIENTO DE DATOS OPERACIONALES

ODS
ODS es un mecanismo diseado para mejorar el rendimiento y

disponibilidad del servidor de sus aplicaciones Bizagi
Tipo de Proveedor
Configuracin del uso de la conexin ODS para el proyecto Para ms

informacin dirgase Configuracin ODS
Personalizado
Desde esta opcin usted puede agregar, editar y borrar los diferentes parmetros del proyecto para
cada ambiente (desarrollo, pruebas, produccin).
573
Para agregar nuevos parmetros, d clic en el signo ms (+). Se abrir una nueva ventana. Defina el
nombre, valor y descripcin del parmetro.
El botn Editar mostrar la misma ventana de creacin, pero con la informacin cargada del
parmetro seleccionado.
Seleccionando un parmetro y dando clic en el icono de X, eliminar el parmetro.
Los parmetros personalizados se pueden utilizar en una expresin de scripting de la siguiente
manera:
CHelper.getParameterValue("PARAMETER_NAME") ;
Si usted crea un parmetro personalizado llamado LOGOSPATH, usted puede utilizarlo en una
expresin de la siguiente manera:
var tmp = CHelper.getParameterValue("LOGOSPATH");
En caso que el usuario desee asignar una direccin diferente para el Portal de Usuarios, se debe
modificar el archivo web.config que es archivo de configuracin de la aplicacin (ms
574
especficamente, se debe modificar el valor asociado a la llave SERVER_NAME). Por favor tenga en
cuenta que no se recomienda modificar valores de configuracin directamente en el archivo Web a
menos que sea estrictamente necesario. En lugar de ello, utilice la funcionalidad de Configuracin de
Ambiente cada vez que sea posible.
Parmetros personalizados en produccin
Para garantizar el funcionamiento correcto de todos los ambientes cuando un proyecto ha hecho
deployment los Parmetros Personalizados no podrn ser editados ni borrados.
Administracin de Actividades Asncronas
Introduccin
Cuando hay puntos de integracin en los procesos donde se utiliza una tarea de tipo de Servicio (ya
sea para invocar un servicio Web o REST o utilizar cdigo personalizado para una actividad avanzada
de reglas,por medio de la Librera de Componentes), Bizagi permite este tipo de tareas a ser
configuradas para ejecutarse de manera asncrona.
Cuando se define una tarea de servicio BPMN como una actividad asncrona, Bizagi permite configurar
un nmero de reintentos, en caso de que las acciones de integracin no respondan en un determinado
umbral (por lo general, una invocacin a un servicio externo).
Ver ms informacin acerca de actividades asincrnicas.
Por lo tanto, en este escenario en el que una actividad asincrnica falla (es decir, una aplicacin externa
no se inicia, hay problemas de conectividad, etc) y se supera el nmero de intentos predefinidos, Bizagi
ofrece la posibilidad de que un administrador haga revisin, seguimiento y diganstico y reintente
manualmente estas operaciones.
575
En la imagen de arriba, vemos los parmetros de configuracin para realizar una actividad asncrona,
como se define modelando el proceso.
Dentro de las opciones de administracin de las actividades asncronas, Bizagi almacenar un registro
relacionando las instancias de proceso (casos) que no pudieron ser completadas y el motivo
correspondiente (un mensaje de error).
A travs de esta consola, el administrador podr reintentar manualmente estas actividades que
contengan errores.
Consola de Actividades Asncronas

Para acceder a esta opcin, haga clic en el men Admin en el Portal de Trabajo Bizagi.
Haga clic en Consola de actividades asncronas.
Esta opcin permite al administrador decidir qu tems volver a intentar, de forma individual o en
grupo. Tambin puede ver el log de reintentos o elegir los casos a abortar (si es necesario).
576
Tenga en cuenta que se le presentar una tabla que tiene todas las Actividades asncronas fallidas con
informacin general como: registro de detalle del error, el nmero de caso al que pertenece la
actividad, el nombre de la actividad, el nmero de reintentos hasta el momento, la fecha en que se
cre la primera actividad, y la fecha lmite de reintentos.
Reintentar un tem
Para reintentar manualmente una actividad asncrona, seleccione la pestaa de Actividades Asncronas
y haga clic en el icono Volver a intentar en la fila correspondiente.
577
Reintentar tems especficos

Para reintentar ms de un elemento a la vez, seleccione los elementos en la pestaa Actividades
asncronas y luego haga clic en el botn Habilitar .
Estos items sern marcados para reintento automtico, que se lleva a cabo por el Programador (el
servicio que se instala para cada proyecto Bizagi que realiza ciertas tareas en un intervalo dado).
Reintentar items en grupo
Bizagi permite al usuario reintentar todos los items que han fallado agrupando por proceso o
actividad.
Este reintento no se realiza inmediatamente, se ejecuta por el Programador (ver el detalle en la opcin
anterior).
Para ello, seleccione la pestaa Agrupadas por Actividad.
Haga clic en Activar en la columna Delegar al Scheduler, para que el Programador vuelva a intentar
en las actividades agrupadas por lotes.
578
Tenga en cuenta que puede activar Actividades agrupados por proceso.
Ver Registro de reintentos

Para ver el registro de reintentos que tiene el detalle de la ejecucin (el mensaje de error que causa
que la actividad asncrona falle), haga clic en el icono en la columna Log.
En el registro de actividades asncronas, se encuentra la historia de los intentos con fecha y el mensaje
de error especfico.
579
Administracin de sistemas externos

Bizagi ofrece la posibilidad de gestionar la informacin de los sistemas externos y aplicaciones
integradas en los procesos.
La gestin de esta informacin (Interfaces y parmetros del ECM, bases de datos conectadas a travs
de la replicacin y virtualizacin, etc) se lleva a cabo para cualquiera de los entornos del proyecto:
desarrollo, produccin o pruebas.
Para ello, tendr los Sistemas externos configurados en una vista:
Para gestionar los valores de sistemas externos para el ambiente de desarrollo, use Bizagi Studio por
medio de la configuracin de Sistemas en la vista de Mdulos.
Para gestionar los valores de Sistemas externos para produccin o pruebas, utilice la Consola de
Administracin (Management Console) de Bizagi.
Para ms informacin sobre cmo gestionar especficamente tales valores, consulte lass siguientes
secciones:
Administracin de interfaces: Para editar los valores ajustados en servicios externos invocados por
procesos Bizagi.
Verificacin de replicacin: el hacer seguimiento o editar valores en las bases de datos conectadas
(Entidades replicadas).
580
Administracin de interfaces
Introduccin
Bizagi ofrece la posibilidad de gestionar la informacin de los sistemas externas y aplicaciones
integradas en los procesos.
A travs de las opciones presentadas en la vista del mdulo en la opcin de Sistemas, usted puede
definir interfaces nuevas que se integran a los procesos Bizagi, o editar la informacin de las existentes
(para gestionar los ambientes de produccin o de pruebas).
Las interfaces enumeradas en un sistema, consideran tanto las que invocan un servicio web SOAP y y
servicios REST.
Interfaces de servicios web SOAP se identifican con este icono:
Interfaces para servicios REST se identifican con este icono:
Las Interfaces creadas a travs del Asistente de interfaces, ya sea en el sexto paso del Asistente de
Proceso (Definir interfaces) o como una tarea de evento al Salir, tambin se consideran en este mdulo
de Sistemas. Las Interfaces creadas con el asistente se crean inmediatamente bajo un sistema de autogenerado llamado Default:
La administracin de interfaces en los ambientes de pruebas y produccin se realiza a travs de las
581
opciones de Bizagi Management Console.
Creando nuevas interfaces

Para crear una nueva interfaz desde la vista de Mdulos, asegrese de tener un Sistema creado con la
propiedad activa Habilitar interfaces en este sistema:
A continuacin, haga clic en su Sistema creado y haga clic en la opcin Nueva interface:
Se le mostrar la siguiente ventana:
582
Tenga en cuenta que, por defecto, la nueva interface ser tratada como una interfaz de servicio web
SOAP (Servicio type = SOAP).
Los siguientes campos se presentan:
Nombre : Nombre nico y requerido que identifica a la interface. ste no debe contener espacios.
Mostrar el nombre: Nombre visible para esta interface (requerido).
Descripcin de la interfaz: una descripcin opcional para documentar la informacin relevante para
esta interfaz.
Tipo de Servicio: Opciones de SOAP o REST. Al elegir resto como el tipo de servicio, no habr
campo para especificar mtodo del servicio.
Interfaz de propiedades de la tabla:. Un conjunto de valores de configuracin orientada a entornos
del proyecto (desarrollo, prueba o produccin Este conjunto incluye:
583
Propiedad
URL Servicio Web
La URL de acceso al servicio. Para servicios REST, este campo tendr la URL
Base
Nombre de usuario
Cuando el servicio requiere autenticacin HTTP bsico, este nombre de

usuario se requiere para el acceso al servicio.
Contrasea
Cuando el servicio requiera la autenticacin bsica HTTP, esta contrasea se

requiere para el acceso al servicio.
Dominio
Cuando el servicio requiera autenticacin HTTP bsica, este campo es opcional

para complementar el nombre de usuario, para el acceso al servicio.
Umbral para
registro (en seg)
El tiempo en segundos que define un umbral de servicio esperado para la

interfaz.
Si la invocacin supera esta definicin en ejecucin, entonces se registra una
lnea de trace en el registro .csv log en ".\SOA\Log\" para propsitos de
monitoreo..
El valor predeterminado se establece en 30 segundos, por lo que siempre se
registra si la invocacin tarda ms que este tiempo.
Tiempo de espera
(en seg)
El tiempo en segundos que define el tiempo de espera para cualquier intento

de invocacin de una interfaz.
Si la invocacin supera esta definicin en ejecucin, se genera un error y se
registra en una lnea de trace en el registro. csv en ".\SOA\Log\".
Por defecto esta opcin no se utiliza (su valor inicial es -1).
La invocacin har timeout de acuerdo a esta propiedad, o la propiedad en la
actividad si la invocacin se realiza en una actividad asncrona (se disparar
cualquier timeout de los 2, el cual tenga el menor valor).
Editando una interface existente

Una vez que se hayan definido interfaces ya configuradas en algn punto de los procesos, es posible
tambin editar su informacin desde esta vista.
De manera similar a la creacin de la misma, las opciones para editar una interface permitirn
principalmente: editar o incluir las credenciales usadas en la autenticacin HTTP bsica, o administrar la
URL del servicio.
Para editar una interface existente, d clic derecho sobre la interface y seleccione sus Propiedades.
584
La edicin de servicios REST contempla ciertas consideraciones al momento de editar la URL Base.
Vea las consideraciones relacionadas a interfaces de servicios REST.
Eliminando una interface

Para eliminar una interface, d clic derecho sobre la misma y seleccione la opcin de Eliminar
interface.
Tenga en cuenta que no es posible eliminar interfaces que se encuentren en funcionamiento en el
ambiente de produccin. Bizagi ejecutar las validaciones de su motor de dependencia de manera que
se permita eliminar aquellas interfaces que no estn siendo utilizadas en alguna versin de proceso.
585
Interfaces en produccin
Las interfaces listadas en esta vista de Bizagi Studio, permiten la definicin inicial de sus valores en sus
diferentes ambientes (desarrollo, pruebas y produccin).
Una vez que estas interfaces se encuentre en produccin, su administracin se realizar directamente
sobre cada ambiente en separado.
Esta administracin se realiza directamente desde la consola administrativa de Bizagi, al abrir el
ambiente especfico.
Vea mayor informacin sobre la opcin de administracin de Sistemas desde la Consola de
Administracin (Management Console) de Bizagi.
Verificar Replicacin
Introduccin
Una vez que la Replicacin se ha configurado, usted puede verificar que su ejecucin sincroniza los
valores en las entidades Paramtricas con columnas de las tablas externas.
En los ambientes de pruebas o de produccin, la manera inmediata de hacerlo es mediante las
opciones del mdulo de Sistemas.
Para obtener ms informacin acerca de la replicacin y su configuracin, consulte la Replicacin.
Usando el mdulo de Sistemas

Esta opcin es especialmente til para todos los ambientes de los proyectos.
El mdulo de Sistemas se presenta a travs de la Consola de administracin (Management Console)
para entornos de produccin o de pruebas, con opciones similares a las presentadas en Bizagi Studio
para el ambiente de desarrollo.
Vea ms informacin acerca de la Consola de administracin.
1. Para revisar una ejecucin de Replicacin programada, vaya al mdulo de Sistemas.
Esto mostrar el sistema establecido para su replicacin.
2. Expanda el nodo de elementos y navegue hasta la configuracin del esquema de Replicacin (bajo
586
el nodo de Proveedores, el proveedor especfico, el nodo replicado Entidades, y, finalmente, la clase

predeterminada de replicacin).
Haga clic en el esquema y haga clic en Propiedades de la replicacin:
En esta ventana, seleccione la pestaa Informes de replicacin para mostrar la fecha y la hora de las
ejecuciones de replicacin.
De haber algn error, en lugar del estado de xito, usted ver el estado de error, con su
correspondiente causa (mensaje).
587
Cuando el esquema de replicacin se ha ejecutado con xito, usted puede buscar los valores
replicados en las Entidades Paramtricas en Bizagi, a travs del portal de trabajo en la administracin
de entidades.
3. Adems de este registro, y permitiendo que corra de nuevo la repeticin proceso, puede usar la
opcin Replicar ahora para sus entidades replicadas para iniciar su sincronizacin inmediata:
588
Administracin de trabajos programados

En Bizagi Management Console, se puede usar el mdulo del Programador (Scheduler) para la
administracin de los trabajos que el servicio mismo del Programador ejecuta.
Las siguientes opciones se presentan para este servicio y sus trabajos.
Estatus del Programador
El color del cono del programados indicar el estatus del servicio (gris cuando est detenido, ocre
cuando est iniciado).
Puede iniciar, reiniciar o detener el servicio directamente desde stas opciones.
Para hacerlo, d clic derecho sobre el cono del Programador y seleccione la accin. La accin tambien
aparece disponibles desde la cinta en las opciones del men principal.
589
El Programador debe estar en estatus de iniciado para ejecutar cualquier trabajo programado.
590
Administracin de trabajos programados

Los trabajos programados se dividen como se describen en la tabla presentada a continuacin:
Tipo de trabajo programado
Descripcin
Trabajos de usuario
Los Trabajos de Usuario son un conjunto de

pasos personalizados que pueden ser
ejecutados de acuerdo a una programacin.
Por ejemplo, una regla de negocio que debe
ejecutarse una vez en una fecha especfica, o que
debe ejecutarse peridicamente durante un
intervalo de tiempo dado.
Trabajos de sistema
Bizagi ejecuta ciertas tareas automticas para

asegurar un correcto funcionamiento del sistema.
Esta categora almacena los trabajos
relacionados a tareas de manetenimiento. Se
recomendienda NO manipular estos trabajos, ya
que la informacin se presenta exclusivamente
para seguimiento.
Trabajos de espera
En los trabajos en espera usted puede ver el

estado de los trabajos programados que estan
relacionados al BPMN de los Procesos tales
como: temporizadores o Actividades Asncronas.
Alarmas
Las Alarmas son notificaciones automticas que

se envan a diferentes usuarios, de acuerdo a
criterios relacionados a tiempos. Por ejemplo,
cuando una Actividad esta prxima a vencerse,
se vence o ya ha vencido.
Ntese que independientemente de la clasificacin de la tabla, los trabajos se presentan discriminados

en 2 listas: aquellos que estn a la espera de sus ejecucin, y aquellos que ya han sido ejecutados
exitosamente.
Administracin y reintentos de trabajos en espera

Los trabajos en espera pueden ser administrados tanto para su revisin, como para habilitarlos para
una ejecucin inmediatamente.
Si algn trabajo en espera falla (o la transaccin completa hace rollbak ms adelante por otra
razn), entonces el trabajo ser listado nuevamente como un trabajo en espera.
Dentro de estas opciones tambin es posible revisar el log de la ejecucin del trabajo. Para revisar un
trabajo, haga doble-clic sobre l:
591
Opcin
Descripcin
Agendas de la tarea
En esta pestaa se presentan la planeacin de

los pasos y trabajos.
Logs de ejecucin
En esta pestaa se listan los registros y log de

las ejecuciones previas que ha tenido el trabajo.
Habilitar para ejecucin
Este botn posibilita reactivar un trabajo, para

que ste quede nuevamente programado para
una ejecucin inmediata.
Administracin de Esquemas de Replicacin

You may manage and reconfigure the schedules set for Replication in your project.
Within these options you may also disable the scheduled execution.
592
Consola de administracin de Replicacin

A travs de la Consola de administracin de Replicacin es posible realizar tareas de seguimiento a la
Replicacin, por ejemplo reactivar su programacin para una ejecucin inmediata.
Dentro de esta consola se presentan las siguientes opciones:
Opcin
Logs de Replicacin
Descripcin
En esta pestaa se listan el log y registro de las
ejecuciones de la Replicacin.
593
Programar ahora
Este botn posibilita reactivar la programacin

de la Replicacin, para que esta quede
nuevamente programada para una ejecucin
inmediata.
Propiedades de la programacin de Replicacin

Para revisar o editar la configuracin programada para una Replicacin, acceda a las propiedades de
la misma desde el clic derecho del esquema de Replicacin.
La siguiente ventana mostrar las propiedades:
Por la configuracin presentada en esta pestaa, defina la periodicidad y frecuencia de ejecucin de

acuerdo a la siguiente tabla:
Opciones del programador
Descripcin
Habilitar programador para

la replicacin
Marque esta opcin en Bizagi para ejecutar los

datos de la replicacin desde la fuente de datos
594
externa.
Periodicidad
Marque, diario, semanal o mensual para definir con

que frecuencia Bizagi ejecutar el esquema de
Replicacin.
Cada [...] da(s)
Esta opcin cambiara de acuerdo a la opcin

seleccionada en Periodicidad.
Cuando se selecciona Diario: ingrese el nmero
de das para realizar la repeticin.
Cuando se selecciona semanal: ingrese el nmero
de semanas para realizar la repeticin. Tambin
seleccione en que da de la semana se debe
ejecutar el esquema.
Cuando se selecciona mensual: ingrese el nmero
de meses para realizar la repeticin. Tambin
seleccione en que da del mes se debe ejecutar el
esquema.
Frecuencia diaria
Defina si la ejecucin ocurre una vez al da (y en

que hora), o si se debe ejecutar cada cierto tiempo
(horas, minutos).
Fecha de inicio
Configure la fecha inicial para que el esquema

comience la ejecucin.
Descripcin de las propiedades del programador
Diagnstico y control de errores
Introduccin
Durante las fases de desarrollo de un proyecto (al automatizar los procesos), o en el ambiente de
produccin, hay ciertos escenarios en los que puede desear para rastrear, o hacer seguimiento a la
ejecucin de sus procesos (tambin para depurar).
Bizagi ofrece la posibilidad de hacer rastreo de los errores en los flujos de procesos (para su control y
diagnstico), de modo que los administradores puedan validar si las reglas del negocio, validaciones,
invocaciones interfaces, o incluso el proceso necesita ser afinado.
Para el control de errores de un proyecto, Bizagi presenta su configuracin de Rastreo o Traces.
595
Esta es una opcin poderosa para ayudar a la comprensin y la deteccin de aquellos

comportamientos que requieren un ajuste, o para garantizar que el proceso funcione como se espera
(durante las pruebas).
Tenga en cuenta que los traces no deben dejarse habilitados todo el tiempo, y que por el contrario se
recomienda que se habiliten solo temporalmente para obtener detalle adicional cuando se detecta que
los procesos no se comportan como se espera.
Adems de la posibilidad de consultar Bizagi traces, tambin se puede revisar el log del Servidor
para Bizagi Engine.
En sistemas operativos Windows, Bizagi registrar logs de eventos en el Servidor (los cuales pueden
revisarse en el visor de eventos).
En la edicin Bizagi JEE, es muy importante consultar el log a nivel del Servidor de Aplicaciones JEE
(el log especfico sea: WebSphere, Weblogic o JBoss).
En WebSphere especficamente, tenga presente que hay un log aparte para el registro de errores
(separado del log del servidor como tal).
596
Cmo funcionan los traces?

Los Traces supervisan el proceso en varios niveles, tales como: el proceso y actividades, las reglas de
negocio, validaciones y polticas de negocio, invocaciones interfaces y Formas (con sus campos).
En otras palabras, es posible realizar el seguimiento de todo el proceso y sus objetos / componentes
que hacen parte del Portal de Trabajo.
Para activar y configurar los Traces, puede habilitar cada objeto / componente por separado y
establecer un filtro para que los registros generados incluyan ciertos niveles de detalle (por ejemplo,
las advertencias y los errores, o errores solamente).
Los pasos para esto son:
1. Reconocer cuales son los Traces que se deben activar (de los distintos objetos y componentes).
2. Definir sus detalles del Trace.
1. Reconocer qu Traces activar

La habilitacin de Traces se realiza desde el Management Console (para un ambiente de pruebas o
produccin).
Tenga en cuenta que la funcin de Traces para el uso de troubleshooting (debug) est orientada
principalmente al entorno de desarrollo.
Es muy recomendable aprovechar esta caracterstica mientras se realizan las pruebas de los
procesos a fin de que en el entorno de produccin slo las utilice si es estrictamente necesario.
Por ejemplo, cuando un servicio Web externo ha cambiado y no hubo consideraciones a este
cambio frente a la configuracin en Bizagi, puede ser til habilitar los Traces en el ambiente de
597
produccin para ayudar a detectar comportamientos no deseados.

Al abrir la ventana de configuracin de rastreo (Traces) ya sea desde Bizagi Studio o desde el
Management Console ver los objetos y componentes disponibles:
Es importante reconocer y planificar qu Traces desea habilitar.

La siguiente tabla describe las posibilidades:
ELEMENTO
DESCRIPCIN
598
EntityManager
Registra la ejecucin de EntityManager

(acceso de base de datos).
Interfaces
Registra cuando una interfaz externa se

invoca. Rastrea las peticiones y
respuestas..
LDAP
Regista la ejecucin de la sincronizacin

programada de usuarios de LDAP en
Bizagi.
Render
Registra la construccin Formas en el

Portal de Trabajo (y sus campos).
Reglas y expresiones
Registra la ejecucin y la evaluacin de

las reglas de negocio y polticas.
Los Traces en reglas son
personalizados using la funcin
CHelper.trace
Scheduler
Registra la ejecucin de los trabajos

programados.
Workflow
Registra cuando comienza una

transaccin, cuando la informacin se
guarda en la base de datos, cuando un
caso se crea y la ejecucin de cada
elemento.
Cuando la asignacin est seleccionada,
registra la ejecucin de reglas de
asignacin.
2. Definir el detalle de los Traces

Con el fin de decidir lo se desea rastrear (el nivel de detalle), en la opcin seleccionada en el men de
rastreo, haga clic en el tipo de rastreo y defina el nivel de detalle (Error, Advertencia, todo).
599
Por defecto est seleccionado Apagado (una caja vaca se muestra) para todos los objetos /
componentes.
Cuando Error es seleccionado, el archivo de rastreo slo registra los errores.
Cuando Advertencia se selecciona, el archivo de rastreo rastrear advertencias y errores.
Cuando Todo est seleccionado, el archivo de rastreo registrar: advertencias, errores y paso a paso la
informacin sobre los comandos ejecutados.
Tenga en cuenta que puede seleccionar cada tipo de rastreo (y sus subtipos) y seleccionar una
configuracin de detalle de seguimiento para cada uno.
Despus de guardar los cambios en estos elementos, debe reiniciar el servicio de su servidor de BPM
(p.ej. IISreset en IIS).
Ubicacin de los Traces

Una vez activado, los Traces se guardan como archivos de texto sin formato en el servidor de BPM.
Ellos estarn ubicados en una ruta diferente, de acuerdo con el servidor web especfico y la aplicacin
600
utilizada como servidor de BPM.
En los proyectos que se ejecuten sobre una plataforma de .NET, los Traces se guardarn en:
C:\Bizagi\Projects\[project_name]\Trace\
Los Traces de las interfaces SOA se guardan por separado en:
C:\Bizagi\Projects\[project_name]\Temporary\SOA\
En los proyectos que se ejecuten sobre una plataforma de JEE, los Traces se guardarn en la ruta
temporal de la mquina.
En sistemas operativos Windows, esta ruta ser;
C:\Windows\Temp\Bizagi\
En sistemas operativos Windows, esta ruta ser;
/tmp/Bizagi
Los Traces de las interfaces SOA se guardan por separado segn el servidor de aplicaciones JEE.
Ejemplos y mayor informacin

Como se describi anteriormente, hay ms de 1 tipo de objeto / componente para rastrear.
Lo siguiente describe los Traces ms comunmente usados.
Trace del Portal de Trabajo

El portal de trabajo graba unos logs con el detalle sobre lo que se ejecuta a nivel de aplicacin (Web).
Estos logs se encuentran en la carpeta .\Trace como un archivo llamado BATrace_Web_[fecha].log.
El siguiente ejemplo ilustra la informacin que se graba en estos archivos:
601
Trace del Scheduler (Programador)

El servicio programador graba unos logs con el detalle sobre lo que ejecuta de manera offline.
Estos logs se encuentran en la carpeta .\Trace como un archivo llamado
BATrace_Scheduler_[fecha].log.
El siguiente ejemplo ilustra la informacin que se graba en estos archivos:
Traces en Expresiones (reglas de negocio)

Para esta opcin, adems de activar la opcin de rastreo correspondiente y sus niveles, tambin es
necesario incluir una lnea de comando de seguimiento en el cdigo de la expresin (reglas de
negocio) que se desea rastrear.
Este enfoque generar un registro separado, para cualquier informacin que el usuario desea rastrear.
Para ms informacin, consulte Validar mi regla de negocio.
Traces en interfaces
Para ms informacin sobre como los Traces para la invocacin de interfaces, consulte Diagnstico y
control de errores para servicios Web. Diagnstico y control de errores para servicios Web.
602
Diagnstico y control de errores para servicios Web

Cuando se configuran invocaciones a servicios Web desde Bizagi, puede contar con varias opciones
para el diagnstico y control de errores.
Una de las opciones es el uso de Traces cuando se detecta que hay un inconveniente con la invocacin
a un servicio Web, y por lo tanto se desea obtener mayor detalle sobre este.
Traces de interfaces
Cuando se hace debug en la invocacin de un servicio Web (en ambientes de desarrollo) o cuando se
desea obtener log detallado sobre una ejecucin fallida, se pueden habilitar los Traces de Interfaces.
603
Tenga en cuenta que los Traces de interfaces pueden habilitarse desde Bizagi Studio o desde el
Management Console y se recomienda enfticamente solo habilitarlos de manera temporal (despus
de obtener el detalle deben ser deshabilitados).
Los cambios en la configuracin de Traces posiblemente requieran reiniciar los servicios de su
servidor BPM.
La habilitacin de los Traces es til para detectar en qu punto exactamente hubo un fallo en la
ejecucin, principalmente porque se cuentan con 6 puntos donde se registra detalle que es til para
diagnosticar si el problema est internamente en el servicio Web exterrno, o si se produjo cuando se
realizaban transformaciones de datos a la informacin de Bizagi.
Tipos de Traces
Los siguientes Traces se registran en un orden cronolgico.
Orden
cronolgico
Tipo de Trace
Descripcin
Request mapping JSON (o

Request)
Registra un log con estructura JSON con la informacin

de cmo se realiza el mapeo para los datos de entrada
(involucrando las transformaciones necesarias).
El nombre de este archivo sigue esta estructura:
[identificador_del_caso]
_BizAgiSOARequestMapping_[timestamp].json
Ntese que el timestamp se define como:
yyyyMMddHHmm.
En versiones anteriores de Bizagi, el Request mapping
JSON no se utiliza (y en cambio se registra Request, el
cual deja un log con estructura XML con la informacin
que se extrae de Bizagi).
Request data JSON (o

Request transformed)

de negocio que extrae de Bizagi.
_BizAgiSOARequest_[timestamp].json
yyyyMMddHHmm.
En versiones anteriores de Bizagi, el Request data JSON
no se utiliza (y en cambio se registra Request
transformed, el cual deja un log con estructura XML con
la informacin como se envia despus de aplicar
transformaciones).
604
SOAP Message body Request
Aplica para las invocaciones a servicios Web de tipo

SOAP (los de tipo REST no se incluyen).
Registra un log la informacin detallada de la
invocacin. Esta informacin queda en un archivo con
esta estructura:
SOAP_TraceVersion02_[timestamp].svclog
yyyyMMddHHmm.
En versiones anteriores de Bizagi, se registra el
contenido del XML justo como se envia al servicio
externo pero sin los datos que van en la cabecera de
SOAP (sin el SOAP Header).
SOAP Message body Response
Aplica para las invocaciones a servicios Web de tipo

SOAP (los de tipo REST no se incluyen).
Registra un log la informacin detallada de la
invocacin. Esta informacin queda en un archivo con
esta estructura:
SOAP_TraceVersion02_[timestamp].svclog
yyyyMMddHHmm.
En versiones anteriores de Bizagi, se registra el
contenido del XML justo como se recibe del servicio
externo pero sin los datos que van en la cabecera de
SOAP (sin el SOAP Header).
Response mapping JSON

(o Response)

de cmo se realiza el mapeo para los datos de salida
(involucrando las transformaciones necesarias).
_BizAgiSOAResponseMapping_[timestamp].json
yyyyMMddHHmm.
En versiones anteriores de Bizagi, el Response mapping
JSON no se utiliza (y en cambio se registra Response, el
cual deja un log con estructura XML con la informacin
que se obtiene de respuesta del servicio Web).
Response data JSON (o

Response transformed)

de negocio que proviene de la respuesta del servicio
Web.
_BizAgiSOAResponse_[timestamp].json
605

yyyyMMddHHmm.
En versiones anteriores de Bizagi, el Response data
JSON no se utiliza (y en cambio se registra Response
transformed, el cual deja un log con estructura XML con
la informacin como llega a Bizagi despus de aplicar
transformaciones).
Medida adicional para el control de errores

Se recomienda enfticamente que se definan los tiempos esperados para la invocacin de un servicio
externo, de manera que se pueda tener explcitamente un valor para: el time-out del servicio, y el
tiempo esperado de umbral de la respuesta (logging threshold).
El parmetro para definir el tiempo umbral de respuessta para las interfaces provee un log que da
alertas sobre aquellas interfaces que se estn demorando ms del tiempo esperado. De esta
manera, se puede hacer un diagnstico a los servicios Web y un control anticipado para revisar las
variables que puedan estar afectando el desempeo del sistema externo.
El time-out arrojado por un servicio se da cuando la invocacin del mismo es ms demorada que su
definicin de time-out (o tiempo de espera).
Cuando el servicio es invocado desde una actividad asncrona, esta definicin se toma del menor
tiempo asignado a cualquiera de las 2 propiedades: el timeout de la actividad asncrona, o el time-out
especfico de la invocacin (dado a la interface a travs de su administracin desde el mdulo de
sistemas).
Para mayor informacin sobre estas opciones, consulte la Administracin de interfaces.
Cmo diagnosticar la invocacin a un servicio Web?

Con los siguientes pasos, ilustramos cmo utilizar los Traces de interfaces para detectar o diagnosticar
errores en la invocacin de servicios externos.
1. Detectar el error
Partiendo de las prcticas comunes, podr verificar si hay algn error en la invocacin de un servicio
Web a travs de la Consola de actividades asncronas (desde las opciones de Administracin, ubicada
como Asynchronous Activities console).
Esto aplica para las actividades asncronas.
606
2. Habilite los Traces

A traves de Traces, habilite todos los que se utilizan en interfaces.
3. Vuelva a ejecutar la invocacin (para obtener el log)

Ejecute un reintento de la invocacin para que se registre un log detallado.
Seguidamente, ubique en la ruta de su servidor BPM en la carpeta SOA, el log de la ejecucin (en este
ejemplo con .NET, la ubicacin es C:\Bizagi\[edicin_Bizagi]\Projects
\[nombre_proyecto]\SOA).
Es muy importante tener en cuenta que no en todos los escenarios, se visualizarn todos los tipos de
logs.
Por ejemplo, si el error ocurre en la extraccin de informacin desde Bizagi, entonces solamente el
primer log (Request mapping) quedar registrado dado que el error ocurre antes de que siquiera se
realice la invocacin.
4. Validar los Traces para identificar el error (uno por uno)
Valide la informacin que se registra en estos logs.
Si encuentra que todos los archivos de request estn all, entonces el error debe estar justo cuando
Bizagi invoca el servicio Web, y podr revisar el archivo SOAP_TraceVersion02_[timestamp].svclog o
enviarlo a nuestro equipo de soporte.
607
Tenga en cuenta que este tipo de log puede ser visualizado con herramientas como SvcTraceViewer de
Microsoft, que usualmente vienen en el framework 4.0 de .NET.
Versiones y actualizaciones
Bizagi libera nuevas versiones de manera peridica.
Estas versiones incluyen nuevas funcionalidades poderosas y ajustes o mejoras a las funcionalidades
existentes.
608
Recomendamos enfticamente que se realicen actualizaciones a las nuevas versiones, de manera que
sus proyectos puedan contar con todos los beneficios de las nuevas funcionalidades, mejoras y ajustes
a bugs.
La versin mas reciente en todas sus ediciones, estar disponible para descarga desde nuestro sitio
en www.bizagi.com.
Actualizacin de Bizagi
La actualizacin de versin es un procedimiento simple.
Dado que Bizagi es una solucin orientada al modelo, la actualizacin de proyectos en Bizagi se lleva a
cabo de una manera sencilla: se involucra una actualizacin del modelo de datos, y unos pasos
adicionales para actualizar los dems componentes (como por ejemplo el portal de trabajo) a la nueva
versin.
Se recomienda peridicamente actualizar la versin de su proyecto de Bizagi.

Para mayor informacin sobre estos temas, consulte las siguientes secciones:
Actualizacin de versin de Bizagi.
Actualizacin de edicin Xpress a Enterprise
Resumen
Desde la versin 10.5 de Bizagi se ofrece la Bizagi BPM Suite como un todo, presentando 3 productos
principales que le ayudan a administrar el ciclo de vida completo de sus procesos de negocio: Bizagi
Modeler, Bizagi Studio y Bizagi Engine.
Con esto, simplificamos nuestra oferta eliminado el concepto de edicin y cambindola a un solo
producto anteriormente conocido como edicin Enterprise. Bizagi Xpress no estar disponible y solo
los usurarios de esta edicin se vern afectados por este cambio.
609
Cuando se tenga un proyecto desarrollado con Bizagi Xpress, es posible actualizar el proyecto a la
Suite BPM de Bizagi.
La actualizacin de versin es un procedimiento simple que se lleva a cabo automticamente por
Bizagi.
Este procedimiento siempre ser realizado por primera vez por la actualizacin del ambiente de
desarrollo.
Para actualizar el ambiente de desarrollo, utilice Bizagi Studio.
Siga el procedimiento ilustrado en esta seccin, sobre cmo actualizar su proyecto de la edicin
Xpress a la Bizagi BPM Suite.
Antes de comenzar
Antes de seguir con este procedimiento, asegrese de haber adquirido las licencias de Bizagi BPM
Suite para su ambiente de produccin.
Tenga en cuenta que una licencia adquirida para sus procesos en Bizagi Xpress no aplicarn para la
actualizacin de proyectos a la Bizagi BPM Suite.
La licencia de Bizagi BPM Suite versin 10.5 o superior, debe tenerla a la mano para activarla en el
ambiente de produccin mientras se realiza el proceso de actualizacin, de lo contrario, el Portal de
Trabajo dejar de funcionar.
Si su proyecto utiliza una licencia para el ambiente de Pruebas tambin, deber tenerla igualmente a la
mano.
Para ms informacin sobre las licencias, por favor escriba a sales@bizagi.com.
Concepto de Actualizacin de versin

El procedimiento para actualizar la versin de un proyecto es simple: consiste en abrir un proyecto
existente (creado previamente con Bizagi Xpress), con Bizagi Studio (versiones 10.5 o superiores).
610
Al hacer esto, Bizagi automticamente actualizar la informacin del proyecto en sus registros y no
requiere modificaciones en la base de datos del proyecto (Xpress y Bizagi BPM Suite use la misma
estructura de metadatos de base de datos).
No se crean nuevas bases de datos en este procedimiento.
Con el procedimiento de actualizacin, el proyecto existente y su base de datos sern asociados a
Bizagi BPM Suite.
La edicin Bizagi Xpress y Bizagi Studio en su versin 10.5 pueden ser instaladas simultneamente
sobre el mismo servidor.
A travs de esta opcin, podr seguir trabajando y darle mantenimiento a sus procesos en la Xpress
(si se tiene un deployment urgente), y actualizarse a la versin 10.5 cuando considere que es el
mejor momento.
Prerrequisitos
Las siguientes consideraciones sern incluidas en el procedimiento de actualizacin de esta versin:
Todos los ambientes deben ser actualizados, de lo contrario, no ser posible llevar a cabo el
deployment con el asistente One-click Deployment de Bizagi.
Los pasos presentados en esta seccin van a mostrar el procedimiento para todos los ambientes
actualizando primero en Desarrollo, despus en Pruebas y finalmente en Produccin.
La actualizacin detiene temporalmente el ambiente en ejecucin (se reinicia el IIS) y en dicho
procedimiento, tambin se elimina la licencia previa de Xpress para utilizar la nueva licencia. Por
estos motivos es muy importante que usted planee esta actualizacin, la comunique dentro de su
organizacin y equipo, y la ejecute en un horario no-laboral (cuando el sistema no est activo o en
horas pico).
Adicional a la actualizacin de edicin, el licenciamiento de su servidor de produccin sigue siendo
requerido para acceder al Portal de Trabajo del ambiente de Produccin.
Aunque usted puede crear sus propios backups de los ambientes de los proyectos, Bizagi
automticamente genera un backup de: la base de datos, los archivos "Scheduler" y
"WebApplication" antes de realizar la actualizacin.
En caso de necesitar estos archivos de backup, estos son almacenados en la ruta de backup (en una
configuracin local de SQL Server sera: "C:\Bizagi\Projects\[your_project]\Backups"), como se muestra
en la siguiente imagen:
611
Cuando se tiene la base de datos de SQL Server en una ubicacin remota, esta ruta usualmente estar
en: "C:\Program Files (x86)\Microsoft SQL Server\[Instancia_MSSQL]\MSSQL\Backup\"
En proyectos que usan Oracle como base de datos, la ruta de backupIn projects using Oracle as the
Database, the backup path will be as defined for that given Oracle instance (during project creation).
Procedimiento de Actualizacin
Para este ejemplo del procedimiento de actualizacin, vamos a actualizar los tres ambientes de
nuestro MyBizagiProject de su versin 10.4 (Xpress) a la versin 10.5 y licenciaremos el servidor de
produccin del proyecto.
612
1. Actualizar el ambiente de Desarrollo

Antes de realizar la actualizacin, asegrese que el proyecto no est abierto por Bizagi Studio o por
Management Console.
1.1. Instale la ultima versin de Bizagi Studio en el servidor de Desarrollo que se encuentra disponible
para descarga desde nuestro sitio web.
1.2. Abra el Bizagi Studio instalado en el servidor de Desarrollo (para este ejemplo, la ltima versin es
10.5).
Verifique que ha abierto el Bizagi Studio de la versin 10, usted puede revisar esto asegurndose que
el archivo BizagiStudio.exe que fue ejecutado se encuentra en la ruta seleccionada en la instalacin
(por defecto "C:\Program Files\Bizagi\Bizagi Standard\Studio").
Si usted lo abre desde el acceso directo del escritorio, en el cono se debe leer Bizagi Studio.
613
1.3. Seleccione la opcin Abrir un Proyecto Existente.

En la ventana presentada, seleccione de la lista desplegable de servidores de proyectos, el servidor
donde el proyecto de Xpress fue creado (debera ser el local).
1.4. Seleccione el proyecto a abrir. En la lista desplegable, se le presentar una lista de proyectos en el
servidor seleccionado y su versin actual.
614
Despus de seleccionar su proyecto de Xpress, haga clic en Finalizar.

1.5. Bizagi generar una alerta de que el procedimiento de actualizar un proyecto de Xpress a Bizagi
BPM Suite debe ser realizado.
Haga clic en S para continuar e iniciar la actualizacin.
1.6. Bizagi lanza el procedimiento de actualizacin, el cul toma algunos minutos.
El progreso y los detalles tcnicos se muestran en esta ventana.
615
Una vez el procedimiento a terminado, el proyecto se abrir en Bizagi Studio.

1.7. Como recomendacin y para evitar confusiones mientras se trabaja con este proyecto, en este
punto usted puede proceder a desinstalar Bizagi Xpress del servidor de Desarrollo.
La desinstalacin de Bizagi Xpress puede realizarse a travs del Panel de control del servidor.
616
2. Actualizar el ambiente de Pruebas

Management Console.
2.1. Instale la ultima versin de Bizagi Studio o Bizagi Engine en el servidor de Pruebas que se
encuentra disponible para descarga desde nuestro sitio web.
Si su ambiente de pruebas cuenta con una licencia de usuarios instalada,, siga los pasos 2.2, 2.3 y 2.4.
De lo contrario, podr saltar directamente al paso 2.5.
2.2Abra la herramienta utilitaria llamada DeleteLicense, ubicada en la ruta de instalacion de Bizagi.
Ejecute su archivo DeleteLicense.exe en la ruta %SystemDrive%\Program Files\Bizagi\Bizagi Engine
\MC, asegurndose de contar con permisos de administrador.
617
D clic en Si (Yes) en la ventana de confirmacin que aparece para confirmar que desea eliminar la
instalacin de la licencia actual.
Una vez que haya aceptado eliminar la licencia, ver la ventana de confirmacin.
618
2.3. Abra la versin de Management Console instalada con Bizagi BPM Suite en el servidor de prueba
(para este ejemplo, la ltima versin es 10.5).
Verifique que ha abierto el Management Console de la versin 10, usted puede revisar esto
asegurndose que el archivo BizagiMC.exe que fue ejecutado se encuentra en la ruta seleccionada en
la instalacin (por defecto en C:\Program Files\Bizagi\Bizagi Engine\MC).
2.4. Active la clave de licencia de Bizagi BPM Suite en su servidor de Pruebas.

Esto se hace a travs de la opcin Administracin de Licencias localizada como un cono en la parte
inferior de la ventana inicial.
619
En caso que el servidor de Pruebas no cuente con una conexin a internet, usted debe activar la
licencia desde un servidor que tenga acceso a este y acceso a Internet.
donde el proyecto de Xpress fue creado (debera ser el local).
620

621
Una vez el procedimiento a terminado, el proyecto se abrir en Management Console.

punto usted puede proceder a desinstalar Bizagi Xpress del servidor de Pruebas.
622
3. Actualizar el ambiente de Produccin

Management Console.
3.1. Instale la ultima versin de Bizagi Engine en el servidor de Produccin que se encuentra disponible
para descarga desde nuestro sitio web.
3.2. Abra la herramienta utilitaria llamada DeleteLicense, ubicada en la ruta de instalacion de Bizagi.
Ejecute su archivo DeleteLicense.exe en la ruta %SystemDrive%\Program Files\Bizagi\Bizagi Engine
\MC, asegurndose de contar con permisos de administrador.
623
D clic en Si (Yes) en la ventana de confirmacin que aparece para confirmar que desea eliminar la
instalacin de la licencia actual.
Una vez que haya aceptado eliminar la licencia, ver la ventana de confirmacin.
624
3.3. Abra la versin de Management Console instalada con Bizagi Engine en el servidor de prueba
(para este ejemplo, la ltima versin es 10.5).
Verifique que ha abierto el Management Console de la versin 10, usted puede revisar esto
asegurndose que el archivo BizagiMC.exe que fue ejecutado se encuentra en la ruta seleccionada en
la instalacin (por defecto "C:\Program Files\Bizagi\Bizagi Studio\MC").
3.4. Active la clave de licencia de Bizagi BPM Suite en su servidor de Produccin.

Esto se hace a travs de la opcin Administracin de Licencias localizada como un cono en la parte
inferior de la ventana inicial.
625
En caso que el servidor de produccin no cuente con una conexin a internet, usted debe activar la
licencia desde un servidor que tenga acceso a este y acceso a Internet.
donde el proyecto del ambiente de Produccin de Xpress fue creado (debera ser el local).
626

627
Una vez el procedimiento a terminado, el proyecto se abrir en Management Console.

punto usted puede proceder a desinstalar Bizagi Xpress del servidor de Produccin.
628
En este punto, hemos actualizado todos nuestros proyectos a Bizagi BPM Suite!
Esto significa que podremos usar Bizagi Studio para abrir el proyecto en desarrollo y el Management
Console para administrar nuestros ambientes de Pruebas y Produccin.
Actualizacin de versin
Introduccin
La actualizacin de versin es un procedimiento simple que se asiste por Bizagi.
Este procedimiento siempre debe ejecutarse primero en un ambiente de desarrollo, utilizando Bizagi
Studio.
Consulte el captulo de Bizagi Studio si tiene dudas sobre la actualizacin del ambiente de desarrollo.
En un ambiente de pruebas o de produccin y para proyectos que se ejecuten sobre una plataforma
de .NET, el procedimiento incluye actualizar la versin de Bizagi Engine, y el uso de Bizagi Management
Console.
629
En un ambiente de pruebas o de produccin y para proyectos que se ejecuten sobre una plataforma
de JEE, el procedimiento incluye actualizar la versin de Bizagi Engine para JEE, y seguidamente llevar a
cabo los pasos que se describen en los enlaces siguientes.
Versionamiento en Bizagi
Las versiones de Bizagi se liberan bajo el siguiente esquema de numeracin:
[nmero_versin_mayor].[nmero_versin_menor].[nmero_actualizacin].
[build]
Versiones menores y mayores

Cuando se encuentra disponible una nueva versin de Bizagi, al abrir Bizagi Studio usted ser
notificado acerca de la versin.
Ntese que Bizagi libera versiones mayores y versiones menores.
630
Aunque el procedimiento para actualizar la versin es muy similar para ambos escenarios, los
describiremos de manera separada.
Actualizacin a versiones menores:
Actualizarse a una versin menor significa que su proyecto de Bizagi seguir ejecutndose bajo la
misma versin mayor (el primer dgito que representa el nmero de versin no cambia).
Por ejemplo, una actualizacin de version menor sucede cuando se actualiza una versin de Bizagi 10.x
a otra versin ms reciente de Bizagi 10.x (p.e, de la versin de Bizagi 10.1 a la Bizagi 10.3).
Para ms informacin sobre este procedimiento, consulte Actualizacin menor de versin.
Actualizacin a versiones mayores:

Actualizarse a una versin mayor significa que su proyecto de Bizagi no seguir ejecutndose bajo la
misma versin mayor (el primer dgito que representa el nmero de versin debe incrementarse).
Por ejemplo, una actualizacin de version mayor sucede si su proyecto se encuentra en una versin de
Bizagi 9.1.x y desea utilizar la versin ms reciente de Bizagi 10.x (p.e, de la versin de Bizagi 9.1.8 a la
Bizagi 10.3).
Para ms informacin sobre este procedimiento, consulte Actualizacin de versin mayor.
Actualizacin menor de versin

Para actualizar su proyecto en una versin Bizagi 10.x a las versin ms reciente 10.x de Bizagi, siga las
recomendaciones y procedimiento descrito a continuacin.
Recomendaciones
631
Antes de actualizar su proyecto, recomendamos:

1. Crear archivos de respaldo (backups) de su Base de datos y de las carpetas de su aplicacin.
Esto significa crear un backup de la Base de datos, y tambin crear una copia del contenido de las
carpetas C:\BizAgi\Projects\[su_proyecto]\WebApplication\ y C:\BizAgi\[edicin_bizagi]\Projects
\[su_proyecto]\Scheduler\.
Aunque usted puede optar por crear sus propios backups de la Base de datos y carpetas de la
aplicacin, Bizagi tambin genera automticamente estos respaldos para: la Base de datos, el
servicio Programador (Scheduler) y archivos de la aplicacin Web antes de comenzar la
actualizacin.
En caso de que requiera de estos archivos de respaldo, los podr encontrar en la ruta de backups
(para SQL Server y en un proyecto con Base de datos local, esta ruta ser: C:\Bizagi\Projects
\[su_proyecto]\Backups):
Cuando se tiene la Base de datos remotamente, esta ruta para SQL Server ser: C:\Program Files (x86)
\Microsoft SQL Server\[instancia_MSSQL]\MSSQL\Backup\.
Si se usa una Base de datos Oracle, el backup quedar en la ruta de backups definida para esa
instancia Oracle (tal como se especific al momento de crear el proyecto).
632
2. Siempre actualice primero su ambiente de desarrollo.

Bajo esta misma idea, es muy importante realizar las pruebas unitarias que garanticen que los
Procesos existentes tienen un comportamiento adecuado.
Una vez se haya verificado esto, podr actualizar su ambiente de pruebas y llevar a cabo las pruebas
de aceptacin de usuario en este ambiente.
Luego de certificar que los Procesos estn OK tanto en desarrollo como en pruebas, y de acuerdo a la
criticidad de sus Procesos, usted puede crear un ambiente llamado Replica de produccin.
El fin de este ambiente, es para realizar la actualizacin y probar los Procesos de produccin con las
instancias activas (casos reales).
Y de esta manera, solamente despus de la revisin de Procesos e instancias en el ambiente de
Replica de produccin, proceder a actualizar su ambiente real de produccin.
El ambiente llamado Replica de produccin, es un proyecto de Bizagi el cual tiene restaurado en l,

un backup del ambiente de produccin.
Este ambiente no es el de produccin en si, ya que por ejemplo en l se debern cambiar los
parmetros de produccin como por ejemplo: el servidor SMTP real, los correos reales de los
usuarios, las URL de servicios Web o puntos de integracin, o cualquier otra informacin susceptible
del ambiente real.
Todos los ambientes deben ser actualizados o de lo contrario no se podr realizar el Deployment de
procesos (publicacin a los otros ambientes).
3. Planee la actualizacin del ambiente de desarrollo y coordnelo con su equipo de trabajo.
La actualizacin de versin debe coordinarse previamente entre el equipo de trabajo involucrado, ya
que la actualizacin se realiza en el servidor BPM y deber hacerse cuando el equipo de trabajo no
est realizando cambios sobre el proyecto.
4. Planee la actualizacin del ambiente de produccin en un horario no laboral.

Esto se debe a que la actualizacin de versin detendr temporalmente los servicios (por
aproximadamente 3 minutos).
5. No realice la actualizacin de versin si tiene un Deployment marcado como Release Candidate

pendiente por llevar a produccin.
Deber cerciorarse de que se hayan aplicado los release candidate de Deployment pendientes.
Prerequisito
Para actualizar la versin de Bizagi de su proyecto, recuerde que primero debe actualizar su ambiente
de desarrollo.
Para actualizar su ambiente de desarrollo, actualice el instalador de Bizagi Studio (descargable desde
633
nuestra pgina oficial de descarga en www.bizagi.com), y luego ejectelo directamente en su Servidor

BPM de desarrollo.
Tenga en cuenta que se debe realizar la actualizacin directamente desde el servidor de desarrollo
BPM (el cul alberga el proyecto, en caso de tener configurado un entorno de trabajo colaborativo).
Actualizacin de Bizagi Engine

Una vez que haya verificado exitosamente el comportamiento de los procesos en el entorno de
desarrollo, puede actualizar sus dems ambientes (primero el de pruebas, y luego el ambiente de
Replica de produccin si se utiliza, y finalmente, produccin).
Si usted ejecuta sus procesos sobre una plataforma .NET, entonces para los otros ambientes la
actualizacin se realiza siguiendo un procedimiento similar al llevado a cabo en desarrollo, y bajo las
mismas recomendaciones.
El procedimiento ser:
Tomar backups y planear la actualizacin previamente.
Primero se instala la ltima versin de Bizagi Engine que corresponda a la misma versin de Bizagi
Studio en desarrollo.
Se actualiza el proyecto a travs de Bizagi Management Console.
Se verifica el comportamiento adecuado de los procesos.
Si usted ha instalado Bizagi en un ambiente de pruebas o produccin de manera manual (como se
indica en Configuracin del ambiente Bizagi), entonces contacte a nuestro equipo de soporte para
hacer la actualizacin de versin (que se realizar de una manera manual).
Si usted ejecuta sus procesos sobre una plataforma JEE, entonces para la actualizacin de sus
ambientes de prueba y produccin, consulte la Actualizacin de versin en la edicin Enterprise JEE.
Bizagi libera nuevas versiones de manera peridica.

Estas versiones incluyen nuevas funcionalidades poderosas y ajustes o mejoras a las funcionalidades
634
existentes.
Recomendamos que se siempre realice la actualizacin a la nueva versin, de manera que sus
proyectos puedan contar con todos los beneficios de las nuevas mejoras y funcionalidades.
La actualizacin de versin es un procedimiento simple, el cual lo notifica y se realiza con Bizagi
gilmente.
Cuando se ha instalado una versin nueva, por medio de Bizagi Studio al abrir el proyecto podr
actualizarlo automticamente en su ambiente de desarrollo.
Para los ambientes de pruebas o produccin se debe llevar a cabo un procedimiento diferente.
Esta seccin describe cmo actualizar la versin en los ambientes de pruebas o de produccin de
proyectos Bizagi ejecutndose sobre una plataforma JEE.
Para ms informacin acerca de la actualizacin del ambiente de desarrollo, consulte Actualizacin de
versin.
Antes de comenzar
Antes de actualizar su proyecto, recomendamos enfticamente:
1. Crear archivos de respaldo (backups) de su Base de datos y de la aplicacin.
Esto significa crear un backup de la Base de datos, y tambin crear una copia de la aplicacin en el
2. Siempre actualice primero su ambiente de desarrollo, luego el ambiente de pruebas y despus el de
Produccin.
Tambin evale si requiere del ambiente adicional que es Rplica de produccin.
Es muy importante realizar las pruebas unitarias que garanticen que los Procesos existentes en el
ambiente de desarrollo tienen un comportamiento adecuado.
635
Una vez se haya verificado esto, podr actualizar su ambiente de pruebas y llevar a cabo las pruebas
de aceptacin de usuario en este ambiente.
Luego de certificar que los Procesos estn OK tanto en desarrollo como en pruebas, y de acuerdo a la
criticidad de sus Procesos, usted puede crear un ambiente llamado Replica de produccin.
El fin de este ambiente, es para realizar la actualizacin y probar los Procesos de produccin con las
instancias activas (casos reales).
Y de esta manera, solamente despus de la revisin de Procesos e instancias en el ambiente de
Replica de produccin, proceder a actualizar su ambiente real de produccin.
El ambiente llamado Replica de produccin, es un proyecto de Bizagi el cual tiene restaurado en l,

un backup del ambiente de produccin.
Este ambiente no es el de produccin en si, ya que por ejemplo en l se debern cambiar los
parmetros de produccin como por ejemplo: el servidor SMTP real, los correos reales de los
usuarios, las URL de servicios Web o puntos de integracin, o cualquier otra informacin suceptible
del ambiente real.
3. Planee la actualizacin del ambiente de produccin en un horario no laboral.
Esto se debe a que la actualizacin de versin detendr temporalmente los servicios y por lo tanto
deber agendarse debidamente.
4. Tener a la mano los archivos de configuracin (y de despliegue) proporcionados por Bizagi (BizAgiear-Websphere-dist.zip, BizAgi-ear-Weblogic-dist.zip, o BizAgi-ear-JBoss-dist.zip) de acuerdo a su
Lo que debe hacerse

Para actualizar la versin en su ambiente de pruebas o de produccin, estos son los pasos a seguir:
1. Actualice la informacin en su Base de datos de Bizagi.
2. Reemplace los archivos de configuracin y libreras que utiliza Bizagi.
3. Generar el portal de trabajo haciendo el despliegue de la aplicacin al Servidor de Aplicaciones.
Procedimiento
Siga el detalle proporcionado para cada paso:
1. Actualice la informacin en su Base de datos de Bizagi.
Para llevar a cabo este paso, por favor contacte a nuestro equipo de soporte.
2. Reemplace los archivos de configuracin y libreras que utiliza Bizagi.
Este paso implica reemplazar los archivos de configuracin que utiliza Bizagi, por su versin ms
reciente (aquellos incluidos en los archivos de distribucin BizAgi-ear-Websphere-dist.zip, BizAgi-earWeblogic-dist.zip, o BizAgi-ear-JBoss-dist.zip).
Esto se realiza de acuerdo a si usted utiliza WebSphere, Weblogic o JBoss, como se describe en el
paso 1: Extraer los archivos usados por Bizagi de cada gua en particular para configurar el Servidor de
Aplicaciones JEE.
636
Para WebSphere consulte la Configuracin de WebSphere.

Para Weblogic consulte la Configuracin de Weblogic.
Para JBoss consulte la Configuracin de JBoss.
Tenga en cuenta que debe realizar este paso para cada nodo (implicando que se debe repetir si su
solucin cuenta con una configuracin en clster).
Cuando se reemplacen estos archivos de configuracin (driver y otras libreras .jar principalmente),
tenga en cuenta que debe considerar el nombre exacto que ya se est referenciando en la
configuracin de su Servidor de Aplicaciones.
Esto significa que se recomienda asegurarse que los jars se renombren para garantizar que se haga
la referencia por su nombre sin necesidad de incluir la versin especfica.
Es importante eliminar cualquier versin vieja de las libreras, dado que al final de la actualizacin,
no se debe tener ms de una version para una misma librera .jar.
3. Generar el portal de trabajo haciendo el despliegue de la aplicacin al Servidor de

Aplicaciones.
Para ms informacin sobre este paso, consulte el Despliegue de la aplicacin hacia un Servidor de
Aplicaciones JEE.
Importante
Tenga en cuenta lo siguiente para actualizar su versin de Bizagi:
Al actualizarse a Bizagi 10.5 o superior, deber cerciorarse de editar el archivo consoleconfiguration.properties que se utiliza por la Consola Administrativa JEE.
Para editarla, deber incluir una referencia a la ruta de un archivo de propiedades.
Realice esto, adicionando al final del archivo lo siguiente:
bizagi_extended=[Ruta_al_archivo_de_propiedades]
Tenga presente que deber utilizar / como el separador de directorios, y que esta ruta no deber
contener espacios en blanco.
637
Seguidamente, asegrese de contar con ese archivo de propiedades (o crearlo en su defecto incluso
vaco), exactamente en la ruta que se defini anteriormente (en este ejemplo, es un archivo plano
ubicado como C:\BizagiJEE\BizagiConsoleManagerJEE\bizagi-extended.properties).
Actualizacin mayor de versin
Para actualizar su proyecto 9.1.x a la versin ms reciente de Bizagi 10.x, ejecutndo sus procesos en
una plataforma de .NET (anteriormente conocida como la edicin Bizagi .NET), por favor revise la
informacin sobre la Actualizacin a Bizagi 10.x.
Si usted tiene un proyecto en la versin 9.1.x ejecutndose en una plataforma de JEE (anteriormente
conocida como la edicin Bizagi JEE), y desea actualizarse a una versin Bizagi 10.x, por favor
contacte nuestro equipo de soporte.
638
Si por el contrario, usted desea realizar una actualizacin menor de versin, consulte la Actualizacin
menor de versin.
Desinstalacin de Bizagi Engine

Usted puede desinstalar Bizagi Engine de su servidor.
En Windows abra Programas haciendo clic en el botn de Inicio
luego Programas o Desinstalar un programa.
, dando clic en Panel de control y
En Windows 8 puede buscar Panel de Control escribiendo Control en la barra de bsqueda y

seleccionando Panel de Control, luego seleccionando Programas.
639
Una nueva ventana mostrar los programas instalados.

Seleccione Bizagi Engine y d clic en Desinstalar. Si se necesitan permisos de administrador ingrselos.
640

Administración Del Sistema Bizagi PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Administración Del Sistema Bizagi PDF

Uploaded by

Copyright:

Available Formats

Bizagi BPM Suite

Parte I Administracin del Sistema Bizagi

Configuracin de la base de datos

Configuracin del servidor BPM

Otras opciones de configuracin

Copyright 2014 - Bizagi

Deployment de Procesos ................................................................................................................................... 428

Copyright 2014 - Bizagi

Administracin del Sistema Bizagi

Copyright 2014 - Bizagi

1. Administrador de Bases de datos (DBA).

Configuracin de la base de datos

Copyright 2014 - Bizagi

Consulte los captulos en esta seccin para ms informacin acerca de:

Requisitos de la base de datos

Requisitos al utilizar SQL Server

Copyright 2014 - Bizagi

Versiones y ediciones soportadas

SQL Server 2012

SQL Server 2008 R2, service pack 1

SQL Server 2008, service pack 1

SQL Server 2005, service pack 2

Todas las ediciones se soportan: Enterprise, Standard o Express.

Verificando la configuracin en SQL Server

Copyright 2014 - Bizagi

configuracin y herramientas cliente de SQL Server.

Esta consulta debe mostrar el detalle completo de la instancia:

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

3. Login de usuario autorizado

Copyright 2014 - Bizagi

Asegrese de que tenga el rol sysadmin:

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

Cuando se ejecutan los procesos sobre una plataforma .NET, considere:

Copyright 2014 - Bizagi

<add key="DSNDB" value="Current Language=us_english;Initial

Requisitos al utilizar Oracle

Versiones y ediciones soportadas

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

Configuracin requerida para Bizagi

Verificando la configuracin en Oracle

Copyright 2014 - Bizagi

Edite el script ConfigureInstanceForBizAgi-[Oracle_Version].sql.

Copyright 2014 - Bizagi

Copyright 2014 - Bizagi

El script anterior puede cambiar en cada versin de Bizagi.

Instalacin de Oracle Data Provider para .NET

Instalacin ODAC requerida?

Servidor donde se ejecuta el

Usando Oracle como la base de datos de Bizagi

Usando Virtualizacin para integrar Oracle

Usando Replicacin para integrar Oracle

Copyright 2014 - Bizagi

Para instalar el componente siga estas instrucciones.

1. Escoger el instalador adecuado

2. Instalar ODAC y su conector ODP.NET

Seguidamente, asegrese de marcar Oracle-Data-Provider for .NET: