Manual de Instalación - BRIDGE MANAGER v4.2

BRIDGE MANAGER
Manual de instalación y configuración inicial

Revisión 3.4

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:

• 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.
• Capí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.
• Capí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.
• Capí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.
• Capí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 adelante
• Linux (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.25
• Servidor de aplicaciones: Servidor de aplicaciones WildFly 9.0.1.Final
• Bases de datos (motores soportados):
• MSSQL Server 2008 R2 en adelante
• Oracle 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:

• Servidor de base de datos con conexiones TCP habilitadas
• Java Runtime Enviroment (JRE).
• 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_BASE
      • Si 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 Administrador
• Se 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ón.
NOTA:
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
IMPORTANTE: 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 mantenerse 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: bridge-manager-installer-{version}.jar, donde {version} es el número de versión del producto.
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.
IMPORTANTE: se debe ejecutar desde una ventana en modo administrador, debido a que si se instala la consola de Promo se requiere registrarlos como servicios.


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.2.7-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.2.7-SNAPSHOT.jar
(Ej: c:\Descargas\java –jar -Duser.language=es bridge-manager-installer-4.2.7-SNAPSHOT.jar)

Configuración de propiedades del instalador

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

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

• 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:

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

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

• "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)
  • 1. Botón seleccionar: opción que agiliza la búsqueda del directorio.
    2. 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)
  • 1. 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)

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

• "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")

• Integración con control de surtidores: opción "ninguno" o "Vox" (para el vertical petróleo)

• 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"

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

• "Ejecutar scripts SQL": se debe seleccionar una de las siguientes opciones
  • • No ejecutar scripts SQL: si ya existiera una BD con las tablas ya generadas
    • Creació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.

Nota: para instalación de BM Tienda, ver Configuración de base de datos para Bridge Manager Tienda y retomar nuevamente el flujo de instalación en el siguiente punto (h)
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 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 datos
Luego 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:

• 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].

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

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

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

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/instancia
  • Usuario: 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)

Replicación de entidades desde Bridge Manager Central a tiendas

Luego de la instalación de Bridge Manager Central, se recomienda ajustar el parámetro "Cantidad de entidades a generar en cada replicación" que se encuentra en el menú Configuración/replicación.

Por defecto se encuentra configurado en "3" como opción de laboratorio. En el caso de producción el valor sugerido es "200". Aplica a la replicación de entidades de Bridge Manager Central a las tiendas en el proceso del asistente de tienda.
Valor en base de datos:

• Tabla: replication_configuration
• Property_key = 'wizard.replication.size'
• Property_value = 3

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 Ejecución del instalador del presente manual hasta finalizar la instalación.
Desde el flujo de instalación, luego se indicarán cuáles son las diferencias en la configuración específicas para la tienda.

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 generadas
    • Creación del modelo de datos básico: se genera la estructura de tablas sin datos de laboratorio
    • Datos de laboratorio(sin BM Central) se genera la estructura de tablas y se completan con datos de laboratorio como artículos, usuarios, terminales, etc.)
    • 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 (a partir de la versión 4.1.5, la base de datos se podrá crear al presionar el botón "Verificar conexión con la base de datos"
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: Creació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).

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 bridge-manager-installer-{version}.jar), la opción de la JVM
-Djava.awt.headless=true
luego 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.

• 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:
  1. presionar Intro en caso de que se quiera instalar el modulo, en caso contrario escribir false y luego presionar Intro.
  2. presionar el número de la opción deseada y luego Intro.

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

• Componentes a instalar:
  1. Archivos de configuración
  2. Instalación como servicio Windows
  3. Tipo de instalación (tienda o central)

• Configuración de base de datos:
  1. Servidor de base datos
  2. Ejecución de scripts SQL

• Configuración de base de datos de Bridge Manager
  1. Host
  2. Puerto
  3. Instancia
  4. Nombre de base de datos
  5. Usuario
  6. Contraseña de la base de datos

• Configuración del algoritmo de contraseña para usuario de Bridge Manager
  1. SHA1 (por defecto) o MD5

• 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 ant.install 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 instalación tomando estos como parámetros por defecto.

• Configurar parámetros del archivo ant.install
  1. Para 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 SQL)
  2. Para 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.

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

