Manual de Instalación

Synthesis Director

Cambio por Revisiones

Âncora
_GoBack _GoBack

Índice 

...

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.

Nota
Recomendación: Se recomienda instalar Synthesis Director en el mismo servidor en que se encuentra instalado Git o en un servidor separado con una conexión de red de al menos 100MB.

...

Nota
Nota: Verificar tener correctamente seteada la variable JAVA_HOME. En caso de no tenerla, setearla a la carpeta de instalación de la JVM. Para esto verificar la carpeta de instalación, ejemplo: C:\Java\jdk1.8.0_77".

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.

Nota
Nota: El SD Agent inicia en el puerto 8383. El SD Agent conoce una IP y un puerto para comunicarse con SD Server. Se tiene q que establecer una comunicación bidireccional entre Agent y Server.

Â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.

Âncora
_Creación _Creación

Los scripts de base de datos existentes deberán ser ejecutados, con el usuario administrador de base de datos.
Cada archivo contiene, como inicio de su nombre, un número que indica la secuencia en que debe ser corrido.

...

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

{DIRECTORIO_INSTALACION}/director/scripts/director/nombreMotorBD

...

Aviso
Importante: En caso de que la ejecución de scripts haya dado como resultado errores o excepciones, detenga la aplicación y contáctese con el personal de soporte técnico.

Âncora
_Seguridad _Seguridad

Âncora
_Toc500318354 _Toc500318354

10. Iniciar/

...

Detener Director

Âncora
_Iniciar_Synthesis_Director _Iniciar_Synthesis_Director

Âncora
_Toc500318355 _Toc500318355

10.1 Iniciar

...

Director

Âncora
_Toc480883582 _Toc480883582

Âncora
_Toc480883602 _Toc480883602

Âncora
_Toc480884748 _Toc480884748

Âncora
_Toc480898032 _Toc480898032

Âncora
_Toc481482601 _Toc481482601

Âncora
_Toc482971961 _Toc482971961

Âncora
_Toc486934983 _Toc486934983

Âncora
_Toc486935097 _Toc486935097

Âncora
_Toc487123510 _Toc487123510

Âncora
_Toc487127440 _Toc487127440

Âncora
_Toc487704590 _Toc487704590

Âncora
_Toc488772777 _Toc488772777

Âncora
_Toc488772858 _Toc488772858

Âncora
_Toc488772889 _Toc488772889

Âncora
_Toc488772954 _Toc488772954

Âncora
_Toc488842552 _Toc488842552

Âncora
_Toc488842736 _Toc488842736

Âncora
_Toc490559398 _Toc490559398

Âncora
_Toc492914079 _Toc492914079

Âncora
_Toc500316783 _Toc500316783

Âncora
_Toc500318278 _Toc500318278

Âncora
_Toc500318356 _Toc500318356

...

Âncora
_Toc480883584 _Toc480883584

Âncora
_Toc480883604 _Toc480883604

Âncora
_Toc480884750 _Toc480884750

Âncora
_Toc480898034 _Toc480898034

Âncora
_Toc481482603 _Toc481482603

Âncora
_Toc482971963 _Toc482971963

Âncora
_Toc486934985 _Toc486934985

Âncora
_Toc486935099 _Toc486935099

Âncora
_Toc487123512 _Toc487123512

Âncora
_Toc487127442 _Toc487127442

Âncora
_Toc487704592 _Toc487704592

Âncora
_Toc488772779 _Toc488772779

Âncora
_Toc488772860 _Toc488772860

Âncora
_Toc488772891 _Toc488772891

Âncora
_Toc488772956 _Toc488772956

Âncora
_Toc488842554 _Toc488842554

Âncora
_Toc488842738 _Toc488842738

Âncora
_Toc490559400 _Toc490559400

Âncora
_Toc492914081 _Toc492914081

Âncora
_Toc500316785 _Toc500316785

Âncora
_Toc500318280 _Toc500318280

Âncora
_Toc500318358 _Toc500318358

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

Âncora
_Toc482971965 _Toc482971965

Âncora
_Toc486934987 _Toc486934987

Âncora
_Toc486935101 _Toc486935101

Âncora
_Toc487123514 _Toc487123514

Âncora
_Toc487127444 _Toc487127444

Âncora
_Toc487704594 _Toc487704594

Âncora
_Toc488772781 _Toc488772781

Âncora
_Toc488772862 _Toc488772862

Âncora
_Toc488772893 _Toc488772893

Âncora
_Toc488772958 _Toc488772958

Âncora
_Toc488842556 _Toc488842556

Âncora
_Toc488842740 _Toc488842740

Âncora
_Toc490559402 _Toc490559402

Âncora
_Toc492914083 _Toc492914083

Âncora
_Toc500316787 _Toc500316787

Âncora
_Toc500318282 _Toc500318282

Âncora
_Toc500318360 _Toc500318360

...

Âncora
_Toc482971967 _Toc482971967

Âncora
_Toc486934989 _Toc486934989

Âncora
_Toc486935103 _Toc486935103

Âncora
_Toc487123516 _Toc487123516

Âncora
_Toc487127446 _Toc487127446

Âncora
_Toc487704596 _Toc487704596

Âncora
_Toc488772783 _Toc488772783

Âncora
_Toc488772864 _Toc488772864

Âncora
_Toc488772895 _Toc488772895

Âncora
_Toc488772960 _Toc488772960

Âncora
_Toc488842558 _Toc488842558

Âncora
_Toc488842742 _Toc488842742

Âncora
_Toc490559404 _Toc490559404

Âncora
_Toc492914085 _Toc492914085

Âncora
_Toc500316789 _Toc500316789

Âncora
_Toc500318284 _Toc500318284

Âncora
_Toc500318362 _Toc500318362

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)

Âncora
_Acceso_Administrativo_a _Acceso_Administrativo_a

Âncora
_Toc500318363 _Toc500318363

11. Acceso Administrativo a

...

Director

Synthesis 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

...

11.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:

...

Luego, el sistema pedirá ingresar una nueva contraseña.

...

...

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

Âncora
_Configuración_de_variables _Configuración_de_variables

Âncora
_Toc477340376 _Toc477340376

...

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.

...

• 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

14.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\

...

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:

...

Âncora
_Toc500318371 _Toc500318371

16.1.1 Bonobo Git Server

16.1.1.1 Pre-requisitos

Los requisitos previos para instalar Bonobo Git Server son:

...

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 Directoriniciar 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

...