Administración Del Sistema Bizagi

Bizagi BPM Suite
Gua de Usuario
Tabla de Contenido
Parte I Administracin del Sistema

Bizagi
Configuracin de la base
de datos
...................................................................................................................................
8
Requisitos de la base de datos
Requisitos al utilizar SQL Server
.......................................................................................................................................................... 9
......................................................................................................................................................... 9
Requisitos al utilizar Oracle
......................................................................................................................................................... 22
Instalacin de Oracle Data Provider para .NET ......................................................................................................................................... 27
Configuracin de Bizagi ODS
.......................................................................................................................................................... 30
Definicin del ODS en el Servidor de Aplicaciones

JEE
.........................................................................................................................................................
37
Configuracin del servidor

BPM
...................................................................................................................................
42
Configuracin de Bizagi Engine .NET
.......................................................................................................................................................... 43
Instalacin del IIS
......................................................................................................................................................... 44
Windows Server 2012 R2 o 2012
......................................................................................................................................... 46

Configuracin del sistema Bizagi
......................................................................................................................................... 54
......................................................................................................................................................... 61
Administracin de Servidores y Clsters
......................................................................................................................................................... 79
Configuracin de mltiples servicios Programador
......................................................................................................................................... 99
Utilizar un repositorio externo para la sesin ......................................................................................................................................... 108

Recomendaciones de seguridad en la configuracin
......................................................................................................................................................... 116
Recomendaciones bsicas
......................................................................................................................................... 116
Recomendaciones intermedias
......................................................................................................................................... 121
Configuracin del portal por fuera del sitio por
defecto
...................................................................................................................................
129
Recomendaciones avanzadas
......................................................................................................................................... 135
Configuracin de Bizagi Engine JEE

.......................................................................................................................................................... 143
Consola JEE de Bizagi
......................................................................................................................................................... 144
Configuracin del Servidor de Aplicacin JEE
para trabajar con Bizagi
.........................................................................................................................................................
151
Lista de chequeo de la configuracin JEE en el .........................................................................................................................................
servidor BPM
151
Configuracin de WebSphere
......................................................................................................................................... 155
Configuracin de WebSphere en clster
................................................................................................................................... 155
Preconfiguracin de WebSphere para soporte
a clster
...................................................................................................................................
157
Configuracin de WebSphere en clster para
trabajar con Bizagi
...................................................................................................................................
174
Configuracin del Scheduler en WebSphere................................................................................................................................... 232
Configuracin estndar de WebSphere
................................................................................................................................... 234
Configuracin de Weblogic
......................................................................................................................................... 303
Configuracin de Weblogic para soporte a clster
................................................................................................................................... 303
Preconfiguracin de Weblogic para soporte...................................................................................................................................
a clster
305
Configuracin de Weblogic en clster para trabajar
con Bizagi
...................................................................................................................................
321
Copyright 2002-2016 Bizagi. Todos los derechos reservados.
Configuracin del Scheduler en Weblogic
................................................................................................................................... 363
Configuracin estndar de Weblogic
................................................................................................................................... 365
Configuracin de JBoss
......................................................................................................................................... 416
Configuracin de JBoss para soporte a clster
................................................................................................................................... 416
Configuracin de JBoss en clster para trabajar
con Bizagi
...................................................................................................................................
418
Configuracin del Scheduler en JBoss
................................................................................................................................... 441
Configuracin estndar de JBoss
................................................................................................................................... 443
Configuracin de la arquitectura del sistema
......................................................................................................................................................... 458
Configuracin del balanceo de cargas
......................................................................................................................................... 461
Balanceo de cargas con WebSphere
................................................................................................................................... 462
Balanceo de cargas con Weblogic
................................................................................................................................... 468
Balanceo de cargas con JBoss
................................................................................................................................... 470
Configuracin de Replicacin y Virtualizacin ......................................................................................................................................... 474
Configuracin de Replicacin y Virtualizacin...................................................................................................................................
en JBoss
476
Configuracin de Autenticacin Federada
......................................................................................................................................... 483
Despliegue a un Servidor de Aplicacin JEE ......................................................................................................................................................... 511
Despliegue hacia WebSphere
......................................................................................................................................... 512
Despliegue hacia Weblogic
......................................................................................................................................... 524
Despliegue hacia JBoss
......................................................................................................................................... 529
......................................................................................................................................................... 540
Otras opciones de configuracin

................................................................................................................................... 563
Configuracin de la conexin a su..........................................................................................................................................................
servidor de correo
563
Configuracin del servicio SMTP a travs del
IIS
.........................................................................................................................................................
564
Configuracin del servicio SMTP a travs de.........................................................................................................................................................
Postfix
576
Configuracin de Bizagi en Amazon

WS
..........................................................................................................................................................
580
Configuracin de Bizagi para el acceso
seguro desde Internet
..........................................................................................................................................................
580
Deployment de procesos
y nuevas versiones
...................................................................................................................................
588
Consideraciones y requerimientos
.......................................................................................................................................................... 589
Deployment de los objetos
......................................................................................................................................................... 597
Relacionar objetos
......................................................................................................................................................... 606
Deployment en un clic
.......................................................................................................................................................... 611
Deployment a Pruebas
......................................................................................................................................................... 615
Release Candidate en Deployment a Pruebas......................................................................................................................................... 634
Deployment a Produccin
......................................................................................................................................................... 637
Mejoramiento continuo
......................................................................................................................................... 648
Gua para nueva versin de Proceso
Deployment Avanzado
Ejemplo de Deployment Avanzado
................................................................................................................................... 654
.......................................................................................................................................................... 658
......................................................................................................................................................... 675
Mantenimiento y administracin
................................................................................................................................... 686
Respaldar Bizagi
.......................................................................................................................................................... 688
Backups de base de datos
......................................................................................................................................................... 690
Backups y su restauracin en SQL Server
......................................................................................................................................... 691
Export e Import en Oracle
......................................................................................................................................... 708
Backups del Portal de trabajo y Programador

......................................................................................................................................................... 719
Monitoreo
.......................................................................................................................................................... 721
Monitoreo de infraestructura y plataforma......................................................................................................................................................... 722

Monitoreo de los servicios
......................................................................................................................................................... 725
Mantenimiento de la base de datos

.......................................................................................................................................................... 731
Mejores prcticas en ambientes de
produccin
..........................................................................................................................................................
735
Administracin del entorno
Management Console
.......................................................................................................................................................... 736
......................................................................................................................................................... 737
Volver a crear desde la base de datos
......................................................................................................................................... 745
Configuracin de parmetros
......................................................................................................................................................... 749
Administracin y configuracin de seguridad
en la autenticacin
.........................................................................................................................................................
759
Administracin de Actividades Asncronas ......................................................................................................................................................... 772
Administracin de sistemas externos
......................................................................................................................................................... 777
Administracin de la conexin a SAP
......................................................................................................................................... 778
Administracin de interfaces
......................................................................................................................................... 779
Verificar Replicacin
......................................................................................................................................... 787
Administracin de trabajos programados ......................................................................................................................................................... 790
Diagnstico y control de errores
......................................................................................................................................................... 796
Diagnstico y control de errores para servicios.........................................................................................................................................
Web
806
Diagnstico y control de errores para SAP
Versiones y actualizaciones
......................................................................................................................................... 811
.......................................................................................................................................................... 813
Actualizacin de Bizagi
......................................................................................................................................................... 814
Actualizacin de edicin Xpress a Enterprise ......................................................................................................................................... 814
Actualizacin de versin
......................................................................................................................................... 834
Actualizacin menor de versin
................................................................................................................................... 836
Actualizacin de versin en la Enterprise JEE................................................................................................................................... 839
Actualizacin mayor de versin
Desinstalacin de Bizagi Engine
................................................................................................................................... 842
......................................................................................................................................................... 842
Parte I
Administracin del Sistema

Bizagi
Administracin del Sistema Bizagi

Introduccin
La administracin del Sistema Bizagi consiste de procedimientos y lineamientos, prcticas
recomendadas e informacin descriptiva que le ayudar a planear y ejecutar este tipo de tareas:
Configuracin inicial de BIzagi Engine en un ambiente de produccin.
Configuracin de otros componentes que hacen parte de su arquitectura de sistema corporativa, de
manera que trabajen junto con Bizagi Engine.
El deployment de los procesos y nuevas versiones (mejoras que son orientadas al negocio).
Tareas de administracin y mantenimiento (relacionadas a las operaciones), y recomendaciones para
el monitoreo de Bizagi Engine.
Componentes 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.
Bizagi provee un servicio Scheduler (Programador), 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 balanceador de cargas opcional, por hardware o software, que debe estar configurado
adecuadamente cuando se utiliza una solucin de Bizagi en clster.
Un servidor HTTP opcional, principalmente configurado con capacidades de proxy inverso para el
acceso al Portal desde Internet de manera segura.
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.
Copyright 2002-2016 Bizagi. Todos los derechos reservados
Un sistema ECM utilizado como gestor documental.

Un ESB (bus) que facilita servicios integrados.
O incluso, uno o ms sistemas ofreciendo servicios Web a los procesos de Bizagi.
Uno o ms sistemas SAP integrados a Bizagi por medio del conector de SAP.
Una o ms bases de datos integradas a travs la Virtualizacin o Replicacin de Datos de Bizagi.
Otras aplicaciones o directorios y archivos externos que estn siendo usados directamente por APIs
o libreras registradas en Bizagi a travs de la funcionalidad de la Librera de componentes.
Perfiles requeridos
De acuerdo a los componentes que hacen parte de la solucin Bizagi, para una buena administracin y
mantenimiento de la solucin, 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, sea un sistema operativo Windows o de tipo *nix como Linux).
De igual ste deber poder manejar, orientar o escalar las configuraciones relacionadas a otros
sistemas o infraestructura adicional involucrada (p.e, el balanceador de cargas, servidor proxy, etc).
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 sobre servicios en
la nube (p.e de Amazon AWS, Azure), 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 y nuevas versiones.
5. Para informacin sobre las tareas de mantenimiento de los proyectos Bizagi y del Sistema Bizagi en
general, consulte Mantenimiento y administracin.
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).
Informacin adicional sobre la configuracin en clster de su base de datos, considerando el nodo
virtual, balanceador o SAN, no se describe/instruye por Bizagi.
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 2014
12.0.2000
SQL Server 2012
11.0.2100 o superior
SQL Server 2008 R2, service pack 1
SQL Server 2008, service pack 1
Para Bizagi Engine, se soportan ediciones Estndar o superior.

SQL Server Azure no est soportado.
La base de datos debe instalarse con una intercalacin (collation) que cumpla lo siguiente:
Sea insensible a maysculas, "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 que utilice la autenticacin SQL Server y que tenga los permisos
necesarios para la ejecucin de los procesos (en la base de datos de Bizagi).
Un login de usuario sysadmin se requiere aparte para tareas administracin de la solucin.
Aislamiento tipo snapshot
Deber asegurarse de tener habilitado el aislamiento tipo snapshot (Snapshot isolation), y que ste
tenga nivel read-committed.
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
10
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):
11
Luego, en las opciones de Seguridad, asegrese de est marcado Autenticacin SQL Server y
Windows.
12
2. TCP/IP protocol
Ejecute el SQL Server Configuration Manager.
13
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:
14
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.
15
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 sysadmin (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:
16
Asegrese de que tenga el rol public:
17
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.
18
Los mapeos de usuario db_datareader, db_datawriter, public, rlBA_SQL_BizagiWebApp y

rlBA_SQL_ExecuteBizagiSPs aplican para la base de datos del proyecto de Bizagi. Esto significa que
usted podr aplicarlos una vez que ya tenga creada la base de datos de Bizagi en su ambiente de
produccin.
Recuerde que para crear la base de datos de Bizagi, usted ha debido usar el login de usuario con
privilegios sysadmin.
Verifique que este login de usuario est habilitado y permitido para conectarse, bajo sus opciones
de Status:
19
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:
20
<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 JEE, 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.
4. Aislamiento tipo snapshot

Podr verificar que la base de datos de Bizagi tenga habilitado el modo snapshot isolation.
Especficamente:
Allow Snapshot isolation: True (ALLOW_SNAPSHOT_ISOLATION ON)
Is Read-committed snapshot isolation on: True (READ_COMMITTED_SNAPSHOT ON)
21
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
Las ediciones soportadas son la Estndar y la Enterprise (la edicin Express de Oracle XE no est
22
soportada).
Se soportan sets de caracteres (configuracin de character_set) en Oracle tanto que sean Unicode o
que no sean Unicode. Sin embargo, tenga en cuenta lo siguiente:
La migracin de bases de datos Oracle a Unicode (desde una configuracin previa no unicode) no
se soporta.
Para bases de datos Unicode de Oracle, los atributos de tipo cadena (string) almacenarn un
mximo de 1000 caracteres.
Si sus atributos requieren almacenar ms de 1000 caracteres entonces deber utilizar los atributos
de texto extendido.
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.
23
3. Se recomienda asignar como mnimo al tamao de bloque 8000 bytes (block size), y 300 procesos
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.
24
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:
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)
25
Edite el script ConfigureInstanceForBizAgi-[Oracle_Version].sql.

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.
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_LOBS_DATAFILES_DIR: La ruta donde Bizagi crear los datafiles para almacenar objetos de tipo
LOB.
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.
26
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
27
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:
28
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.
29
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.
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 opcional, aunque 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.
Esta opcin es recomendada incluso, cuando se desea integrar herramientas de reportera u otras de
inteligencia de negocios (BI), de manera que estas herramientas no realicen consultas directamente
sobre la base de datos transaccional.
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:
30
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).
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.
31
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
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
32
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.
Esta opcin tambin est disponible a travs de Bizagi Studio para el ambiente de desarrollo:
33
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.
La configuracin vara de acuerdo al servidor y plataforma sobre la cul se ejecutan sus procesos.
Cuando se utiliza en Bizagi una plataforma .NE,T primero escoja el tipo de Proveedor (Provider type), y
seguidamente ingrese los detalles.
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.
34
Contrasea: La contrasea para esa cuenta de login.

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.
Cuando se utiliza en Bizagi una plataforma JEE considere lo siguiente:

Para usar la funcionalidad del ODS, usted debe haber definido previamente la fuente de datos
dentro de su servidor de aplicaciones JEE, de manera que desde all se tenga la conexin a la base
de datos que es rplica,
Este paso vara ligeramente de dependiendo del servidor de aplicaciones especfico (Weblogic,
WebSphere, JBoss).
Para mayor informacin sobre este paso, consulte Definicin del ODS en el servidor de aplicaciones
JEE.
35
Una vez que haya definido la fuente de datos dentro de su servidor de aplicaciones JEE, seleccione
el uso de Fuente externa (External Datasource) como el tipo de proveedor.
Seguidamente, digite el nombre exacto de la fuente de datos que se registr en su servidor de
aplicaciones JEE, dentro del campo Datasource Name.
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.
36
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.
37
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).
38
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).
39
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).
40
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.
41
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.
42
La capa BPM soporta una configuracin de balanceo de cargas para la escalabilidad de la solucin
(usando configuracin en 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
sobre plataforma .NET.
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 .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.
43
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.
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 R2
44
8.0
Windows Server 2012
7.5
Windows Server 2008 R2
7.0
Windows Server 2008
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...
Web Management Tools
IIS 6 Metabase compatibility
IIS 7 o superior.
IIS Metabase y IIS 6

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

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

rendimiento.
Autenticacin Bsica
IIS 7 o superior, al realizar

configuraciones adicionales de
seguridad, especialmente para los
servicios SOA de Bizagi.
Autenticacin de Windows
IIS 7 o superior, cuando se usa

autenticacin Windows.
Restricciones de IP y dominio
IIS 7 o superior, al realizar

configuraciones adicionales de
seguridad, especialmente para los
servicios SOA de Bizagi.
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
45
Bizagi.
Consulte la seccin que corresponda a su sistema operativo:
Windows Server 2012
Windows Server 2008 R2 o Windows Server 2008
Recuerde que la configuracin del IIS que se menciona en esta seccin y en los enlaces anteriores,
pertenecen a la configuracin esperada de Bizagi Engine para un ambiente de produccin.
Por lo tanto, los sistemas operativos de tipo Server de Windows (Windows Server) son los
detallados y recomendados enfticamente.
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
Trabajo para los proyectos.
Introduccin
Esta seccin ilustra la configuracin del IIS (Internet Information Services) como prerequisito de un
ambiente de produccin de Bizagi Engine sobre una plataforma de .NET.
Aunque Windows Server 2012 R2 trabaja con IIS en su versin 8.5 y Windows Server 2012 trabaja con
IIS en su versin 8.0 por defecto, el procedimiento e interfaz grfica es muy similar.
Para mayor informacin sobre este prerequisito, consulte Instalacin del IIS.
Instalacin del IIS

Para instalar o revisar la instalacin del IIS en el servidor (y los componentes que requiere Bizagi), siga
los pasos mencionados 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:
46
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).
47
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.
48
D clic en Siguiente (Next).

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

Cuando se le pregunte por las caractersticas requeridas, asegrese de adicionar los requerimientos
(haciendo clic en Adicionar caractersticas).
50
Asegrese de marcar las casillas como se ensea a continuacin:
51
52
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.
53
Haga clic en Cerrar (Close).
Introduccin
Esta seccin ilustra la configuracin del IIS (Internet Information Services) como prerequisito de un
ambiente de produccin de Bizagi Engine sobre una plataforma de .NET.
Aunque Windows Server 2008 R2 trabaja con IIS en su versin 7.5 y Windows Server 2008 trabaja con
IIS en su versin 7.0 por defecto, el procedimiento e interfaz grfica es muy similar.
En estos sistemas operativos, la instalacin del IIS se realiza como un rol, y se configura con estos
pasos:
Para mayor informacin sobre este prerequisito, consulte Instalacin del IIS.
Instalacin del IIS

Para instalar o revisar la instalacin del IIS en el servidor (y los componentes que requiere Bizagi), siga
los pasos mencionados a continuacin.
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.
54
2. En la ventana de administracin del Servidor, ubique el tem de roles, y seleccione la opcin de

Adicionar Roles.
Esta opcin inicia un asistente para configurar el IIS seleccionando los items y componentes.
55
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.
56
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.
57
4. Seleccione los servicios de rol que se requiere para el Portal de Trabajo de Bizagi.
58
59
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.
Una vez que proceda y de el visto bueno, comenzar la instalacin.
60
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.
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.
61
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.
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, revise y asegrese ed lo siguiente:
1. 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 y se recomienda contactar a nuestro equipo de soporte para asegurarse de tener la
activacin de la licencia en su ambiente en clster (para todos los nodos BPM).
2. Considerar las implicaciones en una instalacin manual.
Cuando se configura el ambiente de ejecucin de Bizagi Engine de una forma manual, tenga presente
que as mismo deber proceder cuando desee actualizar su proyecto a una versin ms reciente de
Bizagi.
62
Planee esto consistentemente para prever una actualizacin que involucra un inventario, donde se
reemplazarn archivos y se ejecutarn scripts.
Contacte a nuestro equipo de soporte team para una asistencia en este procedimiento.
Adicionalmente, tenga presente que es recomendado instalar tambin Bizagi Management Console (en
una mquina con acceso al servidor de base de datos), de manera que usted pueda administrar los
parmetros del proyecto, como se describe en la seccin de Pasos adicionales.
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:
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.
63
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:
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
64
(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:
Seguidamente, asegrese de otorgarle permisos de full control.

Ntese que se recomienda utilizar una cuenta de servicio que tenga estos permisos y que est
validada ante su dominio y la red (usar una cuenta de servicio).
65
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 Security Info=True;User
ID=[cuenta_login];Password=[contrasea];Data Source=[instancia_bd];Initial
Catalog=[base_de_datos];" />
<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
66
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.
67
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).
68
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): [su dominio/cuenta de servicio]
Asegrese de seleccionar la cuenta de que se configur en el paso 3 con 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\
Ntese que se recomienda utilizar una cuenta de servicio que tenga estos permisos y que est
validada ante su dominio y la red (usar una cuenta de servicio).
69
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...:
70
Ntese que por defecto, y usualmente esta aplicacin Web se crea bajo el sitio por defecto del IIS
llamado Default Web site.
Sin embargo, usted puede utilizar un sitio Web diferente, considerando el nmero del puerto bajo el
cual sube la aplicacin de ser diferente al puerto 80 por defecto.
Para mayor informacin sobre esta posibilidad, consulte la Configuracin del portal por fuera del sitio
por defecto.
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
71
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
72
(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:
Seguidamente, asegrese tambin de otorgar los siguientes permisos a estas cuentas:

USUARIO
PERMISOS
ASPNET
Modify, Write
[su dominio\cuenta de servicio]
Modify, Write
SYSTEM user
Full control
73
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:
ID=[cuenta_login];Password=[contrasea];Data Source=[instancia_bd];Initial
Catalog=[base_de_datos];" />
Considere:
o [instancia_bd]: La instancia de la base de datos que incluye el nombre del servidor.
74
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:
75
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:
76
[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:
De clic derecho sobre el programador para editar sus propiedades.

Asegrese de que el servicio se inicie bajo la misma identidad (cuenta de servicio) que se utiliz para
el pool del IIS:
77
Ntese que el servicio que quedar registrado como BizAgi[nombre_proyecto]SchedulerService y que

al final 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
78
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.
Cuando se define el repositorio de documentos de su proyecto (donde se almacenarn los adjuntos

de los casos), tenga presente que si utiliza un servidor de archivos (con una carpeta compartida),
entonces deber asegurarse de que la cuenta de servicio especificada en las secciones anteriores
(para el inicio del pool de aplicaciones y el servicio Programador), tenga acceso de lectura y
escritura a dicha carpeta compartida.
Recuerde que si utiliza una configuracin en clster donde se tiene ms de un nodo BPM, entonces
en cada nodo se debera poder acceder a esa carpeta compartida con los permisos requeridos.
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.
Para administrar su infraestructura, usted podr: llevar a cabo la configuracin de un clster para el
Servidor BPM, adicionar o remover nodos a ese clster BPM, o mover el Servidor BPM a otro servidor
fsico.
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.
79
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
80
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.
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).
81
Esto se debe a que todos los nodos BPM debern tener un acceso a un repositorio compartido de los
documentos adjuntos, con los permisos necesarios para esa cuenta que inicia los servicios de Bizagi.
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.
Manejo de clsters (Mdulo de administracin de Servidores)

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
(para as lograr balanceo de carga).
82
Este mdulo est disponible en el Management Console para ambientes de produccin.

Las opciones descritas a continuacin consideran opciones para el manejo de clsters, por lo que
alguna de las opciones solo saldrn dependiendo de si se maneja un ambiente en clster, y dichas
opciones aplican nicamente para proyectos usando una plataforma de .NET.
Bizagi manejar automticamente las licencias que estn activas en el Servidor.
Para configurar un clster, registramos nodos adicionales al Servidor BPM actual utilizando las
opciones de Administracin de 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.
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.
83
Para cada nodo que se desee agregar, siga los siguientes pasos:
1. Utilice la opcin de Adicionar servidor.
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.
84
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. Defina su servidor.
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.
85
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.
86
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 muchas caractersticas donde hay tareas programadas
o ciertos trabajos fuera de lnea, que sean de alta exigencia y demora en el procesamiento.
Se recomienda instalar un servicio adicional del Programador para tener una arquitectura de sistema
redundante (evitar single-points-of-failure) de alta disponibilidad.
Si se instala un servicio adicional del Programador, considere que debe configurarlo como se describe
en Configuracin de mltiples servicios del Programador.
Las tareas programadas o trabajos fuera de lnea que realiza el servicio Programador,
principalmente incluyen: las ejecuciones de Actividades Asncronas, la sincronizacin en la Replicacin
de datos, trabajos personalizados, sincronizacin con LDAP, entre otros.
87
Haga clic en Siguiente para continuar.

4. Confirme esta configuracin.
Al finalizar, Bizagi mostrar la confirmacin del xito en la operacin. De ocurrir algn error, ser
enseado en esta ventana.
88
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).
89
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.
inicial.
90
produccin.
Para cada nodo que se desee agregar, siga los siguientes pasos:
1. Utilice la opcin de Eliminar servidor.
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.
91
2. Revise y confirme la accin.

Asegrese de contemplar que la accin de eliminar servidor sea la que usted desea realizar.
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.
92
Cuando se tiene una configuracin de clster para el Servidor BPM (ms de un nodo para el Portal de
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.
93
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.
94
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.
95
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.
96
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.
97
Finalice dando clic en Cerrar.
Notificaciones usando enlaces al caso

Al configurar un clster BPM o al modificar el punto de entrada de su sistema de alta disponibilidad (la
URL del balanceador de cargas), considere el siguiente aspecto de configuracin para las
notificaciones de sus procesos.
Para utilizar enlaces a casos dentro de correos electrnicos (hyperlinks que directamente lleven a los
usuarios finales a una especfica tarea de un caso), deber asegurarse de configurar en el sistema esa
URL de entrada que corresponda a la que se maneja por su balanceador de cargas.
Para ello, edite los archivos de configuracin de todas las instancias del Portal de trabajo de Bizagi en
su clster, e instancias del servicio Programador de manera que cada uno de ellos pueda construir la
URL apropiada.
Esto se realiza dado que por defecto, cada instancia del Portal de trabajo y del Programador, utilizar
la URL local sin asumir que se utiliza un balanceador de cargas.
Para editar esta configuracin, modifique el archivo web.config de cada Portal de trabajo (ubicado por
defecto como C:\Bizagi\Projects\[su_proyecto]\WebApplication\) y cada archivo de configuracin del
Programador llamado BizAgi.Scheduler.Services.exe.config (y ubicado por defecto como C:\Bizagi
\Projects\[su_proyecto]\Scheduler\).
Al editar cada archivo, incluya las siguientes lneas dentro del elemento <appSettings>:
<add key="SERVER_NAME" value="SU_VALOR"/>
<add key="APP_NAME" value="SU_VALOR"/>
<add key="PROTOCOL" value="HTTPS"/>
Considere que debe incluir el valor de Protocol que sea HTTPS, cuando se utilice HTTPS sobre SSL en
vez de HTTP, si este es su caso (por defecto se maneja como HTTP).
Note que para el valor de SERVER_NAME deber especificar la IP o nombre virtual del balanceador de
cargas, mientras que para APP_NAME el valor deber ser el correspondiente al sitio virtual que
98
procesa el balanceador.
Tenga presente que el enlace de las notificaciones se construir de la siguiente manera:

[PROTOCOL]://[SERVER_NAME]/[APP_NAME]/[OTROS_PARAMETROS_DEL_ENLACE_AL_CASO]
Cuando se configura Bizagi en un esquema de alta disponibilidad, es muy importante asegurarse

que el puerto UDP nmero 11000 sea permitido en los nodos de su clster BPM donde est
instalado Bizagi.
Este puerto UDP es utilizado en la comunicacin y sincronizacin de la cache de Bizagi que involucra
a los componentes de Bizagi.
Configuracin de mltiples servicios Programador
Introduccin
Cada proyecto de Bizagi necesita un servicio instalado en el servidor BPM llamado el Programador
(incluido por la instalacin de Bizagi Engine) .
El Programador es un agente ejecutado por Bizagi el cual est a cargo de realizar el mantenimiento
del sistema, las tareas fuera de lnea -asncronas- y otros trabajos que se ejecuten en un segundo
plano y que pueden ser programados (configurados para ser lanzados peridicamente).
Cuando ejecuta sus procesos en una plataforma .NET, el Programador se instala como servicio de
Windows con un nombre que hace referencia al nombre del proyecto especfico.
El Programador puede ser configurado en clster para soportar balanceo de cargas de estas tareas
que son ejecutadas en segundo plano.
La siguiente imagen ilustra una configuracin de alta disponibilidad, donde se involucra un servicio
redundante del Programador:
99
Sin embargo, para proyectos que requieren significativamente ejecutar tareas en segundo plano, usted
puede instalar y instancias adicionales del Programador, ya sea instalndolas en servidores aparte
(nodos del clster), instalndolas en el mismo servidor, o bajo cualquier combinacin de las anteriores:
100
Al configurar mltiples servicios del Programador, ntese que aunque se pueden configurar varias
instancias sobre un mismo nodo, siempre ser ms recomendable configurarlos lo ms
independientemente posible (de manera que cada nodo utilice su propio servidor dedicado y
recursos).
Esto se debe a que as se evitan los puntos nicos de fallo (ante una eventual falla en un nodo, no se
afectar ms de una instancia del Programador).
Por ejemplo, usted podr optar por diversos servidores separados ejecutando el Programador
(segn las necesidades de su proyecto), incluso de manera aislada al Portal de trabajo de Bizagi.
Por qu configurar mltiples servicios del Programador?

Por defecto, cada proyecto de Bizagi opera con una instancia del servicio Programador.
Sin embargo, usted puede configurar mltiples servicios del Programador y cada uno de estos
trabajar en un lote de tareas de segundo plano, de manera paralela.
Esto le permite lograr uno de los siguientes 2 aspectos, o ambos:
1. Configuracin de un sistema con arquitectura de alta disponibilidad.
En esta configuracin, usted puede tener un clster BPM para contar con capacidades de balanceo de
cargas, donde cada nodo es un Bizagi Engine operacional con sus 2 componentes principales: el Portal
de Trabajo de Bizagi (web application) y el Programador.
De esta manera, la arquitectura de su sistema evita nicos puntos de fallo (de manera que si un nodo
falla, el otro contine trabajando y no haya interrupcin del servicio).
101
Para ms informacin sobre la configuracin del clster BPM, consulte Administracin de Servidores y
Clsters.
2. Escalabilidad del Programador.
En algunos escenarios y de acuerdo a las caractersticas de la implementacin del proyecto, el uso de
ms de un servicio de Programador procesando las tareas en segundo plano, es til para asegurar
que las tareas en segundo plano no permanecen mucho tiempo en una cola.
De acuerdo al anlisis especfico de la cantidad de tareas que el Programador necesita procesar en un
tiempo dado y su SLA esperado (p.e dado por su anlisis de dimensionamiento), usted puede instalar
y configurar ms de una instancia del Programador en el mismo servidor y sin la necesidad de hacer lo
mismo para el Portal de Trabajo (escalar nicamente el Programador).
Antes de empezar
Los pasos que se describen a continuacin, partes desde un proyecto ya configurado (Bizagi Engine
configurado adecuadamente, sea en clster o en una arquitectura de servidor nico).
Observe que a pesar de tener mltiples servicios del Programador, se distribuir la carga de las tareas
en segundo plano entre ellos, identifique el siguiente tratamiento:
1. Slo un Programador va a ejecutar el mantenimiento del sistema
El mantenimiento del sistema que es llevado a cabo por el Programador, involucra mover la
informacin desde las tablas transaccionales en la base de datos y se lleva a cabo en horas no
laborales.
Cuando se tiene mltiples Programadores, es importante predefinir qu Programador estar
encargado de ejecutar el mantenimiento del sistema, de tal manera que pueda configurarlo
adecuadamente (un Programador "maestro").
2. Cada Programador tomar un lote de 10 tareas
Cuando cada servicio de Programador est listo para procesar tareas (de acuerdo a la definicin del
intervalo del Programador, como se describe en Configuracin de parmetros de Bizagi), bloquear
previamente un lote de 10 tareas aunque vaya a trabajar con una a la vez y sea incierto cunto tiempo
tomar procesar la primera (o el lote completo).
El lote de 10 tareas y las tareas en segundo plano procesadas por el Programador en general, siguen
el algoritmo de prioridad PEPS (una cola Primero en Entrar, Primero en Salir).
Lo anterior implica que la cantidad de tareas entrantes a procesar en un momento dado (en un
periodo de tiempo muy corto), no excede las 10 tareas, entonces es comn que el uso de servicios de
Programador adiciona no balanceen las cargas entre ellos.
Qu necesita hacer?
Para configurar mltiples servicios del Programador, lleve a cabo los siguientes pasos:
1. Instale los servicios del Programador adicionales.
Esto se hace ya sea a travs de la opcin clsters de la Consola de Administracin o a travs de una
instalacin manual.
Se deben tener en cuenta consideraciones de nombramiento especiales cuando instale mltiples
servicios del Programador en el mismo servidor.
2. Configure los servicios del Programador adicionales.
102
Recuerde que slo un Programador debe ejecutar el mantenimiento del sistema.

Las configuraciones adicionales orientadas al nmero de hilos ejecutados por cada Programador son
opcionales para optimizar el paralelismo.
Procedimiento
Siga estos pasos.
1. Instale los servicios del Programador adicionales

Los Programadores adicionales son creados a travs de la opcin clsters de la Consola de
Administracin cuando se crea un primer servicio del Programador en dicho servidor.
Para ver ms informacin sobre la configuracin del clster de BPM con un Programador adicional,
consulte Administracin de Servidores y Clsters.
Si est instalado mltiples servicios del Programador en el mismo servidor, lleve a cabo lo siguiente:
1.1 Cree una copia (clone) de la carpeta de Scheduler.
Copie, pegue y renombre la carpeta localizada por defecto en C:\Bizagi\Projects\[su_proyecto]
\Scheduler\.
Haga esto por cada servicio del Programador adicional que requiera en ese mismo servidor.
En este ejemplo, vamos a tener 3 servicios en el servidor:
1.2 Edite los archivos .bat dentro de las nuevas carpetas Scheduler.
Como una mejor prctica, asegrese de editar todos los archivos .bat para mostrarlos listos cuando se
necesiten.
103
Edite install.bat, installx64.bat, uninstall.bat y uninstallx64.bat cambiando el nombre del servicio del
Programador, de tal manera que es nico dentro del mismo servidor:
Observe que en este ejemplo, usamos el mismo nombre seguido de un sufijo numrico.
Para el servicio nmero tres, tenemos:
104
Guarde los cambios cuando termine.

1.3 Ejecute el archivo installx64.bat (o install.bat si aplica) para instalar cada nuevo servicio del
Programador.
D clic en el archivo .bat de instalacin de acuerdo a la arquitectura de su sistema para instalar el
servicio.
Haga esto por cada servicio del Programador adicional que se desee instalar.
Asegrese de tener privilegios de administrador y que tuvo una ejecucin exitosa:
Al final, debe ver sus servicios de programador adicionales instalados y listados en sus servicios de
Windows:
105
No inicie los servicios en este punto (necesitara editar primero su configuracin).
2. Configure los servicios del Programador adicionales

Define cul de todos los servicios de Programador llevar a cabo las tareas de mantenimiento.
Considere todos sus servicios de Programador dentro de la solucin (solo 1 dentro de todos los
nodos que pueda tener en un clster, incluyendo los mltiples servicios que pueda tener en cada
nodo).
Podemos llamar al primero como el Programador "maestro" y este no requerir configuraciones
adicionales.
Para todos los otros servicios de programador, edite el archivo .config localizado por defecto en C:
\BIZAGI\PROJECTS\[your_project]\SchedulerN3\BizAgi.Scheduler.Services.exe.config e incluya la
siguiente llave dentro del elemento <appSettings>:
<add key="DisableAsynchCaseClosing" value="1"/>
106
Al configurar ms de una instancia del Programador en un mismo nodo, es fundamental que

tambin edite la ubicacin de la carpeta temporal que usa cada Programador por aparte (para
evitar inconvenientes que puedan surgir cuando mltiples servicios intenten acceder a los mismos
archivos de manera simultnea).
Para especifica el uso de una carpeta temporal diferente para cada instancia de Programador, edite
la llave Project asegurndose se asignar un valor diferente, no repetido, en cada archivo de
configuracin.
Por ejemplo, usar para 2 instancias en un mismo nodo:
<add key="Project" value="Scheduler1" /> y <add key="Project"
value="Scheduler2" />.
En este punto puede guardar los cambios e iniciar el servicio del Programador (un inicio libre de
errores valida que todos trabajen juntos):
107
Consideraciones cuando use Actividades Asncronas

Como una configuracin adicional, puede poner a punto los parmetros de procesamiento de los
Programadores incluyendo la siguiente llave en sus respectivos archivos .config (dentro del elemento
<appSettings>) para configurar el nmero de hilos que usar cada servicio del Programador:
<add key="MaxThreadsForAsynchWorkitems" value="[numero_de_hilos]"/>
Esta llave es til especialmente cuando su proyecto espera un gran nmero de ejecuciones de tarea
asncronas, en grandes bloques.
Cuando seleccione modificar el nmero de hilos usados por el servicio del Programador (por
defecto usa uno), asegrese de considerar un balanceo apropiado de cargas entre el nmero de
servicios del programador que usar y el numero de hilos que ejecuta cada uno en paralelo.
Tenga en cuenta que al modificar este valor debe ser analizado y probado adecuadamente, de
acuerdo al nmero estimado de tareas en segundo plano, las caractersticas y el estimado del
procesamiento involucrado en cada una de estas tareas y lo ms importante, de acuerdo a las
caractersticas del hardware subyacente (e.g nmero de ncleos y procesadores de sus servidores).
Se recomienda vigilar este valor y optimizarlo como sea necesario mientras lleve a cabo las pruebas
de aceptacin para este escenario para usar la distribucin ms adecuada.
Cuando use mltiples servicios del programados para procesar mltiples actividades asncronas, se
recomienda incluir la siguiente llave:
<add key="DisableInterfaceErrorLogger" value="1"/>
Esta llave optimiza el desempeo debido a que omite el log en el archivo .csv para los threshold y los
timeout y previene los incidentes potenciales cuando mltiples servicios escriben en el mismo archivo.
Notas importantes
Cuando se tienen multiples servicios del programador, todos estos servicios deben ser detenidos
antes de hacer un deployment de proceso.
De igual manera, con esta configuracin, considere sus mltiples servicios del programados cuando
actualice la versin de Bizagi de tal manera que detenga y actualice todos (e.g actualizar el archivo
mpas reciente de la librera usada por ellos).
Utilizar un repositorio externo para la sesin
Introduccin
Cuando se utiliza una configuracin de clster para el servidor BPM, por defecto, cada uno de los
mltiples nodos que hacen parte de ese clster BPM almacenarn los datos de la sesin del usuario.
Sin embargo y principalmente para contar con una mayor capacidad de escalabilidad y mejor
confiabilidad, se puede optar por delegar las sesiones de manera externa a un repositorio
108
centralizado,
Podr hacerlo para que Bizagi utilice la funcionalidad de una base de datos para sesin (session state
database), o un servidor para sesin (session state server), tal y como lo soporta el framework de .NET
de Microsoft.
Generalmente, el uso de un session state server debe proveer mejores tiempos de respuesta, sin
embargo el uso de una session state database soporta de mejor manera una alta concurrencia.
Ntese que adems de proveer un esquema de alta disponibilidad, el uso de un clster BPM le
permite a su solucin poder escalarse fcilmente.
Para mayor informacin sobre la configuracin de clster para el servidor BPM, consulte la
Administracin de servidores y clsters.
Porqu puede ayudar esta alternativa?

Esta alternativa es til para propsitos de escalabilidad, especficamente para optimizar el
procesamiento de los nodos con procesos con los cuales se espera producir una gran cantidad de
casos o actividades realizadas por un mismo conjunto de usuarios, sobre un periodo corto de tiempo.
Al tener las sesiones delegadas a un repositorio central, el procesamiento de las solicitudes se
distribuye de la manera ms eficiente segn lo soporte el algoritmo de su balanceador de cargas, y se
realiza a lo largo de todos los nodos de su clster BPM sin necesidad de usar sticky sessions (cuando
se atan las sesiones a un nodo especfico para procesar todas las solicitudes de una misma sesin de
usuario).
Adems de la escalabilidad, esta alternativa tambin es ms confiable para el IIS dado que las sesiones
almacenadas externamente (p.e directamente en SQL Server), permitirn que no finalicen ante reinicios
o reciclaje de recursos del ASP.NET, o incluso ante reinicios de SQL Server.
Prerrequisitos
El uso de un repositorio externo para almacenar sesiones se apoya en la funcionalidad ofrecida por el
framework de .NET Microsoft.
Esto implica que esta alternativa aplica cuando su proyecto utiliza IIS y una base de datos SQL Server
de Microsoft (en caso de usar una session state database).
Tenga presente que para el uso de la session state database, se recomiendan ediciones Standard o
Enterprise de SQL Server.
Para mayor informacin sobre esta funcionalidad, consulte https://msdn.microsoft.com/en-us/library/
ms178586.aspx.
Lo que debe hacerse

En esta seccin, ilustraremos cmo configurar el uso de una session state database, en cuyo caso, se
llevan a cabo los siguientes pasos:
1. Crear la base de datos para almacenar sesiones en su instancia de SQL Server.
Este paso se realiza por medio de un utilitario que provee el mismo framework de .NET.
2. Configurar su Portal de trabajo de Bizagi para utilizar dicha base de datos.
Este paso puede realizarse mediante las opciones grficas del IIS Manager, o directamente editando el
archivo web.config del Portal de trabajo.
109
Si por el contrario usted desea utilizar un session state server, entonces no necesita crear una base
de datos (no hace falta seguir el paso #1), y en el paso #2 se necesita configurar el Portal de trabajo
de Bizagi para que use un servidor en vez de la base de datos.
Procedimiento
Siga estos pasos.
1. Crear la base de datos para almacenar sesiones en su instancia de SQL

Server.
1.1. Abra una consola de comandos con permisos de administrador y navegue a la ruta de instalacin
del framework de .NET.
Se recomienda hacer uso del utilitario que provee el framework de .NET en su versin 4.0 full (dado
que esta versin de framework es la que usa el Portal de trabajo de Bizagi).
Para asegurar lo anterior, podr incluso realizar estos pasos desde su servidor BPM (que por defecto,
ya debe contar con la versin 4.0 full para una arquitectura de 64 bits instalada en: C:\Windows
\Microsoft.NET\Framework64\v4.0.30319\).
1.2. Ejecute el utilitario (llamado aspnet_regsql.exe) usando los parmetros que permiten crear las
tablas y esquema de la base de datos para almacenar sesiones, y al mismo tiempo definiendo una
base de datos personalizada (custom).
Utilice el siguiente comando:
aspnet_regsql.exe -S [INSTANCIA_SQL] -E -ssadd -sstype c -d [NOMBRE_BD]
Considere:
[INSTANCIA_SQL]: Es el nombre de la instancia de SQL Server. Recuerde utilizar el backslash para
instancias nombradas.
[NOMBRE_BD]: Es el nombre de dar a la base de datos personalizada.
Ntese que el uso de -E accede con las credenciales del usuario actual que ejecuta la consola de
comandos, las cules sern vlidas si se permiten como administrador en la instancia -permisos de
sysadmin (dado que a travs de la autenticacin mixta en SQL Server se soporta autenticacin
Windows tambin). En caso de que no desee utilizar las credenciales del usuario actual, utilice los
parmetros -U y -P (para especificar el nombre de usuario y contrasea respectivamente).
Para conocer a detalle sobre los parmetros de aspnet_regsql, consulte: https://msdn.microsoft.com/
en-us/library/ms178586.aspx.
110
Recuerde que esta alternativa de usar una session state database es recomendada para ediciones
Standard o Enterprise de SQL Server.
Usted puede previamente verificar su edicin de SQL Server ejecutando select @@version:
Una vez que la ejecucin del comando haya finalizado, podr verificar directamente sobre la instancia
SQL Server que se haya creado la base de datos personalizada, con las tablas
ASPStateTempApplications y ASPStateTempSessions:
111
Ntese que se recomienda apoyarse en una base de datos personalizada porque esta le permite
tener los datos de la sesin de manera persistente -sin afectarse por reinicios de la base de datos
(a diferencia de cuando se usa tempdb), y porque de esta manera se logra un configuracin ms
independiente (a diferencia de cuando se utiliza la base de datos ASPState la cual aplica por
instancia).
2. Configurar su Portal de trabajo de Bizagi para utilizar dicha base de datos.

Ntese que esta configuracin puede realizarse directamente editando el archivo web.config del Portal
de trabajo de Bizagi, o a travs de las opciones del IIS Manager (las cuales presentan opciones
grficas para estos ajustes que modifican el archivo web.config).
Para modificar directamente el archivo web.config considere que por defecto ste se ubica en C:
\Bizagi\Projects\WidgetContest\WebApplication\, y que usted deber editar los atributos del
elemento <sessionState>, de manera que quede con estos valores:
mode: SQLServer
allowCustomSqlDatabase: true
timeout: 20 (valor por defecto)
cookieless: false
sqlConnectionString: Data Source=[INSTANCIA_SQL];Initial Catalog=[Nombre_BD];User
ID=[LOGIN];Password=[CONTRASEA];
Para la conexin que especifica sqlConnectionString, considere asignar estos valores:
[INSTANCIA_SQL]: Es el nombre de la instancia de SQL Server. Recuerde utilizar el backslash para
instancias nombradas.
[NOMBRE_BD]: Es el nombre de dar a la base de datos personalizada, justo como se cre por
medio del uso de aspnet_regsql.exe en los pasos anteriores.
[LOGIN]: La cuenta de login para la conexin.
[CONTRASEA]: La contrasea para ese login.
Por ejemplo:
<sessionState allowCustomSqlDatabase="true" cookieless="UseCookies"
mode="SQLServer" sqlConnectionString="Server=MyServer
\SQL2012;Database=MySessionsDB;User ID=MySQLAccount;Password=MySQLAccount"
timeout="20" />
112
Para realizar el ajuste mediante las opciones grficas del IIS Manager, ubique el sitio especfico de su
Portal de trabajo de Bizagi, y de clic sobre Session state:
Asegrese de marcar el uso del modo SQLServer, y especificar detalles adicionales.
Si por el contrario usted desea utilizar un session state server, seleccione el modo State Server.
Ntese que usted deber habilitar el uso de bases de datos personalizadas (marcando la casilla de
Enable custom database):
113
Ntese que por defecto, un Time-out de 20 minutos se especifica.

Para la conexin configurada en Connection String, usted podr editar el valor directamente o usar el
botn Create... para especificar datos de la conexin de manera asistida (recomendado).
Al hacerlo, considere:
Server: Es el nombre de la instancia de SQL Server. Recuerde utilizar el backslash para instancias
nombradas.
Database: Es el nombre de dar a la base de datos personalizada, justo como se cre por medio
del uso de aspnet_regsql.exe en los pasos anteriores.
Credentials: Utilice la opcin de especificar las credenciales (Specify credentials). Utilice el botn
Set... para ingresar tanto la cuenta de login como su contrasea.
114
De clic en Ok para almacenar los cambios.

Tambin podr verificar despus los cambios en el archivo web.config.
Importante
Al realizar modificaciones o personalizaciones de secciones en el archivo web.config, como por
ejemplo la anterior, una de estas 2 alternativas debe considerarse al momento de realizar una
actualizacin de versin de Bizagi:
1. Si se lleva a cabo por medio de Bizagi Management Console, usted deber re-configurar y verificar
que dicha configuracin est aplicada an despus de la actualizacin.
Ntese que por defecto, la actualizacin realizada por Bizagi Management Console no considera las
modificaciones hechas a los archivos originales o la estructura de archivos (por lo que se
sobreescriben cambios).
2. Podr optar por llevar a cabo una actualizacin de versin manual a su vez (sin utilizar Bizagi
Management Console).
De hacerlo as, asegrese de considerar todos los componentes y archivos relevantes de la solucin,
para que pueda reemplazarlos por los archivos nuevos del Portal de trabajo y del servicio
Programador, mientras conserve las modificaciones personalizadas (como en este caso, la ya
mencionada configuracin del uso del session state database).
115
Introduccin
Cuando se cuenta con una aplicacin en un ambiente de produccin, es importante considerar las
mejores prcticas que permitan contar con un nivel de seguridad adecuado.
Estas mejores prcticas no solamente involucran las recomendaciones de configuracin del fabricante
de la aplicacin, sino que tambin se deben apropiar mejores prcticas tanto a nivel de infraestructura,
como de compaa.
Se recomienda adems cumplir rigurosamente los lineamientos y procedimientos que dicten las
polticas y estndares relacionados a la seguridad de la informacin, para que se consideren aspectos
de control, monitoreo, y auditora, entre otros, dentro del marco de lo que representa una aplicacin
segura.
Bizagi es una plataforma que despliega el Portal de trabajo a los usuarios finales, como una aplicacin
web.
Y por lo tanto, Bizagi Ltd recomienda implementar en todos sus proyectos, las medidas necesarias que
permitan fortalecer la seguridad, o mitigar ciertos riesgos y vulnerabilidades a las que no estn
exentas las aplicaciones web.
Recomendaciones
Siga las recomendaciones detalladas en los enlaces a continuacin, donde se presentan clasificadas
como bsicas, intermedias o avanzadas.
Comnmente en los proyectos, se mitigan la mayora de riesgos y vulnerabilidades al llevar a cabo las
recomendaciones bsicas.
Recomendaciones bsicas.
Recomendaciones intermedias.
Recomendaciones avanzadas.
Introduccin
Esta seccin presenta unas recomendaciones de seguridad para el Portal de trabajo de Bizagi, en
cuanto a los aspectos relevantes de la configuracin misma de Bizagi (hardening a nivel de aplicacin).
Recuerde que usted debe velar por un acceso y configuracin segura en sus instalaciones y en cuanto
116
a los equipos, dispositivos y componentes de la solucin que no son propios de Bizagi (la arquitectura
del sistema), como por ejemplo: la red y almacenamiento, los firewalls, balanceadores de carga u
otros dispositivos, otros servidores como controladores de dominio o de base de datos, etc.
Para mayor informacin sobre el alcance de estas recomendaciones, consulte Recomendaciones de
seguridad en la configuracin.
Las recomendaciones presentadas a continuacin aplican cuando Bizagi se ejecuta sobre una
plataforma de .NET, de manera independiente a la versin del servidor Web IIS sobre el cul se
ejecute.
En esta seccin se ilustra a manera de ejemplo la configuracin especficamente sobre un servidor
Web IIS versin 7.5, donde dichas configuraciones se realizan de acuerdo a las capacidades propias
del IIS.
Antes de comenzar
Asegrese de tener en cuenta las siguientes consideraciones antes de continuar.
Consideraciones para la plataforma

Tenga presente que siempre aplican las recomendaciones de Microsoft como fabricante de la
plataforma base de Bizagi en una configuracin de .NET.
Considere los boletines y notificaciones de actualizacin de fixes y parches que emite Microsoft en
relacin a un sistema operativo Windows o al IIS pero teniendo en cuenta las correspondientes
pruebas y la verificacin de no afectar al proyecto de Bizagi.
Consideraciones para la base de datos

Para una mayor seguridad en relacin al acceso a datos, Bizagi presenta la posibilidad de configurar la
cuenta de servicio de base de datos que utiliza el Portal de trabajo (y el servicio programador) con los
mnimos privilegios requeridos.
Para mayor informacin sobre la configuracin de estas cuentas, por ejemplo cuando se utiliza SQL
Server, consulte la Configuracin del SQL Server.
Consideraciones para la autenticacin de Bizagi

Antes de proceder con las recomendaciones en la configuracin del Portal de trabajo como aplicacin
web, deber asegurarse que usted utilice en su esquema de autenticacin en Bizagi, unas polticas de
seguridad en cuanto a contraseas (donde se considere longitud y formacin de las contraseas, su
duracin, elementos de cumplimiento y proteccin de las mismas).
Cuando se utiliza autenticacin tipo Bizagi, configure los parmetros relacionados a estas polticas
como se describe en la Autenticacin de Bizagi.
Se recomienda como mnimo utilizar:
Habilitar bloqueo de cuentas: On
Forzar cambio de contrasea: On
Validar historial de contrasea: On
Registrar eventos de autenticacin: On
117
Numero mximo de intentos de ingreso: 3

Tiempo de expiracin de la contrasea: 30 das o segn criterio.
Tiempo de expiracin de la contrasea: 8 caracteres o segn criterio.
La contrasea necesita contener letras: On
La contrasea necesita contener letras minsculas: On
La contrasea necesita contener letras maysculas: On
La contrasea necesita contener nmeros: On
La contrasea necesita contener caracteres especiales: On
Tiempo de sesin: 5 minutos.
Validar secuencia de contrasea: On
Tiempo de bloqueo de contraseas: Segn criterio.d
Duracin de cuenta bloqueada: Segn criterio.
Duracin para el reinicio del contador de intentos fallidos: Segn criterio.
Consideraciones para el usuario de sistema de Bizagi

Recuerde que el usuario domain\admon es el usuario del sistema que emplea internamente Bizagi
(creado por defecto).
No se podr deshabilitar este usuario dado que es necesario para ejecutar tareas automticas como
temporizadores o tareas programadas, y se recomienda siempre asegurarse que este usuario est
habilitado en el proyecto.
Habiendo dicho lo anterior, ntese que se recomienda enfticamente editar la configuracin del
usuario para que no tenga acceso de administrador en el Portal de trabajo (deber estar en capacidad
de iniciar cierto tipo de procesos y ejecutar tareas, pero no ser un administrador con permisos
completos).
Para ello por ejemplo, podr excluir al usuario de la lista de usuarios permitidos en las opciones de
administracin (p.e, que este usuario no tenga permisos para administrar usuarios, modificar
entidades de parametrizacin, abortar casos, etc).
Esta seccin presenta los aspectos que mitigan la mayora de las vulnerabilidades.
Esta configuracin aplica tambin al ambiente de pruebas o de pre-produccin (cuando se opta por
utilizarlo).
Para los pasos descritos a continuacin, debe asegurarse de tener habilitado el componente del IIS
llamado World Wide Services -> Security -> Basic Authentication, y tambin IP and Domain
restrictions al realizar la instalacin del IIS.
1. Uso del protocolo HTTPS

Se recomienda enfticamente configurar el Portal de trabajo bajo el protocolo HTTPS sobre SSL, dado
que este protocolo cifra la comunicacin.
Para hacerlo, asegrese de contar con un certificado vlido para su servidor, y que se registre su
dominio.
Una vez que cuente con el certicado de su servidor, regstrelo para el uso del Portal de Bizagi
118
utilizando la opcin de certificados del servidor (Server certificates) que presenta el IIS:
Al registrarlo, asegrese de especificar los bindings en el sitio web.
Ntese que para estos bindings, deber especificar el uso explcito de HTTPS, con su puerto asignado,
y seleccionar el certificado.
D clic en Ok para guardar la configuracin.
Al utilizar HTTPS, considere editar el archivo web.config para especificar <add key="PROTOCOL"
value="HTTPS"/>.
119
Esto aplica al utilizar enlaces al detalle de casos desde las notificaciones de procesos como se
describe en Notificaciones usando enlaces al caso.
2. Filtrado de las solicitudes no autorizadas

Se recomienda identificar el gateway de salida de los usuarios de su Portal de trabajo de Bizagi.
De esta manera, podr configurar un rango de direcciones IP vlidas para filtrar las solicitudes (HTTP
requests) hacia su aplicacin.
Para hacerlo, incluya de manera explcita las direcciones IP que pueden acceder al Portal de trabajo de
Bizagi a nivel de la ubicacin del sitio (ntese que podr especificar un dominio tambin), utilizando la
opcin de IP Address and Domain restrictions:
De manera similar, podr apoyarse en productos WAF (Web application firewall) para fortalecer las
medidas de seguridad en el acceso a Bizagi (por ejemplo para hacer uso de features orientados a
deteccin de intrusos u otros, y para considerar polticas de seguridad corporativas adicionales
sobretodo cuando se tiene Bizagi configurado para el acceso desde internet).
Puntualmente al emplear una zona desmiliarizada (DMZ), asegrese que tanto el firewall interno como
el externo no permitan el acceso y puertos de manera indiscriminada.
120
Importante
Para Bizagi, la seguridad es un aspecto de crtica importancia.
Por ello, Bizagi libera peridicamente nuevas versiones las cules cuentan con mltiples mejoras, y fixes
para problemas detectados en versiones anteriores.
Los fixes de problemas reportados podrn incluir soluciones definitivas a vulnerabilidades de
seguridad.
Por lo tanto, se recomienda enfticamente considerar la actualizacin peridica de su solucin a las
nuevas versiones de Bizagi, siguiendo siempre las directrices usuales en este procedimiento como lo
son:
Planear, coordinar y probar adecuadamente dichas actualizaciones.
Apoyarse en los diferentes ambientes (desarrollo, pruebas, pre-produccin cuando aplique, y
produccin).
Tomar las medidas de contingencia necesarias antes del procedimiento (p.e backups).
Evaluar las personalizaciones o configuraciones de seguridad como las listadas en esta seccin, de
forma que se tenga claro para todos los involucrados (stakeholders) que como parte del plan, hay
aspectos que se deben re-configurar posterior a la actualizacin.
Cuando se cuenta con personalizaciones o algunas de las configuraciones de seguridad de esta

seccin, una de estas 2 alternativas debe tomarse al momento de actualizar de versin de Bizagi:
1. Si se lleva a cabo por medio de Bizagi Management Console, usted deber re-configurar y
verificar que dicha configuracin est aplicada an despus de la actualizacin.
De hacerlo as, asegrese de considerar todos los componentes relevantes de la solucin, para que
pueda reemplazar los archivos nuevos del Portal de trabajo y del servicio Programador, mientras
conserve las personalizaciones o configuraciones anteriores.
Para aspectos muy crticos de seguridad, Bizagi podr considerar la emisin de hot fixes
recomendados para aplicarse sin necesidad de esperar a una nueva versin.
Para evaluar o considerar aspectos adicionales de hardening de aplicacin, consulte las
Recomendaciones intermedias.
Introduccin
Para llevar a cabo las recomendaciones de esta seccin, usted debe haber llevado a cabo las
recomendaciones presentadas en Recomendaciones bsicas.
121
ejecute.
del IIS.
utilizarlo).
Para los pasos descritos a continuacin, debe asegurarse de tener habilitado el componente del IIS
llamado World Wide Services -> Security -> Basic Authentication, y tambin IP and Domain
restrictions al realizar la instalacin del IIS.
1. Configuracin de cifrado de informacin usando HTTPS

Incluya el siguiente elemento en el archivo de configuracin web.config de su Portal de trabajo (por
defecto, ubicado en C:\Bizagi\Projects\[su_proyecto]\WebApplication\) para que las cookies queden
cifradas al usarse HTTPS.
Incluya esta definicin dentro del elemento <system.web>:
<httpCookies httpOnlyCookies="true" requireSSL="true" />
Para verificar la correcta configuracin, una vez autenticado en el Portal de trabajo, podr usar la
herramienta de su eleccin que le permita visualizar cmo son las cookies obtenidas (p.e travs de las
opciones de desarrollador de Google Chrome):
En el mismo archivo de configuracin web.config de su Portal de trabajo, edite la definicin del

elemento <pages>, de manera que la variable ViewState quede cifrada siempre. Lo que se busca con
esto es asegurar ese diccionario de informacin, como se indica en https://msdn.microsoft.com/en-us/
library/ms178199(v=vs.85).aspx.
Para hacerlo, ubique el elemento pages que contiene:
<pages controlRenderingCompatibilityVersion="3.5" clientIDMode="AutoID" />
Incluya el atributo y valor:
ViewStateEncryptionMode="Always"
122
Guarde los cambios y cierre el archivo de configuracin.
2. Proteccin adicional a los servicios web de Bizagi

Por defecto Bizagi incluye sus servicios web preconstruidos en la carpeta .\WebApplication
\WebServices\ (por defecto, dentro de C:\Bizagi\[Bizagi_edition]\Projects\[su_proyecto]\).
Bizagi incluye 2 tipos de servicios web en esta ruta: los que son una API orientados al negocio, y los
que son proveen funcionalidad de Bizagi netamente para uso interno.
Se recomienda enfticamente que se provea una capa de seguridad adicional en estos, de manera que
se restringa su acceso mediante el uso de carpetas separadas para cada tipo de servicio web.
Podr incluso dejar totalmente restringido el acceso a los servicios web orientados al negocio en caso
de que su proyecto no los necesite usar.
A pesar de que se recomiende el uso de HTTPS, tambin se debe explcitamente configurar la carpeta
y acceso de los servicios Web con las medidas que se describen en la siguiente tabla.
Tipo de servicio
Acciones
Servicios web internos de

Bizagi
Definir una lista autorizada de direcciones IP (IP whitelist), la cual en este

caso solo contiene la direccin local del mismo servidor BPM ya que
ser el nico usando el servicio de manera interna.
Servicios web del API de

Bizagi (orientados al
negocio)
Definir una lista autorizada de direcciones IP (IP whitelist), la cual en este

caso comprende las direcciones IP (o rango de direcciones)
consideradas por la aplicacin externa desde donde se vaya a invocar a
Bizagi.
Configurar la autenticacin bsica para acceder a esos servicios web
que van a ser invocados por aplicaciones externas (de manera que
estas aplicaciones externas deban autenticarse antes de invocar
servicios en Bizagi).
Para llevar a cabo lo anterior, siga estos pasos:

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, WFEQuery.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\).
Podr nombrar esta carpeta como SOAPservices (o un nombre de su eleccin):
123
Mueva todos los archivos ubicados en .\WebApplication\WebServices\, excepto Cache.asmx,

WFEQuery.asmx y WFAsynch.asmx, hacia la nueva carpeta que ha creado en el paso anterior:
Una vez que haya movido los archivos, podr verificar que solo Cache.asmx, WFEQuery.asmx y
124
WFAsynch.asmx, se encuentren en la carpeta original .\WebApplication\WebServices\.
Asignar la 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:
125
Recuerde que podr incluso dejar totalmente restringido el acceso a los servicios web orientados al
negocio (o eliminarlos), solo en caso de que su proyecto no los necesite usar.
Al utilizar autenticacin bsica o de otro tipo sobre estos servicios, deber asegurarse que sus
aplicativos que invoquen estos servicios consideren una autenticacin previa.
Definir una lista autorizada de IP para acceder a los servicios
Asegrese de configurar a nivel del IIS, que:
o La carpeta .\WebApplication\WebServices\ que contiene los servicios provistos por Cache.asmx,
WFEQuery.asmx y WFAsynch.asmx, sea accesible solo por direcciones IP permitidas (en este caso,
nicamente por el servidor local).
o La carpeta .\WebApplication\SOAPservices\ que contiene el API de los servicios orientados al
negocio, sea accesible solo por direcciones IP permitidas (o rango de direcciones), en este caso, las
asignadas a sus aplicaciones externas.
Para hacerlo, incluya de manera explcita las direcciones IP que pueden acceder a la carpeta (ntese
126
que podr especificar un dominio tambin), utilizando la opcin de IP Address and Domain
restrictions:
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):
3. Eliminar las carpetas no utilizadas en produccin

Se recomienda eliminar las carpetas cuyo uso est orientado a los ambientes de desarrollo.
Se busca evitar que se divulgue informacin del cdigo (vulnerabilidad conocida como Source code
127
leakage).
Usted podr eliminar las siguientes carpetas ubicadas dentro de la carpeta de jQuery (por defecto en
C:\Bizagi\Projects\[su_proyecto]\WebApplication\jquery):
automatictesting
editor
rendering
renderingflat
reporting
test
workportal
workportalflat
Importante
seguridad.
128
son:
produccin).
forma que se tenga claro para los involucrados (stakeholders) que como parte del plan, hay

Tambin es usual configurar el Portal de trabajo de Bizagi en un sitio web del IIS de su eleccin, y no
necesariamente en el de por defecto (llamado Default Web site).
Esto obedece a una medida adicional de seguridad por oscuridad que usted puede llevar a cabo de
manera enteramente opcional.
Para mayor informacin sobre esta posibilidad, consulte la Configuracin del portal por fuera del
sitio por defecto.
Para evaluar o considerar aspectos adicionales de hardening de aplicacin, consulte las
Recomendaciones avanzadas.
Configuracin del portal por fuera del sitio por defecto
129
Introduccin
Esta seccin involucra configuracin manual del Portal de trabajo de Bizagi Engine sobre una
plataforma de .NET.
Tenga en cuenta que estos pasos de configuracin son opcionales, y no son requeridos en ningn
momento dado que Bizagi realiza la creacin, configuracin y actualizacin del Portal de trabajo de
manera asistida en cualquiera de sus ambientes del proyecto (Desarrollo, Pruebas o Produccin).
El procedimiento que se describe a continuacin aplica especialmente cuando usted desee mover el
Portal de trabajo a un sitio web del IIS diferente al que se usa por defecto (conocido como Default
Web site), y parte de esa premisa donde usted ya cuenta con el Portal configurado bajo ese Sitio por
defecto.
Antes de comenzar
Recuerde que por defecto, Bizagi crea y actualiza (p.e al subir de versin) el Portal de trabajo dentro
del Default Web site.
Al llevar a cabo la configuracin que se presenta a continuacin, deber considerar tambin un
procedimiento manual para actualizar su proyecto de versin de Bizagi.
Lo que debe hacerse

Mover el Portal de trabajo de Bizagi hacia otro sitio web del IIS contempla que primero se aada y
configure la aplicacin bajo ese sitio web de su eleccin, y que despus se deshabilite o remueva la
aplicacin que queda bajo el sitio web por defecto.
130
Procedimiento
Siga estos pasos:
1. Adicione la aplicacin a su sitio web.
De clic derecho sobre su sitio web ya creado, para utilizar la opcin de adicionar aplicacin (Add
application...):
Asegrese de:
Especificar el Alias que representa el acceso al Portal de trabajo de Bizagi.
Seleccionar el pool de applicacin que se ha configurado para el uso de Bizagi (por defecto el
llamado Bizagi 64-bit ASP.NET v4.0, u otro pool que se haya dedicado para Bizagi)
Referenciar la misma ruta fsica que su Portal de trabajo ya configurado bajo Default web site est
usando. Esta ruta corresponde a la carpeta donde se encuentra la ruta base de la aplicacin web de
su proyecto (por defecto en C:\Bizagi\Projects\[su_proyecto]\WebApplication\) :
131
De clic en Ok.
Podr navegar en este punto el Portal de trabajo para verificar los cambios y una configuracin
exitosa:
132
En el ejemplo ilustrado anteriormente, puede observar que el sitio de ejemplo My Other Site se
accede por un puerto diferente al 80 por defecto.
Si este es su caso, asegrese de considerar la configuracin relveante en su infraestructura de
manera que: el acceso por ese puerto especfico est autorizado, y que cualquier especificacin
diferente de hostname en los bindings, est correctamente mapeada y manejada por su DNS
corporativo.
133
2. Deshabilitar/remover la aplicacin en el Default Web site.

Una vez que haya verificado la correcta configuracin del Portal de trabajo bajo un sitio web del IIS
diferente, podr deshabilitar o remover la aplicacin inicial que reside bajo Default web site.
134
Tenga en cuenta que se recomienda deshabilitar el Default Web site por completo en vez de
remover la aplicacin (aunque, es de su libre eleccin).
Al deshabilitar el sitio por defecto se cuenta con la ventaja de mantener la configuracin del sitio
bajo Default Web site de manera que lo pueda volver a habilitar temporalmente cuando lo necesite
(puntualmente si desea actualizar la versin de Bizagi de manera asistida por medio de la
actualizacin automtica de Bizagi).
Introduccin
Para llevar a cabo las recomendaciones de esta seccin, usted debe haber llevado a cabo las
recomendaciones presentadas en Recomendaciones bsicas y Recomendaciones intermedias.
ejecute.
del IIS.
utilizarlo).
Esta seccin presenta aspectos especfcos que se recomiendan para mitigar otro set diferente de
vulnerabilidades.
Para algunos de los pasos descritos a continuacin, debe asegurarse de haber instalado el mdulo
URL Rewrite para el IIS.
Este mdulo en su versin 2.0 (para versiones de IIS 7, 7.5 y 8), se puede descargar directamente
desde http://www.iis.net/downloads/microsoft/url-rewrite.
1. Reescritura de valores en variables del servidor

135
Se recomienda configurar reglas que sobreescriban ciertos valores que puedan divulgar informacin
del servidor (se mitiga la vulnerabilidad conocida como fuga de informacin).
Los valores que contienen informacin del servidor del IIS van por defecto en estas variables:
RESPONSE_SERVER, RESPONSE_X-ASPNET-VERSION, y RESPONSE_X-POWERED-BY.
Para sobreeescribir sus valores, realice lo siguiente:
Utilice la opcin de URL Rewrite en el Portal de trabajo de Bizagi (a nivel de la ubicacin del sitio), y de
clic sobre View Server variables para asegurarse de tener las 3 variables que se van a sobreescribir:
Utilice la opcin de Adicionar 3 veces, para incluir estas variables una por una. Al final el listado
deber verse como se ensea:
136
Seguidamente retorne a URL Rewrite (p.e dando clic sobre Back to rules) para adicionar las reglas de
sobreescritura.
Para cada una de las tres variables (RESPONSE_SERVER, RESPONSE_X-ASPNET-VERSION, y
RESPONSE_X-POWERED-BY), de clic en Adicionar regla(s).. y seleccione el tipo de regla en blanco para
salida de informacin (Outbound, blank rule):
137
Las propiedades de la regla sern las siguientes:

Name (nombre): Nombre de la regla, a su eleccin.
Precondition (precondicin): None.
Matching scope (scope al que aplica): Server variable.
Variable name (nombre de la variable): Ingrese para cada regla, una de las 3 variables a
sobreescribirse (RESPONSE_SERVER, RESPONSE_X-ASPNET-VERSION, RESPONSE_X-POWEREDBY).
Variable value (valor de la variable): Matches the pattern.
Using (utiliza): Regular expression.
Pattern (patrn): .+
Ignore case (ignorar maysculas y minsculas): On.
138
Action type (tipo de accin): rewrite

Value (valor): EMPTY.
Replace existing server variable value (reemplazar el valor existente de la variable): On
Al finalizar la creacin de reglas, podr ver que se listen las mismas para las tres variables:
139
De igual manera, con un navegador podr hacer la inspeccin de los valores que enva el servidor
para estas variables:
2. Uso de cabeceras de seguridad

Se recomienda establecer cabeceras de seguridad con el fin de no disponibilizar informacin que
pueda ser usadas en posibles ataques (vulnerabilidades conocidas como ClickJacking).
Las cabeceras de seguridad se configuran estableciendo los siguientes valores:
Cabecera
Valor
x-content-type-options
nosniff
x-dns-prefetch-control
off
x-frame-controls
SAMEORIGIN
x-xss-protection
1; mode=block
140
Strict-Transport-Security
Strict-Transport-Security: max-age=31536000;
includeSubDomains
content-security-policy
default-src: self
NOTA: Ac podr adicionar otras URL diferentes
a la misma aplicacin (self) en caso de que
aplique. Para ms informacin consulte https://
www.owasp.org/index.php/
Content_Security_Policy
Para llevar a cabo esta configuracin, realice lo siguiente:

Utilice la opcin de HTTP Response Headers en el Portal de trabajo de Bizagi (a nivel de la ubicacin
del sitio), y`adicione cada una de las cabeceras con su valor respectivo (usando la opcin de
Adicionar):
Una vez realizado este paso para cada cabecera, deber ver la lista de cabeceras configuradas como
se ensea a continuacin:
141
Importante
seguridad.
son:
produccin).
forma que se tenga claro para los involucrados (stakeholders) que como parte del plan, hay

142
Configuracin de Bizagi Engine 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.
143
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:
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 este paso usted necesita tener los archivos de Bizagi Engine para JEE.
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 este paso usted
necesita tener los archivos de Bizagi Engine para JEE).
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.
Consola JEE de Bizagi
Introduccin
La consola de Bizagi JEE (Bizagi JEE Console) es una herramienta provista por Bizagi Ltd que le ayuda a
llevar a cabo las tareas de administracin involucradas en los proyectos de Bizagi que se ejecutan en
plataformas JEE.
La consola de Bizagi JEE provee opciones por lnea de comandos que son usadas principalmente para
los proyectos en ambientes de Pruebas y Produccin, de tal forma que puede: construir o administrar
la estructura de archivos del proyecto, compilar sus entidades, desplegar el Portal de Trabajo o
administrar sus licencias.
Prerrequisitos
La consola de Bizagi JEE no requiere instalacin.
Tiene un archivo ejecutable que corre en cualquier sistema operativo donde se ejecute su Servidor de
Aplicaciones JEE con Bizagi Engine.
144
Antes de usar La consola de Bizagi JEE, asegrese de cumplir con estos requisitos:
Tener un JDK de JAVA SE en este servidor.
Es altamente recomendado usar el JDK 6, update 45.
Debido a que est diseado para ser ejecutado en el servidor donde el Servidor de Aplicaciones JEE
tiene alojado su proyecto de Bizagi, este servidor debe tener el framework de JAVA instalado.
Tener la variable de ambiente JAVA_HOME configurada adecuadamente (se recomienda que la ruta
no contenga espacios).
Opcionalmente, puede agregar la variable de ambiente JAVA_HOME a la variable del sistema PATH.
Se recomienda ubicar la Consola JEE de Bizagi en una ruta (por ejemplo dentro de la ruta de
instalacin del Servidor de aplicaciones JEE) donde pueda garantizar que tenga los privilegios de
lectura y escritura necesarios (especialmente al momento de aplicar una licencia).
Opciones de comandos
Una vez descomprimido en una carpeta local en el servidor BPM de Bizagi, Los archivos ejecutables de
la Consola de Bizagi JEE deben estar en la ruta <INSTALLATION_PATH>\<Bizagi_Version>\BizagiJEE
\BizagiConsoleManagerJEE\bin.
Use el smbolo del sistema con Privilegios de Administrador para ejecutar los comandos disponibles.
La siguiente tabla lista las diferentes opciones tiles para la Administracin de tareas y las clasifica en
grupos que comparten objetivos comunes.
OPCIONES DE COMANDOS DE LA CONSOLA DE JEE
Objetivo
Comando
Descripcin
Administ
racin
de
proyecto
: Maneja
la
estructur
a
de
archivos
del
proyecto
de
los
compone
ntes de
JEE.
createproj Crea proyectos que

ect
almacenan
la
informacin de la
configuracin.
Este mtodo se
utiliza
cuando
Despliega a un
Servidor
de
Aplicacin JEE.
updatepr
oject
Actualiza
la
informacin de la
configuracin
de
un proyecto.
deleteproj Borra un proyecto

ect
especfico.
Parmetros
Sintaxis
createproject
<pathFile>:
ruta <PathFile>
completa
del
archivo XML que
contiene
la
informacin
del
proyecto.
-m: Indica si la
ejecucin mostrar
cdigos
de
notificacin
y
updateproject
mensajes
<PathFile>
informativos
(Opcional).
-p <ProjectName>: deleteproject -p
Nombre
del <ProjectName>
proyecto
a
ser
borrado.
-m: Indica si la
145
ejecucin mostrar
cdigos
de
notificacin
y
mensajes
informativos
(Opcional).
Desplieg predeploy Prepara la versin
ue de la
de Bizagi (.EAR)
aplicaci
que
ser
n Web:
desplegada en el
Prepara y
servidor.
genera el
archivo
Este mtodo se
.ear para
utiliza
cuando
el
Despliega a un
desplieg
Servidor
de
ue de la
Aplicacin JEE.
aplicaci
n.
deploy
Copia el archivo
.EAR en el Servidor
de
Aplicaciones
JEE.
-u:
Incluir
el
PatchSet.
Este
parmetro necesita
ser agregado para
incluir el PatchSet
(.jar). El valor por
defecto es false.
-p <ProjectName>:
Nombre
del
proyecto
(Obligatorio).
-o <OutputPath>:
Ruta
donde
se
generar la versin
de Bizagi. (opcional).
-c: Indica si el
proyecto est en
clster o no.
-f <FilePath>: Ruta
completa donde se
encuentra el .EAR
que ser usado
para generar la
versin de Bizagi.
(opcional).
-m: Indica si la
ejecucin mostrar
cdigos
de
notificacin
y
mensajes
informativos
(Opcional).
predeploy
-u
<OutputPath>
<FilePath>
<ProjectName>
-o
-f
-p
p
-u:
Incluir
el deploy
-f
PatchSet.
Este <ProjectName>
parmetro necesita <FilePath> -e -c -u
ser agregado para
incluir el PatchSet
defecto es false.
-p <ProjectName>:
Nombre
del
proyecto
146
(Obligatorio).
-e: Indica si es
requerido regenerar
las entidades o no.
-c: Indica si el
proyecto est en
clster o no.
-f <FilePath>: Ruta
completa donde se
encuentra el .EAR
que ser usado
para generar la
versin de Bizagi.
(opcional).
-m: Indica si la
ejecucin mostrar
cdigos
de
notificacin
y
mensajes
informativos
(Opcional).
undeploy
Opcione publish
s
de
solucin
de
problem
as:
til
sobretod
o
para
ambiente
s
de
Borra el archivo
.EAR en el Servidor
de
Aplicaciones
JEE.
-p <ProjectName>: undeploy p
Nombre
del <ProjectName> -n
<EarName>
proyecto
(Obligatorio).
-n
<EarName>:
Nombre
con
extensin del .EAR
desplegado en el
Servidor
de
Aplicaciones de JEE.
-m: Indica si la
ejecucin mostrar
cdigos
de
notificacin
y
mensajes
informativos
(Opcional).
Publica el archivo
.EAR en el Servidor
de
Aplicaciones
JEE.
-p <ProjectName>: publish p
Nombre
del <ProjectName> -f
<FilePath> -u
proyecto
(Obligatorio).
-f <FilePath>: Ruta
completa donde se
encuentra el .EAR
que ser usado
para generar la
versin de Bizagi.
147
desarroll
o.
(opcional).
-u:
Incluir
el
PatchSet.
Este
parmetro necesita
ser agregado para
incluir el PatchSet
defecto es false.
-m: Indica si la
ejecucin mostrar
cdigos
de
notificacin
y
mensajes
informativos
(Opcional).
unpublish
Borra el archivo
.EAR en el Servidor
de
Aplicaciones
JEE.
startapps
erver
Inicia el Servidor de
Aplicaciones de JEE
stopapps
erver
Detine el Servidor
de Aplicaciones de
JEE
cleancach
e
Limpia la cach de
la aplicacin Web
de Bizagi en una
ambiente
standalone
de
desarrollo.
Este mtodo se
utiliza
cuando
Despliega a un
Servidor
de
Aplicacin JEE.
Meta
version
informac
-p <ProjectName>:
Nombre
del
proyecto
(Obligatorio).
-m: Indica si la
ejecucin mostrar
cdigos
de
notificacin
y
mensajes
informativos
(Opcional).
unpublish p
<ProjectName>
-p <ProjectName>:
Nombre
del
proyecto
(Obligatorio).
-host
<HostName>:
nombre o IP del
servidor en donde
se quiere limpiar la
cach interna de
Bizagi (Obligatorio).
-port
<Port>:
Puerto por el cual
escucha
la
aplicacin Web de
Bizagi y al que
quiere limpiar la
cach interna de
Bizagi (Obligatorio).
cleancache -p
<ProjectName> -host
<HostName> -port
<Port>
Muestra la versin
actual de Bizagi
startappserver p
<ProjectName>
stopappserver p
<ProjectName>
version
148
in:
help
Varias
opciones
relativas
a Bizagi y
esta
herramie
nta.
help
Muestra la ayuda
de los comandos y
la descripcin de
los parmetros.
startconsoleservice
Administ startconso Inicia la Consola de

racin
leservice
Bizagi JEE como
de
servicio del sistema
licencias:
usando el puerto
Aplica o
5680.
elimina
licencias. stopconso Detiene el servicio
leservice
del sistema iniciado
con el comando
anterior.
stopconsoleservice
removelicense
removelic
ense
Desinstala
las
licencias de Bizagi
JEE
Administ checkldap
racin
del
LDAP:
verifica o
sincroniz
a el LDAP
configura
do.
Ejecuta la prueba
de la configuracin
del LDAP definida
por en usuario en
Bizagi Studio
-p <ProjectName>: checkldap -p
Nombre
del <projectName> -env
<environment
proyecto
(Obligatorio).
-env
<environment>:
Identificador
del
ambiente donde se
requiere probar la
configuracin
del
LDAP. Los valores
posibles son: 1 para
Desarrollo, 2 para
Pruebas y 3 para
Produccin
(Obligatorio).
Ejecuta
la
sincronizacin de
los usuarios del
LDAP.
Para ejecutar este
comando, verifique
que la variable
SUPPORT_UTILITIE
S est activa en el
archivo
de
-p <ProjectName>: syncldap -p
Nombre
del <projectName
proyecto
(Obligatorio).
synclap
149
propiedades
extendidas
de
Bizagi, este archivo
se encuentra en
<INSTALLATION_P
ATH>
\<Bizagi_Version>
\BizagiJEE\bizagiconfig\bizagiextended.propertie
s
Administ checkemai Ejecuta la prueba
racin
l
de la configuracin
del
del SMTP enviando
SMTP:
un
correo
verifica el
electrnico a una
LDAP
direccin
de
configura
prueba
do.
-p <ProjectName>:
Nombre
del
proyecto
(Obligatorio).
-env
<environment>:
Identificador
del
ambiente donde se
requiere probar la
configuracin
del
SMTP. Los valores
posibles son: 1 para
Desarrollo, 2 para
Pruebas y 3 para
Produccin
(Obligatorio).
-emailTo
<emailTo>:
Direccin de correo
electrnico
para
recibir el correo
enviado
por
la
prueba del SMTP
(Obligatorio).
checkemail -p
<projectName> -env
<environment> -emailTo
<emailTo>
Antes de ejecutar cualquiera de los comandos de administracin del LDAP o del SMTP, configure las
siguientes variables en el archivo de configuracin de la consola, este archivo se encuentra en
<INSTALLATION_PATH>\<Bizagi_Version>\BizagiJEE\BizagiConsoleManagerJEE\config\consoleconfiguration.properties:
bizagi_war_host: IP o nombre del servidor donde se despliega su aplicacin Web.
bizagi_war_port: Puerto del servidor donde se despliega su aplicacin Web.
150
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.
Para una breve resea de los componentes de JEE que se deben configurar en su servidor de
aplicaciones JEE, consulte la Lista de chequeo de la configuracin de componentes JEE.
Lista de chequeo de la configuracin JEE en el servidor BPM
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.
Existen adems, algunas variaciones dependiendo de la arquitectura de sistema que se emplee (p.e, si
se considera un esquema de alta disponibilidad con ms de un nodo en cada capa de la solucin, si se
integran diferentes sistemas, aplicaciones o bases de datos externas, etc).
Configuraciones
La siguiente lista presenta los elementos que se configuran en el servidor de aplicaciones JEE, como
resea al procedimiento que se desprende desde la Configuracin de WebSphere, Configuracin de
Weblogic o Configuracin de JBoss; y til tambin como una lista de chequeo para su configuracin.
1. Puertos
Los siguientes puertos debern estar habilitados (para cada nodo si se utiliza un clster):
Puerto del portal administrativo de su servidor de aplicaciones JEE.
En WebSphere por defecto es el 9043.
En Weblogic por defecto es el 7001.
En JBoss por defecto es el 9990.
151
Puerto del servicio de su servidor de aplicaciones JEE.

Usualmente el puerto usado es el 8080 (p.e en JBoss) aunque su configuracin es completamente
personalizable (p.e 443 u otro cuando se utiliza HTTPS).
Puerto 25 para la conexin con el servidor SMTP y puerto 587 para el relay.
Puerto 4447 para el servicio Scheduler.
Cuando se utiliza un clster, donde se configura un scheduler centralizado, se emplea el puerto 5681
por defecto.
Se recomienda tambin permitir el puerto UDP nmero 11000 en mquinas donde se cuenten con
componentes de Bizagi (por ej, donde se tenga instalado el Management Console).
Este puerto UDP es involucrado en el manejo de la cach de Bizagi y su sincronizacin entre los
componentes.
2. Bizagi Home y archivos de configuracin

Deber tener instalado los archivos de configuracin de Bizagi Engine JEE.
La instalacin deber hacerse para cada nodo si se utiliza un clster.
Estos se encuentran en el paquete distribuble para los diferentes servidores de aplicacin (BizAgi-earWebsphere-dist.zip, BizAgi-ear-Weblogic-dist.zip, BizAgi-ear-JBoss-dist.zip).
Recuerde que dentro del paquete distribuible para los diferentes servidores de aplicacin (BizAgiear-Websphere-dist.zip, BizAgi-ear-Weblogic-dist.zip, BizAgi-ear-JBoss-dist.zip) se encuentran
diferentes archivos para su ambiente de JEE, como:
Libreras y drivers que sirven como insumos de configuracin para el servidor de aplicaciones.
Archivos especiales para configuracin en clster del servidor JEE (como por ejemplo, relacionado
al servicio Programador -Scheduler-).
La Consola JEE (un utilitario) y el archivo base .ear para realizar los despliegues de aplicacin
(para generar el Portal de trabajo de Bizagi como una aplicacin de su servidor de aplicaciones
JEE).
Archivos y mdulos utilizados por Bizagi en tiempo de ejecucin (p.e mdulo JiNET).
La ruta de estos archivos usados por Bizagi, desde una ruta local de su servidor se conoce como
BIZAGI_HOME.
Dentro de los archivos y mdulos utilizados por Bizagi en tiempo de ejecucin (BIZAGI_HOME), deber
garantizar que se encuentren configurados:
El componente JiNET, con el proveedor de datos adecuado especificado en su archivo web.config
(p.e si es Oracle).
La ruta de donde se cargan archivos complementarios de configuracin (propiedades extendidas,
etc), llamado bizagi-config.
Los conectores que se utilicen por medio de funcionalidad de Bizagi, como por ejemplo el conector
JCo de SAP (si su proyecto se conecta con sistemas SAP a travs del conector SAP de Bizagi).
Otras carpetas almacenado los drivers, o archivos de un file store, segn como sea configurado en
152
el servidor de aplicaciones especfico.

Dentro de las variables de entorno que se tienen en cuenta en el inicio del servidor de aplicaciones
JEE, se debe considerar:
La configuracin de la mquina virtual de Java relacionada a los parmetros de memoria segn su
hardware (p.e initial heap size, maximum heap size).
Configuraciones posibles del CLASSPATH, especficas segn el servidor de aplicaciones y del driver
en uso.
La variable APP_SERVER que indicar sobre qu servidor de aplicaciones se ejecutan los procesos,
al igual que otros parmetros segn la versin de Bizagi (por ej, una configuracin de idioma).
Con cada actualizacin de versin de Bizagi, se debe verificar que estos archivos estn correctamente
configurados o actualizados si ameritan cambios.
3. Mdulos dentro del servidor de aplicaciones

En la configuracin de un servidor de aplicaciones JEE (para cada nodo si se utiliza un clster), tenga
en cuenta los siguientes componentes y sus consideraciones.
Mdulo de seguridad
Tenga en cuenta que la configuracin de seguridad en Bizagi requiere de libreras autenticacin, segn
cada servidor de aplicaciones.
La seguridad se apoyar en JAAS (conocido como "Java Authentication and Authorization Service").
Aparte de la instalacin de estas libreras, deber garantizar que se cree el usuario RMI y usuario
domain\admon de Bizagi.
Con cada actualizacin de versin de Bizagi, se debe verificar que estas libreras sean reemplazadas si
son actualizadas.
Recursos para el acceso de datos
Para el acceso a su base de datos, tenga en cuenta lo siguiente:
Deber contar con los drivers apropiados, segn el motor de base de datos (Oracle o SQL Server),
instalados en el servidor de aplicaciones.
Recuerde que debe considerar el driver para la conexin a la base de datos de Bizagi y tambin a
fuentes de datos externas si utiliza la replicacin o virtualizacin de datos de Bizagi.
Con cada actualizacin de versin de Bizagi, se debe verificar que estas libreras sean reemplazados si
son actualizados (contemplando el nombre del archivo exacto).
Deber configurar el JDBC Provider.
El data source que representa la base de datos de Bizagi deber llamarse BizAgiJava.
Si adems utiliza la replicacin o virtualizacin de datos de Bizagi, deber configurar un data source
adicional llamado MainDS, y adems deber configurar un data source para cada fuente de datos que
se integre por medio de este mecanismo.
Servicios de mensajera (JMS)
Deber crear los elementos del servicio de mensajera (JMS) para lo siguiente:
Manejo de tareas asncronas:
o Una fbrica de conexiones para colas llamada AsyncControllerFactory.
o Una cola llamada jms\AsyncController.
o Una definicin de activacin llamada eis\AsyncControllerActivationSpec.
Log de entidades:
153
o Una fbrica de conexiones para colas llamada AsyncAuditControllerFactory.

o Una cola llamada jms\AsyncAuditController.
o Una definicin de activacin llamada eis\AsyncAuditControllerActivationSpec.
Mdulo de persistencia
Tenga en cuenta que Bizagi utiliza eclipselink para la persistencia de datos.
son actualizadas.
Otros mdulos
Bizagi utiliza unas libreras compartidas, y utiliza tambin una librera log4j para funcin de logs.
son actualizadas.
Libreras adicionales para la integracin de otros sistemas
Deber revisar que libreras y APIs adicionales, integradas mediante la funcionalidad de la librera de
componentes de Bizagi, se encuentren registradas en el servidor apropiadamente y ubicadas en su
repositorio de libreras.
4. Configuraciones especficas cuando se usa un clster

Cuando se utiliza ms de un nodo BPM, se deber garantizar la configuracin de estos aspectos a
nivel de Bizagi:
Cach distribuido de Bizagi:
A travs del parmetro bizagi.cache.multicast.enabled configurado en true.
Al utilizar cach distribuido se deber tener una estructura de elementos de mensajera JMS dedicada
para este fin y se tendrn otros parmetros configurados como: bizagi.cache.multicast.address,
bizagi.cache.multicast.port, y bizagi.cache.multicast.type.
Servicio Scheduler centralizado:
A travs de la configuracin del archivo scheduler_configuration.properties.
Configurar las variables SERVER_NAME, APP_NAME y PROTOCOL como parmetros de Bizagi en
caso de que sus notificaciones de proceso contengan enlaces directos a las actividades de caso
(para poder especificar que la URL se construya direccionando al balanceador de cargas).
En clster se debe contar con los 2 Topic Factory (jms/ELEntitiesTopicFactory, jms/

ELRenderTopicFactory) y los 2 Topic (jms/ELEntitiesTopic, jms/ELRenderTopic),
Con cada actualizacin de versin de Bizagi, estos componentes estn sujetos a actualizaciones.
Gua
Para mayor informacin sobre los pasos de configuracin, consulte la documentacin de configuracin
de cada servidor de aplicaciones JEE, y los pasos acordes dependiendo de si se realiza una instalacin
standalone o en clster:
Configurar WebSphere para trabajar con Bizagi
Configurar Weblogic para trabajar con Bizagi
154
Configurar JBoss para trabajar con Bizagi
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
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.
155
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.
156
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
en una ruta sin espacios).
Tener a la mano los archivos de configuracin (y de despliegue) requeridos por Bizagi (BizAgi-earWebsphere-dist.zip).
El archivo BizAgi-ear-WebSphere-dist.zip (incluido en la descarga de Bizagi Engine JEE WebSphere)
debe corresponder a la versin de Bizagi que ha usado en su ambiente de desarrollo (es decir, la
versin de Bizagi Studio y el Plug-in JEE).
Tener instalado el Servidor WebSphere v 8.5 en cada nodo que har parte del clster.
Las versiones soportadas son las pertenecientes a WebSphere 8.5.5, lo cul incluye hasta el update
8.5.53 (recomendado).
De manera similar, tener instalado el WebSphere Application Server Network Deployment (WASND)
que corresponda a WebSphere v 8.5.
157
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, y WASND como los lineamientos presentados en la
siguiente seccin.
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

Para instalar WebSphere de acuerdo a los prerequisitos, asegrese de instalar el conjunto habitual de
archivos y productos que proporciona WebSphere para administrar e instalar sus servidores
WebSphere segn las recomendaciones del fabricante.
El conjunto habitual de archivos y productos incluye: el Installation Manager, WebSphere Network
Deployment y parches necesarios (WebSphere Fixpacks), en este caso para v 8.5.
WebSphere requerir tambin llevar a cabo lo siguiente para la configuracin en clster:
Asegurar que se instalen los componentes necesarios de WebSphere (y WASND) y en todos los
nodos.
Mayor detalle se describe a continuacin en la seccin Directrices de instalacin.
Crear los perfiles para el manejo del clster a travs del WASND.
Mayor detalle se describe en la seccin Creacin de perfiles.
Registrar los nodos como parte del clster, y asegurar que se sincronicen los cambios en ellos.
Mayor detalle se describe en la seccin Registro del clster.
Directrices de instalacin
Al instalar Installation Manager, considere:
Seleccionar una ruta de instalacin que no contenga espacios en blanco.
Haber descomprimido los archivos de instalacin de WebSphere Network Deployment y
WebSphere Fixpacks, cada uno en una carpeta diferente dentro de un directorio que no contenga
espacios en blanco.
158
Configurar 2 repositorios para el Installation Manager, al definir las rutas sobre las cuales se
tomaran los archivos para el uso de los productos de WebSphere.
Los 2 repositorios debern hacer referencia a las rutas predefinidas donde WebSphere Network
Deployment y WebSphere Fixpacks were fueron descomprimidos.
Instalar el WebSphere Application Server a travs del Installation Manager.
Al hacerlo, siga las mismas recomendaciones mencionadas anteriormente, donde se procure
seleccionar un directorio de instalacin que no contenga espacios en blanco.
Seleccione un directorio para instalar los paquetes de los componentes compartidos que igualmente
tampoco contenga espacios en blanco.
La ruta de instalacin, que incluye la instancia del servidor creada ser referenciada a partir de este
momento como <WAS_HOME>.
Ntese que podr iniciar la opcin Profile Management Tool despus de haber instalado los
componentes, para crear los perfiles que se requieren para su configuracin de clster de WebSphere
Application Server.
159
Tenga presente que la instalacin de WebSphere y sus componentes se requiere en cada nodo que
desee incorporar a su clster. Esto implica la repeticin de los pasos anteriores en los nodos.
Creacin de perfiles
Al utilizar WASND, recuerde 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.
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):
160
Seleccione la opcin de Deployment Manager para el tipo de servidor (Server type) y d clic en
Siguiente (Next):
Seleccione la opcin Advanced profile creation para una configuracin avanzada del perfil,
y d clic en Siguiente (Next):
161
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
directory), y verifique que no se utilice como perfil por defecto (la casilla Make this profile the default
debe quedar sin marcarse).
162
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):
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):
163
Seleccione que el servidor NO se ejecute como un servicio.

Ntese que esta opcin no se recomienda para entornos de produccin, y suele aparecer en sistemas
operativos Windows.
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).
164
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 sistemas
operativos de tipo *nix como Linux, o startManager.sh en sistemas operativos Windows):
Creacin del perfil personalizado Custom

Tenga en cuenta que este paso se debe realizar para cada nodo que haga parte del clster.
165
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):
Defina las propiedades del perfil.

166
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).
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).
167
o
o
o
Ingrese la informacin para la federacin de nodos (configuracin que establezca que los nodos
pertenecen a un clster en WebSphere). Para ello, considere:
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.
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.
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.
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.
168
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
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 para iniciarlo (startNode.sh en sistemas operativos
tipo *nix como Linux, o startNode.sh en sistemas operativos Windows):
169
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
Considere:
[Servidor_DM]: Nombre o direccin IP del nodo que contiene el perfil DM.
[Puerto_DM]: Nmero de puerto bajo el cul el nodo que contiene el perfil DM se inicia.
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:
Registro del clster

Al configurar WebSphere en clster, ntese que ciertos mdulos (como por ej, los que usan los
170
recursos JMS o las fuentes de datos), se definen a nivel del clster de manera que esta configuracin
relevante se debe propagar y compartir entre los nodos.
Para definir y registrar el clster en WebSphere, realice lo siguiente:
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.
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.
171

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.
172
4. Ingrese la informacin de los nodos que hacen parte del clster. Para ello, d clic sobre Add
Member para adicionar cada nodo:
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:
173
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 establecer un
servicio en WebSphere que soporte el Portal de Bizagi. Despus de ese paso recuerde que igualmente
se debe hacer un despliegue de aplicacin.
Ntese que Bizagi recomienda el escalamiento horizontal.
4. Revise la configuracin del balanceador de cargas para que considere el nuevo nodo.
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.
174
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.
2.
3.
4.
Instalar las libreras usados por Bizagi hacia WebSphere.

Configurar los archivos usados por Bizagi.
Configurar las variables de entorno.
Configurar los siguientes mdulos en WebSphere:
Acceso a datos
Servicio de mensajera (JMS)
Autenticacin y usuario del sistema Bizagi
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. Instalar las libreras usados por Bizagi en WebSphere.

En este paso, se incluyen libreras y drivers usados por Bizagi en la instancia de WebSphere (son
archivos que no vienen por defecto en una instalacin limpia de WebSphere).
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-WebSpheredist.zip).
Una vez que tenga el archivo .zip, extraiga su contenido en una ruta local de su eleccin.
Esta ruta, incluyendo la subcarpeta llamada BizagiBPMJEE, ser referenciada como
<INSUMOS_DE_CONFIGURACIN> a partir de este momento.
En la siguiente imagen, nuestro <INSUMOS_DE_CONFIGURACIN> ser correspondiente a la ruta C:
\ROOT\BizAgi-ear-WebSphere-dist\BizagiBPMJEE\:
175
1.1 Instalar las libreras para la autenticacin.

La instalacin de dichas libreras se realiza simplemente copiando esas libreras del mdulo de
Autenticacin (bizagi-websphere-security-[version].jar, bizagi-remote-[version].jar, bizagi-securitycommon-[version].jar) que se entregan en los insumos de configuracin, desde esta ruta:
<INSUMOS_DE_CONFIGURACIN>\security\
Hacia el repositorio de las libreras de WebSphere en:
<WEBSPHERE_HOME>\lib\ext\
1.2 Instalar libreras adicionales.

La instalacin de las libreras adicionales se realiza simplemente copiando esas libreras como por
ejemplo la que se utiliza para el registro de logs llamada log4j-[version].jar y la librera que se usa
176
para la persistencia de datos llamada eclipselink-[version].jar.

Dado que ambas se entregan dentro de los insumos de configuracin, cpielas desde esta ruta:
<INSUMOS_DE_CONFIGURACIN>\configuration\
Paso seguido, asegrese de editar el nombre de la librera de eclipselink de manera que no
especifique el detalle exacto de la versin (renmbrelo de manera que quede como eclipselink.jar):
1.3 Instalar libreras compartidas

La instalacin de 2 libreras compartidas se realiza copiando esas libreras como se entregan dentro
de los insumos de configuracin en <CONFIGURATION_INPUTS>\configuration\hacia las rutas
de libreras opcionales de WebSphere.
Para hacerlo, copie los jars httpclient-4.1.1.jar y httpcore-4.1.jar en:
<WEBSPHERE_HOME>\optionalLibraries\
1.4 Instalar los drivers.
La instalacin de los drivers se realiza copiando esas libreras correspondientes al motor de base de
datos, como se entregan dentro de los insumos de configuracin.
Para hacerlo, copie los drivers desde <INSUMOS_DE_CONFIGURACIN>\configuration\y hacia la
ruta de libreras de WebSphere en:
Si su proyecto utiliza Oracle, copie el driver ojdbc6-11.1.0.6.0.jar.
Si su proyecto utiliza SQL Server, copie el driver sqldbc-4..0.jar.
Additionalmente, copie el driver bizagi-jdbc-driver[version].jar.
2. Configurar los archivos usados por Bizagi

Hay algunos archivos de configuracin que Bizagi utiliza internamente para la ejecucin de los
procesos, como por ejemplo: un mdulo JiNET y un set de archivos de propiedades con configuracin
especial dependiendo de las caractersticas del proyecto.
Usted deber definir al inicio cul ser la ruta donde queden estos archivos de configuracin
albergados, de manera que los pueda referenciar dentro de la configuracin de variables de entorno
177
para que WebSphere los considere cuando suba el servicio.

Para poder administrar dicha configuracin de Bizagi (p.e crear archivos de backup de la configuracin
de todo su sistema), recomendamos copiar estos archivos de configuracin de Bizagi a una ruta
aparte.
Esta ruta ser referenciada como <BIZAGI_HOME> a partir de este momento.
Se recomienda que la ruta <BIZAGI_HOME> est contenida dentro del directorio de instalacin de
WebSphere y que el dueo de la misma sea el mismo usuario que ejecuta WebSphere.
De esta manera, usted podr garantizar los permisos adecuados sobre la misma (esta ruta debe
tener por lo menos permisos de lectura y escritura).
Tambin se recomienda que dentro de <BIZAGI_HOME>, se ubique la Consola administrativa JEE,
til para el procedimiento de despliegue de aplicacin.
Para configurar la ruta de los archivos de Bizagi, copie lo siguiente:
La carpeta llamada JiNET (ubicada en <INSUMOS_DE_CONFIGURACIN>) hacia su ruta
<BIZAGI_HOME>
La carpeta llamada bizagi-config (ubicada en <INSUMOS_DE_CONFIGURACIN>) hacia su ruta
<BIZAGI_HOME>
La carpeta llamada connectors (ubicada en <INSUMOS_DE_CONFIGURACIN>) hacia su ruta
<BIZAGI_HOME>
Si sus procesos se integran con SAP por medio de la conexin ofrecida por la funcionalidad de
Bizagi, deber configurar las libreras involucradas para la conectividad con SAP del conector para
plataformas JEE.
178
El conector de SAP para las plataformas JEE (conocido como JCo) se compone de un archivo .jar y
de una librera nativa para el sistema operativo (un archivo .so para sistemas operativos tipo *nix
como Linux, o un archivo .dll para sistemas operativos Windows).
Estos archivos de JCo son solicitados y descargados desde el mismo link oficial de SAP http://
service.sap.com/connectors (acceso autorizado usando sus credenciales vlidas de SAP).
Asegrese de obtener la librera que corresponda a los bits soportados por su arquitectura de
sistema (p.e, de 64 bits o de 32 bits).
Una vez que haya obtenido la librera JCo, asegrese de:
1. Ubicar la librera sapjco-3.x.jar en el repositorio de libreras en <WEBSPHERE_HOME>/lib/ext/.
2. Ubicar el archivo sapjco3.so (para sistemas operativos tipo *nix como Linux) o el archivo sapjco3.dll
(para sistemas operativos Windows) en <BIZAGI_HOME>/connectors/SAP/jco3.
En la siguiente seccin (configuracin de variables de entorno) deber incluir esta ruta dentro de las
variables de entorno iniciales.
3. 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 (por defecto publicada para acceso desde
https://localhost:9043/ibm/console/logon.jsp).
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.
179
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).
180
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).
Ingrese los siguientes valores para las variables y propiedades como se ensea a continuacin:
Initial heap size (tamao inicial de pila de memoria): 1024
Maximum heap size (tamao mximo de pila de memoria): 1024
stos valores son sugeridos como mximo y mnimo de memoria para hacer deployment de Bizagi
correctamente. De otra forma, podran aparecer errores de falta de memoria, lo que llevara a una
instalacin corrupta.
181
Generic JVM arguments (argumentos genricos de la mquina virtual de Java):

-DiNET_HOME=<BIZAGI_HOME>\JiNET -Duser.language=en -Duser.country=US Dfile.encoding=UTF-8 Dcom.ibm.websphere.webservices.soap.enable.legacy.get.behavior=true
La variable -Dcom.ibm.websphere.webservices.soap.enable.legacy.get.behavior=true es necesaria, y

por ejemplo permite a WebSphere invocar servicios web cuyos encabezados sean nulos.
Considere que deber reemplazar <BIZAGI_HOME> con la ruta tal como la defini en pasos
anteriores de configuracin.
Tenga en cuenta que deber usar el caracter de separacin de carpetas apropiado (para sistemas
operativos *nix ser "/", mientras que en sistemas operativos Windows ser "\").
plataformas JEE, como se mencion en la seccin anterior.
Una vez que haya ubicado la libreras de JCo en las rutas adecuadas de su servidor JEE, incluya la
siguiente parte adicional a las variables ya modificadas de los Generic JVM arguments:
-Djava.library.path=<BIZAGI_HOME>\connectors\SAP\jco3
D clic en OK y luego en Guardar (Save) para aplicar los cambios.
182
Navegue nuevamente hacia el enlace Java Virtual Machine (ubicado en las propiedades adicionales -Additional Properties--).
De clic sobre el enlace de propiedades personalizadas (Custom properties), para crear las siguientes
propiedades personalizadas:
APP_SERVER: Propiedad usada internamente por Bizagi para manejo acorde al servidor JEE.
bizagi-config: Propiedad de tipo ruta, que utiliza Bizagi para cargar informacin adicional desde
archivos de propiedades.
Esta ruta debe indicar donde se encuentre el archivo bizagi-extended.properties.
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.
183
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.
com.ibm.websphere.webservices.soap.enable.legacy.get.behavior: Se debe especificar como true
para permitir que WebSphere soporte la invocacin a web services cuyos encabezados sean nulos.
Para crear estas propiedades, d clic sobre el botn de Nuevo (New) para registrar una propiedad
personalizada.
Nombre la primera propiedad con: APP_SERVER, y especifique para su valor: WEBSPHERE.
D clic en OK.
D clic sobre el botn de Nuevo (New) para registrar una segunda propiedad personalizada.
Nombre esta propiedad con: bizagi-config, y especifique que se valor sea la ruta donde queda la
carpeta bizagi-config, que es
donde
se
encuentra
el
archivo
de
propiedades
bizagi.extended.properties.
Esta ruta es una sub-carpeta de <BIZAGI_HOME>, por ejemplo \usr\share\bizagi-config\.
184
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.
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.
personalizada.
Nombre
esta
propiedad
como:
com.ibm.websphere.webservices.soap.enable.legacy.get.behavior, y especifique para
su valor: true.

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.
4. Configurar los mdulos de WebSphere

Se deben configurar algunos mdulos en WebSphere a travs de la Consola de administracin, como
185
se indica a continuacin.
4.1 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).
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
186
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
187
D clic en Siguiente (Next) y especifique la ruta completa al driver de conexin de Oracle (ojdbc),
donde se considera <WEBSPHERE_HOME>\lib\ext\.
Tenga presente que ac deber configurar el driver, asegurndose de que el class path referencie el
nombre exacto del archivo .jar.
Dado que por defecto WebSphere lo buscar como ojdbc6.jar, deber o bien redefinir en el class
path que se busque al archivo como lo entrega Bizagi con detalle de versin menor (ojdbc611.1.0.6.0.jar), o renombrar el archivo fsico para que se llame exactamente as (ojdbc6.jar).
188
D clic en Siguiente (Next) y revise la informacin de resumen. D clic sobre Finalizar (Finish).
Para SQL Server:
Database type (tipo de Base de datos): SQL Server
o Provider type (Tipo de proveedor): Microsoft SQL Server JDBC Driver
o Implementation type (Tipo de implementacin): Connection pool data source
o Name (Nombre): Microsoft SQL Server JDBC Driver
189
D clic en Siguiente (Next) y especifique la ruta completa hacia el driver de conexin de SQL Server
(sqljdbc), donde se considera <WEBSPHERE_HOME>\lib\ext\.
Dado que por defecto WebSphere lo buscar como sqldbc4.jar, deber o bien redefinir en el class
path que se busque al archivo como lo entrega Bizagi con detalle de versin menor (sqldbc4.0.jar), o renombrar el archivo fsico para que se llame exactamente as (sqldbc4.jar).
Una vez se haya creado el Proveedor, ste aparecer listado en la tabla (sea Oracle o SQL Server).
190
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
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).
191
Si usted utiliza una Base de datos SQL Server d clic en Siguiente (Next) y en la ventana a
continuacin asegrese de: Ingresar los parmetros de conexin a su instancia SQL Server y que se
seleccione la casilla Use this data source in container managed persistence (CMP).
Considere:
o database name: El nombre de la base de datos de sus procesos Bizagi.
o port number: El puerto bajo el cual el servicio de la base de datos atiende.
o server name: El nombre del servidor de base de datos.
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.
192

jdbc:oracle:thin:@[servidor_bd]:[puerto]/[servicio]
Considere:
o servidor_bd: El Servidor de Base de datos. Puede utilizar el SID en cambio.
o puerto: El puerto bajo el cual el servicio de la Base de datos atiende. En Oracle por defecto, es el
puerto 1521.
o servicio: El nombre del servicio de la instancia Oracle.
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.
Hga clic en el enlace Propiedades del Pool de Conexion (Connection Pool properties) en la seccin
Propiedades Adicionales (Additional Properties).
193
Ingrese los siguientes valores:

Conexiones mximas (Maximum connections):
Conexiones mnimas (Minimum connections):
120
30
Hga clic en OK y posteriormente en Guardar (Save) para aplicar los cambios.

Hga clic en el enlace Propiedades de la Fuente de datos del Servidor de Aplicaciones (WebSphere
Application Server data source properties) en la seccin Propiedades Adicionales (Additional
Properties).

Tamao del cache (Statement cache size): 200

194
D clic en el enlace de propiedades personalizadas (Custom properties) ubicado en la seccin de

Propiedades adicionales (Additional Properties).
Para SQL Server:
o webSphereDefaultIsolationLevel: Asgnelo a 2 (indicar un nivel llamado READ-COMMITTED).
o responseBuffering: Configrelo como adaptive.
o sendStringParametersAsUnicode: Su valor depende especficamente de su proyecto y si ste
soportar caracteres unicode. Para el soporte a unicode, especifique : true. Ntese que para
soporte a unicode igualmente deber estar utilizando una intercalacin que soporte unicode y la
configuracin apropiada en Bizagi para esta funcionalidad.
De manera adicional, cree 2 nuevas propiedades: usuario (user) y contrasea (password). Para sus
valores considere:
o user:
Para Oracle, es el esquema de usuario que representa el proyecto Bizagi.
Para SQL Server, es la cuenta para acceder a la instancia.
o password: La contrasea de ese usuario.
Para Oracle:
o webSphereDefaultIsolationLevel: Asgnelo a 2 (indicar un nivel llamado READ-COMMITTED).
De manera adicional, cree 2 nuevas propiedades: usuario (user) y contrasea (password). Para sus
valores considere:
o user:
Para Oracle, es el esquema de usuario que representa el proyecto Bizagi.
Para SQL Server, es la cuenta para acceder a la instancia.
o password: La contrasea de ese usuario.
195
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):
4.2 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.
196
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.
197
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.
198

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).
199
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 definir 2 directorios para almacenar logs y archivos del filestore:
Log directory path: El directorio donde quedan los logs asociados al nodo.
Se recomienda contar con una carpeta separada para el nodo y para los logs, por ejemplo
referenciar <WAS_HOME>\profiles\<NODE_NAME>\logs
Permanent store directory path: El directorio donde queda el almacen de archivo.
Se recomienda contar con una carpeta separada para el nodo y el filestore, por ejemplo referenciar
<WAS_HOME>\profiles\<NODE_NAME>\filestores
200
Usted podr definir dicha ruta dentro de <BIZAGI_HOME>, sin embargo el aspecto ms importante
y recomendado, es que esta carpeta quede dentro de la ruta de instalacin de WebSphere, de
manera que se eviten inconvenientes de permisos de acceso (se requiere mnimo permisos de
lectura y escritura; y preferiblemente ser el dueo (ownership) con relacin al usuario que ejecuta
WebSphere).

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: 1024
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
201
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 dos colas (queue).
Una cola ser destinada para el manejo de tareas asncronas en Bizagi y otra para los logs.
Para crear y asociar la primera cola, d clic en Nuevo (New ).

Seleccione que sea de tipo cola (destination type = Queue).
D clic en Siguiente (Next) e ingrese BizagiQueue como identificador (identifier) de la cola.

Ingrese una descripcin tambin.
202
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.

Este destino aparecer listado en la tabla de recursos.
203
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).
204
D clic en OK.
Para crear y asociar la segunda cola, d clic en Nuevo (New ) desde la misma tabla de destinos.
Seleccione que sea de tipo cola (destination type = Queue).
205
D clic en Siguiente (Next) e ingrese BizagiQueueEvent como identificador (identifier) de la cola.


anteriormente (para incluir la configuracin que abarca el clster).
D clic en Siguiente (Next) y luego en Finalizar (Finish) para registrar el destino.
Este destino aparecer listado en la tabla de recursos.
D clic sobre la cola recin creada (BizAgiQueueEvent) para editar su configuracin de reintentos.
deliveries per message), para que tenga un valor igual a 1.
De clic en OK.
Recuerde dar clic en Guardar (Save) para aplicar los cambios.
206
Fbrica de conexiones JMS

Ahora crearemos dos Fbricas de conexiones JMS (una para manejar las tareas asncronas y la otra
para el manejo de logs).
Navegue a la seccin de Recursos (Resources) y expanda el item JMS. D clic sobre Queue Connection
factories.
Para crear la primera fbrica de conexin de colas (Queue Connection factory), de clic en Nuevo
(New).
Mantenga el Proveedor de mensajera por defecto: Default messaging provider, y d clic en
OK.
207
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).
208
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.
209
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.
210
Para crear la segunda fbrica de conexin de colas (Queue Connection factory), de clic en Nuevo
(New), asegurndose de haber seleccionado el scope correspondiente de su clster.

OK.
Ingrese AsyncAuditControllerFactory tanto para el Nombre (Name) como para el Nombre
JNDI (JNDI Name).
211
D clic en Ok.
D clic en la Fbrica creada recin AsyncAuditControllerFactory (la cual aparecer listada en la tabla),
para editar el parmetro de timeout de la conexin.
212
Recuerde guardar (dar clic en Save) para aplicar los cambios.

Recurso de colas
213
Ahora crearemos dos recursos de colas (una para ser utilizada en el manejo de las tareas asncronas .
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.
Para crear el primer recurso para el manejo de tareas asncronas, d clic en Nuevo (New).
Mantenga el Proveedor de mensajera por defecto: Default messaging provider y d clic en
OK.
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.
214
D clic en OK.
Deber ver el recurso listado en la tabla.
Para crear el segundo recurso para el manejo de logs, d clic en Nuevo (New), asegurndose de
seleccionar el scope que incluye el clster (debe listarse como Cluster=[Nombre_clster]).
OK.

Name (Nombre): AsyncAuditController
JNDI Name (Nombre JNDI): jms/AsyncAuditController
Queue name (Nombre de la cola): seleccione la cola creada anteriormente: BizAgiQueueEvent.
215
D clic en OK.
Deber ver ambos recursos listados en la tabla.
216
Especificacin de activaciones
Ahora crearemos dos recursos ms de especificacin de las activaciones (Activation specification). Una
especificacin ser dedicada para las tareas asncronas y la otra para los logs de Bizagi.
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.
Para crear la primera especificacin del manejo de las tareas asncronas, d clic en Nuevo (New).
OK.
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
Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus
217
D clic en OK.
Deber ver la especificacin listada en la tabla.
Para crear la segunda especificacin del manejo de los logs, d clic en Nuevo (New), asegurndose
de seleccionar el scope correspondiente a su clster.
OK.
218

Name (Nombre): AsyncAuditControllerActivationSpec
JNDI Name (Nombre JNDI) : eis/AsyncAuditControllerActivationSpec
Destination type (tipo de destino): seleccione cola: Queue
Destination JNDI Name (Nombre JNDI del destino): jms/AsyncAuditController
D clic en OK.
Deber ver ambas especificaciones listadas en la tabla.
219

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 crean dos Fbricas de tpicos y dos tpicos.
Para iniciar creando las Fbricas de Tpicos, 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.
D clic en Nuevo (New) para crear este recurso. Mantenga el Proveedor de mensajera por defecto:
Default messaging provider y d clic en OK.
220
Ingrese el siguiente detalle:

Name (Nombre): ELEntitiesTopicFactory
JNDI Name (Nombre JNDI): jms/ELEntitiesTopicFactory
Bus name (Nombre del Bus): Seleccione BizAgiBus.
Nonpersistent message reliability (Confianza de mensajes no persistentes): Seleccione Best
effort nonpersistent.
D clic en OK.
Para crear la segunda Fbrica de Tpicos, repita los pasos anteriores: de clic en Nuevo (New) para
crear este recurso y mantenga el Proveedor de mensajera por defecto: Default messaging
provider. D clic en OK e ingrese el siguiente detalle:
Name (Nombre): ELRenderTopicFactory
JNDI Name (Nombre JNDI): jms/ELRenderTopicFactory
Bus name (Nombre del Bus): Seleccione BizAgiBus.
Nonpersistent message reliability (Confianza de mensajes no persistentes): Seleccione Best
effort nonpersistent.
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.
D clic en Nuevo (New) para crear este recurso. Mantenga el Proveedor de mensajera por defecto:
Default messaging provider y d clic en OK.
Ingrese el siguiente detalle:

Name (Nombre): ELEntitiesTopic
JNDI Name (Nombre JNDI) : jms/ELEntitiesTopic
221
Topic space (Nombre de espacio al que pertenece el tpico: Default.Topic.Space

JMS delivery mode (Modo de entrega): Nonpersistent
D clic en OK.
Para crear el segundo Tpico, repita los pasos anteriores: de clic en Nuevo (New) para crear este
recurso y mantenga el Proveedor de mensajera por defecto: Default messaging provider. D
clic en OK e ingrese el siguiente detalle:
Name (Nombre): ELRenderTopic
JNDI Name (Nombre JNDI) : jms/ELRenderTopic
Topic space (Nombre de espacio al que pertenece el tpico: Default.Topic.Space
JMS delivery mode (Modo de entrega): Nonpersistent
4.3 Configuracin de libreras compartidas

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 una librera compartida que referencia a su vez 2 libreras:
httpclient-4.1.1.jar
httpcore-4.1.jar
Para la librera compartida, ingrese el siguiente detalle para la especificacin:
Name: httpclient
Classpath:
$<WEBSPHERE_HOME>/optionalLibraries/httpclient-4.1.1.jar
$<WEBSPHERE_HOME>/optionalLibraries/httpcore-4.1.jar
Ntese que deber editar <WEBSPHERE_HOME> para que haga referencia a la ruta donde se
encuentran dichas libreras, tal como se ubicaron en los pasos previos de instalacin.
Asegrese tambin de marcar la casilla que especifica Use an isolated loader for this library.
222
De clic en OK y en Guardar (Save) para aplicar los cambios.

4.4 Autenticacin y el usuario de sistema Bizagi
La configuracin del usuario interno del sistema Bizagi es estrictamente requerido, para el usuario
llamado admon del dominio por defecto llamado domain.
Para la configuracin de este usuario, acceda la Consola de administracin desde el nodo que cuenta
con el perfil de Deployment Manager (DM).
Para hacerlo, en el nodo con perfil DM, vaya a la seccin de Usuarios y grupos (Users and groups), y
d clic sobre el enlace de Administrar usuarios (Manage users ).
223
D clic en el botn de crear (Create... ) para registrar el usuario administrador por defecto.
Ingrese la siguiente informacin (debe ser necesariamente la informacin a continuacin):
User ID (id de usuario): domain\admon
First name (nombre): Bizagi
Last name (apellido): Bizagi
Password (contrasea): bizagi
D clic sobre Crear (Create). WebSphere notificar que la operacin ha sido exitosa, y podr hacer clic
sobre Cerrar (Close).
Una vez finalice este paso, configure la autenticacin desde las opciones mismas de la consola.
Vaya a la seccin de Seguridad (Security) y de expanda el tem de Seguridad global (Global Security).
Seleccione la casilla de Habilitar la seguridad a nivel de aplicacin (Enable application security) y d
224
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.
Ingrese BizagiDomain en el Nombre (Name) del nuevo dominio:
225
D clic en OK.
D clic sobre el dominio recin creado (BizagiDomain), que aparecer listado:
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):
226
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.
227
228
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
229
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--).
230
D clic en OK, y revise que BizAgiLoginModule sea el primero de los mdulos de WEB_INBOUND
(module order = 1).
231
De vuelta en la configuracin del dominio, de clic sobre Custom properties para adicionar otros
parmetros especficos para la autenticacin.
De clic en Nuevo (New) y adicione esta propiedad:
Name (Nombre): com.ibm.ws.security.web.logoutOnHTTPSessionExpire
Value (Valor): true
Finalmente, d clic en Guardar (Save) para persistir los cambios.
En este punto el Servidor requiere de un reinicio.
Una vez que complete estos pasos, consulte la Configuracin de el Scheduler en WebSphere.
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
232
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
<INSUMOS_DE_CONFIGURACIN> en esta seccin.
Configuracin
Ubique la siguiente ruta local:
<INSUMOS_DE_CONFIGURACIN>/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
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 <INSUMOS_DE_CONFIGURACIN>/

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],:
233
[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).
Para iniciar el servicio, ejecute el archivo start-service como usuario administrador.

En sistemas operativos de tipo *nix como Linux, este archivo ser:
<INSUMOS_DE_CONFIGURACIN>/BizagiSchedulerService/bin/start-service.sh
En sistemas operativos Windows, este archivo ser:
<INSUMOS_DE_CONFIGURACIN>\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.
En sistemas operativos de tipo *nix como Linux, este archivo ser:
<INSUMOS_DE_CONFIGURACIN>/BizagiSchedulerService/bin/shutdown-service.sh
<INSUMOS_DE_CONFIGURACIN>\BizagiSchedulerService\bin\shutdown-service.bat
Una vez que complete estos pasos, consulte la Configuracin de la arquitectura del sistema.
Configuracin estndar de WebSphere
Introduccin
234
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).
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 (y JBoss es un servidor ms ligero que inicia/reinicia
ms rpido, y que no requerir de configuracin adicional/manual para su proyecto).
Sin embargo, si su proyecto requiere estrictamente que se utilice WebSphere en el ambiente de
235
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).
El archivo BizAgi-ear-WebSphere-dist.zip (incluido en la descarga de Bizagi Engine JEE WebSphere)
debe corresponder a la versin de Bizagi que ha usado en su ambiente de desarrollo (es decir, la
versin de Bizagi Studio y el Plug-in JEE).
Tener instalado el Servidor WebSphere v 8.5.
Las versiones soportadas son las pertenecientes a WebSphere 8.5.5, lo cul incluye hasta el update
8.5.53 (recomendado).
De manera similar, tener instalado el WebSphere Application Server Network Deployment (WASND)
que corresponda a WebSphere v 8.5.
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, y WASND como los lineamientos presentados en la
siguiente seccin.
Requisitos de WebSphere
Para instalar WebSphere (una vez que haya cubierto todos los prerrequisitos), asegrese de
considerar lo siguiente:
Instalar el conjunto de archivos y productos usuales entregados por WebSphere para manejar su
Servidor de Aplicacin (Application Server) de WebSphere como IBM recomienda.
El conjunto de archivos y productos incluye: Installation Manager, WebSphere Network Deployment, y
paquetes de fixes (WebSphere Fixpacks), en este caso para v 8.5.
Al instalar el Installation Manager considere:

Seleccionar un directorio de instalacin que no contenga espacios en blanco.
Haber descomprimido ya los archivos de insumo del WebSphere Network Deployment y de los
236
WebSphere Fixpacks, cada uno por aparte en un directorio que no contenga espacios en blanco.
Destinar dos repositorios para el Installation Manager, al definir la ruta desde la cul estos archivos
sern cargados.
Los 2 repositorios deben apuntar a los directorios definidos anteriormente donde se descomprimieron
los archivos de insumo del WebSphere Network Deployment y de los WebSphere Fixpacks.
Instalar el WebSphere Application Server a travs del Installation Manager.
Al hacerlo, siga las mismas recomendaciones mencionadas anteriormente, donde se procure
seleccionar un directorio de instalacin que no contenga espacios en blanco.
Seleccione un directorio para instalar los paquetes de los componentes compartidos que igualmente
tampoco contenga espacios en blanco.
Ntese que podr iniciar la opcin Profile Management Tool para crear el perfil que se requiere para
su instancia de WebSphere Application Server.
Use el Profile Management Tool y cree un perfil con las siguientes caractersticas:
o Configuracin de ambiente (Environment) asignado a Application server (recuerde que en
237
este procedimiento se configura WebSphere a manera standalone, y no a manera de clster).
o Opcin Deploy the administrative console marcada. Esta opcin est disponible al seleccionar
primero Advanced Profile creation:
238
o Definicin de un nombre del perfil (profile name) y una ruta del mismo (profile directory), donde
ninguna de estas definiciones contenga espacios en blanco.
o Definicin de un nombre del nodo (Node name) y del servidor (Server name), donde ninguna de
estas definiciones contenga espacios en blanco.
Para el nombre del host (Host name) usted podr dejar el de por defecto, donde usualmente se toma
el nombre del servidor fsico.
Habilitar la seguridad administrativa (Administrative security), y definir un usuario y contrasea para
el acceso autorizado.
239
Podr ignorar configuracin adicional en relacin a los certificados del servidor (paso Security
Certificates) y dejar los valores por defecto y la asignacin de puertos del servicio.
o No se debe configurar el servidor como un servicio de Windows (aplica para sistemas operativos
Windows). Para ello asegrese de dejar sin marcar la opcin Run the application server process as a
Windows service.
Una vez que revise los detalles en el resumen de instalacin contine con el procedimiento.
La ruta de instalacin, que incluye la instancia del servidor creada, ser referenciada a partir de este
momento como <WEBSPHERE_HOME>.
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 sistemas operativos *nix:
<WEBSPHERE_HOME>/profiles/AppSrv01/bin/startServer.sh
[nombre_instancia_servidor]
En sistemas operativos Windows:
240
<WEBSPHERE_HOME>\profiles\AppSrv01\bin\startServer.bat
[nombre_instancia_servidor]
Considere:
[nombre_instancia_servidor] deber corresponder al nombre de la instancia de su servidor WebSphere
como se configur durante la instalacin.
Detener el Servidor (domain)

Para detener los servicios de WebSphere, execute el siguiente archivo en un smbolo del sistema.
En sistemas operativos *nix:
<WEBSPHERE_HOME>/profiles/AppSrv01/bin/stopServer.sh
[server_instance_name]-username [authorized_user] -password
[authorized_password]
<WEBSPHERE_HOME>\profiles\AppSrv01\bin\stopServer.bat
[server_instance_name] -username [authorized_user] -password
[authorized_password]
Considere:
[nombre_instancia_servidor] deber corresponder al nombre de la instancia de su servidor
WebSphere como se configur durante la instalacin.
[authorized_user] should match the username set for administrative security as configured during
installation.
[authorized_password] should match the password of the user set for administrative security as
configured during installation.
241
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
Lo que debe hacer

Para la configuracin de WebSphere para trabajar con Bizagi, el siguiente procedimiento se lleva a
cabo:
1.
2.
3.
4.
Instalar las libreras usados por Bizagi hacia WebSphere.

Configurar los siguientes mdulos en WebSphere:
Acceso a datos
Autenticacin y usuario del sistema Bizagi
Estos mdulos se configuran en WebSphere utilizando su Consola de administracin, y utilizan a su vez

las libreras y drivers que se instalan en el primer paso.
Despus de estos pasos, su instancia de WebSphere estar configurada para que los Procesos de
Bizagi se desplieguen como una aplicacin JEE (se genera el Portal de Trabajo).
Procedimiento
de WebSphere por defecto.
Realice los pasos de configuracin como se indican a continuacin, teniendo en cuenta que los
nombres usados son sensibles a maysculas.
242
1. Instalar las libreras usados por Bizagi en WebSphere.

En este paso, se incluyen libreras y drivers usados por Bizagi en la instancia de WebSphere (son
archivos que no vienen por defecto en una instalacin limpia de WebSphere).
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-WebSpheredist.zip).
\ROOT\BizAgi-ear-WebSphere-dist\BizagiBPMJEE\:

Autenticacin (bizagi-websphere-security-[version].jar, bizagi-remote-[version].jar, bizagi-securitycommon-[version].jar) que se entregan en los insumos de configuracin, desde esta ruta:
243
1.2 Instalar libreras adicionales.

La instalacin de las libreras adicionales se realiza simplemente copiando esas libreras como por
ejemplo la que se utiliza para el registro de logs llamada log4j-[version].jar y la librera que se usa
para la persistencia de datos llamada eclipselink-[version].jar.
Dado que ambas se entregan dentro de los insumos de configuracin, cpielas desde esta ruta:
Paso seguido, asegrese de editar el nombre de la librera de eclipselink de manera que no
especifique el detalle exacto de la versin (renmbrelo de manera que quede como eclipselink.jar):
244
1.3 Instalar libreras compartidas

La instalacin de 2 libreras compartidas se realiza copiando esas libreras como se entregan dentro
de los insumos de configuracin en <CONFIGURATION_INPUTS>\configuration\hacia las rutas
de libreras opcionales de WebSphere.
Para hacerlo, copie los jars httpclient-4.1.1.jar y httpcore-4.1.jar en:
<WEBSPHERE_HOME>\optionalLibraries\
1.4 Instalar los drivers.
La instalacin de los drivers se realiza copiando esas libreras correspondientes al motor de base de
datos, como se entregan dentro de los insumos de configuracin.
Para hacerlo, copie los drivers desde <INSUMOS_DE_CONFIGURACIN>\configuration\y hacia la
ruta de libreras de WebSphere en:
Si su proyecto utiliza Oracle, copie el driver ojdbc6-11.1.0.6.0.jar.
Si su proyecto utiliza SQL Server, copie el driver sqldbc-4..0.jar.
Additionalmente, copie el driver bizagi-jdbc-driver[version].jar.

para que WebSphere los considere cuando suba el servicio.
aparte.
WebSphere y que el dueo de la misma sea el mismo usuario que ejecuta WebSphere.
Tambin se recomienda que dentro de <BIZAGI_HOME>, se ubique la Consola administrativa JEE,
til para el procedimiento de despliegue de aplicacin.
<BIZAGI_HOME>
<BIZAGI_HOME>
<BIZAGI_HOME>
245
plataformas JEE.
como Linux, o un archivo .dll para sistemas operativos Windows).
1. Ubicar la librera sapjco-3.x.jar en el repositorio de libreras en <WEBSPHERE_HOME>/lib/ext/.
(para sistemas operativos Windows) en <BIZAGI_HOME>/connectors/SAP/jco3.

primero inicie el servicio de su instancia de WebSphere.
Seguidamente, acceda a la Consola de administracin (por defecto publicada para acceso desde
https://localhost:9043/ibm/console/logon.jsp).
246
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.
En ella, expanda el tem Java and Process Management y d clic sobre la definicin de Procesos
(Process definition).
247
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).
Ingrese los siguientes valores para las variables y propiedades como se ensea a continuacin:
Initial heap size (tamao inicial de pila de memoria): 1024
Maximum heap size (tamao mximo de pila de memoria): 1024
248
Generic JVM arguments (argumentos genricos de la mquina virtual de Java):

-DiNET_HOME=<BIZAGI_FILES>\JiNET -Duser.language=en -Duser.country=us Dfile.encoding=UTF-8 Dcom.ibm.websphere.webservices.soap.enable.legacy.get.behavior=true
La variable -Dcom.ibm.websphere.webservices.soap.enable.legacy.get.behavior=true es necesaria, y

por ejemplo permite a WebSphere invocar servicios web cuyos encabezados sean nulos.
249

siguiente parte adicional a las variables ya modificadas de los Generic JVM arguments:
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) para crear 3 propiedades personalizadas.
250
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.
D clic sobre el botn de Nuevo (New) para registrar una segunda propiedad personalizada.
Nombre esta propiedad con: bizagi-config, y especifique que se valor sea la ruta donde queda la
carpeta bizagi-config, que es
donde
se
encuentra
el
archivo
de
propiedades
bizagi.extended.properties.
Esta ruta es una sub-carpeta de <BIZAGI_HOME>.
251
Nombre esta propiedad como

com.ibm.websphere.webservices.soap.enable.legacy.get.behavior, y especifique que
su valor sea true.
Podr visualizar estas nuevas propiedades como se listan a continuacin:
Reinicie el servidor una vez haya finalizado este paso.
4. Configurar los mdulos de WebSphere

Se deben configurar algunos mdulos en WebSphere a travs de la Consola de administracin, como
252
4.1 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).
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):
253
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
254
D clic en Siguiente (Next) y especifique la ruta completa al driver de conexin de Oracle (ojdbc),
donde se considera <WEBSPHERE_HOME>\lib\ext\.
Dado que por defecto WebSphere lo buscar como ojdbc6.jar, deber o bien redefinir en el class
path que se busque al archivo como lo entrega Bizagi con detalle de versin menor (ojdbc611.1.0.6.0.jar), o renombrar el archivo fsico para que se llame exactamente as (ojdbc6.jar).
255
o
o
o
o
Para SQL Server:

Database type (tipo de Base de datos): SQL Server
Provider type (Tipo de proveedor): Microsoft SQL Server JDBC Driver
Implementation type (Tipo de implementacin): Connection pool data source
Name (Nombre): Microsoft SQL Server JDBC Driver
256
D clic en Siguiente (Next) y especifique la ruta completa hacia el driver de conexin de SQL Server
(sqljdbc), donde se considera <WEBSPHERE_HOME>\lib\ext\.
Dado que por defecto WebSphere lo buscar como sqldbc4.jar, deber o bien redefinir en el class
path que se busque al archivo como lo entrega Bizagi con detalle de versin menor (sqldbc4.0.jar), o renombrar el archivo fsico para que se llame exactamente as (sqldbc4.jar).
257
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 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):
258
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
259
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.
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).
260
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.
Hga clic en el enlace Propiedades del Pool de Conexion (Connection Pool properties) en la seccin
Propiedades Adicionales (Additional Properties).
261

Conexiones mximas (Maximum connections):
Conexiones mnimas (Minimum connections):
120
30

Hga clic en el enlace Propiedades de la Fuente de datos del Servidor de Aplicaciones (WebSphere
Application Server data source properties) en la seccin Propiedades Adicionales (Additional
Properties).
262

Tamao del cache (Statement cache size): 200

D clic en el enlace de propiedades personalizadas (Custom properties) ubicado en la seccin de
Propiedades adicionales (Additional Properties).
263
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:
o user: El esquema de usuario que representa el proyecto Bizagi.
o password: La contrasea de ese esquema de usuario.
264
o
o
o
o
o
o
o
Para SQL Server:

serverName: El nombre del Servidor de Base de datos.
portNumber: El puerto bajo el cual la instancia atiende. En SQL Server y por defecto, es el puerto
1433.
webSphereDefaultIsolationLevel: Asgnelo a 1. Este valor indicar un nivel READ-UNCOMMITTED.
sendStringParametersAsUnicode: Su valor depende especficamente de su proyecto y si ste
soportar caracteres unicode. Para el soporte a unicode, especifique : true. Ntese que para
soporte a unicode igualmente deber estar utilizando una intercalacin que soporte unicode y la
configuracin apropiada en Bizagi para esta funcionalidad.
databaseName: El nombre de la Base de datos que corresponde al proyecto.
user: La cuenta login para acceder a la Base de datos.
password: La contrasea de esa cuenta login.
265
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):
266

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).
267
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).
268
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.
269
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, debemos crear 2 colas para el manejo asncrono de las
caractersticas en Bizagi (una cola para el manejo de tareas asncronas y otra cola para los logs).
Para crear y asociar la primera cola, d clic sobre el enlace de Destinos (Destinations), ubicado bajo
la seccin de los recursos destino (Destination resources).
270
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.

271

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.
272
D clic sobre la cola recin creada (BizAgiQueue) para editar su configuracin de reintentos.
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).
273
D clic en Ok.
Para crear la segunda cola para el manejo de logs, nuevamente de clic en Nuevo (New), ubicada
bajo la seccin de los recursos destino (Destination resources) nuevamente.
Seleccione el tipo de la cola (destination type = Queue).
274
D clic en Siguiente (Next) e ingrese BizagiQueueEvent como identificador (identifier) de la cola.


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.
D clic sobre la cola recin creada (BizAgiQueueEvent) para editar su configuracin de reintentos.
deliveries per message), para que tenga un valor igual a 1.
275
D clic en Ok.
Recuerde dar clic en Guardar (Save) para aplicar los cambios igualmente.
Fbrica de conexiones JMS
Ahora crearemos dos Fbricas de conexiones para JMS (una para utilizarse en el manejo de tareas
asncronas de Bizagi y otra para los logs).
Navegue a la seccin de Recursos (Resources) y expanda el item JMS.
D clic sobre Queue Connection factories.
Server=server1) .
276
Para crear la primera fbrica de conexiones para el manejo de las asncronas, de clic en Nuevo
(New).
OK.
Ingrese:
Nombre (Name): AsyncControllerFactory
Nombre JNDI (JNDI Name): AsyncControllerFactory
277
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.
278
279
En este punto el recin creado recurso aparecer listado en la tabla (Queue connection factories).
Para crear la segunda fbrica de conexiones para el manejo de los logs, nuevamente desde esa
tabla de clic en Nuevo (New), y asegrese de seleccionar el scope que incluye la instancia del
servidor (debe listarse como Node=[su_servidor], Server=server1) .

280
OK.
Ingrese:
Nombre (Name): AsyncAuditControllerFactory
Nombre JNDI (JNDI Name): AsyncAuditControllerFactory
D clic en OK.
D clic en la Fbrica creada recin AsyncAuditControllerFactory (la cual aparecer listada en la tabla),
para editar el parmetro de timeout de la conexin.
281
Recuerde guardar (dar clic en Save) para aplicar los cambios.

Recurso de colas
Ahora crearemos dos recurso de colas (uno para el manejo de tareas asncronas y el otro para los
282
logs).
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:
Para crear la primera cola para las tareas asncronas, d clic en Nuevo (New).
Mantenga el Proveedor de mensajera por defecto: Default messaging provider y d clic en OK.

Name (Nombre): AsyncController
JNDI Name (Nombre JNDI): jms/AsyncController
Queue name (Nombre de la cola): seleccione la cola creada anteriormente: BizAgiQueue.
283
D clic en OK.
Deber ver la cola creada listada en la tabla.
284
Para crear la segunda cola para el manejo de logs, nuevamente en la tabla, d clic en Nuevo (New).
Asegrese de seleccionar el scope correspondiente y mantenga el Proveedor de mensajera por
defecto: Default messaging provider.
D clic en OK.
Name (Nombre): AsyncAuditController
JNDI Name (Nombre JNDI): jms/AsyncAuditController
285
Queue name (Nombre de la cola): seleccione la cola creada anteriormente: BizAgiQueueEvent.
D clic en OK.
Note que ambas colas debern aparecer en la tabla de colas.
286
Recuerde dar clci en Guardar (Save) para aplicar los cambios.
Especificacin de activaciones.
Ahora crearemos 2 especificaciones de activaciones (Activation specification), una para el manejo de
tareas asncronas en Bizagi y otra para los logs.
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):
Para crear la primera especificacin, d clic en Nuevo (New).

Mantenga el Proveedor de mensajera por defecto: default messaging provider y d clic en OK.

Name (Nombre): AsyncControllerActivationSpec
JNDI Name (Nombre JNDI) : eis/AsyncControllerActivationSpec
Destination type (tipo de destino): Queue.
287
Destination JNDI Name (Nombre JNDI del destino): jms/AsyncController

Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus.
D clic en OK.
Deber ver la definicin de esta especificacin listada en la tabla.
288
Para crear la segunda especificacin, d clic en Nuevo (New), asegurndose de haber seleccionado
el scope que incluye la instancia del servidor (debe listarse como Node=[su_servidor],
Server=server1):
Mantenga el Proveedor de mensajera por defecto: default messaging provider y d clic en OK.

Name (Nombre): AsyncAuditControllerActivationSpec
JNDI Name (Nombre JNDI) : eis/AsyncAuditControllerActivationSpec
Destination type (tipo de destino): Queue.
Destination JNDI Name (Nombre JNDI del destino): jms/AsyncAuditController
Bus name (Nombre del bus): seleccione el bus creado para Bizagi: BizAgiBus.
289
D clic en OK.
Deber ver ambas definiciones listadas en la tabla.
290

4.3 Configuracin de libreras compartidas
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).
Asegrese de seleccionar el scope que incluye su servidor (a manera de instancia standalone).
De clic en Nuevo (New) para registrar una librera compartida que referencia a su vez 2 libreras:
httpclient-4.1.1.jar
httpcore-4.1.jar
Para la librera compartida, ingrese el siguiente detalle para la especificacin:
Name: httpclient
Classpath:
$<WEBSPHERE_HOME>/optionalLibraries/httpclient-4.1.1.jar
$<WEBSPHERE_HOME>/optionalLibraries/httpcore-4.1.jar
Ntese que deber editar <WEBSPHERE_HOME> para que haga referencia a la ruta donde se
encuentran dichas libreras, tal como se ubicaron en los pasos previos de instalacin.
Asegrese tambin de marcar la casilla que especifica Use an isolated loader for this library.
291
De clic en OK y en Guardar (Save) para aplicar los cambios.

4.4 Autenticacin y usuario del sistema Bizagi
La configuracin del usuario de sistema interno 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).
292
D clic en el botn de crear (Create... ) para registrar el usuario de sistema.

Ingrese la siguiente informacin (debe ser necesariamente la informacin a continuacin):
User ID (id de usuario): domain\admon
First name (nombre): Bizagi
Last name (apellido): Bizagi
Password (contrasea): bizagi.
D clic sobre Crear (Create). WebSphere notificar que la operacin ha sido exitosa, y podr hacer clic
sobre Cerrar (Close).
Para configurar la autenticacin, 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
293
clic sobre Aplicar (Apply).
Vaya a la seccin Seguridad Web (Web and SIP security) y d clic sobre el link (General Settings).
Bajo la seccin Comportamiento de la autenticacin Web (Web authentication behavior), asegrese

de que la opcin Autenticar slo cuando el URI est protegido (Authenticate only when the URI is
protected) est seleccionada.
294
D clic en OK. d clic en Guardar (Save) para persistir los cambios.

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:
295
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).
296
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.
297
298
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).
299
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--).
300
D clic en OK, y revise que BizAgiLoginModule sea el primero de los mdulos de WEB_INBOUND
(module order = 1).
301
Finalmente, d clic en Guardad (Save) para persistir los cambios.

En este punto el Servidor requiere de un reinicio.
Qu sigue?
Despus de estos pasos, su instalacin de WebSphere est configurada para albergar Procesos Bizagi!
Podr ahora iniciar su servidor y hacer generar el Portal de Trabajo de Bizagi (realizar un despliegue
de aplicacin de WebSphere).
Recuerde que en este punto su servidor de WebSphere est configurado para trabajar con Bizagi, y
que la ruta y archivos dentro de <BIZAGI_HOME> no deber ser eliminada o modificada (a menos
de que se lleve a cabo una actualizacin de versin de Bizagi, en cuyo caso algunas modificaciones a
estos archivos podrn aplicar).
Otros archivos dentro de los insumos de configuracin que no se utilizaron en los pasos de esta
seccin, como por ejemplo BizAgiConsoleManager-JEE-dist, sern usados para el procedimiento del
despliegue de los procesos.
Por lo anterior, usted puede descomprimir la carpeta de la Consola JEE dentro de <BIZAGI_HOME>
(recomendado).
Para ms informacin sobre esta opcin, consulte el despliegue de la aplicacin hacia WebSphere.
302
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.
303
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.
304
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.
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 solicitudes, 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).
El archivo BizAgi-ear-Weblogic-dist.zip (incluido en la descarga de Bizagi Engine JEE Weblogic) debe
corresponder a la versin de Bizagi que ha usado en su ambiente de desarrollo (es decir, la versin de
Bizagi Studio y el Plug-in JEE).
Tener instalado el Servidor Weblogic en su versin 12c R1.
La versin soportada de Weblogic es la 12.1.3.
Weblogic puede descargarse o solicitarse directamente desde la pgina oficial de Oracle.
Tenga presente que debe tener el instalador apropiado a su sistema y que para su instalacin debe
seguir tanto los requisitos de Weblogic, como las recomendaciones del fabricante (Oracle) y otros
lineamientos presentados en las siguientes secciones (p.e la creacin de un dominio y el registro del
clster y los servidores involucrados, no utilizar rutas de instalacin con espacios en blanco, etc).
305
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.
Ntese que deber asegurarse de instalar Oracle Coherence, dado que mediante esta seccin se
configura un clster de Weblogic.
Seleccionar el JDK pre-instalado (de su Java home ya configurado, usando JDK 6, update 45).
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:
306
Instalar el servicio de Windows (cuando aplica para el sistema operativo utilizado).
307
Para una gua completa sobre la instalacin de Weblogic, consulte la documentacin oficial de Oracle.
Esta ruta de instalacin ser referenciada como <WEBLOGIC_HOME> a partir de este momento.
Tenga en cuenta que la instalacin de Weblogic se requiere para cada nodo que desee activar en su
clster de Weblogic.
Esto significa repetir el procedimiento anterior para cada nodo.
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.
Note que este paso se requiere solo una vez, indiferente del nmero de nodos que vaya a utilizar para
su clster.
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).
Puede optar por usar la opcin de Generar el dominio configurado automticamente (Generate a
domain configured automatically).
308
Para mayor informacin acerca de estos temas de instalacin y primeros pasos consulte la
documentacin oficial de Weblogic.
Al crear un dominio, tenga presente la definicin de la ruta y nombre de dicho dominio.
De clic en Siguiente.
309
Configure el nombre de usuario y contrasea para el usuario administrador que podr subir el
dominio e ingresar a la consola de administracin de Weblogic (en este ejemplo, usuario admin).
310
Tenga presente que deber recordar las credenciales del usuario administrador y su contrasea
para su uso posterior.
En la configuracin del modo de inicio del servidor (Configure Sever Start Mode and JDK), seleccione
la opcin de produccin (Production Mode). Seleccione el JDK disponible y compatible, tal como se
configur para la instalacin del servidor.
311
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).
Recuerde que a travs de esta seccin, usted va a configurar una instancia de Weblogic en clster.
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.
Ntese que en caso de utilizar SSL, deber activar la casilla de SSL y especificar el puerto de recepcin
SSL.
De clic en Siguiente para proceder con la configuracin de la administracin del clster.
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
312
SSL.
De clic en Siguiente para proceder con la configuracin de mensajera entre nodos.

Asegrese de ingresar 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].
313
De clic en Siguiente y asegrese de asignar los nodos al clster de manera explcita (incluyndolos en
el listado del clster).
314
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 (por
defecto usando el puerto 5556).
Tenga en cuenta que la configuracin deber hacerse en la pestaa correspondiente al tipo de sistema
operativo (Windows o de tipo/familia Unix).
315
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
(teniendo presente que se recomienda dejar AdminServer en una mquina dedicada, dado que sta
realizara las labores de administracin).
Revise los parmetros de configuracin de su dominio antes de proceder con la creacin.
Una vez que los haya revisado, de clic en Crear.
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_12.1\common\bin\.
316
Debe ser en la mquina donde se realizaron los cambios.

2. Desde esa ubicacin ejecute el siguiente comando.
Para sistemas operativos tipo *nix (p.e Linux):
pack.sh
-managed=true
-domain=<WEBLOGIC_HOME>/user_projects/domains/
[CLUSTER_DOMAIN] -template=template.jar -template_name="[CLUSTER_DOMAIN]"
Para sistemas operativos Windows:
pack.cmd
-managed=true
-domain=<WEBLOGIC_HOME>\user_projects\domains
\[CLUSTER_DOMAIN] -template=template.jar -template_name="[CLUSTER_DOMAIN]"
Este comando 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_12.1\common\bin\
con este mismo nombre del dominio (aunque podr cambiarlo por medio de template_name).
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_12.1\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 sistemas operativos tipo *nix (p.e Linux):
unpack.sh
-template=<WEBLOGIC_HOME>/[CLUSTER_DOMAIN].jar
domain=<WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]

unpack.cmd
-template=<WEBLOGIC_HOME>\[CLUSTER_DOMAIN].jar
domain=<WEBLOGIC_HOME>\user_projects\domains\[CLUSTER_DOMAIN]
Asegrese de especificar el valor para -domain y -template de manera consistente con la ruta que
usted selecciono en los pasos anteriores y de acuerdo al nombre de la plantilla, sobretodo si usted
ha personalizado estos valores.
6. Seguidamente, revise el archivo de propiedades de configuracin ubicado
<WEBLOGIC_HOME>\wlserver_12.1\common\nodemanager\nodemanager.properties.
En l, asegrese de tener:
StartScriptName: Asignado al ejecutable startWebLogic.
como
317
Tenga presente el sistema operativo; en

StartScriptName=startWebLogic.cmd
Para sistemas operativos tipo *nix ser:
StartScriptName=startWebLogic.sh
StartScriptEnabled: Asignado con verdadero.
Deber quedar: StartScriptEnabled=true
caso
de
ejecutarse
sobre
Windows
ser:
Cuando se ejecuta NodeManager en plataformas de 64 bits, es posible que requiera utilizar el

siguiente parmetro:
NativeVersionEnabled=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 sistemas operativos tipo *nix (p.e Linux)::
<WEBLOGIC_HOME>/wlserver_12.1/server/bin/startNodeManager.sh
<WEBLOGIC_HOME>\wlserver_12.1\server\bin\startNodeManager.cmd
La ejecucin deber mostrar que el manejador inicia bajo el puerto 5556:
318
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 sistemas operativos tipo *nix (p.e Linux)::
<WEBLOGIC_HOME>/user_projects/domains/[CLUSTER_DOMAIN]/bin/startWebLogic.sh
<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
319
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 o no (RUNNING,
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.
320
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.
2.
3.
4.
Instalar las libreras y drivers usados por Bizagi en Weblogic.

Configurar los siguientes mdulos en Weblogic:
Autenticacin
Acceso a datos
Libreras compartidas (JSTL, JSF)
Otros, tales como el timeout en transacciones (va JTA), y el usuario del sistema Bizagi
Estos mdulos se configuran en Weblogic utilizando su Consola de administracin, y utilizan a su vez

los archivos de Bizagi que se instalan en el primer paso.
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 para trabajar con Bizagi.
Ntese que estos pasos se deben realizar para cada nodo que haga parte de una instalacin de
Weblogic en clster.
1. Instalar las libreras y drivers usados por Bizagi en Weblogic.

En este paso, se incluyen libreras y drivers usados por Bizagi en la instancia de Weblogic (son archivos
que no vienen por defecto en una instalacin limpia de Weblogic).
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-Weblogic-dist.zip).
\ROOT\BizAgi-ear-Weblogic-dist\BizagiBPMJEE\:
321

Autenticacin (bizagi-security-provider-[version].jar, bizagi-remote-[version].jar, bizagi-securitycommon-[version].jar) de los insumos de configuracin, desde esta ruta:
Hacia la ruta de libreras de Weblogic en:
<WEBLOGIC_HOME>\wlserver_12.1\server\lib\mbeantypes\
1.2 Instalar los drivers para el acceso a datos.

La instalacin de los drivers se realiza simplemente copiando los necesarios segn el motor de Base
322
de datos (los drivers entregados en los insumos de configuracin), desde esta ruta:
<WEBLOGIC_HOME>\wlserver_12.1\server\lib\
Si su proyecto utiliza Oracle, entonces no requiere copiar el driver sino revisar que efectivamente se
encuentre all.
El Ojdbc6 usualmente est incluido por defecto en Weblogic.
Si su proyecto utiliza SQL Server, copie el driver sqljdbc-4.0.jar.
1.3 Instalar la librera para los logs.

La instalacin de dicha librera se realiza simplemente copiando el archivo log4j-[version].jar (tambin
entregada en los insumos de configuracin), desde esta ruta:
Hacia la ruta de libreras del dominio de Weblogic en:
<WEBLOGIC_HOME>\user_projects\domains\[your_domain]\lib\
323
1.4 Instalar las libreras compartidas.

La instalacin de este tipo de libreras se realiza para que Bizagi las utilice al momento de realizar un
despliegue en Weblogic (para generar el Portal de trabajo).
Esto se realiza simplemente copiando los archivos: jsf-myfaces-1.2.8.war y eclipselink-[version].jar (que
se entregan en los insumos de configuracin), desde esta ruta:
<WEBLOGIC_HOME>\wlserver_12.1\common\deployable-libraries\
Dos libreras compartidas adicionaes se utilizan para este fin, pero no necesita instalarlas dado que ya
vienen por defecto en una instalacin de Weblogic, Estas libreras son jsf-1.2.war y jstl-1.2.war:
324

para que Weblogic los considere cuando suba el servicio.
aparte.
Weblogic y que el dueo de la misma sea el mismo usuario que ejecuta Weblogic.

<BIZAGI_HOME>
<BIZAGI_HOME>
<BIZAGI_HOME>
En la siguiente imagen, <BIZAGI_HOME> se configur haciendo referencia a C:\ROOT\BizagiWeblogic
\:
325
Adicionalmente, podr crear una carpeta donde almacenar los archivos de un almacn de archivos de
JMS (un JMS File Store), de uso dedicado para Bizagi.
Podr crear esta carpeta dentro de la ruta <BIZAGI_HOME>, sin embargo lo ms importante, usual
y recomendado es que esta carpeta quede dentro del directorio de instalacin de Weblogic para
evitar inconvenientes sobre los permisos otorgados (lectura y escritura mnimo; preferiblemente el
ownership correspondiente al usuario ejecutando Weblogic).
Ntese que en esta imagen, la ruta donde se almacenarn dichos archivos ser C:\ROOT
\BizagiWeblogic\JMSFileStores\FileStore0\, la cul ser utilizada en la configuracin ms adelante
relacionada a los recursos JMS.
326
plataformas JEE.
de una librera nativa para el sistema operativo (un archivo .so para Linux o un archivo .dll para
Windows).
1. Ubicar la librera sapjco-3.x.jar en el repositorio de libreras en <WEBLOGIC_HOME>\user_projects
\domains\[your_domain]\lib\.
2. Ubicar el archivo sapjco3.so (para Linux) o el archivo sapjco3.dll (para Windows) en
<BIZAGI_HOME>/connectors/SAP/jco3.

primero asegrese de que su instancia de Weblogic no est iniciada (debe estar detenida).
Seguidamente, edite el archivo de inicio del servicio de Weblogic para asignar las variables necesarias.
En sistemas operativos de tipo *nix:
Ubique la siguiente lnea dentro del archivo en <WEBLOGIC_HOME>/user_projects/domains/
<USER_DOMAIN>/bin/startWebLogic.sh:
JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"
Adicione lo siguiente al final de la misma lnea, pero dentro de las comillas:
-DiNET_HOME=<BIZAGI_HOME>/JiNET -Duser.language=en -Duser.country=us Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC -Dbizagi-config=<BIZAGI_HOME>/
bizagi-config Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JA
XBRIContextFactory Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactory 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 <BIZAGI_HOME>, y que debe utilizar
"/" como el caracter de separacin de ruta.
327
Una vez que haya ubicado la librera de JCo en el repositorio de libreras de su servidor JEE (en
<WEBLOGIC_HOME>/user_projects/domains/[your_domain]/lib/), incluya la siguiente parte adicional
a las variables ya modificadas de JAVA_OPTIONS que se realizaron en <WEBLOGIC_HOME>/
user_projects/domains/<USER_DOMAIN>/bin/startWebLogic.sh:
-Djava.library.path=<BIZAGI_HOME>/connectors/SAP/jco3
Adicional a lo anterior, se recomienda que incremente la memoria utilizada en los parmetros de

memoria por defecto (de acuerdo a las caractersticas de hardware de su servidor), para proveer un
mejor desempeo y tiempo de despliegue en el servidor.
Para ello, haga uso de la lnea donde se especifique el comando: USER_MEM_ARGS=
Se recomienda asignar los siguientes valores (aunque igualmente a criterio de su administrador y
recomendaciones del fabricante, podr afinar estos valores):
USER_MEM_ARGS="-Xms512m -Xmx1024m -XX:PermSize=512m -XX:MaxPermSize=1024m"
Si est utilizando una Base de datos SQL Server, deber hacer una modificacin adicional a los
328
parmetros de ambiente, de manera que se incluya el driver sqljdbc-4.0.jar en el CLASSPATH de

Weblogic (usando el nombre exacto y versin de ese driver).
Para hacerlo, edite el archivo
<WEBLOGIC_HOME>/wlserver_12.1/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, y al final pero dentro
de las comillas).
Guarde los cambios y reinicie su Servidor Weblogic.
En Sistemas operativos Windows:

Ubique la siguiente lnea dentro del 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:
-DiNET_HOME=<BIZAGI_HOME>\JiNET -Duser.language=en -Duser.country=us Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC -Dbizagi-config=<BIZAGI_HOME>
\bizagi-config Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JA
XBRIContextFactory Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactory Dbizagi.cache.multicast.enabled=true Dbizagi.cache.multicast.address=224.2.2.3 Dbizagi.cache.multicast.port=7777 -Dbizagi.cache.multicast.type=UDP
"\" como el caracter de separacin de ruta.
329
siguiente parte adicional a las variables ya modificadas de JAVA_OPTIONS que se realizaron en
<WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\startWebLogic.sh:

Para ello, haga uso de la lnea donde se especifique el comando: set USER_MEM_ARGS=
set
USER_MEM_ARGS=-Xms512m
-Xmx1024m
-XX:PermSize=512m
XX:MaxPermSize=1024m
Para hacerlo, edite
el
archivo
<WEBLOGIC_HOME>\wlserver_12.1\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).
4. Configurar los mdulos de Weblogic

330
Se deben configurar algunos mdulos en Weblogic para que utilicen las libreras y drivers previamente
instalados.
La configuracin tal como se describe a continuacin, se realiza a travs de la Consola de
administracin de Weblogic.
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.
Igualmente asegrese de aplicar los cambios o liberar el bloqueo (haciendo clic en Activate
changes y al finalizar o clic en Release configuration si no desea aplicarlos).
Al final de cada uno de los pasos, se recomienda ir persistiendo cambios (de manera incremental).
Si desea hacerlo de esta manera, considere que deber nuevamente usar la opcin Lock & Edit
button de manera intermedia en cada paso.
Despus de realizar cambios, Weblogic puede indicar que se requiere de un reinicio del servicio.
4.1 Autenticacin
Acceda la Consola de administracin, y vaya a la seccin SecurityRealms y seleccione el tem del
mbito de dominio (myrealm).
Seleccione la pestaa de Proveedores Providers y luego la pestaa de Autenticacin (Authentication).

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

BizagiAuthenticator como el tipo (Type) de Proveedor de Autenticacin.
seleccione
332
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.
333
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--).
334
Finalmente, active los cambios.

4.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).
335

Primero ingrese BizAgiJava tanto para el Nombre (Name) como para el Nombre JNDI (JNDI Name).
336
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).
337

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).
338

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).
339
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.
340

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 .
341
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.
Podr seleccionar la ruta dentro de <BIZAGI_HOME> como se configur en el paso 2, sin embargo
tenga en cuenta que esta ruta deber proporcionar los permisos de acceso adecuado para su
configuracin de clster.
Haga clic en Ok.
342
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.
343
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
344
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). .
D clic sobre JMS Modules y en Nuevo (New) para registrar un mdulo JMS.
345
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.
346
Connection factories y colas (queues)

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 6 nuevos recursos: Connection Factory para la cola de
tareas asncronas, Distributed Queue para sta, Connection factory para los logs, Distributed Queue
para sta, Connection Factory para tpicos, y 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 que ser dedicado a las tareas asncronas en Bizagi, seleccione Connection
347
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).
348
Asegrese de marcar la casilla que activa el uso de XA Connection Factory Enabled y d clic en
Finalizar (Finish).
Para el segundo recurso, se crea una cola para el manejo de tareas asncronas.
Seleccione Distributed Queue como el tipo (Type).
349
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).
350
D clic en Siguiente (Next) e ingrese: EclipseLinkTopicConnectionFactory en el Nombre

(Name).
Ingrese jms/EclipseLinkTopicConnectionFactory en el Nombre JNDI (JNDI Name) y d clic
Finalizar (Finish).
351
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).
352
Para el quinto recurso que ser dedicado al log de Bizagi, seleccione Connection Factory como
el tipo (Type).
353
D clic en Siguiente (Next) e ingrese: AsyncAuditControllerFactory tanto en el Nombre (Name),

como en el Nombre JNDI (JNDI Name).
Finalizar (Finish).
Para el sexto y ltimo recurso, se crea una cola para el manejo de los logs de Bizagi.
Seleccione Distributed Queue como el tipo (Type).
D clic en Siguiente (Next) e ingrese: AsyncAuditController en el Nombre (Name).

Ingrese jms/AsyncAuditController en el Nombre JNDI (JNDI Name) y d clic en Siguiente
(Next).
Al finalizar, podr visualizar todos los nuevos recursos quedarn listados que 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
354
de colas (lo cual quiere decir que se respetara la configuracin de reintentos de la Asncrona en
Bizagi).
De manera similar, de vuelta en la lista de los recursos, d clic sobre la cola distribuida creada como
AsyncAuditController para editar sus propiedades,
Finalmente, recuerde activar los cambios.
4.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
355
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_12.1\common
\deployable-libraries\.
Marque la librera jsf-1.2.war .

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

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.

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 anterior):
357
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 anterior):
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 anterior):
358
Seguidamente, se recomienda editar el nombre de la librera de manera que no se incluya el detalle de

la versin menor.
Cambie el nombre a eclipselink-2, y de clic sobre Finalizar (Finish).
Una vez haya instalado estas 4 libreras desplegables, se listarn inmediatamente:
359
Recuerde activar los cambios.

4.5 Parmetros de transaccin (JTA) y usuario del sistema Bizagi
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.
D clic en Guardar (Save) y active los cambios.

Usuario del sistema Bizagi
Para configurar el usuario del sistema Bizagi, es necesario crearlo como usuario admon del dominio
domain.
360
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).
Ingrese la siguiente informacin para este usuario (debe ser necesariamente la informacin a
continuacin):
Name: admon.
Provider: DefaultAuthenticator
Password: bizagi$91
361
D clic en OK.
Una vez que complete estos pasos, consulte la Configuracin de el Scheduler en Weblogic.
Recuerde que en este punto su servidor est configurado para trabajar con Bizagi, y que la ruta y
archivos dentro de <BIZAGI_HOME> no deber ser eliminada o modificada (a menos de que se
lleve a cabo una actualizacin de versin de Bizagi, en cuyo caso algunas modificaciones a estos
archivos podrn aplicar).
(recomendado).
362
Introduccin
esquema de:
solucin).
Prerrequisitos
Para configurar del servicio de Scheduler de Weblogic asegrese de cumplir con los siguientes
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 <INSUMOS_DE_CONFIGURACIN>
en esta seccin.
Configuracin
<INSUMOS_DE_CONFIGURACIN>/BizagiSchedulerService/
2. Copie las libreras cliente para EJB en la ruta <INSUMOS_DE_CONFIGURACIN>/

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:
363
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
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).

En sistemas operativos tipo *nix (p.e Linux),, este archivo ser:
<INSUMOS_DE_CONFIGURACIN>/BizagiSchedulerService/bin/start-service.sh
<INSUMOS_DE_CONFIGURACIN>\BizagiSchedulerService\bin\start-service.bat
administrador.
En sistemas operativos tipo *nix (p.e Linux), este archivo ser:
<INSUMOS_DE_CONFIGURACIN>/BizagiSchedulerService/bin/shutdown-service.sh
<INSUMOS_DE_CONFIGURACIN>\BizagiSchedulerService\bin\shutdown-service.bat
364
Configuracin estndar de Weblogic
Introduccin
se configura sobre diferentes Servidores de Aplicacin JEE como WebSphere, Weblogic, o JBoss.
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.
365
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 (y JBoss es un servidor ms ligero que inicia/reinicia
ms rpido, y que no requerir de configuracin adicional/manual para su proyecto).
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).
El archivo BizAgi-ear-Weblogic-dist.zip (incluido en la descarga de Bizagi Engine JEE Weblogic) debe
Tener instalado el Servidor Weblogic en su versin 12c R1.
La versin soportada de Weblogic es la 12.1.3.
Weblogic puede descargarse directamente desde la pgina oficial de Oracle.
Tenga presente que debe tener el instalador apropiado a su sistema, y que para su instalacin debe
seguir tanto los requisitos de Weblogic (incluyendo otras prcticas que pueda emitir Oracle como
fabricante), como los lineamientos presentados en la siguiente seccin (p.e la creacin de un dominio)
y otras recomendaciones generales como por ejemplo instalar Weblogic en una ruta que no contenga
espacios en blanco.
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.
366
Ntese que Oracle Coherence no es necesario dado que mediante esta seccin se configura Weblogic
en modo standalone (no en clster).
Seleccionar el JDK pre-instalado (usando JDK 6, update 45).
Tenga presente que no se debe instalar el JDK embebido del instalador, dado que se debe tener
controlado que sea un JDK de versin soportada por Bizagi.
367
Instalar el servicio de Windows (cuando aplica para el sistema operativo utilizado).
368
Para una gua completa sobre la instalacin de Weblogic, consulte la documentacin oficial de Oracle.
Esta ruta de instalacin ser referenciada como <WEBLOGIC_HOME> a partir de este momento.
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).
369
documentacin oficial de Weblogic.
Al crear un dominio, tenga presente la definicin de la ruta y nombre de dicho dominio.
370
Configure el nombre de usuario y contrasea para el usuario administrador que podr subir el
dominio e ingresar a la consola de administracin de Weblogic.
371
En la configuracin del modo de inicio del servidor (Configure Sever Start Mode and JDK), seleccione
la opcin de produccin (Production Mode). Seleccione el JDK disponible y compatible, tal como se
configur para la instalacin del servidor.
372
En la configuracin siguiente de la instancia de Weblogic, asegrese de seleccionar la opcin del

Administration Server.
Recuerde que a travs de esta seccin, usted va a configurar una instancia de Weblogic a modo
standalone (no en clster).
Ver las opciones por defecto para la configuracin de ese servidor (AdminServer).
Modifique estos valores de acuerdo a su criterio para finalizar la configuracin de su instancia:
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.
Revise los parmetros de configuracin de su dominio antes de proceder con la creacin.
Una vez que los haya revisado, de clic en Crear.
Opciones de Weblogic
Para iniciar, detener o acceder a la Consola de administracin de Weblogic, consulte la informacin a
continuacin.
Iniciar el servidor (dominio)

373
Para iniciar Weblogic, execute the following file in a command prompt:

En Linux:
<WEBLOGIC_HOME>/user_projects/domains/<USER_DOMAIN>/bin/startWebLogic.sh
En Windows:
<WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\startWebLogic.cmd
En Windows, tambin se puede optar por usar las opciones del men (Oracle Weblogic > User
Projects > [user_domain] > Start Admin Server).
Asegrese de especifica el usuario y contrasea (tal como fue especificado cuando se cre el dominio
de Weblogic).
374
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
En Windows, tambin se puede optar por usar las opciones del men (Oracle Weblogic > User
Projects > [user_domain] > Start Admin Server).
375
Asegrese de especifica el usuario y contrasea (tal como fue especificado cuando se cre el dominio
de Weblogic).
Acceder a la Consola de administracin

Para acceder a la Consola de administracin de Weblogic, ingrese la siguiente direccin URL en un
navegador:
http://localhost:7001/console/login/LoginForm.jsp
Considere el nmero de puerto del servicio de acuerdo a las modificaciones que haya hecho al
momento de su configuracin.
Recuerde que igualmente requerida ingresar el usuario y contrasea autorizado del dominio.
376
Lo que debe hacer

Para la configuracin de Weblogic para trabajar con Bizagi, el siguiente procedimiento se lleva a cabo:
1.
2.
3.
4.
Instalar las libreras y drivers usados por Bizagi en Weblogic.

Configurar los siguientes mdulos en Weblogic:
Autenticacin
Acceso a datos
Libreras compartidas (JSTL, JSF)
Otros, tales como el timeout en transacciones (va JTA), y el usuario del sistema Bizagi
Estos mdulos se configuran en Weblogic utilizando su Consola de administracin, y utilizan a su vez

los archivos de Bizagi que se instalan en el primer paso.
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.
377
Realice los pasos de configuracin como se indican a continuacin, teniendo en cuenta que los
nombres usados son sensibles a maysculas.
1. Instalar las libreras y drivers usados por Bizagi en Weblogic.

En este paso, se incluyen libreras y drivers usados por Bizagi en la instancia de Weblogic (son archivos
que no vienen por defecto en una instalacin limpia de Weblogic).
Para ello, debe contar con el archivo de distribucin que entrega Bizagi (BizAgi-ear-Weblogic-dist.zip).
\ROOT\BizAgi-ear-Weblogic-dist\BizagiBPMJEE\:

Autenticacin (bizagi-security-provider-[version].jar, bizagi-remote-[version].jar, bizagi-securitycommon-[version].jar) de los insumos de configuracin, desde esta ruta:
<WEBLOGIC_HOME>\wlserver_12.1\server\lib\mbeantypes\
378
1.2 Instalar los drivers para el acceso a datos.

La instalacin de los drivers se realiza simplemente copiando los necesarios segn el motor de Base
de datos (los drivers entregados en los insumos de configuracin), desde esta ruta:
<WEBLOGIC_HOME>\wlserver_12.1\server\lib\
Si su proyecto utiliza Oracle, entonces no requiere copiar el driver sino revisar que efectivamente se
encuentre all.
El Ojdbc6 usualmente est incluido por defecto en Weblogic.
Si su proyecto utiliza SQL Server, copie el driver sqljdbc-4.0.jar.
379
1.3 Instalar la librera para los logs.

La instalacin de dicha librera se realiza simplemente copiando el archivo log4j-[version].jar (tambin
entregada en los insumos de configuracin), desde esta ruta:
Hacia la ruta de libreras del dominio de Weblogic en:
<WEBLOGIC_HOME>\user_projects\domains\[your_domain]\lib\
1.4 Instalar las libreras compartidas.

La instalacin de este tipo de libreras se realiza para que Bizagi las utilice al momento de realizar un
despliegue en Weblogic (para generar el Portal de trabajo).
Esto se realiza simplemente copiando los archivos: jsf-myfaces-1.2.8.war y eclipselink-[version].jar (que
se entregan en los insumos de configuracin), desde esta ruta:
380
<WEBLOGIC_HOME>\wlserver_12.1\common\deployable-libraries\
Dos libreras compartidas adicionaes se utilizan para este fin, pero no necesita instalarlas dado que ya
vienen por defecto en una instalacin de Weblogic, Estas libreras son jsf-1.2.war y jstl-1.2.war:

para que Weblogic los considere cuando suba el servicio.
381
aparte.
Weblogic y que el dueo de la misma sea el mismo usuario que ejecuta Weblogic.

<BIZAGI_HOME>
<BIZAGI_HOME>
<BIZAGI_HOME>
En la siguiente imagen, <BIZAGI_HOME> se configur haciendo referencia a C:\ROOT\BizagiWeblogic
\:
Adicionalmente, podr crear una carpeta donde almacenar los archivos de un almacn de archivos de
JMS (un JMS File Store), de uso dedicado para Bizagi.
382
Podr crear esta carpeta dentro de la ruta <BIZAGI_HOME>, sin embargo lo ms importante, usual
y recomendado es que esta carpeta quede dentro del directorio de instalacin de Weblogic para
evitar inconvenientes sobre los permisos otorgados (lectura y escritura mnimo; preferiblemente el
ownership correspondiente al usuario ejecutando Weblogic).
Ntese que en esta imagen, la ruta donde se almacenarn dichos archivos ser C:\ROOT
\BizagiWeblogic\JMSFileStores\FileStore0\, la cul ser utilizada en la configuracin ms adelante
relacionada a los recursos JMS.
plataformas JEE.
de una librera nativa para el sistema operativo (un archivo .so para Linux o un archivo .dll para
Windows).
1. Ubicar la librera sapjco-3.x.jar en el repositorio de libreras en <WEBLOGIC_HOME>\user_projects
\domains\[your_domain]\lib\.
2. Ubicar el archivo sapjco3.so (para Linux) o el archivo sapjco3.dll (para Windows) en
<BIZAGI_HOME>/connectors/SAP/jco3.
383

primero asegrese de que su instancia de Weblogic no est iniciada (debe estar detenida).
Seguidamente, edite el archivo de inicio del servicio de Weblogic para asignar las variables necesarias.
En sistemas operativos de tipo *nix:
Ubique la siguiente lnea dentro del archivo en <WEBLOGIC_HOME>/user_projects/domains/
<USER_DOMAIN>/bin/startWebLogic.sh:
JAVA_OPTIONS="${SAVE_JAVA_OPTIONS}"
Adicione lo siguiente al final de la misma lnea, pero dentro de las comillas:
-DiNET_HOME=<BIZAGI_HOME>/JiNET -Duser.language=en -Duser.country=us Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC -Dbizagi-config=<BIZAGI_HOME>/
bizagi-config Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JA
XBRIContextFactory Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactory
"/" como el caracter de separacin de ruta.
Una vez que haya ubicado la librera de JCo en el repositorio de libreras de su servidor JEE (en
<WEBLOGIC_HOME>/user_projects/domains/[your_domain]/lib/), incluya la siguiente parte adicional
a las variables ya modificadas de JAVA_OPTIONS que se realizaron en <WEBLOGIC_HOME>/
user_projects/domains/<USER_DOMAIN>/bin/startWebLogic.sh:
-Djava.library.path=<BIZAGI_HOME>/connectors/SAP/jco3
384

Para ello, haga uso de la lnea donde se especifique el comando: USER_MEM_ARGS=
USER_MEM_ARGS="-Xms512m -Xmx1024m -XX:PermSize=512m -XX:MaxPermSize=1024m"
Para hacerlo, edite el archivo
<WEBLOGIC_HOME>/wlserver_12.1/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, y al final pero dentro
de las comillas).
En Sistemas operativos Windows:

Ubique la siguiente lnea dentro del 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:
-DiNET_HOME=<BIZAGI_HOME>\JiNET -Duser.language=en -Duser.country=us Dfile.encoding=UTF-8 -DAPP_SERV=WEBLOGIC -Dbizagi-config=<BIZAGI_HOME>
\bizagi-config Dcom.sun.xml.ws.spi.db.BindingContextFactory=com.sun.xml.ws.db.glassfish.JA
XBRIContextFactory Djavax.xml.bind.JAXBContext=com.sun.xml.bind.v2.ContextFactory
385
"\" como el caracter de separacin de ruta.
siguiente parte adicional a las variables ya modificadas de JAVA_OPTIONS que se realizaron en
<WEBLOGIC_HOME>\user_projects\domains\<USER_DOMAIN>\bin\startWebLogic.sh:

Para ello, haga uso de la lnea donde se especifique el comando: set USER_MEM_ARGS=
set
USER_MEM_ARGS=-Xms512m
-Xmx1024m
-XX:PermSize=512m
XX:MaxPermSize=1024m
386
Para hacerlo, edite

el
archivo
<WEBLOGIC_HOME>\wlserver_12.1\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).
4. Configurar los mdulos de Weblogic

Se deben configurar algunos mdulos en Weblogic para que utilicen las libreras y drivers previamente
instalados.
La configuracin tal como se describe a continuacin, se realiza a travs de la Consola de
administracin de Weblogic.
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.
Igualmente asegrese de aplicar los cambios o liberar el bloqueo (haciendo clic en Activate
changes y al finalizar o clic en Release configuration si no desea aplicarlos).
Al final de cada uno de los pasos, se recomienda ir persistiendo cambios (de manera incremental).
Si desea hacerlo de esta manera, considere que deber nuevamente usar la opcin Lock & Edit
button de manera intermedia en cada paso.
Despus de realizar cambios, Weblogic puede indicar que se requiere de un reinicio del servicio.
4.1 Autenticacin
Acceda la Consola de administracin, y vaya a la seccin SecurityRealms y seleccione el item del
387
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
388
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.
389
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-).
390
Finalmente, active los cambios.

4.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).
391

Primero ingrese BizAgiJava tanto para el Nombre (Name) como para el Nombre JNDI (JNDI Name).
392
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).
393

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).
394

En las opciones de transaccin (Transaction Options), asegrese de marcar la casilla de Supports
Global Transactions y 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).
395
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).
396
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 su instancia de servidor AdminServer (como el destino --Target--), y especifique el
directorio que se configur en el paso 2, en <BIZAGI_HOME> donde estn los archivos que utilizar
Bizagi en runtime.
Haga clic en Ok.
397
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.
398
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.
399
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).
400
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 y crear los recursos asociados.
Se deben crear 4 nuevos recursos: 2 Connection factories (una para el manejo de tareas asncronas en
Bizagi, y otra para el log de auditora), y as mismo 2 colas (queues), una para cada fin.
Para ello, de clic sobre el mdulo recin creado (SystemModule-Bizagi).
401
Connection factories.
Para crear y asociar el primer recurso, de tipo connection factory, desde la tabla de resumen de
recursos (Summary of Resources) d clic sobre Nuevo (New)
Para el primer recurso dedicado a las tareas asncronas, 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).
402
Finalizar (Finish).
Para el segundo recurso, de tipo connection factory dedicado a los logs, desde la tabla de resumen
de recursos (Summary of Resources) d clic sobre Nuevo (New)
Seleccione nuevamente Connection Factory como el tipo (Type).
403
D clic en Siguiente (Next) e ingrese AsyncAuditControllerFactory tanto en el Nombre (Name),

como en el Nombre JNDI (JNDI Name).
Finalizar (Finish).
Colas (Queues)
De vuelta en la tabla de resumen de recursos (Summary of Resources) d clic sobre Nuevo (New), esta
vez para crear y asociar el primer recurso, de tipo cola dedicado a las tareas asncronas.
Para la primera cola, seleccione Queue como el tipo (Type).
404
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.
405
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 para editar sus propiedades,
406
Bizagi).
Para la segunda cola, de vuelta en la tabla de resumen de recursos (Summary of Resources) d clic
sobre Nuevo (New).
Seleccione Queue como el tipo (Type) para crear una cola dedicada al log.
D clic en Siguiente (Next) e ingrese: AsyncAuditController en el Nombre (Name).

407
Ingrese jms/AsyncAuditController 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 AsyncAuditController en el Nombre (Name) y
d clic en OK.
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 AsyncAuditController para editar sus
propiedades,
Bizagi).
Al final podr visualizar los 4 recursos que hemos creado (2 connection factories, 2 colas).
4.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
408
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_12.1\common
\deployable-libraries\.
Marque la librera jsf-1.2.war.

409
Seleccione la opcin de Instalarla como una librera (Install this deployment as library).
D clic en Siguiente (Next y luego en Finalizar (Finish).
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):
410
Para la cuarta, esta vez marque la librera eclipselink-2.5.0.jar (ubicada en la misma ruta).
Seguidamente, se recomienda editar el nombre de la librera de manera que no se incluya el detalle de

la versin menor.
Cambie el nombre a eclipselink-2, y de clic sobre Finalizar (Finish).
411
Una vez haya instalado estas 4 libreras desplegables, se listarn:
4.5 Parmetros de transaccin (JTA) y usuario del sistema Bizagi

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.
412
D clic en Guardar (Save) y active los cambios.

Usuario del sistema Bizagi
Para configurar el usuario del sistema Bizagi, es necesario crearlo como 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).
413
Ingrese la siguiente informacin para este usuario (debe ser necesariamente la informacin a
continuacin):
Name: admon.
Provider: DefaultAuthenticator
Password: bizagi$91
414
D clic en OK.
Siguientes pasos
Despus de estos pasos, su instalacin de Weblogic est configurada para albergar Procesos Bizagi!
Puede ahora iniciar su servidor y generar el Portal de Trabajo (como un despliegue de aplicacin en
Weblogic).
Recuerde que en este punto su servidor de WebSphere est configurado para trabajar con Bizagi, y
que la ruta y archivos dentro de <BIZAGI_HOME> no deber ser eliminada o modificada (a menos
de que se lleve a cabo una actualizacin de versin de Bizagi, en cuyo caso algunas modificaciones a
estos archivos podrn aplicar).
415
(recomendado).
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).
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.
416
Si desea configurar JBoss a modo standalone (solamente empleando un servidor BPM; sin esquema de
balanceo de cargas), consulte la Configuracin estndar de JBoss.
Lo que debe hacerse

1. Configurar JBoss en clster para trabajar en Bizagi.

Estos pasos se describen en la Configuracin en clster de JBoss.
417

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).
El archivo BizAgi-ear-JBoss-dist.zip (incluido en la descarga de Bizagi Engine JEE JBoss) debe
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 y de su descarga).
Usted podr tambin utilizar la instalacin de JBoss que se incluye en el Plug-in para JEE en su
ambiente de desarrollo.
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.
Se requiere que esta ruta no contenga espacios en blanco.
418
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, 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.
En este paso se considera la configuracin de los mdulos y conexiones.
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
vienen por defecto en la instalacin limpia).
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 <INSUMOS_DE_CONFIGURACIN> a partir de este momento.
Esto crear una carpeta llamada BizagiBPMJEE, que provee la siguientes estructura y archivos:
419
Ntese que en nuestro caso <INSUMOS_DE_CONFIGURACIN> 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:
<INSUMOS_DE_CONFIGURACIN>\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:
420
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:
421
<INSUMOS_DE_CONFIGURACIN>\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
422
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).
423
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:
424
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 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>
425
<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 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"/>
426
</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"/>
427
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>
428
<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="batch-delay" value="50"/>
<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>
429
<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>
<connector-ref connector-name="in-vm"/>
</connectors>
<entries>
<entry name="java:/JmsXA"/>
</entries>
</pooled-connection-factory>
</jms-connection-factories>
<jms-destinations>
430
<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">
431
<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"/>
432
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>
433
Una vez realizado estos cambios, reinicie su servicio de JBoss.
3. Creacin de usuarios de administracin y de aplicacin.

Para la configuracin de Bizagi en JBoss, 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!
434
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.
435
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>:
436
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 las variables de entorno necesarias:
NET_HOME
Deber tener la ruta del home JiNET (por

ejemplo <BIZAGI_JEE_HOME>/
BizagiBPMJEE/JiNET).
DAPP_SERV
Deber tener como valor: JBOSS.
Djava.net.preferIPv4Stack
Deber estar asignada como true
Duser.language
Deber especificar el lenguaje por defecto (p.e,

en)
Duser.country
Deber especifica la cultura por defecto para ese
437
lenguaje (p.e, us).

Dfile.encoding
Deber configurarse como UTF-8
Dbizagi-config
Deber tener la ruta de la carpeta bizagi-config ,

donde se encuentra ubicado el archivo
bizagi.extended.properties de propiedades.
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.
plataformas JEE.
como Linux o un archivo .dll para sistemas operativos Windows).
438

1. Ubicar la librera sapjco-3.x.jar en el repositorio de libreras en <JBOSS_HOME>\modules\system
\layers\base\com\sap\jco\main\.
(para sistemas operativos Windows) en <INSUMOS_DE_CONFIGURACIN>/connectors/SAP/.
3. Incluya una modificacin adicional al archivo host.xml, para incluir una ocurrencia ms de <jvmoption> que considere la variable de entorno Djava.library.path.
Para hacerlo, incluya la siguiente linea, (reemplazando el valor correspondiente de
<INSUMOS_DE_CONFIGURACIN>):
<option value="-Djava.library.path=<BIZAGI_JEE_HOME>\connectors\SAP
\jco3"/>
4. Edite el archivo module.xml ubicado en <JBOSS_HOME>\modules\system\layers\base\com\sap\jco

\main\ para que dentro del elemento <resources> se tenga lo siguiente: <resource-root
path="sapjco3.x.jar"/>:
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>:
439
Solamente se debe conservar el nombre master para el nodo maestro:
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 sistemas operativos tipo *nix (p.e Linux):

<JBOSS_HOME>/bin/domain.sh -b [IP_Nodo_Maestro] Djboss.bind.address.management=[IP_Nodo_Maestro]
<JBOSS_HOME>\bin\domain.bat -b [IP_Nodo_Maestro] Djboss.bind.address.management=[IP_Nodo_Maestro]
En cada uno de los nodos esclavos (slave), utilice el siguiente comando.

<JBOSS_HOME>/bin/domain.sh -b [IP_Nodo_Actual] Djboss.domain.master.address==[IP_Nodo_Maestro] --host-config=hostslave.xml
<JBOSS_HOME>\bin\domain.bat -b [IP_Nodo_Actual] Djboss.domain.master.address==[IP_Nodo_Maestro] --host-config=hostslave.xml
440
Qu sigue?
Despus de estos pasos, su instalacin de JBoss 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 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
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 <INSUMOS_DE_CONFIGURACION> en
esta seccin.
Configuracin
<INSUMOS_DE_CONFIGURACION>/BizagiSchedulerService/
441
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:
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,
442
configuracin de variables de entorno para configurar JBoss para trabajar en clster).

En Sistemas operativos tipo *nix como Linux, este archivo ser:
<INSUMOS_DE_CONFIGURACION>/BizagiSchedulerService/bin/start-service.sh
En Windows, este archivo ser:
<INSUMOS_DE_CONFIGURACION>\BizagiSchedulerService\bin\start-service.bat
administrador.
En Sistemas operativos tipo *nix como Linux, este archivo ser:
<INSUMOS_DE_CONFIGURACION>/BizagiSchedulerService/bin/shutdown-service.sh
En Windows, este archivo ser:
<INSUMOS_DE_CONFIGURACION>\BizagiSchedulerService\bin\shutdown-service.bat
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).
443
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 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).
444
Los archivos de configuracin y de despliegue entregados por Bizagi (BizAgi-ear-JBoss-dist.zip).

El archivo BizAgi-ear-JBoss-dist.zip (incluido en la descarga de Bizagi Engine JEE JBoss) debe
JBoss instalado.
La versin soportada de JBoss es EAP 6.2.
Mayor informacin en la pgina oficial de JBoss (p.e de requerimientos de sistema y de su descarga).
Usted podr tambin utilizar la instalacin de JBoss que se incluye en el Plug-in para JEE en su
ambiente de desarrollo.
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 sistemas operativos tipo *nix (p.e Linux), ejecute standalone.sh en una consola de comandos con
los siguientes parmetros:
standalone.sh -b 0.0.0.0
En sistemas operativos Windows, ejecute standalone.bat en una consola de comandos con los
siguientes parmetros:
standalone.bat -b 0.0.0.0
445
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.
446
Detener el servidor
Para detener el Servidor de Aplicaciones JBoss, ubique la carpeta <JBOSS_HOME>/bin y ejecutar el
archivo jboss-cli:

Ejecute jboss-cli.sh en una consola de comando con los siguientes parmetros:
jboss-cli.sh --connect command=:shutdown
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.
2.
3.
4.
Extraer los archivos usados por Bizagi hacia JBoss.

Instale el archivo orig.
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
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:
447
En nuestro caso <BIZAGI_JEE_HOME> referencia la ruta C:\BizagiJEE\. El archivo zip descomprimido

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

contenido dentro de la carpeta BizagiBPMJEE/
configuration dentro de la carpeta <BIZAGI_JEE_HOME>.
Seleccione Extraer Todos y escoja la carpeta <JBOSS_HOME>/modules/system/layers/base/

como el destino donde se extraern los archivos.
449
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:
450
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:
451
2. Instale el archivo orig.

El archivo org es entregado por Bizagi para configurar los siguientes mdulos en el servidor JBoss.
Autenticacin.
Acceso de datos y los drivers correspondientes.
Fuente de datos de su proyecto.
Servicio de mensajera (JMS),
Configuracin de JTA.
Compresin de HTTP
Conexin a SAP (cuando se requiera).
Copie el archivo standalone-bizagi.orig entregado por Bizagi en los archivos de configuracin y
despliegue la carpeta <JBOSS_HOME>/standalone/configuration.

452
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 la definicin de variables
de entorno por ejemplo para incluir JiNet para el inicio de servicio de JBoss y para ajustar la
asignacin de memoria usada por JBoss para su servicio.
Esto se hace editando el archivo de configuracin del ejecutable.
En sistemas operativos tipo *nix (p.e Linux), este archivo se encuentra en

<JBOSS_HOME>/bin/standalone.conf.
En sistemas operativos 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.
Edite el archivo <JBOSS_HOME>/bin/standalone.conf para iniciar JBoss, incluyendo las siguientes
variables de entorno:
DiNET_HOME: Deber tener la ruta del home JiNET (por ejemplo <BIZAGI_JEE_HOME>/
DAPP_SERV: Deber tener como valor: JBOSS .
Djava.net.preferIPv4Stack: Deber estar asignada como true
Dbizagi.scheduler.external.enabled: Deber estar asignada como false para un servicio de JBoss
standalone.
453
Duser.language: Debrer especificar el lenguaje por defecto (p.e, en)

Duser.country: Deber especifica la cultura por defecto para ese lenguaje (p.e, us).
Dfile.encoding: Deber configurarse como UTF-8
Dbizagi-config: Deber tener la ruta de la carpeta bizagi-config , donde se encuentra ubicado el
archivo bizagi.extended.properties de propiedades.
Puede hacerlo, incluyendo la siguiente lnea en la parte despus de la lnea que contiene "Reduce the
RMI GCs...":
# Bizagi Configuration
JAVA_OPTS="$JAVA_OPTS
-Djava.net.preferIPv4Stack=true
DiNET_HOME=<BIZAGI_JEE_HOME>/BizagiBPMJEE/JiNET
DAPP_SERV=JBOSS
Duser.language=en
-Duser.country=us
-Dfile.encoding=UTF-8
-Dbizagiconfig=<BIZAGI_JEE_HOME>/BizagiBPMJEE/bizagi-config"
JAVA_OPTS="$JAVA_OPTS -Xms1024m -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:
454
En sistemas operativos 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 1GB.
set "JAVA_OPTS=-Xms1024M -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 las siguientes variables de entorno:
DiNET_HOME: Deber tener la ruta del home JiNET (por ejemplo <BIZAGI_JEE_HOME>/
DAPP_SERV: Deber tener como valor: JBOSS .
Djava.net.preferIPv4Stack: Deber estar asignada como true
Dbizagi.scheduler.external.enabled: Deber estar asignada como false para un servicio de JBoss
standalone.
Duser.language: Debrer especificar el lenguaje por defecto (p.e, en)
Duser.country: Deber especifica la cultura por defecto para ese lenguaje (p.e, us).
Dfile.encoding: Deber configurarse como UTF-8
Dbizagi-config: Deber tener la ruta de la carpeta bizagi-config , donde se encuentra ubicado el
archivo bizagi.extended.properties de propiedades.
455
Puede hacerlo, incluyendo la siguiente lnea en la parte despus de la lnea que contiene "Reduce the
RMI GCs...":
-Djava.net.preferIPv4Stack=true -DiNET_HOME=<BIZAGI_JEE_HOME>/BizagiBPMJEE/
JiNET DAPP_SERV=JBOSS -Duser.language=en -Duser.country=us Dfile.encoding=UTF-8 -Dbizagi-config=<BIZAGI_JEE_HOME>/BizagiBPMJEE/bizagiconfig
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 finalizar, el archivo <JBOSS_HOME>/bin/standalone.conf.bat deber verse as:
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.
4.1 Localice la carpeta <JBOSS_HOME>/bin y ejecute el archivo add-user.
En sistemas operativos tipo *nix (p.e Linux), ejecute en el smbolo del sistema:
add-user.sh
En sistemas operativos Windows, ejecute 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'.
456
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.
457
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 y tenga en cuenta la configuracin de clsters para la alta disponibilidad.
458
Elementos fundamentales
Los siguientes son los elementos principales a configurar en la arquitectura del sistema de su solucin
Bizagi sobre una plataforma JEE.
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).
459
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.
Otros elementos
Tenga en cuenta estos elementos adicionales:
Proxy opcional para el acceso desde internet
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.
Bases de datos externas integradas a la solucin
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.
Otros
Si su proyecto integra otros servicios web, u otros sistemas para la autenticacin (por ejemplo un
LDAP. o un proveedor de identidad para una autenticacin federada), deber asegurarse de que
460
encuentren accesibles para Bizagi con una configuracin compatible.

Deber tambin cerciorarse de definir en Bizagi la conexin a su servidor SMTP corporativo para el
envo de notificaciones.
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).
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 JBoss (ejemplo).
461
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
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>.
462
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
LoadModule deflate_module modules/mod_deflate.so
Incluya la siguiente configuracin del mdulo deflate para utilizar la compresin HTTP y las
optimizaciones en trfico y desempeo de su aplicacin (especialmente para dispositivos mviles):
# Method 1: Only compress specified content type
<Location />
<IfModule mod_deflate.c>
# compress content with type html, text, and css
AddOutputFilterByType DEFLATE text/html text/plain text/css text/javascript
text/json application/javascript text/xml
<IfModule mod_headers.c>
# properly handle requests coming from behind proxies
Header append Vary User-Agent
463
</IfModule>
</IfModule>
</Location>
# deflate.log, log compression ratio on each request
#<IfModule mod_deflate.c>
# DeflateFilterNote Input instream
# DeflateFilterNote Output outstream
# DeflateFilterNote Ratio ratio
# LogFormat '"%r" %{outstream}n/%{instream}n (%{ratio}n%%)' deflate
# CustomLog logs/deflate.log deflate
#</IfModule>
# Properly handle old browsers that do not support compression
<IfModule mod_deflate.c>
BrowserMatch ^Mozilla/4 gzip-only-text/html
BrowserMatch ^Mozilla/4\.0[678] no-gzip
BrowserMatch \bMSIE !no-gzip !gzip-only-text/html
</IfModule>
Adicione las siguientes lneas dentro de la definicin del VirtualHost, de la siguiente manera:
<VirtualHost *:80>
ProxyRequests OFF
ServerName [Servidor_Balanceador]:[Puerto_Balanceador]
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
</VirtualHost>
Considere:
[Servidor_Balanceador]: Nombre del servidor (o IP) que ejerce el balanceo (en este ejemplo
ser el servidor local que tiene instalado Apache).
[Puerto_Balanceador]: Nmero de puerto sobre el cual atiende el servicio balanceador.
[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.
464
[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
</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:
465
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
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.
Ingrese la siguiente informacin:

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

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.
467
Balanceo de cargas con Weblogic
de Bizagi.
Este ejemplo aplica para la edicin Enterprise JEE donde se utiliza configuracin de Weblogic 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 Weblogic como se
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>.
468
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 [Servidor_Balanceador]:[Puerto_Balanceador]
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:
[Servidor_Balanceador]: El nombre del servidor local el cul ejerce el balanceo de cargas.
[Puerto_Balanceador]: 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.
469
[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.
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
470
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.
La versin para JBoss se disponibiliza ac tambin: http://mod-cluster.jboss.org/.
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
Apache HTTP Server.
Con esto tendr el servidor instalado con los mdulos necesarios para JBoss.
<APACHE_HOME>.
471
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_Balanceador]
ManagerBalancerName mycluster
<VirtualHost [Nodo_Maestro]:[Puerto_Nodo_Maestro]>
<Location />
Order deny,allow
Deny from all
Allow from 127.0.0.1
Allow from [Nodo1]:[Puerto1]
</Location>
472
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_Balanceador]: El nmero de puerto bajo el cual el balanceador atiende las peticiones.
Ntese que para cada nodo adicional del clster de JBoss, usted podr incluir ocurrencias adicionales
de:
Allow from [NodoN]:[PuertoN]
(sticky sessions).
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">
473
<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
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.
474
Para revisar estas propiedades, podr utilizar Bizagi Management Console.

Desde el Management Console, 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, asegrese de ver la configuracin de la pestaa de

acuerdo al ambiente correcto.
Tenga presente que deber tener a la mano el nombre del proveedor configurado tambin.
475
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
Configuracin de Replicacin y 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
476
fuente de datos. Esto se puede realizar: Configurando un archivo externo donde se establezcan todas
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.
477
customProperties: Esta etiqueta tendr la informacin para crear las conexiones. Esta etiqueta
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:
478
El driver debe ser:

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:
479
480
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:
481
[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.
482
Configuracin de Autenticacin Federada
Resumen
Bizagi soporta la integracin con un proveedor de Identidad con servicios federados.
De esta manera, Bizagi puede contar con capacidades Single Sing-On y encargar la autenticacin a su
proveedor de Identidad corporativo (e.g. Ping Federate).
Prerrequisitos
Antes de continuar, asegrese de que:
1. Haya configurado el proveedor de Identidad que soporte el estndar SAML 2.0 (e.g Ping Federate).
Las versiones certificadas y recomendadas para usar la Autenticacin Federada en Bizagi son:
Ping Federate versin 7.1.4.7.
ADFS versin 2.1.
2. Tanto para el proveedor de Identidad como para el Portal de Trabajo de Bizagi, se haga la
configuracin usando el protocolo HTTPS.
Necesitar contar con los correspondientes certificado SSL de servidor vlidos (vigentes a la fecha, y
emitidos por una autoridad de certificacin CA).
Cuando use Ping Federate, puede establecer y revisar todos los certificados importados a travs del
panel de administracin (localizado por defecto en https://[server]:[port]/pingfederate/app), incluyendo
aquellos desde su proveedor de servicios (e.g Bizagi) y aquellos que use para HTTPS o aserciones de
fin de sesin.
Asegrese de que sus certificados son importados y visibles en Trusted CAs, SSL Server Certificates,
483
Digital Signing & XML y Decryption Keys & Certificates.
3. Ya que usted ya ha realizado esta configuracin en el ambiente de desarrollo y pruebas,

asumiremos que ya: ha obtenido la metadata desde su proveedor de identidades y ha configurado los
parmetros de autenticacin en Bizagi (que a su vez, referencia la metadata obtenida desde su
proveedor de identidades).
Para cualquier tipo de autenticacin, necesita asegurarse que los usuarios estn creados en el Portal
de Trabajo de Bizagi.
Independiente del tipo de Autenticacin para el inicio de sesin del portal de Trabajo, usted puede
escoger crear los usuarios de forma manual o configurar una tarea programa en Bizagi para
importar y sincronizar los usuarios de su servidor LDAP.
Antes de comenzar
Recuerde que a travs de la autenticacin federada, usted delegar en su proveedor de identidad, la
validacin y autenticacin de los usuarios que ingresan a Bizagi.
Por lo tanto, es fundamental que sus usuarios se encuentren sincronizados correctamente tanto en la
base de datos de Bizagi (a manera de registros en la WFUser, como en su repositorio de usuarios del
proveedor de identidad).
Para el uso de SAML 2.0 y la autenticacin federada, tenga en cuenta que al iniciarse una sesin, Ping
Federate crea una asercin que contiene el identificador del usuario en el campo NameID del
elemento SAML_SUBJECT.
Este identificador NameID debe incluir el dominio del usuario, de cualquiera de estas formas:
username@domain, domain\username.
Considere entonces que la sincronizacin de sus usuarios en la tabla WFUser contenga la informacin
del dominio de usuario, donde se recomienda el siguiente mapeo:
484
USERNAME
DOMAIN
CONSIDERACIN
username
domain
NameID podr enviarse en la

asercin como
username@domain
o tambin como domain
\username
En caso de que no se pueda garantizar este mapeo, podr usar cualquiera de los siguientes
USERNAME
DOMAIN
CONSIDERACIN
username@domain
domain
NameID deber enviarse en la

asercin como
username@domain
domain\username
domain
NameID deber enviarse en la

asercin como domain
\username
Qu necesita hacer?
Para configurar la autenticacin federada para su proyecto de Bizagi, se requieren 4 grandes pasos:
1. Exporte la metadata de su proveedor de identidad en un archivo XML.
Se necesita exportar la metadata que define el servicio de su proveedor de identidades para
configurar Bizagi.
2. Configure los parmetros de Autenticacin en Bizagi y exporte esta metadata.
Usted necesitar referenciar la metadata previamente exportada y configurar en Bizagi los parmetros
de autenticacin adicionales.
Una vez haya configurado Bizagi, necesitar exportar esta metadata para configurar el SAML especfico
en su proveedor de identidades.
3. Configure una conexin confiable en su proveedor de identidades.
Necesitar configurar Bizagi en su proveedor de identidades definiendo elementos como la conexin,
un perfil del Navegador SSO, la configuracin de firma y verificacin, etc.
Pasos
Para configurar la autenticacin federada, siga los pasos presentados a continuacin.
1. Exporte la metadata de su proveedor de identidad en un archivo XML.

Exporte la metadata de su proveedor de identidad siguiendo los pasos a continuacin:
1.1. Use el panel de Administracin y localice la opcin Exportar Metadata.
Asegrese de iniciar sesin en el panel de Administracin y localice la opcin Exportar Metadata
(Metadata Export) bajo la seccin Funciones Administrativas (Administrative functions).
485
D clic en dicha opcin para lanzar un asistente de configuracin.

1.2. Seleccione el rol de la metadata
Asegrese de haber seleccionado que su Ping Federate es el Proveedor de Identidades.
1.3. Seleccione el modo metadata

En este punto, no hay conexiones disponibles para la generacin de la metadata, por lo que puede
omitir esa opcin y usar seleccionar la informacin a incluir en la metadata manualmente (select
information to include metadata manually).
486
1.4. Seleccione el protocolo.

Asegrese de seleccionar SAML 2.0 como el protocolo escogido.
Para la siguiente configuracin del atributo de contrato, puede dejarlo en blanco y pasar directamente
al siguiente paso.
1.5. Seleccione la clave de firma
Para la clave de firma, asegrese de seleccionar el certificado apropiado tal y como se configur en
HTTPS.
487
1.6. Seleccione la metadata de firma.

De igual manera, seleccione acordemente el certificado de firma para la metadata de firma.
Se recomienda marcar Include this certificate's public key certificate in the <KeyInfo> element, para
verificar la informacin en cualquier punto.
Asegrese de especificar el uso del algoritmo RSA SHA-1.
1.7. Seleccione el XML del certificado de cifrado.
Finalmente, seleccione el certificado de cifrado seleccionando su certificado tal y como fue configurado
en HTTPS.
488
1.8. Guarde el archivo de metadata en una ruta dentro de su servidor BPM.

Asegrese de guardar el archivo metadata.xml en una ruta que se accesible por su servidor BPM (e.g
una ruta local para que Bizagi acceda en tiempo de ejecucin).
Necesitar configurar esta ruta en la configuracin de Bizagi:
2. Configure los parmetros de Autenticacin en Bizagi y exporte esta

metadata.
Configure Bizagi llevando a cabo lo siguiente:
2.1. Configure la autenticacin Federada.
Para hacer esto en Bizagi Studio, vaya a la vista de Mdulos y localice el mdulo de Seguridad (usando
Bizagi Management Console).
D clic en la opcin Autenticacin, localizada bajo el tem de Seguridad y seleccione Autenticacin
Federada en la lista desplegable del panel de la derecha:
489
Usted ver que esta autenticacin se basa en el protocolo SAML 2.0.

D clic en Actualizar.
Recibir un mensaje de confirmacin y podr ver que aparecen parmetros adicionales bajo el tem
de Autenticacin.
2.2. Configure los parmetros adicionales.
Proceda a configurar estos parmetros adicionales como se describe a continuacin, asegrese de dar
clic en Actualizar para cada uno de los que modifique.
Observe que los valores de los parmetros distinguen entre maysculas y minsculas y por lo tanto,
necesita asegurarse de ingresarlos correctamente.
PARMETRO DE
DESCRIPCIN
ES REQUERIDO UTILIZARLO?
490
AUTENTICACIN
FEDERADA
Enable passive
authentication
Habilite o deshabilite este

parmetro para permitir el uso del
protocolo SAML de autenticacin
pasiva.
No.
Se recomienda que se configure
como deshabilitado, de lo
contrario, se implementar el
redireccionamiento activo.
Force use of Authn
Habilite o deshabilite este

parmetro para forzar el uso de
login para esta aplicacin, sin tener
en cuenta cualquier contexto
confiable de logins anteriores.
Este parmetro solo es til como
una poltica estricta que no
considere sesiones activas por
otras aplicaciones.
No.
Se recomienda que se configure
como deshabilitado, de lo
contrario, Bizagi siempre
necesitar que los usuarios
hagan login an si ya lo hayan
realizado desde otra aplicacin.
Metadata file path
Especifica la ruta local al archivo

xml de metadata de su proveedor
de identidades.
Ejemplo:
E:\BizagiJEE\SSO
\MyIDPMetadata.xml
S.
Key Store password
Especifica la contrasea para

acceder al repositorio de llaves
como se incia en el parmetro Key
store path.
S.
Key Store path
Especifica la ruta local donde se

encuentra el archivo repositorio de
llaves de su certificado.
Ejemplo
E:\BizagiJEE\SSO\Certificate
\MyKeystore
S.
Organization name
Especifica el nombre de su
organizacin como se presenta en
su certificado.
S.
Organization URL
Especifica la URL de su
organizacin como se presenta en
su certificado.
S.
Passive authentication
username
Aplica solo cuando se ha habilitado

la autenticacin pasiva.
Especifica el nombre de usuario
usado por la autenticacin pasiva.
No.
Selected signing algorithm
Especifica el algoritmo usado por
S.
491
las aserciones.
Especifique el uso de RSA SHA-1.
Technical contact email
Especifica la direccin de correo

electrnico de su contacto tcnico.
S.
2.3. Generar la configuracin SAML resultante de Bizagi.

Una vez se haya configurado los parmetros en Bizagi, usted necesita exportar esta configuracin en
un archivo XML para ser despus importado a su proveedor de identidades.
Para exportar los parmetros de configuracin de SAML, use el administrador de JEE Console que
viene incluido cuando instala su plugin de JEE.
Por defecto, el administrador de la JEE Console se encuentra en BizagiConsoleManagerJEE C:
\BizagiJEE\[Bizagi_version]\BizagiConsoleManagerJEE (de acuerdo a su versin de Bizagi).
Cuando use JEE Console, use el siguiente comando para exportar el archivo de configuracin de SAML.
JEEConsoleManager.bat samlconfig -g
entityId [URL_de_su_Proyecto_Bizagi]
-p
[Nombre_de_su_Proyecto_Bizagi]
Considere:
[Nombre_de_su_Proyecto_Bizagi]: Debe especificar el nombre de su proyecto de Bizagi (Portal de
trabajo).
[URL_de_su_Proyecto_Bizagi]: Debe especificar la URL del portal de trabajo de Bizagi. Por ejemplo.
https://MiServidor.MiDominio.loc:8080/BizAgi-war/
En caso de necesitar borrar archivos de configuracin previos, puede usar el parmetro -d para
borras (en vez de -g para generar).
Por ejemplo:
JEEConsoleManager.bat samlconfig -d -p [Nombre_de_su_Proyecto_Bizagi] entityId [URL_de_su_Proyecto_Bizagi]
Una vez ejecutado, el smbolo del sistema mostrar un mensaje de xito:
Observe que el mensaje notifica la ruta donde se generaron estos archivos (en C:/BizagiJEE/
[Bizagi_version]/BizagiBPMJEE/bizagi-config/saml-config/):
492
Los archivos generados incluyen:

Carpeta Certificate: Contiene el repositorio de llaves con la clave para apagar las aserciones.
Carpeta metadata: Contiene 2 sub-carpetas: IdP y SP.
IdP contiene el archivo xml con la metadata del proveedor de identidades.
SP contiene el archivo xml con la metadata de Bizagi (el proveedor de servicios). Este archivo se llama
SPMetadata.xml y es en el que estamos interesados para importarlo en Ping Federate.
Carpeta SingleLogOut: Contiene al archivo wsdl del servicio SOAP involucrado en el mecanismo de
cierre de sesin.
Archivo saml-sp.log4j.xml: Es el log del archivo de configuracin.
Archivo saml-sp.propertiese: Es el archivo de propiedades para el protocolo SAML.
En caso que desee listar la ubicacin de estos archivos, puede usar el parmetro -l. Por ejemplo:
JEEConsoleManager.bat samlconfig -l -p [Nombre_de_su_Proyecto_Bizagi]
entityId [URL_de_su_Proyecto_Bizagi]
3. Configure una conexin confiable en su proveedor de identidades.

Para completar la configuracin a una conexin confiable establecida en el proveedor de identidades,
se usa este archivo XML de metadata de Bizagi necesitar crear estos elementos de la definicin de
SAML:
Una conexin al proveedor de servicios (service provider connection).
La conexin al proveedor de servicios define un Perfil de navegador que usa una definicin de
credenciales.
Un Perfil de navegador que soporte SSO (browser profile supporting SSO).
Para soportar SAML de Bizagi, se necesita un perfil de navegador SSO que cumpla con SAML 2.0.
El perfil de navegador usa: una definicin de asercin y una definicin de protocolos.
Una definicin de asercin (assertion definition).
La asercin especifica un adaptador para conectarse con el repositorio de usuarios (e.g LDAP, una
base de datos, etc).
Una definicin de protocolos (protocol definition).
493
El protocolo especifica los bindings y la configuracin relevante de las capacidades de firma.

Una definicin de credenciales (credentials definition).
Las credenciales especifican el uso de autenticacin de back-channel (back-channel authentication),
firma digital (digital signature) y verificacin de firma (signature verification).
Una definicin de autenticacin back-channel (back-channel authentication definition).
Una definicin de firma digital (digital signature definition).
La definicin de firma digital especifica cmo autenticarse sin aserciones.
Una definicin de verificacin de firma (signature verification definition).
La definicin de la verificacin de firma especificar cmo se verifican las aserciones (como las maneja
Bizagi).
El siguiente diagrama muestra un esquema de los elementos y la estructura que crearemos (SAMLcompliant):
Para hacer esto, a travs de la configuracin asistida en Ping Federate, llevamos a cabos los siguientes
pasos:
3.1. Utilice el panel administracin para crear una nueva conexin SP.
Asegrese de iniciar sesin en el panel de administracin de su Ping Federate (por defecto, se
encuentra en https://[server]:[port]/pingfederate/app) y d clic en la opcin Crear Nueva (Create New)
directamente bajo la seccin Conexiones SP (SP Connections).
494
3.2. Configure el tipo de conexin.

Asegrese de marcar la casilla Perfiles Navegador SSO (Browser SSO Profiles) y luego, d clic en
Siguiente (Next):
3.3. Configure las opciones de conexin.

Asegrese de marcar la casilla Navegador SSO (SSO Profiles) y luego, d clic en Siguiente (Next):
495
3.4. Importe la metadata

Asegrese de dar clic en el botn Seleccionar archivo para importar el archivo de metadata producido
por la Consola JEE (generada en C:/BizagiJEE/[Bizagi_version]/BizagiBPMJEE/bizagi-config/samlconfig/metadata/SP/SPMetadata.xml):.
Una vez este archivo sea importado, usted ver su informacin cargada en la pestaa Resumen de la
Metadata (Metadata Summary).
No modifique esta configuracin.
Observe que la Conexin SP requiere la configuracin del perfil del Navegador SSO.
Proceda a configurar el Navegador SSO haciendo clic en Configurar Navegador SSO (Configure
Browser SSO):
496
3.5. Configure el Perfil SAML.

Para el Navegador SSO, asegrese de marcar la casilla SP-Initiated SSO para el perfil de Single SignOn.
Para el perfil de Inicio Simple de sesin, marque la casilla SP-Initiated SLO.

3.6. Configure el tiempo de vida de la Asercin
Para el navegador SSO, asegrese de configurar el tiempo de vida (expiracin) de una asercin.
Establezca este valor de acuerdo a sus polticas corporativas, de cualquier manera, tenga en cuenta
que no se recomienda definir un tiempo de vida con un periodo de tiempo muy extenso (en minutos).
Usted puede usar 5 minutos para ambos valores:
497

3.7. Lance la creacin de Aserciones
Recuerde que el perfil del Navegador SSO requiere una definicin de aserciones.
Desde la pestaa Creacin de Aserciones (Assertion creation), d clic en el botn Configurar creacin
de aserciones (Configure Assertion Creation) para crear una nueva definicin de aserciones.
3.8. Configure el mapeo de Identidades

Para la asercin, use la configuracin Standard del atributo contrato.
498

3.9. Configure el atributo contrato.
Para la asercin, configure la definicin SAML_SUBJECT y asegrese de escoger:
urn: oasis: names: tc: SAML: 1.1: nameid-format:unspecified
En este punto, usted puede configurar cualquier atributo de usuario adicional que quiera incluir en las
aserciones SAML.
Observe que Bizagi no administrar estos atributos adicionales, pero usted puede tener su proveedor
de identidades (su implementacin) usando los atributos y la informacin por separado.
D clic en Siguiente (Next) cuando termine.
3.10. Lance la configuracin del mapeo del adaptador IdP.
Tenga en cuenta que la asercin requiere una definicin del adaptador en su configuracin.
En la pestaa Mapeo del Adaptador IdP (IdP Adapter Mapping), haga clic en el botn Mapear nueva
instancia del adaptador (Map New Adapter instance..) para mapear uno de los adaptadores (ya sea
uno existente o una definicin nueva).
499
Seleccione una de sus instancias de adaptador que se adapte para esta conexin o utilice el botn
Administrar Instancias de Adaptador (Manage Adapter Instances..) y luego d clic en el botn crear
Nueva instancia.
Para la configuracin del adaptador, necesita asegurarse de que se configure usando lo siguiente:
Type: HTML Form IdP Adapter
500
Password credential validator: Una instancia que conecta a su repositorio de usuarios (e.g tipo
LDAP).
Asegrese de establecer adecuadamente la conexin y configure las credenciales del validador.
Asegrese de mapear el adaptador, para esto, d clic en Add new row to [Credential validators]:
Extended contract: Puede omitir este paso.

Username: para los atributos de adaptado (adapter attributes) listados, asegrese de marcar la
casilla seudnimo (pseudonym).
501
Cuando termine, d clic en Terminar (Done).

3.11. Mapee y configure la instancia del adaptador
Asegrese de asignar y mapear este adaptador a la configuracin de la asercin, ya sea que haya
creado o reutilizado un adaptador existente.
3.12. Configure el mapeo de la asercin

Seleccione la opcin Usar solo los valores del contrato del adaptador en la asercin SAML (Use only
the adapter contract values in the SAML assertion).
502
D clic en siguiente (Next).

13 Configure el cumplimiento del atributo contrato.
Para la definicin SAML_SUBJECT ya provista, seleccione:
Source: Adapter
Value: username

Usted puede omitir la configuracin de los criterios de omisin dando clic en siguiente (Next) dejando
los campos en blanco.
3.14. Revise el mapeo del adaptador IdP
Una vez haya hecho esto, puede revisar la informacin del mapeo del adaptador en la ventana de
resumen y continuar.
Al final, su instancia de adaptador debe aparecer listada para la asercin:
503
3.15. Revise la creacin de la asercin

Una vez haya hecho esto, puede revisar la definicin de la asercin en la ventana de resumen y
continuar.
Al final, la asercin deber aparecer listada en la pestaa Creacin de Asercin (Assertion creation)
para la configuracin del perfil del Navegador SSO:
3.16. Configure los ajustes del protocolo

Para el Navegador SSO, d clic en Configurar los ajustes del protocolo (Configure protocol settings).
Usted puede ver que alguna informacin ya se ha configurado.
No modifique la informacin ya establecida a cerca de bindings, endpoints y URL de respuesta, ya que
es importada directamente del archivo de metadata de Bizagi (cuando se importa la conexin SP).
Usted puede editar la configuracin de Bindings de SAML admisibles (Allowable SAML Bindings) para
asegurar que solo los protocolos POST, Redirect y SOAP son etiquetados.
504
Para la configuracin de la poltica de firma (Signature policy), usted puede marcar tanto Requiere
solicitudes AuthN para ser firmado cuando sea recibido a travs de los bindings de POST o Redirect
(Require AuthN requests to be signed when received via the POST or Redirect bindings) como para
Siempre firmar la asercin SAML (Always sign the SAML assertion).
Para la configuracin de la poltica de cifrado (Encryption policy), seleccione Ninguna (None).
505
Una vez termine, usted puede revisar la configuracin de los protocolos en la ventana de resumen y
continuar.
Al final, usted regresar a la pestaa Configuracin de Protocoles (Protocol settings) en la
configuracin del perfil del Navegador SSO.
3.17. Revise la configuracin del navegador SSO
Revise la configuracin del navegador SSO en la ventana de resumen y contine.
506
Cuando termine de crear el perfil del Navegador SSO, regresar a la configuracin principal de la
conexin SP.
3.18. Configure las credenciales
D clic en configurar las credenciales (Configure credentials) para configurar cules certificados sern
utilizados para propsitos de firma por la conexin SP.
507
La configuracin de las credenciales considera: ajustes de la autenticacin back-channel, firma digital y

verificacin de firmas.
3.19. Configure la autenticacin back-channel
Para este paso, utilice la Autenticacin Back-channel (Back-channel Authentication), d clic en el
enlace Configurar (Configure) en su pestaa.
Para la Autenticacin Back-channel (Back-channel Authentication), asegrese de marcar lo siguiente:
Firma digital (Perfil del navegador SSO) (Digital signature (Browser SSO profile only)) y Requiere SSL
(Require SSL):

Una vez termine, puede revisar la configuracin de la autenticacin back-channel (back-channel
authentication) en la ventana de resumen y continuar.
3.20. Configurar los ajustes de firma digital.
Para configurar la firma digital involucrada, primero seleccione el Certificado de firma (Signing
certificate) apropiado.
508
Sus certificados importados deben aparecer en la lista desplegable.

En caso que no, consulte la seccin Antes de empezar del Ejemplo de exportacin de metadata de
Ping Federate para asegurarse de que import los certificados necesarios (recomendado).
Tenga en cuenta que este certificado deber ser aquel usado solo por su proveedor de identidades
para firmar las aserciones (por ejemplo, si esta usando solamente certificado en cada servidor, debe
usar el mismo certificado del servidor SSL configurado para HTTPS en Ping Federate).
Seleccione RSA SHA-1 como el algoritmo de firma (Signing algorithm).

3.21. Configure los ajustes de verificacin de firma.
Para configurar la verificacin de firma (signature verification), d clic en Administrar ajustes de
verificacin de firma (Manage Signature Verification Settings...)
Los ajustes de la verificacin de firma (signature verification) pueden contar con un modelo de
confianza Anclado (Anchored) o Desanclado (Unanchored).
De cualquier forma, se recomienda usar Desanclado (Unanchored) para que el certificado usado por
509
bizagi para las aserciones sea validado directamente en Ping Federate (con la configuracin de
Anclado (Anchored), usted podra necesitar validar y especificar el nombre exacto en los ajustes de
Subject DN para comparar cuando obtener el certificado usado por Bizagi para las aserciones).
Para la pestaa Certificado de verificacin de la firma (Signature verification certificate) (cuando use
un modelo de confianza Desanclado), asegrese de seleccionar el certificado que usar Bizagi para las
aserciones.
De igual manera que en los pasos anteriores, observe que el certificado debe ser el que es usado
solamente por Bizagi para firmar las aserciones (por ejemplo, si esta usando solamente certificado en
cada servidor, debe usar el mismo certificado del servidor SSL configurado para HTTPS en Ping
Federate).
Una vez termine, puede revisar esta configuracin en la ventana de resumen y continuar.
Al final, regresar a la configuracin de Credenciales (Credentials) la cual ser presentada con su

resumen.
De igual forma, cuando termine de revisar, proceda a terminar la configuracin de Credenciales
(Credentials).
3.22. Revise la configuracin de la conexin SP
Por ltimo, regrese a la configuracin de la conexin SP, confirme que su conjunto de credenciales
aparezca como configurado.
D clic en siguiente (Next) para moverse a la pestaa de Activacin y resumen (Activation & summary)
donde deber verificar:
Que el estado de la conexin (Connection Status) para esta conexin SP sea Active.
Que todo el conjunto de informacin sea exacta revisando el resumen.
510
D clic en terminar (Done).
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.
511
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 <INSUMOS_DE_CONFIGURACIN>
\Bizagi\Bizagi-ear-Websphere.ear.
Ms informacin sobre esta ruta y archivo se referencia en la configuracin de WebSphere.
Tener instalada la Consola de 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.
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 en <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).
512
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

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 sistemas operativos tipo *nix (p.e Linux), utilice:
sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh createproject -f
<CONFIG_PATH>
En sistemas operativos 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:
sh <JEECONSOLE_HOME>/bin/JEEConsoleManager.sh predeploy -o <OUTPUT_PATH> -p
[PROJECT_NAME] -f <FILE_PATH>
<JEECONSOLE_HOME>\bin\JEEConsoleManager.bat predeploy -o <OUTPUT_PATH> -p
513
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).
Este .EAR se entrega inicialmente dentro de los insumos de configuracin, en
<INSUMOS_DE_CONFIGURACIN>\Bizagi\Bizagi-ear-Websphere.ear.
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.
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.
514
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).
Si no es la primera vez que despliega la aplicacin sobre WebSphere (est aplicando cambios o
versiones de proceso nuevas a su proyecto de Bizagi), entonces deber detener la aplicacin Bizagiear ya existente y desinstalarla previamente:
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
515
(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
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
516
(Apply).

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.
517
8. Seleccione la aplicacin instalada haciendo clic sobre ella (Bizagi-ear).

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. Dentro de la edicin de la aplicacin recientemente creada Bizagi-ear, incluya referencias a libreras
compartidas.
Para hacerlo, de clic en la aplicacin y utilice el botn Reference shared libraries para ubicar las
opciones de mapeo de libreras en Shared library mapping.
Seleccione la librera httpclient:
518
De clic en Ok y aplique los cambios.

10. 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.
519
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).
Si no es la primera vez que despliega la aplicacin sobre WebSphere (est aplicando cambios o
versiones de proceso nuevas a su proyecto de Bizagi), entonces deber detener la aplicacin Bizagiear ya existente y desinstalarla previamente:
520
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.
521
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. Edite la aplicacin recientemente creada Bizagi-ear, incluyendo referencias a libreras compartidas.

Para hacerlo, de clic en la aplicacin y utilice el botn Reference shared libraries para ubicar las
opciones de mapeo de libreras en Shared library mapping.
Seleccione la librera httpclient:
522
De clic en Ok y aplique los cambios.

10. Seleccione la aplicacin instalada y utilice el botn de Iniciar (Start) para cargar sus componentes e
iniciar el Portal de Trabajo.
523
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).
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.
refenciada como <JEECONSOLE_HOME> a partir de este momento.
Lo que debe hacer

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

proyecto.
La plantila XML de esta configuracin la puede encontrar dentro de la ruta de la Consola Bizagi JEE, en
<JEECONSOLE_HOME>\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:
conexin.

525
<CONFIG_PATH>
\[NOMBRE_PROYECTO]
Considere:
\[NOMBRE_PROYECTO]\dist\BizAgi-ear-Weblogic.ear).
<INSUMOS_DE_CONFIGURACIN>\Bizagi\Bizagi-ear-Weblogic.ear.
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
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
526
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.
D clic sobre Instalar (Install).
2. Navegue hacia la ruta de <INSUMOS_DE_CONFIGURACIN>, donde se encuentra el archivo EAR
generado de la aplicacin Weblogic.
Seleccione este archivo (Bizagi-ear-Weblogic.ear).
527
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).
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):
528
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.
Despliegue hacia JBoss
Introduccin
Esta seccin describe cmo generar el Portal de Trabajo para los Procesos de Bizagi en JBoss
529
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.
referenciada como <JEECONSOLE_HOME> a partir de este momento.
Lo que debe hacer

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

proyecto.
La plantila XML de esta configuracin la puede encontrar dentro de la ruta de la Consola Bizagi JEE,
ubicada en <JEECONSOLE_HOME>\ProjectTemplate.xml.
530
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.

<CONFIG_PATH>
\[NOMBRE_PROYECTO]
531
Considere:
\[NOMBRE_PROYECTO]\dist\BizAgi-ear-JBoss.ear).
<INSUMOS_DE_CONFIGURACIN>\Bizagi\Bizagi-ear-JBoss.ear.
Si su configuracin de JBoss 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

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
cuando JBoss est detenido.
Sin embargo, se recomienda reiniciar la aplicacin una vez que se hayan realizado cambios.
532
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 sistemas operativos
Windows); o el archivo <JBOSS_HOME>\bin\run.conf (sistemas operativos tipo *nix como Linux).
Edite,este archivo teniendo en cuenta:
Editar los parmetros de memoria inicial y memoria mxima para sistemas operativos tipo *nix,
agregando:
Xms1024m Xmx1024m -XX:MaxPermSize=1024m
debajo de la lnea que contiene: # Specify options to pass to the Java VM.
Editar los parmetros de memoria inicial y memoria mxima para sistemas operativos Windows,
agregando:
set "JAVA_OPTS=-Xms1024m -Xmx1024m -XX:MaxPermSize=1024m"
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.
533
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.
534
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).
535
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.
536
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 ):
537
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.
538
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
la JEE.
539
Introduccin
Al iniciar Bizagi Engine en un ambiente de Produccin, hay algunas configuraciones adicionales que
Bizagi recomienda implementar en todo proyecto.
Para un proyecto ejecutndose en la plataforma JEE, dichas configuraciones son llevadas acabo al
ajustar configuraciones del servidor.
ste procedimiento asegura la calidad del servicio debido a la inclusin de polticas WS-Security.
sta seccin ilustra cmo reforzar su entorno de operacin con dichas opciones de seguridad:
Antes de iniciar
Tenga en mente que para el Portal de Trabajo de Bizagi se recomienda usar un protocolo HTTPS
sobre una configuracin SSL (en su servidor de aplicaciones JEE).
Al usar HTTPS, considere editar el archivo bizagi-config.properties para incluir la lnea

PROTOCOL="HTTPS".
sto aplica al usar enlaces de caso en notificaciones de procesos.
Las siguientes recomendaciones estn dirigidas a proveer una seguridad mejorada para su servidor y
sus servicios web, a pesar de ser completamente opcionales.
Al elejir llevar acabo el refuerzo de seguridad contemplando certificados X.509, tenga en cuenta que
necesitar:
Certificados oficiales X.509 (entregados por una Entidad Certificadora 'CA' apropiada y oficial) para
propsitos de encripcin.
Dichos certificados deben ser vlidos y estar ya instalados.
El administrador de su plataforma requerir experiencia adecuada en la materia (certificados, su uso
e instalacin).
Recomendaciones de seguridad
La idea detrs de estas recomendaciones es mejorar la seguridad de su servicio completamente,
considerando los siguientes aspectos:
1. Creacin de un Conjunto de Polticas de Aplicacin.
2. Creacin de un Enlace de Conjunto de Polticas
3. Configuracin de certificados
a. Definicin de certificados de confianza
b. Configuracin de la firma de mensajes entrantes
540
c. Configuracin de la firma de mensajes salientes

d. Configuracin de desencripcin de mensajes entrantes
e. Configuracin de encripcin de mensajes entrantes
4. Unir un Conjunto de Polticas y Asignar Enlaces a un Proveedor de Servicio
Configuracin
Siga estas recomendaciones para implementar seguirdad adicional en su entorno operacional de
Bizagi.
En el siguiente ejemplo usaremos un servidor de IBM WebSphere
1. Creacin de un Conjunto de Polticas de Aplicacin

Un conjunto de polticas es un contenedor de tipos de polticas relacionadas a seguridad y mensajera
confiable para Servicios Web. Para ms informacin visite el Centro de Conocimiento de IBM.
Siga los siguientes pasos para crear un Conjunto de Polticas de Aplicacin:
1. Abra la opcin Conjunto de Polticas de Aplicacin (Application policy sets) localizada en el panel
izquierdo en el men Servicios (Services) > Conjunto de Polticas (Policy sets).
541
2. Seleccione el enlace (Username WSSecurity default) y haga clic en el botn Copiar (Copy) para
hacer una copia de un Conjunto de Polticas de Aplicacin.
ste Conjunto de Polticas cifra, por defecto, el cuerpo SOAP, la firma y el token de nombre de usuario.
542
3. D un nuevo nombre y descripcin a la copia y presione OK.

sto crear una copa de la plantilla por defecto "WS-Security Application Policy Set".
2. Creacin de un Enlace de Conjunto de Polticas

Aqu configurar la informacin especfica asociada a las polticas definidas para su Servicio Web.
Siga los siguientes pasos para enlazar un Conjunto de Polticas de Aplicacin:
1. Abra la opcin Enlaces de conjunto de polticas del proveedor general (General provider policy set
bindings) ubicada en el panel izquierdo en el men Servicios (Services) > Conjunto de Polticas (Policy
sets).
543
2. Seleccione una plantilla de Proveedor llamada Muestra de Proveedor (Provider sample) y presione el
botn Copiar (Copy).
544
3. Ingrese nombre y descripcin, luego presione el botn OK.
3. Configuracin de Certificados
Para configurar WS-Security en sus Servicios Web Bizagi, necesita modificar la configuracin previa
copiada de las plantillas para agregar la informacin de sus certificados.
Para avanzar con esta configuracin, por favor asegrese de leer la siguiente informacin:
Tenga en mente que en este punto debe tener un certificado X.509 oficial (emitido por una
Autoridad Certificadora "CA") para propsitos de encripcin.
Dichos certificados deben ser vlidos y actualmente instalados.
Para propsitos de ejemplificacin, un almacen de claves ha sido generado, llamado serverKeys.jks
en el lado del servidor, el cual incluye la llave pblica y privada del servidor y la llave pblica del
cliente.
El almacen de llaves est localizado en la ruta ${USER_INSTALL_ROOT}\config\cells
545
\<yourCellName>\.
Para ambientes de desarrollo y pruebas, se pueden generar certificados auto firmados.

ste procedimiento puede ser realizado a travs de software de terceros y, por lo tanto, es
responsabilidad del cliente cmo generarlo y su uso.
Para propsitos de pruebas, JEE tiene una librera llamada Keytool. La documentacin de la
herramienta es proveda en caso de que desee generar un certificado auto firmado. Debido al
hecho de que es un software de terceros, es responsabilidad del cliente cmo generarlo y su uso.
Para ambientes de Produccin, se recomienda fuertemente usar un certificado oficial (emitido por
una Autoridad Certificadora "CA").
3.a. Definicin de certificados de confianza

1. Desde la consola, seleccione la configuracin creada en la opcin Enlaces de conjunto de polticas
del proveedor general (General provider policy set bindings) ubicada en el panel izquierdo, en el
men Servicios (Services) > Conjunto de Polticas (Policy sets).
2. Seleccione la opcin WS-Security > Llaves y certificados (Keys and certificates), y en la seccin
Ancla de confianza (Trust anchor), cree una nueva Ancla de confianza al seleccionar el botn Nuevo
(New).
546
3. Ingrese la informacin de su almacn de llaves. Debe estar localizado

${USER_INSTALL_ROOT}\config\cells\<yourCellName>\ServerKeys.jks.
en:
3.b. Configuracin de la firma de mensajes entrantes

Para garantizar apropiadamente que la llave usada es de confianza, usted debe configurar los
mensajes entrantes. En este punto, un certificado oficial X.509 debe ser instalado y configurado
547
apropiadamente. De otra forma, lea cmo definir certificados de confianza.

Por favor, siga los pasos mencionados a continuacin para configurar apropiadamente la firma de los
mensajes entrantes:
2. Seleccione la opcin WS-Security > Autenticacin y proteccin (Authentication and protection).
548
3. En la seccin de Tokens de proteccin (Protection Tokens), seleccione la opcin con_signx509token.

Luego abra el enlace Manejador de retorno (Callback handler).
4. Elija las siguientes opciones en la lista desplegable:

Almacn de certificados:
(none)
Almacn de anclas de confianza:
ServerTrustStore
549
Luego presione OK.
3.c. Configuracin de la firma de mensajes salientes

Por favor, siga los pasos mencionados a continuacin para configurar apropiadamente la firma de los
mensajes salientes:
550
551
3. En la seccin de Tokens de proteccin (Protection Tokens), seleccione la opcin gen_signx509token.

4. En el Almacen de LLaves (Keystore), seleccione Custom de la lista desplegable y haga clic en el

enlace Configuracin de Almacn de Llaves Personalizado (Custom keystore configuration).
552
5. Ingrese la informacin en cada seccin:

Almacn de Llaves (Keystore):
Datos del Almacn de Llaves.
Llave (Key):
Datos de la llave publica del servidor.
553
Luego presione OK.
3.d. Configuracin de la desencripcin de mensajes

Por favor, siga los pasos mencionados a continuacin para configurar apropiadamente la
desencripcin de los mensajes entrantes:
554
3. En la seccin de Tokens de proteccin (Protection Tokens), seleccione la opcin con_encx509token.


555

Llave (Key):
Datos de la llave privada del servidor.
556
Luego presione OK.
3.e. Configuracin de encripcin de mensajes salientes

Por favor, siga los pasos mencionados a continuacin para configurar apropiadamente la encripcin
de los mensajes salientes:
557
558
3. En la seccin de Tokens de proteccin (Protection Tokens), seleccione la opcin gen_encx509token.


559

Llave (Key):
Datos de la llave publica del cliente.
Then, press OK.
4. Unir un Conjunto de Polticas y Asignar Enlaces a un Proveedor de Servicio

Una vez el Conjunto de Polticas de Aplicacin y el Enlace de Conjunto de polticas ha sido creado,
560
debe decidir cul Servicio Web aplicar para esta configuracin.

Siga estos pasos para configurar un Servicio Web con las configuraciones realizadas anteriormente.
1. Abra la opcin Proveedores de servicio (Service providers) ubicada en el men de Servicios
(Services).
2. Seleccione un recurso que desee asegurar.

EntityManagerSOAImplService.
Para
este
ejemplo,
seleccione
el recurso
561
3. Agregue el Conjunto de Polticas y el enlace de Conjunto de Polticas creados previamente.
En este punto, se complet la configuracin de seguridad, pruebe su servicio Web usando las
credenciales necesarias.
La capa SOA de Bizagi est atada a SOAP 1.0 y 1.1, por lo tanto, cualquier mtodo que utilice estos
estndares puede ser configurado desde un servidor que pueda proteger los proveedores.
562
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 la conexin a su servidor de correo
Introduccin
Bizagi ofrece la posibilidad de utilizar un servidor de correo electrnico para enviar notificaciones
definidas en sus procesos.
Esta es fcilmente configurable mediante la especificacin de la ubicacin del servidor de correo
electrnico en las opciones de Entorno de su proyecto Bizagi.
Como prctica recomendada, en un ambiente de produccin se debe utilizar un servicio local SMTP
(donde se encuentre Bizagi Engine) de manera intermedia entre Bizagi y su servidor SMTP corporativo.
Las ventajas de utilizar este servicio local de manera intermedia son:
La necesidad de utilizar la autenticacin para acceder al servidor SMTP
Incluso si se desea utilizar un puerto diferente al nmero 25 que se utiliza por defecto.
La posibilidad de contar con la continuidad del negocio en sus procesos (en un caso eventual en que
el servidor SMTP est temporalmente fuera de servicio, los procesos de Bizagi continan y las
notificaciones se encolan en el IIS).
Una mejor trazabilidad y monitoreo sobre las notificaciones (estadsticas adicionales) junto con la
posibilidad de usar un mecanismo de store-and-forward.
Incluso, en algunas ocasiones el servidor SMTP intermedio podr instalarse no local al servidor BPM
de Bizagi, en caso de que el servidor BPM de Bizagi no tenga acceso directo al servidor SMTP
corporativo.
En entornos Windows, dicho servicio es proporcionado por IIS (un servicio de servidor SMTP), que
puede ser instalado directamente en el servidor de BPM.
Para sistemas operativos *nix (aplica para Bizagi ejecutndose en plataforma JEE), puede utilizar los
servicios de terceros, tales como Postfix.
Tenga en cuenta que al establecer estos servicios, la administracin depende de herramientas (por
ejemplo postfixadmon) para configurar el SMTP y sus reglas (con el fin de evitar el envo de spam).
Para mayor informacin sobre cmo instalar, configurar y utilizar un servicio de SMTP intermedio,
consulte:
Configurar el servidor SMTP a travs del IIS.
563
Configurar el servidor SMTP a travs de Postfix.
Configuracin del servicio SMTP a travs del IIS
Introduccin
Esta seccin ilustra cmo configurar el Servidor SMTP como servicio, que se provee por los
componentes de Internet Information Services (IIS), para utilizarlo como servicio intermedio y hacer
relay de notificaciones a su servidor SMTP corporativo (aplica para procesos que se ejecuten sobre
plataformas Windows).
Esta opcin es enfticamente recomendada para implementar las mejores prcticas tales como: el uso
de una conexin autenticada al servidor SMTP de correos corporativo, el uso de parmetros
avanzados (por ejemplo, un puerto diferente al de por defecto o el uso de TLS, etc), y poder contar
con la continuidad en sus procesos de negocio (en el eventual caso que su servidor SMTP se encuentre
temporalmente fuera de servicio, las notificaciones se encolan en el IIS y el proceso contina).
Para mayor informacin sobre estas ventajas, consulte la Configuracin de la conexin a su servidor de
correo.
Prerrequisitos
Para utilizar y configurar el servicio del SMTP local en el IIS, deber primero asegurarse de habilitar las
caractersticas y roles del servidor.
Recuerde que el servicio SMTP se encuentra disponible nicamente para sistemas operativos de
servidor -Windows server- (como por ejemplo Windows Server 2012 y 2008).
La instalacin de la caracterstica SMTP Server se realiza a travs de las opciones de administracin
del servidor (Server management):
564
Tenga presente que esto requiere de roles del servidor Web server adicionales, tales como: IIS 6
Management console y Remote Server Admin Tools:
Una vez que esta caracterstica se encuentre instalada, asegrese que el servicio SMTP se encuentre
iniciado y preferiblemente configurado para un inicio automtico:
565
Lo que debe hacerse

Una vez se tenga el servicio instalado, lleve a cabo los siguientes pasos para reenviar notificaciones
por medio del relay, a su servidor de correo corporativo:
1. Configure el servidor SMTP del IIS
2. Cree un dominio para el servidor SMTP
3. Configure los parmetros de correo en Bizagi
Procedimiento
Siga estos pasos como se describen a continuacin.
1. Configure el servidor SMTP del IIS

1.1. Inicie el Administrador de IIS 6,0
La configuracin del SMTP se realiza por medio del Administrador del IIS versin 6.0 (incluso si se tiene
una versin ms reciente del IIS).
Para ello, puede utilizar el acceso desde Inicio -> Herramientas administrativas -> Servicios de
Internet Information Server 6.0 o las opciones de adminstracin del servidor.
566
1.2. Configure las propiedades del servidor SMTP

It is strongly recommended to explicitly adjust the settings to comply with best security practices.
To verify settings, right click on and select properties:
567
Review the following configuration:

Authentication should specify anonymous access:
568
Connection should be allowed only from the local server (localhost):
569
Relay should be allowed only from the local server (localhost):
Make sure that under the delivery settings, you specify the outbound security employed to
authenticate against your corporate SMTP server:
570
Similary for the delivery settings, use the advanced options to specify the location of your corporate
SMTP server (as the smarthost to relay to).
Note that you should enter a server name or use IP addresses inside of squared brackets (as
[xxx.xx.xx.xx])
571
2. Cree un dominio para el servidor SMTP

2.1 Cree un dominio nuevo
Para seguir las mejores prcticas, cree un dominio en el SMTP para el manejo de las notificaciones de
sus procesos Bizagi.
Expanda la estructura de rbol bajo el nombre del servidor virtual y d clic derecho para seleccionar
Nuevo-> Dominio.
2.2 Especifique que sea un dominio remoto

En la ventana New SMTP Domain Wizard, primero seleccione la opcin Remoto y haga clic en
Siguiente.
572
2.3 Nombre el dominio adecuadamente

Para el campo Nombre, escriba el nombre DNS del dominio al que desea volver a enviar notificaciones
de correo electrnico.
D clic en Finalizar.
2.4 Configure el manejo adicional para ese dominio.

Una vez que el dominio se crea puede encontrar propiedades avanzadas, haciendo clic derecho en ese
573
dominio y seleccionando sus Propiedades.
El servidor SMTP deber ser el autorizado para enviar finalmente esas notificaciones (asegrese de
que est habilitado Allow incoming mail to be relayed to this domain).
Configure las opciones dentro de Outbound Security.. segn sea necesario (especificando las
credenciales de salida para la autenticacin utilizada en ese servidor de correo corporativo).
Se debe soportar relay.
En el cuadro Route Domain de la ventana de propiedades, seleccione Forward all mail to Smart Host
(Reenviar todo el correo al host inteligente.)
Introduzca el nombre del servidor SMTP, o su direccin IP entre corchetes "[]".
574
D clic en Ok.
Para mayor informacin sobre dominios SMTP, consulte la documentacin oficial de Microsoft en
http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/e2156172-7118-4ff29a6a-1b7dd52580fa.mspx?mfr=true.
Finalmente, asegrese que este servicio est iniciado an despus de realizar cambios:
3. Configure los parmetros de correo en Bizagi

575
Teniendo ya configurado el servicio del SMTP, asegrese de configurar los parmetros de correo para
su proyecto de Bizagi.
En los ambientes de produccin y de pruebas, podr realizar esto mediante el Management Console
provisto por Bizagi Engine, asegurndose que se instancie el servicio local (localhost) como el servidor
SMTP.
Marque la casilla de habilitar el correo (Enable mail) y especifique la cuenta que envia los correos
(sender account) usando el dominio vlido:
De clic en Ok para guardar los cambios, y seguidamente realice un IISReset sobre sus servicios del IIS.
Configuracin del servicio SMTP a travs de Postfix
Introduccin
Esta seccin ilustra cmo configurar Bizagi para trabajar con un servidor SMTP de Postfix, para
utilizarlo como servicio intermedio y hacer relay de notificaciones a su servidor de correos corporativo.
576
Postfix es un servidor de correo (MTA) de cdigo abierto (de uso y licencia libre) de terceros.
Se recomienda su uso en plataformas JEE dado que es ampliamente adoptado en sistemas
operativos de tipo *nix.
Esta opcin es enfticamente recomendada para implementar las mejores prcticas tales como: el uso
de una conexin autenticada al servidor SMTP de correos corporativo, el uso de parmetros
avanzados (por ejemplo, un puerto diferente al de por defecto o el uso de protocolos y medidas
adicionales como TLS, etc), y poder contar con la continuidad en sus procesos de negocio (en el
eventual caso que su servidor de correos se encuentre temporalmente fuera de servicio, las
notificaciones se encolan en Postfix y el proceso contina).
Para mayor informacin sobre estas ventajas, consulte la Configuracin de la conexin a su servidor de
correo.
Prerrequisitos
Se debe cumplir con los siguientes prerrequisitos:
1. Tener instalada una versin de Postfix 2.9 o superior.
Debe instalarlo en el servidor BPM, con la capacidad de hacer relay a su servidor de correos
corporativo.
2. Tener Bizagi configurado en el servidor BPM.
Los enlaces de gua sobre cmo configurar la solucin Bizagi en el servidor BPM, sea en clster o
standalone, se encuentran segn el Servidor de Aplicaciones JEE que se emplee (WebSphere, Weblogic
o JBoss) en Configurar el Servidor de Aplicaciones JEE.
3. Tener habilitado el puerto por el cual su servidor SMTP corporativo atiende las peticiones de correo.
Lo que debe hacerse

Se deben llevar a cabo los siguientes pasos:
1. Instalar los paquetes necesarios para la funcionalidad del correo.
2. Configurar los parmetros relevantes en los archivos de Postfix.
3. Configurar los parmetros de correo en Bizagi.
Procedimiento
Recuerde que el procedimiento parte de tener instalador Postfix en el servidor BPM.
Una vez se tenga la instalacin, realice los siguientes pasos:
En caso de que Postfix est instalado en un servidor diferente, el mismo procedimiento aplica solo
que en vez de usar localhost desde Bizagi, se debe referenciar ese servidor que contiene a Postfix.
1. Instalar los paquetes necesarios para la funcionalidad del correo.

Instale los siguentes paquetes (telnet, cyrus, mailx) ejecutndo estos comandos (con el usuario ROOT
o con sus privilegios):
577
sudo yum install telnet

sudo yum install cyrus-sasl-plain
sudo yum install mailx
2. Configurar los parmetros relevantes en los archivos de Postfix.

Ubique el archivo de configuracin main.cf de Postfix, ubicado por defecto como /etc/postfix/
main.cf.
Podr usar el editor Vi (comando vi /etc/postfix/main.cf) para incluir las siguientes lineas al
final del archivo:
relayhost = [<servidor_corporativo_smtp>]:<puerto>
smtp_tls_loglevel = 1
smtp_tls_security_level = encrypt
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_sasl_mechanism_filter = CRAM-MD5, PLAIN, LOGIN
smtp_tls_CAfile = /etc/postfix/cacert.pem
Considere que <servidor_corporativo_smtp> y <puerto> debern corresponder a su servidor de
correos corporativo (y puerto bajo el cul atiende) al cul se le hace relay. Ejemplo de configuracin:
relayhost = [smtp.office365.com]:587
Seguidamente, cree el archivo sasl_passwd donde se almacenan las credenciales para el envo de
correos (el nombre del archivo como es configurado desde smtp_sasl_password_maps
anteriormente):
Podr usar nuevamente el editor Vi (comando sudo vi /etc/postfix/sasl_passwd) para incluir
la siguiente lnea en ese archivo:
[<servidor_corporativo_smtp>]:<puerto> <email>:<contrasea>
Considere que <email> y <contrasea> debern corresponder a la cuenta autorizada a autenticarse
en su servidor corporativo. Ejemplo de configuracin:
[smtp.office365.com]:587 bizagi_mail_service@bizagi.com:Bizagi10GO
Asegrese de fijar los permisos apropiados a ese archivo sasl_passwd. Podr hacerlo con chmod con
el comando:
sudo chmod 400 /etc/postfix/sasl_passwd
Cree el archivo sasl_passwd.db, con el comando postmap como se muestra:
sudo postmap /etc/postfix/sasl_passwd
Finalmente, reinicie el servicio de Postfix para que cerciorarse que los cambios tomen efecto:
cd /etc/postfix
sudo postfix reload
Podr verificar la correcta configuracin en este punto, utilizando:

578
echo "<Email_body>" | mail -s "<Email_subject>" <Recipient_email> -r

<Email_for_relay>
Ejemplo:
echo "Sending a test mail from postfix" | mail -s "Test mail from
Postfix" MyEmail@bizagi.com -r bizagi_mail_service@bizagi.com
Los logs los puede revisar, desde la ubicacin por defecto con:
sudo tail /var/log/maillog
3. Configurar los parmetros de correo en Bizagi

Teniendo ya configurado el servicio del SMTP, asegrese de configurar los parmetros de correo para
su proyecto de Bizagi.
En los ambientes de produccin y de pruebas, podr realizar esto mediante el Management Console
provisto por Bizagi Engine, asegurndose que se instancie el servicio local (localhost) como el servidor
SMTP (independientemente de donde se tenga instalado el Management Console).
Marque la casilla de habilitar el correo (Enable mail) y especifique la cuenta que envia los correos
(sender account) usando el dominio vlido:
579
De clic en Ok para guardar los cambios.
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, aunque no necesariamente diseada o dirigida a un ambiente de produccin.
Para utilizar un ambiente de desarrollo pre configurado en la nube, consulte Cmo utilizar una
mquina virtual de Bizagi 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.
Lo siguiente representa la arquitectura considerada:
580
581
Ntese que los servicios de un proxy inverso permite redirigir el acceso desde Internet hacia el
servidor BPM de Bizagi con protocolos seguros, mientras que los usuarios en la intranet continuarn
accediendo el Portal de Trabajo de Bizagi desde adentro.
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>.
Configuracin de seguridad
Para habilitar los mdulos avanzados de seguridad en Apache, los cuales incluyen el proxy inverso,
siga estos pasos:
582
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.
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
583
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.
584
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.
585
Por ejemplo, si su proyecto de Bizagi se llama "MyProject" entonces se debe configurar el archivo
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
586
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]
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.
587
Es decir, si se utiliza autenticacin integrada (p.e Windows) o tipo Bizagi, a nivel de servidor BPM
(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 y nuevas versiones

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
588
modificaciones hasta que se complete el ciclo de Deployment). Se administra mediante Bizagi

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.
Consideraciones y requerimientos
Introduccin
Antes de iniciar un Deployment en Bizagi, hay consideraciones y requerimientos que deben tenerse en
cuenta tanto para el Deployment en un clic como para el Deployment Avanzado.
Considere adems los requerimientos tcnicos que aplican especficamente para el Deployment en un
clic.
Para mayor informacin sobre esta funcionalidad de Bizagi, consulte el Deployment de procesos y
nuevas versiones.
Antes de comenzar
Considere que si usted va a ejecutar sus procesos en una plataforma de .NET platform, el uso del IIS
Express no es soportado.
589
Recuerde que el servidor IIS Express que viene embebido en Bizagi Studio le permite realizar
prototipado rpido o usar un servidor ms simple para verificar, presentar en demos, o realizar
pruebas unitarias de la implementacin de sus procesos. Sin embargo esta opcin no est diseada
para usarse en un ambiente de produccin ,donde se requiere un servidor ms robusto.
A su vez, se recomienda enfticamente usar el IIS como se provee por el sistema operativo Windows,
incluso en un ambiente de desarrollo.
1. Requerimientos generales de la implementacin

Estos requerimientos aplican de manera indiferente al tipo de Deployment utilizado.
1.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):
590
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.
1.2 Revisin de metadata sin inconvenientes

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.
1.3 Conocimiento sobre 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.
591
2. Requisitos tcnicos del Deployment

Estos requerimientos aplican de manera indiferente al tipo de Deployment utilizado.
2.1 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:
2.2 La Base de datos en 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:
592
Cuando se utiliza Oracle, esto significa revisar que sea la misma versin y release:
2.3 La 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 la
misma:
593
Cuando se utiliza Oracle, esto significa revisar que la configuracin del set de caracteres sea la misma:
594
3. Requisitos tcnicos propios del Deployment en un clic

Los siguientes son los requerimientos tcnicos para utilizar el Deployment en un clic que ofrece Bizagi
Studio, dado que este tipo de Deployment se realiza en lnea y bajo la asistencia de Bizagi.
3.1 Bizagi Engine instalado en los ambientes destino

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 ser de la misma versin que corresponda al Bizagi Studio que tiene instalado
en el ambiente de desarrollo.
3.2 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
(tanto el servidor BPM, como el servidor de Base de datos).
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:
El puerto TCP nmero 5679.
595
UDP 50051, 50052, 50053.

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 (ubicado en la ruta
de instalacin de Bizagi Studio que se usa en el ambiente de desarrollo, y que por defecto queda
ubicado como C:\Program Files\Bizagi\Studio\BizagiStudio).
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.
3.3 Contar con credenciales autorizadas en el Servidor del ambiente

Se requieren credenciales 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
administrador.
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.
596
Deployment de los objetos

El Deployment de Bizagi publica los Procesos y metadata adicional del proyecto.
Al realizar un deployment or al haber realizado ya uno anterior, es importante considerar el
tratamiento y caractersticas de este procedimiento.
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. Funcionalidades a nivel de atributos que no se pueden cambiar

Existen ciertas funcionalidades del producto para atributos (o entidades), las cuales no se pueden
activar una vez que dichos atributos (o entidades) hayan sido publicados ya en un ambiente de
produccin con la funcionalidad desactivada.
De manera similar, no se podr desactivar esta funcionalidad para atributos (o entidades) que ya estn
en el ambiente de produccin con la funcionalidad activada.
597
Las funcionalidades a nivel de atributos que no permite cambios (desactivacin o activacin posterior)
son:
La encripcin a nivel de base de datos.
La Virtualizacin de datos o Replicacin de datos.
Esto significa que si su atributo del ambiente de produccin ya utiliza encripcin a nivel de base de
datos o est siendo replicado o virtualizado, no podr cambiar esta definicin para este mismo
atributo.
En cambio y si requiere cambiar su funcionalidad, deber dejar de utilizar ese atributo (y detener el
esquema de replicacin cuando se usa la replicacin de datos), y crear una nueva verisn de proceso
que utilice un nuevo atributo en su lugar.
3. 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 identificados con un cono amarillo.
Mensajes de errores de integridad, que requieren 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:
598
Cuando se presenta un error de integridad, puede dar clic sobre l para ver mayor detalle:
599
Ntese que puede almacenar este log como un archivo XML.
4. 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.
600
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.
5. 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 administracin 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:
5.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.
601
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.
5.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.
602
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.
5.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.
603
En resumen, cambios en la configuracin de sistemas con Proveedores de datos, que ya est en

produccin, debe hacerse directamente sobre ese ambiente.
5.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 para la definicin de carpetas en la integracin ECM.
5.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).
604
En resumen, los 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.
5.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.
5.7 Grupos de usuarios (Desde la definicin de Organizacin)

605
La definicin de los elementos de la Organizacin en un proyecto (tal como: reas, 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.
606
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).
607
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.
608
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.
609
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.
610
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 en un clic
Introduccin
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.
611
En los siguientes Deployment, Bizagi actualizar la informacin de los Procesos a ese ambiente
existente.
En escenarios ms sofisticados, en los cuales el uso del Deployment en un clic que se realiza en lnea
no es viable, Bizagi provee una herramienta para Deployment Avanzado.
Para mayor informacin sobre esta herramienta, consulte el Deployment Avanzado.
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.
Por otro lado, la ventana de Deployment y procedimiento puede ser lanzada desde el mdulo de
Proceso (en la vista de mdulos) dando clic derecho en una versin especfica:
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 de 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
612
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.
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
Consideraciones y requerimientos para un Deployment.
las
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

613
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.
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
614
desarrollo, puede optar por llevar los Procesos al ambiente de produccin.

Para mayor informacin, consulte el Deployment a produccin.
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.
Este Deployment se lleva a cabo con el Deployment en un clic, de una manera en-lnea y sencilla.
En esta seccin ilustramos cmo realizar un Deployment al ambiente de pruebas.
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
615
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.
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
616
al de produccin).
Para ms informacin sobre esta opcin, consulte Release Candidate.
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.
617
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).
618
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.
619
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).
620
Para ms informacin acerca de esta opcin, consulte Relacionar objetos.

Agregar ms Procesos: Puede optar por incluir ms Procesos en el mismo Deployment.
621
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.
622
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.
623
Bizagi notifica cuando se complete el Deployment satisfactoriamente.
624
Haga clic en Cerrar.
625
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:
626
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.
627
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).
628
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).
629
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).
630
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).
631
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.
632
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
633
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).
634
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.
635
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:
636
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.
637
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.
638
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.
639
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.
640
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).
641
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 produccin, por defecto se nombra la Base de datos como "[miProyecto]" pero es
posible editar este nombre (aunque no se recomienda utilizar el mismo nombre que se utiliza en el
proyecto del ambiente de desarrollos).
642
Ingrese la cuenta y contrasea para la Base de datos y d clic en Siguiente.

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.
643
Deployment, al igual que la configuracin relacionada al ambiente de produccin (Servidor BPM y de

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).
644
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.
645
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 verificar la disponibilidad del Portal de Trabajo:
646
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 (por lo que usted no deber ingresar la
informacin sobre la ubicacin de sus servidores de produccin ya ingresados en un primer
deployment).
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 en C:\Program Files\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
647
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.
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.
648
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.
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.
649
Deployments incrementales
Para Deployments posteriores al primer Deployment a Produccin, 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
Subprocesos que utilice.
650
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.
651
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,
652
grupos de usuario).
Esquemas de festivos (en el esquema de horario
de trabajo)
Solo la descripcin del esquema de das 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).
653
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.
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
posteriormente 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 caractersticas 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
654
Cambios en el flujo del proceso: incluir o eliminar

elementos en el modelo, o cambiar los nombres,
duracin, notificaciones, etc de los mismos.
Incluir o eliminar atributos (o controles en Incluir o eliminar atributos (o controles en
formas) que sern evaluados en una regla de formas) que solo son informativos, ms no sern
negocio.
evaluados en una regla de negocio.
Cambios sobre reglas de negocio que ser Cambios sobre reglas de negocio que se prev
evaluadas en algn punto del proceso y que no podran producir inconsistencias con
podran producir inconsistencias con instancias instancias de proceso en produccin.
de proceso en produccin.
Cambios en las configuraciones de acciones de Cambios en las configuraciones de acciones de
actividad (notificaciones, decisiones, etc) que actividad (notificaciones, decisiones, etc) que se
afecten la lgica de enrutamiento del proceso.
prevea no afecten la lgica de enrutamiento del
proceso.
Cambios en la
procesos.
configuracin
de
los
sub
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.
Consideraciones
1. Bizagi duplicar los componentes de proceso tales como Formas, Polticas, Expresiones,
Vocabularios, Plantillas y elementos en cada versin/copia de proceso creada.
2. Bizagi compartir la misma definicin para Vocabularios, Expresiones y Polticas Globales entre las
diferentes versiones/copias de proceso. Por lo tanto, estos no sern duplicados sino compartidos.
3. Cuando clone un proceso con mltiples versiones, Bizagi solo clonar la ltima versin de proceso,
las versiones anteriores sern ignoradas.
655
4. Durante la creacin de una nueva versin o durante el clonado de un proceso, los usuarios finales
no podrn usar el Portal de Trabajo debido a que los servicios estarn detenidos.
Crear una nueva versin de Proceso

1. En la vista de Mdulos haga clic derecho sobre la versin del Proceso que quiere generar una nueva
versin y seleccione la opcin de Nueva versin.
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
656
Proceso.
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.
657
Solo los objetos relacionados al Proceso se copiarn: Fases, Actividades, Transiciones, Eventos,
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
utilizar el Deployment Avanzado.
658
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
subprocesos 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.
659
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 cambiar 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.
5. Planee y coordine el Deployment
660
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 contingencia 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 seguridad, 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:
\Program Files\Bizagi\Bizagi Studio\MC).
661
El propsito de cada ejecutable y dnde debe utilizarse se describe en la tabla a continuacin (este
archivo 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

662
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 anteriormente se realiza a travs de sus archivos con
extensin .config.
Estos archivos de configuracin contienen 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
663
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 configurar los archivos ejecutables, el login de SQL Server requerir de permisos de sysadmin.
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, 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
664
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:
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.
665
Una vez que confirme la accin, el progreso de la creacin de base de datos se ensea:
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:
666
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.

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:
667
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.
668
OPCIN
CUNDO UTILIZARLA?
Incluir sub procesos
Puede inicialmente y explcitamente marcar todos

los procesos y subprocesos que desea
considerar en el deployment.
Cuando marque solo procesos, podr basarse
en esta opcin para asegurarse de incluir todos
los subprocesos 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 elementos de la organizacin (posiciones,

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

organizacin dado que estos elementos se crean
669
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 incluir
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.
670

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.
671
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.
672
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:
673
Esto 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:
Pasos posteriores
Una vez se haya completado el deployment de procesos a travs del Deployment avanzado,
recomendamos que se limpie la cach del servidor en produccin antes de anunciar la finalizacin del
deployment.
Cuando se ejecutan los procesos sobre un IIS (plataforma de .NET), despus de realizar un deployment
avanzado deber limpiar la memoria cach del Portal de trabajo y de la base de datos.
Para realizar esto, invoque los siguientes servicios web de Bizagi disponibles en cada proyecto:
Cach de formas de la base de datos: http://[su_servidor][su_proyecto]/webservices/cache.asmx?
op=CleanRenderCache
Cach de aplicacin: http://[su_servidor][su_proyecto]/webservices/cache.asmx?op=CleanUpCache
Ntese que seguidamente deber reiniciar los servicios del IIS.
674
Cuando se ejecutan los procesos sobre una plataforma de JEE (sea sobre un WebSphere, Weblogic o
JBoss), despus de realizar un deployment avanzado deber limpiar la memoria cach del Portal de
trabajo y de la base de datos.
Para realizar esto, lleve a cabo los siguientes pasos:
Limpie la memoria cach de formas de la base de datos.
Genere el Portal de trabajo (desplegar la aplicacin web), an cuando este deployment no sea el
primero y el Portal est operando en produccin, como se indica en Despliegue sobre un Servidor
de Aplicacin JEE.
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).
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\Bizagi\Bizagi Studio\MC"
para sistemas de x64 o en "C:\Program Files (x86)\Bizagi\Bizagi Studio\MC" para sistemas de x32).
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.
675
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:
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
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.
676
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.
Utilizar el Export en el ambiente de desarrollo

1. Ejecute el Export.exe.
ste le mostrar la siguiente informacin y opciones:
677
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.
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.
678
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.
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.
679
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.
Esto no realiza ningn cambio a la Base de datos destino.
Permite revisar y decidir si desmarcar o no, cada uno de los

objetos (informacin del sistema) que sern llevados con el
680
Deployment.
6
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.
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
681
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
esperada.
682
registros que sern actualizados.

Este filtro es muy importante, para revisar que efectivamente se
actualice informacin de la 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.

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:
683
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
684
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
685
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
Introduccin
Las tareas de mantenimiento y de administracin son fundamentales en un sistema, principalmente
para garantizar la disponibilidad de la informacin y el funcionamiento adecuado de ese sistema.
Al llevar a cabo las tareas de mantenimiento y de administracin de una manera adecuada, usted
podr maximizar el tiempo de operacin de ese sistema, incluido Bizagi Engine, y velar por un
adecuado desempeo tambin, evitando as interrupciones en el servicio a los usuarios finales de
manera no planeada.
686
Dentro del mantenimiento y de administracin del sistema, existen diferentes tipos de tareas con
diferentes finalidades, como por ejemplo:
Como medida de contingencia, ya sea como parte de la preparacin antes de realizar ciertos
procedimientos, o como parte programada de un plan mayor (p.e plan de continuidad de negocio
corporativo o de recuperacin de desastres).
Como medida de afinamiento para velar por el correcto funcionamiento y adecuado desempeo del
sistema.
Como parte del monitoreo recomendado que usted debe realizar para anticiparse a una
eventualidad de la mejor manera.
Como parte del mantenimiento de Bizagi Engine como producto, contemplando las actualizaciones
de versin.
Una vez que su proyecto haya sido desplegado en el ambiente de produccin, asegrese de tener un
plan y de considerar las siguientes tareas para asegurar un funcionamiento y administracin adecuada
del Sistema Bizagi.
Tareas
Considere las siguientes tareas dentro de su plan de mantenimiento y administracin.
1. Respaldar Bizagi
Es muy importante que siempre cuente con respaldos de Bizagi, de manera que pueda restaurarlo,
apoyndose en los respaldos como medida de contingencia ante eventos no planeados.
Considere los componentes relevantes que se deben respaldar, como se describe en Respaldar Bizagi.
2. Monitorear la plataforma, los servicios y otros elementos de la

infraestructura
Es muy importante siempre monitorear la infraestructura y plataforma que soporta los servicios de
Bizagi (los servidores involucrados y otros servicios integrados al sistema), e igualmente monitorear el
desempeo de los servicios propios de Bizagi.
Para ms informacin sobre las recomendaciones para estas tareas, consulte Monitoreo de servidores.
3. Realizar mantenimiento a la base de datos

Es muy importante estar afinando constantemente la base de datos.
Adicionalmente, al llevar a cabo tareas de monitoreo sobre su base de datos (y su desempeo),
igualmente se podrn detectar los aspectos por optimizar.
687
Para ms informacin sobre las recomendaciones para estas tareas, consulte Mantenimiento de la
base de datos.
4. Administrar los parmetros de ambiente y la integracin con otros sistemas

En cualquier momento se pueden revisar los parmetros y variables que afectan o intervienen con los
procesos de Bizagi.
Es importante garantizar que las notificaciones, puntos de integracin y otros aspectos particulares de
la implementacin como tal, mantengan un ptimo funcionamiento y desempeo.
Dentro de los parmetros de ambiente que se administran, asegrese de que la configuracin de
negocio est correctamente configurada y que la configuracin relacionada a la conexin con otros
sistemas integrados (ya sea por medio de servicios Web, Conector SAP, autenticacin LDAP,
repositorios ECM, servidor LDAP, o bases de datos conectadas por medio de Virtualizacin y
Replicacin de datos), sea igualmente acertada.
Para ms informacin acerca de la revisin y administracin de estos parmetros en Bizagi, consulte la
Configuracin de entorno.
5. 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 versin de Bizagi, como
se describe en Actualizacin de Bizagi.
Respaldar Bizagi
Introduccin
Para Bizagi Engine, de manera similar que con cualquier sistema, los respaldos proveen la posibilidad
de:
Revertir a un estado previo el sistema, a manera de rollback de ciertos cambios, en el menor tiempo
posible.
Tener la posibilidad de usar un punto de restauracin dentro de un plan de contingencia (para estar
preparado ante un evento no planeado que afecte la operacin).
Por estos motivos, respaldar Bizagi es una tarea importante dentro del mantenimiento y administracin
del sistema. Para mayor informacin sobre otras tareas relacionadas, consulte Mantenimiento y
administracin.
Lineamientos
Respaldar Bizagi Engine se lleva a cabo considerando tanto la informacin en la base de datos, como
los adjuntos y archivos de otros componentes, teniendo en cuenta diferentes aspectos para cada
elemento a respaldar.
1. Crear backups de la base de datos de manera frecuente

Para Bizagi Engine, los archivos backup de la base de datos son el elemento principal que deber
respaldar para medidas de contingencia, por lo que deber crearlos frecuentemente.
688
Depender de usted, definir la frecuencia con la que se creen estos backups de base de datos, donde
a mayor frecuencia se tendr la posibilidad de perder la menor cantidad de informacin posible ante
una eventualidad o desastre.
Se recomienda crear backups de la base de datos diariamente como mnimo, sin embargo de
acuerdo a su anlisis y dimensionamiento del proyecto o directrices corporativas, usted podr optar
por crearlos con mayor frecuencia.
Estos podrn ser creados automticamente y programados fcilmente mediante las herramientas y
ayudas del motor de base de datos mismo.
Se recomienda crear backups adicionales antes de realizar un procedimiento que implique cambios
importantes sobre la base de datos.
Si usted va a realizar un deployment de nuevos procesos y versiones, si va a actualizar la versin de
Bizagi, o si va a realizar cambios en la implementacin que ameriten una verificacin posterior, siempre
es buena idea contar con un backup previo como punto de restauracin en caso de que los resultados
de esos cambios no sean los esperados.
Para mayor infromacin sobre cmo crear backups de manera manual, consulte Backups de base de
datos.
2. Crear backups de los dems componentes, considerando la frecuencia con la

que stos cambian
De manera adicional a la base de datos, en el Sistema Bizagi se deben crear backups que contemplen
los dems componentes de la solucin:
Archivos del Portal de trabajo (la aplicacin Web) y archivos del Programador (Scheduler).
Se recomienda crear un backup inicial de estos archivos tan pronto se realice la puesta en marcha.
Despus, los backups se justo antes de realizar cualquier cambio posteriormente sobre ellos.
Se pueden crear backups de los archivos antes de procedimientos que los modifiquen, como por
ejemplo el cambio de versin de Bizagi o al aplicar fixes (Bizagi no genera cdigo por lo que estos
archivos no cambiarn o crecern diariamente bajo la operacin normal de los procesos).
Para mayor informacin sobre cmo crear backups de estos archivos, consulte Backups del Portal de
trabajo y Programador.
Adjuntos de los casos (archivos y documentos asociados a los procesos).
Por defecto, los adjuntos de los casos no se almacenan directamente en la base de datos, sino que de
manera aparte en un sistema ECM o servidor de archivos.
Asegrese de crear backups de los archivos adjuntos a los casos, sea si son almacenados en un ECM u
en un servidor de archivos:
o Si su proyecto almacena estos adjuntos en un sistema ECM externo, entonces deber considerar
estos archivos dentro de las polticas de backup de su empresa y de su sistema ECM.
o Si por el contrario, su proyecto almacena estos adjuntos en un servidor de archivos (el
comportamiento por defecto), entonces para crear backups bastar con crear una copia de la
carpeta principal (por defecto llamada Docs) en otra ubicacin segura, por ejemplo en dispositivos
externos o en la nube.
Se recomienda crear backups de estos adjuntos, en la misma frecuencia en que se creen backups de la
base de datos.
689
Los archivos y documentos adjuntos a los casos (instancias de Procesos) se almacenan por defecto
en el mismo Servidor BPM (bajo la ruta C:\BizAgi\Projects\[su_proyecto]\Docs\).
Sin embargo, se recomienda definir una ubicacin para almacenar los adjuntos, que sea diferente al
Servidor BPM. Esta ruta de almacenamiento est definida por la configuracin del parmetro upload
path en caso de usar un servidor de archivos y no un ECM.
Aunque este valor puede ser cambiado en cualquier momento, tenga presente que debe mover la
estructura existente a la nueva ubicacin, si realiza un cambio de valor usando un servidor de
archivos.
Backups de base de datos

Tenga presente que se recomienda realizar backups de base de datos, bajo los lineamientos
mencionados en Respaldar Bizagi.
Para ms informacin acerca de cmo crear backups (archivos de respaldo) o cmo restaurar los
mismos, siga las secciones de acuerdo al motor de base de datos qu utiliza 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 .
690
Backups y su restauracin en SQL Server
Introduccin
Como parte de las tareas de mantenimiento y de administracin frecuentes, es fundamental la creacin
de backups para contar con la posibilidad de restaurar a un estado anterior un proyecto Bizagi, ante
una eventualidad.
La restauracin a un estado anterior es muy sencillo dado que Bizagi es orientado al modelo y los
datos.
Para mayor informacin, consulte Mantenimiento y administracin.
Notas importantes
Los backups en este tipo de tareas se crean principalmente como una medida de contingencia.
La restauracin de backups debe usarse slo para mover una base de datos a una nueva ubicacin,
o como medida de contingencia de restauracin a un estado anterior un mismo ambiente.
Es decir que un backup del ambiente de desarrollo slo debe ser restaurado en el ambiente de
desarrollo y un backup del ambiente de produccin solo debe ser restaurado en el ambiente de
produccin.
Para crear ambientes, se debe usar la funcionalidad del Deployment de Bizagi.
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.
Si su proyecto utiliza Oracle, consulte Export e Import de Oracle.
Tenga en cuenta que los adjuntos de los casos no estarn dentro de la informacin del backup.
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.
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).
691
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.
692
2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin Backup... desde las
tareas:
693
3. Especifique que el backup se realice completo (modo FULL).
694
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.
695
4. Haga clic en OK cuando la operacin se haya completado:
696
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.
697
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:
698
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.
699
2. Ubique la Base de datos y d clic derecho sobre sta. Seleccione la opcin de Restaurar -> Base de
datos:
700
3. Especifique que la Base de datos ser restaurada desde un dispositivo.

Navegue hasta seleccionar el archivo .bak de origen:
701
702
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:
703
5. Vaya al tab de Opciones, y marque la opcin de Sobrescritura (Overwrite the existing database).
704
Asegrese de seleccionar el destino de los archivos usados por la Base de datos (.dat y .log).
705
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.
706
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.
707
Export e Import en Oracle
Introduccin
una eventualidad.
La restauracin a un estado anterior es muy sencillo dado que Bizagi es orientado al modelo y los
datos.
Para mayor informacin, consulte Mantenimiento y administracin.
Notas importantes
Los backups en este tipo de tareas se crean principalmente como una medida de contingencia.
La restauracin de backups debe usarse slo para mover una base de datos a una nueva ubicacin,
o como medida de contingencia de restauracin a un estado anterior un mismo ambiente.
Es decir que un backup del ambiente de desarrollo slo debe ser restaurado en el ambiente de
desarrollo y un backup del ambiente de produccin solo debe ser restaurado en el ambiente de
produccin.
Para crear ambientes, se debe usar la funcionalidad del Deployment de Bizagi.
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 de Datapump.
Si su proyecto utiliza SQL Server, consulte Backups y su restauracin en SQL Server.
Tenga en cuenta que los adjuntos de los casos no estarn dentro de la informacin del backup.
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.
708
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.
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:
709
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.
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:
710
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:
711
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=%
712
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).
713
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.
714
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).
715
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:
716
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.
717
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.
718
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:
Backups del Portal de trabajo y Programador
Introduccin
719
una eventualidad.
Adems de backups a la base de datos, es importante contar con un backup de los componentes de
Bizagi como lo son el Portal de trabajo y el servicio Programador.
Aparte del backup inicial de estos componentes, se recomienda crear backups de los mismos antes de
procedimientos que los modifiquen por ejemplo el cambio de versin de Bizagi o al aplicar fixes
(Bizagi no genera cdigo por lo que estos archivos no cambiarn o crecern diariamente bajo la
operacin normal de los procesos).
Para mayor informacin, consulte Respaldar Bizagi.
Backups del Portal de trabajo y del Programador

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 el servicio Programador (Scheduler).
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 .NET, deber copiar las carpetas (y su contenido) del
Servidor BPM donde estn instalados estos servicios.
Las rutas son:
Portal de trabajo: 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\
720
Contemple respaldar adicionalmente:

Los adjuntos de los casos, que por defecto quedan almacenados en la carpeta Docs si no estn
integrados a un ECM y si usted no usa un servidor de archivos aparte.
Recuerde que los adjuntos de los casos deben ser respaldados con una mayor frecuencia que los
archivos del Portal de trabajo y el Programador (idealmente bajo la misma frecuencia con la que se
respalda la base de datos).
Otros componentes y archivos que hagan parte de las personalizaciones en su implementacin.
Como por ejemplo, ensamblados .dll adicionales, hojas de estilo personalizadas, etc, u otros
componentes que usted considere necesarios.
Si su proyecto se ejecuta sobre una plataforma JEE, usted deber crear un respaldo del archivo .ear
generado (el que se despliega en su servidor de aplicaciones).
Tambin deber crear respaldos de archivos de configuracin adicionales, principalmente los usados
por Bizagi Engine en su <BIZAGI_HOME>.
Monitoreo
El monitoreo es una tarea fundamental dentro del marco del mantenimiento y administracin del
sistema.
Para mayor informacin sobre tareas relacionadas, consulte Mantenimiento y administracin.
Dentro del monitoreo, considere tambin todos los activos relevantes que proveen servicios a su
721
sistema Bizagi, de manera que pueda velar por una operacin adecuada de la solucin BPM completa.
Esto significa que deber monitorear constantemente: La plataforma base de Bizagi (los servidores y
otros servicios integrados a su solucin, incluyendo especialmente el motor de base de datos), otros
elementos crticos de la infraestructura (como por ejemplo la red), y la operacin y rendimiento de los
servicios de Bizagi.
Para mayor informacin sobre los lineamientos para esta tarea, consulte las siguientes sub-secciones:
Monitoreo de la infraestructura y de plataforma.
Monitoreo de los servicios.
Monitoreo de infraestructura y plataforma
Introduccin
Una tarea muy importante en el mantenimiento y administracin del Sistema Bizagi, es monitorear la
infraestructura y plataforma la cul soporta la ejecucin de Bizagi Engine.
El administrador de plataforma deber mantenerse alerta a cambios significativos o anormalidades en
el comportamiento o rendimiento del sistema, y estar a cargo de tomar las medidas necesarias dado
el caso.
Servicios de la infraestructura o plataforma que se deben monitorear, incluyen los servidores sobre los
cules se ejecutan los componentes de Bizagi, y tambin otros activos y servicios de infraestructura
que hacen parte de la arquitectura del sistema, y que estn inmersos en la solucin, como por ejemplo
el almacenamiento o la red.
Un monitoreo proactivo y adecuado, le permitir detectar aquellos puntos dnde potencialmente hay
aspectos por resolver, o cuellos de botella.
Los siguientes lineamientos proveen un punto de partida as como tambin recomendaciones tiles
para las tareas de monitoreo y diagnstico de infraestructura y plataforma.
Sin embargo, estos lineamientos no abarcan extensivamente todas las tareas que un administrador
de plataforma debe realizar para estos propsitos, ni para labores de mantenimiento (la
informacin siguiente es enunciativa y no exhaustiva).
Monitoreo de la infraestructura
Se recomienda monitorear de manera permanente, la correcta operacin y rendimiento de los activos
y servicios de infraestructura crticos.
Para un sistema Bizagi, los siguientes aspectos son especialmente importantes:
1. Rendimiento del repositorio de datos fsico (la SAN).

En una implementacin tpica corporativa, las bases de datos, archivos, mquinas virtuales y otros
activos de infraestructura, se encuentran en un repositorio separado de los servidores fsicos y
compartidos entre diferentes servidores y otros dispositivos de cmputo.
Si este es su caso, consulte la documentacin de su proveedor para determinar los procedimientos
adecuados de monitoreo y las recomendaciones para mantener un rendimiento ptimo en la SAN.
Cuando el almacenamiento de la base de datos se presenta al sistema operativo como un volumen, en
722
el caso de Windows, es posible usar Windows Performance Monitor para identificar potenciales
inconvenientes de rendimiento all.
Las mejores prcticas para el anlisis del rendimiento del repositorio se encuentra documentado por
Microsoft como proveedor.
Para mayor informacin, consulte http://blogs.technet.com/b/askcore/archive/2012/02/07/measuringdisk-latency-with-windows-performance-monitor-perfmon.aspx
2. Latencia entre los servidores de base de datos y la SAN.

El monitoreo de la latencia de disco fsica puede ser llevado a cabo mediante comandos especficos
que provee el fabricante del motor de base de datos.
Por ejemplo, a travs del uso de sys.dm_io_virtual_file_stats (que es un Transact-SQL que provee SQL
Server), se puede tener la medicin.
Para mayor informacin sobre este comando, consulte https://msdn.microsoft.com/en-us/library/
ms190326.aspx).
Dado que la informacin que se retorna no es trivial de comprender, se recomienda un anlisis
detallado para tener claro lo que sucede con cada base de datos.
Por ejemplo, se puede consultar este enlace http://www.sqlskills.com/blogs/paul/how-to-examine-iosubsystem-latencies-from-within-sql-server/ que provee un script que permite una mejor lectura de los
resultados (de la latencia I/O en el subsistema).
Para bases de datos Oracle, usted podr apoyarse en el uso de Oracle Enterprise Manager para
monitorear este tipo de aspectos.
Para mayor informacin, consulte las opciones de monitoreo de operaciones I/O como por ejemplo
las que se ensean en https://docs.oracle.com/cd/B28359_01/server.111/b28275/
tdppt_realtime.htm#CHDCCFDG.
3. Latencia entre los servidores BPM y los de base de datos.

Dado que Bizagi es una aplicacin intensiva en el acceso a datos, usted deber considerar las
siguientes mediciones recomendadas en la conexin de red entre los servidores BPM y los de base de
datos:
Latencia baja: La red debe tener en promedio una latencia de 0,15 ms. En instalaciones corporativas,
una latencia baja usualmente se logra con los servidores BPM y los de base de datos en el mismo
segmento de red e involucrando un switch.
El monitoreo de la latencia entre el servidor BPM y los de base de datos se puede medir a travs de
un comando PING desde la consola.
Ancho de banda adecuado: El ancho de banda recomendado es de por lo menos 10,000 kb en
64ms, de acuerdo a los resultados presentados cuando se invoca el siguiente servicio REST de
Bizagi:
http://[BPM_Server]/[Work_Portal_Site]/Rest/SystemUtilities/Diagnostics/
Database/DatabaseBenchmark
Usted podr invocar este servicio usando el navegador, asegurndose de usar los valores
correspondientes para [BPM_Server] y [Work_Portal_Site].
723
4. Conexin entre los dispositivos cliente y los servidores BPM.

Especialmente para la red corporativa en sus instalaciones (o una VPN), el monitoreo de la red (en
este caso, el ancho de banda) entre el servidor BPM y los dispositivos clientes, puede medirse a travs
de un comando PING desde la consola.
5. Otros servicios.
Recuerde que debe monitorear otros servicios que son externos a Bizagi, pero que estn integrados a
la solucin.
Esto incluye el ESB u otros sistemas que expongan servicios web, o repositorio de datos a Bizagi, o
servicios como el del servidor de correos corporativo, servidores de archivos o repositorios del ECM,
como tambin, cualquier otro sistema o repositorio que se use para la autenticacin (p.e el Directorio
Activo), o dispositivos adicionales como firewalls o el balanceador de cargas.
Tenga en cuenta que estos servicios deben estar operando, y que Bizagi debe contar con acceso
autorizado cuando aplique (a los que se Bizagi necesite acceder).
Monitoreo de la plataforma
Para monitorear la plataforma sobre la cual los componentes de Bizagi Engine se ejecutan, puede
apoyarse en los contadores de rendimiento usuales del sistema operativo.
Para realizar chequeos de la salud del servidor (health checks) o medir y monitorear de manera
constante el rendimiento de la plataforma de los servidores BPM, se recomienda usar estos
contadores (adems de otros adicionales que usted considere apropiados):
Processor\% Processor Time: Se refiere al porcentaje en promedio del tiempo de procesador
ocupado. Es un indicador principal para considerar si la capacidad de procesamiento (CPU) en el
servidor IIS es suficiente. Se recomienda que este contador debe permanecer con un valor inferior al
85% para que el sistema se encuentre en un estado saludable.
System\Processor Queue Length: La cola de procesamiento que va llenado con hilos cuando los
procesadores del servidor se encuentran ocupados atendiendo otros hilos en ese momento. Si este
contador est usualmente por encima de 2 y el porcentaje de tiempo de procesamiento (%
Processor Time) permanece en niveles altos, entonces se considera que hay un cuello de botella en
el sistema.
Memory\Available Mbytes: Se refiere a la cantidad de memoria fsica (medida en MBytes) del
sistema que puede ser usada por nuevos procesos. Si la memoria libre es igual o mayor que el 50%,
entonces el sistema se considera en un estado saludable. Un valor de 25% o menor de memoria
libre, sugiere un potencial problema. Un valor por debajo del10%, entonces debe revisarse la
condicin de manera cuidadosa y seguramente tomar acciones con las precauciones debidas. Un
valor menor al 5% impactar de manera negativa al desempeo del sistema.
Memory\Pages/sec: Se refiere a la cantidad de solicitudes de lectura y escritura de la memoria al
disco. Si este valor permanece alto y la cantidad de Mbytes disponibles es menor al 10%, entonces
724
el subsistema relacionado a la memoria se considera un cuello de botella. Menos de 500 Pages/sec

se considera normal, ms de 500 puede resultar impactando el rendimiento.
Network Interface\Bytes Total/sec : Se refiere a la cantidad total de bytes tanto enviados como
recibidos sobre la red. Si el valor de este contador es usualmente mayor que 80%, entonces es
posible que se deba instalar otra NIC de mayores capacidades en el servidor.
Asegrese que todos sus servidores cuenten con suficiente espacio disponible de disco.
La cantidad adecuada de espacio libre en disco depender de las caractersticas de su
implementacin (dadas por el anlisis del dimensionamiento en particular), y de la arquitectura de
sistema que involucre.
Sea para los servidores de base de datos, los servidores BPM, o para cualquier servidor de archivo
usado en el almacenamiento de adjuntos de documentos, cuando el espacio en disco usado est
cerca de la capacidad, usted deber tomar las medidas adecuadas.
Ejecutar los servidores con una cantidad inapropiada de espacio puede resultar en problemas de
rendimiento y comportamientos no esperados por parte del sistema operativo en s.
Adems de lo anterior, considere tambin: Paging file (% de uso), Physical disk (% tiempo de disco),
or Logical disk (% tiempo de procesador).
Como buena prctica, adems de trazas de auditoria o de actualizaciones (p.e service packs), tenga
en cuenta que los cambios importantes en general deben ser registrados en la hoja de vida del
servidor (fecha de cambio vs el cambio).
Monitoreo de los servicios
Introduccin
Recomendamos al administrador de la plataforma, monitorear los servicios de Bizagi tanto de su
componente web (el Portal de trabajo) como del servicio Programado.
Ambos debern encontrarse operando en todo momento y bajo un ptimo desempeo.
Un monitoreo proactivo y adecuado, le permitir detectar aquellos puntos dnde potencialmente hay
aspectos por resolver, o cuellos de botella.
Monitoreo del servidor de aplicacin/web

En los servidores BPM, y ya sea si se utiliza WebSphere, Weblogic, JBoss o IIS, asegrese de
monitorear de manera constante el servicio mismo del servidor de aplicacin/web.
Para ello, puede apoyarse en los logs respectivos. La siguiente tabla ilustra los logs tpicos para hacer
seguimientos (o adicionales segn instrucciones propias del fabricante):
SERVIDO
R
LOG
RUTA
725
WebSphe
re
SystemErr.log, SystemOut.log,
StartServer.log, y
StopServer.log
<WEBSPHERE_HOME>\profiles\[NodeName]\logs
\server1
Weblogic
AdminServer.log,
[su_domino_Weblogic].log
<WEBLOGIC_HOME>\user_projects\domains\[DOMAIN]
\servers\log
[NodeName].log,
[NodeName].out,
para instalaciones de clster
horizontal
<WEBLOGIC_HOME>\user_projects\domains\[DOMAIN]
\servers\[NodeName]\log
JBoss
Server.log
<JBOSS_HOME>\standalone\log
IIS
Logs registrados por el visor

de eventos
C:\inetpub\logs
Adems de lo anterior, monitoree los eventos que Bizagi registra ante sucesos importantes.
Por ejemplo, en sistemas operativos Windows, podr apoyarse en el Visor de eventos de Windows
(eventvwr).
En servidores de aplicacin JEE, monitoree los logs del servicio y tenga en cuenta los logs de tipo
FFDC.
Acerca de las Actividades Asncronas

Tambin deber monitorear cmo se procesan las Actividades Asncronas de Bizagi.
Recuerde que stas podrn ser procesadas en un segundo plano, e involucrando diversos reintentos
(por ejemplo, tpicamente debido a que una interfaz externa se encuentre fuera de servicio).
Si su proyecto se apoya significativamente en el uso de Actividades Asncronas, se recomienda vigilar
de cerca su ejecucin adecuada.
En plataformas JEE, este tipo de actividades se manejan directamente por los recursos JMS dentro del
servidor de aplicaciones JEE como tal.
Tanto para JEE como para .NET, tambin se recomienda apoyarse en la opcin de administracin que
el Portal de trabajo presenta para este fin, llamada la Consola de Actividades Asncronas.
Esta consola lista aquellas actividades que estn pendientes por ejecutarse (debido a un intento fallido
anterior).
Bizagi disponibiliza un log adicional que se recomienda monitorear, el cual registra aquellos
servicios externos que no responden, o que lo hacen sobre un marco de tiempo alargado.
Esto significa que cuando Bizagi invoca servicios web externos, se registra una entrada en un archivo
.csv siempre que dicho servicio exceda el umbral predefinido para retornar una respuesta a tiempo
(o, se cumpla el tiempo de espera).
Este archivo se ubica dentro de .\Temporary\SOA\Log\ de la ruta del proyecto (por defecto se crea
un archivo por interfaz de servicio, p.e C:\Bizagi\Projects\[your_project]\Temporary\SOA\Log
726
\[interfaz]Log_1.csv) .
Y, dicho archivo tendr una lnea para cada alerta descrita anteriormente, con el detalle: fecha
(DateTime), descripcin del error (ErrorDescription), idCase, nombre de la tarea (Task_Name), URL,
nombre del mtodo (Method_Name), y tiempo de la interfaz (InterfaceTime)- de la forma
MM:ss:mmm.
Acerca del IIS
Cuando se monitorea explctamente el IIS, se recomienda tener en cuenta el tamao de la cola de

solicitudes directamente all para directamente detectar si hay cuellos de botella en el servidor BPM.
Si se detecta una cantidad en aumento de solicitudes que se encolan en el IIS (donde se implica una
degradacin porque el comportamiento de la cola sea incremental), entonces se debe considerar si se
necesitan nodos adicionales BPM en su configuracin de clster.
Demoras en el procesamiento de solicitudes que no se produzcan por servicios externos (p.e in en
puntos de integracin en Bizagi) o que no sean producidos por la capacidad del servidor de base de
datos de retornar la informacin, sugieren que los servidores BPM deben ser revisados y ajustados (un
escalamiento horizontal de acuerdo a cmo aumente el tamao de la cola).
Archivos de log de los hilos del servidor web proveen detalle adicional, ubicado por defecto en las
carpetas tipo W3SVC dentro de C:\inetpub\logs\LogFiles:
ASPECTOS A MONITOREAR
INTERPRETACIN
727
Archivos de log de los hilos del servidor web.
Estos archivos presentan parmetros que

presentan una medicin en milisegundos:
timedb: El tiempo que toma la base de datos
para entregar la informacin final al servidor
BPM.
timeba: El tiempo que toma el Portal de
trabajo en procesar la solicitud.
La suma de ambos totalizan el tiempo que toma
en procesarse una solicitud por completo, una
vez que se maneja en el IIS (quiere decir que no
incluye el tiempo de espera en cola que pueda
tener una solicitud).
Lo anterior sugiere que a travs de los
contadores de rendimiento del IIS se podr
acotar si las solicitudes aguardan un tiempo no
esperado/deseado en cola.
Recuede que usted podr monitorear el
contador llamado Current queue size (que se
disponibiliza en la clasificacin HTTP Service
Request queue), especficamente para el pool de
aplicaciones que usa Bizagi (por defecto
nombrado como Bizagi 64-Bit ASP.NET v4.0).
Esto permite determinar el comportamiento en
las colas de los servidores BPM.
728
Podr tambien utilizar contadores de rendimiento especficos del IIS (rol de servidor web), como por
ejemplo:
ASP.NET Applications\Requests/Sec: Muestra el rendimiento (en trminos de throughput) de la
aplicacin ASP.NET en el servidor. Debe monitorearse conjuntamente con otros contadores para
poder determinar de la mejor manera si el servidor est procesando las solicitudes de la aplicacin
como se espera.
ASP.NET\Application Restarts: Indica el nmero de reinicios de la aplicacin para determinar el
tiempo real de servicio del servidor. Un valor alto de este indicador debe ser monitoreado con
mayor detalle. Este tipo de contador junto con otros generales, puede ayudarle a identificar si hay
un cuello de botella en el subsistema como tal, o producido en la aplicacin.
ASP.NET\Request Wait Time: Muestra la cantidad de tiempo (en milisegundos) que demor la
solicitud en cola de espera. Idealmente este valor debe ser cercano a 0 ms. Si por el contrario es
mayor a 1000 ms, esto sugerir que el servidor IIS tendr aspectos por revisar/escalar dado que su
rendimiento estar siendo impactado.
ASP.NET\Requests Queued: La cola eventualmente se podr llenar con solicitudes que esperan
poder ser procesadas, por lo que este contador mostrar el nmero de solicitudes que se encolan.
Debe ser monitoreado para esclarecer cuando una aplicacin est siendo abrumada. Por lo tanto,
un anlisis del encolamiento de la aplicacin en conjunto con contadores del servidor, proveern una
ayuda para determinar dnde est la causa.
.NET CLR Memory\# Total Committed Bytes: Muestra la cantidad de memoria virtual reservada para
la aplicacin en el archivo de paginacin. Debe monitorearse conjuntamente con otros contadores
del servidor, para poder determinar si hay problemas de rendimiento. Los problemas pueden ser
causados por una pequea cantidad de memoria ya instalada, o porque una aplicacin est
sobreutilizando la memoria.
729
Web Service\Get Requests/sec: Muestra la cantidad de solicitudes tipo GET que se procesan por
segundo. Si el valor no es ptimo para un servidor de IIS en particular (p.e en comparacin con
otros servidores), entonces el algoritmo de distribucin de cargas del balanceador podr
replantearse para favorecer al servidor en cuestin (asumiendo que los servidores tienen
caractersticas de hardware y software similares, o de lo contrario deber tener en cuenta esas
variables).
Web Service\Post Requests/sec: Muestra la cantidad de solicitudes tipo POST que se procesan por
segundo. Si el valor no es ptimo para un servidor de IIS en particular (p.e en comparacin con
otros servidores), entonces el algoritmo de distribucin de cargas del balanceador podr
replantearse para favorecer al servidor en cuestin (asumiendo que los servidores tienen
caractersticas de hardware y software similares, o de lo contrario deber tener en cuenta esas
variables).
Web Service\Current Connections: Muestra el nmero de conexiones activas con el servicio. Si el
valor no es ptimo para un servidor de IIS en particular (p.e en comparacin con otros servidores),
entonces el algoritmo de distribucin de cargas del balanceador podr replantearse para favorecer
al servidor en cuestin (asumiendo que los servidores tienen caractersticas de hardware y software
similares, o de lo contrario deber tener en cuenta esas variables).
Monitoreo del Programador

El monitoreo del servicio Programador es fundamental para velar por una operacin adecuada de
Bizagi.
Dicho servicio debe estar permanentemente en un estado de ejecucin para que las labores de
mantenimiento de sistema de Bizagi se encuentren al da (p.e, la ejecucin de este servicio no deber
verse interrumpida de manera inesperada).
En plataformas JEE, el Programador se ejecuta como un agente contenido dentro del servicio del
servidor de aplicaciones JEE.
Tenga presente que en algunos casos puede ser til escalar horizontalmente el Programador, de
manera que se cuente con mltiples instancias ejecutndose en paralelo (involucrando los nodos
que sean necesarios).
Esto se realiza con el fin de distribuir el procesamiento involucrado en las tareas que son llevadas a
cabo por el Programador, que son principalmente:
Importar o sincronizar los usuarios contra un repositorio LDAP.
Importar o sincronizar la informacin de entidades paramtricas, va la Replicacin de datos de
Bizagi.
Ejecutar las Actividades Asncronas y sus reintentos.
Ejecutar los trabajos personalizados.
Enviar alarmas u otras notificaciones especficas.
Otras, como por ejemplo activar los temporizadores u otros patrones/eventos que impliquen una
demora programada.
Por lo tanto y de acuerdo al dimensionamiento de su proyecto, producto del monitoreo pro-activo,
o debido a otras caractersticas de su proyecto, evale si el uso de instancias adicionales del
Programador proveer una ayuda para su sistema.
Ntese que el mantenimiento del sistema de Bizagi lo realiza tambin el Programador, sin embargo
y en un clster, esta labor la realiza la instancia maestra y no se distribuye por medio de un
730
balanceo de cargas.
De ocurrir algn error o comportamiento no esperado, Bizagi lo registrar en el log del servidor (p.e
en un sistema operativo Windows, en el Visor de eventos).
Aspectos adicionales a monitorear son:
ASPECTOS A MONITOREAR
La ejecucin de tareas por parte del servicio
Programador de Bizagi
INTERPRETACIN
Una tendencia incremental en la creacin de
tareas que deben ser ejecutadas por el
Programador, contrastada con la capacidad
actual del Programador para procesarlas,
sugerir que debe revisarse la configuracin del
mismo.
Al observar un incremento en las tareas que
deben ser ejecutadas por el Programador y que
se encolan, se debe considerar si se necesitan
instancias adicionales del servicio Programador.
Notas importantes sobre la base de datos

Es muy importante realizar un monitoreo en el motor de la base de datos para poder asegurar su
adecuada operacin y que pueda realizar consultas bajo el rendimiento esperado.
Al monitorear la base de datos y su rendimiento, usted podr determinar si se requiere el
escalamiento vertical de los servidores involucrados (o escalamiento horizontal en caso de usar un
esquema de clster activo-activo, como en el caso de Oracle RAC).
Para mayor informacin sobre los lineamientos tanto de monitoreo como de mantenimiento para la
base de datos, consulte Mantenimiento de la base de datos.
Adicionalmente, asegrese de que en la base de datos especfica de su proyecto, se encuentre el
usuario interno del sistema Bizagi (domain\admon) de manera activa y habilitado.
Mantenimiento de la base de datos
Introduccin
Una tarea muy importante en el mantenimiento y administracin del Sistema Bizagi, es realizar un
mantenimiento constante a la base de datos, de manera que se pueda velar por el correcto
funcionamiento y ptimo desempeo del sistema.
Tenga en cuenta que cada motor de base de datos (SQL Server u Oracle) ofrece las herramientas
necesarias para realizar monitoreo pro-activo, diagnsticos (herramientas de perfilamiento), o
acciones de afinamiento sobre la base de datos.
Lineamientos para el monitoreo y afinamiento

Recomendamos al DBA lo siguiente:
731
1. Ejecute un monitoreo contnuo sobre el rendimiento de la base de datos.

Ntese que los motores de bases de datos en s, proveen las herramientas especializadas que
permiten un monitoreo, ejecutar diagnsticos e interpretar resultados para el posterior afinamiento
(adems de archivos de log correspondientes).
A travs del monitoreo proactivo, usted puede anticiparse a una situacin no deseable (table scans,
bloqueos o demoras, etc), y evidenciar aspectos que requieren de afinamiento.
Por ejemplo, la deteccin de un table scan sugerir que las consultas/estadsticas no estn al da de
manera ptima, o que se necesita mantener los ndices (crear nuevos o redefinir los existentes).
Si el DBA detecta que el motor de base de datos no cuenta con un ptimo desempeo (no ejecuta las
consultas bajo buenos tiempos de respuesta), recuerde que podr escalar verticalmente la base de
datos en cualquier momento (o escalar horizontalmente si se utiliza un esquema de clster activoactivo como Oracle RAC).
2. Lleve a cabo un afinamiento de manera peridica, y siguiendo mejores

prcticas.
Para procesos en los que se espera la produccin de una gran cantidad de casos, o gran cantidad de
actividades por da, el afinamiento de la base de datos se recomienda como mnimo de manera
semanal.
Las mejores prcticas incluyen que el afinamiento se realice en horarios no laborales, y de manera
planeada (considerando que estas tareas pueden tomar un tiempo significativo), al igual que otras
recomendaciones que sean instruidas por el fabricante del motor de la base de datos.
Los principales aspectos sujetos al afinamiento son:
Verificar la integridad de la base de datos.
Actualizar las estadsticas
Reorganizar y mantener los ndices actualizados (recrear los que estn altamente fragmentados o
reorganizarlos de acuerdo al orden las columnas consultadas -especialmente para ndices
compuestos).
Reducir la base de datos (shrinks).
Monitorear los filegroups, de manera que su configuracin (tamao, incremento, tamao mximo,
volumen de disco usado, etc) sea la adecuada de acuerdo a su comportamiento de crecimiento.
Dependiendo de las caractersticas de hardware en sus nodos de base de datos (p.e el nmero de
discos duros, nmero de procesadores y cores), podr configurar los data files y archivos de log de
manera ptimizada (escalar estos archivos).
Por ejemplo y de acuerdo a lo anterior, usted podra decidir beneficiarse de las operaciones de
entrada y salida de disco en paralelo (I/O) al contar con mltiples volmenes de datos si decide
separar los data files y filegroups (ubicando los archivos de log, o tempdb en su propio volumen, o
incluso un data file dedicado con las tablas transaccionales ms usadas -en un volumen con mejor
velocidad).
Sobre tempdb, se recomienda configurarlo con mltiples data files y filegroups, que tengan un tamao
predefinido (todos homogneamente) y evitando el crecimiento automtico (auto-growth). As se
podr usar un data file por CPU/core.
Al realizar la configuracin del tamao predefinido, considere recomendaciones como: Deshabilitar el
crecimiento automtico (auto-growth) en los data files, hacer que los data file y los archivos de log no
usen ms del 90% del espacio disponible en disco, hacer que los archivos de log tengan el doble del
tamao de un nico data file, y permitir el crecimiento automtico (auto-growth) para el archivo de log
file a cierto tamao dado.
Dentro del modelo de datos de Bizagi, considere prestar especial atencin al comportamiento de las
732
siguientes tablas:
(adems de cualquier otras del negocio que se detecten crezcan rpidamente).
Aquellas relacionadas al almacenamiento diario de trabajo como: Workitem, Workitemcl, Wfcase, y
Wfcasecl.
Otras similares adicionales, que dependen de qu tanto se usen en su proyecto como:
Asynchwiretry y Asynchworkitem.
Aquellas almacenando logs como: AttribLog, EntityLog, Wistatelog, Transitionlog, Factlog,
Casestatelog, Authlog, Attribcharlog, Assignationlog, Joblog (especialmente cuando su proyecto
involucra frecuentemente los trabajos), Alarmjobrecipientlog (especialmente cuando su proyecto
involucra frecuentemente las alarmas), Wfcaseabortreason (especialmente cuando en su proyecto se
aboirtan casos frecuentemente de manera manual) y Reassignlog (especialmente cuando en su
proyecto se realizan reasignaciones frecuentemente de manera manual).
Ntese que tambin se puede optar por separar estas tablas de log en un filegroup aparte.
Adicional a lo anterior, incluya en sus planes de afinamiento, las tablas del negocio que esperan
almacenar una gran cantidad de informacin.
De acuerdo a lo observado, podr revisar cmo est fragmentada la informacin (p.e, los filegroups
en SQL Server o los tablespaces en Oracle).
Recuerde realizar el afinamiento de base de datos despus de ejecutar acciones de mantenimiento

de Bizagi (p.e las realizadas por el Programador, u otras opciones desde utilitarios adicionales
como Archiving).
3. Asegrese de contar con la configuracin adecuada de concurrencia en SQL

Server.
Realice monitoreo sobre la configuracin requerida para que la base de datos de Bizagi maneje
concurrencia.
Esto implica verificar que la base de datos de Bizagi tenga habilitado el modo snapshot isolation.
Especficamente:
Allow Snapshot isolation: True (ALLOW_SNAPSHOT_ISOLATION ON)
Is Read-committed snapshot isolation on: True (READ_COMMITTED_SNAPSHOT ON)
Ntese que al utilizar los niveles descritos anteriores de snapshot isolation, se vuelve an ms
importante que incremente los recursos y refuerce las mejores prcticas para la base de datos tempdb
(p.e, el uso de un volumen propio que garantice velocidades ptimas en operaciones I/O).
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).
Deber llevar a cabo las tareas de afinamiento adicionales que promueva el fabricante del motor de
base de datos por s, y tal como sean identificadas por el uso de las herramientas especializadas
733
(de lo observado en trazas y logs).
4. Asegrese que el usuario de sistema se encuentre habilitado.

Recuerde que el usuario domain\admon es el usuario del sistema que emplea internamente Bizagi
(creado por defecto).
No se podr deshabilitar este usuario dado que es necesario para realizar tareas automticas como
temporizadores o tareas programadas, y se recomienda revisar que este usuario est siempre
habilitado en la base de datos.
Habiendo dicho lo anterior, ntese que se recomienda enfticamente editar la configuracin del
usuario para que no tenga acceso de administrador en el Portal de trabajo.
Para ello, podr excluir al usuario de la lista de usuarios permitidos en las opciones de administracin
(p.e, que este usuario no tenga permisos para administrar usuarios, modificar entidades de
parametrizacin, abortar casos, etc).
Recomendaciones bsicas al
(perfilamiento)
ejecutar
tareas
de
diagnstico
Cuando se lleven tareas enfocadas al diagnstico y seguimiento de un problema especfico, y se desee

usar un perfilamiento, considere estos lineamientos:
1. No ejecutar el perfilamiento (profiler) desde el mismo servidor de base de datos.
2. De manera similar y cuando aplique, ejecute un perfilamiento 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, podr
considerar primero un muestreo para evitar afectar el rendimiento del servidor.
3. Siempre incluya filtros en el perfilamiento.
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
nmero de registros afectados es muy alto.
Notas adicionales
Tenga en cuenta que adems del afinamiento y monitoreo a la base de datos, usted tambin deber
considerar las tareas de monitoreo sobre otros aspectos relacionados que interfieren en el
734
funcionamiento adecuado de la base de datos (p.e configuracin del dominio si son parte de una
configuracin en clster, la red entre sus servidores de base de datos y otros elementos de la
arquitectura del sistema como por ejemplo la SAN o el mismo servidor BPM).
Para mayor informacin consulte Monitoreo.
Tenga en cuenta que 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.
Mejores prcticas en ambientes de produccin
Introduccin
Produccin es el ambiente en el que los procesos de negocio se ponen en funcionamiento por los
usuarios finales. En este ambiente, sus procesos deben trabajar lo mejor posible para evitar
interrupciones, garantizar la precisin y disponibilidad de la informacin y proporcionar una mejor
experiencia de usuario. Aqu hay algunas recomendaciones que hay que tener en cuenta para
garantizar un funcionamiento correcto de sus procesos en el ambiente de produccin:
1. Optimice el rendimiento
2. No afecte a los usuarios finales cuando realice tareas de mantenimiento
3. Mejora continua
1. Optimice el rendimiento
Apague las trazas
Al configurar su entorno de produccin, asegrese de que las trazas de Bizagi estn desactivadas.
Las trazas proporcionan una medida de seguimiento de los incidentes (si se presentan) y por lo tanto,
stas deben ser activadas slo cuando sea necesario. Tener estos logs y trazas deshabilitados
proporcionar un mejor rendimiento. No se recomiendan las trazas en el ambiente de produccin ya
que los registros pueden crecer mucho creando de problemas de rendimiento.
Si necesita trazas en Produccin djelas en los componentes que necesita y apague todos los dems.
Evite el uso de mquinas virtuales para bases de datos

Al configurar su ambiente de produccin, se recomienda utilizar una mquina real como el servidor de
base de datos. Del mismo modo, debe asegurarse de que est garantizada una conexin rpida entre
el servidor de BPM y el servidor de base de datos. Usando una mquina virtual puede no presentar un
rendimiento ptimo (puede no proveer una velocidad de disco apropiada, entre otras variables).
2. No afecte a los usuarios finales cuando realice tareas de

mantenimiento
735
Sincronice el LDAP en horas no laborables

Cuando se utiliza la sincronizacin del LDAP para importar usuarios en Bizagi, asegrese de que el
servidor LDAP responde de manera oportuna. Toda la configuracin debe realizarse fuera de las horas
de trabajo o en un momento de menor rendimiento (especialmente cuando se sincronizan ms de
1.000 usuarios).
Siempre debe usar: filtros adecuados en la configuracin de la sincronizacin LDAP y, como una buena
prctica, programar esta sincronizacin en horas no laborables. Al programar este trabajo, asegrese
de realizar el seguimiento que se haya completado de acuerdo con un umbral esperado (antes de que
comiencen las horas laborables).
Otras tareas de mantenimiento, en horas no laborables

De manera similar, la realizacin de otras tareas de mantenimiento debe darse dentro de un marco de
tiempo apropiado que no afecte las horas ms crticas y laborables del sistema. Dentro de estas
tareas se incluyen: deployments de procesos, actualizaciones a nuevas versiones, afinamiento en la
base de datos, actualizaciones en la plataforma (y parches), un archiving de informacin, etc.
3. Mejora continua
La mejora continua es una parte clave de la evolucin de Bizagi para el cliente. Hay 2 tipos de mejoras:
Cambios menores que no afectan el flujo de trabajo o un cambio en el modelo de datos que no
afecte la lgica del proceso
Cambios que afectan los flujos de trabajo o cambios que afecten a la lgica del proceso.
Acciones:
Nueva versin del proceso:
o Recomendacin: Cree una nueva versin del proceso
produccin y no est seguro de cmo afectarn los
ejecutan en el ambiente de produccin.
si ya ha sido desplegado en el ambiente de

nuevos cambios a los casos actuales que se
si cambia el flujo de trabajo.
si cambia el modelo de datos.
Nueva versin de la forma:

o Recomendacin: Cree una nueva versin de las formas si el modelo de datos cambia y se
requieren nuevos datos.
o Recomendacin: Cree una nueva versin de las formas si cambian las reglas que usan los datos
de la forma.
No cree nuevas versiones del proceso o de las formas, si los cambios se consideran de menor
importancia y est seguro de que dichos cambios no crear efectos secundarios en los casos que se
ejecutan en el ambiente de produccin.
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
736
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).
737
Interfaz de usuario
Al abrir Bizagi Management Console, la ventana inicial provee atajos para las opciones ms usadas:
738
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
739
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.
Seguimiento
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
740
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).
741
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.
742
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.
743
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
744
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.
Volver a crear desde la base de datos
Introduccin
Esta opcin permite crear de nuevo un ambiente de produccin ejecutable en su servidor BPM; a partir
de una base de datos existente.
Con ella, Bizagi crear de manera automtica el Portal de Trabajo y el servicio Programador sobre una
plataforma de .NET (usando IIS).
Esta opcin es til especialmente para planes de continuidad de negocio, por ejemplo cuando por
algn factor externo se imposibilit el uso o recuperacin del servidor BPM (la configuracin de los
componentes Programador y Portal de Trabajo), pero an se cuenta con el servicio de la base de
datos o un backup (archivo de respaldo) de ella.
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.
Antes de comenzar
Si usted no cuenta con el servicio de base de datos disponible y ejecutndose al momento de usar
esta opcin pero si cuenta con un backup (archivo de respaldo) de la misma, entonces deber
restaurar dicho backup en su servicio de base de datos antes de iniciar con estos pasos.
Procedimiento
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.
745
2. Abra Bizagi Management Console

Abra Bizagi Management Console y en la primera ventana de bienvenida, seleccione la opcin de
Proyectos.
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:
746
Bizagi iniciar un asistente para este procedimiento.

Ingrese el detalle de la conexin a la Base de datos existente.
747
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.
748
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.

En este punto ya contar con el servidor BPM adecuado para su proyecto, y conectado a su servicio de
base de datos del mismo.
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.
749
La configuracin de entorno posee tres opciones:

Popular
Avanzado
Personalizado
750
Antes del el primer deployment, la configuracin de TODOS los ambientes puede ser realizada en el
ambiente de desarrollo 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)
751
Los parmetros para configurar son

OPCIN
DESCRIPCIN
Opciones de Notificacin
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.
752
OPCIN
DESCRIPCIN
Enviar copia de
Email a
Define una cuenta de correo electrnico a la cual se enviarn las copias de

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.
Integracin por email
Habilitar revisin
de emails
Habilita la posibilidad de recuperar correos electrnicos desde una cuenta

configurada para poder completar tareas a travs de correo electrnico sin
ingresar al Portal de Trabajo.
Tipo de conexin
Depende de los requerimientos de su compaa, las opciones disponibles son

Exchange, POP3 e IMAP.
Activar SSL
Define si Bizagi usar SSL para conectarse con su servidor de correo. Esta
opcin depende de la configuracin de su Servidor de Correos y est
disponible cuando el tipo de conexin es POP3 o IMAP.
Puerto
Define el Puerto de conexin a su Servidor de Correos. Esta opcin est

disponible cuando el tipo de conexin es POP3 o IMAP.
Cuenta
Define la cuenta que recibir las respuestas de los correos electrnicos

enviados por los usuarios finales.
Servicio de
Correo / Servidor
Cuando se selecciona Exchange, el servicio de correo recibe la URL del

Servicio Web de Exchange, el cual es una ULR .asmx, la URL por defecto
para este servicio es https://[MailServer]/EWS/Exchange.asmx. D clic aqu
para ms informacin sobre Servicio Web de Exchange (EWS) y cmo
determinarla.
Cuando se selecciona POP3 o IMAP, define el nombre o la direccin IP de su
Servidor de Correos.
Usuario
Define un nombre de usuario vlido dentro de su Servidor de Correos para

realizar la conexin.
Clave
La contrasea del usuario previamente mencionado.
Recomendamos usar una cuenta exclusiva para recuperar los mensajes entrantes para la
Integracin por Correo Electrnico. Bizagi leer todos los mensajes entrantes y los marcar como
ledos.
Cualquier error lanzado por la integracin por Correo Electrnico ser registrado en el Visor de
Eventos de Windows.
753
Cualquier error lanzado por la integracin por Correo Electrnico ser registrado en un archivo
.csv localizado en %temp%/Bizagi/EmailIntegration.
Configuracin SMTP
Para configurar el usuario, la contrasea, el puerto y la Seguridad de la capa de transporte (TLS) de
SMTP, edite el archivo <BIZAGI_HOME>\BizagiBPMJEE\bizagi-config\bizagi-extended.properties en
las siguientes propiedades:
SMTP.UserName=
SMTP.Password=
SMTP.Port=
SMTP.TlsEnabled=true/false
Si la cuenta de notificaciones de salida (configuracin SMTP) se encuentra en Exchange, su
configuracin es correcta y Bizagi lanza la excepcin 550 5.7.1 Unable to relay, consulte http://
exchangeserverpro.com/exchange-2013-configure-smtp-relay-connector/ para resolver el problema.
Avanzado
Desde esta opcin usted puede configurar los parmetros de caractersticas avanzadas, para cada
ambiente (desarrollo, pruebas, produccin).
754
Los parmetros que pueden ser configurados son:

OPCIN
DESCRIPCIN
OPCIONES DE SCHEDULER
Intervalo
Configura el intervalo (en horas, minutos y segundos), para cuan

frecuente el servicio de Scheduler realizar un monitoreo 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 valor de esta propiedad puede ser una carpeta local o una ruta
externa alojada en un servidor remoto. Para servidores remotos, la
ruta debe ser \\[Direccin IP o Nombre del Servidor]\[Carpeta]\.
Asegrese de que tiene permisos de escritura en dicha carpeta del
servidor.
755
OPCIN
DESCRIPCIN
El directorio por defecto en Bizagi .NET es: C:\BizAgi\Enterprise
\Projects\[Project name]\Docs
La ruta por defecto en Bizagi JEE es el directorio ./BizAgiDocs ubicado
en el home del usuario (p.e. C:\Users\[user]\BizAgiDocs en sistemas
operativos Windows).
Tenga presente que [user] corresponde al usuario que inicia el
Servicio del Servidor de Aplicaciones (p.e, usuario root en sistemas
operativos tipo *nix como Linux).
Tamao mximo de Upload
Define el tamao mximo que puede tener un archivo para ser subido
a la aplicacin Bizagi (bytes).
Considere la siguiente tabla con el fin de convertir a bytes las
unidades ms comunes de medicin para el almacenamiento de datos
MEDIDA
BYTES
1 KB
(Kilobyte)
1.024
1 MB
(Megabyte)
1.048.576
1 GB
(Gigabyte)
1.073.741.8
24
OPCIONES SOA
Forzar llave de negocio de
SOA
La opcin para 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
relaciones M-M
de 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 Las Entidades Paramtricas en el Portal de Trabajo se manejan en
756
OPCIN
DESCRIPCIN
longitud de Atributo Y (2) cach si el nmero de atributos es menor que el primer parmetro y
Lmite de instancias de el nmero de registros es menor que el segundo parmetro.
Entidades
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.
OPCIONES DE INTERFAZ DE SERVICIOS WEB
Tiempo de Espera
Sirve para configurar un tiempo de espera para los servicios web

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
Umbral de tiempo en segundos para registrar las interfaces que

duran ms de este tiempo.
OPCIONES DE NOTIFICACIN DE ANULACIN

Deshabilitar notificaciones Si se selecciona desactiva la notificacin de los casos que sean
de anulacin
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 dirjase Configuracin ODS
Personalizado
Desde esta opcin usted puede agregar, editar y borrar los diferentes parmetros del proyecto para
cada ambiente (desarrollo, pruebas, produccin).
757
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
758
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.config 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 y configuracin de seguridad en la autenticacin
Introduccin
Bizagi ofrece la posibilidad de gestionar la configuracin de seguridad del proyecto Bizagi a travs de
Bizagi Management Console.
La gestin de esta informacin se puede llevar a cabo de manera independiente para cualquiera de
los entornos del proyecto: desarrollo, produccin o pruebas.
Al utilizar Bizagi Management Console, encontrar la configuracin relacionada a aspectos de
seguridad, que podr gestionar bajo el mdulo con ese mismo nombre: Seguridad.
La configuracin que es gestionada bajo este mdulo incluye: el tipo de autenticacin utilizado
(Autenticacin), el control de acceso (Autorizacin), y la Configurar la sincronizacin LDAP.
Configuracin de la autenticacin
Usted puede editar el tipo de autenticacin usada por el proyecto y los parmetros adicionales que
cada tipo de autenticacin utiliza.
759
Los tipos de autenticacin son:

Autenticacin Bizagi: Permite que Bizagi maneje la autenticacin (el dominio, los usuarios y sus
contraseas se guardan en Bizagi).
Autenticacin LDAP: Usa un servidor LDAP (p. ej. un Directorio Activo) para verificar la informacin
ingresada en la pgina de login (usuario, contrasea y dominio).
Mientras se use la autenticacin contra un servidor LDAP, no se guardarn contraseas en Bizagi.
Autenticacin Federada: Usa un proveedor de Identidad que autentica al usuario y facilitan las
capacidades de Single Sing-On a travs de servicios federados.
Mientas se use la autenticacin Federada, no se guardarn las contraseas en Bizagi y la autenticacin
es incrustada para ese proveedor de Identidad para cumplir con el estndar WS-Federation Passive
Protocol (e.g. Active Directory Federation Services).
Autenticacin Windows: Permite a Bizagi validar automticamente, usuarios contra dominios y

mquinas de Windows.
Esto se logra haciendo que el Portal de Trabajo delegue la autenticacin a las mquinas de Windows
del lado del cliente (Bizagi no almacenar contraseas).
La Autenticacin Windows no funciona en mviles si la autenticacin annima est deshabilitada. Para
usarlo, tiene que habilitarla. Esto saltar la pgina de login.
Autenticacin personalizada; Permite que la autenticacin sea manejada por una aplicacin externa.
Con la autenticacin personalizada, usted desarrolla su propio componente que sobre escribe los
mtodos de Bizagi en su componente de Autenticacin.
De esta manera y por s mismo, el componente que desarrolle puede contar con APIs u otros
componentes de terceros y conexiones para autenticar al usuario (e.g. validar contra una base de
datos MySQL, archivos XML o una base de datos de un sistema heredado, etc).
Autenticacin Mixta: Permite el uso de dos tipos diferentes de autenticacin para usuarios de
diferentes dominios. Uno de los tipos debe ser Autenticacin Bizagi y el otro puede ser Windows o
Autenticacin personalizada
760
Considere los siguientes aspectos importantes:

1. Cualquier tipo de autenticacin requiere que los usuarios hayan sido previamente creados o
importados en la base de datos de Bizagi (aunque con ciertos tipos de autenticacin, cierta
informacin como la contrasea no se almacene en Bizagi).
2. Con cualquier tipo de autenticacin, el usuario del sistema domain/admon debe mantenerse
habilitado.
Este usuario no debe asignarse a ningn usuario final especfico, y deber tener permisos
restringidos en el menu y opciones del Portal de trabajo.
Se recomienda que usted crea y defina un usuario para el administrador de negocio de su solucin
de tal manera que sea ese otro usuario quien realice modificaciones en los valores de entidades
paramtricas, la administracin de sus usuarios, licencias o casos, etc.
Los dems parmetros relacionados a cada tipo de autenticacin que podr modificar son:
Tipo de
autenticacin
Opcin
Descripcin
Define el asunto del correo que se enva a un usuario

Correo de notificacin
cuando su cuenta es creada y queda activa.
de cuenta activa Su uso est relacionado con Correo de notificacin de
Asunto
cuenta activa - Mensaje.
Define el cuerpo del correo que se enva a un usuario
Correo de notificacin
cuando su cuenta es creada y queda activa.
de cuenta activa Su uso est relacionado con Correo de notificacin de
Mensaje
cuenta activa - Asunto.
Define el asunto del correo que se enva al
administrador cuando un usuario solicita el
desbloqueo de una cuenta (cuando se usa Habilitar el
Correo de solicitud de
envo de correos para desbloqueo de cuentas y se ha
desbloqueo de cuenta
definido una Direccin de correo del administrador de
- Asunto
cuentas).
Su uso est relacionado con Correo de solicitud de
desbloqueo de cuenta - Mensaje.
Define el cuerpo del correo que se enva al
desbloqueo de una cuenta (cuando se usa Habilitar el
Correo de solicitud de
envo de correos para desbloqueo de cuentas y se ha
desbloqueo de cuenta
definido una Direccin de correo del administrador de
- Mensaje
cuentas).
Su uso est relacionado con Correo de solicitud de
desbloqueo de cuenta - Asunto.
761
Correo del
recordatorio de
contrasea - Asunto
Define el asunto del correo que se enva al usuario

cuando este solicita un recordatorio de contrasea.
Su uso est relacionado con Correo del recordatorio Mensaje.
Correo del
recordatorio de
contrasea - Mensaje
Define el cuerpo del correo que se enva al usuario

cuando este solicita un recordatorio de contrasea.
Su uso est relacionado con Correo del recordatorio Asunto.
Direccin de correo
del administrador de
cuentas
Define la direccin de correo del administrador a

cargo de las solicitudes de desbloqueo de cuentas
(Correo de solicitud de desbloqueo de cuenta).
Se requiere contar con Habilitar el envo de correos
para desbloqueo de cuentas.
Duracin del bloqueo

de cuenta
Define la duracin en minutos en que una cuenta

permanece bloqueada por intentos fallidos al llegar al
alcanzar el Nmero mximo de intentos fallidos, antes
de ser automticamente desbloqueada (cuando se
tiene Habilitar el bloqueo de cuenta por intentos
fallidos).
Este parmetro debe ser igual o mayor al de la
Tiempo de espera para intentos fallidos.
Forzar el cambio de
contrasea por
primera vez
Define si la contrasea debe ser cambiada despus

del primer inicio de sesin.
Considere su uso, o de manera alternativa, optar por
definir una Vigencia mnima de la contrasea.
Forzar el uso de
caracteres especiales
en la contrasea
Establece si la contrasea debe ser contener por lo

menos un caracter especial (caracteres no alfanumricos).

menos una letra.
Forzar el uso de letras
Considere en vez, el uso de Forzar el uso de
en la contrasea
maysculas en la contrasea y de Forzar el uso de
maysculas en la contrasea.
Forzar el uso de
maysculas en la
contrasea

menos una letra mayscula.
Forzar el uso de
minsculas en la
contrasea

menos una letra minscula.
Forzar el uso de
nmeros en la
contrasea

menos un nmero.
Forzar la validacin
Establece si se valida que la contrasea no tenga
762
de secuencias en
contraseas
secuencias de caracteres (p.e abc, 12).
Forzar la validacin
del historial de
contraseas
Define el nmero de contraseas nicas que una

cuenta debe tener antes de reutilizar una contrasea
antigua.
Habilitar el bloqueo
de cuenta por
intentos fallidos
Establece si se deben bloquear las cuentas cuando se

alcance el Nmero mximo de intentos fallidos.
Habilitar el log de
autenticacin en la
base de datos
Establece si se debe crear un registro de auditora

con todos los eventos de autenticacin.
Aplica slo para el ambiente de desarrollo y de
pruebas.
Habilitar el login
rpido
Establece si el inicio de sesin en el Portal de trabajo

se realiza sin necesidad de ingresar la contrasea (un
login rpido mediante la seleccin de cuenta desde
una lista desplegable).
La lista desplegable muestra los primeros 100
usuarios activos (para el usuario nmero 101 en
adelante, habr un campo de texto para escribir la
cuenta).
Su uso est orientado a pruebas unitarias o para
verificar rpidamente prototipos (este parmetro no
es vlido en ambientes de produccin).
Habilitar el uso de
pregunta secreta
Establece si los usuarios establecen una pregunta

secreta y su respuesta, de manera que puedan contar
con la posibilidad de evitar un bloqueo de cuenta al
olvidar la contrasea.
Habilitar el envo de
correos para
desbloqueo de
cuentas
Establece si se debe o no enviar un correo al

desbloqueo de su cuenta, segn lo definido en
Direccin de correo del administrador de cuentas y
Correo de solicitud de desbloqueo de cuenta.
Habilitar sesiones
concurrentes por
cuenta
Establece si se permite ms de un inicio de sesin

concurrente para una misma cuenta.
Longitud mxima de
la contrasea
Define el nmero mximo de caracteres que debe

contener una contrasea (utilice cero si esta restriccin
no es deseada).
Longitud mnima de la
contrasea
Define el nmero mnimo de caracteres que debe

contener una contrasea.
Nmero mximo de
Define el nmero mximo de intentos de inicio de
763
intentos fallidos
sesin permitidos antes de que la cuenta quede

bloqueada (si se cuenta con Habilitar el bloqueo de
cuenta por intentos fallidos).
Tiempo de espera
para bloqueo de
cuentas inactivas
Define el nmero de das que transcurre antes de que

una cuenta sea bloqueada por inactividad.
Tiempo de espera
para intentos fallidos
Define la duracin en minutos del contador de

intentos fallidos.
Despus de este tiempo de espera, el conteo de
intentos se reinicia (si no se lleg al tope de intentos
fallidos Nmero mximo de intentos fallidos).
Tiempo de espera
para sesiones
inactivas
Define el tiempo en minutos, en el que una sesin

inactiva expira.
En dicho caso se deber realizar la autenticacin de
nuevo.
En caso de que desee aumentar este tiempo de
espera a ms de 60 minutos (no recomendado),
entonces usted debe editar la configuracin por
defecto del servidor Web (por ejemplo, realizar la
modificacin directamente en el IIS).
Tiempo de servicio
para solicitudes
pendientes
Define el tiempo esperado de servicio para procesar

una solicitud de desbloqueo de cuenta.
Define el nmero mximo de das en los que se puede

Vigencia mxima de la
utilizar una contrasea antes de que se exija una
contrasea
cambio (tiempo de expiracin de la misma).
LDAP
Personalizada
Vigencia mnima de la
contrasea
Define el nmero mnimo de das que debe trascurrir

antes de que la contrasea pueda ser cambiada de
nuevo.
Considere su uso, o de manera alternativa, optar por
Forzar el cambio de contrasea por primera vez.
AUTHOPTIONS_LDAP_
Path
Corresponde a la ruta de acceso al servidor LDAP

(utilizando el formato de URL LDAP).
AUTHOPTIONS_LDAP_
UseIntegration
Aplica si usted ya ha configurado Bizagi para

sincronizar los usuarios del Directorio Activo en
Bizagi.
Si este es el caso, active esta opcin, para utilizar la
misma URL del LDAP y la configuracin de los ajustes
de sincronizacin de LDAP.
Cuando esta opcin est activada, el valor de la
primera opcin ser ignorada.
Componente
Autenticacin
de Define el nombre del assembly que llevar a cabo la

autenticacin. Este assembly debe estar presente en el
764
Personalizada:
bin de la aplicacin Web o en el GAC.
Define el nombre de la
autenticacin personalizada
Clase de autenticacin
especificado. Ac debera
personalizada
namespace de esa clase
como Namespace.Clase).
Mixta
Bizagi Domain
Otro tipo de
autenticacin
clase que realizar la

dentro del componente
incluir el nombre del
(definir este parmetro
Especifique el nombre del dominio para los usuarios

que van a ser autenticados mediante la autenticacin
de Bizagi.
Seleccione el tipo de autenticacin que utilizar

(Windows o Personalizada).
Configuracin de la autorizacin
Usted puede editar los permisos otorgados o restringidos a los usuarios finales para administrar los
perfiles que puedan acceder y modificar informacin, o utilizar ciertas opciones de administracin del
Portal de trabajo.
Los permisos dentro de esta definicin se apoyan en el concepto de roles y grupos de usuarios.
En el componente de Autorizacin usted puede administrar los accesos de los siguientes items:
765
MEN
Anlisis
DESCRIPCIN
Permite o restringe acceso a informacin de
Procesos especficos en las Herramientas de
Anlisis.
Si el acceso se restringe para un Proceso
especfico, usted podr acceder el men de
Reportes, pero usted no podr ver ese Proceso
en el Monitoreo de Actividades de Negocio BAM,
Sensores ni en el Anlisis de Tareas y Procesos.
Aplicaciones
Permite o restringe acceso a Aplicaciones. Estos

permisos se configuran para cada aplicacin
individualmente.
Si el acceso se restringe para una aplicacin
especfica, usted no podr crear nuevos casos de
procesos que pertenezcan a esa aplicacin;
tampoco podr ver casos relacionados a esos
Procesos en su Inbox.
Usted debe saber que un usuario, pese a ser
restringido a una Aplicacin, podr seguir siendo
asignado a Procesos relacionados a ella pero no
podr acceder a sus tareas. Por esta razn sea
cuidadoso al implementar esta restriccin.
Entidades
Permite o restringe privilegios de administracin

a Entidades Paramtricas en el Portal de Trabajo.
Estos permisos se configuran para cada entidad
individualmente.
Los privilegios de administracin que se pueden
configurar son:
Control Total: Permite administracin total de
una entidad, es decir, si se concede, el usuario
podr crear nuevos registros de la entidad as
como ver, modificar o eliminar los existentes.
Ver Datos: Si se concede, el usuario
nicamente podr ver los registros de la
entidad. Estos registros no podrn ser
modificados.
Modificar: Si se concede, el usuario podr ver
y modificar los registros de la entidad, pero no
766
podr crear nuevos registros.

Crear: Si se concede, el usuario podr crear
nuevos registros en la entidad pero no podr
modificar los registros existentes.
Administracin
Permite o restringe la administracin de Alarmas,

Items de trabajo de actividades asncronas,
casos, usuarios por defecto y perfiles.
Creacin de Casos
Permite o restringe la creacin de nuevos casos.

Estos permisos se conceden para cada Proceso
individualmente.
Si se restringe para un Proceso especfico, usted
no podr crear nuevos casos de ese Proceso; sin
embargo, usted podr ser asignado a las
actividades de ese Proceso.
Pginas
Controla el acceso a las pginas de mens y submens del Portal de Trabajo. Estos permisos se
conceden para cada pgina individualmente.
IMPORTANTE: En el men de Analysis, los
permisos aplicados al men Todos los Reportes
se heredan para los sub-mens. Esto quiere
decir que si se restringe el acceso a Todos los
reportes usted no podr acceder a ninguno de
sus directorios de nivel ms bajo (sub-mes).
Polticas
Permite o restringe acceso a Polticas. Estos

permisos se conceden para cada poltica
individualmente.
Si se restringe el acceso a una poltica especfica,
esta no ser visible en el men de Polticas de
negocio del Portal de Trabajo;
consecuentemente, usted no podr acceder a
ella.
Consultas
Permite o restringe acceso a Consultas de Caso.

Estos permisos se conceden para cada consulta
individualmente.
Si se restringe el acceso a una Consulta
especfica, esta no ser visible en el men de
Consultas del Portal de Trabajo;
ella.
Vocabularios
Permite o restringe acceso a la Administracin de
767
Vocabularios. Estos permisos se conceden para

cada definicin individualmente.
Si se restringe el acceso a una Definicin
especfica, esta no ser visible en el men de
Polticas de negocio del Portal de Trabajo;
ella.
Configurar la sincronizacin LDAP

Usted puede editar los parmetros de conexin a su sistema LDAP.
Al editar parmetros relacionados a la conectividad, o los relacionados a la sincronizacin como tal

(p.e cundo se efecta la programacin de esta sincronizacin, considere estas opciones:
Configuracin
Descripcin
768
Conexin
LDAP URL
Especifique la ruta o URL para acceder al servidor LDAP

(formato de URL LDAP).
Dominio\usuario
Especifique un nombre de usuario y su dominio, para ser

utilizado como el usuario autenticado que realiza la
sincronizacin.
Clave
Especifique la contrasea de usuario del dominio utilizado

como el usuario autenticado que realiza la sincronizacin.
Hora de sincronizacin
Defiar una hora del da para que el Programador realice la

sincronizacin LDAP.
Los valores permitidos para este campo son de 0 a 23.
Configuraci FIltro
n
de
importacin
Dominio
Introduzca un filtro para importar slo las cuentas

correspondientes al proyecto (de acuerdo con un criterio de
atributos LDAP).
Se recomienda usar y configurar una condicin de filtrado
con el fin de importar el conjunto adecuado de los usuarios
(especialmente al probar la configuracin).
Mayor informacin sobre los filtros posibles en Atributos de
LDAP.
Especifique el nombre del dominio al que los usuarios sern
registrados en la entidad de usuario de Bizagi (WFUSER).
Identificador de cuenta Seleccione el atributo LDAP que identifica de forma nica

de usuario
cada cuenta. Por ejemplo, sAMAccountName es el atributo
LDAP correspondiente al nombre de la cuenta de un
usuario.
Al editar los mapeos de atributos, aada, modifique o elimine los registros de mapeo de la definicin
en la pestaa de Agregar Mapeo.
769
Al editar los valores por defecto, aada, modifique o elimine los registros de la definicin en la
pestaa de Agregar Valor por defecto.
770
No especifique que el atributo Habilitado (enabled) se establezca en Verdadero, a menos que est
completamente seguro de que su licencia actual admitir el nmero de usuarios importados.
Tenga en cuenta que si el nmero total de usuarios activos es mayor que el nmero de usuarios con
licencia, el Portal de Trabajo dejar de funcionar.
Recuerde que en cualquier momento usted podr probar la configuracin de la sincronizacin con
LDAP, especialmente til si se ha realizado alguna modificacin (p.e cambios en el filtro), de manera
que los resultados de sincronizacin se mostrarn los registros encontrados en la ltima pestaa
llamada Resultados de la prueba:
Probar la configuracin no implica que se realice una sincronizacin inmediata en la base de datos
de Bizagi.
Esta opcin nicamente es para propsitos de verificacin y los resultados no se persisten dado
que ser el servicio Programador quien lleve a cabo la ejecucin real en la hora programada.
Importante
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).
En resumen, los cambios en la configuracin de Autenticacin y LDAP que ya est en produccin, debe
hacerse directamente sobre ese ambiente.
771
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.
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.
En la imagen de arriba, vemos los parmetros de configuracin para realizar una actividad asncrona,
772
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).
773
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.
774
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.
775
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.
776
Administracin de sistemas externos

Bizagi ofrece la posibilidad de gestionar la informacin de los sistemas externos y aplicaciones
integradas en los procesos a travs de Bizagi Management Console.
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.
Al utilizar Bizagi Management Console, ubique el mdulo de los Sistemas externos integrados a su
proyecto para administrar su configuracin:
Para ms informacin sobre cmo gestionar especficamente tales valores, consulte lass siguientes
secciones:
Administracin de la conexin a SAP: Para editar los parmetros de conexin a su sistema SAP
integrado por medio del conector de SAP de Bizagi.
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).
777
Administracin de la conexin a SAP
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
editar los parmetros de conexin a su sistema SAP (para gestionar los ambientes de produccin o de
pruebas).
Parmetros de conexin a SAP
Edite los parmetros de conexin de su sistema SAP localizando el tem Conector de SAP bajo el
mdulo Sistemas.
D clic derecho en las propiedades de la configuracin de su conector de SAP:
Tenga en cuenta que si bajo alguna circunstancia cualquiera de estos parmetros cambian en su
sistema SAP, los puede editar en Bizagi para su ambiente especfico (pruebas o produccin)
Considere estos parmetros para su integracin con SAP:
Nombre del Host: La direccin IP o el nombre del servidor que aloja su sistema SAP.
Cliente: El nmero del cliente que accede al sistema SAP.
Espera de inactividad: El tiempo de espera en segundos para conexiones inactivas.
778
Por defecto, usted puede asignar un valor de 600.

Idioma: El cdigo ISO de 2 letras que representa la configuracin de idioma (como se ingres
cuando se accedi a SAP a travs de SAP Logon).
Nmero mximo de conexiones: El nmero mximo de conexiones que permitir a travs del
conector de SAP.
Por defecto, puede asignar un valor de 10 conexiones.
Tamao del Pool: El nmero de conexiones que se manejaran para su reutilizacin.
Por defecto, usted puede asignar un valor de 5.
Nmero de sistema: El nmero de su sistema SAP.
Usuario: Un usuario autorizado para acceder e invocar BAPIs o RFCs.
El usuario de SAP configurado aqu, ser usado como la cuenta de servicio de este conector.
Contrasea: La contrasea del usuario autorizado de SAP.
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
servicios REST.
Interfaces de servicios web SOAP se identifican con este icono:
Interfaces para servicios REST se identifican con este icono:
En el ambiente de Pruebas o de Produccin, usted puede administrar sus interfaces como se describe
a continuacin.
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 localizar este grupo de interfaces, vaya a la vista de Mdulos y d clic en el mdulo Sistemas.
Para editar una interface existente, d clic derecho sobre la interface y seleccione sus Propiedades.
779
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:
780
Se le mostrar la siguiente ventana:
Tenga en cuenta que, por defecto, la nueva interface ser tratada como una interfaz de servicio web
SOAP (Servicio type = SOAP).
781
La edicin de servicios REST contempla ciertas consideraciones al momento de editar la URL Base.
Vea las consideraciones relacionadas a interfaces de servicios REST.
Los siguientes campos se presentan:
Nombre : Nombre nico y requerido que identifica a la interface. ste no debe contener espacios.
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:
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 .\Temporary\SOA\Log\ de su
proyecto (por defecto, queda una archivo por cada servicio web, creado
como
C:\Bizagi\Projects\[su_proyecto]\Temporary\SOA\Log\[su_interface]
Log_1.csv).
Este log es especialmente til para el monitoreo dado que cada invocacin
que exceda o produzca un timeout dejar registro con el siguiente detalle:
Fecha (DateTime), Descripcin (ErrorDescription), idCase, Tarea (Task_Name),
URL, Mtodo (Method_Name), y Registro de tiempo (InterfaceTime) en
formato MM:ss:mmm.
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 .\Temporary\SOA\Log\ de
su proyecto (por defecto, queda una archivo por cada servicio web, creado
como
C:\Bizagi\Projects\[su_proyecto]\Temporary\SOA\Log\[su_interface]
782
Log_1.csv).
Este log es especialmente til para el monitoreo dado que cada invocacin
que exceda o produzca un timeout dejar registro con el siguiente detalle:
Fecha (DateTime), Descripcin (ErrorDescription), idCase, Tarea (Task_Name),
URL, Mtodo (Method_Name), y Registro de tiempo (InterfaceTime) en
formato MM:ss:mmm.
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).
Nombre del puerto
Cuando el usuario necesita ejecutar una interfaz SOAP en la cul, el servicio

tiene diferentes puertos (p.ej, SOAP 1.1, SOAP 2.0, etc.), este campo permite
al usuario escribir el nombre especfico del puerto por donde se conectar
el servicio. Este nombre del puerto puede ser configurado de acuerdo al
ambiente en donde se ejecuta la interfaz.
Los nombres de los puertos se especifican al final del WSDL del servicio:
Mximo de bytes del

bfer
Edite su valor (por incrementar) en caso de que necesite enviar informacin
muy extensa a su servicio Web (p.e un adjunto de gran tamao).
til cuando se excede el lmite por defecto de la cantidad de informacin
que se permite en el envio.
Corresponde al atributo maxBufferSize del elemento bindings del
archivo de configuracin del Windows Communication Foundation (WCF).
Establece el tamao mximo de los encabezados SOAP.
Mximo de memoria
en el pool del bfer
Corresponde al atributo maxBufferPoolSize del elemento bindings del
783
archivo de configuracin del Windows Communication Foundation (WCF).

Establece la mxima cantidad permitida de memoria (en bytes).
Mximo de
caracteres
permitidos en el XML Edite su valor (por incrementar) en caso de que necesite enviar informacin
Corresponde al atributo maxStringContentLength del elemento
readerQuotas del archivo de configuracin del Windows Communication
Foundation (WCF). Establece la longitud mxima de la cadena de respuesta.
Mximo de longitud
de matriz en los
datos recibidos
Mximo de bytes
permitidos por
lectura
Mximo de
caracteres en el
nombre de tabla

Corresponde al atributo maxArrayLength del elemento readerQuotas
del archivo de configuracin del Windows Communication Foundation (WCF).
Establece la longitud mxima permitida del arreglo de datos.

Corresponde al atributo maxBytesPerRead del elemento readerQuotas
del archivo de configuracin del Windows Communication Foundation (WCF).
Establece el mximo de bytes permitido que se retorna en cada lectura.

Corresponde al atributo maxNameTableCharCout del elemento
readerQuotas del archivo de configuracin del Windows Communication
Foundation (WCF). Establece el numero mximo de caracteres en el nombre
de una tabla.
Los valores y tipos de datos de los atributos de la especificacin Windows Communication

Foundation (WCF) de Microsoft explicados anteriormente (por ej. correspondientes a los parmetros
finales como: maxbuffersize, maxbufferpoolsize, maxstringcontentlength, maxarraylength,
784
maxbytesperread, y maxnametablecharcount), corresponden a la definicin del archivo de

configuracin XML como se presentan en la siguiente imagen:
Esta ser la estructura que Bizagi construye para la invocacin del Web Service.
Opciones avanzadas para la seguridad del servicio web:
De clic en el enlace para configurar el tipo de seguridad que se utiliza en su servicio web.
Tenga presente que esta definicin difiere de las credenciales que se especifican en las propiedades
anteriores (usuario, contrasea y dominio) ya que las anteriores son utilizadas principalmente para que
Bizagi acceda a los recursos fsicos (p.e el WSDL) de la definicin del servicio web, mientras que esta
configuracin determinar cmo debe Bizagi autenticarse ante la ejecucin del servicio web.
Las opciones que podr editar y administrar para una interface ya definida en su ambiente son:
Opcin
Descripcin
Plain Header Token Enva el token de usuario
Especificacin
Segn la definicin en:
785
(usernameToken) en el encabezado
del mensaje SOAP de acuerdo a la
especificacin de WS-Security.
Secure
Conversation
Header Token
Basic HTTP
Authentication
Enva el token de usuario de acuerdo

a la especificacin, teniendo un
certificado adecuado instalado en el
cliente.
Enva las credenciales que aplican
cuando el end-point especificado del
servicio est protegido (a nivel de
autenticacin bsica).
https://www.oasis-open.org/
committees/download.php/16782/wssv1.1-spec-osUsernameTokenProfile.pdf
http://docs.oasis-open.org/ws-sx/wssecureconversation/200512

http://www.ietf.org/rfc/rfc2617.txt
Por defecto, Bizagi intentar usar este

tipo de seguridad si no se especifica
alguno, y se cuenta con autenticacin
bsica a nivel del recurso (usando las
credenciales definidas en las
propiedades de usaurio, contrasea y
dominio).
No generar proxy en ejecucin (generarlo ahora):

Bizagi genera una definicin (.cs, .dll) del proxy de cada servicio Web que se integra al proceso cuando
ste se ejecuta sobre una plataforma .NET.
Por defecto, este proxy se genera la primera vez que se haga el look-up y se invoque el servicio
durante la ejecucin.
Al utilizar esta opcin y si desea generarlo previamente (desde Bizagi Studio), Bizagi utilizar esta
definicin en ejecucin en vez de generar una nueva en ese momento.
Esta opcin es muy til cuando el servicio Web en el ambiente de produccin est muy restringido y
sus recursos no pueden ser accedidos de manera sencilla (hay esquemas o el WSDL que tienen
restricciones importantes de seguridad).
Con esta opcin, puede generar el proxy a partir del WSDL configurado para otro ambiente (p.e
ambiente de desarrollo).
Para hacerlo, utilice la opcin Use y genrelo desde para seleccionar el ambiente a partir del cul se
generar el proxy.
Para la correcta ejecucin al utilizar esta caracterstica, deber cerciorarse de que el WSDL utilizado
786
para generar el proxy sea exactamente el mismo que se utilizar en ejecucin, en dicho ambiente.
Esta opcin no aplica a una plataforma JEE puesto que el proxy que se genera en diseo es
realizado por el framework de .NET.
Esta clase proxy de .NET no es compatible y no se utiliza en una platforma de JEE.
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
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:
787
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).
788
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:
789
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.
790
El Programador debe estar en estatus de iniciado para ejecutar cualquier trabajo programado.
791
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 mantenimiento. Se
recomienda 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 estn
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 rollback 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:
792
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

Usted puede administrar y configurar los esquemas de replicacin en su proyecto.
Dentro de estas opciones, tambin puede deshabilitar el esquema de ejecucin.
793
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.
794
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
795
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.
796
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).
797
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.
Adicional al detalle del trace, se recomienda revisar los eventos y logs de su servidor, ya sea para
WebSphere, Weblogic, JBoss o IIS. Estos logs lo ayudarn a encontrar el detalle del error cuando se
encuentre depurando su proceso.
1. Reconocer qu Traces activar
La habilitacin de Traces se realiza desde el Management Console (para un ambiente de pruebas o
produccin).
798
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
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
799
Conectores / WS
Connector
Registra cuando una interfaz externa se invoca. Rastrea

las peticiones y respuestas.
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.
Conectores / SAP
Registra cuando una BAPI de SAP se invoca. Rastrea

los parmetros de Importacin y Exportacin.
Para ms informacin sobre como los Traces para la
invocacin de interfaces, consulte Diagnstico y control
de errores para BAPIs de SAP. Diagnstico y control de
errores para SAP.
EntityManager
Registra la ejecucin de EntityManager (acceso de

base de datos).
LDAP
Registra 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 use 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).
800
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
801
utilizada como servidor de BPM.

E
L
E
M
E
N
T
O
E
n
t
i
t
y
M
a
n
a
g
e
r
L
D
A
P
R C:\Bizagi\Projects\[project_name]
e \Trace\
n
d
e
r
(
C
o
n
t
r
o
l
)
C:\Windows\Temp\Bizagi\Trace\
R
u
l
e
802
s
S
c
h
e
d
u
l
e
r
W
o
r
k
f
l
o
w
C
o
n
n
e
c
t
o
r
s
/
W
S
C
o
n
n
e
c
t
o
r
C:\Bizagi\Projects\[project_name]
\Temporary\SOA\
Para Interfaces asncronas de SOA
configuradas para reintentos en
C:\Windows\Temp\Bizagi\SOA
fallos, las trazas de cada reintento
quedarn en:
\Temporary\Scheduler\SOA\
C
o
n
n
\Temporary\SAP\
e
c
C:\Windows\Temp\Bizagi\SAP
803
t
o
r
s
/
S
A
P
La siguiente tabla ilustra dnde se encuentran los logs de acuerdo con el servidor.
SERVIDOR
LOG
RUTA
WebSphere
SystemErr.log,
SystemOut.log,
StartServer.log, y
StopServer.log
<WEBSPHERE_HOME>\profiles\[NodeName]\logs
\server1
Weblogic
AdminServer.log,
[su_domino_Weblogic].log
<WEBLOGIC_HOME>\user_projects\domains
\[USER_DOMAIN]\servers\log
JBoss
Server.log
<JBOSS_HOME>\standalone\log
IIS
Logs registrados por el

visor de eventos
C:\inetpub\logs
Ejemplos y mayor informacin

Como se describi anteriormente, hay ms de 1 tipo de objeto / componente para rastrear.
Lo siguiente describe los Traces ms comnmente 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:
804
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.
Para ms informacin sobre como los Traces para la invocacin de interfaces, consulte Diagnstico y
control de errores para BAPIs de SAP. Diagnstico y control de errores para SAP.
805
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 WS Connector
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 WS
Connector.
806
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
Registra un log con estructura XML, con la informacin de

negocio extrada desde Bizagi.
El nombre de este archivo sigue esta estructura:
[identificador_del_caso]
_BizAgiSOARequest_[timestamp].json
Ntese
que
el
timestamp
se
define
como:
yyyyMMddHHmm.
Request transformed

negocio despus de aplicar una transformacin a los
datos extrados desde Bizagi.
_BizAgiSOARequest_[timestamp].json
Ntese
que
el
timestamp
se
define
como:
yyyyMMddHHmm.
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
Ntese
que
el
timestamp
se
define
como:
yyyyMMddHHmm.
En versiones anteriores de Bizagi, se registra el contenido
del XML justo como se enva al servicio externo pero sin
los datos que van en la cabecera de SOAP (sin el SOAP
Header).
807
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
Ntese
que
el
timestamp
se
define
como:
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

negocio tal y como es retornada por la respuesta del
servicio Web.
_BizAgiSOAResponse_[timestamp].json
Ntese
que
el
timestamp
se
define
como:
yyyyMMddHHmm.
Response transformed

negocio despus de aplicar una transformacin a los
datos retornados por la respuesta del servicio Web.
_BizAgiSOAResponseTransformed_[timestamp].json
Ntese
que
el
timestamp
se
define
como:
yyyyMMddHHmm.
Adems de los anteriores, existen 2 trazas adicionales que proporcionan una ayuda para verificar
cmo qued configurado el mapeo de los datos de entrada y datos de salida.
Tipo de Trace
Request mapping JSON
Descripcin
til principalmente para el ambiente de produccin, como medida
inmediata para la consulta de la configuracin del mapeo.
Registra un log con estructura JSON, con la informacin sobre
cmo se realiz el mapeo para los datos de entrada
(involucrando las transformaciones necesarias).
_BizAgiSOARequestMapping_[timestamp].json
Ntese que el timestamp se define como: yyyyMMddHHmm.
Response mapping JSON
til principalmente para el ambiente de produccin, como medida

inmediata para la consulta de la configuracin del mapeo.
808
Registra un log con estructura JSON, con la informacin sobre

cmo se realiz el mapeo para los datos de salida (involucrando
las transformaciones necesarias).
_BizAgiSOAResponseMapping_[timestamp].json
Ntese que el timestamp se define como: yyyyMMddHHmm.
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.
809
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.
810
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.
Diagnstico y control de errores para SAP

Cuando se configuran invocaciones a BAPIs de SAP 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.
811
Traces de SAP
Cuando se hace debug en la invocacin de una BAPI de SAP (en ambientes de desarrollo) o cuando se
desea obtener log detallado sobre una ejecucin fallida, se pueden habilitar los Traces de SAP.
Tenga en cuenta que los Traces de interfaces pueden habilitarse en cualquier momento, sin
embargo 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.
812
La habilitacin de los Traces es til para detectar en qu punto exactamente hubo un fallo en la
ejecucin, principalmente porque se cuentan con 4 puntos donde se registra detalle que es til para
diagnosticar si el problema est internamente en la BAPI de SAP externa, 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
Import
Registra un log con estructura XML con la informacin

de cmo se realiza el mapeo para los parmetros de
Import (Involucrando funciones de transformacin).
El nombre sigue la siguiente convencin:
BizagiSAPImport[timestamp].xml
Observe
que
timestamp
corresponde
a
yyyyMMddHHmm.
Import Transformed

trada desde Bizagi.
BizagiSAPImportTransformed[timestamp].xml
Observe
que
timestamp
corresponde
a
yyyyMMddHHmm.
Export

de cmo se realiza el mapeo para los parmetros de
Export (Involucrando funciones de transformacin).
BizagiSAPExportTransformed[timestamp].xml
Observe
que
timestamp
corresponde
a
yyyyMMddHHmm.
Export Transformed

trada desde desde el Export de la BAPI de SAP.
BizagiSAPExportTransformed[timestamp].xml
Observe
que
timestamp
corresponde
a
yyyyMMddHHmm.
Versiones y actualizaciones
Bizagi libera nuevas versiones de manera peridica.
Estas versiones incluyen nuevas funcionalidades poderosas y ajustes o mejoras a las funcionalidades
existentes.
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.
813
La versin mas reciente en todas sus ediciones, estar disponible para descarga desde nuestro sitio
en www.bizagi.com.
Consulte los captulos a continuacin para mayor detalle.
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 consulte la Actualizacin de versin de Bizagi.
Si usted utiliza una versin de Bizagi 10.4 o anterior (conocida antes como ediciones Enterprise, Xpress
o JEE), consulte la Actualizacin a Bizagi 10.5 para una explicacin detallada de los conceptos en Bizagi
Suite 10.5 y consideraciones de actualizacin.
Actualizacin de edicin Xpress a Enterprise
Resumen
Desde la versin 10.5, Bizagi ofrece 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.
Cuando se tenga un proyecto desarrollado con Bizagi Xpress, es posible actualizar el proyecto a la
Suite BPM de Bizagi.
814
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. (Aplica para versiones 10.4 o previas).
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).
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).
815
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:
816
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.
817
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.
818
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.
819
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.
820
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.
821
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.
822
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.
823
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.
824
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).
825

826
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.
827
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.
828
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.
829
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.
830
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).
831

832
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.
833
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.
834
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.
835
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 versin 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 versin 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 la versin ms reciente 10.x de Bizagi, siga las
recomendaciones y procedimiento descrito a continuacin.
Recomendaciones
836
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).
837
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
838
nuestra pgina oficial 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.
Tenga en cuenta que al actualizar la versin de Bizagi Engine, deber siempre reiniciar el servidor.
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.
839
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.
La actualizacin de versin es un procedimiento simple, el cual lo es realizado y notificado mediante
Bizagi.
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
840
ambiente de desarrollo 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 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
841
Aplicaciones JEE.
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.
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.
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
, dando clic en Panel de control y

842
luego Programas o Desinstalar un programa.
En Windows 8 puede buscar Panel de Control escribiendo Control en la barra de bsqueda y

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

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

Administración Del Sistema Bizagi

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Administración Del Sistema Bizagi

Hochgeladen von

Copyright:

Verfügbare Formate

Bizagi BPM Suite

Parte I Administracin del Sistema

Requisitos al utilizar Oracle

Configuracin de Bizagi ODS

Definicin del ODS en el Servidor de Aplicaciones

Configuracin del servidor

Windows Server 2012 R2 o 2012

Windows Server 2008 R2 o 2008

Administracin de Servidores y Clsters

Utilizar un repositorio externo para la sesin ......................................................................................................................................... 108

Configuracin de Bizagi Engine JEE

Configuracin de WebSphere en clster

Copyright 2002-2016 Bizagi. Todos los derechos reservados.

Configuracin del Scheduler en Weblogic

Configuracin estndar de Weblogic

Configuracin estndar de JBoss

Balanceo de cargas con WebSphere

Balanceo de cargas con Weblogic

Balanceo de cargas con JBoss

Despliegue hacia Weblogic

Despliegue hacia JBoss

Otras opciones de configuracin

Configuracin de Bizagi en Amazon

Gua para nueva versin de Proceso

Backups de base de datos

Backups del Portal de trabajo y Programador

Copyright 2002-2016 Bizagi. Todos los derechos reservados.

Monitoreo de infraestructura y plataforma......................................................................................................................................................... 722

Mantenimiento de la base de datos

Volver a crear desde la base de datos

Copyright 2002-2016 Bizagi. Todos los derechos reservados.

Administracin del Sistema

Administracin del Sistema Bizagi

Componentes del Sistema Bizagi

Un sistema ECM utilizado como gestor documental.

Configuracin de la base de datos

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

Requisitos de la base de datos

Requisitos al utilizar SQL Server

Versiones y ediciones soportadas

SQL Server 2014

SQL Server 2012

SQL Server 2008 R2, service pack 1

SQL Server 2008, service pack 1

Para Bizagi Engine, se soportan ediciones Estndar o superior.

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Verificando la configuracin en SQL Server

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Esta consulta debe mostrar el detalle completo de la instancia:

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Copyright 2002-2016 Bizagi. Todos los derechos reservados

3. Login de usuario autorizado

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Asegrese de que tenga el rol public:

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Copyright 2002-2016 Bizagi. Todos los derechos reservados

Los mapeos de usuario db_datareader, db_datawriter, public, rlBA_SQL_BizagiWebApp y

Copyright 2002-2016 Bizagi. Todos los derechos reservados

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

Copyright 2002-2016 Bizagi. Todos los derechos reservados

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