Download Carta de Presentación

INNOVATIVE SOFT
MANUAL
Manual Instalación y Configuración
i+tms
INNOVATIVE SOFT
Índice de contenido
MANUAL
INNOVATIVE SOFT
MANUAL
INFORMACION GENERAL
Acerca del
manual
Este documento describe y explica los procedimientos para instalar y configurar el producto de
software i+tms (innovative treasury management system)
Audiencia
El manual esta dirigo para el administrador de infraestrucutura de tecnología de información encargado
de los productos de software financieros
Que es el
i+tms
Es un sistema de información financiera que procesa instrucciones en formatos estándares ISO y no
ISO, con el propósito de automatizar los procesos de negocio de la tesoreria corporativa
interconectando los sistemas internos de la entidad con los sistemas de conexion a SWFIT y/o
sistemas bancarios, el cual preserva todos los datos financieros para su explotación
Funcionamiento básico
El sistema i+tms se divide en dos módulos que procesan la información:
i+tms2bo.- Módulo de entrega o rececepcion de información financiera para el backoffice
i+tms2swift.- Módulo de entrega o recepcion de mensajes swift para el sistema SWIFT alliance access
Los procedimientos funcionan como dos servicios windows o demonios unix y entre ellos se
intercambian las instrucciones que se entregan o se reciben de swift/sistemas internos, estos procesos
pueden estar en servidores distintos.
Prerequisitos
•
Servidor Windows /Unix
•
Swift alliance Access 7.0/Fastworks/ Alliancet Lite2 Autoclient 1.2 y Personal Token
•
Java 1.6 o mayor instalado
•
Base de datos de la institución , una gran variedad de base de datos con soporte jdbc es
compatible con la aplicacion, se puede proveer mysql
•
Si desea autenticar el software contra el el directorio activo de microsoft debe asegurarse que
en el directorio lib de la distribucion del software se encuentra la libreria dinámica
ntlmauth.dll compatible con la version windows compatible con su sistema
•
Obtener datos de configuración
•
Conexión a base de datos para el sistema i+tms (ip, libreria y nombre de base de
datos)
•
Conexion a base de datos para los sistemas especificos de la institución por ej. DB2
del AS400 (ip, libreria y nombre de base de datos)
•
Habilitar el Servicio de Relay en el servidor de correo institucional para recibir las
notificaciones via correo electronico de las excepcion del sistema
•
Obtener las librerias y ejecutables del java service wapper tanuki de la plataforma done se
ejecutará el software (http://wrapper.tanukisoftware.com/doc/english/download.jsp)
•
Obtener kit de intalación
INNOVATIVE SOFT
MANUAL
INNOVATIVE SOFT
MANUAL
PROCEDIMIENTO DE INSTALACION
Introducción
A coninuación describimos los pasos de instalación manual del software i+tms
Donde
obtener el kit
www.innovative-soft.com/downloads/itms
Pasos de
instalación
servidores
i+tms
1.- Crear un directorio de instalacion (por ejemplo E:\isoft)
2.- Descompactar el archivo InstallationFilesi+tms.zip en el directorio de instalacion ( e:\isoft)
3.- crear la base de datos swift de interfases
a) Si utiliza myql en forma local en el servidor en la línea de comandos ejecute los siguiente
comandos (start -> run)
mysql -uroot -p<password>
create database swift
use database
source <directorio_instalacion>\scripts\i+tms\schema-export.sql
exit
b) si utiliza una base de datos en otro servidor , entrar con el administrador de base de bases
Ejecutar el procedimiento sql para crear la base de datos de acuerdo a su motor:
schema-exportSQLServer.sql
schema-exportOracle.sql
schema-export<otroMotor>.sql (favor de solicitar el procedimiento sql)
4.- editar con notepad o algún otro editor que no cambie la codificacion UTF-8 los archivos de
configuracion y cambie los parametros de configuracion
<directorio_instalacion>\config\i+tms\i+tms.hibernate.cfg.xml (conneccion a la base de datos
del componenete de transformación)
hibernate.dialect (valor ejemplo org.hibernate.dialect.MySQLInnoDBDialect)
hibernate.connection.driver_class (valor ejemplo com.mysql.jdbc.Driver)
hibernate.connection.url (valor ejemplo jdbc:mysql://localhost/SWIFT)
INNOVATIVE SOFT
MANUAL
hibernate.connection.username (valor ejemplo root)
hibernate.connection.password (valor ejemplo jeje)
<directorio_instalacion>\config\i+tms\i+tms.spring.xml (conneccion de los servicios windows
o demonios unix de interfase)
hibernate.dialect (valor ejemplo org.hibernate.dialect.MySQLInnoDBDialect)
hibernate.connection.driver_class (valor ejemplo com.mysql.jdbc.Driver)
hibernate.connection.url (valor ejemplo jdbc:mysql://localhost/SWIFT)
hibernate.connection.username (valor ejemplo root)
hibernate.connection.password (valor ejemplo jeje)
<directorio_instalacion>\config\i+tms\i+tmsSAA.params
windows o demonios unix de interfase)
toSWIFTDirectory
directorio de lectura SAA)
(valor
ejemplo
(conneccion
de
los
servicios
C:\iswift\input\messagePartner\103-200-202\
pollingTime=15 (valor ejemplo 15 segundos para verificar si hay mensajes disponible
a enviar a SWIFT
Nota.- Si desea autenticar contra el directorio activo el la variable url debe de agregar el string
“;useNTLMv2=true;domain=su_nombre_de_dominio”
5.- editar con notepad o algún otro editor que no cambie la codificacion UTF-8 los archivos de
configuracion de backoffice espeficifico de la institucion y cambie los parameretros como lo necesite
<directorio_instalacion>\config\i+tms\bo.cfg.xml (conexion de base de datos al backoffice de
BANCOMEXT)
hibernate.dialect (valor ejemplo org.hibernate.dialect.DB2400Dialect)
hibernate.connection.driver_class
com.ibm.as400.access.AS400JDBCDriver)
(valor
hibernate.connection.url
(valor
jdbc:as400://17.1.5.201;libraries=CSLIBD;auto commit=true/S102776E)
ejemplo
ejemplo
hibernate.connection.username (valor ejemplo jjuarez)
hibernate.connection.password (valor ejemplo jeje)
<directorio_instalacion>\lib\i+tms\sirs\com\innovative\sirs\bo\dao\hibernate\bncemt199frombo.hbm
(nombre de tabla en DB2)
table (valor ejemplo SCLIBD.SCLCC122)
INNOVATIVE SOFT
MANUAL
<directorio_instalacion>\config\i+tms\MONXsendACK.txt (criterio de seleccion de bancos y
monedas a seleccionar para el envio de acuse de MONEX)
bicAndCurr=codigobic,moneda1,moneda2,...
any,USD,EUR,CAD,GBP,JPY,MXN,CHF,CNY)
(valor
ejemplo
notBicAndCurr=codigobic,moneda1,moneda2 (valor ejemplo de acuses no son del
bic y monedas siguientes: SCBLUS33,currency=AUD,ZAR,HKD,DKK,NOK,NZD
<directorio_instalacion>\config\i+tms\GenerateACKnotification.txt (logo y descripción de
institucuion para el envio de acuse)
logoFile (valor ejemlo C:\Users\Gabriel\logoMonex.jpg)
institutionDescription (valor ejemplo , especificando @@ para el retorno de linea:
BANCO MONEX S.A. INSTITUCION DE BANCA MULTIPLE, MONEX GRUPO
FINANCIERO@@AV. PASEO DE LA REFORMA
284
PISO 15
COLONIA
JUAREZ@@C.P.06600 México D.F. Tel. 52310000@@www.monex.com.mx@@
<directorio_instalacion>\config\i+tms\MONXcallSendACKws.txt (uri y url del servicio web
para enviar el acuse por correo)
url
(valor
ejemplo
del
url
para
llavar
http://172.21.12.152:7001/SwiftShipping2/SwiftFileServer2Service?WSDL)
el
web
service
serverURI (valor ejemplo del uri del servidor http://com.monex.swiftfileserver/)
Los pasos 6,7, 8 y 9 son opcionales si quiere guardar los archivos de configuracion dentro del jar
6.- descompactar la libreria <directorio_instalacion>\lib\i+tms\sirs.jar, cambiando antes la extension .jar
a .zip en el directorio <directorio_instalacion>\lib\i+tms\sirs
7.Copiar
los
archivos
<directorio_instalacion>\lib\i+tms\sirs
de
configuracion
modificados
al
directorio
8.- Compactar en un archivo de zip dentro del directorio <directorio_instalacion>\lib\i+tms\sirs en un
archivo sirs.zip y renombrar a sirs.jar
9.- Reemplazar el archivo
<directorio_instalacion>\lib\i+tms\sirs.jar por el recien creado
<directorio_instalacion>\lib\i+tms\sirs\sirs.jar
10.- En caso de no requerir de algunos campos que se almacenan del sistema puede editar los archivos
de mapeo que se encuentran <directorio_instalacion>\lib\i+tms\sirs\sirs.jar, para lo cual debe
descompactar los archivos con el comando jar xf sirs.jar e ir al directorio
./com/innovative/sirs/dao/hibernate y editar los archivos *.hbm.xml y eliminar las lineas
correspondientes a los campos de la tabla que no desea incluir para almacenar , tenga cuidado para no
eliminar los campos que corresponden a las llaves y acuda a soporte tecnico para determinar si el
campo no afectaria la ejecución del sistema para los resultados que desea obtener su institución.
11.-Reemplaze las librerias de la plataform de ejecucion
Bajar de internet la distribucion comunity del tanuki y extraer los archivos en un directorio temporal
INNOVATIVE SOFT
MANUAL
Copiar como sigue lo siguientes archivos
desde el <directorio_temporal_tanuki>\bin\* al directorio <directorio_instalacion>\bin\wrapper
desde el <directorio_temporal_tanuki>\lib\* al directorio <directorio_instalacion>\lib\i+tms
ejemplo de directorio temporal de tanuki c:\tmp\wrapper-linux-x86-64-3.5.25 para redhat 64 bits
12.- instale los servicios de interfases en la linea de comandos
En windows abra una consola DOS <start -> run)
y escriba cmd <enter>
<directorio_instalacion>\scripts\i+tms\i+tms2BO install
<directorio_instalacion>\scripts\i+tms\i+tms2Swift install
En unix abrir una session shell y ejecute:
sh <directorio_instalacion>/scripts/i+tms/i+tms2bo.sh install
sh <directorio_instalacion>/scripts/i+tms/i+tms2swift.sh install
12.- Inicie los servicios de interfases en la linea de comandos
En windows DOS
<directorio_instalacion>\scripts\i+tms\i+tms2BO start
<directorio_instalacion>\scripts\i+tms\i+tms2Swift start
En unix
sh <directorio_instalacion>/scripts/i+tms/i+tms2bo.sh start
sh <directorio_instalacion>/scripts/i+tms/i+tms2swift.sh start
13.- Programar la ejecucion de la interfase propios de la institución, por ejemplo:
<directorio_instalacion>\scripts\i+tms\scheduleSICAR
Configuracio
n del servico
Es posible que se requiera cambiar algunos parametros del software tanuki (java wrapper) el cual
permite que el producto de software i+tms quede funcionando como servicio o demonio, los archivos de
configuracion son:
<directorio_instalacion>\config\i+tms\i+tms2bo.conf y
<directorio_instalacion>\config\i+tms\i+tms2swift.conf
INNOVATIVE SOFT
MANUAL
En estos archivos se puedem configurar los siguientes parametros :
1.-wrapper.java.command=java (comando que ejecuta la maquina virtual de java)
2.- wrapper.java.classpath.1=../../config/i+tms (librerias que requiere la aplicación, cuando se agrega
nueva funcionalidad es posbile que sea necesario agregar a la lista las nuevas librerias)
wrapper.java.classpath.2=./
wrapper.java.classpath.3=../../lib/i+tms/log4j-1.2.14.jar
3.- wrapper.filter.trigger.1=java.lang.OutOfMemoryError (Error o Excepcion que puede generar la
aplicación)
4.- wrapper.filter.action.1=RESTART (accion en caso de presentarse el error, en este caso reinicia la
aplicación)
Para mayor información sobres estos parametros puede consultar el manual de tanuki en la liga
siguiente:
http://wrapper.tanukisoftware.com/doc/english/introduction.html
Pasos de
configuracion
de
notificaciones
1.- editar con notepad , vi o algún otro editor el archivo de configuracion:
<directorio_instalacion>\config\i+tms\EmailNotification.txt
modifique los valores de conexion al servidor de correo, en el que requiera habilitar recepción de las
notificaciones de excepciones via correo, si desea interrumpir de inmediato el envio de notificaciones
cambie el valor de la variable disableNotifications a yes.
Pasos de
instalación
del
programador
de tareas
1.- editar con notepad , vi o algún otro editor el archivo de configuracion:
<directorio_instalacion>\config\i+tms\QuartzItmsServer.properties
cambie solamante los siguientes parametros como necesite
org.quartz.scheduler.rmi.registryHost = localhost (ip del servidor)
org.quartz.scheduler.rmi.registryPort = 1099 (puerto del servicio rmi)
org.quartz.threadPool.threadCount = 5 (cantidad máxima de trabajos simultaneos)
2.- Ejecute el comando <directorio_instalacion>\scripts\i+tms\i+tmsSchedulerServer
Pasos de
instalación de
webservices
1.- Define las propiedades de sistema de java para las variables conforme lo requiera el servidor de
aplicación
org.quartz.properties=<directorio_instalacion>\config\i+tms\QuartzItmsClient.properties
base.itms.dir=<directorio_instalacion>
java.rmi.server.hostname =<direccion ip servidor de calendarizacion o itms Scheduler>
donde el directorio corresponde la la ruta de instalacion del software i+tms normalmente c:\isoft o
INNOVATIVE SOFT
MANUAL
/isoft
Ejemplo de comando .de definicion de propiedad en el sistema en glassfish 4.0
c:\glassfisg4\bin\asadmin
asadmin> create-system-properties org.quartz.property=/isoft/scripts/i+tms/QuartzItmsClient.properties
Wel logic puede configurar los parametros en la consola en server properties se agregan los argumentos
ej.: -Dorg.quartz.properties=<directorio_instalacion>\config\i+tms\QuartzItmsClient.properties
2.- editar con notepad , vi o algún otro editor el archivo de configuracion:
<directorio_instalacion>\config\i+tms\QuartzItmsServer.properties
cambie solamante los siguientes parametros como necesite
org.quartz.scheduler.rmi.registryHost = localhost (ip del servidor)
org.quartz.scheduler.rmi.registryPort = 1099 (puerto del servicio rmi)
org.quartz.threadPool.threadCount = 5 (cantidad máxima de trabajos simultaneos)
3.- Configure el pool de conexiones de base de datos con la siguiente informacion
a) Data Source
Pool Name: DS_SWIFT_DATABASE
Resource Type: java.sql.Driver
Driver Classname: nombre de la clase del vendor de base de datos que implementa el driver de sql (ej.:
net.sourceforge.jtds.jdbc.Driver)
Propiedades (user, password y URL) correspondiente a la base de datos que se conectara la apliación
b) Recurso JDBC
JDNI Name: jdbc/DS_SWIFT_DATABASE
4.- Realizar el despliegue del web archive (archivo war)
*Es necesario que el servidor de aplicacion tenga acceso a la libreria del manejador de base de datos
para lograr la comunación a la base de datos,
ejemplo: glassfish con sqlserver implica colocar el archivo
<drive>:\glassfish4\glassfish\domains\domain1\lib\ext\jtds-1.2.2.jar
Notas
En el caso de la instalacion en un servidor unix/linux, en la especificacion de rutas de directorios se
cambia el caracter / por el de \
En el caso de utilizar como motor de base de datos SQL Server , es necesario habilitar el protocolo
tcpip de la base de datos con el programa SQL Server Configuration Manager (SQLServer network
INNOVATIVE SOFT
MANUAL
utility)
Ejemplo de configuracion del datasource con mysql en websphere 8.5:
Resource –> JDBC –> JDBC Providers (Name = Mysql , Description= Mysql Database, class Path =
<drive>:/isoft/lib/i+tms/mysql-connector-java-3.1.10-bin.jar, Implementation class name =
com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource
Resource –> JDBC –> Data sources (Provider = Mysql Database, Name = DS_NAME_DATABASE,
JDNI name=jdbc/DS_SWIFT_DATABASE
En la liga Custom properties agregar las variables (databaseName=swift, serverName=<ip servidor de
base de datos>, Port = 3306)
En la liga JAAS – J2C authentication data especificar (alias=root username=root, password=<password
asignado>
Para realizar el despliegue de la aplicacion (Application -> Application Type -> websphere enterprise
applications, click en el boton de install) en el paso “Map context roots for Web modules” especificar
itmsWS para indicarle al servidor de aplicacion que las peticiones de la aplicación se resolveran cuando
se especifice /itmsWS
Verificación
de la
instalacioón
Para corroborar que el servicio esta funcionando puede hacer lo siguiente
1.- Verificar el el servicio windows o daemon unix estan ejecutandose
En Windows ir al panel de control -> Herramientas administrativas -> Services y buscar en la lista de
procesos que el servicio i+tms2bo e i+tms2swift esten iniciados
En Unix verificar la lista de procesos wrapper y java mediante la ejecución con el comado ps -eal en
una session shell
2.-Verificar que las bitacoras no presenten eventos severos o fatales en los archivos de bitacora
<directorio_instalacion>\logs\i+tms\i+tms2bo.log y <directorio_instalacion>\logs\i+tms\i+tms2bo.log
PROCEDIMIENTOS DE DIAGNOSTICOS DE PROBLEMAS
Introducción
Procedimento
de detección
de problemas
A coninuación describimos los pasos de instalación manual del software i+tms
Cada uno de los módulos genera una bitacora de los eventos que suceden en el sistema incluyendo los
errores de excepciones, las cuales se preservan en los archivos con nombre i+tms2swift.log e
i+tms2bo.log ubicados en el directorio isoft\logs\i+tms.
Por las bitacoras se encuentra con el mínimo de información , lo cual puede modificarse cuando se
requiera obtenerse más información sobre el comportamiento de los modulos para ello se requiere
editar los archivos i+tms2bologger.txt o el i+tms2swiftlogger.txt, y cambiar en nivel de registro de la
bitacora cambiando el patron INFO a DEBUG
INNOVATIVE SOFT
MANUAL
Si se requiere cambiar los niveles de registro de la bitacora es necesario reiniciar los procesos
ejecutando los comandos en una consola de DOS:
net stop i+tms2bo ( sh i+tms2bo stop en Unix)
net start i+tms2bo ( sh i+tms2bo start en Unix
o bién:
net stop i+tms2swift ( sh i+tms2swift stop en Unix)
net start i+tms2swift ( sh i+tms2swift start en Unix)
El sistema en terminos generales envia las excepciones de errores en la bitacora como eventos con
nivel de registro INFO (informativo), de tal forma que solamente en ocasiones especiales se requerira
cambiar el nivel de registro de eventos en la bitacora
Eventos
conocidos
A continuación se relacionan los problemas que se han sucitado en el funcionamiento de la aplicación
Excepción
Causa
Procedimiento
...parsing failed:
Probable Cause
El sistema no pudo
reconocer un mensaje
estandar ISO
1.-Extraer el mensaje swift de la bitacora i+tms2bo.log
2.Enviarlo a support@innovative-soft.com
3.-Esperar la actualizacion de las libreria models.jar
4.-Detener los servicios i+tms2bo e i+tms2swift
5.-Reemplazar la libreria en isoft\lib\i+tms
6.Iniciar los servicios i+tms2bo e i+tms2swift
CORRUPTED
DATA FOUND
El sistema no encontro
un secuencia valida en
los formatos en el
archivo
que
esta
procesando
1.- Identificar la hora de registro del error de la bitacora
i+tms2bo.log
2.- Identificar por la hora el nombre del archivo que tiene
información corrupta
3- Verificar en Swift Alliance Access la cantidad de
mensajes vs la cantidad de mensajes en la base de datos
tomando como base la fecha y hora del archivo procesado
4.- En caso de faltar registros solicitar al administrador la
generacion de un reporte con el complemnto de los mensajes
faltantes
5.- Contactar a soporte (support@innovative-soft.com) para
determinar el medio de importación de los archivos
JDBCException
Reporter
El sistema no se puede
conectar a la base de
datos debido a que la red
desconecto la session de
base de datos
1.- Reiniciar los servicios i+tms2bo e i+tms2swfit
2.- Si el problema persiste identificar con el administrador de
base de datos, la razon por la cual el sistema no puede
conectarse al servidor de base de datos
El sistema no procesa los
archivos del directorio
especicados
en
la
variable
fromSWIFTDirectory en
el archivo de parametros
isoft\config\i+tsm\i+tms
2Swift.params.txt
1.-Detenga los servicios i+tms2bo e i+tms2swift
2.-Renombre el archivo con extension .Noprocesa
3.-Reinicie los servicios
4.-Verifique que el proceso se ejecuta normalmente
5.- Envie el archivo renombrado a soporte@innovativesoft.com
6.- Espere instrucciones de soporte para resolver el problema