...
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" |
Índice ...
| Nota |
|---|
| Nota: En el anexo 14.1 Instalación de Git se encuentran los procedimientos de instalación de los productos Bonobo y GitLab. |
...
...
| 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.
...
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. |
...
...
...
...
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:
...
| 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 |
|---|
|
...
- 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 |
|---|
|
...
- 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:
...
| Â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 | 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/ |
...
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
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 |
|---|
| 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:
- 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 |
|---|
|
...
15.1.1 Bonobo Git Server
1415.1.1.1 Pre-requisitos
Los requisitos previos para instalar Bonobo Git Server son:
...
- 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
1415.1.1.2 Instalación de Bonobo Git Server
...
- Nombre de usuario: admin
- Contraseña: admin
| Âncora |
|---|
| _Toc500318372 |
|---|
| _Toc500318372 |
|---|
|
...
15.1.2 GitLab
1415.1.2.1 Instalación de GitLab
...