Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Image RemovedImage Added

Manual de Instalación

Synthesis Director

...


DIRECTOR - Manual de instalación 1.0




Painel
borderColor#E4E3E3
bgColor#ffffff
titleColor#ffffff
borderWidth1px
titleBGColor#704581
titleREVISIONES


Expandir
titleExpandir 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.6Agregado de la sección "8. Actualización"

 

1.7Se especifica la configuración de SMTP





Painel
borderColor#E4E3E3
titleColor#ffffff
borderWidth1
titleBGColor#704581
titleCONTENIDO


Expandir
titleExpandir contenido
Índice




Âncora
_GoBack
_GoBack
 

Â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
_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
_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
    • 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



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

...

titleRequsitos 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
_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.

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.

...

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

...

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


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 de , para crear e inicializar la 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 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.


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

...

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

...

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

...

  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 Synthesis Director


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

...

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)

...


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

...

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.

...

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

Servidor

8383

Saliente

Comunicación con agente

Servidor

80-443

Saliente

Comunicación con el servidor Git

Servidor

1433

Saliente

Acceso BBDD MSSQL

Servidor

1521

Saliente

Acceso BBDD Oracle

Agente

8383

Entrante

Comunicación con Servidor

Agente

8080/8443

Saliente

Comunicación con Servidor

Agente

80-443

Saliente

Comunicación con el servidor Git

Si

Git

80/443

Entrante

Acceso consola web, Agente y Servidor



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:

...

Nota
Nota: La carpeta de logeo no es configurable.

...

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)

...

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

...

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

...

Windows 8 o superior y Windows Server 2012 o superior

  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

14.1.1.2 Instalación de Bonobo Git Server

Windows 8 o superior y Windows Server 2012 o superior

  1. Verificar que se encuentren instalados todos los pre-requisitos mencionados en el apartado 14.1.1.1 Pre-requisitos
  2. Descargar la última versión de Bonobo Git Server desde su sitio web oficial (https://bonobogitserver.com)
  3. Extraer los archivos del archivo de instalación en C:\inetpub\wwwroot
  4. Permitir que el usuario IIS modifique la carpeta App_Data (C:\inetpub\wwwroot\Bonobo.Git.Server\App_Data) Para ello:
    1. Seleccionar la opción "Propiedades" de la carpeta App_Data
    2. Ir a la pestaña "Seguridad"
    3. Hacer clic en "Editar"
    4. Seleccionar el usuario IIS (IIS_IUSRS) y agregarle permisos de modificación y escritura (control total)
    5. Oprimir el botón "Aplicar", "Aceptar" y "Aceptar"

Image Removed

5. Convertir Bonobo.Git.Server a la aplicación en IIS

Para ello:

    1. Ejecutar el "Administrador de Internet Information Services (IIS)" e ir a Sitios > Default Web Site > Bonobo.Git.Server
    2. Hacer clic derecho en "Bonobo Git Server" y convertirlo en aplicación
    3. Comprobar si el grupo de aplicaciones seleccionado se ejecuta en .NET 4.0

Image Removed

6. Configurar la autenticación

Para ello:

    1. Seleccionar la aplicación
    2. Hacer clic en el ícono de autenticación

Image Removed

c. Habilitar la autenticación anónima en IIS y desactivar los demás

Image Removed

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:

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

Image Removed

...

14.1.2.1 Instalación de GitLab

CentOS 7

  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

...


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

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

...

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

  • 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 el mismo se podrá configurar el nombre, tamaño y cantidad de registros que se guardarán.


Bloco de código
titlevtol-log4j.xml , configuración server.log
collapsetrue
<!-- 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
titlelogging.properties, configuración ejemplo manager.log
collapsetrue
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 Server

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"



Windows Server 2012 o superior

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



15.1.1.2 Instalación de Bonobo Git Server


Windows 8 o superior y Windows Server 2012 o superior

  1. Verificar que se encuentren instalados todos los pre-requisitos mencionados en el apartado 14.1.1.1 Pre-requisitos
  2. Descargar la última versión de Bonobo Git Server desde su sitio web oficial (https://bonobogitserver.com)
  3. Extraer los archivos del archivo de instalación en C:\inetpub\wwwroot
  4. Permitir que el usuario IIS modifique la carpeta App_Data (C:\inetpub\wwwroot\Bonobo.Git.Server\App_Data) Para ello:
    1. Seleccionar la opción "Propiedades" de la carpeta App_Data
    2. Ir a la pestaña "Seguridad"
    3. Hacer clic en "Editar"
    4. Seleccionar el usuario IIS (IIS_IUSRS) y agregarle permisos de modificación y escritura (control total)
    5. Oprimir el botón "Aplicar", "Aceptar" y "Aceptar"


Image Added


5. Convertir Bonobo.Git.Server a la aplicación en IIS

Para ello:

    1. Ejecutar el "Administrador de Internet Information Services (IIS)" e ir a Sitios > Default Web Site > Bonobo.Git.Server
    2. Hacer clic derecho en "Bonobo Git Server" y convertirlo en aplicación
    3. Comprobar si el grupo de aplicaciones seleccionado se ejecuta en .NET 4.0


Image Added


6. Configurar la autenticación

Para ello:

    1. Seleccionar la aplicación
    2. Hacer clic en el ícono de autenticación


Image Added


c. Habilitar la autenticación anónima en IIS y desactivar los demás


Image Added


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:

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


Image Added


Âncora
_Toc500318372
_Toc500318372
15.1.2 GitLab


15.1.2.1 Instalación de GitLab


CentOS 7

  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


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

Bloco de código
themeMidnight
titlemail.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