Guía de Implementación
VTOL CD MX - Guía de implementación 3.8.0.
...
0
| Painel | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
|
...
|
| Painel | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
Se recomienda una lectura inicial de todo el documento antes de comenzar con el procedimiento de implementación de la aplicación.
Además es recomendable tener los conocimientos mínimos del software de base requerido por VTOL para una mejor comprensión de los temas tratados en este documento.
...
...
4.4 Flujo de implementación
En este apartado se explicará la secuencia o los pasos para instalar de cero, configurar e iniciar VTOL Server:
- Verificar y cumplir con los pre-requisitos del sistema, tanto de software como de hardware (apartado 5. Pre-
...
...
- )
- Efectuar la instalación completa mediante el asistente gráfico de instalación (apartado 7.1.1 Instalación de cero de VTOL 3.8)
- Crear la base de datos y ejecutar los script de base de datos (apartado 7.3.1 Creación de la base de datos)
- Iniciar VTOL (apartado 9. Iniciar / detener la aplicación)
- Acceder a la consola web de administración (apartado 10. Acceso administrativo a VTOL)
- Iniciar sesión en la consola web de administración (apartado 11.1 Primer inicio de sesión)
- Configurar las propiedades y las variables iniciales que utilizará VTOL, como por ejemplo "VTOL Core Habilitado" (apartado 11.2 Configuración de la aplicación VTOL)
- Administrar la seguridad del usuario (apartado 12.1 Administración de usuarios para acceso administrativo WEB)
Una vez efectuado el flujo de implementación, dirigirse al documento "VTOL CD MX - Manual de usuario" para conocer cómo operar con el producto VTOL.
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
A continuación se detallarán los pre-requisitos para realizar la instalación de VTOL Server en el sistema.
...
- Windows 32/64 bits
- Windows 7 o superior
- Windows Server 2012 R2 o superior
- Linux 32/64 bits
- Cent OS v7 o superior
| Âncora | ||||
|---|---|---|---|---|
|
- Memoria RAM
- VTOL Engine: 2GB (mínimo disponible para la aplicación)
- VTOL Admin: 2GB (mínimo disponible para la aplicación)
- CPU: cuádruple procesador de al menos 2.6 GHZ
- Capacidad de almacenamiento en Disco Rígido: 20GB o superior
- 1 placa de red de 100Mb o 2 placas de red de 100Mbits para instalación en clúster
| Notawarning |
|---|
| Nota: Los requerimientos de hardware dependerán en gran parte del volumen de transacciones a procesar por el sistemaAdvertencia: Es requerido que NAPSE efectúe un correcto dimensionamiento de los requerimientos del hardware en base a la cantidad de transacciones a procesar y la cantidad de usuarios concurrentes en la aplicación. |
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
- Java Virtual Machine (JDK) 1.8.x (32/64bits acorde al SO)
- Servidor de aplicaciones: J2EE Compliant. Debe encontrarse instalado JBoss Wildfly 1018.0.1.0
- Motor de base de datos:
- MS SQL Server 2012 Service Pack 3 o superior
- Oracle 11.2 o superior
- DB2 9.5 o superior
...
- superior
| Aviso |
|---|
Advertencia: Es requerido que NAPSE efectúe un correcto dimensionamiento de los requerimientos del software en base a la cantidad de transacciones a procesar y la cantidad de usuarios concurrentes en la aplicación. El software de base debe tener instalados todos los parches de seguridad que el fabricante haya liberado hasta el momento. |
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
Caso de Uso: Autorización de una transacción |
|
| |||
Orden | Componente | Acción | Comunicación | ||
1 | C1 | El POS (ubicado en la tienda dentro de la WAN de la empresa) inicia una transacción de venta, anulación o devolución contra VTOL Client especificando el monto y las cuotas. | TCPIP | ||
2 | C2 | Los datos de la autorización pasan por el Firewall principal (ubicado entre la WAN y la LAN de la empresa). Este los deja pasar ya que el puerto 3000 de VTOL Server está habilitado. | TCPIP | ||
3 | C3 | VTOL Server recibe la petición de autorización originada por VTOL Client, por medio de un socket server junto con los datos sensibles de la tarjeta. | TCPIP | ||
4 | C4 | VTOL Server graba la transacción de autorización en la base de datos ubicada en la LAN de la empresa. Los datos sensibles son almacenados encriptados con 3DES utilizando un mecanismo de administración dinámica y aleatoria de llaves. | TCPIP | ||
5 | C3 | Una vez grabada la transacción en la base de datos, VTOL envía la petición al centro autorizador (VISA, POSNET, AMEX, cual corresponda) por el protocolo de comunicación TCPIP utilizando el formato definido por la norma ISO8583 para las autorizaciones financieras. | TCPIP | ||
6 | C5 | La trama enviada por VTOL Server al centro autorizador pasa a través del firewall anterior a la red MPLS que se utiliza normalmente para enlazar a los centros autorizadores. | TCPIP | ||
7 | C6 | El centro autorizador (VISA, POSNET, AMEX, cual corresponda) recibe la petición de autorización desde la red MPLS y aprueba la transacción emitiendo la respuesta por el mismo medio (la red MPLS). Entonces la respuesta, en formato ISO8583, es enviada por el mismo enlace hacia VTOL Server. | TCPIP | ||
8 | C3 | El proceso VTOL (ubicado en la DMZ) recibe la respuesta de la autorización por medio del enlace TCPIP establecido al iniciar la comunicación y procede a validarla y procesarla. | TCPIP | ||
9 | C4 | El proceso VTOL (ubicado en la DMZ) graba la transacción de respuesta en la base de datos por medio del driver correspondiente usando el estándar JDBC y el protocolo de comunicación TCPIP. | TCPIP | ||
10 | C3 | El proceso VTOL envía la respuesta a VTOL Client, ubicado en el POS, por medio del mismo socket que el POS creó en su momento usando TCPIP al puerto 3000. | TCPIP | ||
11 | C2 | El firewall (ubicado entre la red DMZ y la red WAN de la empresa) recibe la respuesta y la rutea al POS originador. | TCPIP | ||
12 | C1 | El POS (ubicado en una tienda de la empresa) recibe la respuesta a la petición de autorización y emite el voucher correspondiente. | TCPIP |
Caso de Uso: Acceso WEB |
|
| ||
Orden | Componente | Acción |
| |
1 | C9 | El usuario desde una PC accede a la consola WEB de VTOL (utilizando HTTPS) para realizar diferentes tareas: monitoreo, configuración, etc. | ||
2 | C3 | VTOL recibe la petición HTTPS y muestra la pantalla de LOGIN para que el usuario se identifique con usuario y contraseña. |
| |
3 | C9 | Opera normalmente hasta finalizar sesión o se haya superado el tiempo máximo de inactividad de sesión. |
|
| Nota |
|---|
| Nota: Para conocer el diagrama de flujo de datos que muestra todo el proceso de autorización visite el anexo 17.9 Flujograma del Proceso de Autorización. |
...
Finalizada la pre-instalación se visualizarán los componentes dentro de la carpeta 'rsvtol' de la siguiente forma:
Carpeta | Descripción |
bin | Contiene los archivos de inicio y de detención de la aplicación como proceso de Windows y de Linux |
configuration | Esta carpeta contiene toda la configuración del Application Server adaptada para que la aplicación VTOL funcione correctamente |
deployments | En esta carpeta se encuentra el EAR de la aplicación |
dist | Posee dos carpetas importantes en su interior:
|
lib | Reservado para uso futuro para que puedan almacenarse librerías |
tmp | Carpeta de temporales del servidor de aplicaciones |
Âncora _Instalación_en_el _Instalación_en_el Âncora _Toc364490913 _Toc364490913
Âncora _Base_de_datos_1 _Base_de_datos_1
Âncora _Configuración_de_la _Configuración_de_la
Âncora _Toc492667833 _Toc492667833
Âncora _Toc165205640 _Toc165205640
7.3 Configuración de la base de datos
| _Base_de_datos_1 | |
| _Base_de_datos_1 |
| _Configuración_de_la | |
| _Configuración_de_la |
| _Toc492667833 | |
| _Toc492667833 |
| _Toc165205640 | |
| _Toc165205640 |
Los scripts, para crear e inicializar la base de datos que emplea la aplicación, se encuentran en la carpeta "scripts" dentro del directorio de instalación del producto. Los scripts se encuentran separados en carpetas según el motor de base de datos al que corresponden y se deben ejecutar en una secuencia determinada según sea necesario crear o actualizar una base de datos de VTOL.
En las siguientes secciones se explica con mayor detalle cada una de las posibilidades.
Âncora _Creación _Creación
Âncora _Toc492667834 _Toc492667834
7.3.1 Creación
| _Creación | |
| _Creación |
| _Toc492667834 | |
| _Toc492667834 |
Los scripts de base de datos existentes deberán ser ejecutados, con el usuario administrador de base de datos.
Cada archivo contiene, como inicio de su nombre, un número que indica la secuencia en que debe ser corrido.
Los scripts se encuentran ubicados en la ruta Jboss/rsvtol/dist/scripts.
Primero se deben ejecutar los script de VTOL CORE, ubicados en:
Jboss/rsvtol/dist/scripts/core/nombreMotorBD
, en el siguiente orden:
- "1-CONSOLE-SCHEMA.sql"
- "2-CORE-SCHEMA.sql"
- "3-CORE-POPULATE.sql"
Por último, se deben ejecutar los scripts del módulo Crédito Débito, ubicados en:
Jboss/rsvtol/dist/scripts/cd-mx/nombreMotorBD
, en el siguiente orden:
- "1-CD-MX-SCHEMA.SQL"
- "2-CD-MX-POPULATE.SQL"
Dónde:
- rsvtol
- es el directorio dentro del Jboss donde se instalaron los componentes de VTOL.
- nombreMotorBD
- corresponde al nombre del motor de base de datos
- mssql – Motor de base de datos MS SQL Server
- oracle – Motor de base de datos Oracle
- db2 – Motor de base de datos DB2
- corresponde al nombre del motor de base de datos
Cuando el motor de base de datos sea MSSQL, tiene que estar activo el isolation level “READ_COMMITTED_SNAPSHOT”. Para activarlo se debe ejecutar el siguiente comando:
ALTER DATABASE [nombre_bbdd] SET READ_COMMITTED_SNAPSHOT On;
Donde nombre_bbdd es el nombre de la base de datos.
Nota: Para que el cambio surja efecto, no debe haber conexiones activas salvo la indicada anteriormente.
| Âncora | ||||
|---|---|---|---|---|
|
| Âncora | ||||
|---|---|---|---|---|
|
...
Los archivos tendrán el nombre:
server.log o server.log.X
Donde X es el número de rotación del archivo de logueo. Cuando llega a un máximo de MegaBytes se van rotando e incrementando este número hasta un máximo, luego se eliminan los más antiguos.
Los archivos de log tienen el siguiente formato:
| Wiki Markup |
|---|
yyyyMMdd HH:mm:ss,SSS LLLLL \[component\] \[Thread_name\] description |
Donde:
- "yyyy" corresponde al año
- "MM" corresponde al mes
- "dd" corresponde al día
- "HH" corresponde a la hora formato 24hs
- "ss" corresponde a los segundos
- "SSS" corresponde a los milisegundos
- "LLLL" a la prioridad de logeo. Valores posibles
- DEBUG: Muestra información más detallada de los procesos, sin contener datos sensibles
- INFO: Muestra información general del funcionamiento de los procesos
- ERROR: Informa un error manejado dentro de la aplicación
- FATAL: Advierte de estados o errores que no tienen incidencia al funcionamiento de la aplicación
- WARN: Advierte sobre estados indebidos dentro de la aplicación
- "component" corresponde al componente interno de la aplicación que efectúa el logueo
- "thread_name" corresponde al nombre y/o número de hilo que se está ejecutando
- "description" corresponde la descripción del evento que está ocurriendo.
A continuación se da un ejemplo:
...
2014-10-10
...
13:44:16,351
...
DEBUG Vtol
ReverseSenderProcess #Reverse: 0 Excluded terminals in process: []
2014-10-10
...
13:44:17,126
...
INFO
...
...
...
...
Thread:
...
RSFMK.AsyncCommWorker-4:
...
MONITOR:
...
DISCONNECTED
...
2014-10-10
...
13:44:17,
...
205 INFO communication RSFMK.AsyncCommWorker-2
...
...
Thread:
...
RSFMK.AsyncCommWorker-2:
...
MONITOR:
...
DISCONNECTED
...
2014-10-10
...
13:44:17,220
...
INFO
...
...
...
...
Thread:
...
RSFMK.AsyncCommWorker-1:
...
MONITOR:
...
DISCONNECTED
...
2014-10-10
...
13:44:17,266
...
INFO
...
...
...
...
Thread:
...
Temp_RSFMK.AsyncCommWorker-2:
...
MONITOR:
...
DISCONNECTED
...
2014-10-10
...
13:44:17,266
...
INFO
...
...
...
...
Thread:
...
RSFMK.AsyncCommWorker-3:
...
MONITOR:
...
DISCONNECTED
...
2014-10-10
...
13:44:17,376
...
INFO
...
...
...
...
Thread:
...
Temp_RSFMK.AsyncCommWorker-1:
...
MONITOR:
...
DISCONNECTED
...
2014-10-10
...
13:44:17,376
...
INFO
...
communication
RSFMK.AsyncCommWorker-5
...
...
Thread:
...
RSFMK.AsyncCommWorker-5:
...
MONITOR:
...
DISCONNECTED
...
2014-10-10
...
13:44:18,139
...
ERROR
...
communication
RSFMK.AsyncCommWorker-4
...
Connect
...
failed:
...
ProvencredClientCommunication(127.0.0.1:6666
...
...
).
...
Retry
...
is
...
set
...
forever.
...
Error
...
Message:
...
Connection
...
refused:
...
connect
...
| Âncora | ||||
|---|---|---|---|---|
|
...
Tabla | Campos | Temporal | |
CreditDebitOperationRequest | cardNumber | NO | |
| expirationDate | NO | |
| cvc | SI | |
track1 | SI | ||
track2 | SI | ||
chipTockens | SI | ||
FinancialTransaction | expirationDate | NO | |
cardNumber | NO | ||
ClosedFinancialTransaction | expirationDate | NO | |
cardNumber | NO | ||
EMVAdviceEntry | chipTockens | SI |
...
<appender name="FILE" class="com.synthesis.fwk.logging.log4j.RollingFileAppender">
</layout> </appender> |
Por otro lado, se debe modificar el Root, comentando la referencia al appender CONSOLE y agregando la priority INFO, como se puede ver en la siguiente figura
...