Versões comparadas

Versão antiga 1

changes.mady.by.user Micaela Abril Soto Rudel

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Maria Gala Higgins

Gravado em

Chave

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




Image Modified



Manual de Instalación - BRIDGE Manager

...

  • Por tienda: funciona local en cada tienda, en donde se permite realizar las operaciones de la propia tienda, monitorear su situación, realizar configuraciones locales.
  • Central: centraliza la información de todas las tiendas, permite realizar configuraciones generales a todas las tiendas y es quien recibe la información proveniente de los sistemas externos, para luego replicarlo a las tiendas, en caso de corresponder.

Gliffy Diagram
nameArquitectura Bridge Copy
pagePin1



Para realizar la instalación local en una tienda o en forma centralizada se utiliza un mismo instalador y se seleccionará el modo (tienda/central) al momento de la instalación.

...

Expandir

Si posee permisos de administrador del servidor puede iniciar la instalación haciendo doble click en el archivo instalador.

Si se realiza este paso y no tuviera permisos, se recibe el siguiente mensaje y no permite continuar la instalación.

Image Modified

Si no tuviera permisos de administrador, se necesita abrir la ventana de línea de comando en modo administrador:

Image Modified

Image Modified


Navegar hasta el directorio en donde se encuentre el archivo instalador.

Desde ese directorio, ejecutar el siguiente comando, indicando el nombre del archivo instalador disponible:

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

Ejemplo: c:\Descargas\java –jar bridge-manager-installer-7.0.0.jar

En el caso de que se quiera forzar el idioma del instalador al español, agregar el parámetro del idioma: java -jar -Duser.language=es bridge-manager-installer-7.0.0.jar

Al ejecutar el instalador, comenzará a extraer los archivos necesarios para la instalación.

Image Modified

Paso a paso

Luego de la extracción de los archivos, se presentan una serie de pantallas donde son requeridos datos para completar la instalación.

En caso de requerir cancelar el proceso de instalación en cualquiera de las pantallas, se debe presionar el botón "Cancelar".

A continuación se presentan cada una y se detalla la información requerida.

(1) Paso: Opciones de instalación obligatorias


Completar:

  • Directorio de instalación: indicar el directorio en que se desee ubicar los archivos de la instalación. Puede ser un directorio nuevo o uno existente.
  • Directorio Java: se debe configurar con el directorio en el cual se encuentra instalada la máquina virtual de Java (INCLUYENDO el directorio bin dentro del directorio a configurar). Por ejemplo: c:\JDK\bin.
  • 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, el host en minúsculas).
  • 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. Otras aplicaciones que se encuentren en el mismo servidor, no deben utilizar 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) Se validará que no se encuentre en uso al momento de la instalación
    • 8080
    • 8180
    • 8280
    • 8380
  • Ubicación archivo client.zip: Este archivo contiene imágenes y recursos para un cliente en particular. 


Informações
titleNota importante:
  • Directorio de instalación: si en el mismo servidor donde se instaló Bridge Manager Central se instalará Bridge Manager tienda, tener en cuenta la tienda se instale en un directorio diferente al definido para Central.
    • Ej:
      • c:\napse\bridge_Central
      • c:\napse\bridge_tienda1


Nota: si el directorio no existe, se informará con un mensaje.

  • Si confirma se crea el directorio, si no continúa sin crearlo

(2) Paso: Componentes a instalar


Completar:

  • Ubicación URL de Director: ruta de la ubicación URL de Director.
  • Tipo de instalación: de acuerdo al tipo de instalación solicitará distintas configuraciones posteriormente (tienda o central)
  • Integración con Teampleace: por defecto estará seteado en NO.

(3) Paso: Configuración de la base de datos de Bridge Manager - BM Central

En el caso de haber seleccionado Tipo de instalación = Central, solicita la siguiente información para la creación de la base de datos.


En el caso de que la base de datos indicada no exista, se creará y se creará el usuario con la contraseña indicada.

Completar:

  • Host de la base de datos: 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) en donde se desee crear la base de datos o donde reside la base de datos existente.
  • Puerto de la base de datos: por defecto es el puerto 27017.
  • Nombre de la Base de datos: identificador de la base de datos existente, o se debe indicar el nombre con el que se desee crear la base.
  • Usuario de la base de datos: usuario de la base de datos existente o indicar un usuario a ser creado.
  • Contraseña de la base de datos: clave del usuario de la base de datos existente  o indicar la contraseña para el usuario indicado.
  • Mecanismo de autentificación: usuario contraseña (default) o por LDAP
  • Seleccione el conjunto de Datos de Central: país donde se instalara el sistema: 
    • Argentina
    • Uruguay
    • México
    • Honduras
    • Colombia
    • Chile (a partir de v7.3)

