PROMO - Manual de Instalacion 6.1

MANUAL DE INSTALACION

PROMO 6.1

 

Índice

IntroducciónConsola de Administración - PROMO

IntroducciónPre-Requisitos del sistema

Ejecución del Instalador (Windows)Instalación de la aplicaciónEstructura de directorios

Instalación Linux (CentOS 7)Instalación MongoDB 3.4Instalación de la aplicación (Consola de Promo)Configurar Motor de Simulación como servicio en LINUX

PROMO - BRIDGEConfigurar el envío de prefijos de cupones y tarjetas a Bridge

Ejecución del sistemaAcceder a la Consola de administraciónErrores en la instalación de la consolaErrores de inicialización de la consola

Motor de PromocionesIntroducciónPre-Requisitos del sistemaInstalación (Linux/Windows)

Instalación del Motor de PROMO desde el Instalador

Instalación de Versiones Anteriores del Motor de PROMOConfiguraciones Generales del Motor:

Archivos de ConfiguraciónMotor MultitiendaConfiguración de Multitienda

Mantenimiento - MotorDepuración de archivos de logErrores de inicializaciónErrores de procesamiento

Documentación relacionadaInformación de Configuración

Depuración de archivos de backup de Base de datosEnmascarar Contraseña de DBConfiguración de Redes Sociales

Configurar FacebookConfigurar Twitter

Resolución de problemasDesinstalación

Apéndice A: OS4690Instalación de Motor en OS4690

Apéndice B: Variables de EntornoSet PATH JAVA_HOME en Windows

Apéndice C: Actualizaciones de ConsolaActualización por nuevos Release

IntroducciónPROMO es una solución que permite separar el manejo de promociones del punto de venta. Cuenta con dos grandes componentes: el "Motor de promociones", encargado de calcular las promociones participantes cuando se realiza una transacción en el punto de venta e informarlas al mismo una vez finalizado el cálculo; y la "Consola de administración", encargado de brindar una herramienta centralizada de administración. El presente manual ilustra sobre cómo realizar la instalación de ambos componentes y las diferentes opciones que pueden ser configuradas para su funcionamiento.

Consola de Administración - PROMO

Introducción

La Consola de administración es el componente web de administración y creación de promociones, cupones, tarjetas de fidelidad y mapas que posee PROMO. Por medio de esta herramienta se podrá, entre otras cosas, crear promociones y definirle sus condiciones, cupones, tarjetas, combos y beneficios. También se podrán crear los mapas que contienen las promociones para luego generar los archivos de configuración que se cargarán en el " ", para que puedan ser evaluados los tickets y calculadas las promociones en base a las definiciones generadas en la Consola.Motor de promociones

Pre-Requisitos del sistema

A continuación se detallan los requisitos mínimos para la instalación de la Consola de Administración de PROMO que operara con una (1) compañía.Los requerimientos mínimos de hardware se proveen como una guía para el sizing de un ambiente no productivo. Para instalaciones en ambientes productivos con requerimientos específicos de performance y volumen de datos se requiere un sizing particular para estimar la configuración apropiada.

Descripción Requisito mínimo

Servidor de Aplicaciones Wildfly 9

1.

Memoria RAM libre 8 GB

JVM (Java Virtual Machine) jdk-8u25-windows-x64 o superior

Velocidad del procesador 2.5 GHz

Capacidad del disco rígido (libres) 4 GB

Sistema Operativo Windows Server 2008 R2, Windows 7 64-bit

Servidor de base de datos MongoDB 3.4

El uso de máquinas virtuales agrega un overhead que puede afectar la performance o escalabilidad. Nota: se deberá agregar el JDK a la variable de entorno Importante Adicionalmente: %PATH%. (ver 8 Apendice B: Variables de Entorno)

Ejecución del Instalador (Windows)

Deberá ejecutarse desde modo comando el Instalador " " para proceder a la instalación y configuración de la consola y motor de simulación de PROMO. Para esto como administrador promo-console-installer-6.1.0.jardeberá ejecutarse el comando java –jar promo-console-installer-6.1.0.jarTambién se instalarán los siguientes componentes indispensables para el correcto funcionamiento de la aplicación:

Wildfly 9.PromoSimEngine x.x (motor de simulación)MongoDB 3.4

Los servicios de MongoDB y PromoSinEngine quedaran instalados y ejecutándose en estado "Automático" (iniciaran al iniciar el equipo donde está instalado PROMO)Respecto del servicio Wildfly, Inicialmente vendrá configurado por defecto el directorio sugerido, ocupando el puerto 8080 Al finalizar el instalador se crearán e iniciaran todos los servicios y directorios correspondientes.

Instalación de la aplicación

Se deberá ejecutar como administrador, en modo comando el instalador de PROMO ( )promo-console-installer-x.x.x.jar

2. Se presentara la siguiente pantalla donde se deberá presionar " ":Next

3. Luego se solicitará la aceptación de los términos y condiciones de uso de la aplicación.

4. Luego de aceptados los términos y condiciones, se solicitará que se identifique el nombre del usuario y el e-mail de quien (empresa o persona) está realizando la instalación.

5. A continuación se deberá indicar la ruta de acceso a Java y el directorio donde se realizara la instalación de Promo. Por default se propone " ". Cambien se deberá indicar el directorio donde se instalara c:\synthesis\Promola base de datos (MongoDb)

: En caso de que PROMO trabaje integrado con BRIDGE, deberá tildarse la opcion "Install Bridge Integration" para una correcta configuracion de la aplicación.Nota

De no existir los directorios se solicitara autorización para la creación de los directorios necesarios para la instalación de PROMO.

7. Se solicitara indicar el directorio donde se instalara Wildfly.

En caso de no existir el directorio, se solicitara autorización para la creación del mismo.

8. Se solicitara se informe si se desea instalar o solo activar los servicios que se instalan con PROMO.

9. En la siguiente pantalla que se presente, habrá que presionar el botón " " a fin de dar comienzo al proceso de instalación de PROMO y sus componentes.Install

9. Finalizada la instalación se mostrara la siguiente ventana donde se informara la correcta instalación de la consola de PROMO y se solicitara dar Clic en " " para terminar con el proceso.OK

Estructura de directorios

Luego de haber instalado la Consola de administración, quedará una estructura de directorios similar a la siguiente en el directorio de instalación (ej: "c:\synthesis\promo"). Los siguientes directorios y archivos son algunos de los que se deberán tener en cuenta:

