Image RemovedImage Added

Manual de Instalación

Synthesis Director

Cambio por Revisiones

...

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

Âncora
_Toc500318340 _Toc500318340

3. Referencias

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

...

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

Âncora
_Toc478737563 _Toc478737563

Âncora
_Toc500318341 _Toc500318341

4. Introducción

Âncora
_Toc103589952 _Toc103589952

Âncora
_Toc113187107 _Toc113187107

Âncora
_Toc119311942 _Toc119311942

Âncora
_Toc478737564 _Toc478737564

Âncora
_Toc500318342 _Toc500318342

4.1 Qué es Synthesis Director?

Synthesis Director es una solución de Synthesis Retail Solutions que permite gestionar, administrar, distribuir y monitorear de manera centralizada y eficiente nuevas versiones de productos Synthesis 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 Synthesis Director

El producto se encuentra constituido por los siguientes componentes:

...

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

Âncora
_Pre-requisitos_del_Sistema _Pre-requisitos_del_Sistema

Âncora
_Toc500318345 _Toc500318345

6. Pre-requisitos del Sistema

...

Âncora
_Toc500318349 _Toc500318349

6.1 Plataformas Soportadas

• Windows 64 bits
  • 8 o superior
  • Server 2012 y 2016
• Linux 64 bits
  • Cent OS 6.5 o superior

Âncora
_Toc500318350 _Toc500318350

6.2 Requerimientos de Hardware

• Memoria RAM: 4GB como mínimo disponible para la aplicación
• Disco Rígido: 100GB como mínimo disponible para la aplicación
• Procesador: i5 o superior

Âncora
_Toc500318351 _Toc500318351

6.3 Requerimientos de Software

• Git Server (Bonobo para Windows o GitLab para Linux)
• Navegador web (se recomienda el uso de Chrome)
• Motor de Base de Datos
  • Microsoft SQL Server 2012 / 2014
  • Oracle 10, 11 o 12
• Java Virtual Machine (JDK) jdk1.8.0_77 64bits
  Link de descarga: http://www.oracle.com/technetwork/java/javase/downloads/index.html

Âncora
_Instalación _Instalación

Âncora
_Toc500318352 _Toc500318352

7. Instalación

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

...

java –jar INSTALADOR.jar

Por ejemplo:

java –jar director-installer-1.0.0-SNAPSHOT.jar

...

Al ejecutar esta sentencia, se descomprime el archivo.

4. Se presentará la pantalla de bienvenida del instalador. Oprimir el botón "Siguiente".

...

7. A continuación, se deberá seleccionar el directorio de instalación e ingresar los puertos del servidor WEB. Oprimir el botón "Siguiente".

En caso de que el directorio no exista, se ofrecerá crearlo.

8. Indicar el motor de base de datos que se utilizará y presionar "Siguiente".

...

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

Una vez completados los datos, presionar el botón "Siguiente".

10. Presionar "Instalar" para ejecutar el proceso de instalación.

...

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
_Creación_de_la _Creación_de_la

Âncora
_Toc500318353 _Toc500318353

8. Creación de la Base de Datos

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.

Primero se deben ejecutar los script de VTOL CORE, ubicados en:

{DIRECTORIO_INSTALACION}/director/scripts/core/nombreMotorBD

, en el siguiente orden:

1. "1-CORE-SCHEMA.sql"
2. "2-CORE-POPULATE.sql"

...

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

{DIRECTORIO_INSTALACION}/director/scripts/director/nombreMotorBD

, en el siguiente orden:

1. "1-SD-SCHEMA.sql"
2. "2-SD-POPULATE.sql"

Donde:

• nombreMotorBD: corresponde al nombre del motor de base de datos
  • mssql – Motor de base de datos MS SQL Server
  • oracle – Motor de base de datos Oracle

...

Âncora
_Seguridad _Seguridad

Âncora
_Toc500318354 _Toc500318354

9. Iniciar/Detener Synthesis Director

Âncora
_Iniciar_Synthesis_Director _Iniciar_Synthesis_Director

Âncora
_Toc500318355 _Toc500318355

9.1 Iniciar Synthesis Director

...

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

9.2 Detener Synthesis Director

...

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

10. Acceso Administrativo a Synthesis Director

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

...

https://IP-SERVER:PORT/director 

Donde:

• 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 defecto 8090 y 8490 para el seguro)

...

Âncora
_Toc500318365 _Toc500318365

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

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

12. Puertos

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

...

Âncora
_Toc500318368 _Toc500318368

13. Logeo del sistema

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

...

Âncora
_Toc500318369 _Toc500318369

14. Anexo

Âncora
_Instalación_de_Git _Instalación_de_Git

Âncora
_Toc500318370 _Toc500318370

14.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 14.1.1 Bonobo Git Server)
• Si el sistema operativo es Linux, se instalará GitLab (apartado 14.1.2 GitLab)

Âncora
_Toc500318371 _Toc500318371

14.1.1 Bonobo Git Server

14.1.1.1 Pre-requisitos

Los requisitos previos para instalar Bonobo Git Server son:

...

Instalación de los Pre-requisitos

Windows 8 o superior

1. Ingresar a Panel de Control > Todos los elementos de Panel de control > Programas y características
2. Hacer clic en el enlace "Activar o desactivar las características de Windows" que se encuentra en el panel izquierdo
3. Hacer clic en la casilla de verificación denominada "Internet Information Services"
4. Oprimir el botón "Aceptar". Aguardar a que se apliquen los cambios y oprimir el botón "Cerrar"

...

1. Ingresar al Administrador de servidores. Seleccionar la opción del menú Administrar > Agregar roles y funciones
2. En la opción "Tipos de Instalación", que se encuentra en el panel izquierdo, seleccionar la opción "Instalación basada en roles o basada en funciones". Oprimir el botón "Siguiente"
3. En la opción "Selección de Servidor", seleccionar el servidor apropiado. Oprimir el botón "Siguiente"
4. En la opción "Roles del Servidor", hacer clic en la casilla de verificación denominada "Web Server (IIS)". Oprimir el botón "Siguiente"
5. En la opción "Características", hacer clic en el botón "Siguiente" porque no son necesarias funciones adicionales para IIS
6. En la opción "Rol Servicio Web", hacer clic en el botón "Siguiente"
7. En "Servicios del Rol" se debe personalizar la instalación IIS o aceptar la configuración predeterminada. Hacer clic en "Siguiente"
8. Finalmente, en la opción "Confirmación", hacer clic en "Instalar"
9. Aguardar a que se complete la instalación de IIS y oprimir el botón "Cerrar" para salir del asistente

.NET Framework

Windows 8 o superior y Windows Server 2012 o superior

...

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

Âncora
_Toc500318372 _Toc500318372

14.1.2 GitLab

14.1.2.1 Instalación de GitLab

...

1. Instalar y configurar las dependencias necesarias
   1. Los comandos de a continuación también abrirán el acceso HTTP y SSH en el firewall del sistema:

sudo yum install -y curl policycoreutils-python openssh-server
sudo systemctl enable sshd
sudo systemctl start sshd
sudo firewall-cmd --permanent --add-service=http
sudo systemctl reload firewalld

b. Instalar Postfix para enviar correos electrónicos de notificación. Si desea utilizar otra solución para enviar correos electrónicos, omitir este paso y configurar un servidor SMTP externo después de haber instalado GitLab:

sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix

Durante la instalación de Postfix, podría aparecer una pantalla de configuración. Seleccionar 'Sitio de Internet' y presionar enter. Usar el DNS externo del servidor para 'nombre de correo' y presionar enter. Si aparecen pantallas adicionales, presionar enter para aceptar los valores predeterminados

...

2. Agregar el repositorio de paquetes de GitLab e instalar el paquete

a. Agregar el repositorio de paquetes de GitLab:

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh | sudo bash

b. Luego, instalar el paquete GitLab. Cambiar `http://gitlab.example.com` a la URL a la que se desea acceder a la instancia de GitLab. La instalación se configurará automáticamente e iniciará GitLab en esa URL. HTTPS requiere configuración adicional después de la instalación:

sudo EXTERNAL_URL="http://gitlab.example.com" yum install -y gitlab-ee

3. En el primer ingreso, se redirigirá a una pantalla de restablecimiento de contraseña. Proporcionar la contraseña de la cuenta de administrador, posteriormente redirigirá a la pantalla de inicio de sesión. Usar el nombre de usuario de la cuenta predeterminada root para iniciar sesión

Consideraciones para entornos Linux

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