Utilizando de la opción "Verificar conexión con la base de datos" se pueden corroborar los datos ingresados, en caso de que exista la base de datos.

Image Modified

NOTA: los nombres de los hosts deben ser ingresados en letra minúscula

(3.b) Paso: Configuración de la base de datos de Bridge Manager - BM Tienda

En el caso de haber seleccionado Tipo de instalación = Tienda, solicita la siguiente información para la creación de la base de datos.

++ La base de datos de la Tienda tiene que ser diferente a la base de datos del Central ++ (si se instala en el mismo servidor de base de datos)


En el caso de que la base de datos indicada no exista, se creará y se creará el usuario con la contraseña indicada.

Además de los datos solicitados para Central, solicita completar:

  • Código de la tienda: indicar el código que se le asignará a la tienda. Este código será el que se requerirá al instalar los POS de la tienda. Debe ser único.
  • Nombre de la tienda: nombre de fantasía.

En caso de instalar la tienda en el mismo servidor que Central, se pueden:

  • Indicar los datos del usuario creado al instalar central (tener en cuenta que la contraseña será la existente): asignará permisos al usuario para operar sobre la nueva base.
  • Indicar un nombre de usuario/contraseña nuevo: creará un nuevo usuario en la BBDD.

Utilizando de la opción "Verificar conexión con la base de datos" se pueden corroborar los datos ingresados, en caso de que exista la base de datos.

NOTA: los nombres de los hosts deben ser ingresados en letra minúscula

(3.c) Paso: Bridge Manager config - BM Tienda

En el caso de haber seleccionado Tipo de instalación = Tienda, solicita la siguiente información para conectarse con el Bridge Manager Central.

Completar:

  • Protocolo: se podrá indicar si es con protocolo de seguridad o no (http o https)

  • Hostname del Central: dirección IP del servidor o el nombre del host donde se encuentra instalado el central.
  • Puerto del BM Central: puerto indicado en el paso "Opciones de instalación obligatorias" al instalar el central.
  • Puerto de Bridge Api Central: puerto de central, pero finalizado en 1. Por ejemplo, si el puerto de BMC era 8080, el de API se crea automáticamente en 8081.
  • Puerto de Bridge Core Central: puerto de central, pero finalizado en 2. Por ejemplo, si el puerto de BMC era 8080, el de API se crea automáticamente en 8081.
  • Url de Promo: para permitir la conexión con PROMO.

NOTA: los nombres de los hosts deben ser ingresados en letra minúscula

(4) Paso: Configuración algoritmo de Hashing de Contraseñas


Completar:


Expandir
titleVer detalle
  • El archivo que se podrá seleccionar tiene algunas particularidades, a saber:
    • Nombre: scripts.zip (debe tener exactamente ese nombre y ser del tipo .zip)
    • Contenido del archivo scripts.zip  
      • a) Pueden ser archivos que permiten la ejecución de sentencias sobre la base de datos de Mongo
      • b) Pueden ser archivos json de colecciones a importar 
      • Ambos pudieran convivir dentro del mismo .zip (ver detalle en anexo)
  • Luego de seleccionar el archivo con el botón "Siguiente" continuará con la instalación

Image Modified


En el caso en el cual se haya incluido un archivo scripts.zip, se informará como uno de los pasos. 

  • En el paso clientScripts → se crea la tarea offline para la importación de tablas exportadas

  • Dependiendo de los archivos contenidos:
    • Los UPDATE, DELETE, INSERT.json
      • Estas sentencias se ejecutan como parte del proceso de instalación directo en la base de datos de la instalación. No tienen un orden estricto de ejecución sino que es aleatorio. 
      • NOTA: tener en consideración esto porque si luego en la replicación de maestros se enviaran registros que ya fueron impactados por algún update o insert, estos pudieran verse sobre escritos. 
    • Con los archivos que corresponden a Json de colecciones de Mongo, se creará una tarea offline para la importación de las tablas exportadas. 
      • Esto será posterior a la instalación 
      • Luego al instalar, como último paso se va a crear una tarea offline para la importación de dicho archivo (Borrando los datos de las tablas creadas por producto y remplazándola por las tablas que figuren en el ZIP)
      • Se puede comprobar ingresando al BM instalado, que se generó y ejecutó la tarea offline

image2022-9-23_16-35-55.png

  • Y verificar que los datos importados impactan en la instalación realizada.
  • En el ejemplo se modifica el nombre del ítem Anticipo, y se exporta la colección 'Item'



(5) Paso: Progreso de la instalación

Una vez completada toda la información de los pasos anteriores se accede a esta pantalla final.

También se acceda a esta pantalla en caso de NO haber tildado la opción de aceptación de términos y condiciones.

Seleccionar "Instalar" para iniciar la instalación.


Durante la instalación informa el progreso de la siguiente manera:

Durante y post instalación, al presionar "Enseñar det..." permite ver el log de la instalación y el detalle de los errores.


En caso de estar realizando una instalación de una tienda, se conecta automáticamente al central y se descarga todos los datos maestros requeridos.

Al finalizar la instalación informa:

Image Modified

(aviso) Al finalizar la instalación se debe verificar en la salida informada (solapa "salida"):

1) que no haya habido errores

2) que todos los logs de respuesta "ack" tengan código 0, por ejemplo: {"ack":0}


NOTA: En cualquier pantalla del instalador podrá solicitar la cancelación de la instalación con el botón "Cancelar".

Image Modified


BM - Instalación silenciosa

...

Expandir

Paso: Configurar parámetros

Para modificar los parámetros de la instalación se debe editar el archivo ant.install.properties que se encuentra en la carpeta en donde se encuentra el instalador.

Tomar el archivo correspondiente a la instalación que se quiere realizar (central o tienda, cada uno tiene su propio archivo).

PasoPropiedadant.install.propertiesValores

Términos y condiciones de uso (2/2)


Acepto los términos y condiciones de usolicense.acceptedtrue/false

Nombre completolicense.name

Correo electrónicolicense.email

Opciones de instalación obligatorias


Directorio de instalación

installDir



Directorio Java

javaH



Host donde se está instalando Bridge Manager

env.HOSTNAME



Puerto de escucha del servidor

ruleWebservicePos.host = NTK-NOELIAC
jbossPort =


Componentes a instalar


Archivo de configuración

config

true/false

Tipo de instalación

installType

  • central

Configuración de la base de datos de Bridge Manager - BM Central


Host de la base de datos

datasource.dbhost



Puerto de la base de datos

datasource.dbport



Nombre de la Base de datos

datasource.dbname



Usuario de la base de datos

datasource.username



Contraseña de la base de datos

#datasource.password


Configuración de la base de datos de Bridge Manager - BM Tienda


Host de la base de datos

datasource.dbhost



Puerto de la base de datos

datasource.dbport



Nombre de la Base de datos

datasource.dbname



Usuario de la base de datos

datasource.username



Contraseña de la base de datos

#datasource.password



Código de la tienda

storeCode



Nombre de la tienda

storeName


Bridge Manager config - BM Tienda


Hostname del Central

centralHost



Puerto del BM Central

centralPort



Puerto de Bridge Api Central

centralPortApi



Puerto de Bridge Core Central

centralPortBridgecore



Url de Promo

urlPromo


Configuración algoritmo de Hashing de Contraseñas


Algoritmoencryption

  • SHA-1

  • md5

Paso: Ejecutar instalación

Copiar el archivo en el directorio donde se encuentra el instalador y desde donde se ejecutará el mismo en modalidad silencioso.

Para iniciar la instalación, abrir la ventana de línea de comando en modo administrador:

Image Modified

Navegar hasta el directorio en donde se encuentre el archivo instalador.

Desde ese directorio, ejecutar el siguiente comando, indicando el nombre del archivo instalador disponible:

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

Ejemplo: c:\Descargas\java –jar bridge-manager-installer-7.0.0-SNAPSHOT.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.

Image Modified

Image Modified

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

Image Modified

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

Image Modified

BM - Resultado de la instalación

...

Expandir

Log de proceso de instalación

El registro del log de la instalación se puede encontrar en el archivo ant.install.log, ubicado en el directorio del instalador.

Allí se puede acceder al detalle de toda la operatoria realizada al momento de la instalación.e

Log de configuración de instalación

Luego de haber completado el proceso de instalación, junto al archivo instalador, se podrá encontrar el archivo ant.install.properties en donde se encuentra detallada toda la configuración seleccionada durante la instalación y puede utilizarse en una instalación silenciosa.

Base de datos