synthesis\promo\images: directorio de las imágenes\synthesis\promo\images\profile\synthesis\promo\images\barcode: contiene las imágenes de códigos de barras asociados a cupones emitidos.\synthesis\promo\images\promotion: contiene las imágenes que se asocien a las promociones\synthesis\promo\logs: información sobre las trazas de ejecución de la aplicación, incluyendo información técnica ante cualquier falla.\synthesis\promo\backup: backups de la base de datos MongoDB\synthesis\promo\import: directorio donde deberán alojarse los mapas para la importación de promociones.\synthesis\promo\mdb: aquí se encuentran las funciones utilizadas en la base de datos.\synthesis\promo\engine: el motor de promociones que utiliza la consola para la simulación de las mismas.\synthesis\promo\catalogs: directorio donde se alojaran los archivos de catálogo (. ) que se importaran al iniciar la aplicación. Deberán generarse de manera manual las carpetas correspondientes a cada catalogscompañía, indicando en el nombre del directorio el ID de la compañía. (Ej.: \synthesis\promo\catalogs\22 donde 22 corresponde al ID de la nueva Ccia)

Instalación Linux (CentOS 7)

Es requisito que antes de realizar la instalación de la consola estén instaladas los siguientes componentes:

MongoDB 3.4JDK 1.8.0_25

1.

Junto con la consola de PROMO, durante el proceso se instalarán el motor de simulación y Wildfly.

Instalación MongoDB 3.4

Se pueden seguir los pasos en la documentación de instalación online de Mongo.

Linux: https://docs.mongodb.com/v3.4/tutorial/install-mongodb-on-red-hat/

Luego de que mongo se encuentra instalado se debe configurar la seguridad del mismo de la siguiente forma:

Ejecutar el servicio de Mongo mediante sudo service mongod start

2. Ejecutar el comando mongo

3. El sistema quedará dentro de la consola de Mongo, con lo cual allí mismo se deberá ejecutar los siguientes comandos:

>use promo

>db.createUser({user:"promousr", pwd:"nosotros", roles:[{role:"dbOwner", db:"promo"}]})

Nota: se utiliza en estos ejemplos el nombre de usuario "promousr" y el password "nosotros", esto puede ser cambiado acorde a lo requerido por el usuario.

4. Salir de la consola mediante el comando " "exit

5. Ejecutar el comando > para frenar la ejecución de mongo.service mongod stop

6. Editar el archivo y descomentar el tag " " para habilitar la seguridad, colocando la siguiente línea como se muestra en la imagen:/etc/mongod.conf Security

Instalación de la aplicación (Consola de Promo)

Se deberá ejecutar como el instalador entregado desde línea de comando de la siguiente forma:root

Donde X.X.X Corresponde al número de versión de PROMO que se está instalando.

Luego de ejecutado el instalador, comenzará a descomprimirse el archivo para dar comienzo a la instalación,

Terminada la descompresión, se solicitara autorización para proceder con la instalación de la aplicación, dar clic en " "Next

En la siguiente pantalla se deberán aceptar los términos y condiciones de uso, una vez leídos los mismos, de estar de acuerdo, dar clic en " " para continuar. Accept

Se deberá proveer de un nombre (persona física u organización) y un mail para poder registrar la aplicación y proseguir con la instalación, así como también se solicita re confirmar la aceptación de los términos y condiciones.Completados los campos, presionar " ":Next

A continuación se deberá indicar la ruta de acceso a Java y el directorio donde se realizara la instalación de Promo. Por default se propone " ". También se deberá indicar el directorio donde se instalara la /usr/local/promo/base de datos (MongoDb)

Nota: En caso de que PROMO trabaje integrado con BRIDGE, deberá tildarse la opción "Instalar Integración con Bridge" para una correcta configuracion de la aplicación.

De no existir los directorios se solicitara autorización para la creación de los directorios necesarios para la instalación de PROMO.

Presionar " "Si

En la siguiente ventana se solicitara indicar el directorio donde se instalara Wildfly.

En caso de no existir el directorio, se solicitara autorización para la creación del mismo. Dar clic en "Si"

Para iniciar con instalación, en la siguiente pantalla habrá que presionar el botón " " a fin de dar comienzo al proceso de instalación de PROMO y sus componentes.Installar

Durante la instalación se presentara una ventana de progreso donde se podrá visualizar los componentes que se están instalando y su progreso.

Finalizado el proceso se presentara un pop-Up de proceso terminado, donde se deberá presionar " " y luego " " para terminar el proceso.Aceptar Salir

Una vez instalada la consola, sera requerido iniciar Wildfly, lo cual podrá hacerse manualmente ejecutando " ", o bien podrá configurarse Wildfly como servicio en linux siguiendo los pasos indicados en la sudo ./standalone.shWeb para tal fin.

Configurar Motor de Simulación como servicio en LINUX

Deberá generarse un archivo desde cualquier editor de texto, con el nombre " " y deberá contener las siguientes líneas:promo.service

Una vez generado el archivo, debera guardarse en y ejecutar el siguiente comando para notificar al sistema:  /etc/systemd/system

Luego habrá que habilitarlo para que ejecute al inicio con el siguiente comando:

De ser necesario accionar sobre el servicio podrán ejecutarse los siguientes comandos:

systemctl start promo   iniciar el servicio   detener el serviciosystemctl stop promo

  reiniciar el serviciosystemctl restart promo    ver estado del servicio1systemctl status promo

PROMO - BRIDGE

Durante la instalación de la consola de promociones podrá indicarse si ésta operará integrada o no con Bridge.De ser así, será requerido tener instalado previamente Bridge Manager ya que Promo utilizara servicios y vistas de Bridge.

Para Instalar la consola integrada con Bridge, durante el proceso de instalación, ya sea sobre Windows o sobre Linux, deberá tildarse en la ventana de Opciones de Instalación, la opción "Instalar Integración con Bridge"

Con lo cual, al presionar "Siguiente", en el siguiente popUp se mostrara como ruta para Wildfly, el directorio donde este instalado la App Server de Bridge. Tambien debera tenerse en cuenta que el archivo de configuracion para las conexiones con la base de Bridge, entre otras configuraciones, propias de PROMO sera " ".promoconfig.propertis

En este archivo, aparte de encontrar las opciones de configuracion de redes sociales, base de promo (mongoDB), y la estructura de directorio por defecto, tambien enocntraran los valores de configuracion para la integracion con bridge, ya sea se utilice una base SQL o una base Oracle.

Ejemplo:

De usarse un esquema de base de datos u otro habra que descomenar y configurar la opcion correspondiente.

Configurar el envío de prefijos de cupones y tarjetas a Bridge

1- En la consola de PROMO. Ir a Administración > Información de configuración.

2- Buscar " " (clave) de la categoría .soap.url promo.bridge

El valor deberá ser la URL al servicio de Bridge Manager que espera recibir los prefijos. Ejemplo: http://10.x.1x.1x:8180/bridge/services/bridgeCoreSOAP?wsdl.

3- Para forzar la ejecución de este servicio se puede ejecutar el job "Exportación de Tipos de Tarjetas y Cupones a Bridge (SOAP)" en Administración > areas programadas.T

Ejecución del sistema

Acceder a la Consola de administración

Una vez instalada la consola de PROMO podrá ser accedida desde algunos de los siguientes browsers soportados por Promo: o ,Firefox Google Chorme

Ingresar la siguiente URL en la barra de direcciones del :Browser

http://IP-SERVIDOR:8080/promo

Donde es la dirección IP o DNS del computador donde se está ejecutando el servidor de aplicaciones.IP-SERVIDOR

Errores en la instalación de la consola

404 – ERROR de Inicializacion en Instalador

Este error pude se produce al no iniciarse la instalación de la consola desde una pantalla de comando ejecutada como administrador. Se deberá ejecutar como administrador, en modo comando el instalador de PROMO (promo-console-installer-6.x.x.jar)

Errores de inicialización de la consola

404 – ERROR (al iniciar la aplicación WEB)Este error pude producirse porque no está levantado el servicio WildFly. Deberá revisarse en los servicios del sistema que el servicio WildFly este en ejecución. De no estarlo, iniciarlo y refrescar la página del navegado y volver a probaOtro de los motivos por los cuales pueda darse este error es que no se haya descomprimido correctamente el aplicativo, para corroborarlo habrá que chequear en el directorio de instalación synthesis\promo\appse

si hay un archivo llamada " ". De encontrarse este archivo, indicara que se ha producido un error en la inicialización de la aplicación. Contactar al administrador del rver\standalone\deployments promo.war.failedsistema para su solución.

Nota: Se recomienda realizar un chequeo de los servicios agregados luego de la instalación de PROMO para cerciorarse de que estén iniciados y ejecutándose correctamente. Para ello, acceder a los servicios del sistema y chequear que los siguientes servicios estén corriendo:

Wildfly // MongoDB // PromoSimEngine

Motor de Promociones

Introducción

Como se mencionó en el punto anterior, el motor de promociones es el componente de PROMO encargado de recibir tickets directamente desde el punto de venta, luego procesarlos, y, finalmente, informar las promociones que participaron y los artículos afectados.La instalación el motor de promociones se realiza conjuntamente con la instalación de la consola de Promo, al ejecutarse el instalador de la aplicación. La comunicación se establece a través de mensajes XML enviados mediante TCP/IP o Pipes (IBM 4690).

Pre-Requisitos del sistema

En el siguiente cuadro se detallan los requisitos mínimos y recomendados para la instalación del motor de promociones:

Descripción Requisito Mínimo

Memoria RAM libre (con HD) 512 MB

JVM (Java Virtual Machine) Versión 1.8

Velocidad de procesador 2 GHz

Capacidad de disco rígido (libres) 1 GB

Sistema Operativo Según requisitos.

Instalación (Linux/Windows)

Instalación del Motor de PROMO desde el Instalador

Se provee un archivo donde X.X.X es la versión del motor que se está instalando. promo-gengine-installer-X.X.X.jarSe deberá ejecutar como administrador, en modo comando el instalador del Motor de PROMO ( )promo-gengine-installer-X.X.X.jar

Al ejecutarse el instalador aparecerá la siguiente ventana:

Presionar "Siguiente" para continuar.

Se deberán aceptar los términos y condiciones para continuar con la instalación del motor de PROMO.

Presionar en " " para continuar.Aceptar

Luego de aceptados los términos y condiciones, se solicitara que se identifique el nombre del usuario y el e-mail de quien (empresa o persona) está realizando la instalación.

Presionar " " para continuar.Siguiente

A continuación se deberá indicar la ruta de acceso a Java y el directorio donde se realizara la instalación del motor de PROMO. Por default se propone " ". c:\synthesis\gengine

Se podrá indicar aquí, por medio del check "Instalar Servidor REST (Default TCP/IP)", para que se instale el motor como SERVIDOR REST sino se instalara por default en modo TCP/IP.

Presionar " " para continuar.Siguiente

En el siguiente Pop-UP se deberá indicar la URL de acceso a "Director" para futuras actualización y el código de tienda que tomara el motor A continuación se deberá indicar

Presionar " " para continuar.Siguiente

En la siguiente pantalla que se presente, habrá que presionar el botón " " a fin de dar comienzo al proceso de instalación del motor de PROMO y sus componentes.Instalar

Finalizada la instalación se mostrara la siguiente ventana donde se informara la correcta instalación del motor de PROMO. Se solicitara dar Clic en " " y luego en " " para terminar con el proceso. Aceptar Salir

1. 2. 3. 4.

Terminado el proceso de instalación del motor de promociones podrá chequearse en los servicios del sistema la existencia de dos nuevos servicios correspondientes al motor de promociones y al agente Director que ya estarán ejecutándose de manera atomística, hecho que marcara la correcta instalación y puesta en funcionamiento del nuevo motor de PROMO.

Instalación de Versiones Anteriores del Motor de PROMO

Se provee un archivo g-engine-x.x.x-installer.zip donde x.x.x es la versión del motor que se está instalando. Para instalar:

Crear una carpeta donde se ejecutará el motor (Cuidado de tener permisos de lectoescritura en la misma)Descomprimir el contenido del zip en dicha carpeta.Modificar el archivo con los parámetros correctos de configuración acorde al entorno en que se estará ejecutando.conf/config.xmlEjecutar en modo comando como administrador " " en Windows o " " en Linux.tcp.bat sudo ./tcp.sh

Configuraciones Generales del Motor:

Archivos de Configuración

CONFIG.XML

<general> <simulation>false</simulation>

<compatibilityMode>false</compatibilityMode> <mapIdentifiers></mapIdentifiers>

<ticketIdentifiers>store,terminal</ticketIdentifiers>

<disableLoyalty>false</disableLoyalty> <!- ->identificar unico por cada instancia del motor.

<!-- <engineId></engineId> --> <!- ->Nombre unico por cada instancia del motor.

<!-- <engineName></engineName> --></general>

</simulation> : Indica si el motor opera para simulaciones desde la consola o no. Valor por defecto "False" (No simulación)</compatibilityMode> : indica si el motor opera en modo compatible con el antiguo motor (Integraciones 4690) agrupando o no los beneficios en la respuestas dadas por el motor. Por default el parámetro viene definido en "False" (No compatble) por lo que en este modo agrupara los beneficios (motor nuevo). En caso de definir el beneficio en "True", no se agruparan los beneficios (compatibilidad con

antiguo motor). </ >: identificaran las carpetas por las cuales el motor irá en búsqueda del mapa para evaluar la promoción. Deberán definirse en una lista separada por comas.mapIdentifiers

</ >: indicara por qué atributo se identificara al ticket cuando el motor opere como multiempresa.ticketIdentifiers</disableLoyalty>: El valor por default de este parámetro será "false" indicando que el motor mantiene una comunicación con PROMO central para la gestión de elementos de Fidelidad. En caso de configurar en "true" este parámetro, se deshabilitara la comunicación con PROMO central, por lo que un status de Finish, commit, rollback, etc etc se evaluara como un status "sales" (método de evaluación

previo a Fidelidad). </engineId>: identificador único del motor. Deberá configurarse cuando se desee que el motor reporte su mapa activo a la consola de PROMO.

</engineName>: Nombre único del motor. Junto con el "EnginerId" deberá configurarse cuando se desee que el motor reporte su mapa activo a la consola de PROMO.

Configuración de la operatoria OffLine del Motor:

<offline> <!- ->Directorio donde se guardarán los tickets offline

<directory>offline</directory>

<!- ->Cantidad de segundos en los que chequea offline

<check>60</check></offline>

Directorio de donde tomara los mapas:

<map> <!- ->Directorio desde donde el motor lee los mapas

<directory>sales</directory>

<!- ->Cantidad de segundos en los que chequea nuevo mapa <check>60</check>

<!- ->Cantidad de dias hasta remover el archivo del mapa <daysUntilRemoval>100</daysUntilRemoval>

<!-- remover mapas simulados --> <removeSimulatedMaps>true</removeSimulatedMaps>

<!-- máximo numero de mapas simulados a mantener --> <simulatedMapsMax>10</simulatedMapsMax>

<!-- máximo numero de mapas simulados para iniciar el proceso de remoción -->

<simulatedMapsThreshold>30</simulatedMapsThreshold></map>

Configuración de Decimales en la respuesta:

<response>

<!- ->Decimales de redondeo de la respuesta

<roundDecimals>2</roundDecimals>

<roundCountables>3</roundCountables>

</response>

Puertos:

<server> <!- ->Puerto del servidor rest

<rest>8888</rest> <!- ->Puerto del servidor socket

<socket>3000</socket></server>

Conexión con PROMO Central:

<promoCentral> <url> </url>http://localhost:8080/promo

<user>sender</user> <password>mate</password>

<!- ->Descomentar en el caso que la mensajería no lo implemente y se requiere el envió de un valor fijo

<!-- companyId></companyId --></promoCentral>

LOGGING.PROPERTIES

En este archivo podrán configurarse los niveles de logueo de la consola, siendo el nivel SEVERE el nivel por default y ALL el nivel de logueo para debug.

# Agregar -Djava.util.logging.config.file=logging.properties como parametro a la JVM

_# http://www.javapractices.com/topic/TopicAction.do?Id=143_

handlers = java.util.logging.ConsoleHandler java.util.logging.FileHandler

.level = SEVERE # File Logging

java.util.logging.FileHandler.pattern = ./logs/gengine.log java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter

java.util.logging.FileHandler.level = SEVERE

# Console Loggingjava.util.logging.ConsoleHandler.level = SEVERE

Motor Multitienda

El Motor de promociones cuenta con la posibilidad de que levante y lea mapas de diferentes directorios. Cada directorio se corresponderá con una tienda distinta y en cada directorio se listará un conjunto de mapas.El modo Multitienda se activa por configuración, encontrándose desactivado por default. La mensajería asociada al motor no se verá alterada por la activación del modo Multitienda.

Configuración de Multitienda

Para que el motor de promociones funcione en modo Multitienda, deberá de editarse el archivo y editar el siguiente tag:"…\conf\Config.xml"

<general> ……

<mapIdentifiers></mapIdentifiers> <ticketIdentifiers>store,terminal</ticketIdentifiers>

……</general>

Donde en se identificaran las carpetas por las cuales el motor irá en búsqueda del mapa para evaluar la promoción. Deberán definirse en una lista separada por comas. <mapIdentifiers></ mapIdentifiers>En caso de tener elementos, en deberá quedar solamente definido "terminal" ya que al ticket se lo va a identificar siempre por la concatenación de y <ticketIdentifiers></ticketIdentifiers> <mapIdentifiers> <ticketIdentifiers>Para que los cambios sean tomados correctamente se deberán guardar los cambios y reiniciar el motor de promociones.

Mantenimiento - Motor

Depuración de archivos de log

Como se mencionó anteriormente, los archivos donde se registran los eventos que suceden en el motor de promociones son almacenados en uno o varios archivos de log. Estos archivos pueden crecer en tamaño dentro del disco rígido, quitando espacio que el usuario puede utilizar para otros fines. Por lo tanto es posible que se requiera eliminar algunos de estos archivos para liberar espacio. Para eliminar los archivos de log será necesario consultar el archivo de configuración de log ( ). En él estarán especificadas las políticas de log, los archivos y los directorios destinados para este ../conf/logging.propertieslfin.

Errores de inicialización

Los siguientes son errores que pueden producirse al iniciar el motor de promociones:

java.io.FileNotFoundException: \log\669comm.log (El sistema no puede hallar la ruta especificada)Indica un error en la configuración del archivo de log. El error indica que no puede encontrar la ruta o el archivo '\log\669.comm.log'. Para solucionarlo, se recomienda revisar el archivo de configuración config/log4j.xml.

Exception in thread "main" java.lang.NoClassDefFoundError: …Este error ocurre cuando hay errores en el classpath.

java.net.BindException: Address in use: JVM_BindEste error se produce cuando el puerto de comunicaciones que utilizará el Motor de promociones está reservado o siendo utilizado por otra aplicación. Sólo puede suceder en una comunicación TCP/IP. Para solucionarlo se recomienda determinar cuál es la aplicación que utiliza el puerto y cerrarla o configurarla para que utilice otro, o bien modificar la configuración del Motor de promociones para que establezca sus comunicaciones por un puerto diferente (a través del archivo de configuración, propiedad ).promoCommunication.port

