...
DIRECTOR - Manual de usuario 1.1.X
| Painel | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
|
...
|
...
| Índice |
|---|
|
| Painel | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
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.
...
Capítulo 2 – Introducción
Explica en qué consiste el producto Synthesis Director y los componentes que abarca Napse
Capítulo 3 – Consola de administración
Brinda información para comenzar a interactuar con la consola de administración
...
Capítulo 5 – Monitoreo
Explica el procedimiento para descargar e instalar una nueva versión de una solución Synthesis en Napse en las terminales de una o más tiendas y el procedimiento de cómo monitorear las terminales de las tiendas
...
Numeración (1., 2., 3...) | Indica la secuencia de pasos a seguir dentro de un procedimiento |
Viñetas (•) | Indican opciones y características |
Signo mayor (>) | Se utiliza para especificar los niveles de menú (Ej.: Archivo > Abrir) |
Estilo de fuente "negrita" | Indica los nombres de elementos interface (Ej.: botón Aceptar) y de cualquier otro ítem que requiera énfasis |
Estilo de fuente "cursiva" | Se utilizará para mencionar a los ejemplos |
Recuadro "Consejo práctico:" | Se utilizará para resaltar tips o accesos rápidos para la operatoria o procedimiento que se encuentre realizando |
Recuadro "Nota:" | Se utilizará para resaltar aclaraciones sobre el tema en curso |
Recuadro "Importante:" | Se utilizará para indicar al usuario sobre precauciones / cuestiones relevantes que deberá tener en cuenta el usuario |
2. Introducción
2.1
...
¿Qué es
...
Director?
Synthesis Director es una solución de Synthesis Retail Solutions Napse que permite gestionar, administrar, distribuir y monitorear de manera centralizada y eficiente nuevas versiones de productos Synthesis Napse 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 Napse 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 AgentAgente
Se encuentra integrado en cada producto de una terminal, Entre sus principales funciones se encuentran: informar periódicamente el estado del producto, actualizar el producto a nuevas versiones vigentes e informar datos de una terminal.
...
| Nota |
|---|
| Nota: Para conectarse y acceder a la consola de administración de Synthesis Director, por favor dirigirse al documento "Synthesis Director - Manual de instalación.pdf" de la versión correspondiente. Dicho manual explica detalladamente el proceso de acceso a la consola de administración. Para conocer la funcionalidad de la consola de administración, se aconseja previamente leer el documento Manual de usuario 4.0.0.X. En el mismo se realiza una introducción y explicación de la funcionalidad básica de la interfaz de usuario. |
...
En este apartado se explicará el flujo o secuencia normal de configuración y operatoria en la consola de Synthesis Director:
- Creación de la compañía (Documento VTOL Core CORE - Manual de usuario .pdf4.0.0.X)
Se debe crear la entidad con mayor jerarquía en la red del negocio del retailer. La compañía contendrá un conjunto de locales. - Creación del local (Documento VTOL Core CORE - Manual de usuario 4.0.0.pdfX)
Un local pertenece a una compañía y posee un conjunto de terminales. - 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. - 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. - 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. - 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.
...
| Aviso |
|---|
Importante: En caso de que un agente (Synthesis Director Agent) se comunique con el componente servidor (Synthesis Director Server) y éste detecte que el código de terminal y el código de tienda informado por el agente no existan en el sistema, el servidor procederá a registrar en el sistema la tienda y la terminal informada. Es requisito fundamental que exista previamente en el sistema el código de producto y el código de compañía informado por el agente. |
...
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.
...
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
| Âncora | ||||
|---|---|---|---|---|
|
Crear en Bonobo.Git.Server (previamente configurado) un repositorio para el nuevo producto.
...
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.
...
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
...
- Nombre del producto
- Código de la versión
- Rol
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
| Âncora | ||
|---|---|---|
|
...
|
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
- Version Versión anterior: Versión (Código) de la cual hereda la nueva versión
- Rol: Será el rol del usuario que podrá descargar en las terminales dicha versión del producto.
- Backup base de datos: 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:
...
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:
- Código (siempre y cuando ninguna terminal se haya descargado la versión a editar, si no, no se puede editar este campo)
- Descripción
- Rol
- Habilitado
- Backup base de datos
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
| Âncora | ||||
|---|---|---|---|---|
|
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:
...
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).
...
Los filtros ofrecidos para monitorear las versiones instaladas en las terminales son los siguientes:
- produtoproducto
- cantidad de aplicaciones página
...
- Nombre de la compañía
- Nombre de la tienda
- Código de la terminal
- Nombre del productoVersión
- División operativa
- Categoría de terminal
- Status agente: con las opciones
- Indistinto: Muestra la totalidad de las terminales
- 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 (Descargada).
- Con Errores: Cuando hubo al menos un error en alguno de los pasos de las tareas de sincronización o de instalación
...
- Agente encendido
- Agente apagado
- Estado de aplicación: con las opciones
- Aplicación encendida
- Aplicación apagada
- Tarea pendiente: con las opciones
- Con tarea pendiente
- Sin tarea pendiente
- Estado tarea: con las opciones
- Sin ejecutar tarea
- Ejecutando tarea
- Versión instalada (igual o distinta, utilizando % como comodín)
- Versión descargada (igual o distinta, utilizando % como comodí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.
...
Para descargar una versión a una o más terminales, se debe tildar la/las mismas y luego presionar el botón de “Descargar”, donde se mostrará un diálogo con un resumen de la cantidad de terminales seleccionadas, un agrupamiento por cantidades de versiones actuales instaladas y una lista de versiones disponibles para descargar a las terminales seleccionadas con el objetivo de que el usuario pueda confirmar la acción deseada.
Adicionalmente se le pedirá que indique las opciones de planificación
- indicando fecha y hora
- o bien que la descarga se haga ni bien la terminal se reporte al servidor
...
de terminales seleccionadas, un agrupamiento por cantidades de versiones actuales instaladas y una lista de versiones disponibles para descargar a las terminales seleccionadas con el objetivo de que el usuario pueda confirmar la acción deseada.
Adicionalmente se le pedirá que indique las opciones de planificación
- indicando fecha y hora
- o bien que la descarga se haga ni bien la terminal se reporte al servidor
| Nota |
|---|
Es importante destacar:
|
Por último se le pedirá al usuario que ingrese un comentario (obligatorio) asociado a la acción de descarga y que generará un registro de auditoria en el sistema
...
5.1.3 Instalación de versión
Una vez realizado exitósamente exitosamente el proceso de descarga, se procede a ejecutar también de forma remota la instalación de la versión en la terminal.
...
A diferencia de la descarga, el proceso de Instalación se ejecutará tan pronto el agente (componente cliente de la solución Director) se reporte al servidor. El agente ejecutará una serie de pasos y los informará a 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" la versión instalada.
5.2 Monitoreo de Terminales
| Âncora | ||||
|---|---|---|---|---|
|
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.
...
- Estado de la terminal
- IP
- % en uso del disco
- Total del disco
- % en uso de la memoria
- Total de la memoramemoria
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
- IP
- Status: con las opciones
- Con problemas
- Sin problemas ni alertas
- Con alertas
- Ultimo status
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.
...
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
- Las alertas se podrán configurar por rango de tiempo, horario desde/hasta y días de la semana
| Nota |
|---|
| Nota: Para obtener más información de cómo configurar las alertas, dirigirse al documento "VTOL Core CORE - Manual de usuario 4.pdf0". |
7. Actualización masiva de agentes
7.1 Descripción
A través de Director se pueden descargar y actualizar versiones de aplicaciones. Este proceso se lleva a cabo gracias a la interacción entre un componente cliente llamado "agente", desplegado en cada terminal que posee software actualizable, y el componente servidor o Director Server. No obstante, para actualizar el agente en sí, no es posible hacerlo de la misma manera que se hace con una aplicación. Sin embargo, la solución posee un mecanismo para distribuir los binarios de los agentes en toda la cadena, por ejemplo cuando:
- se agregan nuevas funcionaldadesfuncionalidades
- se corrigen issues
- hay algún binario queda corrupto
- etc
...
7.2 ¿Cómo funciona?
Cuando inicia el agente, antes de iniciar la aplicación, le consulta al Director Server si sus binarios son los mismos que él tiene, utilizando para ello un número de versión.
...
Si no son iguales, se hace una comparación entre lo que tiene el cliente/agente y lo que tiene el servidor. Con éste delta, se hace la transferencia automática de las diferencias, la cuales son aplicadas en el cliente para luego, si continuar con el proceso normal de inicio
...
7.3 ¿Cómo se activa?
Para activar ésta funcionalidad se debe crear una carpeta en el servidor donde se ejecuta Director Server que contenga todos los binarios del Agente.
...
donde N es un número incremental que se debe incrementar cada vez que se haya introducido algún cambio a dicha carpeta (agergaragregar, renombrar o quitar archivos)
...
Una vez creada dicha ingresar a la consola de administración de Director Server e ir a la sección "Configuración→Configuración de propiedades". Luego buscar la propiedad "Directorio raiz raíz de actualizaciones del agente". Dicha propiedad debe indicar el directorio creado en el paso anterior, donde se encuentran los binarios del agente que se quieren sincronizar.
...
7.4 ¿Cómo evidenciar el funcionamiento?
Realizada la configuración de los pasos anteriores, al iniciar cada agente, notará que se logea así con la siguiente explicación:
...
7.5 ¿Cómo desplegar una versión nueva?
Para desplegar una versión nueva se debe
...