De

<keywords content="keywords"> virtualización, replicación, virtual, replicar, JEE virtual, Jboss 7.1, Jboss, producción JBoss, irtualization, replication, virtualización en producción, replicación en producción </keywords>

Cómo configurar la virtualización y replicación en un Servidor JEE

Introducción

El procedimiento que se presenta en este artículo ilustra cómo configurar una fuente de datos externa en un servidor de aplicaciones JEE, usado para un ambiente de Bizagi de Pruebas o de Producción.

Este procedimiento sólo se requiere si se utiliza la virtualización o replicación como métodos de integración en el proyecto Bizagi.

Este paso no se requiere en un ambiente de Desarrollo del proyecto de Bizagi, ya que Bizagi Studio configura de manera automática el servidor JBoss 7.1.1 (que se instala embebido en este ambiente), al momento de configurar la virtualización o replicación.

Prerequisitos

Antes de continuar, asegúrese que su servidor de aplicaciones JEE haya sido configurado para trabajar con procesos de Bizagi.

Para garantizar este prerequisito, revise el artículo correspondiente a la configuración de cada Servidor de Aplicaciones JEE:

• Configuracion_de_JBoss_para_trabajar_con_Bizagi.
• Configuracion_de_WebLogic_para_Trabajar_con_Bizagi.
• Configuracion_de_WebSphere_para_Trabajar_con_Bizagi.

Adicional a lo anterior, debe también asegurarse que la configuración de virtualización y replicación en el ambiente de Desarrollo haya sido probada y validada con éxito, con el comportamiento esperado.

Que debe hacerse

Para configurar la fuente de datos externa que se usa en la virtualización o replicación en el servidor JEE, los siguientes pasos se realizan:

1. Registrar el driver de Bizagi usado para la conexión a la fuente externa.

2. Incluir la información de conexión a las fuentes externas.

3. Incluir información adicional (aplica únicamente cuando se usa virtualización).

Ejemplo

El siguiente ejemplo ilustra cómo configurar la virtualización en un ambiente de producción de Bizagi sobre JBoss 7.1.1.

Registrar el driver de Bizagi usado para la conexión a la fuente externa

Para registrar el driver en JBoss 7.1.1, edite el archivo de configuración standalone.xml que se ubica en: <JBOSS_HOME>/standalone/configuration/.

Tenga en cuenta que <JBOSS_HOME> es la ruta de instalación donde se ubica JBoss 7.1.1, como se especificó en la configuración_de_JBoss_para_trabajar_con_Bizagi.

Al editar este archivo:

1. Ubique el elemento <drivers>.

2. Incluya las siguientes lineas para usar el driver "Bizagi" en la conexión de Bizagi:

<driver name="BIZAGI" module="com.bizagi.jdbc">
	<driver-class>bizagi.jdbc.BizAgiDriver</driver-class>
</driver>

En este punto, el archivo standalone.xml debe verse como:

Incluir la información de conexión a las fuentes externas

En el mismo archivo <JBOSS_HOME>/standalone/configuration/standalone.xml que se está editando, ubique el elemento <datasources>, y adicione dentro de él las siguientes líneas:

<datasource jta="false" jndi-name=" java:/[externalDS]" pool-name="[externalDS]" enabled="true" use-ccm="true">
	<connection-url>[connectionURL]</connection-url>
 	<driver>[driver]</driver>
 	<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
 	<security>
 		<user-name>[dbUser]</user-name>
 		<password>[dbUserPassword]</password>
 	 </security>
   	<validation>
   		<validate-on-match>false</validate-on-match>
  		 <background-validation>false</background-validation>
                </validation>
	<statement>
		<share-prepared-statements>false</share-prepared-statements>
	</statement>
</datasource>

Edite estas líneas asegurándose que se reemplacen los valores correspondientes a las fuentes de datos externas usadas en el proyecto:

• [externalDS]: Es un nombre que identifique de manera única la fuente de datos. Si esta fuente utiliza la replicación de Bizagi, este nombre deberá corresponder al valor de la propiedad "JDataSource" del proveedor en Bizagi, como se especifica en la sección "Incluir la propiedad JDataSource" .
• [driver]: El driver utilizado para la conexión. Este debe ser de acuerdo al motor de base de datos, con los valores: ORACLE, MICROSOFTSQLSERVER.
• [dbUser]: El usuario de la base de datos.
• [dbUserPassword]: La contraseña para el usuario de la base de datos.
• [connectionURL]: La cadena de conexión a la fuente de datos externa. Ver el detalle a continuación.

Para la conexión a bases de datos ORACLE, la cadena deberá ser de la manera: jdbc:oracle:thin:@//[databaseServer]:[servicePort]/[serviceName]

Donde:

• [databaseServer]: El nombre del servidor de la base de datos Oracle.
• [servicePort]: El número del puerto sobre el cual la instancia de Oracle se inicia.
• [serviceName]: El Sid del servicio de la instancia Oracle.

Para la conexión a bases de datos SQL Server, la cadena deberá ser de la manera: jdbc:sqlserver://[databaseServerInstance]:[instancePort];databaseName=[SQLdatabase]

Donde:

• [databaseServerInstance]: El nombre del servidor de la base de datos SQL Server, e instancia (si es una instancia llamada).
• [instancePort]: El número del puerto sobre el cual la instancia de SQL Server se inicia.
• [SQLdatabase]: El nombre del proyecto de Bizagi, el cual en SQL Server es la base de datos del proyecto.

En la siguiente imagen de ejemplo, podrá apreciarse que hay 2 fuentes de datos externas usadas en el proyecto:

Guarde el archivo y sus cambios.

Incluir la propiedad JDataSource

Si alguno de los proveedores de datos utiliza replicación, entonces tenga en cuenta que deberá incluir la propiedad "JDataSource" desde la vista de módulos (en Sistemas).

Esto puede realizarse directamente desde las opciones de la Consola administrativa de Bizagi (Management Console):

Nótese que el valor para estar propiedad debe corresponder al nombre especificado en [externalDS], en la edición del archivo standalone.xml.

Incluir información adicional (aplica únicamente cuando se usa virtualización)

El siguiente paso se realiza únicamente si se utiliza la virtualización de Bizagi en por lo menos 1 fuente de datos externa.

En el mismo archivo editado <JBOSS_HOME>/standalone/configuration/standalone.xml, ubique el elemento <datasources>.

1. Adicione las siguientes líneas, como una nueva fuente de datos "MainDS" (datasource). Esta se utlizará para la conexión principal a la base de datos de Bizagi:

<datasource jta="false" jndi-name=" java:/MainDS" pool-name=" MainDS" enabled="true" use-ccm="true">
	<connection-url>[connectionURL]</connection-url>
 	<driver>[driver]</driver>
 	<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>
 	<security>
 		<user-name>[dbUser]</user-name>
 		<password>[dbUserPassword]</password>
 	 </security>
   	<validation>
   		<validate-on-match>false</validate-on-match>
  		 <background-validation>false</background-validation>
                </validation>
	<statement>
		<share-prepared-statements>false</share-prepared-statements>
	</statement>
</datasource>

2. Edite estas lineas asegurándose de reemplazar los valores correspondientes de conexión a la base de datos del proyecto (tenga en cuenta que esta información deberá referenciar la base de datos de Bizagi).

• [driver]: El driver utilizado para la conexión. Este debe ser de acuerdo al motor de base de datos, con los valores: ORACLE, MICROSOFTSQLSERVER.
• [dbUser]: El usuario de la base de datos.
• [dbUserPassword]: La contraseña para el usuario de la base de datos.
• [connectionURL]: La cadena de conexión a la fuente de datos externa. Ver el detalle a continuación.

Para la conexión a bases de datos ORACLE, la cadena deberá ser de la manera: jdbc:oracle:thin:@//[databaseServer]:[servicePort]/[serviceName]

Donde:

• [databaseServer]: El nombre del servidor de la base de datos Oracle.
• [servicePort]: El número del puerto sobre el cual la instancia de Oracle se inicia.
• [serviceName]: El Sid del servicio de la instancia Oracle.

Para la conexión a bases de datos SQL Server, la cadena deberá ser de la manera: jdbc:sqlserver://[databaseServerInstance]:[instancePort];databaseName=[SQLdatabase]

Donde:

• [databaseServerInstance]: El nombre del servidor de la base de datos SQL Server, e instancia (si es una instancia llamada).
• [instancePort]: El número del puerto sobre el cual la instancia de SQL Server se inicia.
• [SQLdatabase]: El nombre del proyecto de Bizagi, el cual en SQL Server es la base de datos del proyecto.

3. Edite la fuente de datos existente llamada "BizAgiJava" (datasource) en los valores de los elementos: "<connection-url>" y "<driver>". Este paso se realiza para utilizar un formato donde se consideren las fuentes de datos externas, además de la conexión a la base de datos principal (sólo cuando se usa virtualización). Para hacerlo, asegúrese que el datasource BizagiJava contenga el siguiente formato editado:

<connection-url>jdbc:bizagi:mainDS=MainDS:external={[myProvider_N]:[externalDS_N]}</connection-url>
<driver>BIZAGI</driver>

En esta información, asegúrese que reemplace con los valores correspondientes la información del proveedor y fuente del elemento connection-url. Para ello, tenga en cuenta:

• [myProvider_N]: Es el nombre del proveedor, tal como se configuró en Bizagi. Recuerde que aplica para los proveedores que usan virtualización.
• [externalDS_N]: Es el nombre único que se le dió a la fuente de datos externa en el archivo standalone.xml (como "<datasource>").

Si su proyecto tiene más de 1 fuente de datos externa que utiliza la virtualización de Bizagi, entonces se requiere una dupla adicional de la manera {[myProvider_N]:[externalDS_N]} que debe concatenarse separaándose por ";". Por ejemplo:

<connection-url>jdbc:bizagi:mainDS=MainDS:external={[myProvider1]:[myExternal1]};{[myProvider2]:[myExternal2]}</connection-url>
<driver>BIZAGI</driver>

Guarde el archivo y sus cambios.

Artículos Relacionados

• Cómo_Integrar_Bizagi_con_una_Fuente_de_datos_externa (a través de virtualización o replicación).
• Deployment_de_la_aplicación_a_un_Servidor_JEE