Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.



Image Removed Image Added 






Guía de Implementación


VTOL CD MX 3.8.0.0

...

Fecha

Revisión

Cambios – Motivo

07/05/2018

1.0

Creación del documento

28/08/20181.1Agregado de apartado "4.4 Flujo de implementación"



Índice


Índice



Âncora
_Ref402522277
_Ref402522277
Âncora
_Ref402522280
_Ref402522280
Âncora
_Ref402522282
_Ref402522282
Âncora
_Ref402522285
_Ref402522285
Âncora
_Ref402522287
_Ref402522287
Âncora
_Ref402522290
_Ref402522290
Âncora
_Ref402522296
_Ref402522296
Âncora
_Ref402522302
_Ref402522302
Âncora
_Toc492667791
_Toc492667791
1. Objetivo

...

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:


  1. Verificar y cumplir con los pre-requisitos del sistema, tanto de software como de hardware (apartado 5. Pre-requisitos del sistema)

  2. 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)

  3. Crear la base de datos y ejecutar los script de base de datos (apartado 7.3.1 Creación de la base de datos)

  4. Iniciar VTOL (apartado 9. Iniciar / detener la aplicación)

  5. Acceder a la consola web de administración (apartado 10. Acceso administrativo a VTOL)

  6. Iniciar sesión en la consola web de administración (apartado 11.1 Primer inicio de sesión)

  7. 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)

  8. 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
_Pre-Requisitos_del_sistema
_Pre-Requisitos_del_sistema
Âncora
_Toc492667801
_Toc492667801
5. Pre-Requisitos del sistema

...

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:

  • config: contiene toda la configuración propia de VTOL
  • scripts: contiene los scripts de base de datos que permiten su creación y populación

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

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

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. "1-CONSOLE-SCHEMA.sql"
  2. "2-CORE-SCHEMA.sql"
  3. "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. "1-CD-MX-SCHEMA.SQL"
  2. "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


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
_Actualización
_Actualización
Âncora
_Toc492667835
_Toc492667835
7.3.2 Actualización

...

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.

...

2014-10-10 13:44:16,351
DEBUG vtol Vtol
ReverseSenderProcess #Reverse: 0 Excluded terminals in process: []
2014-10-10
13:44:17,126 INFO communication RSFMK.AsyncCommWorker-4 CrDb
Thread: RSFMK.AsyncCommWorker-4: MONITOR: DISCONNECTED
2014-10-10
13:44:17,205 INFO communication RSFMK.AsyncCommWorker-2 CrDb
Thread: RSFMK.AsyncCommWorker-2: MONITOR: DISCONNECTED
2014-10-10
13:44:17,220 INFO communication RSFMK.AsyncCommWorker-1 CrDb
Thread: RSFMK.AsyncCommWorker-1: MONITOR: DISCONNECTED
2014-10-10
13:44:17,266 INFO communication Temp_RSFMK.AsyncCommWorker-2 CrDb
Thread: Temp_RSFMK.AsyncCommWorker-2: MONITOR: DISCONNECTED
2014-10-10
13:44:17,266 INFO communication RSFMK.AsyncCommWorker-3 CrDb
Thread: RSFMK.AsyncCommWorker-3: MONITOR: DISCONNECTED
2014-10-10
13:44:17,376 INFO communication Temp_RSFMK.AsyncCommWorker-1 CrDb
Thread: Temp_RSFMK.AsyncCommWorker-1: MONITOR: DISCONNECTED
2014-10-10
13:44:17,376 INFO communication
RSFMK.AsyncCommWorker-5 CrDb 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:66660). Retry is set forever. Error
Message: Connection refused: connect

...

<appender name="FILE" class="com.synthesis.fwk.logging.log4j.RollingFileAppender">
<errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>
<param name="File" value="${jboss.server.log.dir}/server.log"/>
<param name="Append" value="false"/>
<param name="MaxFileSize" value="20MB"/>
<param name="MaxBackupIndex" value="10"/>
<param name="datasourceJndiName" value="java:/RS-VTOL" />
<param name="insertAuditQuery" value="insert into rs_audit (type, date_time, source, logon_name, description) values ('Info', ?, 'Logging Rotation Process', 'SYSTEM', 'RollingFileAppender executed. A new log file was created. Oldest log file was deleted.')" />

<layout class="org.apache.log4j.PatternLayout">










Wiki Markup
<param name="ConversionPattern" value="%d %-5p \[%-20.20c\{1\}\] \[%t\] %m%n"/>











</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

...