Luego de la instalación se contará con el servidor de base de datos instalado (en caso de que no existiera previamente) de MongoDB con dos bases de datos:

  • "admin":
    • Se puede acceder con usuario "admin" con contraseña "Nosotros123", el cual posee permiso root.
    • Contiene los usuarios que pueden acceder a la base.
  • con datos de Bridge manager (con el nombre indicado en la instalación):
    • Se puede acceder con el usuario/contraseña indicado en la instalación.
    • Aqui residirán los datos maestros, configuraciones y datos transaccionales de la aplicación. En caso de una base de Tienda, contará con todos los datos maestros, importados automáticamente de central durante la instalación.

Servicios del sistema

Terminado el proceso de instalación, podrá chequearse en los servicios del sistema la existencia de nuevos servicios que ya estarán ejecutandose de manera automática, lo cual permite indicar la correcta instalación y puesta en funcionamiento:

  • MongoDB Server (MongoDB)
  • NapseBridgeApi_xxx: siendo xxx el nombre de la base de datos.
  • NapseBridgeCore_xxx: siendo xxx el nombre de la base de datos.
  • NapseBridgeManager_xxx: siendo xxx el nombre de la base de datos.


Ejemplo

Image Modified

Estructura de directorios

Luego de haber completado el proceso de instalación, quedará una estructura de directorios similar a la siguiente en el directorio de instalación:

  • bridgeapi
  • bridgecore
  • bridgemanager
    • log: contiene los archivos logs de la aplicación Bridge Manager.

Ejemplo de estructura de una instalación en Windows, realizada en el directorio BMT:

Image Modified

Datos maestros

Al finalizar la instalación de un Bridge Manager en modalidad Tienda, se importan del Central los datos maestros.

Desde la consola de administración, opción Monitoreo> Monitor de Importación se puede visualizar los errores que pudieron haberse generado durante la importación.

...

Expandir

Consola de administración

Al finalizar la instalación quedan automáticamente ejecutándose los servicios que hacen que esté disponible la consola de administración.

Para acceder, ingresar en un navegador web el nombre del servidor y el puerto indicado en la instalación. ej: http://10.4.201.54:8180/

Se accede a la pantalla de login:


Image Modified

NOTA: si la aplicación BRIDGE MANAGER no levanta automáticamente luego de la instalación, REINICIAR los servicios del sistema

Ejemplo:

Image Modified

(aviso) En caso de que se requiera inactivar la aplicación se deben detener los servicios (Ver: BM - Resultado de la instalación, sección Servicios).


NOTA: para el login el super usuario: suser, contraseña: suser123

Este usuario no debería ser utilizado por el retailer sino por soporte interno de Napse. Para tal fin de se aconseja crear un usuario administrador propio para que utilice el retailer.

...

Expandir

Paso: Dar de baja los servicios

Para iniciar la desinstalación, abrir la ventana de línea de comando en modo administrador:

Image Modified

Navegar hasta el directorio en donde se haya realizado la instalación.

Se dispone de un desintalador por componente instalado, correspondiente a una carpeta.

Desde cada una de las carpetas ejecutar su desinstalador indicando: removeService.bat

De esta forma, se irán dando de baja los servicios que se encuentran ejecutándose.

Ejemplo:

Si la instalación del BM Central fue en el siguiente directorio C:\Users\carla.escalera\AMBIENTES\BRIDGE71\BMC

En cada una de las siguientes carpetas se instalará un removeService.bat

  • bridgeapi
  • bridgecore
  • bridgemanager

Para eliminar el servicio se deberá ir hasta dicha carpeta y ejecutar el removeService.bat

Image Modified

El ejecutarse se cerrará en forma automática la ventana de cmd y se eliminará el servicio.

Paso: Base de datos

Se requiere remover manualmente las bases de datos creadas en la instalación.

En el caso de no utilizar el motor de base de datos para otros fines, se sugiere desinstalarla:

2) Desinstalar MongoDB (desde la opción del sistema operativo para quitar aplicaciones).

3) Borrar la carpeta donde se encuentra instalado MongoDB, dado que mantiene configuraciones previas y no se elimina automáticamente al desintalar.

Paso: Eliminar archivos

Eliminar manualmente los archivos que se generaron en el directorio de instalación.

...

  • El nombre de la tabla o collection debe ser exactamente el mismo del modelo de datos de Mongo.

Image Modified


Ejemplo de como deben ser los nombres de los archivos:

Image Modified



c) Contenido ejemplo de cada archivo/sentencia 

...