Está en la página 1de 33

Cliente:

Technisys

Proyecto:
Cyberbank View Server

Documento:
Manual de configuracin
Noviembre 2016
Versin: 1.1

1. Introduccin
2. Requerimientos y configuracin de software
3. Base de datos
3.1 Creacin scripts bases de datos - DatabaseExporter
3.2 Script creacin bases de datos
3.3 Despliegue de Scripts
4. Instalacin
4.1 Parametrizacin de carpetas externas
4.2 Configuracin de archivos de propiedades
Archivo coresMap.xml
Archivo server.properties
Archivo webClient.properties
Archivo log4j.webclient.xml
4.3 Preparacin del aplicativo
4.4 Instalacin de la aplicacin
4.4.1 Tomcat
Instalacin
Detencin
Desinstalacin

Verificacin exitosa de la instalacin


4.4.2 WebSphere
Instalacin
Detencin
Desinstalacin
Verificacin exitosa de la instalacin
4.4.3 Weblogic
Instalacin
Detencin
Desinstalacin
Verificacin exitosa de la instalacin
Historial de Cambios

1. Introduccin
Este documento especifica los parmetros de configuracin del ambiente y los lineamientos
para la instalacin del producto.

2. Requerimientos y configuracin de software


El software que puede ser utilizado para ejecutar la aplicacin se describe en la siguiente
tabla.
Software

Tipo

Versin

Java VM

Mquina virtual

1.6.x

Apache Tomcat

Web Container

5.5, 6 o 7

Oracle

Database

11g

Respecto al Navegador, es decisin del cliente el navegador que desea utilizar. En la siguiente
tabla se detalla los posibles browsers
Software

Versin

Mozilla Firefox

3.0 o superior

MS Internet Explorer

10 o superior

Google Chrome

26 o superior

Como pre-requisito para iniciar la instalacin se debe tener instalado


Java VM Sun 1.6.x.
Base de datos con el esquema creado.
Tomcat 6x/7x
Navegador Web

3. Base de datos
NOTA: ESTA SECCIN DEBE SER REALIZADA SLO EN LOS CASOS EN QUE ES NECESARIO
ACTUALIZAR LA BASE DE DATOS POR COMPLETO.

3.1 Creacin scripts bases de datos - DatabaseExporter


La herramienta utilizada para generar los script necesarios para crear una base de datos
desde cero, se pueden generar con el DatabaseExporter.
Para configurar el mismo apuntando a la base que requerimos como destino, se debe seguir el
siguiente manual
Database Exporter - Manual de Configuracin

La salida del mismo sern los script que se utilizarn a continuacin.

3.2 Script creacin bases de datos


Esta base de datos contiene las pantallas y sus flujos que resuelven las funcionalidades del
canal. Es una base de datos esttica que slo puede cambiar en el caso de que se instale un
nuevo release de producto.

Rol/Servidor

Base de datos

Script

Tipo de usuario

VIEW

Segn ambiente

SCRIPT\Despliegue\Esqu
ema\0.creacion_BaseDato
s.sql

ADMINISTRADOR Base

VIEW

Segn ambiente

SCRIPT\Despliegue\Esqu
ema\1.script_inicial_esque
ma.sql

ADMINISTRADOR Base

VIEW

Segn ambiente

SCRIPT\Despliegue\Dato
s.zip\Datos\2.script_para
metrizacion.sql

ADMINISTRADOR Base

VIEW

Segn ambiente

SCRIPT\Despliegue\Esqu
ema\3.script_inicial_constr
aints.sql

ADMINISTRADOR Base

