BRIDGE MANAGER - Manual de instalación v4.1

BRIDGE MANAGER Manual de instalación

 Versión 2.8

Revisiones

Fecha Versión Descripción Autor

14/05/2010 1.0 Creación del documento ER

15/10/2014 1.1 Actualización del documento según versión actual de instalación

CC

29/10/2015 1.2 Actualización del documento según versión actual de instalación

IS

06/11/2015 1.3 Actualización del documento con correcciones de forma y ajustes puntuales.

LV

11/11/2015 1.4 Actualización del documento con ajustes/correcciones asociadas a la nueva versión.

IP

13/04/2016 1.5 Corrección de la última actualización. Se habían realizado actualizaciones sobre una versión vieja.

LN

02/08/2016 1.6Se ajustan los requerimientos mínimos de hw sugeridos para BMT y BMC.Se actualizan pantallas y agregan notas de mensajes de validación.Se agrega anexo de asistente de instalación de tienda

AA

30/12/2016 1.7Se ajusta formato del documento y se da nuevo orden al contenido del manual (a Bridge v4).Se separa la instalación modo no gráfico y el flujo de instalación BMC de BMT.Se considera BD OracleSe agrega capítulo de mantenimiento y configuración (depuración y configuración de logs)Se actualiza flujo de asistente de tienda

AA

10/01/2017 1.8Se actualiza con la aceptación de "términos y condiciones"

AA

12/04/2017 2.0Se actualiza con instalador de Bridgev4.1

AA

2/06/2017 2.1Se agrega ingreso de datos del componente/Director

AA

21/07/2017 2.2Se actualiza con requerimientos mínimos de hw y sw. Manejo de índices

AA

27/07/2017 2.3Se modifica los ejemplos para la generación de los índices

IP

24/08/2017 2.4Se agrega recomendaciones y prerrequisitos de instalación para BD Oracle.

AA

23/09/2017 2.5Se actualiza con nuevo instalador integrado con consola de Promo, motor de simulación y agente Promo Director.Se incorpora modo de instalación silenciosa con archivo de configuración ant.install

AA

06/03/2018 2.6 Se ajusta el instalador con nuevos parámetros para Promo y datos para lab/demo

AA

10/04/2018 2.7 Se ajustan puntos de prerrequisitos de instalación AA

29/08/2018 2.8 Se ajusta el directorio donde se guardará el archivo log

AA

Índice 1 Introducción

1.1 ¿Qué es BRIDGE MANAGER? 1.2 Acerca de este manual 1.3 Documentación relacionada

2 Consola de Administración2.1 Introducción 2.2 Plataformas Soportadas 2.3 Requerimientos de Hardware 2.4 Requerimientos de Software 2.5 Instalación 2.5.1 Requisitos iniciales 2.5.2 Instalación de la aplicación Bridge Manager Central 2.5.3 Instalación de la aplicación Bridge Manager Tienda 2.5.4 Instalación de la aplicación en modo no gráfico 2.5.5 Instalación en modo silencioso 2.5.6 Creación de la base de datos 2.5.7 Índices 2.5.8 Desinstalar MongoDB 2.6 Ejecución del sistema 2.6.1 Configuración de la JVM 2.6.2 Iniciar la aplicación 2.6.3 Acceder a la Consola de administración 2.6.4 Detener la aplicación 2.6.5 Primera ejecución de la aplicación Bridge Manager Tienda

3 Asistente de tienda

1.

3.1 Asistente de nueva tienda 3.2 Lista de entidades a sincronizar desde Bridge Manager Central

4 Mantenimiento y configuración4.1 Análisis de logs 4.2 Cómo cambiar la base de datos 4.3 Depuración de archivos de log 4.4 Configuración de archivos logs 4.5 Procesos de depuración 4.6 Troublesooting

5 Instalación de consola y motor de simulación de Promo5.1 Prerrequisitos de instalación de consola Promo y motor de simulación 5.2 Componentes que se instalan 5.3 Log del instalador de Bridge con la consola de Promo 5.4 Estructura de directorios 5.5 Acceder a la consola de Promo 5.6 Operación con Consola y motor de simulación 5.7 Mantenimiento y configuración

Introducción

¿Qué es BRIDGE MANAGER?

BRIDGE MANAGER es una solución de BackOffice basada en las ventajas de 4690 SA y GSA con las ventajas de las tecnología Open Source. Principalmente robusta, multiplataforma y extensible. Adicionalmente esta solución integra la Suite de productos Bridge Ominicanal lo que permitirá acoplar otros módulos ampliando la funcionalidad ofrecida.En resumen, la solución será un conjunto de módulos que contemplan las operaciones reducidas de CashOffice y proveen una serie de interfases para integrarlo con sistemas externos.Cuenta con una "Consola de administración", encargada de brindar una herramienta centralizada de administración. Esta consola es Web y funciona sobre un servidor de aplicaciones WildFly. El presente manual ilustra sobre cómo realizar la instalación de la consola de administración y las diferentes opciones que pueden ser configuradas para su funcionamiento.

Acerca de este manual

En este manual encontrará toda la información necesaria para instalar el producto BRIDGE MANAGER.Se explicarán cada uno de los pasos de instalación, los requerimientos de hardware y software, las propiedades a ser configuradas. El manual se encuentra dividido en los siguientes capítulos:

1.

1.

1.

1.

1.

Capítulo 1 - Introducción

Provee una breve descripción del producto así como también una visión global del manual, brindando información sobre el contenido del mismo.

C apítulo 2 - Consola de Administración

Informa los requerimientos de software y hardware para poder instalar el sistema, la instalación del producto, incluyendo la creación e inicialización de la base de datos a utilizar y la ejecución del Sistema.

C apítulo 3 - Asistente de tienda

Se detalla el proceso de sincronización de una nueva tienda con Bridge Manager Central a través del asistente de tienda en una nueva instalación de tienda.

C apítulo 4 - Mantenimiento y configuración

Ajustes posteriores a la instalación que pueden requerirse como cambio de base de datos, usuarios, configuración de logs y su análisis.

C apítulo 5 - Instalación de consola y motor de simulación de Promo

Informa sobre los prerrequisitos de instalación con Promo, componentes a instalar, etc.

Documentación relacionada

Manual de usuario de Bridge Manager: detalla el uso operativo y funcional de la aplicación.

Consola de Administración

Introducción

BRIDGE MANAGER es un sistema centralizado, accesible mediante el uso de un explorador WEB. Las principales características funcionales son: proveer contabilidad por cajero, por terminales o por oficina, realizar dotaciones retiros, arqueos y cuadratura de cajeros, registrar transacciones, realizar cierres de periodos, administrar y monitorear el estado del sistema, el estado de procesos, realizar auditorías, obtener reportes para control, realizar el mantenimiento de los maestros de artículos, operadores, medios de pagos, administrar perfiles y permisos asociados y otras funcionalidades adicionales. La Consola de administración funciona bajo un servidor de aplicaciones y utiliza un servidor de base de datos, tal como se indica en la sección 2.4: .Requerimientos de Software

Plataformas Soportadas

Windows 7 en adelanteLinux (Suse, Centos 7)

Requerimientos de Hardware

Los siguientes requerimientos son los recomendados de mínima, considerando que sean de uso dedicado para la aplicación Bridge.

Memoria RAM: 8Gb (mínimo para BMT), 16Gb (mínimo para BMC)CPU: Intel i5 o procesador de similares características para BMT, i5 / i7 para BMC.Capacidad de almacenamiento en Disco Rígido: 1Tb o superior.

Requerimientos de Software

JVM Oracle 1.8.0.25Servidor de aplicaciones: Servidor de aplicaciones WildFly 9.0.1.FinalBases de datos (motores soportados):MSSQL Server 2008 R2 en adelanteOracle 10g en adelante

Instalación

Requisitos iniciales

Antes de realizar la instalación, se debe verificar que se encuentren instalados y funcionando los siguientes componentes o prerrequisitos:

Servidor de base de datos con conexiones TCP habilitadasJava Runtime Enviroment (JRE).El servicio de SQL Browser (SQL Server Browser) debe encontrarse "en ejecución"La autenticación del servidor de base de datos debe encontrarse como mixta

Autenticación mixta (Modo de autenticación de Windows y SQL Server)Se debe contar con una base de datos creada previamente, la cual se generará con su respectiva estructura luego de ejecutar el instalador.