• 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"

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.

1. 1. 1. Ant Installer - properties auto generated on Fri\ Sep\ 15\ 16\:20\:37\ ART\ 2017
         basedir = C\:\\Users\\andreaa\\AppData\\Local\\Temp
         antinstall4
         ant.install.config.version = 0.0
   2. Properties from Page:license
      <!— Datos ingresados de aceptación de términos y condiciones de uso-->
   3. Properties from Page:licenseInput
2. .CheckboxInput
   license.accepted = true <!— Check de aceptación -->
3. .ValidatedTextInput
   license.name = Juan Perez <!— Nombre completo -->
4. .ValidatedTextInput
   license.email = [email protected] <!— Correo electrónico -->
   
   <!— Propiedades definidas para los directorios de instalación -->
   1. Properties from Page:InstDIR
5. .DirectoryInput
   installDir = C\:\\synthesis
   bridge <!— Directorio de instalación -->
6. .JavaDirectoryInput
   javaH = C\:
   Program Files\\Java
   jdk1.8.0_25 <!— Directorio de Java -->
7. .HostTextInput
   ruleWebservicePos.host = NTK-JOSEL <!— Host de instalación -->
8. .LargeSelectInput
   jbossPort = -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\=100
   8280 : jbossPort = -Djboss.socket.binding.port-offset\=200
   8380 : jbossPort = -Djboss.socket.binding.port-offset\=300 -->
   
   <!— Componentes a instalar -->
   1. Properties from Page:selector
9. .TargetInput
   config = true <!— Archivos de configuración, por defecto = true -->
10. .TargetInput
    instWrapper = false <!— Instalar como servicio al wildfly -->
11. .TargetInput
    PromoInstall = true <!— Instalación de consola Promo -->
12. .UnvalidatedTextInput
    director.url = https\://synthesis-director\:8490/ <!— URL de ubicación de Director -->
13. .UnvalidatedTextInput
    director.storeCode = 1 <!— Código de tienda de Director -->
14. .TargetSelectInput
    installType = central <!— Tipo de instalación, opciones: tienda o central -->
15. Targets selected for page
    selector-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 -->
    1. Properties from Page:dbselect
16. .TargetSelectInput
    dbengine = mssql <!— Servidor de base de datos (opciones : mssql u oracle)-->
17. .TargetSelectInput
    run-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 -->
    
    <!— Configuración de base de datos para Central -->
    1. Properties from Page:dbselect
18. .TargetSelectInput
    dbengine = mssql <!— Servidor de base de datos (opciones : mssql u oracle)-->
19. .TargetSelectInput
    run-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')
    -->
20. Targets selected for page
    dbselect-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-->
    1. Properties from Page:dsmssql
21. .UnvalidatedTextInput
    datasource.dbhost = localhost <!— host de la base de datos -->
22. .UnvalidatedTextInput
    datasource.dbport = 1433 <!— puerto de la base de datos -->
23. .UnvalidatedTextInput
    datasource.dbinstance = SQLEXPRESS <!— Instancia de la base de datos -->
24. .UnvalidatedTextInput
    datasource.dbname = BridgeManager <!— Nombre de la base de datos -->
25. .UnvalidatedTextInput
    datasource.username = sa <!— Uusuario de la base de datos -->
26. 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 de base de datos de Bridge Manager, si la base de datos seleccionada es Oracle-->
    1. Properties from Page:dsoracle
27. .UnvalidatedTextInput
    datasource.dbhost = localhost <!— host de la base de datos -->
28. .UnvalidatedTextInput
    datasource.dbport = 1433 <!— puerto de la base de datos -->
29. .UnvalidatedTextInput
    datasource.dbservice = orcl <!— Nombre de la base de datos/instancia -->
30. .UnvalidatedTextInput
    datasource.username = sa <!— Usuario de la base de datos -->
31. 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 -->
    1. Properties from Page:hashing
32. .LargeSelectInput
    encryption = SHA-1 <!— algoritmo de encriptación de clave de usuarios. Opciones: SHA-1 o MD5 -->
33. Targets selected for page
    hashing-targets = hashing,centralConfig,
    
    <!— Configuración algoritmo de Hashing de Contraseñas -->
    1. Properties from Page:progress
