Instalación

Instalación en Unitrade

En el ambiente de UniTrade se deberán modificar 3 archivos: mercap.ini, server-configuration.ini y tr-ut-service.ini. Los dos últimos ya se encontrarán en el ambiente o serán provistos por Mercap cuando se requieran.

Modificaciones a Archivos de Configuración

A continuación se detallarán los cambios que deberán realizarse a los archivos de configuración. Es importante aclarar que cada vez que se realice algún cambio sobre ellos deberá reiniciarse el servicio de UniTrade para que dichas modificaciones se vean reflejadas en el sistema.

Modificaciones a mercap.ini

El archivo de configuración mercap.ini cuenta con una sección en la cual se puede activar la comunicación entre Mesa y Unitrade. Si dicha sección no se encuentra en el archivo se puede agregar manualmente. Dicha sección es la siguiente:

[TR-UT-Synchronization-Server-Configuration]
TR-UT-Synchronization-Server-Enabled = true
TR-UT-Synchronization-Server-INI = .\config\tr-ut-service.ini
TR-UT-Synchronization-Server-Configuration-INI = .\config\tr-ut-server-configuration.ini

Para activar la comunicación es necesario modificar la variable denominada TR-UT- Synchronization-Server-Enabled en true, como se ve en el ejemplo anterior.

Existe una sección que no tiene relación con la integración entre Unitrade y Trading Room pero que es necesaria para las sucursales que es Branch-Office-Server-Configuration y ambas secciones no pueden activarse al mismo tiempo en el mismo archivo. Esto no es un problema ya que si se tienen instaladas sucursales, en el ambiente además del archivo mercap.ini existirán otros archivos similares para cada instancia de cada sucursal (se suelen llamar mercapA.ini, mercapB.ini, etc) y serán estos archivos los que tendrán activada la variable Branch-Office-Server-Configuration (no es el caso del archivo mercap.ini que sólo tendrá activada TR-UT-Synchronization-Server-Enabled).

Es decir, la sección de sucursales en el archivo mercap.ini deberá verse como en el siguiente ejemplo:

[Branch-Office-Server-Configuration]
Branch-Office-Server-Enabled = false
Branch-Office-Server-Port-Number = 8888
Branch-Office-Cache-Timeout-In-Seconds = 28800

Modificaciones al archivo tr-ut-service.ini

En este archivo se podrá indicar el puerto que será usado para la url de la conexión SOAP. Si no se especifica ninguno en particular se tomará el puerto 7375 por defecto. En caso de querer especificarlo deberá indicarse en la variable port, a continuación se muestra cómo debería configurarse para utilizar el puerto 7376:

A su vez, en hostname se debe añadir la url del banco

[WebService]
; Puerto a utilizar para los Web Service (SOAP)
; Default: 7375
hostname = localhost
port = 8080  

Modificaciones al archivo tr-ut-server-configuration.ini

En este archivo podrá configurarse el puerto que será utilizado por UniTrade para servir el WSDL, el cual es necesario para definir cómo será la comunicación entre ambos sistemas. Para esto primero deberá habilitarse dicha comunicación en la sección HTTP- Server, especificamente en la variable enabled como se muestra a continuación:

[HTTP-Server]
## enable
# Habilitar un servidor HTTP para exponer los WSDL.
# Puede deshabilitarse si se tiene otro servidor que pueda exponerlos.
# Default: true
enabled = true

En este mismo archivo se definirá el puerto para servir el WSDL de la siguiente forma (en este caso para el puerto 9901):

Y en el cual se podrá especificar el puerto, por ejemplo, configurando el puerto 9901:

## port
# Puerto a utilizar por el servidor HTTP para exponer los WSDL.
# Default: 80
port = 9901

Por lo que en dicho archivo deberá quedar lo siguiente:

[HTTP-Server]
## enable
# Habilitar un servidor HTTP para exponer los WSDL.
# Puede deshabilitarse si se tiene otro servidor que pueda exponerlos.
# Default: true
enabled = true

## port
# Puerto a utilizar por el servidor HTTP para exponer los WSDL.
# Default: 80
port = 9901

## root_directory
# Directorio en el que se coloca los WSDL.
# Va a ser expuesto como directorio raíz del servidor HTTP.
# Default: .\htdocs\
;root_directory = .\htdocs\
using_free_port = false

[SOAPServer]
## connection_threshold
# Cuando se alcanza esta cantidad de conexiones simultáneas se activa un proceso que elimina las conexiones inactivas
# durante el período de inactividad especificado.
# Default: 1024
;connection_threshold = 1024

## connection_survival_time
# Período de inactividad a partir del cual se eliminan las conexiones si se supera el umbral de conexiones.
# Unidad: Segundos
# Default: 7200 
;connection_survival_time = 7200

## number_of_server_processes
# Cantidad de procesos internos de SmallTalk que levanta SST para atender pedidos.
# Se puede levantar para procesar mayor cantidad de pedidos en simultaneo,
# pero puede incrementar el tiempo de respuesta si son demasiados pedidos
# Default: 10
;number_of_server_processes = 10

Instalación Trading Room

En Mesa deberá configurarse la url donde se encuentra el WSDL. La misma deberá especificarse como una ruta HTTP en la cual se definirá la IP o el nombre de la máquina en la cual se encuentra instalado Unitrade, además de especificar el puerto que se definió en el archivo serverconfiguration.ini en el ambiente de Unitrade y el nombre del archivo servido por unitrade: TradingRoomAndUnitradeSynchronizationWebService.wsdl

El menú desde donde se puede configurar lo antedicho se encuentra en el módulo de Administración: Sistemas Externos > SOAP.

Se deberán configurar los siguientes campos:

• Nombre: Conector Unitrade

• WSDL: http://[SERVERUNITRADE]:

  [puerto]/TradingRoomAndUnitradeSynchronizationWebService.wsdl

• Seguridad: Password digest

• Usuario: mercap

• Contraseña: MERCAP

• Ruta de Archivo de Log: log.log

• Timeout en Segundos: 360

A continuación se puede ver un ejemplo, suponiendo que el nombre del servidor donde se encuentra instalado Unitrade es srvUnitrade, y el puerto definido es 9901:

La url completa del ejemplo es la siguiente:http://srvUnitrade:9901/TradingRoomAndUnitradeSynchronizationWebService.wsdl.

Para probar la conectividad entre Unitrade y Mesa podrá copiarse dicha url en algún explorador desde la máquina en la que está instalado Mesa. Tener en cuenta que para que pueda probarse la conectividad Unitrade debe haber sido reiniciado. Si la conectividad está funcionando deberá verse algo similar a lo siguiente: