PE - Instalador desatendido automático







1. Objetivo

El objetivo de este documento es ofrecer una guía completa del proceso de instalación del agente de Fiscal Flow Colombia en el punto de venta, para poder comunicarse con el servidos de FF para poder operar.

Este tipo de instalador cuenta con una configuración definida por default, propia para una compañía y ambiente en particular, para agilizar su instalación.

2. Pre-requisitos del Sistema

Previo a la instalación se requiere verificar y cumplir con los siguientes pre-requisitos del sistema:

2.1 Requerimientos de Software

Detalle de los requisitos mínimos para la utilización del agente en el punto de venta:

  • 256 MB de memoria libre para el proceso (agente).
  • 512 MB de espacio en disco disponible.
  • Sistema operativo: 
    1. Windows 7 en adelante
    2. Sistema operativo Linux SUSE
    3. CentOS.
  • Node.js
  • Java  1.8

2.2 Instalación de Node JS

  • SISTEMA OPERATIVO WINDOWS:

    • Ingresar en: https://nodejs.org/en/ e instalar la opción recomendada.

      La instalación es estandard, es decir, hay que ir presionando siguiente, salvo en este paso en donde hay que marcar la opción, tal como se ve en la siguiente pantalla: 

      image2019-11-30_11-58-26.png

  • SISTEMA OPERATIVO LINUX

    Antes de continuar con este tutorial, hay que asegurar de haber iniciado sesión como usuario con privilegios de sudo.


    1. Agregar el repositorio NodeSource yum:
      curl -sL https://rpm.nodesource.com/setup_10.x | sudo bash -

    2. Instalar Node.js and npm :
      sudo yum install nodejs

    3. Para verificar que la instalación de nodejs y npm fue exitosa:

node --version (debería informar la versión de node, por ej: v10.13.0)

npm --version (debería informar la versión de npm, por ej: 6.4.1



3. Instalación

Paso a paso:

  1. Abrir una ventana de comandos de DOS en modo administrador.
  2. Dirigirse al directorio en donde se encuentra el instalador.

  3. Ejecutar el siguiente comando, siendo "fiscalflowagent.exe" el instalador:

    fiscalflowagent.exe /VERYSILENT


  4. Si desea ejecutarlo con el mouse, simplemente dar doble clic y seguir el flujo.

  5. Para realizar la instalación se requiere contar con los siguientes datos:

    • URL del servidor de FF del ambiente al que se quiere acceder (test o producción).
    • Puerto a escuchar


4. Resultado de la instalación

Detalle de las verificaciones a realizar luego de una instalación.

4.1 Archivos de programa

En el directorio indicado en la instalación se debe encontrar los siguientes directorios y archivos:

4.2 Servicio de windows

Se debe encontrar en estado "En ejecución" el servicio "napse-fiscal-flow-agent-mex":



4.3 Log de la instalación

En el archivo de log de la aplicación que se puede encontrar en directorio_instalación\log\info.log se debe visualizar la siguiente información:

En la última línea, se puede ver el numero de versión de la aplicación y su fecha de compilación.

4.4 Log de errores

El archivo de log de errores de la aplicación, que se puede encontrar en directorio_instalación\log\error.log se debe encontrar vacío si la instalación fue exitosa.

Si hubo problemas, tendrá el detalle de los mismos. A continuación se mencionan algunos errores comunes y su solución:

ErrorCausaSolución
sayHi: Error: getaddrinfo ENOTFOUND httpLa URL del servidor no se encuentra bien formada.

Las opciones son:

  • Reinstalar, modificando el parámetro /ip
  • Modificar la configuración de la instalación:
    • Bajar el servicio "napse-fiscal-flow-agent-mex"
    • Modificar la configuración:
    • Subir el servicio nuevamente.
sayHi: Error: connect ETIMEDOUT - http://10.4.201.52Al momento de realizar la instalación no había conexión con la VPN.Este error no requiere ningún ajuste. No es requerido tener conexión con la VPN al momento de instalar.


5. Verificación de funcionamiento

Para verificar si el agente se encuentra funcionando se puede invocar al servicio utilizado para obtener un token.

Para utilizar el servicio se requiere conocer el id y secret de la compañía.

URL: http://ip_terminal:1010/api/v1/oauth2/authenticate (reemplazar ip_terminal con la ip de la terminal en la que se instaló el agente).

Ejemplo: