Manual de Instalación
Synthesis Director
Cambio por Revisiones
Fecha | Versión | Cambios – Motivo |
---|
27/03/2017 | 1.0 | Creación del documento |
25/04/2017 | 1.1 | Actualización del documento |
06/07/2017 | 1.2 | Agregación del apartado "Puertos" |
25/07/2017 | 1.3 | Agregación del apartado "Flujo de Implementación" |
15/08/2017 | 1.4 | Agregado de HTTPS |
05/12/2017 | 1.5 | Agregación del anexo "Instalación de Git" |
| 1.6 | Agregado de la sección "8. Actualización" |
| 1.7 | Se especifica la configuración de SMTP |
Índice
Â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:
- 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
Â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:
- 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 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:
- Verificar y cumplir con los pre-requisitos del sistema, tanto de software como de hardware (apartado 6. Pre-requisitos del Sistema)
- Efectuar la instalación completa mediante el asistente gráfico de instalación (apartado 7. Instalación)
- Crear la base de datos y ejecutar los script de base de datos (apartado 8. Creación de la Base de Datos)
- Iniciar Synthesis Director como proceso (apartado 9.1 Iniciar Synthesis Director)
- Acceder a la consola web de administración e iniciar sesión (apartado 10. Acceso Administrativo a Synthesis Director)
- 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 |
---|
| _Toc480883575 |
---|
| _Toc480883575 |
---|
|
Âncora |
---|
| _Toc480883595 |
---|
| _Toc480883595 |
---|
|
Âncora |
---|
| _Toc480884741 |
---|
| _Toc480884741 |
---|
|
Âncora |
---|
| _Toc480898025 |
---|
| _Toc480898025 |
---|
|
Âncora |
---|
| _Toc481482594 |
---|
| _Toc481482594 |
---|
|
Âncora |
---|
| _Toc482971953 |
---|
| _Toc482971953 |
---|
|
Âncora |
---|
| _Toc486934975 |
---|
| _Toc486934975 |
---|
|
Âncora |
---|
| _Toc486935089 |
---|
| _Toc486935089 |
---|
|
Âncora |
---|
| _Toc487123502 |
---|
| _Toc487123502 |
---|
|
Âncora |
---|
| _Toc487127432 |
---|
| _Toc487127432 |
---|
|
Âncora |
---|
| _Toc487704582 |
---|
| _Toc487704582 |
---|
|
Âncora |
---|
| _Toc488772767 |
---|
| _Toc488772767 |
---|
|
Âncora |
---|
| _Toc488772848 |
---|
| _Toc488772848 |
---|
|
Âncora |
---|
| _Toc488772879 |
---|
| _Toc488772879 |
---|
|
Âncora |
---|
| _Toc488772944 |
---|
| _Toc488772944 |
---|
|
Âncora |
---|
| _Toc488842542 |
---|
| _Toc488842542 |
---|
|
Âncora |
---|
| _Toc488842726 |
---|
| _Toc488842726 |
---|
|
Âncora |
---|
| _Toc490559388 |
---|
| _Toc490559388 |
---|
|
Âncora |
---|
| _Toc492914069 |
---|
| _Toc492914069 |
---|
|
Âncora |
---|
| _Toc500316773 |
---|
| _Toc500316773 |
---|
|
Âncora |
---|
| _Toc500318268 |
---|
| _Toc500318268 |
---|
|
Âncora |
---|
| _Toc500318346 |
---|
| _Toc500318346 |
---|
|
Âncora |
---|
| _Toc488772768 |
---|
| _Toc488772768 |
---|
|
Âncora |
---|
| _Toc488772849 |
---|
| _Toc488772849 |
---|
|
Âncora |
---|
| _Toc488772880 |
---|
| _Toc488772880 |
---|
|
Âncora |
---|
| _Toc488772945 |
---|
| _Toc488772945 |
---|
|
Âncora |
---|
| _Toc488842543 |
---|
| _Toc488842543 |
---|
|
Âncora |
---|
| _Toc488842727 |
---|
| _Toc488842727 |
---|
|
Âncora |
---|
| _Toc490559389 |
---|
| _Toc490559389 |
---|
|
Âncora |
---|
| _Toc492914070 |
---|
| _Toc492914070 |
---|
|
Âncora |
---|
| _Toc500316774 |
---|
| _Toc500316774 |
---|
|
Âncora |
---|
| _Toc500318269 |
---|
| _Toc500318269 |
---|
|
Âncora |
---|
| _Toc500318347 |
---|
| _Toc500318347 |
---|
|
Âncora |
---|
| _Toc488772769 |
---|
| _Toc488772769 |
---|
|
Âncora |
---|
| _Toc488772850 |
---|
| _Toc488772850 |
---|
|
Âncora |
---|
| _Toc488772881 |
---|
| _Toc488772881 |
---|
|
Âncora |
---|
| _Toc488772946 |
---|
| _Toc488772946 |
---|
|
Âncora |
---|
| _Toc488842544 |
---|
| _Toc488842544 |
---|
|
Âncora |
---|
| _Toc488842728 |
---|
| _Toc488842728 |
---|
|
Âncora |
---|
| _Toc490559390 |
---|
| _Toc490559390 |
---|
|
Âncora |
---|
| _Toc492914071 |
---|
| _Toc492914071 |
---|
|
Âncora |
---|
| _Toc500316775 |
---|
| _Toc500316775 |
---|
|
Âncora |
---|
| _Toc500318270 |
---|
| _Toc500318270 |
---|
|
Âncora |
---|
| _Toc500318348 |
---|
| _Toc500318348 |
---|
|
Âncora |
---|
| _Toc500318349 |
---|
| _Toc500318349 |
---|
|
6.1 Plataformas Soportadas
- Windows 64 bits
- 8 o superior
- Server 2012 y 2016
- Linux 64 bits
Â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
Nota |
---|
Nota: En el anexo 14.1 Instalación de Git se encuentran los procedimientos de instalación de los productos Bonobo y GitLab. |
Nota |
---|
title | Requsitos de Base De Datos |
---|
|
El dimensionamiento minimo para un ejercicio de 10 tiendas con 15 terminales con 4 productos cada una es de 1.5GB. La definición de los usuarios y permisos son de lectura, escritura, actualización y eliminación (a nivel datos) y de ejecución de Stored Procedures. |
Â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.
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. |
Para instalar Synthesis Director Server se deben seguir los siguientes pasos:
- Verificar la existencia de la base de datos que usará la aplicación Synthesis Director.
- Iniciar sesión en el sistema operativo donde se instalará la aplicación con un usuario con permisos de administrador.
- Iniciar el instalador de la aplicación Synthesis Director ejecutando la siguiente sentencia en la línea de comandos:
Bloco de código |
---|
java –jar INSTALADOR.jar |
Por ejemplo:
Bloco de código |
---|
java –jar director-installer-1.0.0-SNAPSHOT.jar |
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". |
Al ejecutar esta sentencia, se descomprime el archivo.
4. Se presentará la pantalla de bienvenida del instalador. Oprimir el botón "Siguiente".
5. Al pasar a la siguiente pantalla se mostrarán los términos de servicio y condiciones de uso de la aplicación para ser leídos. Oprimir el botón "Aceptar".
6. Se deberán aceptar los términos y condiciones y completar con el nombre completo y el correo electrónico para poder continuar con la instalación. 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".
9. Ingresar los datos vinculados a la base de datos a emplearse:
- La versión del motor de base de datos seleccionado
- El host de la base de datos
- El nombre de la base de datos que fue creada previamente para Synthesis Director
- El puerto de la base de datos
- 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.
Se mostrarán los elementos instalados.
Se podrá observar información detallada de la instalación presionando el botón "Enseñar detalles". Al hacer esto se mostrarán dos solapas:
- En la solapa "Salida" podrá observar el progreso de la instalación visualizando las tareas ejecutadas por el instalador
- En la solapa "Errores" se presentan las fallas que tuvieron lugar durante la instalación
11. La finalización de la instalación se informa mediante un mensaje de "Terminado". Oprimir "Aceptar".
12. Presionar el botón "Salir" para salir del instalador.
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:
Archivo | Descripción |
bin | Carpeta que contiene los archivos de inicio y de detención de la aplicación como proceso de Windows y de Linux |
docs | Carpeta que contiene documentación de Synthesis Director |
scripts | Carpeta que contiene los scripts de base de datos que permiten su creación y populación |
tomcat | Carpeta del servidor de aplicaciones tomcat |
licenseAccepted.sts | Archivo de texto que menciona el usuario y la fecha que aceptó los términos y condiciones de uso |
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 establecer una comunicación bidireccional entre Agent y Server. |
Âncora |
---|
| _Actualización |
---|
| _Actualización |
---|
|
Âncora |
---|
| _Toc500318352 |
---|
| _Toc500318352 |
---|
|
8. Actualización
Detener el servicio de Director Server.
Realizar los pasos al igual que el punto 7 de instalación, pero en este caso se debe seleccionar la carpeta del server que se quiere actualizar, al existir no mostrará el punto 7.1 del mismo.
Iniciar nuevamente el servicio de Director Server.
Âncora |
---|
| _Creación_de_la |
---|
| _Creación_de_la |
---|
|
Âncora |
---|
| _Toc500318353 |
---|
| _Toc500318353 |
---|
|
9. 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.
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.
Primero se deben ejecutar los script de VTOL CORE, ubicados en:
{DIRECTORIO_INSTALACION}/director/scripts/core/nombreMotorBD
, en el siguiente orden:
- "1-CORE-SCHEMA.sql"
- "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-SD-SCHEMA.sql"
- "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
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 |
---|
| _Toc500318354 |
---|
| _Toc500318354 |
---|
|
10. Iniciar/Detener Synthesis Director
Âncora |
---|
| _Iniciar_Synthesis_Director |
---|
| _Iniciar_Synthesis_Director |
---|
|
Âncora |
---|
| _Toc500318355 |
---|
| _Toc500318355 |
---|
|
10.1 Iniciar Synthesis 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 |
---|
| _Toc480883583 |
---|
| _Toc480883583 |
---|
|
Âncora |
---|
| _Toc480883603 |
---|
| _Toc480883603 |
---|
|
Âncora |
---|
| _Toc480884749 |
---|
| _Toc480884749 |
---|
|
Âncora |
---|
| _Toc480898033 |
---|
| _Toc480898033 |
---|
|
Âncora |
---|
| _Toc481482602 |
---|
| _Toc481482602 |
---|
|
Âncora |
---|
| _Toc482971962 |
---|
| _Toc482971962 |
---|
|
Âncora |
---|
| _Toc486934984 |
---|
| _Toc486934984 |
---|
|
Âncora |
---|
| _Toc486935098 |
---|
| _Toc486935098 |
---|
|
Âncora |
---|
| _Toc487123511 |
---|
| _Toc487123511 |
---|
|
Âncora |
---|
| _Toc487127441 |
---|
| _Toc487127441 |
---|
|
Âncora |
---|
| _Toc487704591 |
---|
| _Toc487704591 |
---|
|
Âncora |
---|
| _Toc488772778 |
---|
| _Toc488772778 |
---|
|
Âncora |
---|
| _Toc488772859 |
---|
| _Toc488772859 |
---|
|
Âncora |
---|
| _Toc488772890 |
---|
| _Toc488772890 |
---|
|
Âncora |
---|
| _Toc488772955 |
---|
| _Toc488772955 |
---|
|
Âncora |
---|
| _Toc488842553 |
---|
| _Toc488842553 |
---|
|
Âncora |
---|
| _Toc488842737 |
---|
| _Toc488842737 |
---|
|
Âncora |
---|
| _Toc490559399 |
---|
| _Toc490559399 |
---|
|
Âncora |
---|
| _Toc492914080 |
---|
| _Toc492914080 |
---|
|
Âncora |
---|
| _Toc500316784 |
---|
| _Toc500316784 |
---|
|
Âncora |
---|
| _Toc500318279 |
---|
| _Toc500318279 |
---|
|
Âncora |
---|
| _Toc500318357 |
---|
| _Toc500318357 |
---|
|
Â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:
- Iniciar sesión en el sistema operativo
- Ingresar a la carpeta {DIRECTORIO_INSTALACION}/director/bin
- Ejecutar uno de los archivos según el sistema operativo:
- start-director.cmd (Windows)
- start-director.sh (Linux)
Âncora |
---|
| _Toc500318359 |
---|
| _Toc500318359 |
---|
|
10.2 Detener Synthesis 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 |
---|
| _Toc482971966 |
---|
| _Toc482971966 |
---|
|
Âncora |
---|
| _Toc486934988 |
---|
| _Toc486934988 |
---|
|
Âncora |
---|
| _Toc486935102 |
---|
| _Toc486935102 |
---|
|
Âncora |
---|
| _Toc487123515 |
---|
| _Toc487123515 |
---|
|
Âncora |
---|
| _Toc487127445 |
---|
| _Toc487127445 |
---|
|
Âncora |
---|
| _Toc487704595 |
---|
| _Toc487704595 |
---|
|
Âncora |
---|
| _Toc488772782 |
---|
| _Toc488772782 |
---|
|
Âncora |
---|
| _Toc488772863 |
---|
| _Toc488772863 |
---|
|
Âncora |
---|
| _Toc488772894 |
---|
| _Toc488772894 |
---|
|
Âncora |
---|
| _Toc488772959 |
---|
| _Toc488772959 |
---|
|
Âncora |
---|
| _Toc488842557 |
---|
| _Toc488842557 |
---|
|
Âncora |
---|
| _Toc488842741 |
---|
| _Toc488842741 |
---|
|
Âncora |
---|
| _Toc490559403 |
---|
| _Toc490559403 |
---|
|
Âncora |
---|
| _Toc492914084 |
---|
| _Toc492914084 |
---|
|
Âncora |
---|
| _Toc500316788 |
---|
| _Toc500316788 |
---|
|
Âncora |
---|
| _Toc500318283 |
---|
| _Toc500318283 |
---|
|
Âncora |
---|
| _Toc500318361 |
---|
| _Toc500318361 |
---|
|
Â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:
- Iniciar sesión en el sistema operativo
- Ingresar a la carpeta {DIRECTORIO_INSTALACION}/director/bin
- 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 Synthesis Director
Synthesis Director provee una consola web por la cual se pueden realizar distintas funciones, como ser:
- Administración de productos
- Administración de versiones
- Monitoreo de versiones
- Monitoreo de terminales
- Alertas de estado en terminales
Nota |
---|
Nota: Las funcionalidades de administración de seguridad, configuración de reglas de negocio, auditoría, eventos, alertas y configuración del sistema son propias de VTOL Core. Para conocer del mismo, por favor dirigirse al documento "VTOL CORE – Manual de usuario.pdf". |
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 se debe utilizar el siguiente enlace:
Bloco de código |
---|
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)
Finalizada la inicialización del sistema y accediendo a la URL mencionada, se visualizará la pantalla de login:
Pantalla de Login
Âncora |
---|
| _Toc480884752 |
---|
| _Toc480884752 |
---|
|
Âncora |
---|
| _Toc480898036 |
---|
| _Toc480898036 |
---|
|
Âncora |
---|
| _Toc481482605 |
---|
| _Toc481482605 |
---|
|
Âncora |
---|
| _Toc482971969 |
---|
| _Toc482971969 |
---|
|
Âncora |
---|
| _Toc486934991 |
---|
| _Toc486934991 |
---|
|
Âncora |
---|
| _Toc486935105 |
---|
| _Toc486935105 |
---|
|
Âncora |
---|
| _Toc487123518 |
---|
| _Toc487123518 |
---|
|
Âncora |
---|
| _Toc487127448 |
---|
| _Toc487127448 |
---|
|
Âncora |
---|
| _Toc487704598 |
---|
| _Toc487704598 |
---|
|
Âncora |
---|
| _Toc488772785 |
---|
| _Toc488772785 |
---|
|
Âncora |
---|
| _Toc488772866 |
---|
| _Toc488772866 |
---|
|
Âncora |
---|
| _Toc488772897 |
---|
| _Toc488772897 |
---|
|
Âncora |
---|
| _Toc488772962 |
---|
| _Toc488772962 |
---|
|
Âncora |
---|
| _Toc488842560 |
---|
| _Toc488842560 |
---|
|
Âncora |
---|
| _Toc488842744 |
---|
| _Toc488842744 |
---|
|
Âncora |
---|
| _Toc490559406 |
---|
| _Toc490559406 |
---|
|
Âncora |
---|
| _Toc492914087 |
---|
| _Toc492914087 |
---|
|
Âncora |
---|
| _Toc477340335 |
---|
| _Toc477340335 |
---|
|
Âncora |
---|
| _Toc500316791 |
---|
| _Toc500316791 |
---|
|
Âncora |
---|
| _Toc500318286 |
---|
| _Toc500318286 |
---|
|
Âncora |
---|
| _Toc500318364 |
---|
| _Toc500318364 |
---|
|
Â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:
- Nombre de usuario: suser
- Clave de acceso: suser123
Luego, el sistema pedirá ingresar una nueva contraseña.
Pantalla de Cambio de 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 |
---|
|
Âncora |
---|
| _Configuración_Inicial_del |
---|
| _Configuración_Inicial_del |
---|
|
Âncora |
---|
| _Toc500318366 |
---|
| _Toc500318366 |
---|
|
12. 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.
A continuación, se detalla las variables del sistema que deberán chequearse y configurarse.
Nota |
---|
Nota: Se aconseja fuertemente configurar por primera y única vez las propiedades sombreadas en color amarillo. El resto de las propiedades requieren su revisión, pero tienen un valor por defecto acorde al funcionamiento normal del sistema. |
Propiedad | Tipo | Descripción |
Ruta del log del sistema | Alfanumérico | Ruta de donde se puede descargar el log del sistema. Configurar la carpeta "DIRECTORIO_INSTALACION/tomcat/logs/", donde "DIRECTORIO_INSTALACION" es el directorio de instalación de la aplicación. |
Umbral que detiene las notificaciones (minutos) | Entero | Umbral en minutos para detener el envío de notificaciones |
Límite para considerar terminal fuera de linea (minutos) | Entero | Límite en minutos para considerar una terminal fuera de línea |
Umbral crítico para HDD | Entero | Umbral porcentual crítico para el disco rígido |
Umbral de alarma para HDD | Entero | Umbral porcentual de alarma para el disco rígido |
Umbral crítico para RAM | Entero | Umbral porcentual crítico para la memoria RAM |
Umbral de alarma para RAM | Entero | Umbral porcentual de alarma para la memoria RAM |
Password remoto para GIT | Alfanumérico | Contraseña del usuario de Git |
Usuario remoto para GIT | Alfanumérico | Nombre de usuario de Git |
URL remoto para GIT | Alfanumérico | Ruta de Git |
Ruta base para archivos temporales | Alfanumérico | El sistema utiliza un este directorio para trabajar con archivos temporales. Por defecto lo hace en la ruta "/synthesis/director/tmp/". La misma debe ser creada con permisos de lectura y escritura para el usuario que inicia la aplicación. |
Formato de fecha y hora para comunicarse con el agente | Alfanumérico | Formato de fecha y hora para comunicarse con el componente agente |
Nota |
---|
Nota: Para conocer cómo modificar las propiedades, por favor dirigirse al documento "VTOL Core - Manual de usuario.pdf". |
Âncora |
---|
| _Toc500318367 |
---|
| _Toc500318367 |
---|
|
13. Puertos
Se detallan a continuación los puertos con los que opera el sistema.
Componente | Puerto | Tipo | Nota | Configurable |
Servidor | 8090-8490 | Entrante | Accesos consola web | Sí |
Servidor | 8383 | Saliente | Comunicación con agente | Sí |
Servidor | 80-443 | Saliente | Comunicación con el servidor Git | Sí |
Servidor | 1433 | Saliente | Acceso BBDD MSSQL | Sí |
Servidor | 1521 | Saliente | Acceso BBDD Oracle | Sí |
Agente | 8383 | Entrante | Comunicación con Servidor | Sí |
Agente | 8080/8443 | Saliente | Comunicación con Servidor | Sí |
Agente | 80-443 | Saliente | Comunicación con el servidor Git | Si |
Git | 80/443 | Entrante | Acceso consola web, Agente y Servidor | Sí |
Nota |
---|
Nota: los puertos aquí señalados son valores por defecto y dependerán de la configuración finalmente elegida. |
Âncora |
---|
| _Toc500318368 |
---|
| _Toc500318368 |
---|
|
14. Logeo del sistema
El sistema generará trazas de log en la siguiente carpeta:
Bloco de código |
---|
{DIRECTORIO_INSTALACION}/tomcat/logs/ |
Nota |
---|
Nota: La carpeta de logeo no es configurable. |
El sistema por defecto genera varias trazas de log.
- 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
Configuración
En el mismo se podrá configurar el nombre, tamaño y cantidad de registros que se guardarán.
Bloco de código |
---|
title | vtol-log4j.xml , configuración server.log |
---|
collapse | true |
---|
|
<!-- File appender -->
<appender name="File" class="vtol.core.log.CustomRollingFileAppender">
<param name="File" value="${catalina.home}/logs/server.log" />
<param name="append" value="true" />
<param name="MaxFileSize" value="100MB" />
<param name="MaxBackupIndex" value="20" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d [%t] %-5p %c{2} %x - %m%n" />
</layout>
</appender> |
- Para configurar los archivos de logueo de Tomcat se debe modificar el file logging.properties, el cual encontraremos en: {
DIRECTORIO_INSTALACION
}\tomcat\conf
En el mismo se podrá configurar el nombre, tamaño y cantidad de registros que se guardarán por cada uno de los archivos de logueo.
Ejemplo de configuración de manager.log
Bloco de código |
---|
title | logging.properties, configuración ejemplo manager.log |
---|
collapse | true |
---|
|
3manager.org.apache.juli.FileHandler.level = FINE
3manager.org.apache.juli.FileHandler.directory = ${catalina.base}/logs
3manager.org.apache.juli.FileHandler.prefix = manager.
3manager.org.apache.juli.FileHandler.bufferSize = 16384
3manager.org.apache.juli.FileHandler.maxDays = 90
3manager.org.apache.juli.FileHandler.encoding = UTF-8 |
- El stacktrace.log genera un máximo de 10 archivos con un tamaño de 50MB cada uno. Al ser un archivo de logueo de excepciones de la aplicación no tiene opción de cambio de configuración.
Documentación Tomcat: https://tomcat.apache.org/tomcat-8.5-doc/logging.html#Documentation_references
Aviso |
---|
cuando se hace una re-instalación completa del sistema, la configuración de logeo se pierde, por lo tanto se recomienda realizar un backup previo a la instalación. |
Âncora |
---|
| _Toc500318369 |
---|
| _Toc500318369 |
---|
|
15. Anexo
Âncora |
---|
| _Instalación_de_Git |
---|
| _Instalación_de_Git |
---|
|
Âncora |
---|
| _Toc500318370 |
---|
| _Toc500318370 |
---|
|
15.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:
Âncora |
---|
| _Toc500318371 |
---|
| _Toc500318371 |
---|
|
15.1.1 Bonobo Git Server
15.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
- Windows 10 con ASP.NET habilitado
Instalación de los Pre-requisitos
Âncora |
---|
| _Hlk494462581 |
---|
| _Hlk494462581 |
---|
|
Internet Information ServerWindows 8 o superior
- Ingresar a Panel de Control > Todos los elementos de Panel de control > Programas y características
- Hacer clic en el enlace "Activar o desactivar las características de Windows" que se encuentra en el panel izquierdo
- Hacer clic en la casilla de verificación denominada "Internet Information Services"
- Oprimir el botón "Aceptar". Aguardar a que se apliquen los cambios y oprimir el botón "Cerrar"
Windows Server 2012 o superior
- Ingresar al Administrador de servidores. Seleccionar la opción del menú Administrar > Agregar roles y funciones
- 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"
- En la opción "Selección de Servidor", seleccionar el servidor apropiado. Oprimir el botón "Siguiente"
- En la opción "Roles del Servidor", hacer clic en la casilla de verificación denominada "Web Server (IIS)". Oprimir el botón "Siguiente"
- En la opción "Características", hacer clic en el botón "Siguiente" porque no son necesarias funciones adicionales para IIS
- En la opción "Rol Servicio Web", hacer clic en el botón "Siguiente"
- En "Servicios del Rol" se debe personalizar la instalación IIS o aceptar la configuración predeterminada. Hacer clic en "Siguiente"
- Finalmente, en la opción "Confirmación", hacer clic en "Instalar"
- 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
- 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"
- Seleccionar el idioma y presionar el botón "Descargar"
- Un archivo ejecutable se descargará localmente, abrirlo y seguir las instrucciones del asistente gráfico de instalación
- Aguardar a que se instalen los componentes y cerrar el instalador
15.1.1.2 Instalación de Bonobo Git Server
Windows 8 o superior y Windows Server 2012 o superior
- Verificar que se encuentren instalados todos los pre-requisitos mencionados en el apartado 14.1.1.1 Pre-requisitos
- Descargar la última versión de Bonobo Git Server desde su sitio web oficial (https://bonobogitserver.com)
- Extraer los archivos del archivo de instalación en C:\inetpub\wwwroot
- Permitir que el usuario IIS modifique la carpeta App_Data (C:\inetpub\wwwroot\Bonobo.Git.Server\App_Data) Para ello:
- Seleccionar la opción "Propiedades" de la carpeta App_Data
- Ir a la pestaña "Seguridad"
- Hacer clic en "Editar"
- Seleccionar el usuario IIS (IIS_IUSRS) y agregarle permisos de modificación y escritura (control total)
- Oprimir el botón "Aplicar", "Aceptar" y "Aceptar"
5. Convertir Bonobo.Git.Server a la aplicación en IIS
Para ello:
- Ejecutar el "Administrador de Internet Information Services (IIS)" e ir a Sitios > Default Web Site > Bonobo.Git.Server
- Hacer clic derecho en "Bonobo Git Server" y convertirlo en aplicación
- Comprobar si el grupo de aplicaciones seleccionado se ejecuta en .NET 4.0
6. Configurar la autenticación
Para ello:
- Seleccionar la aplicación
- Hacer clic en el ícono de autenticación
c. Habilitar la autenticación anónima en IIS y desactivar los demás
7. Abrir un navegador de Internet e ingresar el link:
Bloco de código |
---|
http://localhost/Bonobo.Git.Server |
8. Se visualizará la página inicial del Servidor Bonobo Git funcionando
9. Ingresar las credenciales predeterminadas:
- Nombre de usuario: admin
- Contraseña: admin
Âncora |
---|
| _Toc500318372 |
---|
| _Toc500318372 |
---|
|
15.1.2 GitLab
15.1.2.1 Instalación de GitLab
CentOS 7
- Instalar y configurar las dependencias necesarias
- 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
- Se debe cargar un SCHEME cuando se selecciona el motor de base de datos Oracle
- La instalación se debe realizar sobre un directorio el cual el usuario que instalará posea permisos de lectura y escritura
- Para iniciar Synthesis Director, el usuario debe tener permisos de:
- lectura sobre el directorio de instalación
- ejecución sobre los archivos con extensión SH
- escritura sobre el directorio tomcat
- Al crear un repositorio, se debe crear un archivo inicial para inicializar el repositorio
16. 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:
Directorio |
---|
<directorio_instalación>\tomcat\conf |
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:
- 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:
Bloco de código |
---|
theme | Midnight |
---|
title | mail.groovy |
---|
|
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 |