El script 0 debe editarse para definir el nombre de la Base de Datos a crear, luego los script 1,
2, 3 deben ser editados en la etiqueta SET SCHEMA <XXXX> por SET SCHEMA
<Usuario_Aplicativo> designado o ya creado en seccin 3.2 para el ambiente, una vez
realizado el cambio en todos los scripts mencionados, deben ser ejecutados en el orden que
se presenta a continuacin:
0.creacion_BaseDatos.sql
1.script_inicial_esquema.sql
2.script_parametrizacion.sql
3.script_inicial_constraints.sql
Nota: si surgen errores en las tablas layoutaction, layoutcache, en los contrainsts de la tabla
diccionario o en la creacin de ndices al ejecutar el script 3, no es relevante.
Aclaracin: El nombre de la base de datos debe ser modificado, cuando se realice el cambio
se debe considerar para modificar los archivos de parametrizacin de la aplicacin.

3.3 Despliegue de Scripts


Si se requiere realizar un cambio en el nombre de la base de datos debe modificarse en el
archivo 0.creacion_BaseDatos.sql y tener en consideracin este cambio para la configuracin
del archivo de propiedades del servidor del view (server.properties).
Si ya existe una instalacin previa de Cyberbank View, realizar backup de la base de datos
cuyo nombre est especificado dentro del archivo 0.creacion_BaseDatos.sql alojado en el
servidor o cuyo nombre eligi el banco en el momento de instalar la versin anterior. Para
realizar este backup se deben utilizar los comandos propios de db2 y lo debe realizar un
usuario con permisos de administrador en la base de datos, una vez realizado el backup, se
debe eliminar la base de datos completa (con mismo usuario):

4. Instalacin

En el presente se indicar cuales son los archivos de propiedades necesarios para configurar
la aplicacin independientemente de donde se instale la misma. Luego se mostrar en detalle
la forma de instalarla.

4.1 Parametrizacin de carpetas externas


La configuracin que se aplicar se encuentra en un carpeta externa la cual puede ser
especificada en una variable de entorno en la JVM al iniciar el servidor. El nombre de dicha
variable es desktop-webserver.configPath, por lo que el parmetro pasado a la JVM deber
ser -Ddesktop-webserver.configPath=path.
Ejemplo: -Ddesktop-webserver.configPath=/cyberbank/desktop-webserver/config
Esto permitir que la inicializacin del contexto de spring tome la carpeta especificada para
localizar los archivos de propiedades descritos en la siguiente seccin.
En caso de no establecer la variable de entorno, se tomar por defecto el valor definido en la
inicializacin del bean applicationProperties del archivo webclient.applicationContext.xml

4.2 Configuracin de archivos de propiedades


Los archivos que contiene la carpeta de configuracin definida en la variable de entorno (o en
su defecto su valor por default) se detallan a continuacin (asumiendo que en el parmetro el
valor definido es -Ddesktop-webserver.configPath=configView).
desktop-webserver/config
/coresMap.xml
/server.properties
/webClient.properties
/log4j.webclient.xml
/collectionTable.properties
/MasterKey.key
/staticActions.xml
/viewActions.xml

Archivo coresMap.xml
Este archivo posee todos los cores contra los que puede transaccionar la aplicacin as como
la forma de acceso al mismo.
Cada Core es configurado mediante una implementacin y sus respectivas propiedades:
<bean id="coreX" scope="prototype" class="clase_que_lo_implementa">
<property name="host" value="ip" />
<property name="port" value="puerto" />
<property name="responseTimeOut" value="timeout"/>
</bean>

Esta implementacin es la encargada de comunicarse con coreX. Podemos definir el host y


el puerto donde se encuentra, como tambin el tiempo de espera de respuesta.
Otra implementacin puede ser mediante Web Services:
<bean id="ws" scope="prototype" class="net.technisys.cyberbank.view.server.core.corews.CoreWsServiceClient"/>

Por defecto Cyberbank View trabaja integrado con Cyberbank Multichannel Manager. Esta
integracin establece un vnculo entre el canal y CMM mediante una librera de TMF. Para
definir la utilizacin de esta librera se debe definir la siguiente instancia en el archivo de
configuracin coreMaps.xml:
<bean id="tmfClassImplementation" scope="prototype" class="net.technisys.multichannel.tmf.facade.impl.TMF"/>
<bean id="tmf" scope="prototype" class="net.technisys.cyberbank.view.server.core.tmf.TmfClient">

<property name="TMFInstance" ref="tmfClassImplementation" />


</bean>

TmfClient se comunica con Tmf para acceder al servicio que corresponda. El atributo
TMFinstance, indica que implementacin de Tmf usar.
Un ejemplo completo del archivo tiene la siguiente forma:
<?xml version="1.0" encoding="UTF-8" ?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xmlns:util="http://www.springframework.org/schema/util"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-2.0.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd
http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.0.xsd">
<util:map id="coreMap" scope="prototype" map-class="java.util.HashMap">
<entry key="core" value-ref="core"/>
<entry key="core2" value-ref="core"/>
<entry key="view" value-ref="view"/>

<entry key="tmf" value-ref="tmf"/>


<entry key="ws" value-ref="ws"/>
</util:map>
<bean id="core" scope="prototype" class="net.technisys.cyberbank.view.server.core.CoreClient">
<property name="host" value="localhost" />
<property name="port" value="4445" />
<property name="responseTimeOut" value="10000"/>
</bean>
<bean id="view" scope="prototype" class="net.technisys.cyberbank.view.server.core.coreview.ViewClient"/>
<bean id="tmfNewClassImplementation" scope="prototype" class="net.technisys.cyberbank.view.server.core.tmf.TMFExtended"/>
<bean id="tmf" scope="prototype" class="net.technisys.cyberbank.view.server.core.tmf.TMFDirectClient">
<property name="TMFInstance" ref="tmfNewClassImplementation" />
</bean>
<bean id="ws" scope="prototype" class="net.technisys.cyberbank.view.server.core.corews.CoreWsServiceClient"/>
</beans>

Importante: este ejemplo es informativo, debe adaptarse a la instalacin.

Archivo server.properties
Contiene las propiedades del servidor de la aplicacin en la forma property=value. A
continuacin se especifica cada una de ellas:
#----------------Datos de la BD--------------------driver
= Driver de conexin de la base de datos (ej para db2 com.ibm.db2.jcc.DB2Driver)
conn
= String de conexin de la base de datos (ej para db2
jdbc:db2://10.1.4.40:50000/TCHPVIEW)
username
= Usuario de la base de datos (ej para db2 DB2INST1)
password
= Password de la base de datos
defaultSchema = Indica el esquema por defecto que utiliza la base de datos
hibernateDialect =Indica el dialecto que se quiere utilizar (es opcional)
acceptAs
= Para DB2 va false | para postgres va true
acceptTrue = Para DB2 va false | para postgres va true
useSlashes = Para DB2 va false | para postgres va true
#----------------Propios del server---------------------

monitorEnabled = Habilita o no el monitor del view, el mismo es para debuguear los casos de uso en
desarrollo ( Dejar valor false por defecto )
monitorPort

= Puerto de escucha del monitor del view, se abre en caso que monitorEnabled=true

loadCache

= Habilita o no el llenado de caches ( Dejar valor en true por defecto )

loadOnDemand = Habilita o no la carga de componenetes bajo demanda, si el mismo es false se


cargan
todos al momento de iniciar la aplicacin ( Dejar valor en true por defecto ).
#Ftp server (no se utilizan las siguientes 4 propiedades de FTP salvo que se indique lo contrario. Dejar
valores por defecto no interfiere en el funcionamiento de la aplicacin)
FTP_HOST =
FTP_PORT =
FTP_USER =
FTP_PASS =
SSL_ENABLE = Dejar false salvo que se indique lo contrario
logOutMessage = Indica si quiero loguear el mensaje completo que se enva a un core X ( Dejar valor
false por defecto )

logInMessage = Indica si quiero loguear el mensaje completo que se recibe de un core X ( Dejar valor
false por defecto )

PROXY_USER = Actualmente no se utiliza, se mantiene por compatibilidad con versiones anteriores


PROXY_PASS = Actualmente no se utiliza, se mantiene por compatibilidad con versiones anteriores
IMAGES_URL = Path donde se consumen ciertas imgenes internas ( Dejar valor images/ por defecto
)
SECURITY_CLASS = Implementacin utilizada la la seguridad del servidor ( dejar valor
net.technisys.cyberbank.view.server.testing.DummySecurity por defecto)
#---------------------Common properties-----------------------VERSION

= Versin de la aplicacin

INSTITUTION_ID = Institucin por defecto en caso que no se especifique ( Dejar valor 1111 por
defecto )
CHANNEL_ID

= Canal por defecto en caso que no se especifique (Dejar valor 8 por defecto )

# Estas propiedades representas una region, afecta al formato de numeros, monedas, fechas y horas.

Ej, es_AR (argentina ej: 1.201,36 ) ; es_CR (costa rica ej: 1,201.36)
LANGUAGE = es
COUNTRY
= CL
ID_PROJECT_DEFAULT
defecto )
IS_DEBUG
se

Proyecto por defecto utilizado en la aplicacin ( Dejar valor 1 por

= Permite ver el nombre del workflow y del layout de una pantalla determinada mientras
navega ( Dejar valor false por defecto )

#------------POOL PARA RECARGAS---------------RELOAD_ENABLED


= Indica si se levanta el listener para la recarga de componentes
( Dejar
valor false por defecto )
RELOAD_CONNECTION_PORT = Puerto de conexin/escucha para las recargas ( Dejar valor 4566
por
defecto )
RELOAD_CORE_POOL_SIZE = Nmero de threads vivos en el pool ( Dejar valor 5 por defecto )
RELOAD_MAX_POOL_SIZE

= Nmero mximo que permite el pool ( Dejar valor 15 por defecto )

RELOAD_BLOCKING_QUEUE_CAPACITY = Tamao de la cola de espera, en caso que el pool de


threads haya llenado su pool size ( Dejar valor 20 por
defecto )
RELOAD_KEEP_ALIVE_TIME = Cuando el nmero de thrads es mayor al core, este es el tiempo
.
mximo de espera de los treads ( Dejar valor 10000 por defecto )
RELOAD_BACKLOG
por

= Longitud maxima de la cola de espera para sockets ( Dejar valor 20


defecto )

consoleReloadEnable
cuando

= Habilita la recarga de componentes por consola del server, solo para


funciona stand-alone ( Dejar valor false por defecto )

#------------Configuracion para coneccion por socket------------------------#Puerto de conexion/escucha del view


CONNECTION_PORT
= Puerto de conexin entre el webcliente y el server para aplicacin standalone
( Dejar valor 4567 por defecto )
CORE_POOL_SIZE
= Nmero de threads vivos en el pool ( Dejar valor 50 por defecto )

MAX_POOL_SIZE

= Nmero mximo que permite el pool ( Dejar valor 55 por defecto )

BLOCKING_QUEUE_CAPACITY = Tamao de la cola de espera, en


haya llenado su pool size ( Dejar valor 1 por defecto )

caso que el pool de threads

KEEP_ALIVE_TIME

= Cuando el nmero de thrads es mayor al core, este es el tiempo mximo de


espera de los treads ( Dejar valor 10000 por defecto )

BACKLOG

= Longitud maxima de la cola de espera para sockets ( Dejar valor 50 por


defecto )

KEEP_ALIVE_QUERY = Un comando de SQL sencillo para mandar a la base de datos para que
queda
viva la conexin ( Dejar valor "SELECT 1" por defecto )

PROFILE_CACHE_EXPIRE_TIME = Tiempo para recargar el cache de perfiles en segundos ( Dejar


valor
180 por defecto )
PROJECT_IDENTIFIER =product/
configurando

Indica el proyecto que tiene asociado el ambiente que se est

cmmtargetchannelid = true Indica la forma en que se carga el canal, dependiendo de la


implementacin. Si es true se carga el canal en la forma esperada por CMM. El canal utilizado es el
especificado en la propiedad cmmchannelid

cmmchannelid

=8

Especifica el canal si la propiedad anterior es true

ADMIT_SERVICE_WITH_UNDERSCORE = true True si el core contra el que se ejecuta admite


guiones bajo en el nombre de los servicios, caso contrario se eliminan los guiones bajos de los
nombres.
PAGINATION_INFO_IN_HEADER = true True si la informacion de paginacion debe viajar en el header
del request, False para que viaje en el body
BANK.MNEMONIC=TECHBANK
BANK.SHORT_DESC=TechBank
LOCAL_CURRENCY.MNEMONIC=ARS
LOCAL_CURRENCY.SHORT_DESC=ARS

Valores necesarios para operadores de techbank


Valores necesarios para operadores de techbank
Valores necesarios para operadores de techbank
Valores necesarios para operadores de techbank

FILL_DEFAULT_VALUES=false

Indica si debe ejecutar el servicio que obtiene los valores por


defecto para las distintas entidades utilizadas
SCOPE=solution=DB;device=DS;actor=BI;country=AR

Scope en el que se levanta la

aplicacin

Dependiendo de la instalacin se van a configurar los valores que correspondan.

Archivo webClient.properties

Contiene las propiedades del servidor web de la aplicacin en la forma property=value. A


continuacin se especifica cada una de ellas:
VERSION

= Versin de la aplicacin

CONNECTION_HOST

= Ip donde se encuentra CyerbankView Server, para el caso en que se ejecuta


stand-alone. Por defecto este valor no se utiliza.

CONNECTION_PORT

= Puerto donde se encuentra CyerbankView Server, para el caso en que se


ejecuta stand-alone. Por defecto este valor no se utiliza.

APPLICATION_TITLE

= Nombre de la aplicacin ( Dejar valor "View Web Client" por defecto)

IS_PROTOTYPE

= Dejar valor en false por defecto

log4jLocation

= Nombre y carpeta donde encontrar log4j.properties. En caso que no se


especifique un directorio, el archivo debe estar en el classpath ( El archivo
debe
estar en la carpeta donde se encuentran los archivos de configuracin por
defecto, sera /configView/log4j.webclient.xml)

IMAGES_URL
valor

= Carpeta dentro del war donde


images/ por defecto )

