Manual de Instalación - Bridge Manager 7.7 - SMB
Painel | |||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||
|
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
SMB - Introducción
Napse cuenta con una amplia gama de soluciones que tienen como finalidad lograr una experiencia de compra única y positiva que cumpla con las expectativas del cliente.
Con este objetivo, BRIDGE - SMB cubre las necesidades del segmento medio de retailers, ofreciéndole una solución unificada, simple de instalar y operar, y mantiene las ventajas y beneficios de todos los productos de la Suite Napse.
¿Qué es SMB? (Segmento Medio Bridge)
Las soluciones Napse se encuentran instaladas y operando en retailers de diferentes países de América Latina, permitiendo atender, por ejemplo con Bridge tiendas físicas y virtuales. La integración de nuestros clientes con Promo permite crear una experiencia de consumo personalizada, ya que con Promo es posible centralizar promociones y programas de fidelidad. Con Vtol es posible la gestión e integración de compras electrónicas y la validación de pago desde y hacia las tiendas físicas y virtuales. Mientras que con Fiscal Flow es posible emitir, controlar, gestionar, almacenar y enviar a sus clientes comprobantes electrónicos.
Todo este potencial de la Suite Napse se fusiona en una única solución: SMB, pensada para el segmento medio, simplificando la puesta en marcha, agilizando su operatoria y optimizando su rendimiento.
SMB se compone de un único instalador que dejara operativo en el la tienda del retail del segmento medio la suite de soluciones Napse, compuesta por:
- Bridge Manager Central: Actúa como BackOffice complementando la operación en tienda de los puntos de venta. Cuenta con una “Consola de administración”, encargada de brindar una herramienta centralizada de administración en la nube.
- Bridge Manager Tienda: Proporcionara todas las opciones de administración de la tienda, manejo de inventario, medios de pago, gestión de clientes, informes, monitoreo de terminales, pedidos, presupuestos, configuraciones y opciones de seguridad, de forma simplificada e intuitiva.
- Bridge POS: es la aplicación de punto de venta que integra las interfaces de usuario, con servicios asociados a la venta (servicios en línea y gestión de promociones) y las reglas de negocio personalizadas. Maneja además de las operaciones de venta y devolución, operaciones de no venta y de contabilidad de caja.
- Integración con Promo: Durante la instalación se configuraran los elementos necesarios en Promo (cloud) para la gestión de las promociones.
- Integración con Vtol: Durante la instalación se configuraran los elementos necesarios en Vtol (cloud) para la validación de las transacciones electrónicas; así como también se instalara librería EVM (Correspondiente al país en el que se instale), el cual permite simplifica la integración y la comunicación con el medio de pago de tarjetas abstrayendo a la aplicación de punto de venta de procesos como el manejo del PINPAD, reconocimiento de tarjetas (crédito/débito y otras), a comunicación e integración con Gateway de transacciones VTOL y resolver problemas de contingencia.
- Integración con Fiscal Flow: Durante la instalación se configuraran los elementos necesarios en Fiscal Flow (cloud) para la gestión de facturas electrónicas; así como también se instalara el agente de Fiscal Flow permite una operación fuera de línea ante determinadas circunstancias y de acuerdo a configuración específica.
- Integración con Director: Durante la instalación se configuraran los elementos necesarios en Director (cloud) para la gestión y administración de nuevas versiones de los productos Napse instalados (Bridge Manager, Bridge POS, EmvKit y agente de Fiscal Flow y del mismo director)
Arquitectura de alto nivel
Expandir | ||
---|---|---|
| ||
Acerca de este manual
Expandir | ||
---|---|---|
| ||
En este manual encontrará toda la información necesaria para instalar el producto Bridge Manager para el Segmento Medio (SMB). 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: SMB - 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. SMB - Requerimientos de SW y HW: Informa las plataformas soportadas y los requerimientos de software y hardware para poder instalar el sistema. SMB - Instalación de prerrequisitos: Detalla los requisitos a cumplir previos a iniciar la instalación del producto y los pasos a realizar para cada modo de instalación disponibles. SMB - BMC - install.properties: Especifica cada uno de los campos que integran el archivo install.properties, necesario para la correcta ejecución de la instalación. SMB - BMT - install.properties: Especifica cada uno de los campos que integran el archivo install.properties, necesario para la correcta ejecución de la instalación de la tienda en Windows. SMB - Instalación BMC-SMB - LINUX: Informa cómo ejecutar el sistema sobre plataformas Linux. SMB - Instalación BMC-SMB - Windows: Informa cómo ejecutar el sistema sobre plataformas Windows. SMB - Instalación BMT-SMB - Windows: Informa cómo ejecutar el sistema sobre plataformas Windows. SMB - Resultado de la instalación: Detalla la estructura de directorios, base de datos, servicios luego de la instalación en cada una de las plataformas de instalación. SMB - Ejecución del sistema: Informa cómo acceder a la consola de BMC y el acceso a la consola del BMT. Ajustes posteriores a la instalación de BMC-SMB, como sincronización de catálogos, medios de pago, clientes, maestros de artículos y factura electrónica. SMB - Desinstalación: Resumen de cómo realizar la desinstalación. SMB - Manteamiento: Información a tener en cuenta para el mantenimiento del sistema. SMB -Troubleshooting: Detalle de problemas que pueden ocurrir y sus soluciones. |
SMB - Requerimientos de SW y HW
Expandir | ||
---|---|---|
| ||
Requerimientos de Hardware
Prerrequisitos de Software
|
SMB - Instalación de prerrequisitos en LINUX - SUSE
Expandir | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Para las Instalaciones de BMC - SMB sobre Linux SUSE 15 - Enterprice se proveerá un instalador de prerrequisitos (prereqLinux.sh) que al ejecutarse sobre un ambiente recién instalado y sin otra instalación preexistente, dejara instalado en el sistema los requerimientos de software necesarios para el correcto funcionamiento de Bridge SMB, a saber:
|
SMB - Instalación de prerrequisitos en WINDOWS
Expandir | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Java 1.8 sobre WindowsPara la instalación JAVA sobre Windows como prerrequisito de instalación de Bridge SMB se recomienda seguir los pasos expuestos en el siguiente video:
Se podrá ver el proceso de instalación y configuración de NodeJS como prerrequisito para la instalación de Bridge SMB de productos Napse sobre plataformas Windows en el siguiente link: Mongodb 4.2, configurado como replicaSet y seguridad activada sobre Windows
Para la instalación JAVA sobre Windows como prerrequisito de instalación de Bridge SMB se recomienda seguir los pasos expuestos en el siguiente video: NodeJS sobre WindowsSe podrá ver el proceso de instalación y configuración de NodeJS como prerrequisito para la instalación de Bridge SMB de productos Napse sobre plataformas Windows en el siguiente link: Mongodb 5 - configurado como replicaSet y seguridad activada sobre WindowsBridge Manager trabaja con una base de datos MongoDB por lo cual se requiere que no exista en el servidor donde se instala Bridge Manager, una versión previa.
Por otro lado, si MongoDB ya se encontrara instalado y con seguridad es requerido que exista uno de los siguientes usuarios:
Se podrá ver el proceso de instalación y configuración de MongoDB como prerrequisito para la instalación de Bridge SMB de productos Napse sobre plataformas Windows en el siguiente link: |
SMB - BMC - install.properties
Expandir | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
El archivo install.properties sera el utilizado para declarar todos los parámetros necesarios para la instalacion de Bridge Manager Central, utilizando el instalador silencioso.
|
SMB - BMT - install.properties
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
SMB - Instalación BMC-SMB en LINUX
Expandir | |||||
---|---|---|---|---|---|
| |||||
Napse se proveerá el paquete de instalación de BMC - SMB. Este paquete contendrá:
Adicionalmente, en el directorio de instalación, deberá de colocarse el archivo ant.install.properties de la compañía generado desde Director, para la instalación de BMC-SMB sobre Linux. Al momento de ejecutar la instalación, el directorio de instalación deberá presentar los siguientes elementos para garantizar una correcta instalación:
|
SMB - Instalación BMC-SMB en WINDOWS
Expandir | |||||
---|---|---|---|---|---|
| |||||
Napse se proveerá el paquete de instalación de BMC - SMB. Este paquete contendrá:
Adicionalmente, en el directorio de instalación, deberá de colocarse el archivo ant.install.properties de la compañía generado desde Director, para la instalación de BMC-SMB sobre Windows. Al momento de ejecutar la instalación, el directorio de instalación deberá presentar los siguientes elementos para garantizar una correcta instalación:
|
SMB - Instalación BMT-SMB en WINDOWS
Expandir | |||||
---|---|---|---|---|---|
| |||||
Napse se proveerá el paquete de instalación de BMT - SMB. Este paquete contendrá:
Adicionalmente, en el directorio de instalación, deberá de colocarse el archivo ant.install.properties de la compañía generado desde Director, para la instalación de BMT-SMB sobre Windows) Al momento de ejecutar la instalación, el directorio de instalación deberá presentar los siguientes elementos para garantizar una correcta instalación:
|
SMB - Resultado de la instalación
Expandir | ||
---|---|---|
| ||
Terminada la instalación podrán visualizarse los siguientes servicios activos en el entorno sobre el que se haya instalado.
Terminada la instalación podrá visualizarse la siguiente estructura de directorios en base a la ruta que se haya indicado al momento de la generación del .properties
Terminada la instalación podrá visualizarse la siguiente estructura en la base de datos de MongoDB. |
Expandir | ||
---|---|---|
| ||
Terminada la instalación podrán visualizarse los siguientes servicios activos en el entorno sobre el que se haya instalado.
Terminada la instalación podrá visualizarse la siguiente estructura de directorios en base a la ruta que se haya indicado al momento de la generación del .properties
Terminada la instalación podrá visualizarse la siguiente estructura en la base de datos de MongoDB. |
Expandir | ||
---|---|---|
| ||
Terminada la instalación podrán visualizarse los siguientes servicios activos en el entorno sobre el que se haya instalado.
Terminada la instalación podrá visualizarse la siguiente estructura de directorios en base a la ruta que se haya indicado al momento de la generación del .properties
Terminada la instalación podrá visualizarse la siguiente estructura en la base de datos de MongoDB. |
SMB - Ejecución del sistema
Expandir | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Para acceder a Bridge Manager Central - SMB, ingresar en un navegador web el nombre del servidor y el puerto indicado en la instalación (ej.: http://localhost:8080/login/auth) Se accederá a la pantalla de login:
|
Expandir | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
Para acceder a Bridge Manager Tienda - SMB, ingresar en un navegador web el nombre del servidor y el puerto indicado en la instalación. (ej.: http://localhost:8180/login/auth) Se accederá a la pantalla de login:
|
SMB - Configuraciones
Luego de haber realizado la instalación de la aplicación Bridge Manager, puede ser requerido algún cambio en los parámetros de configuración o ajustar algún parámetro por default del sistema.
Expandir | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
Base de datos La modificación de los datos de acceso a la base de datos se realiza desde cada uno de los componentes de Bridge Manager, en el directorio de instalación. Para que sea tomada la nueva configuración se requiere reiniciar los servicios. (Ver BM - Resultado de la instalación> Servicios)
Configuración de logs La política de logeo es propia e independiente de cada componente de Bridge. Manager (consola)
CORE El archivo log4j.xml es el archivo que contiene la configuración de los archivos log, ubicado en el directorio directorio de instalación\bridgecore\config En este archivo se puede modificar la configuración de:
API Puede modificarse la configuración del nivel de logueo desde bridgeapi\config\default.json Replicación
La colección ImportTypePriority detalla las entidades que se reciben desde sistemas externos y si se deben replicar a las tiendas o no. Para la entidad requerida (dataFileType), setear en false el atributo que indica si debe replicarse (replicateOnWizard) en la base de Central.
REPLICACIÓN POR TIPOS DE TRANSACCIONES DE TIENDA A CENTRAL La colección TransactionSubType contiene el detalle de los tipos de transacciones existentes. Allí se puede definir a través del flag mustReplicate (tipo boolean) si el mismo debe replicarse de tienda a central. |
SMB - Desinstalación
Expandir | ||
---|---|---|
| ||
Para la instalación del BMC-SMB deberán considerarse los siguientes puntos:
|
SMB - Mantenimiento
Expandir | ||
---|---|---|
| ||
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. El sistema genera archivos por componente (api, core, bridge consola), los cuales se ubican dentro de la carpeta "log" de la carpeta de cada componente, dentro del directorio de instalación. Por ejemplo, para API tenemos los archivos de log en: directorio instalación\bridgeapi\log Todos los archivos de logs pueden eliminarse sin afectar el comportamiento de la aplicación.
Para liberar espacio, periódicamente se depuran los datos de la base de datos de tienda y de central. Desde la consola de administración del BM en la sección Configuración> Sistema, seleccionando la opción Tienda y luego depuración, se pueden configurar el tiempo que se mantendrá la información de las entidades a ser depuradas, en el parámetro:
Las entidades que se depuran son:
|
SMB - Troubleshooting
Expandir | ||
---|---|---|
| ||
En general, lo problemas durante la instalación corresponde a problemas con compatibilidad de la base de datos (en caso de haber una base previa). Se recomienda realizar una desinstalación de la aplicación, incluyendo la desinstalación de la base de datos (ver: BM - Desinstalación).
Si al conectarse desde un browser, no se observa la primer pantalla de inicio de sesión de usuario lo más probable es que se ha generado algún error en la instalación. Verifique el archivo con el log de la instalación como primer paso. Puede deberse a que se haya iniciado la aplicación antes de haber finalizado la instalación y configuración de la base de datos. En este caso, se deberá reiniciar los servicios (Ver: BM - Resultado de la instalación, sección Servicios) y para asegurarse de que se hayan levantado, verificar en el log de bridge manager (ubicado en bridgemanager\log) que se encuentre levantado tomcat (buscar "Tomcat started on port(s)"). |