Instructivo Instalación Trading Room

A continuación se detallarán los pasos necesarios para la correcta instalación de Mercap Trading Room. Es requisito para el instalador que se hayan completado los pasos de la sección Precondiciones.

Precondiciones

Bases de Datos

El sistema requiere dos bases de datos instaladas: una principal, y una de auditoría.

Para ambas, realizar el siguiente procedimiento:

1. Crear una base de datos nueva. Para ello, dentro del servidor en la carpeta

   Databases, hacer click derecho → “New Database...”.

Tomar nota del nombre elegido de la base ya que luego será necesario utilizarlo en la sección ODBC.

1. Agregar un nuevo login con usuario mercap y contraseña MERCAP. En caso de usar otro usuario y/o contraseña algunos pasos más adelante cambiarán. Para ello, sobre el servidor en la carpeta Security, hacer click derecho “New” “Login...”.

Completar con el usuario y contraseña mencionados anteriormente, seleccionar la opción “SQL Server authentication” y destildar la opción “Enforce password policy”.

Seleccionar la página “User Mapping” para asociar el usuario de login a la base de datos. Tildar la opcion “Map” de la base y tildar los roles db_owner y public para asignarle al usuario los permisos sobre los objetos de la base.

Hacer click en OK.

Para crear las tablas utilizar los scripts SQL provistos, respectivamente en cada base:

• Base Principal:

  • DeployDatabaseScript.sql

• Base Auditoría:

  • DeployAuditDatabaseScript.sql

ODBC

El sistema accede a los datos en la base de datos a través de ODBC (Open DataBase Connectivity). Se deben agregar las entradas indicadas a continuación. Para ello se utiliza el “Administrador de orígenes de datos ODBC” (odbcad32.exe) que se encuentra en las Herramientas Administrativas del sistema.

• Para sistemas Windows de 64 bits:

  • C:\Windows\SysWow64\odbcad32.exe

• Para sistemas Windows de 32 bits:

  • C:\Windows\System32\odbcad32.exe

Se espera que estén configurados dos ODBC, a través de los cuales accederá Mercap Trading Room a la base de datos. Con el primero se accederá a la base de datos principal, y con el segundo a la base de datos de auditoría.

En la solapa de System DSN, hacer clic en “Add...”.

A continuación, se debe seleccionar el controlador de la base de datos, y presionar Finish.

Nota: Se recomienda el driver SQLServer.

A partir de allí comenzará el proceso de configuración propio del controlador utilizado.

1. Especificar un nombre para el origen de datos ODBC. Tomar nota de lo ingresado porque luego será solicitado por el instalador de Mercap Trading Room. El nombre por defecto que utiliza el instalador es “TradingRoom”. Opcionalmente, se puede especificar una descripción. Por último, especificar la instancia de SQL Server al que se conectará el ODBC. Desplegando las opciones, se puede elegir entre los servidores actualmente visibles por el sistema.

Presionar Next.

1. Especificar que se va a utilizar autenticacióon de SQL Server, con usuario mercap y contraseña MERCAP. En caso de haber creado otro usuario para la base de datos, ingresar dicho usuario y contraseña.

Presionar Next.

1. Seleccionar la base de datos a la que se conectará él ODBC, ya sea la base de datos principal o la de auditoría, dependiendo del ODBC que se esté configurando. Debería estar disponible en la lista desplegable. De no aparecer, es probable que el usuario que se está utilizando no tenga permisos de acceso a la base de datos deseada.

Hacer clic en Next.

1. En esta página, se pueden utilizar los valores por defecto.

Hacer clic en Finish.

1. Finalmente, se puede observar un detalle de la información configurada.

Se debe verificar que la conexión sea satisfactoria, para ello presionar el botón “Test Data Source...”. Deberá aparecer la siguiente ventana:

Hacer clic en OK en ambas ventanas. Repetir los pasos anteriores para configurar el ODBC de la base de datos de auditoría. Finalmente, el ODBC debería quedar de la siguiente manera:

Instalación

Proceso de instalación

Una vez cumplidas todas las precondiciones, el proceso de instalación continua con la instalación de archivos en el servidor.

Requisitos:

• Privilegios de administrador.

• Gestor de base de datos instalado y funcionando (Localmente o en otro servidor).

Consideraciones:

• Las rutas indicadas en este manual son las utilizadas por defecto, pero el cliente podrá adaptarlas a sus necesidades, siempre teniendo en cuenta las configuraciones requeridas en cada caso.

• Los nombres de servidores o PCs indicados en este manual son a modo ilustrativo, y el cliente deberá cambiarlos por los correspondientes a cada ambiente donde se esté realizando la instalación.

• Mercap Trading Room es un sistema de 32 bits, por lo que tendrá que tenerse en cuenta esta particularidad en caso de instalarse en un sistema operativo de 64 bits, para utilizar las herramientas de configuración adecuadas en cada caso.

• Las acciones que se realicen sobre el sistema operativo, deben ejecutarse con permisos de administrador.

Instalación de archivos:

• Descomprimir el archivo TradingRoomServer.zip provisto por Mercap en C:\Mercap (u otro directorio). Una vez finalizado, la estructura resultante debería tener el siguiente formato:

• Deben configurarse los permisos del directorio: C:\Mercap\TradingRoom para que el usuario bajo el que se ejecuta el servicio de MercapTradingRoom tenga acceso de “Control Total” sobre TODOS los archivos y subdirectorios del mismo. Para esto se deberá hacer click derecho en la carpeta y seleccionar propiedades → solapa “Sharing” y click en el siguiente botón:

Una vez dentro clickear sobre el botón Permissions

Deberán estar tildadas todas las opciones

Instalación del servidor como servicio del sistema operativo:

Este capítulo describe los pasos requeridos para la correcta instalación de Mercap Trading Room como un servicio Windows.

1. Realizar la registración de Mercap Trading Room como servicio desde la línea de comandos ejecutando como administrador lo siguiente en el directorio de instalación de Mercap Trading Room (C:\Mercap\TradingRoom):

sc create MercapTradingRoom start=auto DisplayName="Mercap Trading Room" binPath=C:\Mercap\TradingRoom\TradingRoomWrapper.exe

Nota: Verificar que el comando se encuentre completo en un sola línea sin saltos.

1. Utilizar regedit (o cualquier otro editor del registro de Windows) y buscar donde está definido el servicio registrado en el paso anterior navegando hasta la clave:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\MercapTradingRoom

a) Crear una nueva Clave, llamada Parameters: hacer clic con el botón derecho → New → Key.

Indicar nombre “Parameters” y aceptar.

b) Dentro de la clave Parameters, se deben crear tres valores de tipo alfanumérico (”String Value”):

• AppDirectory

• Application

• AppParameters

Para ello, hacer clic con el botón derecho New String Value. Luego, completar con los datos que se observan en la siguiente imagen:

• C:\Mercap\TradingRoom

• C:\Mercap\TradingRoom\vast\bin\mercap-server.exe

• -ipackaged-server.icx -ini:packaged-server.ini -mo36000000 -mi8000000 -ml4000000 -mn4000000

c) Verificar que la instalación del servicio haya sido exitosa desde la aplicación de servicios en el panel de control de Windows, como se muestra en la siguiente imagen:

Seleccionar el servicio MercapTradingRoom y hacer click derecho para visualizar las propiedades del mismo. Verificar que el path al ejecutable TradingRoomWrapper.exe sea correcto, y que el mismo concuerde con el directorio de instalación de Mercap Trading Room.

Detalle archivo de configuración mercap-settings.ini:

En el directorio C:\Mercap\TradingRoom se encuentra el archivo de configuración mercap-settings.ini donde se registran (entre otras) las siguientes entradas:

• httpServerListeningPort: Puerto interno de escucha del servidor de Mercap Trading Room.

• filesBaseUrl: Dirección en donde se sirven los archivos estáticos a través de Internet Information Services. El puerto aquí definido es el designado para utilizar Mercap Trading Room.

• odbcName: Nombre del ODBC, usados para la conexión con la base principal y la de auditoría respectivamente.

• winDomainServer: nombre del servidor de dominio utilizado para login via Active Directory.

• winGroupsSearchPattern: Patrón usado para los grupos de Active Directory designados para Mercap Trading Room.

Configuración de Sitio Web mediante IIS(Internet Information Services)

A continuación se detallan los pasos necesarios para configurar el sitio web de Mercap Trading Room mediante Internet Information Services. En caso de que no esté activado se deberá ingresar a Panel de Control Programas Programas y características Activar o Desactivar las características de Windows.

Luego Seleccionar lo siguiente:

Una vez que se pueda ingresar al IIS realizar los siguientes pasos

1. Sitios: El primer paso es crear el sitio web de Trading Room. Hacer clic en “Add Web Site...”.

Asignarle el nombre Trading Room. Poner la ruta de los archivos estáticos, un nivel más arriba del directorio files. Por ejemplo, si los archivos estáticos están en C:\Mercap\TradingRoom\iis\files, entonces la ruta tiene que ser C:\Mercap\Tradingroom\iis.

Luego, definir el usuario:“Connect as...” → “Specific User:” con username:

MERCAP\mercap y password MERCAP.

Luego, definir el puerto de escucha para los archivos estáticos. Este puerto se corresponde con el puerto definido en mercap-settings.ini → filesBaseUrl.

Este puerto es el designado para utilizar Mercap Trading Room.

1. Proxy: Instalar el módulo URL Rewrite para construir las reglas de re-escritura de la URL. Este módulo necesita de la instalación del módulo Application Request Routing Cache (ARRC).

En caso de no tener los módulos instalados deberá dirigirse a https://www.iis.net/downloads/microsoft/url-rewrite para URL Rewrite y https://www.iis.net/downloads/microsoft/application-request-routing para Application Request Routing Cache (ARRC).

Una vez instalados ambos, posicionarse con un clic sobre el host e ir al módulo ARRC.

A la derecha, en la sección “Proxy” hacer clic en “Server Proxy Settings...”. Tildar el combo “Enable proxy” y aplicar los cambios.

Luego, ir al sitio web creado y abrir el módulo URL Rewrite. Hacer click en “Add Rule(s)...” y escoger “Blank rule”. Al configurar cada regla, activar la opción “Stop processing of subsequent rules” que se encuentra al final de la regla.

Las reglas deberían quedar cargadas de la siguiente manera (el orden importa):

Nombre	Patrón	Acción	URL
JS_CSS	(files.*\/)([0-9.]*-)?([^\/]*(css|js))$	Rewrite	{R:1}{R:3}
StaticFiles	files.*	None	-
Redirección	(.*)	Rewrite	http://localhost:XXXX/{R:1}

El resto de la parametría dejarla por default.

El puerto definido en redirección es un puerto interno que se comunica con el servidor de Mercap Trading Room. Se corresponde con el puerto definido en mercapsettings.ini→httpServerListeningPort.

1. Páginas de error: Para configurar las páginas de errores de Mercap (provistas por el archivo TradingRoomServer.zip), es necesario instalar el módulo Error Pages. Para cada archivo html provisto, crear una página nueva con el correspondiente código de error, apuntando mediante una ruta absoluta.

Además, es necesario ir al módulo Configuration Editor del host, acceder a la sección system.webServer/httpErrors del Web.config y modificar el valor de “allowAbsolutePathsWhenDelegated” a True.

1. MIME Types: Las extensiones que normalmente se tiene que agregar son .woff y .woff2. Solo hay que ir al módulo Mime Types, presionar “Add...” y ponerle “application/x-woff” a ambas extensiones.

1. Longitud Máxima URL: Acceder al módulo Request Filtering y presionar “Edit Feature Setting...” y modificar el valor de “Maximum Query String” a un valor prudente (por ejemplo, 10000).

1. Archivos Estáticos: Es necesario tener instalado el Handler StaticFileModule para poder servir los archivos estáticos. Este se instala automáticamente cuando se agregan los módulos de Directory Browsing y Error Pages. Tras tener ambos instalados, ir al módulo de Handler Mappings, presionar “Add Module Mapping...” de nombre StaticFile, con path * y asignar los handlers StaticFileModule, DefaultDocumentModule, DirectoryListingModule. Luego, presionar el botón “Request Restrictions...” y seleccionar la opción de tipo File or Folder.

1. Cabecera: Ir al módulo HTTP Response Headers, hacer click en “Add...” y especificar una cabecera de nombre “Access-Control-Allow-Origin” y valor *.

1. Permisos: En caso de presentarse el error 401 Unauthorized para los archivos estáticos, es necesario añadir permisos de lectura para el usuario IUSR en el directorio de los archivos estáticos. Para ello, ir al módulo de Authentication, en la sección de nombre Anonymous Authentication.

Anexos

Cambio de usuario

Si el usuario y/o contraseña creado en la base de datos es distinto del sugerido en este manual, utilizar la herrramienta RDB Config Updater. Los pasos para su uso son:

1. Descomprimir el archivo zip provisto en alguna carpeta con permisos de escritura.

2. Abrir una consola en la carpeta donde se descomprimió la del archivo. Puede hacerlo manteniendo pulsado la tecla Shift y click derecho.

1. Ejecutar el siguiente comando:

db-config-updater -username:USER -password:PASS -auditusername:AUDITUSER -auditpassword:AUDITPASS

Donde debe reemplazarse:

• USER por el nombre de usuario para la base de datos del sistema.

• PASS por el password para la base de datos del sistema.

• AUDITUSER por el nombre de usuario para la base de datos del log de auditoría.

• AUDITPASS por el password para la base de datos del log de auditoría.

En caso de funcionar correctamente se obtendrá por pantalla el mensaje:

mercap-settings.dat successfully created

Se habrá generado un archivo de dicho nombre con las credenciales encriptadas.

Finalmente, reemplazar el archivo mercap-settings.dat del directorio de instalación de Mercap Trading Room por el nuevo generado.