A partir de v4.1, se debe contar con un filegroup (SQL Server) o un tablespace (Oracle) para el uso de índices. Ver Índices.A partir de la v4.1.5 la base de datos se crea al verificar la conexión con la misma, si no existiera. 

Particularidades en caso de utilizar base de datos Oracle.En las instalaciones con Oracle, en el servidor donde reside el motor de base de datos, no se debe tener seteado el NLS_LANG, en cambio se deberá:

Setear las variables ORACLE_HOME y ORACLE_BASESi las variables son seteadas a nivel usuario, se debe considerar que se encuentren definidas para el usuario con el cual se ejecutará Bridge Manager, sino deben quedar a nivel sistema

Cambiar todo el entorno de configuración regional de la máquina/equipo a inglés (Estados Unidos)Con sistema operativo Windows:

quitar el registro de Windows, la entrada NLS_LANG (para instalación del Oracle XE)Con sistema operativo Linux:

unset NLS_LANG

En el equipo a instalar Bridge Manager

Se debe contar con los permisos necesarios de creación y modificación en las rutas creadas, como en el directorio del usuario correspondiente. En su defecto ejecutar el instalador como AdministradorSe debe asegurar la disponibilidad del puerto donde escuchará Bridge (pudiendo configurarse: 8080, 8180, 8280 o 8380)Recomendación:

Evitar que el nombre de la máquina o equipo donde se instalará Bridge Manager tenga un guión bajo ("_") en su nombre, porque queda inaccesible (o en su defecto configurar por su IP, si la misma fuera fija)

Una vez cumplidos estos requisitos, continuar con el paso 2.5.2: . Instalación de la aplicaciónNOTA:A partir de la versión 4.1.3 el instalador permitirá instalar Bridge Manager (Central o Tienda) junto con la consola de Promo (v5.2), motor de simulación de Promo y agente de Director para Promo. Por prerrequisitos para instalar Promo, ver anexo Instalación de consola y motor de simulación de Promo

: Previo a la instalación del producto, debe desinstalarse cualquier versión anteriormente instalada de MongoDB, a través de Panel de Control->Desinstalar un Programa. En el caso que quiera IMPORTANTEmantenerse una instalación de MongoDB previa, la ruta donde está instalado deberá ser indicada correctamente durante el wizard de instalación.

Instalación de la aplicación Bridge Manager Central

Ejecución del instalador

El nombre del archivo del instalador es: donde {version} es el número de versión del producto.bridge-manager-installer-{version}.jar,Para iniciar el instalador, se debe ejecutar el siguiente comando en modo Administrador:

JAVA_HOME/bin/java –jar bridge-manager-installer-{version}.jar

Nota: JAVA_HOME hace referencia a la ubicación donde se encuentra instalada la JVM. En un entorno Windows con java correctamente instalado simplemente hay que hacer doble click sobre el archivo. : se debe ejecutar desde una ventana en modo administrador, debido a que si se instala la consola de Promo se requiere registrarlos como servicios.IMPORTANTE

1.

Para iniciar el instalador, se debe ejecutar el siguiente comando desde la ventana de línea de comando:Directorio del instalador …:\>java –jar bridge-manager-installer-{version}.jar(Ej: c:\Descargas\java –jar bridge-manager-installer-4.1.5-SNAPSHOT.jar) En el caso de que se quiera forzar el idioma del instalador en español, agregar el parámetro del idioma:

java -jar -Duser.language=es bridge-manager-installer-4.1.5-SNAPSHOT.jar(Ej: c:\Descargas\java –jar Duser.language=es bridge-manager-installer-4.1.5-SNAPSHOT.jar)-

Configuración de propiedades del instalador

Ejecutar el instalador según lo explicado en 2.5.2.1: .Ejecución del instalador

1.

1.

El instalador descomprimirá los archivos necesarios para la instalación en un directorio auxiliar, mostrándose el siguiente popUp (con mensaje "Extrayendo…"

Nota: este paso puede demorar unos minutos.

Una vez descomprimido la próxima pantalla a mostrarse es la de "términos y condiciones de uso" donde se detalla el texto de las condiciones de licenciamiento.

1.

1.

Para poder leer el texto completo, se podrá hacer uso de la barra de scroll, pudiendo verificar el texto completo

Al presionar "aceptar", pasará a la próxima pantalla de aceptación de "términos y condiciones de uso".

Se deben completar con los datos del encargado del área del retailer (datos obligatorios)Tildar la opción "acepto los términos y condiciones de uso" (obligatorio para una correcta instalación)"nombre completo""correo electrónico"

Ejemplo:

1.

Si se ingresara uno de los datos con formato no válido se informará con un mensaje de error (formato de email y el campo nombre que se encuentre completo)

Nota: si no se aceptan los términos y condiciones de uso, el proceso de instalación pasará a la última pantalla del instalador salteando las configuraciones restantes. Ver Instalación fallida por no aceptación de términos y condiciones

Luego de completos los datos obligatorios y presionar el botón "siguiente", el sistema mostrará la siguiente pantalla para su configuración, con valores predeterminados que podrán ser modificados.

1. Luego se solicitará configurar "Opciones de instalación obligatorias"

Se informará la configuración por defecto, pero la misma podrá ser modificada según las siguientes indicaciones.

":"Seleccione su directorio de instalación se requiere ingresar la ruta deseada para el directorio de instalación o puede utilizar la precargada por defecto.Botón seleccionar: otra opción es la búsqueda de un directorio ya existente o que se desee crear.

1. 2.

1.

"Seleccione el directorio de instalación de MongoDB": se debe configurar el directorio en el cual se encuentra instalado MongoDB (si desea utilizar una base de datos ya preexistente para la consola de PROMO y no fue desinstalado durante la revisión de pre-requisitos) Se recomienda desinstalar MongoDB y el mismo se instalará en el directorio que se configure en este parámetro)

Botón seleccionar: opción que agiliza la búsqueda del directorio.Por ayuda en desinstalar ver: Desinstalar MongoDB

"Seleccione su directorio java": se debe configurar el directorio en el cual se encuentra instalada la máquina virtual de Java (sin incluir el directorio bin dentro del directorio a configurar)Botón seleccionar: opción que agiliza la búsqueda del directorio.

"Host donde se está instalando Bridge Manager": se debe configurar la dirección IP o el nombre del server dentro del dominio de red (no localhost), caso contrario se mostrará el mensaje:

"Seleccione el puerto de escucha del servidor": el puerto por defecto es el 8080, pero también se podrán optar por otros dentro de la lista de selección desplegable.

Importante: se debe considerar que otras aplicaciones que se encuentren en el mismo servidor, no utilicen el mismo puerto que se desea configurar (por ejemplo si el Bridge Manager Central se encuentra instalado en el mismo servidor que Bridge Manager Tienda, ambos deberán instalarse en puertos diferentes)

1. Una vez configurados los datos de la primera pantalla presionar el botón "siguiente", mostrando la próxima pantalla "Componentes a instalar":

"Archivo de configuración"

"Instalar como servicio de Windows": si no se tilda la opción, Bridge Manager se deberá levantar desde el directorio de instalación del application server wildfly tal cual se indica en el punto de iniciar aplicación.

Nota: para instalaciones de demo, se recomienda no tildar esta opción e iniciar Bridge Manager desde el acceso directo que dejará la instalación (mediante el archivo bridge.bat).

1.

"Instalar Promo": si se tilda la opción, se instalarán la consola y motor de simulación de Promo. En caso de ser seleccionado, siempre se instalará como servicio MongoDB y el agente Director.El motor de simulación (promoengineSim) levantará junto con el wildfly.

Nota: es independiente al tilde "instalar como servicio de Windows" ya que este aplica al application server Wildfly que levantará tanto Bridge Manager como consola de Promo.

"Ubicación URL de Director": URL del servidor de actualización de versiones (no es requerido si no se integrará con Director) por lo que puede mantener el valor por defecto.

"Código de Tienda Director": código asignado en el actualizador de versiones (no es requerido si no se integrará con Director)

"Tipo de instalación": seleccionar la opción Central (para instalación de BM Tienda ver Componentes a instalar "tienda")

Una vez configurados los datos de la segunda pantalla presionar el botón "siguiente", mostrando la próxima pantalla "Configuración de base de datos"

1.

"Seleccione el servidor de Base de datos": SQL Server o Oracle

"Ejecutar scripts SQL": se debe seleccionar una de las siguientes opcionesNo ejecutar scripts SQL: si ya existiera una BD con las tablas ya generadasCreación del modelo de datos básico: se genera la estructura de tablas sin datos de laboratorio.Datos de laboratorio: se genera la estructura de tablas y cargan datos de laboratorio como artículos, usuarios, terminales, etc.

y retomar nuevamente el flujo de instalación en el siguiente punto (h) Nota: para instalación de BM Tienda, ver Configuración de base de datos para Bridge Manager TiendaImportante: en caso de ejecutar SQL scripts en alguna de las diferentes opciones, es pre-requisito tener creada una base de datos vacía previamente junto con sus índices.

Una vez configurados los datos presionar el botón "siguiente", mostrando la próxima pantalla "Configuración de Base de datos de Bridge Manager" (ver )Motor de base de datos Oracle

Se informará la configuración por defecto, pero la misma podrá ser modificada según las siguientes indicaciones.

"Host de la base de datos": dirección IP o nombre del servidor de base de datos o nombre del host (localhost en el caso en el cual resida en el mismo servidor)"Puerto de la base de datos": se precarga por defecto con el puerto 1433."Instancia de la base de datos": en caso de existir para SQL Server no siempre es requerido"Nombre de la base de datos" (Ejemplo: bridge)"Usuario de la base de datos""Contraseña de la base de datos": clave del usuario de la base de datos"Nombre de la Base de datos Promo": permite definir el nombre de la base de datos de Promo para aquellos casos en los cuales deseara utilizar una nueva o mantener la misma.

Nota: tener en cuenta que estas propiedades son las utilizadas en el punto 2.5.4: Creación de la base de datosLuego de configurar todos los datos de la base de datos se podrá verificar su correcta conexión

Si se presiona el botón "Verificar conexión con la base de datos" y la prueba fue exitosa, se obtendrá el siguiente mensaje:

1.

Si la prueba no fue exitosa, se informará un mensaje indicando error, pudiendo ser alguno de los datos configurados no correctos.

Luego de configurar la base de datos y verificar su conexión, presionar el botón "siguiente" pasando a la siguiente pantalla "Configuración algoritmo de Hashing de Contraseñas"

Se configuran los siguientes datos de encriptación de contraseñas:

"Seleccione el algoritmo": Algoritmo de encriptación de contraseñas de usuarios de Bridge Manager y Bridge POS, con las opciones [SHA-1] o [MD5].

Nota: el algoritmo por defecto es [SHA-1].

1.

1.

Luego de configurar los datos de encriptación de contraseñas, presionar el botón "siguiente". Se mostrará la última pantalla donde se deberá presionar el botón "instalar" para finalizar la instalación.

Luego de presionar el botón "instalar", se podrán ir visualizando los pasos de la instalación.

1. En el caso de que se haya seleccionado la , se podrán ir visualizando los pasos de la instalación de Promoinstalación de Promo

1.

1.

Una vez finalizada exitosamente la instalación, se informará con un mensaje "Terminado", luego se deberá aceptar el mensaje con el botón "aceptar".

Presionando el botón "salir" se cerrará la pantalla del instalador finalizando el proceso de instalación.

Instalación fallida

En caso de instalación con fallas, se podrán verificar los errores presionando "Enseñar detalles", solapa "Errores".

Instalación cancelada

Si en algunas de las pantallas del instalador se presiona el botón "cancelar", se abortará el proceso y se informará con un mensaje "cancelado", cuando el mismo es aceptado, se cerrará la pantalla del instalador omitiendo todo paso previo configurado.

1.

Instalación fallida por no aceptación de términos y condiciones

Flujo particular si no fueron aceptados los términos y condiciones durante el proceso de Instalación de Bridge Manager

En caso de no haber tildado la opción de aceptación de términos y condiciones, pasará directamente a la última pantalla del proceso de instalación, informando que la misma fue fallida.

Motor de base de datos Oracle

Flujo particular si el servidor de base de datos seleccionado fue Oracle Si fue seleccionado Oracle, la pantalla permite configurar los datos del servidor y de la base de datos de Bridge Manager.

:Host dirección IP del servidor de base de datos o el nombre del host (localhost en el caso en el cual resida en el mismo servidor).Puerto: por defecto es el puerto 1521.Servicio o SID: nombre de la base de datos/instanciaUsuario: usuario de la base de datos.Contraseña: clave de la base de datos.

Nota: retomar al flujo de instalación (configuración punto-g)

Instalación de la aplicación Bridge Manager Tienda

Para llevar a cabo la instalación de un Bridge Manager Tienda, el instalador es el mismo utilizado para Bridge Manager Central, con lo cual la secuencia de pasos y pantallas es la misma. Para iniciar la instalación de Bridge Manager Tienda, continuar desde el paso del presente manual hasta finalizar la instalación. Ejecución del instaladorDesde el flujo de instalación, luego se indicarán cuáles son las diferencias en la configuración específicas para la tienda.

1.

Componentes a instalar para Bridge Manager tienda

En el caso de instalar un Bridge Manager Tienda, se deberá seleccionar la opción "tienda" en lugar de "central" en la pantalla "Componentes a instalar"

Una vez configurados los datos de la segunda pantalla presionar el botón "siguiente", mostrando la próxima pantalla "Configuración de base de datos"

Configuración de base de datos para Bridge Manager Tienda

En caso de estar instalando un Bridge Manager tienda, difiere la modalidad a ejecutar scripts.

"Seleccione el servidor de Base de datos": SQL Server o Oracle"Ejecutar scripts SQL": (sólo para tienda)

No ejecutar scripts SQL: si ya existiera una BD con las tablas ya generadasCreación del modelo de datos básico: se genera la estructura de tablas sin datos de laboratorioDatos de laboratorio se genera la estructura de tablas y se completan con datos de laboratorio como artículos, usuarios, terminales, etc.)(sin BM Central)Datos de integración: se generan datos de laboratorio para integración con ERP)

Importante: En caso de ejecutar SQL scripts en alguna de las diferentes opciones, es pre-requisito tener creada una base de datos vacía previamente.Si se encuentra instalando un Bridge Manager Tienda, luego de configurar la base de datos, debe retomar el flujo de instalación en el punto "Configuración de Base de datos de Bridge Manager"

Estructura de directorios creada en la instalación

Luego de haber instalado el Bridge Manager, quedará una estructura de directorios similar a la siguiente en el directorio de instalación (ej.: c:\synthesis\rs-bm). En esta figura (obtenida de una instalación en Windows), se identifican los directorios más relevantes que se deberán tener en cuenta:

appserver/bin: contiene los archivos para iniciar el servidor de aplicaciones (standalone.bat y su archivo de configuración standalone.conf.bat)

appserver/standalone/configuration: contiene el archivo standalone.xml que permite configurar los niveles de log de la aplicación como así también los datos de acceso a la base de datos. Ver sección 2.7.1: .Cómo cambiar la base de datos

appserver/standalone/deployments: contiene los binarios de la aplicación Bridge Manager (bridge.war, bridge-server-rest.war y del actualizador de versiones)

appserver/standalone/log: contiene los archivos logs de la aplicación Bridge Manager y del servidor de aplicaciones.Ver Análisis de logs

scripts: contiene todos los scripts de base de datos que se deberán correr para crear la base de datos (si no fueron ejecutados desde el flujo de instalación). Para mayor detalle ver sección 2.5.3: Creac.ión de la base de datos

tlog: esta carpeta se genera una vez que la aplicación fue iniciada, con dos carpetas (processed y withError) conteniendo los archivos tlogs.xml correspondientes a las aperturas y cierres de período (EOD, SOD) y a las operaciones de no venta generados desde Bridge Manager con la terminal 0 (arqueo, dotación y retiro).

1.

Instalación de la aplicación en modo no gráfico

Al instalador es posible ejecutarlo en modo gráfico o en modo texto. Dependiendo de si el entorno en el que se ejecute el instalador tiene interfaz gráfica o no, al iniciarse detecta si puede correr en modo gráfico caso contrario, se corre en modo texto. La configuración de las propiedades en modo texto se va a realizar de forma diferente. Las imágenes de las pantallas serán de línea de comando.

Ejecución del instalador en modo texto

Para forzar que el instalador ejecute en modo texto, agregar al comando de ejecución del instalador (java –jar ), la opción de la JVMbridge-manager-installer-{version}.jar-Djava.awt.headless=trueluego de JAVA_HOME/bin/java.

Desde una ventana de línea de comandos, ingresar el comando de ejecución del instalador en modo no gráfico.

1.

1. 1. 2.

Se irán mostrando las siguientes pantallas en las cuales se deberá ir configurando las mismas opciones de una instalación estándar gráfica.

Dependiendo el tipo de dato a configurar, se debe:presionar en caso de que se quiera instalar el modulo, en caso contrario escribir y luego presionar .Intro false Intropresionar el número de la opción deseada y luego .Intro

1.

1. 1. 2. 3.

Configuración del directorio de instalación, máquina virtual y puerto.

Componentes a instalar:Archivos de configuraciónInstalación como servicio WindowsTipo de instalación (tienda o central)

1. 1. 2.

1. 1. 2. 3. 4. 5.

Configuración de base de datos:Servidor de base datosEjecución de scripts SQL

Configuración de base de datos de Bridge ManagerHostPuertoInstanciaNombre de base de datos

1.

5. 6.

1. 1.

UsuarioContraseña de la base de datos

Configuración del algoritmo de contraseña para usuario de Bridge ManagerSHA1 (por defecto) o MD5

1.

1. 1.

2. 2. 3.

Luego de finalizado se informará en la ventana de comandos.

Instalación en modo silencioso

En esta modalidad de instalación, se podrá pre configurar mediante un archivo de configuración, para que el instalador tome los valores precargados y no sean solicitados en forma interactiva con las diferentes pantallas gráficas del instalador estándar. El archivo de configuración que se haya generado de una instalación previa, podrá ser utilizado de base para próximas instalaciones ajustando aquellos parámetros requeridos para una nueva ant.installinstalación tomando estos como parámetros por defecto.

Configurar parámetros del archivo ant.installPara la instalación de un Bridge Manager Central: se debe tomar la referencia de un ant.install de BM Central (ver: Detalle de parámetros del archivo ant.install para Bridge Manager Central

)con SQLPara tienda: un ant.install de BM Tienda (ver: )Detalle de parámetros del archivo ant.install para Bridge Manager Tienda con SQL

Copiar el archivo en el directorio donde se encuentra el instalador y desde donde se ejecutará el mismo en modalidad silencioso.Abrir una ventana de comandos como administrador.

1.

1.

Una vez configurado el archivo de propiedades ant.install, desde el directorio donde se encuentra ubicado el archivo del instalador, ejecutar el comando

java –jar bridge-manager-installer-{version}.jar text-auto

Una vez ejecutado el comando java –jar bridge-manager-installer-{version}.jar text-auto, se descomprimirá el archivo informando en la ventana de comando "Loading self extractor…" abriéndose un popUp donde irá informando el avance.

1.

1.

A medida que el instalador va ejecutando sus pasos, se irán informando en la ventana de comandos.

Al finalizar la instalación se informará en la ventana de comando como "Terminado"

1. 1. 1.

2.

3. 2.

3.

4.

Instalación fallida

En aquellos casos en los cuales se genere algún error, se informará en la ventana de comandos el mensaje de error. En el ejemplo, la clave del usuario de la base de datos no es correcto y da un error al intentar hacer un login con el usuario y clave configurados en el archivo de propiedades ant.install

Detalle de parámetros del archivo ant.install para Bridge Manager Central con SQL

A continuación se detallan aquellos parámetros que son tomados como base desde el archivo ant.install en aquellos casos en los cuales la instalación se lleve a cabo a través del comando text-auto sin tener la interacción con las pantallas gráficas donde se va solicitando el ingreso de la configuración de la instalación.

Ant Installer - properties auto generated on Fri\ Sep\ 15\ 16\:20\:37\ ART\ 2017 basedir = C\:\\Users\\andreaa\\AppData\\Local\\Tempantinstall4ant.install.config.version = 0.0

Properties from Page:license <!— Datos ingresados de aceptación de términos y condiciones de uso-->Properties from Page:licenseInput

.CheckboxInputlicense.accepted = true <!— Check de aceptación -->.ValidatedTextInputlicense.name = Juan Perez <!— Nombre completo -->.ValidatedTextInputlicense.email = juan_perez@gmail.com <!— Correo electrónico -->

4.

1. 5.

6.

7.

8.

1.

<!— Propiedades definidas para los directorios de instalación -->Properties from Page:InstDIR

.DirectoryInputinstallDir = C\:\\synthesisbridge <!— Directorio de instalación -->.JavaDirectoryInputjavaH = C\:Program Files\\Javajdk1.8.0_25 <!— Directorio de Java -->.HostTextInputruleWebservicePos.host = NTK-JOSEL <!— Host de instalación -->.LargeSelectInputjbossPort = -Djboss.socket.binding.port-offset\=100 <!— Puerto, por defecto toma el port 8080 dejando la opción vacía.

Opciones :8080 : jbossPort =

8180 : jbossPort = -Djboss.socket.binding.port-offset\=1008280 : jbossPort = -Djboss.socket.binding.port-offset\=200

8380 : jbossPort = -Djboss.socket.binding.port-offset\=300 -->

<!— Componentes a instalar -->

8.

1. 9.

10.

11.

12.

13.

14.

15.

1. 16.

17.

Properties from Page:selector.TargetInputconfig = true <!— Archivos de configuración, por defecto = true -->.TargetInputinstWrapper = false <!— Instalar como servicio al wildfly -->.TargetInputPromoInstall = true <!— Instalación de consola Promo -->.UnvalidatedTextInputdirector.url = https\://synthesis-director\:8490/ <!— URL de ubicación de Director -->.UnvalidatedTextInputdirector.storeCode = 1 <!— Código de tienda de Director -->.TargetSelectInputinstallType = central <!— Tipo de instalación, opciones: o -->tienda centralTargets selected for pageselector-targets = config,PromoInstall,central, <!— Resumen de instalación, valores de los parámetros config, instWrapper (solo si es true),PromoInstall (solo si es true),installType,Ej con servicio wildfly, Promo y central.selector-targets = config,instWrapper,PromoInstall,central,-->

<!— Configuración de base de datos para Tienda -->Properties from Page:dbselect

.TargetSelectInputdbengine = mssql <!— Servidor de base de datos (opciones : mssql u oracle)-->.TargetSelectInputrun-store-scripts = <!— Ejecución de scripts SQL. En este ejemplo de ant.install que es de BM Central esta opción queda vacía por ser scripts de tienda -->

17.

1. 18.

19.

20.

1. 21.

22.

23.

24.

25.

26.

<!— Configuración de base de datos para Central -->Properties from Page:dbselect

.TargetSelectInputdbengine = mssql <!— Servidor de base de datos (opciones : mssql u oracle)-->.TargetSelectInputrun-central-scripts = createLaboratoryDBCentral <!— Ejecución de scripts SQL para Central.

Las opciones son:noCreateDB ('No ejecutar scripts')

createDB ('Creación del modelo básico de base de datos'), createLaboratoryDBCentral ('Datos de laboratorio')

-->Targets selected for pagedbselect-targets = mssql,createLaboratoryDBCentral, <!— Resumen, según el ejemplo los valores que toman los parámetros dbengine, run-central-scripts --><!— Configuración de base de datos de Bridge Manager, si la base de datos seleccionada es SQL-->

Properties from Page:dsmssql.UnvalidatedTextInputdatasource.dbhost = localhost <!— host de la base de datos -->.UnvalidatedTextInputdatasource.dbport = 1433 <!— puerto de la base de datos -->.UnvalidatedTextInputdatasource.dbinstance = SQLEXPRESS <!— Instancia de la base de datos -->.UnvalidatedTextInputdatasource.dbname = BridgeManager <!— Nombre de la base de datos -->.UnvalidatedTextInputdatasource.username = sa <!— Uusuario de la base de datos -->Property hidden .PasswordTextInput

#datasource.password= XXXXXXXX <!— Contraseña del usuario de la base de datos. Descomentar esta línea y agregar la clave del usuarioEj.:datasource.password= nosotros

-->

26.

1. 27.

28.

29.

30.

31.

1. 32.

33.

1. 34.

<!— Configuración de base de datos de Bridge Manager, si la base de datos seleccionada es Oracle-->Properties from Page:dsoracle

.UnvalidatedTextInputdatasource.dbhost = localhost <!— host de la base de datos -->.UnvalidatedTextInputdatasource.dbport = 1433 <!— puerto de la base de datos -->.UnvalidatedTextInputdatasource.dbservice = orcl <!— Nombre de la base de datos/instancia -->.UnvalidatedTextInputdatasource.username = sa <!— Usuario de la base de datos -->Property hidden .PasswordTextInput

#datasource.password=XXXXXXXX<!— Contraseña del usuario de la base de datos. Descomentar esta línea y agregar la clave del usuario.Ej.:datasource.password= nosotros

--><!— Configuración algoritmo de Hashing de Contraseñas -->

Properties from Page:hashing.LargeSelectInputencryption = SHA-1 <!— algoritmo de encriptación de clave de usuarios. Opciones: SHA-1 o MD5 -->Targets selected for pagehashing-targets = hashing,centralConfig,

<!— Configuración algoritmo de Hashing de Contraseñas -->Properties from Page:progress

Targets selected for pageprogress-targets = licenseMessage,licenseAccepted,updateDB,cleanuptarget, <!— Resumen de la instalación, no modificar -->

Detalle de parámetros del archivo ant.install para Bridge Manager Tienda con SQL

A continuación se detallan aquellos parámetros que difieren de la instalación de una tienda con respecto a Central.Se mencionan sólo aquellos donde difiere con respecto a lo mencionado en el punto anterior de Bridge Manager Central. En este ejemplo, se configura para que se instale:

1. 1. 2.

3.

4.

5.

1. 6.

7.

8.

9.

10.

11.

12.

1. 13.

14.

15.

Actualizando el directorio de instalacióncomo servicio de Windowscon port 8380sin la consola de Promo ya que se instaló en Bridge Manager Centralsin ejecutar scripts (apuntando a una BD ya existente)actualizando la clave del usuario de base de datos

Properties from Page:InstDIR.DirectoryInputinstallDir = C\:\\synthesisBMT_Sep25C.JavaDirectoryInputjavaH = C\:Program Files\\Javajdk1.8.0_25.HostTextInputruleWebservicePos.host = NTK-JOSEL.LargeSelectInputjbossPort = -Djboss.socket.binding.port-offset\=300 <!— Componentes a instalar -->

Properties from Page:selector.TargetInputconfig = true.TargetInputinstWrapper = true <!— instalando el wildfly como servicio -->.TargetInputPromoInstall = false <!— sin instalar consola Promo, PromoInstall = false -->.UnvalidatedTextInputdirector.url = https\://synthesis-director\:8490/.UnvalidatedTextInputdirector.storeCode = 1.TargetSelectInput

installType = store <!— instalación de tienda -->Targets selected for page

selector-targets = config,instWrapper,store, <!— sin instalar consola Promo, e instalando wildfly como servicio de Windows --><!— Configuración de base de datos para Bridge Manager Tienda -->

Properties from Page:dbselect.TargetSelectInputdbengine = mssql.TargetSelectInput

run-store-scripts = noCreateDB <!— Ejecución de scripts SQL para Tienda. Ej : 'No ejecutar scripts de SQL'. Las opciones son:

noCreateDB ('No ejecutar scripts') createDB ('Crear modelo básico de base de datos'),

createLaboratoryDBCentral ('Datos de laboratorio, sin BMC') createIntegratonDB ('Datos de integración')-->

15.

1. 16.

17.

1. 18.

19.

20.

21.

22.

23.

24.

1.

Targets selected for page dbselect-targets = mssql, noCreateDB, <!— Resumen, según el ejemplo los valores que toman los parámetros dbengine, run-store-scripts -->

<!— Configuración de base de datos para Bridge Manager Central, no se configuran para BM Tienda -->Properties from Page:dbselect

.TargetSelectInputdbengine = mssql.TargetSelectInputrun-central-scripts = <!— Configuración de base de datos de Bridge Manager, si la base de datos seleccionada es SQL-->

Properties from Page:dsmssql.UnvalidatedTextInputdatasource.dbhost = localhost <!— host de la base de datos -->.UnvalidatedTextInputdatasource.dbport = 1433 <!— puerto de la base de datos -->.UnvalidatedTextInputdatasource.dbinstance = SQLEXPRESS <!— Instancia de la base de datos -->.UnvalidatedTextInputdatasource.dbname = BridgeManager <!— Nombre de la base de datos -->.UnvalidatedTextInputdatasource.username = sa <!— Uusuario de la base de datos -->Property hidden .PasswordTextInput

#datasource.password= XXXXXXXX <!— Contraseña de la base de datos. Descomentar esta línea y agregar la clave del usuarioEj.:datasource.password= nosotros

-->

Creación de la base de datos

La consola de administración requiere del uso de una base de datos. Para ello se debe crear una en el servidor de base de datos (ver especificaciones en la sección 2.4: ). Requerimientos de SoftwarePara la creación de las tablas que utilizará la Consola de administración y en su inicialización deberán utilizarse los ubicados en el directorio "BRIDGEMANAGER_DIR/scripts" generado durante scriptsel proceso de instalación (ver sección 2.5.2: ) o en caso de que se haya seleccionado la opción "Ejecutar SQL scripts" no es necesario realizarlo manualmente. A Instalación de la aplicacióncontinuación se detallarán los pasos a seguir.Crear la base de datos o esquema que utilizará la Consola de administración.

Se propone utilizar " ", de utilizarse otro nombre hay que tener en cuenta que éste deberá ser utilizado para el resto de la configuración.BridgeManager

:NotaCabe aclarar que los nombres de usuarios y de la base de datos a utilizar en este proceso, deberán ser los utilizados en el proceso de instalación. Ver sección 2.5.2.2: Configuración de propiedades

: Si fuese requerido, es posible cambiar la configuración de conexión con la base de datos en el proceso de instalación. Para ello, consultar sección 2.8.1: .Nota 2 Cómo cambiar la base de datos

Ejecutar el archivo .bat que crea las tablas de la base de datos de la Consola de administración:run_all_scripts_store.bat

Una vez terminados los pasos anteriores, puede continuarse con la ejecución del sistema (ver sección 2.6: ).Ejecución del sistema

Índices

Uno de los pre requerimientos previa instalación de Bridge Manager, es la creación de un FILEGROUP en el caso de SQL Server, o bien un Tablespace para el caso de ORACLE. Este será utilizada para almacenar los índices poder optimizar las consultas a la base de datos.

Debe poseer en nombre de INDEXES

Ejemplo SQL Server--Crear un FILEGROUP llamado INDEXES en la base de datos BridgeALTER DATABASE Bridge ADD FILEGROUP INDEXES;ALTER DATABASE Bridge ADD FILE ( NAME= 'INDEXES1', FILENAME = 'C:\Program Files\Microsoft SQL Server\MSSQL12.SQLEXPRESS\MSSQL\DATA\indexes.ndf' ) TO FILEGROUP INDEXES; Ejemplo Oracle--Crear un TABLESPACE llamado INDEXES en la ubicación C:/oracle/oradata/orcl/INDEXES.dbf CREATE TABLESPACE "INDEXES" LOGGINGDATAFILE 'C:/oracle/oradata/orcl/INDEXES.dbf' SIZE 512MEXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO;

Desinstalar MongoDB

Para poder desinstalar MongoDB, seguir los siguientes pasos:

Desde el menú inicio, buscar "configuración"

Seleccionar "Configuración" donde luego se mostrará un nuevo panel.

Seleccionar "Sistema"Luego de que se muestre un nuevo menú, seleccionar "Aplicaciones y características".Al buscar en el panel derecho por "mongo", se listará la aplicación. Al seleccionarla, se habilitarán los botones con la opción "desinstalar".

Al desinstalar solicitará confirmación y luego de confirmado se informará si la operación fue exitosa.

Ejecución del sistema

Configuración de la JVM

Antes de comenzar la ejecución de la aplicación se deberá controlar que se encuentren correctamente configurados algunos de los parámetros y variables de entorno relativos a la JVM. Parámetros y Variables de Entorno

JAVA_HOME: mediante esta variable de entorno es posible configurar el del componente JRE.path

:En Windows-Verificar el script la línea standalone.conf.bat set JAVA_HOME= …En Unix o similares:

Verificar en el archivo la siguiente línea:standalone.confJAVA_HOME="/opt/java/jdk"

JAVA_OPTS: mediante esta variable es posible configurar los parámetros propios de la JVM. Dentro de los parámetros más utilizados están:Xms: especifica la cantidad de memoria mínima del con la que arranca la JVM.heapXmx: especifica la cantidad de memoria máxima que la JVM puede alocar para el .heapXdebug (ver)

Es decir, que la memoria de la JVM va a estar en el rango [Xms, Xmx]. Para configurar estas opciones:

:En Windows

Verificar el script la siguiente línea y configurar el mínimo y máximo de memoria de acuerdo al hardware utilizado.standalone.conf.bat set JAVA_OPTS=%JAVA_OPTS% -Xms512M -Xmx1024M

En Unix o similaresEliminar los signos de comentario del archivo en la siguiente línea y configurar el mínimo y máximo de memoria de acuerdo al hardware disponible. standalone.conf

JAVA_OPTS="-Xms512M -Xmx1024M"

Iniciar la aplicación

Para iniciar la aplicación "Consola de administración" se dispondrá de uno de los siguientes archivos:

Para Windows<Directorio Instalación>/appserver/bin/standalone.bat

Para Linux<Directorio Instalación>/appserver/bin/standalone.sh

Donde <Directorio Instalación> corresponde al directorio donde se instaló el Bridge Manager

Nota: si se inicia por primera vez la aplicación Bridge Manager Tienda, ver Primera ejecución de la aplicación Bridge Manager Tienda

Acceder a la Consola de administración

Una vez iniciada la aplicación, podrá ser accedida mediante un explorador WEB, " , como por ejemplo: , , , , etc. browser" Chrome MS Internet Explorer Mozilla Firefox Netscape NavigatorIngresar la siguiente URL en la barra de direcciones del :browser

http:// :IP-SERVIDOR PORT_INSTALACION/bridge

Donde es la dirección IP o DNS del servidor donde se está ejecutando el servidor de aplicaciones, y es el puerto configurado durante la instalación. IP-SERVIDOR PORT_INSTALACIONEjemplo:

http://localhost:8080/bridge

Al acceder a la aplicación desde el browser, la primera pantalla será la del Inicio de sesión del usuario. Para poder operar con la consola deberá referenciar el manual de usuario: Manual de Usuario - Bridge Manager.doc

1.

Detener la aplicación

Para detener la aplicación, deben presionarse en forma simultánea las teclas " " dentro de la ventana de comandos donde se está ejecutando el servidor de aplicaciones WildFly donde se CONTROL + Cencuentra montada la aplicación de la Consola.

Primera ejecución de la aplicación Bridge Manager Tienda

Si se instaló un Bridge Manager como tienda y el mismo se encontrará vinculado a un Bridge Manager Central, se habilitará el asistente de tienda mediante el cual se solicitarán algunos datos de configuración requeridos para la conexión con un Bridge Manager Central la cual permitirá iniciar el proceso de sincronización de maestros y configuración. Para mayor detalle, ver Asistente de tienda

Asistente de tienda

Luego de la instalación de Bridge Manager con la configuración de tienda, la primera vez que la aplicación sea ejecutada (desde el standalone.bat) se iniciará el asistente de tienda o wizard.

Asistente de nueva tienda

Cuando se inicia la aplicación Bridge Manager tienda, se mostrará la pantalla de Inicio de sesión.

1.

1.

Al ingresar con el usuario: clave: ante el primer ingreso del usuario suser, se solicitará el cambio de clave. En el campo "contraseña anterior" ingresar , en el campo suser suser123, suser123"contraseña nueva" ingresar una nueva contraseña y la misma en el campo "confirmar contraseña".

Si los datos ingresados fueron correctos, se informará del cambio de contraseña exitoso y se deberá iniciar sesión nuevamente con la nueva contraseña.

Nota: el tooltip indicará la política de seguridad que tiene la clave.

Luego del login Bridge Manager tienda validará si se encuentra o no inicializado (con datos ya sincronizados de Central)

1.

1.

Se solicitará por pantalla el ingreso de los datos de la nueva tienda a instalar y luego se debe presionar "siguiente"código de tienda (requerido)nombre de tienda (requerido)

Opcionales:

Superficie de tienda (en m )2

Sup. destinado a ventas (en m )2

Se informará "la operación ha sido exitosa" y solicitará por pantalla el ingreso de la URL de Bridge Manager Central:dirección IP del Bridge Manager Central al cual se conectará el Bridge Manager tienda.

1.

1.

Se realiza prueba de conexión con el servidor de Bridge Manager Central y se verifica que la tienda no se encuentre duplicada en BMC, al presionar el botón "Comprobar conexión", si la misma fue exitosa se informará con un mensaje "conexión exitosa".

En caso de error en la conexión con la URL de Central, se informará "No se pudo conectar"

Luego de presionar "siguiente", solicitará el ingreso de un usuario administrador con su contraseña y la confirmación de la misma.

Nota: la contraseña ingresada tiene que cumplir con la política de seguridad definida en Bridge. Con el tooltip se informa como debe ser conformada la contraseña:

1.

1.

Cantidad mínima de caracteres numéricos, alfabéticos y su total.

De no cumplir con esta política, se informará con un mensaje en el margen derecho superior de la consola.

Luego de ingresados los datos del usuario, presionar el botón "siguiente".

Se solicita confirmar los datos de la tienda para que Bridge Manager Central pueda sincronizar sus catálogos, mediante el ingreso de la URL de tienda

1.

1.

URLhttp o httpsIP de la tiendaPuertoCarpeta de instalación

Presionar botón "importar maestros". Se valida la conexión con BMC

Una vez que se haya solicitado a Bridge Manager Central la sincronización de catálogos, se irán visualizando las entidades que se sincronizarán, cantidad de registros a importar de cada una, su grado de avance (en porcentaje) y si hubo o no registros con errores. Una barra en el margen superior indica el avance sobre el proceso total de sincronización.

1. Para poder visualizar los errores que se pudieron haber generado durante el proceso de importación se podrá acceder al monitor de importación.

(Ver documento ) Manual de Usuario - Bridge Manager

1. El asistente de tienda finaliza el proceso de sincronización informándolo en el margen superior (procesando 100%) y posteriormente se podrá ingresar a la consola mediante el botón "página de inicio", accediendo al Bridge Manager tienda (página de inicio, Resumen de ventas)

Lista de entidades a sincronizar desde Bridge Manager Central

A continuación se listan las entidades que se sincronizarán desde Bridge Manager Central a la nueva tienda instalada. El orden de entidades es alfabético, pero en el proceso de sincronización e importación, es considerado un orden de prioridades (import_type_priority) ya que existen dependencias que así lo requieren. Ej.:Los catálogos de marcas, proveedores y jerarquías departamentales deben ser importados previo al catálogo de artículos ya que son campos que vienen informados en cada artículo.

Catálogos Entidad

Marcas BrandList

Lista de precios BusinessUnitGroupItemList

Compañías CompanyList

Motivo de conciliación ConciliationReasonList

Tipo de método de contacto ContactMethodTypeList

Países CountryList

Clientes CustomerList

Holding HoldingList

Impuesto Interno InternalTaxList

Tipo de IVA de los artículos ItemIVATypeList

Artículos ItemList

Categorías del Ítem ante el IVA ItemTaxCategoryList

Ítem componente de kit e ítem kit LinkedItemList

Depósitos LocationList

Categorías departamentales MerchandiseHierarchyGroupList

Niveles de jerarquías MerchandiseHierarchyLevelList

Tipo de identificación PartyIdentificationTypeList

Motivos de cancelación de venta SaleCancelReasonList

Motivos de descuento del precio de venta de un articulo SaleItemDiscountReasonList

Motivos de devolución de una venta SaleReturnReasonList

Motivos de descuento del precio de una transacción de venta SaleTransactionDiscountReasonList

Artículos en Stock StockItemList

Listado de Tiendas StoreList

Regiones Impositivas StoreTaxCategoryList

Proveedores SupplierList

Tipos de Uso de Artículo TaxIntendedUsageTypeList

Jurisdicciones Impositivas TaxJurisdictionList

Categorización del cliente ante determinados impuestos TaxJurisdictionTaxTypeCategoryList

Administración de Relaciones Impositivas Anidadas TaxJurisdictionTaxTypeList

Tipo de impuestos TaxRateClassList

Registro de impuestos TaxTypeList

Medios de pago soportado por el POS TenderList

Configuración de terminal del medio de pago TerminalTenderConfigList

Unidades de Medida UnitOfMeasureList

Garantías WarrantyList

Categoría de terminales WorkStationCategoryList

Mantenimiento y configuración

Luego de haber realizado la instalación de la Consola de administración, es posible que sea necesario cambiar algún parámetro de configuración.Estos cambios pueden ser necesarios ya sea por:

cambio de la base de datos utilizada,algún cambio en el directorio de configuración,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 archivos de log,otras.

:Nota

Tener en cuenta que para realizar el mantenimiento se deberá detener la aplicación, realizar los cambios y luego volver a iniciarla. Para mayor información sobre cómo iniciar y detener la aplicación ver sección 2.6: .Ejecución del sistema

Análisis de logs

Para poder analizar determinados comportamientos de la aplicación, se registran los archivos logs en los cuales se podrá obtener información que permita diagnosticar diversos problemas que pudieran generarse en la operación diaria de tienda o en Central. Allí se podrán revisar errores de la aplicación como problemas en la distribución de TLOGs, exportaciones, etc. Los archivos a consultar:

server.log

Este archivo se irá renombrando diariamente con agregando en su nombre de archivo la fecha de la cual contiene información. Ej: server.log.2016-12-30

Cómo cambiar la base de datos

De ser necesario cambiar alguna de las siguientes propiedades de la conexión a la base de datos:

Nombre de usuarioContraseñaDirección IP donde se encuentraNombre de la base de datos

Deberán editarse los siguientes archivos DIRECTORIO_BRIDGE_MANAGER\appserver\standalone\configuration\standalone.xmlDIRECTORIO_BRIDGE_MANAGER\appserver\modules\system\layers\base\com\synthesis\configuration\main\bmconfig.properties Cada uno de los archivos de configuración mencionados anteriormente posee los siguientes parámetros, los cuales podrán ser editados en caso de ser necesario: Cadena de conexión para conectarse a la base de datos de la consola de administración.<connection-url>jdbc:jtds:sqlserver://localhost:1433/BridgeManager</connection-url>Nombre se usuario para acceder a la base de datos de la consola de administración.

<user-name>sa</user-name>Contraseña para acceder a la base de datos de la consola de administración.

<password>$(ds.pass)</password>De realizarse algún cambio, deberá utilizarse los mismos valores en todos los archivos antes mencionados, correspondientes al sistema operativo de instalación.

:Nota

'DIRECTORIO_BRIDGE_MANAGER' es el directorio de instalación.

Depuración de archivos de log

La aplicación registra diversos eventos dentro de un archivo de log. Asimismo, estos archivos, con el pasar del tiempo, aumentarán su tamaño progresivamente. Es por ello que es necesario realizar un cierto mantenimiento, consistente en la depuración de los mismos periódicamente. El directorio donde la aplicación realizará el log es el siguiente:

DIRECTORIO_BRIDGE_MANAGER\appserver\standalone\log

Todos los archivos correspondientes a este directorio podrán ser eliminados sin afectar el comportamiento de la aplicación. :Nota

' ' es el directorio de instalación.DIRECTORIO_BRIDGE_MANAGER

Configuración de archivos logs

Se puede configurar/ajustar desde el archivo el tamaño de los archivos logs de la aplicación, el mismo se encuentra ubicado en el directorio: logging.properties..\DIRECTORIO INSTALACION\appserver\standalone\configuration\logging.properties Parámetros de configuración sobre el tamaño de los archivos logs y su modo de generación. handler.FILESIZEDATE.level=ALLhandler.FILESIZEDATE.formatter=FILESIZEDATEhandler.FILESIZEDATE.properties=enabled,autoFlush,append,rotateSize,maxBackupIndex,suffix,fileNamehandler.FILESIZEDATE.enabled=truehandler.FILESIZEDATE.autoFlush=truehandler.FILESIZEDATE.append=truehandler.FILESIZEDATE.rotateSize=10485760 – tamaño máximo del archivo handler.FILESIZEDATE.maxBackupIndex=20handler.FILESIZEDATE.suffix=.yyyy-MM-ddhandler.FILESIZEDATE.fileName=C\:\\ ...\\appserver\\standaloneDIRECTORIO INSTALACIONlog/server.log 

NOTA: en el parámetro handler.FILESIZEDATE.fileName, se podrá definir el directorio donde va a residir el o los archivos de logs del server. 

Procesos de depuración

Mediante un proceso que se ejecuta en Bridge Manager y según configuración de determinados parámetros, se depuran registros de tablas de la base de datos que permiten liberar de espacio en la misma, pudiendo conservar registros históricos según sea requerido. Sobre el proceso de depuración:

Aplica tanto en Tienda como en Central.

Las tablas depuradas son:De auditoría y electrónico Journal: EV_ERR, EV_EJ, Operation_auditDe importación y replicación: Import_receipt y Replicacion_inboxDe distribución de transacciones: SRVR_T2A_TRX_ORI, SRVR_T2A_TRX_IXRETAIL y SRVR_T2A_TRX

Se ejecuta el storeProcedure con los parámetros de configuración que se detallan a continuación.DataCleaner

La siguiente configuración puede ser accedida desde la consola de Bridge Manager tienda, menú Configuración/configuración/opciones de tienda/Opciones varias de tienda.

Cantidad mínima de días de los que se conservarán los registros de auditoría:permite definir la cantidad mínima de días de los que se conservarán los registros de auditoría cuando se ejecuta el proceso de depuración.

Cantidad de Días en los que se guardan los Tlogs

Cantidad de días en los que se guardan los registros de importación y replicación procesados correctamente:en el caso de recibir los catálogos de artículos, proveedores, etc. desde un sistema externo ERP, los registros que se hayan generado e importado tanto en tienda como en central podrán ser depurados.

Cantidad de días en los que se guardan los registros de importación y replicación procesados incorrectamente

La siguiente configuración no se encuentra accesible desde la consola de Bridge Manager, sino directamente en la tabla RS_SYSTEM_PROPERTY:

Property_key Nombre Descripción Valor por defecto

'auditDepuration.repeatInterval' 'Intervalo entre ejecuciones del proceso de depuración de registros de auditoría.'

'Intervalo entre ejecuciones del proceso de depuración de registros de auditoría, expresado en milisegundos.'

'86400000'

Troublesooting

Si al iniciar la aplicación y conectarse desde un browser, no se observa la primer pantalla de inicio de sesión de usuario, aún no ha levantado la aplicación o se ha generado algún error en la ejecución. Intente nuevamente su acceso o revisando en el directorio de instalación, si los archivos de Bridge Manager han sido deployados (.war.deployed) o fallaron (.war.failed) … DIRECTORIO DE INSTALACION\appserver\standalone\deployments

Instalación de consola y motor de simulación de Promo

A partir de la versión 4.1.3 de Bridge, el instalador permitirá instalar Bridge Manager (Central o Tienda) junto con la consola y motor de simulación de Promo (v5.2)

Prerrequisitos de instalación de consola Promo y motor de simulación

Los prerrequisitos de Promo

Descripción Requisito mínimo

Servidor de Aplicaciones Wildfly 9

Memoria RAM libre 4 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:

Si ya se encontraba instalada la consola de Promo en el mismo servidor a instalar Bridge Manager, se debe desinstalar MongoDB y prever el proceso de migración de base de datos de PROMO. Si no se desinstala MongoDB, quedará apuntando al directorio previo de instalación del mismo.

Si está migrando desde la versión 4.3 referenciar el del doc Apéndice C: Actualización desde versiones anteriores MANUAL DE INSTALACION - PROMO V5.2

Componentes que se instalan

Consola de Promo 5.2

Como servicio

PromoSimEngine 1.3. (motor de simulación)MongoDB 3.4PromoEngineDirector

Los servicios de y quedaran instalados y ejecutándose en estado "Automático" (iniciaran al reiniciar el equipo donde está instalado PROMO)MongoDB, PromoSimEngine PromoEngineDirector

Log del instalador de Bridge con la consola de Promo