34. Targets selected for page
    progress-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:

• Actualizando el directorio de instalación
• como servicio de Windows
• con port 8380
• sin la consola de Promo ya que se instaló en Bridge Manager Central
• sin ejecutar scripts (apuntando a una BD ya existente)
• actualizando la clave del usuario de base de datos

1. 1. Properties from Page:InstDIR
2. .DirectoryInput
   installDir = C\:\\synthesis
   BMT_Sep25C
3. .JavaDirectoryInput
   javaH = C\:
   Program Files\\Java
   jdk1.8.0_25
4. .HostTextInput
   ruleWebservicePos.host = NTK-JOSEL
5. .LargeSelectInput
   jbossPort = -Djboss.socket.binding.port-offset\=300
   <!— Componentes a instalar -->
   1. Properties from Page:selector
6. .TargetInput
   config = true
7. .TargetInput
   instWrapper = true <!— instalando el wildfly como servicio -->
8. .TargetInput
   PromoInstall = false <!— sin instalar consola Promo, PromoInstall = false -->
9. .UnvalidatedTextInput
   director.url = https\://synthesis-director\:8490/
10. .UnvalidatedTextInput
    director.storeCode = 1
11. .TargetSelectInput
    installType = store <!— instalación de tienda -->
12. 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 -->
    1. Properties from Page:dbselect
13. .TargetSelectInput
    dbengine = mssql
14. .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. 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 -->
    1. Properties from Page:dbselect
16. .TargetSelectInput
    dbengine = mssql
17. .TargetSelectInput
    run-central-scripts =
    <!— Configuración de base de datos de Bridge Manager, si la base de datos seleccionada es SQL-->
    1. Properties from Page:dsmssql
18. .UnvalidatedTextInput
    datasource.dbhost = localhost <!— host de la base de datos -->
19. .UnvalidatedTextInput
    datasource.dbport = 1433 <!— puerto de la base de datos -->
20. .UnvalidatedTextInput
    datasource.dbinstance = SQLEXPRESS <!— Instancia de la base de datos -->
21. .UnvalidatedTextInput
    datasource.dbname = BridgeManager <!— Nombre de la base de datos -->
22. .UnvalidatedTextInput
    datasource.username = sa <!— Uusuario de la base de datos -->
23. Property hidden .PasswordTextInput
    #datasource.password= XXXXXXXX <!— Contraseña de la base de datos. Descomentar esta línea y agregar la clave del usuario
    Ej.: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 Software).
    Para la creación de las tablas que utilizará la Consola de administración y en su inicialización deberán utilizarse los scripts ubicados en el directorio "BRIDGEMANAGER_DIR/scripts" generado durante el proceso de instalación (ver sección 2.5.2: Instalación de la aplicación) o en caso de que se haya seleccionado la opción "Ejecutar SQL scripts" no es necesario realizarlo manualmente. A continuación se detallarán los pasos a seguir.
24. Crear la base de datos o esquema que utilizará la Consola de administración.
    • Se propone utilizar "BridgeManager", de utilizarse otro nombre hay que tener en cuenta que éste deberá ser utilizado para el resto de la configuración.

Nota:
Cabe 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
Nota 2: 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: Cómo cambiar la base de datos.

1. 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 Bridge
ALTER 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" LOGGING
DATAFILE 'C:/oracle/oradata/orcl/INDEXES.dbf' SIZE 512M
EXTENT 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 path del componente JRE.

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

• Verificar en el archivo standalone.conf la siguiente línea:
  JAVA_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 heap con la que arranca la JVM.
• Xmx: especifica la cantidad de memoria máxima que la JVM puede alocar para el heap.
• Xdebug (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 standalone.conf.bat la siguiente línea y configurar el mínimo y máximo de memoria de acuerdo al hardware utilizado.
  set JAVA_OPTS=%JAVA_OPTS% -Xms512M -Xmx1024M
  
  En Unix o similares
• Eliminar los signos de comentario del archivo standalone.conf en la siguiente línea y configurar el mínimo y máximo de memoria de acuerdo al hardware disponible.
  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, "browser", como por ejemplo: Chrome, MS Internet Explorer, Mozilla Firefox, Netscape Navigator, etc.
Ingresar la siguiente URL en la barra de direcciones del browser:

• http://IP-SERVIDOR:PORT_INSTALACION/bridge

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

• 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

Detener la aplicación

Para detener la aplicación, deben presionarse en forma simultánea las teclas "CONTROL + C" dentro de la ventana de comandos donde se está ejecutando el servidor de aplicaciones WildFly donde se encuentra 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.

• Al ingresar con el usuario: suser clave: suser123, ante el primer ingreso del usuario suser, se solicitará el cambio de clave. En el campo "contraseña anterior" ingresar suser123, en el campo "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)

• 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)
  • código de inventario (requerido)

Opcionales:

• • Superficie de tienda (en m²)
  • Sup. destinado a ventas (en m²)

• Al completar el "código de tienda", se sugiere el "código de inventario" (en el caso de contener caracteres alfabéticos se omitirán informando sólo los caracteres numéricos)
• Si el código de tienda sólo contiene letras, se validará que se ingresen caracteres numéricos en el campo "Código de inventario".
• Este código será utilizado en el módulo de inventario para generar los nros de secuencia únicos por tienda.
• Bridge valida al momento de sincronizar con Bridge Manager Central que no exista un código de tienda o código de inventario igual al ingresado en el Wizard, caso contrario informará del error.

Ejemplo:

• Código de tienda 1010AB (alfanumérico)
• Código de inventario sugerido 1010 (toma sólo los números del código de tienda, pudiendo cambiarse)

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

• 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:

• 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

• • • URL
      • • http o https
        • IP de la tienda
        • Puerto
        • Carpeta 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.

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

• 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.
Las entidades que se sincronizan mediante el wizard pueden ser configuradas mediante script según campo "replicate_on_wizard" en true en la tabla import_type_priority. Si se encuentra en false, no se sincronizará el maestro en el proceso del asistente de instalación de tienda.
Ej.:
La lista de entidades/catálogos que se importan por defecto.
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.

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 usuario
• Contraseña
• Dirección IP donde se encuentra
• Nombre de la base de datos

Deberán editarse los siguientes archivos
DIRECTORIO_BRIDGE_MANAGER\appserver\standalone\configuration\standalone.xml
DIRECTORIO_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:

• 'DIRECTORIO_BRIDGE_MANAGER' es el directorio de instalación.

Configuración de archivos logs

Se puede configurar/ajustar desde el archivo logging.properties el tamaño de los archivos logs de la aplicación, el mismo se encuentra ubicado en el directorio:
..\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=ALL
handler.FILESIZEDATE.formatter=FILESIZEDATE
handler.FILESIZEDATE.properties=enabled,autoFlush,append,rotateSize,maxBackupIndex,suffix,fileName
handler.FILESIZEDATE.enabled=true
handler.FILESIZEDATE.autoFlush=true
handler.FILESIZEDATE.append=true
handler.FILESIZEDATE.rotateSize=10485760 – tamaño máximo del archivo
handler.FILESIZEDATE.maxBackupIndex=20
handler.FILESIZEDATE.suffix=.yyyy-MM-dd
handler.FILESIZEDATE.fileName=C\:
DIRECTORIO INSTALACION ...\\appserver
standalonelog/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.
• Hay un proceso que permite depurar información de auditoria, información transaccional y apartados y presupuestos.
• Dependiendo el tipo de información, se ejecuta un store procedure diferente.
• La ejecución de los store procedure dejan registro de auditoría que permitirá chequear la cantidad de registros depurados de cada entidad.
• La siguiente configuración puede ser accedida desde la consola de Bridge Manager tienda o Central, menú Configuración/Sistema/Opciones de tienda/Depuración

A continuación se agrega mayor detalle sobre los parámetros y entidades afectadas:

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

Nota: El uso de máquinas virtuales agrega un overhead que puede afectar la performance o escalabilidad.

• 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 Apéndice C: Actualización desde versiones anteriores del doc 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.4
• PromoEngineDirector

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

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,cleanuptarget
Unable to locate tools.jar. Expected to find it in C:\Program Files\Java\jre1.8.0_25\lib\tools.jar
Buildfile: 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="a69a2223-196e-4fbe-8b61-554a28114f70"><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 (.catalogs) que se importaran al iniciar la aplicación.
• Tickets: 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.properties del motor.
• Ticketsender: 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, "browser", como por ejemplo: Chrome, MS Internet Explorer, Mozilla Firefox, Netscape Navigator, etc.
Ingresar la siguiente URL en la barra de direcciones del browser:

• • • http://IP-SERVIDOR:PORT_INSTALACION/promo

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

• • • 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 usuario/clave por defecto del administrador es: 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

Anexo configuración de setup

Para mejoras en la performance de Bridge Manager con sus envíos de información entre Bridge Manager Central y los servidores de Bridge Manager tiendas, se cuenta con determinada configuración, la cual se describe en el siguiente anexo del documento.

• Doble chequeo de disponib de tienda
  • Tienda a BMC anuncia q esta activa
    • Evita que BMC envie datos (todas tienen que tener la misma versión)
  • Lote de clientes (qty de reg x configuración) En BMC se arma el lote y recién allí se envía a las tiendas. Si no se genera el lote con la cantidad de registros configurados se envía luego de 24hs de recibido el primer cliente.

Configuración 
a) Para configurar que no se importen los registros y se repliquen directo a tiendas, se debe configurar 

• En Central ejecutar:

update IMPORT_TYPE_PRIORITY set DO_IMPORT = 0 where data_file_type = 'ExternalItem' 
 (Reemplazar ExternalItem por la interfaz externa según lo que se requiera omitir importación en BMC)
b) Para configurar  la cantidad de registros que forman el lote de TLOGs a replicar de BMT a BMC

• Ejecutar lo siguiente en la Tienda:

update IMPORT_TYPE_PRIORITY set GROUP_QTY = 3 where data_file_type = 'T2ATransaction'
 (Configurar donde dice 3 el valor que se requiera configurar, ese número define la cantidad de registros por lote a generar)
Me gustaSé el primero al que le gusta esto

• Sin etiquetas
• Editar etiquetas

Principio del formulario
Escribe un comentario…
Final del formulario

• Envío de TLOG por subtipo

CONFIGURACION DE TIPOS DE TRANSACCIONES A REPLICAR DE BMT A BMC. (V1.1)

• En la tabla CO_TRX_SUB_TYP se agrega una columna FL_REPLICATE (tipo boolean) en la cual se define si el  TLOG del subtipo de transacción directamente NO se replica de BMT a BMC. 
• Condición: si el flag FL_REPLICATE está en FALSE no replica a BMC, en cualquier otro caso replica como funcionamiento nativo (ej: no existe el registro en la tabla, esta el flag configurado en TRUE, es NULL, etc.) 

• No importar en central y replicar directo a tiendas

V1.3 CONFIGURACIÓN PARA QUE EN BMC SE IMPORTE O NO NOVEDADES DESDE SERVICIOS EXTERNOS 

Se agrega funcionalidad:

• configurar desde la import_type_priority si las novedades recibidas desde un servicio externo se importan o no en BMC previa replicación a las tiendas. 
• agrupar registros para armar cada lote de TLOGs para ser replicados desde BMT a BMC 

En ambas BBDD (BMC y BMT) 

Tabla:  Import_type_priority
Se agregan dos nuevos campos

Configuración de tienda para cálculo de impuestos del cliente (percepciones)

Para que la tienda pueda calcular percepciones de Ingresos Brutos y de IIVA, se deben configurar los datos de la tienda.

-       Domicilio completo de la tienda (país, provincia y ciudad)

-       Check “agente de retención” activo

-       Categoría impositiva “IVA responsable inscripto” o la que corresponda (si se configura en CONSUMIDOR FINAL no calculará)

En Bridge Manager, chequear ADMINISTRACION/NEGOCIO/Tienda 

En caso de que no se encuentren correctamente configurados los datos de la tienda, al agregar un cliente del tipo empresa en Bridge POS a la venta en curso, se informarán mensajes informando la no correspondencia de la jurisdicción.

Reinstalación del motor de búsqueda Elastic Search

En aquellos casos en los cuales se requiera la reinstalación del motor de búsqueda Elastic Search,  posterior a la instalación del servidor de Bridge Manager, será necesario tener la siguiente consideración: