Image RemovedImage Added

Manual de Instalación

Synthesis Director

...

DIRECTOR - Manual de instalación 1.1.X

...

...

Âncora
_Toc478737561 _Toc478737561

Âncora
_Toc500318338 _Toc500318338

1. Objetivo

El objetivo de este documento es ofrecer una guía completa del proceso de instalación del producto Synthesis Directorproducto Director.

Se explicarán los pasos de la implementación, los requerimientos de hardware y software como así también las propiedades a ser configuradas.

...

Âncora
_Toc500318339 _Toc500318339

2. Alcance

Synthesis Director de Synthesis Retail SolutionsNapse Global.

Âncora
_Toc500318340 _Toc500318340

3. Referencias

Se menciona la serie de documentos que acompañan al producto:

• Synthesis Director – Manual de instalación
  Este manual

• Synthesis Director – Manual de usuario
  Manual del usuario que explica la operatoria completa de Synthesis Director

• VTOL CORE – Manual de usuario
  Manual del usuario que explica la operatoria completa de VTOL Core

4. Introducción

4.1

...

¿Qué es

...

Director?

Synthesis Director es una solución de Synthesis Retail Solutions Napse que permite gestionar, administrar, distribuir y monitorear de manera centralizada y eficiente nuevas versiones de productos Synthesis Napse en la red de tiendas de un retailer.
Además, posee la funcionalidad de monitorear en forma remota las terminales publicando múltiple información de las mismas.

Âncora
_Toc500318343 _Toc500318343

4.2 Arquitectura

...

de Director

El producto se encuentra constituido por los siguientes componentes:

• Synthesis Director Server
  Ubicado de forma centralizada en un servidor, permite y efectúa la gestión, administración, coordinación e integración del sistema. Le ofrece al usuario una consola web de operación.

...

• Consola de administración
  Por medio de la interfaz gráfica web, el usuario puede acceder a la solución para administrar los productos Synthesis y Napse y sus versiones y monitorear las terminales de los locales.

...

• Git
  Se encarga de llevar a cabo el control y la gestión de versiones de los productos definidos en el sistema.

• Synthesis Director Agent
  Se encuentra integrado en cada producto de una terminal de una tienda, Entre sus principales funciones se encuentran: informar el estado del producto, actualizar el producto a nuevas versiones vigentes e informar datos de una terminal. 
  
  

Diagrama de Synthesis Director

Âncora
_Toc500318344 _Toc500318344

5. Flujo de Implementación

En este apartado se explicará la secuencia o los pasos para instalar, configurar e iniciar Synthesis Director:

1. Verificar y cumplir con los pre-requisitos del sistema, tanto de software como de hardware (apartado 6. Pre-requisitos del Sistema)
   
   
2. Efectuar la instalación completa mediante el asistente gráfico de instalación (apartado 7. Instalación)
   
   
3. Crear la base de datos y ejecutar los script de base de datos (apartado 8. Creación de la Base de Datos)
   
   
4. Iniciar Synthesis Director como proceso (apartado 9.1 Iniciar Synthesis Director)
   
   
5. Acceder a la consola web de administración e iniciar sesión (apartado 10. Acceso Administrativo a Synthesis Director)
   
   
6. Configurar las propiedades y las variables iniciales que utilizará Synthesis Director utilizará Director (apartado 11. Configuración Inicial del Sistema)

...

Una vez efectuado el flujo de implementación, dirigirse al documento "Synthesis Director - Manual de usuario.pdf" para conocer cómo operar con el producto Synthesis Director.

6. Pre-requisitos del Sistema

...

La instalación completa de Synthesis Director se realiza gracias al uso de un asistente gráfico de configuración.

...

Para instalar Synthesis Director Server se deben seguir los siguientes pasos:

...

1. Verificar la existencia de la base de datos que usará la aplicación Synthesis Director.
   
   
2. Iniciar sesión en el sistema operativo donde se instalará la aplicación con un usuario con permisos de administrador.
   
   
3. Iniciar el instalador de la aplicación Synthesis Director ejecutando la siguiente sentencia en la línea de comandos:

...

1. 1. La versión del motor de base de datos seleccionado
   2. El host de la base de datos
   3. El nombre de la base de datos que fue creada previamente para Synthesis Director
   4. El puerto de la base de datos
   5. Y las credenciales (usuario y contraseña) para la autenticación del motor de base de datos

...

13. Dentro del directorio elegido en el paso 7, se creó la carpeta con la versión instalada de Synthesis Director.

Los archivos creados son los siguientes:

...

...

A continuación, lo que se debe realizar es ejecutar los scripts en la base de datos. Ver el apartado 7. Creación de la Base de Datos.

Âncora
_Actualización _Actualización

Âncora
_Toc500318352 _Toc500318352

8. Actualización

...

Los scripts, para crear e inicializar la base de datos que emplea la aplicación, se encuentran en la carpeta "scripts" dentro del directorio de instalación del producto.

Los scripts se encuentran separados en carpetas "core" y "director" y también según el motor de base de datos al que corresponden.

...

Por último, se deben ejecutar los scripts de Synthesis Directorde Director, ubicados en

{DIRECTORIO_INSTALACION}/director/scripts/director/nombreMotorBD

...

Âncora
_Seguridad _Seguridad

Âncora
_Toc500318354 _Toc500318354

10. Iniciar/

...

Detener Director

Âncora
_Iniciar_Synthesis_Director _Iniciar_Synthesis_Director

Âncora
_Toc500318355 _Toc500318355

10.1 Iniciar

...

Director

...

Para iniciar Synthesis Director como proceso, se deben seguir los siguientes pasos:

1. Iniciar sesión en el sistema operativo
   
   
2. Ingresar a la carpeta {DIRECTORIO_INSTALACION}/director/bin
   
   
3. Ejecutar uno de los archivos según el sistema operativo:
   • start-director.cmd (Windows)
   • start-director.sh (Linux)

Âncora
_Toc500318359 _Toc500318359

10.2 Detener

...

Director

...

Para finalizar Synthesis Director como proceso, se deben seguir los siguientes pasos:

1. Iniciar sesión en el sistema operativo
   
   
2. Ingresar a la carpeta {DIRECTORIO_INSTALACION}/director/bin
   
   
3. Ejecutar uno de los archivos según el sistema operativo:
   • stop-director.cmd (Windows)
   • stop-director.sh (Linux)

...

...

11. Instalar Director como servicio

1. Iniciar sesión en el sistema operativo
   
   
2. Ingresar a la carpeta {DIRECTORIO_INSTALACION}/director/bin
   
   
3. Ejecutar uno de los archivos según el sistema operativo:
   • install-service.cmd (Windows)
   • install-service.sh (Linux)

El servicio se creará con el nombre DirectorServer

Âncora
_Acceso_Administrativo_a _Acceso_Administrativo_a

Âncora
_Toc500318363 _Toc500318363

12. Acceso Administrativo a Director

Director provee una consola web por la cual se pueden realizar distintas funciones, como ser:

...

Debido a las características de un servicio web, el acceso a la consola administrativa se puede realizar de forma remota.
Para acceder a la consola web de Synthesis Director de Director se debe utilizar el siguiente enlace:

...

• IP-SERVER: corresponde a la dirección IP o nombre del server donde se está ejecutando el servidor Synthesis Director
• PORT: corresponde al puerto del servidor web utilizado por Synthesis Director por Director (por defecto 8090 y 8490 para el seguro)

...

Finalizada la inicialización del sistema y accediendo a la URL mencionada, se visualizará la pantalla de login:

Image RemovedImage Added
Pantalla de Login

Âncora
_Toc500318365 _Toc500318365

...

12.1 Primer Inicio de Sesión

Synthesis Director concede por defecto una cuenta de acceso a la consola de administración que debe ser cambiada cuando se ingresa a la misma por primera vez.
El formulario de Login solicitará los datos de la cuenta por defecto:

...

Este usuario tendrá los permisos necesarios para poder gestionar los usuarios del sistema.

Âncora
_Configuración_Inicial_del _Configuración_Inicial_del

Âncora
_Toc500318366 _Toc500318366

...

13. Configuración Inicial del Sistema

A continuación se detallan todas las propiedades y variables de configuración de Synthesis Director.

Estas variables, pertenecientes al módulo "Director", son configurables a través de la página de configuración presente en la consola de administración web del producto que se accede mediante el punto de menú Configuración > Configuración de Propiedades.

...

Âncora
_Toc500318367 _Toc500318367

...

14. Puertos

Se detallan a continuación los puertos con los que opera el sistema.

...

Âncora
_Toc500318368 _Toc500318368

...

15. Logeo del sistema

El sistema generará trazas de log en la siguiente carpeta:

...

• el server.log, guarda información específica de la aplicación DIRECTOR
• el catalina.log, guarda información específica del contenedor
• el localhost_access_log.log, guarda información específica de accesos de la aplicacion (todas las solicitudes como http)
• el host-manage.logr, guarda información específica de eventos de la aplicación “manager”
• el manager.log, guarda información específica de la aplicación “host_manager”
• stacktrace.log, guarda información específica de excepciones de la aplicación

15.1 Configuración

• para configurar el server.log se debe modificar el file vtol-log4j.xml, el cual encontraremos en: {DIRECTORIO_INSTALACION}\tomcat\webapps\director\WEB-INF\classes\

...

...

16. Configuración adicional del sistema

...

16.1 Memoria

Para administrar la memoria del Director Server se debe crear un archivo setenv.bat (windows) o sentenv.sh (linux) en "[Instalación de Director Server]\tomcat\bin" con el siguiente contenido

...

...

16.2 Soporte

...

16.2.1 Utilización de JConsole

JConsole es una utilidad de la JVM de Sun que permite monitorear el funcionamiento en real time de una aplicación Java, como ser la memoria utilizada, los thread, procesador, etc

...

1. identificar el PID del proceso Director Server
2. abrir un shell con privilegios de administrador
3. ejecutar el comando jconsole PID, donde PID es el número de proceso identificado en el paso 1

...

16.2.2 Captura de Thread Dump y Memory dump

1. Identificar el PID de la aplicación JAVA
2. Abrir un SHELL con privilegios de administrador
3. Ejecutar los siguientes comandos

...

5. compartir para su análisis

Âncora
_Toc500318369 _Toc500318369

...

17. Anexo

Âncora
_Instalación_de_Git _Instalación_de_Git

Âncora
_Toc500318370 _Toc500318370

...

17.1 Instalación de Git

En este anexo se mencionarán los pre-requisitos y la explicación de cómo instalar los softwares de control de versiones Git.

En base al sistema operativo que posea el servidor a instalar Git, variará el software a instalar:

• Si el sistema operativo es Windows, se instalará Bonobo (apartado 15.1.1 Bonobo Git Server)
• Si el sistema operativo es Linux, se instalará GitLab (apartado 15.1.2 GitLab)

Âncora
_Toc500318371 _Toc500318371

...

17.1.1 Bonobo Git Server

1617.1.1.1 Pre-requisitos

Los requisitos previos para instalar Bonobo Git Server son:

• Servicios de Internet Information Services (IIS) 8
• .NET Framework 4.6 ( para Windows 7 Service Pack 1; Windows 8; Windows 8.1; Windows Server 2008 R2 SP1; Windows Server 2008 Service Pack 2; Windows Server 2012; Windows Server 2012 R2; Windows Vista Service Pack 2). (Windows 11 puede ya tenerlo incluido)
• Windows 10 con ASP.NET habilitado

...

1. Ingresar a la página de "Centro de Descargas" de Microsoft y buscar el componente "Microsoft .NET Framework 4.6 (instalador Web) para Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1, Windows Server 2008 SP2 Windows Server 2008 R2 SP1, Windows Server 2012 and Windows Server 2012 R2"
2. Seleccionar el idioma y presionar el botón "Descargar"
3. Un archivo ejecutable se descargará localmente, abrirlo y seguir las instrucciones del asistente gráfico de instalación
4. Aguardar a que se instalen los componentes y cerrar el instalador

1617.1.1.2 Instalación de Bonobo Git Server

...

1. 1. Nombre de usuario: admin
   2. Contraseña: admin

Âncora
_Toc500318372 _Toc500318372

...

17.1.2 GitLab

1617.1.2.1 Instalación de GitLab

...

1. Se debe cargar un SCHEME cuando se selecciona el motor de base de datos Oracle
2. La instalación se debe realizar sobre un directorio el cual el usuario que instalará posea permisos de lectura y escritura
3. Para iniciar Synthesis Director, iniciar Director, el usuario debe tener permisos de:
   1. lectura sobre el directorio de instalación
   2. ejecución sobre los archivos con extensión SH
   3. escritura sobre el directorio tomcat
4. Al crear un repositorio, se debe crear un archivo inicial para inicializar el repositorio

17.2 Agregar certificados a la Consola

Para agregar un certificado “.jks” a la consola de Director, se necesita guardar el “.jks” en la carpeta conf del tomcat donde se encuentra la instalación de Director Server${directorioInstalacionDirector}\tomcat\conf y configurar el mismo dentro del conf.xml que se encuentra en la sección:

Image Added

Y en ese connector agregar también el tag ciphers y el  sslEnabledProtocols  donde se indica seguridad.
Quedando de la siguiente manera:

<Connector protocol="org.apache.coyote.http11.Http11NioProtocol" 
               port="8490" maxThreads="200" 
               scheme="https" secure="true" 
               SSLEnabled="true" keystoreFile="conf/director.jks" keystorePass="nosotros" 
               clientAuth="false" 
               ciphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
               TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
               TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
               SSL_RSA_WITH_3DES_EDE_CBC_SHA" 
               sslProtocol="TLS"
               sslEnabledProtocols="TLSv1.2"/>   

18. Configurar Servidor SMPT

Para que Director pueda realizar el envío de mails, se deben realizar la siguientes configuraciones:

Abrir el archivo mail.groovy que se encuentra en el siguiente directorio: 

En el archivo mail.groovy editar las siguientes propiedades: 

• mail.username = completar con la cuenta del servidor SMPT
• mail.password.encrypted = completar con la contraseña de la cuenta. La contraseña se configura encriptada, seguir los siguientes pasos:
  

  • Abrir el directorio <directorio_instalación>\bin\mail (hacer cmd, para que abra la consola). Escribir "encrypt-mail-password.cmd <password>" (pasándole la pasword de nuestro correo. Nos devolverá la password encriptada, copiarla. Por ejemplo:
    Image Added

• mail.subject = completar con el texto que se usará como "Asunto" del mail
• mail.from = completar con la cuenta del servidor SMPT.
  
  • Para cuentas Office365 la propiedad mail.from debe ser igual a la propiedad mail.username

Importante:

Las propiedades "mail.subject" y "mail.from" NO deben tener la palabra "default".

Ejemplo de configuración:

mail.username = "[email protected]"
mail.password.encrypted = "c4CfVttz/+5Ce+UfeEFwrg=="
mail.subject = "VTOL Mail"
mail.from = "[email protected]"
mail.props.map = [  "mail.smtp.auth":"true",
                    "mail.smtp.socketFactory.port":"587",
                    "mail.smtp.socketFactory.class":"javax.net.ssl.SSLSocketFactory",
                    "mail.smtp.socketFactory.fallback":"true",
                    "mail.smtp.starttls.enable":"true"]
 
//GMAIL
//mail.host = "smtp.gmail.com"
//mail.port = 587
 
//Office 365
mail.host = "smtp.office365.com"
mail.port = 587