Al finalizar la instalación de Bridge junto con la opción "instalar Promo", se podrá chequear el resultado informado (en la solapa "Enseñar detalle") Targets:config,PromoInstall,central,mssql,createLaboratoryDBCentral,hashing,centralConfig,licenseMessage,licenseAccepted,updateDB,cleanuptargetUnable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre1.8.0_25\lib\tools.jarBuildfile: C:\Users\andreaa\AppData\Local\Temp\antinstall4\build.xml licenseValidation: licenseMessage: appserver:[echo] Installing Application Server[copy] Copying 1268 files to C:\synthesis\BMC_Sep15\appserver[copy] Copied 891 empty directories to 6 empty directories under C:\synthesis\BMC_Sep15\appserver[mkdir] Created dir: C:\synthesis\BMC_Sep15\tmp[mkdir] Created dir: C:\synthesis\BMC_Sep15\backup[mkdir] Created dir: C:\synthesis\BMC_Sep15\backupDB[mkdir] Created dir: C:\synthesis\BMC_Sep15\appserver\offline[echo] Copy resources /director to /director[copy] Copying 38 files to C:\synthesis\BMC_Sep15\director[echo] Copy resources /cmds to /cmds[copy] Copying 22 files to C:\synthesis\BMC_Sep15\cmds wrapper:[echo] Configuring wrapper config:[echo] Configuring appserver[mkdir] Created dir: C:\synthesis\BMC_Sep15\config[copy] Copying 112 files to C:\synthesis\BMC_Sep15\config[copy] Copied 28 empty directories to 2 empty directories under C:\synthesis\BMC_Sep15\config <span style="color: #1f4e79">SimulationEngine:</span><span style="color: #1f4e79"><ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="42019fa1-a7e2-4721-90e8-42a1ab86bf33"><ac:plain-text-body><![CDATA[[echo] Installing Sim Engine

[copy] Copying 49 files to C:\synthesis\BMC_Sep15\promo\engine

[copy] Copied 6 empty directories to 3 empty directories under C:\synthesis\BMC_Sep15\promo\engine

\\ \\ PromoConfiguration: PromoDatabaseServerCheck:

[echo] Checking Database Server

\\ PromoDatabaseServer:

[echo] Installing Database Server

\\ PromoDatabasePostCheck:

[echo] Checking Database Server

\\ \\ PromoDatabaseInteractive: PromoData:

[echo] Installing Data

[copy] Copying 20 files to C:\synthesis\BMC_Sep15\promo\mdb

[copy] Copied 8 empty directories to 2 empty directories under C:\synthesis\BMC_Sep15\promo\mdb

\\ PromoScripts:

[echo] Preparing Services

[copy] Copying 1 file to C:\synthesis\BMC_Sep15\promo\promoscripts

[copy] Copying 1 file to C:\synthesis\BMC_Sep15\promo\engine

\\ PromoServices:

[echo] Creating Services

[exec] Installing MondoDB

[exec] El servicio de MongoDB no se ha iniciado.

[exec]

[exec] Puede obtener m s ayuda con el comando NET HELPMSG 3521.

[exec]

[exec] 2017-09-15T16:22:30.118-0300 I CONTROL [main] Trying to remove Windows service 'MongoDB'

[exec] 2017-09-15T16:22:30.121-0300 I CONTROL [main] Service 'MongoDB' removed

[exec] El servicio de MongoDB est  inici ndose...

[exec] El servicio de MongoDB se ha iniciado correctamente.

[exec]

[exec] Installing SimEngine

[exec] C a n ' t o p e n s e r v i c e !

[exec] O p e n S e r v i c e ( ) : E l s e r v i c i o e s p e c i f i c a d o n o e x i s t e c o m o s e r v i c i o i n s t a l a d o .

[exec]

[exec] C a n ' t o p e n s e r v i c e !

[exec] O p e n S e r v i c e ( ) : E l s e r v i c i o e s p e c i f i c a d o n o e x i s t e c o m o s e r v i c i o i n s t a l a d o .

[exec]

[exec] S e r v i c e " P r o m o S i m E n g i n e " i n s t a l l e d s u c c e s s f u l l y !

[exec] S e t p a r a m e t e r " A p p D i r e c t o r y " f o r s e r v i c e " P r o m o S i m E n g i n e " .

[exec] S e t p a r a m e t e r " S t a r t " f o r s e r v i c e " P r o m o S i m E n g i n e " .

[exec] P r o m o S i m E n g i n e : U n e x p e c t e d s t a t u s S E R V I C E _ P A U S E D i n r e s p o n s e t o S T A R T c o n t r o l .

[exec]

[exec]

\\ PromoEstructure:

[mkdir] Created dir: C:\synthesis\BMC_Sep15\promo\backup

[mkdir] Created dir: C:\synthesis\BMC_Sep15\promo\import

[mkdir] Created dir: C:\synthesis\BMC_Sep15\promo\catalogs

[mkdir] Created dir: C:\synthesis\BMC_Sep15\promo\images

[mkdir] Created dir: C:\synthesis\BMC_Sep15\promo\images\profile

[mkdir] Created dir: C:\synthesis\BMC_Sep15\promo\images\barcode

[mkdir] Created dir: C:\synthesis\BMC_Sep15\promo\images\promotion

\\ PromoInstall:

[echo] "Installing Promo"

\\ central: \[echo\] Copiando Aplicaciones \[copy\] Copying 56 files to C:\synthesis\BMC_Sep15\appserver\standalone\deployments \\ mssql: \\ createLaboratoryDBCentral: \\ copyScripts: \[echo\] Copiando Scripts Base de datos \[copy\] Copying 14 files to C:\synthesis\BMC_Sep15\scripts \\ createDB: \[exec\] Ejecutando mssql-sql-central.sql \[exec\] Trato de instanciar conexion... \[exec\] Database connected! \[exec\] Executing Line by Line Script... \[exec\] Presione una tecla para continuar . . . \[exec\] Ejecutando lab-dataCommon-mssql.sql \[exec\] Trato de instanciar conexion... \[exec\] Database connected! \[exec\] Executing Line by Line Script... \[exec\] Presione una tecla para continuar . . . \\ hashing: \\ encryptionUser: \\ centralConfig: \[sql\] Executing commands \[sql\] 1 of 1 SQL statements executed successfully \\ licenseValidation: \\ licenseMessage: \\ licenseAccepted: \\ updateDB: \[echo\] jdbc:jtds:sqlserver://localhost:1433/BMC_Sep15;instance= \[sql\] Executing commands \[sql\] Executing commands \[sql\] Executing commands \[sql\] Executing commands \[sql\] Executing commands \[sql\] 5 of 5 SQL statements executed successfully \\ cleanuptarget: \[copy\] Copying 1 file to C:\instaladores Bridge\insta SEP 14 \\ BUILD SUCCESSFUL Total time: 2 minutes 31 seconds]]>

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.catalogsTickets: este directorio puede estar o no dependiendo del tipo de instalación (con KPI / sin KPI), y dependiendo a su vez del directorio de guardado de tickets que se especifique en el archivo promo.

del motor.propertiesTicketsender: este directorio puede estar o no dependiendo del tipo de instalación (con KPI / sin KPI). Y contiene al aplicativo que captura los tickets y los envía a la consola.

Acceder a la consola de Promo

Si durante el proceso de instalación se habilitó la instalación de PROMO, la consola levantará su aplicación con el mismo application server Wildfly de Bridge Manager. Una vez iniciada la aplicación, podrá ser accedida mediante un explorador WEB, " , como por ejemplo: , , , , etc. browser" Chrome MS Internet Explorer Mozilla Firefox Netscape NavigatorIngresar la siguiente URL en la barra de direcciones del :browser

http:// :IP-SERVIDOR PORT_INSTALACION/promo

Donde es la dirección IP o DNS del servidor donde se está ejecutando el servidor de aplicaciones, y es el puerto configurado durante la instalación. IP-SERVIDOR PORT_INSTALACIONEjemplo:

http://localhost:8080/promo

Al acceder a la aplicación desde el browser, la primera pantalla será la del Inicio de sesión del usuario. El por defecto del administrador es: usuario/clave admin/Promo2020

Operación con Consola y motor de simulación

Para poder operar con la consola deberá referenciar el documento:

Manual de Usuario - PROMO 5.2.doc

Mantenimiento y configuración

Referenciar anexo "Información de configuración" del doc MANUAL DE INSTALACION - PROMO V5.2