Instructivo de implementación de Sinergial Advance

Él presente documento intentará ser una guía para poder pasar a producción Sinergial Advance con sus distintas modalidades y alternativas de implementación. 

La mayoría de los métodos exige como requisito tener el sitio ya configurado en IIS.

• Sinergial (base de datos) instalado en la versión compatible indicada en las notas de versión.

• API Sinergial instalada en la versión compatible indicada en las notas de versión.

• API Integra instalada en la versión compatible indicada en las notas de versión.

• Servidor IIS o Nginx configurado y funcionando.

1. Dirigirse al siguiente directorio F:\Sinergial\Deployment\Sinergial Advance\X.X.0 (donde X.X es la versión a implementar)

2. Entrar a Server

3. Entrar a Fuente

4. Copiar todo el contenido de la carpeta.

5. Dirigirse hasta el PC que hará el rol de servidor para el cliente y abrir la carpeta donde el IIS apunta en el sitio creado para Sinergial Advance

   1. Open

      

6. Copiar todo el contenido en dicha carpeta

7. Buscar el archivo page.json en el directorio /assets

8. Editar los datos con los del cliente

Open

1. Nombre → El nombre de la empresa

2. Api_server → La URL de la API Sinergial

3. Url_img → La URL donde se encuentran almacenadas las imágenes.

4. Api_integra → la URL de la API Integra

5. Por cada módulo se debe señalar con true/false si se encuentra activo en modo de desarrollo.

6. Luego de la configuración, se debe entrar a la plataforma desde la url que definimos en IIS.

7. Se comienza el proceso de validación de la licencia (ver documento)

8. Se comienza el proceso de Credenciales de API (Ver documento)

1. Dirigirse al siguiente directorio F:\Sinergial\Deployment\Sinergial Advance\X.X.0 (donde X.X es la versión a implementar)

2. Entrar a Server

3. Entrar a Fuente

4. Copiar el contenido de la carpeta.

5. Dirigirse al directorio que indica el sitio en IIS y eliminar todo el contenido, no sin antes realizar una copia del archivo /assets/page.json y /assets/images/logo/logo-empresa.png

6. Pegar todo el contenido de la version nueva en la misma carpeta.

7. Remplazar los archivos de respaldo (page.json y logo-empresa.png)

1. Dirigirse al siguiente directorio F:\Sinergial\Deployment\Sinergial Advance\X.X.0 (donde X.X es la versión a implementar)

2. Copiar el instalador Sinergial Advance Setup.exe en la PC del cliente.

3. Ejecutar el instalado dando doble clic.

4. Esperar a que el programa se cargue y luego presionar Siguiente.
   
   

   Open

   

5. En la siguiente pantalla se podrá seleccionar el modo de instalación

   1. Aplicación

   2. Server (usando IIS)

   3. Server (usando Nginx)
      
      

      Open

      
      Open

      
      Open

      

6. Presionar botón siguiente.

7. En la siguiente página se podrá seleccionar el directorio donde se quiere instalar, 

   1. en el caso de haber seleccionado el Modo Aplicación, por defecto vendrá en la ruta C:\Oliver\SinergialAdvance

   2. en el caso de haber seleccionado el Modo Server(NGINX), por defecto estará en la ruta C:\Oliver\SinergialAdvance (asegurarse de tener instalado el servidor NGINX en esa ruta , esto se hace con el instalador de API INTEGRA)

   3. en el caso de haber seleccionado el Modo Server (ISS), por defecto vendra en la ruta C:\inetpub\wwwroot\SinergialAdvance  (asegurarse de tener el servidor IIS creado apuntando a esa ruta)
      
      

      Open

      
      Open

      

8. Luego de seleccionado el directorio presionar siguiente

9. En la siguiente pantalla completar los datos del page.json
   
   

   Open

   

   1. Nombre Empresa → El nombre de la empresa

   2. API Sinergial → La URL de la API Sinergial

   3. API Integra → la URL de la API Integra

      1. Es importante completar los campos de API Sinergial y API Integra , ya que si permanecen vacios , fallaran la validacion de licencia y obtencion de credenciales de api

   4. URL de Imágenes → el directorio de imágenes usado para el plugin de visualizador de precios

   5. Logo de la empresa → logo usado para reportes ( SI DEJAMOS LA IMAGEN VACÍA QUEDARÁ LA IMAGEN POR DEFECTO DE OLIVER)

10. Luego de completados los datos, presionar el botón siguiente

11. A partir de esta versión se podrá validar la licencia y generar/obtener las credenciales de API desde el mismo instalador, por lo cual en la siguiente pantalla se requerirá ingresar un usuario de sinergial.

    Open

    

12. Una vez ingresado podremos opcionalmente corroborar que el usuario sea correcto presionando el botón Validar y luego presionar el botón Siguiente

13. En la siguiente pantalla podremos ingresar el número de licencia.

    Open

    

14. La cual también podremos validar presionando el botón Validar y continuaremos presionando el botón Siguiente

15. En el caso de estar instalando el Modo Aplicación, la siguiente pantalla nos preguntará si queremos crear un acceso directo a la versión app en el escritorio
    
    

    Open

    

16. Luego de tildado el checbox , presionar el botón siguiente

17. En la siguiente pantalla se mostrará todo lo que se va a instalar.
    
    

    Open

    

18. Presionar botón instalar

19. Se mostrará una pantalla de carga y al terminar la pantalla de finalización de instalación, en el modo app nos preguntará si queremos ejecutar la aplicación (si fuera el caso).
    
    

    Open

    

20. Presionar finalizar, con estos terminaría la instalación.

1. Dirigirse al siguiente directorio F:\Sinergial\Deployment\Sinergial Advance\X.X.0 (donde X.X es la versión a implementar)

2. Copiar el actualizador Sinergial Advance Update.exe en la PC del cliente.

3. Ejecutar el instalado dando doble clic.

4. Esperar a que el programa se cargue y luego presionar Siguiente.
   
   

   Open

   

5. En la siguiente pantalla se autoseleccionara el modo de instalación detectado en el sistema

   1. Aplicación

   2. Server (usando IIS)

   3. Server (usando Nginx)
      
      

      Open

      
      Open

      
      Open

      

6. Presionar botón siguiente.

7. En la siguiente página se autoseleccionara la ruta donde fue instalada la aplicación

   Open

   

8. Luego al presionar el boton siguiente

9. Nuevamente como en la instalación tendremos la pantalla de las configuraciones, pero los campos estarán pre cargados con los datos de la versión instalada

   Open

   

10. Al presionar el botón Siguiente nuevamente se nos pedirá ingresar un usuario de sinergial

    Open

    

11. Al ingresar el usuario y presionar el botón siguiente podremos ver la licencia de la versión instalada , la cual podremos cambiar si es necesario

    Open

    

12. Una vez presionado el botón siguiente podremos actualizar la versión en la siguiente pantalla

    Open

    

13. Al finalizar la actualización se mostrará la opción de ver los cambios en el archivo de configuración page.json, usando el programa winMerge, este compara el nuevo page.json con un file page.json.backup que se encuentra en la carpeta donde está la versión instalada.

    Open

    

14. Una vez corroborados los cambios, el proceso de actualización estará completo.

OBSERVACIONES:

• A partir de la versión 5.3.22 se cambió el paquete para el uso de notificaciones Web Socket de Abbly a Reverb.

• Se agregó la configuración al page.json en “servidor”:

  //DEBERIA SALIR CONFIGURADO DE LA SIGUENTE MANERA EN CASO CONTRARIO COMUNICAR A DESARROLLO "echo_config": { "app_key": "knlafqer7oytgscp4eml", "host": "{aqui modificar por dominio que apunta al servicio de webSocket del cliente en el servidor IIS}", "port": 443, "cluster": "mt1" }

• Para dudas sobre como configurar servicio webSocket ir a : https://oliverinformatica.atlassian.net/wiki/spaces/AI/pages/807731204/Websocket+Reverb