Errores de procesamiento

Durante su funcionamiento, el motor de promociones podrá informar errores similares a los enunciados a continuación:

[promo.MIDDLEWARE] PROMOENGINE VALIDATION ERROR: [P01] combo-component: invalid use of order-criteria with this setIndica que se ha producido un error en la validación de algún mapa que está intentando cargar. El valor que se encuentra entre corchetes indica en qué promoción se ha producido el error. De no existir los corchetes significa que el error se produjo en la definición de la convivencia de las promociones que se encuentra en el mapa. El texto que sigue a los corchetes describe el tipo de error producido. Asimismo, anterior a esta línea de log se encuentra que mapa se intentó cargar.

[promo.MIDDLEWARE.MESSAGING] Message not accepted: Parser exception parsing input message: Content is not allowed in prolog.Indica que se recibió una petición o ticket que no respeta el formato definido para la mensajería. En estos casos el motor responderá a la terminal que envió el requerimiento un mensaje de respuesta con un código de error (ver " ").Manual de mensajería – Promo

1. 2. 3.

[promo.MIDDLEWARE] There is no PromoEngine available to process this request.Este mensaje se emite cuando el Motor de promociones recibe una petición que indica la utilización de una versión de mapa inexistente. Al igual que en el caso anterior, al no poder resolver la petición, se responderá con un mensaje que especificará un código de error (ver " ").Manual de referencia técnica – API de Promo

[promo.MIDDLEWARE.MESSAGING]- WARNING: INVALID TICKET: cvc-datatype-valid.1.2.1: 's250.0' is not a valid value for 'double'.Indica que se ha recibido una petición o ticket que posee un valor o tipo de dato inválido. En este caso, el motor dará un mensaje de respuesta con un código de error (ver " ").Manual de mensajería – Promo

Documentación relacionada

Documento MANUAL DE INTEGRACION – PROMO 6.1.docDocumento MANUAL DE USUARIO PRINCIPAL – PROMO 6.1.docDocumento MANUAL DE USUARIO FINAL – PROMO 6.1.doc

Información de ConfiguraciónExisten un número de parámetros de configuración que pueden ser modificados para personalizar el comportamiento de PROMO. Algunos de estos parámetros solo estarán disponibles en la consola de PROMO Principal y otros podrán ser editados desde la consola de PROMO de cada compañía.Estos parámetros se encuentran en la Consola de PROMO, " y son: Menú " " >> "Administración Información de ConfiguraciónConfiguraciones disponibles para el :Usuario Principal

  Módulo Clave Valor Descripción

1 Promo Operative.system Windows Sistema Operativo donde se encuentra operando Promo.

