Manual de Usuario

Synthesis Director

Cambio por Revisiones

Índice

1. Acerca del manual

1.1 Propósito y alcance

El presente manual tiene por finalidad la capacitación de los usuarios que deseen utilizar la consola de administración del producto Synthesis Director.
Brinda la información necesaria, con el nivel suficiente de detalle para que el usuario pueda monitorear el estado del sistema, así como también obtener información sobre el procesamiento de operaciones y realizar las tareas de administración correspondientes.

El manual se encuentra dividido en los siguientes capítulos:

Capítulo 1- Acerca del manual
Provee una visión global del manual, brindado información sobre el contenido del mismo

Capítulo 2 – Introducción
Explica en qué consiste el producto Synthesis Director y los componentes que abarca

Capítulo 3 – Consola de administración
Brinda información para comenzar a interactuar con la consola de administración

Capítulo 4 – Versiones
Brinda información para la administración de productos y versiones de dichos productos

Capítulo 5 – Monitoreo
Explica el procedimiento para descargar e instalar una nueva versión de una solución Synthesis en las terminales de una o más tiendas y el procedimiento de cómo monitorear las terminales de las tiendas

Capítulo 6 – Administración
Informa los temas administrativos referentes a la aplicación

1.2 Referencias tipográficas

En este manual se utilizarán las siguientes convenciones:

2. Introducción

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

2.2 Componentes

Synthesis Director 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, Entre sus principales funciones se encuentran: informar el estado del producto, actualizar el producto a nuevas versiones vigentes e informar datos de una terminal.
  
  

3. Consola de administración

3.1 Flujo Operativo

En este apartado se explicará el flujo o secuencia normal de configuración y operatoria en la consola de Synthesis Director:

1. Creación de la compañía (Documento VTOL Core - Manual de usuario.pdf)
   Se debe crear la entidad con mayor jerarquía en la red del negocio del retailer. La compañía contendrá un conjunto de locales.
   
   
2. Creación del local (Documento VTOL Core - Manual de usuario.pdf)
   Un local pertenece a una compañía y posee un conjunto de terminales.
   
   
3. Creación de las terminales (Documento VTOL Core - Manual de usuario.pdf)
   Las terminales son las unidades lógicas que representan una caja. En las mismas se ejecutan los productos que se actualizarán mediante Synthesis Director.
   
   
4. Creación del producto (apartado 4.1.2 Alta de productos)
   Es preciso definir en el sistema el producto de software que se utiliza en las terminales y la ruta en GIT en donde se almacenarán las versiones. Un producto poseerá varias versiones.
   
   
5. Alta de versión para el producto creado previamente (apartado 4.2.2 Alta de versiones)
   Se define en el sistema la versión vigente del producto creado previamente.
   
   
6. Monitoreo y gestión de versiones por producto y por terminales (apartado 5.1 Monitoreo de Versiones) y monitoreo de terminales (apartado 5.2 Monitoreo de Terminales)
   En estas pantallas, se gestionan las versiones de los productos por terminales y se monitorean las características que poseen cada una de las terminales.
   
   

4. Versiones

4.1 Administración de Productos

Un producto es una solución de software instalada en las terminales de una empresa.
Synthesis Director permite definir y gestionar los productos de forma única para su posterior uso en el sistema.

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Administración de Productos" dentro de "Versiones" (Versiones > Administración de Productos).

Descripción de la página:
A través de esta página es posible efectuar el alta, consulta y edición de los productos que operará el retailer.

4.1.1 Búsqueda de productos

El sistema brinda la opción de buscar productos que se encuentran cargados, por medio de los siguientes filtros:

• Código del producto
• Nombre del producto
• Estado del producto: Habilitado/Deshabilitado

Una vez completado alguno de dichos campos, se debe presionar el ícono de "Buscar" para que la búsqueda se lleve adelante. Al hacer esto, en la tabla se mostrarán sólo aquellos productos que posean una coincidencia igual o parcial.

4.1.2 Alta de productos

Para crear un producto, presionar el botón "Nuevo" del formulario "Administración de Productos". Se desplegará la siguiente pantalla:

Se deberán ingresar los siguientes campos:

• Código: obligatorio y único
• Nombre: obligatorio
• Nombre repositorio GIT: obligatorio, se indica la ruta de GIT de dicho producto
• Descripción: detalle descriptivo opcional del producto
• Habilitado: estado del producto, por defecto estará tildado que significa habilitado

Presionar el botón "Guardar" para finalizar la creación del producto o "Cancelar" para regresar a la pantalla de administración de productos.
Una vez registrado el producto se generará en forma automática una versión base, la cual se utilizará como punto de partida para una futura versión que se desee instalar en una o más tiendas/terminales.

4.1.3 Modificación de productos

Para modificar un producto en particular previamente cargado, se debe presionar el botón "Acciones > Editar".
En el formulario de edición, se mostrarán los datos cargados y se podrán modificar las propiedades del producto.

Presionar "Guardar" para guardar los cambios o "Cancelar" para descartarlos y volver a la pantalla principal.

4.2 Administración de Versiones

Los productos evolucionan en forma de versiones para otorgar nuevas funcionalidades.
Con Synthesis Director, las versiones de los productos se alojan en un repositorio central para luego ser distribuidas en todas las terminales de un retail de manera remota.

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Administración de Versiones" dentro de "Versiones" (Versiones > Administración de Versiones).

Descripción de la página:
Gracias a este formulario es posible efectuar el alta, consulta y edición de las versiones de los productos registrados en el sistema.

4.2.1 Búsqueda de versiones

Las versiones cargadas en el sistema se pueden localizar mediante los siguientes filtros:

• Nombre del producto
• Código de la versión

Una vez completado alguno de dichos campos, se debe presionar el ícono de "Buscar" para que la búsqueda se lleve a cabo y se puedan visualizar los registros que posean una coincidencia igual o parcial.

4.2.2 Alta de versiones

Para crear una versión de un producto, presionar el botón "Nuevo" del formulario "Administración de Versiones". Se desplegará la siguiente pantalla:

Se deberán ingresar los siguientes campos:

• Código: obligatorio y único
• Descripción: detalle descriptivo opcional de la versión
• Producto
• Habilitado: estado de la versión, por defecto estará tildado que significa habilitado
• Backup: permite realizar un backup automático de la base de datos, por defecto estará tildado que significa la práctica de la copia de seguridad
• Versión: el archivo a adjuntar debe ser formato zip y contener la versión del producto con la siguiente estructura de directorios:

app
meta-data
scripts
batch
legal
    license
    terms
docs

Una vez cargado y validado el archivo, se desplegará un pop-up donde se tendrán que aceptar los términos y condiciones:

Presionar botón "Aceptar" para continuar con la gestión o "Cancelar" si no se desea aceptar la licencia.
Posteriormente, se informarán los cambios que se efectuaron en el repositorio tras la carga de una nueva versión.

Presionar el botón "Aceptar" para continuar.
Finalmente, presionar "Guardar" para registrar la versión en el sistema o "Cancelar" para volver a la pantalla de administración de versiones.

4.2.3 Modificación de versiones

Para modificar una versión previamente cargada, se debe presionar el botón "Acciones > Editar".
En el formulario de edición, se mostrarán los datos cargados y se podrán modificar los siguientes valores:

• Descripción
• Habilitado
• Backup

El código de la versión y el archivo de versión no es posible editarlos.

Presionar "Guardar" para guardar los cambios o "Cancelar" para descartarlos y volver a la pantalla de administración de versiones.

5. Monitoreo

5.1 Monitoreo de Versiones

Las versiones de los productos que están instaladas en los terminales se podrán controlar y actualizar de forma centralizada.
El proceso de actualización de versiones de productos consta de dos etapas:

• Sincronización: Descarga en la terminal la versión disponible de un producto
• Instalación: Con la descarga finalizada de archivos correspondientes a la versión y disponibles en la terminal, se efectúa la instalación automática

Cada uno de los pasos de la actualización en cada terminal es ejecutado e informado por el componente Synthesis Director Agent.
Ambas etapas de actualización se realizan bajo demanda desde la pantalla de "Monitoreo de Versiones" de Synthesis Director.

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Monitoreo de Versiones" dentro de "Monitoreo" (Monitoreo > Monitoreo de Versiones).

Descripción de la página:
En esta página, se logran ejecutar los procesos de sincronización e instalación de versiones.
En la cuadrilla se logra visualizar todas las terminales con sus productos instalados y conocer la versión que poseen, la versión que tienen descargada para actualizar el producto y la versión disponible en el repositorio.
Además, se informa el estado de la terminal (activo o desconectada) y el estado del producto que se ejecuta en la terminal (en funcionamiento o detenido).

5.1.1 Búsqueda

Los filtros ofrecidos para monitorear las versiones instaladas en las terminales son:

• Nombre de la compañía
• Nombre de la tienda
• Código de la terminal
• Nombre del producto
• Status: con las opciones
  • No disponible: El componente agente que gobierna al producto no está activo o no es alcanzable a través de la red
  • En proceso: Proceso de sincronización o de actualización en ejecución
  • Disponible y Actualizado: Estado ideal en una terminal para un producto
  • Acción pendiente: Cuando existen diferencias entre la versión instalada (Actual) y la descargada (Sincronizada) o cuando existen diferencias entre la última versión vigente (Disponible) y la versión descargada (Sincronizada)
  • Con Errores: Cuando hubo al menos un error en alguno de los pasos de las tareas de sincronización o de instalación

Presionar el ícono de "Buscar" para que la búsqueda se lleve adelante. Al hacer esto, en la tabla se mostrará como resultado las terminales por tienda y por producto.

5.1.2 Sincronización de versión

El proceso de sincronización permite que en una terminal determinada se descargue, remotamente desde un repositorio central, la última versión disponible del producto que tiene instalado para posteriormente efectuarse el proceso de actualización.
Para sincronizar una o más terminales se debe tildar el/los terminales con los productos deseados y presionar el botón "Sincronizar", ante lo cual el/los terminales en cuestión descargarán la nueva versión.

Dada esta acción, se efectuará la descarga de la versión disponible en la terminal.
Una vez finalizada la sincronización, se mostrará en la columna "Estado" la leyenda Disponible y en la columna "Sincronizada" el mismo código de versión que se informa en la columna "Disponible".

El paso siguiente es generar la instalación de la versión descargada en la terminal.

5.1.3 Instalación de versión

Una vez realizado exitosamente el proceso de sincronización, se procede a ejecutar también de forma remota la instalación de la versión en la terminal.
Para actualizar una o más terminales se deben tildar y presionar el botón "Instalar".

El componente Synthesis Director Agent del producto a instalar, ejecuta una serie de pasos y lo informa al componente Synthesis Director Server para que sea mostrado en la pantalla.
Finalizada la etapa de instalación, se informará en la columna "Estado" la leyenda Disponible, en la columna "Actual" el mismo código de versión que se informa en la columna "Disponible" y no se mostrará el componente casillero de selección puesto que no hay una nueva acción por tomar.

5.2 Monitoreo de Terminales

El componente Synthesis Director Agent informa continuamente al componente Synthesis Director Server información, atributos y propiedades de la terminal de la tienda con la finalidad de publicarlos en una pantalla para que el operador pueda visualizar y conocer datos de las mismas.

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Monitoreo de Terminales" dentro de "Monitoreo" (Monitoreo > Monitoreo de Terminales).

Descripción de la página:
Esta página permite brindarle al operador del sistema información detallada de las terminales ofreciéndole la posibilidad de controlar, conocer y tomar a futuro decisiones de sus atributos.
Se visualizan los siguientes datos de una terminal:

• Estado de la terminal
• IP
• % en uso del disco
• Total del disco
• % en uso de la memoria
• Total de la memora

5.2.1 Búsqueda

Los filtros ofrecidos para monitorear las terminales del retailer son:

• Nombre de la compañía
• Nombre de la tienda
• Código de la terminal
• Status: con las opciones
  • Con problemas
  • Sin problemas ni alertas
  • Con alertas

Presionar el ícono de "Buscar" para que la búsqueda se lleve adelante. Al hacer esto, en la tabla se mostrarán sólo aquellos terminales que posean una coincidencia igual o parcial.

5.2.2 Visualización de propiedades

Para ver el detalle de una acción auditada se debe presionar el botón "Acciones > Detalle" correspondiente a la terminal en cuestión. Se visualizará los estados de los productos e información del sistema.

6. Administración

6.1 Alertas del sistema

Synthesis Director posee alertas del sistema propias. Las mismas se podrán encontrar en Administración > Alertas y son las siguientes:

• Memoria baja del terminal
• Disco lleno del terminal
• Terminal caída
• Aplicación caída