se encuentran las imagenes (Dejar

CSS_URL

= Carpeta dentro del war donde se encuentran las hojas de estilo (Dejar valor
css/ por defecto )

SCRIPTS_URL

= Carpeta dentro del war donde se encuentran las liberias de jasvascript (Dejar
valor scripts/ por defecto )

FILES_URL

= Carpeta dentro del war donde se encuentran los archivos (Dejar valor files/
por defecto )

USE_QUICK_ACCESS
NOTICE_INTERVAL

= Barra de acceso rpido a un workflow por su cdigo ( Dejar valor false por
defecto )
= Intervalo de llegada de avisos de TRX pendientes para el usuario. Valores en
milisegundos, -1 para no ejecutar. ( Dejar valor -1 por defecto )

NOTICE_INTERVAL_PRELOGIN = Intervalo de llegada de avisos de TRX pendientes previo al login


de en la aplicacin. Valores en milisegundos, -1 para no
ejecutar. ( Dejar valor -1 por defecto )
MENU_RESTRICT
= Habilita la restriccin de seguridad para visualizar todos los menues
disponibles por el perfil del usuario. En caso de ser false se muestran todos los menues
independientemente del perfil del usuario ( Dejar en true por defecto )

MAX_UPLOAD_FILE_SIZE = Tamao mximo permitido de archivo para subir. Medido en bytes ( Dejar
1000000000 por defecto )
TEMP_PATH

= Path temporal de archivos subidos ( Dejar valor c:/ por defecto )

# WORKFLOWS que se ejecutan desde el cliente para tareas especificas dejar valores por defecto
CREATE_NEW_USER = TransitorioTransitorioClientes_CreacionUsuarioEnBaseAClienteTransitorio
FORGOT_PASSWORD = TransitorioTransitorioRegenerarPasswordTransitorio
PENDING_TRXS
= processServiceAuthRequestFor_AuthorizationCaja
#se corresponden con los tipos de archivo indicados en TYPES_OF_FILES (otros,texto,imagenes)
texto
= Se corresponden con los tipos de archivo indicados en TYPES_OF_FILES (otros, texto,
imagenes) ( Dejar valor txt.pdf.doc.rtf por defecto )
imagenes

= Se corresponden con los tipos de archivo indicados en TYPES_OF_FILES (otros, texto,


imagenes) ( Dejar valor gif.jpeg.png por defecto )

MULTI_INSTITUTION = Indica si se debe levantar la aplicacin en la forma multi-institucin ( Dejar


valor
false por defecto )

reportDirectoryPath_win = Directorio de los reportes del view si el Sistema Operativo es de tipo


Windows ( Dejar valor C:\\reports\\Desarrollo\\View\\ReportTemplates\\ por defecto)
reportDirectoryPath_unix = Directorio de los reportes del view si el Sistema Operativo es tipo Unix
( dejar valor /reports/Desarrollo/View/ReportTemplates/ por defecto)
DEFAULT_LANGUAGE

= Idioma por defecto ( Dejar valor espaol por defecto )

CONNECTION_CONNECTOR_CLASS = Indica cual es mi facade para interactuar con el server ( Dejar


valor net.technisys.cyberbank.view.connector.DirectClientConnectorView por defecto )

#Propiedades de impresoras fiscales (nicamente si aplica a la instalacin)


ServerCodebase = URL del servlet de impresin ( Dejar valor http://10.1.12.48:9080 por defecto)
ContextJar
= URL de la librera de interfaz con impresoras (Se debe utilizar el valor del contexto,
{viewContext}, de la aplicacin para usar en la ruta, dejar valor
/{viewContext}/jars/printer-0.0.jar por defecto )

RSConditionServletUrl = URL del servlet de evaluacin de condiciones de Js Rule Services ( Se


debe
utilizar el valor del contexto, {viewContext}, de la aplicacin para usar en la
ruta, dejar valor /{viewContext}/ruleServiceCondition por defecto )

INSTITUTION_ID = Institucin por defecto en caso que no se especifique ( Dejar valor 1111 por
defecto )
CHANNEL_ID

= Canal por defecto en caso que no se especifique (Dejar valor 8 por defecto )

# Estas propiedades representas una region, afecta al formato de numeros, monedas, fechas y horas.
Ej, es_AR (argentina ej: 1.201,36 ) ; es_CR (costa rica ej: 1,201.36)
LANGUAGE = es
COUNTRY
= CL
ID_PROJECT_DEFAULT
defecto )
IS_DEBUG
se

Proyecto por defecto utilizado en la aplicacin ( Dejar valor 1 por

= Permite ver el nombre del workflow y del layout de una pantalla determinada mientras
navega ( Dejar valor false por defecto )

BRANCH_ID = Indica la sucursal por defecto en caso que no se indique ( Dejar valor 1 por defecto )
ENCRYPT_PASSWORD = Indica si se debe encriptar el password para los casos que tenga un login
visible ( Dejar valor true por defecto )
RENDER_NOT_VISIBLE_TAGS=false Compatibilidad: muestra(true)/oculta(false o cualquier otro
valor) el espacio asignado a labels NO VISIBLES.

EXTERNAL_JAR_DIR=/widgets

Carpeta en donde se alamacenan los JARS de los widgets

LOGOUT_URL=/desktop-webserver/sso Logout URL para el flujo de login


USE_CAPTION_TABLE=false Usar caption en tablas para renderizar el header
#XSS_EXCLUSION=<,>
por ,

Usar en el caso que tenga que excluir caracteres especiales. Van separados

ADMIT_RELOAD= En true permite que se recarguen los componentes mediante la url de recarga que se
invoca tambin desde View Config. En ambientes donde no hay hot deploy debe estar en false.

MUST_HIDE_VERSION= Para que el applicationStatus retorne el nmero de versin del server, esta
propiedad debe estar en true, de lo contrario en false
http://xx.xx.xx.xx:yyyy/CONTEXT/applicationStatus.htm

Dependiendo de la instalacin se van a configurar los valores que correspondan.

Archivo log4j.webclient.xml
Contiene la configuracin del nivel de log que se utilizar en la aplicacin. Se debe tener en
cuenta que la ubicacin de este archivo est especificada en el archivo webClient.properties,
en la propiedad log4jLocation.
Este archivo tiene la siguiente forma:
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">


<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
Se especifican las propiedades que tendr el log que aparezca por consola
<!-- LogFile a consola -->
<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
<param name="Threshold" value="INFO"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%m%n"/>
</layout>
</appender>
Se especifican las propiedades que tendr el log que aparezca en el archivo configurado. Se debe prestar especial atencin al
parametro File, aqui se indica donde se dejar el archivo de log de la aplicacin
<!-- LogFile a archivo -->
<appender name="LogFileAppender" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="/home/user/WebClient.log"/>
<param name="Threshold" value="INFO"/>
<param name="Append" value="true"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d] line %-3L [%F: %M] '%m'%n"/>
</layout>

</appender>
Se especifican loggers puntuales para limitar logueos de aplicacines externas o librerias de terceros
<!-- Loggers -->
<logger name="org.jbpm" additivity="false">
<level value="ERROR"/>
</logger>
<logger name="org.hibernate" additivity="false">
<level value="ERROR"/>
</logger>
<logger name="org.springframework" >
<level value="INFO"/>
</logger>
<root>
<priority value="ALL"/>
<appender-ref ref="LogFileAppender"/>
<appender-ref ref="ConsoleAppender"/>
</root>
</log4j:configuration>

Dependiendo de la instalacin se van a configurar los valores que correspondan.

4.3 Preparacin del aplicativo


La estructura del aplicativo depende de la generacin del mismo. Si se gener como war, la
estructura tendr la siguiente forma.
Diners.war
|_WEB-INF/
|
|_web.xml
|
|_ lib/
|
|
|_server.jar
|
|
|_server.applicationContext.xml
|
|_classes/
|
|_webclient.applicationContext.xml
|_scripts/
|_pages/
|_inicio/
|_images/
|_files/
|_css/
|_META-INF/

|_jars/

En el caso que se genere como ear, la estructura es muy similar, conteniendo todo lo anterior
Techbank.ear
|_CyberbankView.war
|
|_... ( lo descripto anteriormente para el war)
|_META_INF

El directorio WEB-INF/lib contiene todas las libreras utilizadas por la aplicacin.


En Scripts contiene libreras javascripts para utilizar por el WebClient.
En Inicio se encuentran las pginas jsp, utilizadas como login.
En images se encuentran las imgenes asociadas a la aplicacin web.
En pages se encuentran las pginas estticas en caso que sean requeridas.
En files se encuentran los archivos temporales que requieran generarse durante la ejecucin.
En css se encuentran las hojas de estilo utilizadas por la aplicacin.
En META-INF se encuentra el manifest del war generado
En jars se encuentran jars de terceros necesarios para alguna funcionalidad externa (su
existencia depende si es necesario algn jar).

Como indicamos en la seccin 4.1, los archivos de configuracin se toman por defecto de la
carpeta /configView, esto puede ser modificado desde la aplicacin.
Para especificar el origen del archivo server.properties, debemos modificar el bean cuyo id es
applicationProperties en la propiedad location. Esto est en el archivo
server.applicationContext.xml, que se encuentra en la ruta Techbank.war/WEBINF/lib/server-x.x.jar detallada en el grfico de la estructura anterior. Quedara de la siguiente
forma:
<bean id="serverProperties" class="net.technisys.properties.spring.TechSpringPropertiesFactory">
<property name="properties">
<props>
<prop key="class">DoubleEncryptionPropertiesResolver</prop>
<prop key="masterKeyFile">file:${desktop-webserver.configPath}/MasterKey.key</prop>
</props>
</property>
<property name="targetPropertiesPath" value="file:${desktop-webserver.configPath}/server.properties" />
</bean>

Para especificar el origen del archivo coresMap.xml, debemos modificar el import sito en el
archivo server.applicationContext.xml, que se encuentra en la ruta Techbank.war/WEBINF/lib/server-x.x.jar detallada en el grfico de la estructura anterior. Quedara de la siguiente
forma:
<import resource="file:/${desktop-webserver.configPath}/coresMap.xml" />

Para especificar el origen del archivo webClient.properties, debemos modificar el bean cuyo
id es applicationProperties en la propiedad location. Esto est en el archivo
webclient.applicationContext.xml, que se encuentra en la ruta Techbank.war/WEBINF/classes/ detallada en el grfico de la estructura anterior. Quedara de la siguiente forma:

<bean id="applicationProperties" class="net.technisys.cyberbank.view.spring.PropertiesUtil">


<constructor-arg value="/cyberbank/desktop-webserver/config" />
<constructor-arg value="desktop-webserver.configPath" />
<property name="searchSystemEnvironment" value="true"></property>
<property name="locations">
<list>
<value>file:${desktop-webserver.configPath}/webclient.properties</value>
<value>file:${desktop-webserver.configPath}/collectionTable.properties</value>
</list>
</property>
</bean>

Por defecto todos los archivos externos se buscarn en el valor que se defina para la variable
${desktop-webserver.configPath}

4.4 Instalacin de la aplicacin


Este punto depende de donde se quiera instalar la aplicacin, vamos a detallar cmo sera la
misma para Tomcat y para WebSphere

4.4.1 Tomcat
Instalacin
1. Iniciar el servidor Apache Tomcat

2. Abrir un navegador Web e ingresar a la pgina principal de Tomcat ( por defecto


localhost:8080 )

3. Dirigirse dentro del menu Administracin, a la opcin Tomcat manager.


Ingresar usuario y password solicitado
4. Ingresaremos a la ventana de Gestor de aplicaciones Web y buscaremos la
seccin de Desplegar.

5. En la subseccin de Archivo WAR a desplegar, presionar el botn Examinar


y elegir el war que quiero deployar.
6. Presionar Desplegar y se doployar el archivo en Tomcat. El mismo ya estar
disponible para utilizar.

7. Si falla, se mostrar un mensaje en el recuadro Mensaje, aclarando las


causas del inconveniente.
Detencin
Para detener la aplicacin, se debe presionar Parar en la seccin de Aplicaciones

Desinstalacin
Para detener la aplicacin, se debe presionar Replegar en la seccin de Aplicaciones
Verificacin exitosa de la instalacin
Se debe validar que en el cuadro de Mensaje no haya aparecido ningn error.
Presionar el link de prueba (En este ejemplo http://10.230.10.43:7003/Techbank)

Historial de Cambios
Versin

Fecha

1.1

09/11/201
5

Autor
Federico Freund

Comentarios
Se agrega propiedad ADMIT_RELOAD y

MUST_HIDE_VERSION