2 Negocio lang es_AR Lenguaje en que operará la Consola. Actualmente hay tres opciones: es_AR (español Argentina, es_MX(español Mexico) y pt_BR (portugués Brasil). Esto afecta además del lenguaje, la configuración regional de la consola.

3 Negocio backupDirectory C:\synthesis\promo\backup Directorio donde se encuentran los ejecutables de mongodb (Suele ser el path de instalación + bin)

4 Negocio mongoDBDirectory C:\synthesis\promo\mdb\bin Directorio donde se encuentran los ejecutables de mongodb (Suele ser el path de instalación + bin)

5 Negocio mongoDBHostname localhost Host de la base de datos

6 Negocio mongoDBPort 27017 Puerto de la base de datos

7 General auditDateCleaner 30 Eliminar registros de las tablas de importación.

8 General importReceiptDateCleaner

30 Eliminar registros de las tablas de importación.

9 General ticketGeneratorSeconds 2 DEMO: cantidad de segundos de generación de ticket para demos

10 General quartz.cronExpression.databaseJob

0 0 1 1/1 * ? * GENERAL: planificación de resguardo de la base de datos.

11 Promo Bridge

soap.url http://xx.x.xx.xx:8080/bridge/services/bridgeCoreSOAP

URL de conexión a la base de datos de Bridge por medio del servicio SOAP. Solo disponible en Instalación PROMO - BRIDGE

12 Promo engineSalePath C:/synthesis/gengine/engine/sales/ Directorio de Mapas del Motor

Configuraciones disponibles para el :Usuario Admin. de cada compañía

  Módulo Clave Valor Descripción

1 Coupon barcodePath _C:\synthesis\assets\images\barcode_ Directorio donde se almacenarán las imágenes de los barcodes generados en el caso de cupones electrónicos. Estos cupones cuando son enviados por mail contienen un link a la mencionada imagen.

2 Coupon barcodeUrl _

http://localhost:8080/promo/assets/barcode/_

Respecto a la opción anterior, es la URL que se incrustará en el HTML de los cupones electrónicos, es decir el link HTML a la imagen del barcode del cupòn.

3 Promo fileDirectory C:/synthesis/promo/catalogs/11/ Importación de catálogo: directorio donde estarán los archivos

4 Tarjetas de fidelidad

Max.qty 999 Cantidad máxima de tarjetas a generar por cada operación de alta masiva

5 Tarjetas de fidelidad

isEditableAfterCardsGeneration false Permitir la edición del tipo de tarjeta luego de haber generado una tarjeta activa

6 Tarjetas de fidelidad

prefix.active false Utilizar prefijo númerico incremental para tipos de tarjeta

7 Coupon CODE128 PPPSSSTTTnnnnnnnnnnnnnnnnnn Formato de codificación CODE 128

8 Coupon EAN13 PPPSSSTTTnnnc Formato de codificación EAN13

9 Coupon UPCA PPPSSSTTTnnc Formato de codificación UPCA

10 Coupon max.qty 999 Máxima cantidad de cupones que se pueden generar de una vez, en la opción de generación masiva de cupones.

11 Coupon prefix.active true Si el valor es true, el prefijo de los cupones será un número autoincremental, es decir cada vez que se crea un tipo de cupón se asigna automáticamente un prefijo.

12 Coupon amountFormat %.02f Formato en el que se imprimen los montos de los cupones

13 Promo applicationMethod resume Promociones: valor por defecto en el método de aplicación

14 Promo divisionMethod proportional Promociones: valor por defecto en el método de división

15 Promo divisionPrice benefited-price Promociones: valor por defecto el tipo de precio beneficiado

16 Promo fileList.txt.separator , Importador de Catalogos Separador de listas en archivos de texto plano.

17 Promo fileList.xls.ColStart 0 Importador de Catalogos - Columna en la cual comenzar el procesamiento cuando se trata de importar catálogos en formato XLS.

18 Promo fileList.xls.Direction vertical Importación de catálogo Para Importación de catálogos en formato XLS, indica si los datos se encuentran distribuidos en format "vertical" (un datos por fila) o bien "horizontal" (un dato por columna).

19 Promo fileList.xls.RowStart 0 Importación de catálogo: fila de comienzo de la importación de catálogo

20 Promo separator | Separador de campos dentro de cada archivo de catálogo.

21 Promo terminatedOnError true Termina la importación de catálogo, si al menos uno fallo. Si es false, no termina e informa los catálogos fallidos.

22 Promo updateSize 100 Importación de catálogo - Cantidad de registros para insertar en bloque en la BD. (0 significa que inserta todos juntos)

23 Promo Distribution ThreadPoll 10 Cantidad de hilos creados para la distribución simultanea

24 Promo path C:\synthesis\promo\import Directorio donde se localizarán los archivos de mapas para ser importados.

25 Promo Benefit.active false Si se activa esta opción, los beneficios serán identificados por un campo autoincremental.

26 Promo Promotion.code.active false Si se activa esta opción, las promociones serán identificadas por un número autoincremental.

27 Cupones default.from test@gmail.com Email por default con el que se enviaran los correos

28 Cupones default.insertImages false Indica si acepta o no barcodes

29 Cupones default.subject Promo Test Mail Asunto por default

30 Cupones host smtp.gmail.com Host del proveedor de email

31 Cupones password ********* Contraseña de la cuenta de email

32 Cupones Port   Puerto de conexión

33 Cupones smtp.auth true Habilitar Auth SMTP

34 Cupones smtp.port 587 Puerto SMTP

35 Cupones smtp.socketFactory.class javax.net.ssl.SSLSocketFactory nombre de la clase SSLSocketFactory

36 Cupones smtp.socketFactory.fallback false Fallback de socketFactory

37 Cupones smtp.socketFactory.port 465 Puerto SMTP de socketFactory

38 Cupones smtp.starttls.enable true Habilitar Start TLS

39 Cupones username test@gmail.com Usuario o nombre de la cuenta de email

40 Promo use.item.catalog 1 Indica con un 1 si existe el catálogo de ítem, con un 0 que no. Esta configuración optimiza la detección de colisiones según se tenga o no catálogo.

41 Promo cleanEngineStatusHistory 7 Tiempo en días que la consola mantendrá el historial de estados del motor

42 Promo deployedEditable.enabled false Si se encuentra habilitado permite la edición de promociones que ya han sido distribuidas.

43 Promo promotion.enginestatus.communication

600 Tiempo en segundos que el motor debe informar los mapas activos

44 Promo promotion.images.height 250 Altura de las imágenes a incluir en las promociones.

45 Promo promotion.images.path _c:\synthesis\promo\images\custom\promotion_ Directorio desde donde se cargarán las imágenes a incluir opcionalmente en las promociones.

46 Promo promotion.images.width 250 Ancho de las imágenes a incluir en las promociones

47 Promo reportParticipants false Valor global para todas las promociones al momento de generar el mapa.

48 Promo reportParticipantsVisible true Determina si se visualiza o no, la opción reportar participantes

49 Promo method.of.payment NOTHING Relacionado al uso de las promociones por medio de pago. Existen 3 valores posibles: NOTHING (deshabilitado), ON_ITEMS_PAID (calcula promociones sobre cada ítem pagado), ON_PAYMENT_MADE (calcula promociones sobre los pagos realizados).

50 Promo method.of.payment.onItemsPaid.class

om.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsGSPromotion

Es el nombre de la promoción codificada que se encargara del procesamiento ON_ITEMS_PAID

51 Promo method.of.payment.onItemsPaid.name

Promociones basadas en ítems Nombre que se desea otorgar a las promociones ON_ITEMS_PAID

52 Promo method.of.payment.onItemsPaid.tenderMethodPropertyKey

com.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsSSPromotion

Es el nombre de la promoción codificada que se encargara del procesamiento ON_PAYMENT_MADE

53 Promo method.of.payment.onPaymentMade.class

com.synthesis.promo.engine.partialPayment.hardcoded.promotion.PartialPaymentsSSPromotion

Promoción Codificada: nombre de la promoción por medio de pago basada en ítems.

54 Promo method.of.payment.onPaymentMade.name

Promociones basadas en pagos Nombre que se desea otorgar a las promociones ON_PAYMENT_MADE

55 Promo method.of.payment.onPaymentMade.tenderMethodPropertyKey

promo.configuration.tenderMethod.paymentMethod Codigo que se desea otorgar a las promociones ON_PAYMENT_MADE

56 Promo testEnginePORT 3001 Puerto en el que corre el motor de promociones destinado para las simulaciones de mapas/promos

57 Promo testEngineRetries 2 Cantidad de reintentos que se harán al motor de promociones del simulador.

58 Promo testEngineSalesPath C:/synthesis/promo/engine/sales/ Directorio donde se encuentran los mapas del simulador

59 Promo testEngineTimeout 8000 Timeout del motor para el simulador.

60 Redes sociales

facebook.appId 1068803666479012 Id de la aplicación de facebook

61 Redes sociales

facebook.permissions publish_actions,manage_pages Permisos de la aplicación de facebook

62 Redes sociales

facebook.secret dfa5ffe6aa6306fc49472dbaaa3c16a9 Clave secreta de la aplicación de facebook

63 Redes sociales

facebook.secure https Protocolo de conexión segura a la aplicación de facebook

64 Redes sociales

twitter.accessToken 2848336690-D2geAfGVL9u2bD6TrD1LxH5fUsXlBnHLa3FOziK

Token de acceso a twitter

65 Redes sociales

twitter.accessTokenSecret NHd6JbcoLaBK5QEfrKgmOaQwwxmbwlEtOYlQni3Fx6H3y

Token secreto de acceso a twitter

66 Redes sociales

twitter.consumerKey HTPKOHdatasoDsm2Ud7ULnUapAKFXoC Clave consumer key de twitter

67 Redes sociales

twitter.consumerSecret X1plqdQWK0nRCGz6KFxm37IZTzp4O7w9BjLSspIr4mYWLZsrOy

Clave consumer secret de twitter

68 Transacciones

cleanTransactions 90 Cantidad de días que permanecerán los registros de transacciones en la base de datos

Podrán existir cambios correspondientes a:

actualización de la consola de administración (de existir alguna actualización se entregará la correspondiente documentación y la forma de instalarla),depuración de backups de BD.

Tener en cuenta que para realizar el mantenimiento se deberá detener la aplicación, realizar los cambios y luego volver a iniciarla. Nota:

Depuración de archivos de backup de Base de datos

La aplicación registra un backup automático diario de la base de datos MongoDB. Es por ello que es necesario realizar un cierto mantenimiento, consistente en la depuración de los mismos a fin de que la periódicamentecarpeta de backup no ocupe demasiado en disco.

Enmascarar Contraseña de DB

La clave enmascarada de base de datos se genera mediante la promo-crypto-tool que sera provista.

El programa toma como ingreso a la clave a encriptar y devuelve la clave encriptada que se debe situar en el archivo en una entrada llamada (por ej. grails.promoplus.properties grails.mongodb.encriptedPasswordmongodb.encriptedPassword=lYYBAfxLR40=).

En caso de utilizar grails.mongodb.encryptedPassword se debe considerar comentar o eliminar la anterior grails.mongodb.password ya que en caso de existir ambas siempre utilizará grails.mongodb.password. En caso de que el archivo promoplus.properties no exista, se tomará, como valor por defecto, a v9vbhV.

Para encriptar una clave se debe utilizar promo-crypto-tool de la siguiente forma en una consola:  java -jar <nombre del jar> <contraseña a encriptar>, por ej java -jar promo-crypto-tool-1.0.0.jar abcdefg

o bien

java -jar <nombre del jar> y al ejecutarlo, de modo interactivo, solicitará el ingreso de la contraseña.

En ambos casos la contraseña encriptada se obtendrá por pantalla.

Nota: Se debe considerar la limitación del algoritmo tripledes, el cual acepta sólo caracteres us-ascii como entrada del encriptador. Utilizar caracteres diferentes genera contraseñas encriptadas inválidas.

Nota2: Se asume que si existe, en el archivo promoplus/promoplus.properties, una contraseña no encriptada   no debe existir la entrada de contraseña encriptada (grails.mongodb.password) (grails.mongodb. y viceversa. La entrada no deseada se puede eliminar o comentar.encriptedPassword)

Configuración de Redes Sociales

Para trabajar con redes sociales PROMO posee una serie de opciones de configuración que se describen a continuación. También es importante aclarar que los servicios de redes sociales están en constante evolución y cambio por lo cual aquí se hace referencia al sitio del servicio en cuestión para obtener la información actualizada al respecto.

Configurar Facebook

La configuración de las propiedades de Facebook se encuentran en el archivo . En el mismo se encontrará:promoplus.properties

Propiedad Descripción

grails.plugin.facebooksdk.app.id = 1068803576479012 Corresponde al id proporcionado por Facebook y es del tipo numérico.

grails.plugin.facebooksdk.app.permissions = publish_actions,manage_pages,publish_pages

Son los permisos proporcionados por Facebook y se presentan en formato de lista de cadenas de caracteres (separados por coma).

grails.plugin.facebooksdk.app.secret = dfa5ffe6aa6306fc49472dbcba3c16a9 Es una cadena y también es proporcionada por Facebook.

Generación de Aplicación en Facebook

Para poder utilizar la publicación en Facebook se deberá ingresar a , darse de alta como y agregar una nueva aplicación siguiendo los pasos https://developers.facebook.com/ desarrollador de Aplicaciones Facebookindicados en la página. Esto aplica a la versión de App Facebbok 2.9, pero es importante notar que al crear una aplicación para Facebook, se comienza en estado de desarrollo y para poder realizar publicaciones hay que dar los permisos de Administrador al usuario de FB que realizara las publicaciones. Por otra parte, si se quiere compartir o que otro usuario pueda realizar publicaciones, es necesario ser amigos entre los usuarios y darle permisos de administrador. Al acceder a la URL indicada más arriba, se accederá a la sección de " " de Facebook.Facebook for Developers

Se deberá dar clic en "Mis Aplicaciones" que figura arriba a la derecha, junto al icono de usuario.

Una vez allí, habrá que dar clic en el botón verde de " ". Agregar una nueva aplicación

Se solicitara ingresar un nombre y un correo electrónico de contacto para dar de alta la app. Luego de ingresados los datos solicitados, presionar en " ".Crear identificador de la aplicación

La siguiente pantalla presentara los datos de la nueva aplicación recién generada.

Aquí se mostraran los datos requeridos para la configuracion de la aplicación en el archivo promoplus.propertis que son:

Identificador de la aplicación >> grails.plugin.facebooksdk.app.idClave secreta de la aplicación >> grails.plugin.facebooksdk.app.secret

Sera necesario tener una de Facebook dada de alta y asociada a la cuenta de usuario de facebook para poder realizar las publicaciones en esta pagina. paginaDesde el perfil de usuario con el que se haya generado la app de Facebbok, se deberá dar clic en el menú desplegable de la cual se tendrá acceso a las configuraciones y paginas. En este menú dar clic en " ", y generarla en base al perfil del negocio siguiendo los pasos indicados por facebok Crear paginaUna vez generada la pagina y configurados los datos en el archivo de configuracion aportados por la aplicación generada, se podrá reiniciar la consola y proceder a la publicación de las promociones en la red social.

Nota: Se deberá ser administrador tanto de la pagina como de la aplicación generada en Facebook para poder realizar las publicaciones desde PROMO.

Configurar Twitter

También en este caso la configuración se realiza desde el archivo . En el mismo se encontrará:promoplus.properties

Propiedad Descripción

twitter.accessTokenSecret = 2HUuDOo3OpU3MqiivweQOOYAX7lS0Oq7uf0WSeareNVG5 Corresponde al Token proporcionado Twitter y es del tipo Alfanumérico

twitter.accessToken= 790933373356976128-LmbYvRTE5viQ6oymJV2K6RFHOjRHVK8 Corresponde al Token proporcionado Twitter y es del tipo Alfanumérico

twitter.consumerSecret= PQZF4y7BiZnc0qd2ngJTSXcHlG2WdYMbUMFmvcljXdE1gbWAIW Información proporcionada por Twitter en formato alfanumérico

twitter.consumerKey= vZmiaU1HCiJuow7NJA1chkTSK Información proporcionada por Twitter en formato alfanumérico

Para obtener los parámetros desde Twitter, se debe registrar como desarrollado o creador de aplicaciones que interactúen con éste. Para ello referirse a y seguir los pasos indicados https:/apps.twitter.com/en TW para tal fin.

Generación de perfil en Twitter

Al acceder a la URL indicada en la sección anterior, se presentara la siguiente pantalla:

Dar clic en "Create New App" y completar el formulario que se presentara en pantalla:

Completos todos los campos, dar clic en "Create your Twitter application"y se mostraran las configuraciones disponibles para la nueva aplicación recientemente generada:

Se debera acceder a la solapa "Keys and Access Tokens" donde se mostraran los datos necesarios para la configuracion de la aplicación en PROMO (promoplus.propertis)

Al pie de esta página se mostrara el botón para generar el token de acceso:

Dar clic en "Create my access token":

Se mostrara en la parte superior de la pagina el mensaje indicando que se ha genrado correctametne el token y al pie de la pagina se mostraran los datos correspondientes al token que se ha generado.

Estos datos deberán también configurarse en base a lo indicado en la sección anterior en el archivo . Hecho esto, se podrán guardar los cambios y reiniciar la consola para proceder a la promoplus.propertispublicación de promociones en la red social. 

No podrán subirse a las redes sociales imágenes con tamaños motor a 1 MB. Importante:

Resolución de problemas

Durante su funcionamiento, la Consola de administración podrá informar errores inesperados. Los errores que puedan a llegar a ocurrir utilizando la aplicación serán informados mediante un pop-up en rojo indicando la causa del mismo. Asimismo, el log de la aplicación que se encuentra en indicará más detalle acerca del mismo. \synthesis\promo\logSi el error es por un tema de permisos o página no encontrada, se informará mediante una pantalla aclaratoria con el problema ocurrido.

Desinstalación

Para proceder con la desinstalación de la consola y motor de PROMO se deberá:

1- Bajar servicios

PromoSImEngineWildflyMongoDBPromoEngine (si se instaló el motor)PromoEngineDirector (si se instaló el motor)

2- Borrar directorio C:\Synthesis (rota donde se instaló la consola)

3- Desinstalar MongoDB

4- Borrar los servicios de PromoSinEngine, Wilfly y MongoDB, y PromoEngine, PromoEngineDirector si se instaló el motor

Apéndice A: OS4690

Instalación de Motor en OS4690

Se deberán seguir los siguientes pasos para instalar correctamente el motor de PROMO en un OS4690:

Envié el jar entregado a un controlador, al raíz del disco con el nombre, por ejemplo: F promo-gengine-installer-x.x.x.jar

Ejecutar el instalador:  F:/instala> javaebin:java -jar promo-gengine-installer-x.x.x.jar

Dependiendo si está disponible el modo gráfico, se podrá ejecutar en ese modo o en modo texto. Se recomienda el modo gráfico y ejecutar desde la carpeta F:/instala

Cuando se solicite, indicar estos valores: 

Directorio java: /opt/java/tdk8 Directorio de instalación: /cdrive/f_drive/instala/promo

Pueden presentarse errores al instalar servicios. Esto es debido a los permisos del Linux4690, ignorar.

Se generan los archivos:

F:/instala/ant.install.logF:/instala/ant.install.properties

Se genera la carpeta F:/instala/promo

Revisar y Copiar los siguientes archivos:   Modifcar el  config.xml (…promo/engine/conf) para especifi8car las rutas correctas:

    <offline>        <!- ->Directorio donde se guardarán los tickets offline        <directory>/cdrive/f_drive/promo/engine/offline</directory>        <!- ->Cantidad de segundos en los que chequea offline        <check>60</check>    </offline>    <map>        <!- ->Directorio desde donde el motor lee los mapas        <directory>/cdrive/f_drive/promo/engine/sales</directory>        <!-Cantidad de segundos en los que chequea nuevo mapa

Modificar logging.properties (…promo/engine/conf)    para especificar las rutas correctas:  java.util.logging.FileHandler.pattern = /cdrive/f_drive/promo/engine/logs/promo

Configurar aplicación Background: 

Programa shell:Parámetros: F:/promo/engine/tcp4690.bat  (o rest4690.bat para trabajar como servidor tcp ip o rest según sea el caso). 

     Iniciar cuando es Maestro y cuando no es Maestro     Activar configuración y cargar Controlador 

Apéndice B: Variables de Entorno

Set PATH JAVA_HOME en Windows

Para que la aplicación se ejecute correctamente será necesario, setear la variable JAVA_HOME en Windows.  Para ello ingresar a Panel de Control > Sistemas y Seguridad > Sistemas y seleccionar "Configuración Avanzada del Sistema" En la solapa de Opciones Avanzadas, dar clic en "Variables de Entorno". En Variables de Sistema, posicionarse en JAVA_HOME y dar clic en "Editar" y colocar la ruta donde se encuentre JAVA.

En Variables del sistema, buscar PATH, y hacer clic en " ", luego agregar Editar % JAVA_HOME% \ bin

Dar clic en " " para guardar los cambios y que la variable quede seteada correctamente. Aceptar

Apéndice C: Actualizaciones de Consola

1. 2. 3. 4. 5.

Actualización por nuevos Release

En caso de que un nuevo reléase de su versión de consola sea liberado, pudra realizar la actualización de la versión de PROMO siguiendo estos pasos:

Bajar el servicio de Wildfly (acceder a la sección de servicios del sistema y detener Wildfly)Acceder al directorio donde este instalada la consola de PROMO (por default en C:\synthesis\promo)Ingresar al directorio C:\synthesis\promo\appserver\standalone y eliminar los directorios "data" y "tmp"Ingresar al directorio C:\synthesis\promo\appserver\standalone\deployments y reemplazar el archivo promo.war existente por el enviado por el personal de Synthesis.Hecho esto, iniciar nuevamente el servicio wilfly.

: una vez iniciado el servicio luego del reemplazo del archivo promo.war, en el directorio C:\synthesis\promo\appserver\standalone\deployments se generara un archivo llamado promo.war.Notaisdeploying, indicando que se están descomprimiendo los archivos de la actualización.

En caso de terminar satisfactoriamente el proceso, este archivo será renombrado como promo.war.deployed. De presentarse algún error durante la descompresión de la actualización, se generara un archivo llamado promo.war.failed el cual deberá ser enviado al personal de soporte para su análisis y posterior resolución del inconveniente a fin de iniciar correctamente la consola.