FLEXAB UPDATER

MAAN
NUUA DEE US
ALL D SUUA
ARRIIO
O
Y
Y
AD
DMMIIN
NIIS
STTR
RAAD
DOOR
R
 I N T R O D U C C I Ó N ........................................................................................................ 3
M A N U A L D E L U S U A R I O ............................................................................................ 4
M A N U A L D E L A D M I N I S T R A D O R ................................................................................ 9

FlexAB – FlexAB Updater

2
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf
FLEXAB U PDATER , MANUAL DEL U SUARIO Y A D MI N I S T R A D OR

El presente documento contiene una guía para poner en marcha y utilizar el Updater.

I N T RO D UC C I Ó N
Por lo general, las versiones de FlexAB suelen ser actualizadas mediante builds que pueden incluir
correcciones o incluso nueva funcionalidad. Cuando se distribuye un build, es necesario que el
administrador lo obtenga de un FTP, y luego lo instale en cada máquina de un usuario, lo cual consume
mucho tiempo y pone una carga en el administrador que podría ser automatizada. Si la tarea queda en
manos del usuario, es probable que se encuentre con obstáculos que lo superen.

Para simplificar el proceso de distribuir builds a los usuarios, se creó un “updater” (actualizador)
su función es simplemente descargar los builds y tenerlos disponibles hasta que sea necesario instalarlo.
Cuando ese momento llega, el mismo actualizador se encarga de instalar el build.

El administrador tendrá como única tarea configurar el aplicativo para que este se encargue de
descargar e instale actualizaciones.

FlexAB – FlexAB Updater

3
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf
M AN U A L DEL U SUARI O
Para utilizar el updater, se debe correr la aplicación FlexTray, es importante destacar que se
trabaja en dos etapas. Una es el chequeo y descarga de actualizaciones y la otra es la instalación de un
build en sí. El servidor al cual se consulta por actualizaciones es el último al que el usuario intentó
acceder. (Universo activo en el archivo flexconfig.ini)

Ambas operaciones pueden ser accedidas de dos formas, mediante el menú desplegable del
traybar o desde un menú dentro del FlexTray. Para esta guía utilizaremos el ícono del tray, una vez
seleccionadas las opciones la funcionalidad es la misma.

Haciendo click con el botón derecho sobre el ícono del traybar, se desplegará un menú como se
muestra en la Imagen 1.
Lo primero que se debe hacer es configurar la forma en que se van a descargar e instalar las
actualizaciones. Para ello vamos a la ventana updater OPTIONS (Imagen 2), accediendo por el menú
Option (Imagen 1).

Imagen 1 - Menú contextual del Traybar

Imagen 2 – Ventana updater Option

FlexAB – FlexAB Updater

4
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf
 A continuación se explica las distintas instancias de configuración que puede tomar la ventana
Updater Option para descargar e instalar actualizaciones automáticas.

1) Daily:
Al seleccionar esta instancia estamos obligando a Flex Tray a ejecutar el proceso de
actualización e instalación en el horario que se le indica

2) To start:
Al seleccionar esta instancia estamos obligando a Flex Tray a ejecutar el proceso de
actualización e instalación siempre que se inicie

3) Download request confirmation:

Al seleccionar esta instancia estamos obligando a Flex Tray a pedir confirmación de
descarga de actualización (Imagen 4), si esta instancia no se selecciona, la actualización
se descargara sin solicitarle confirmación al usuario, por lo que la imagen 4 no se
mostrara.
Es importante destacar que si no se encuentran actualizaciones se le informa al usuario
por medio de la imagen 3

Imagen 3 – No hay Updates disponibles Imagen 4 - Actualizaciones nuevas

Tras seleccionar esa operación se informará al usuario si hay o no actualizaciones

disponibles, mediante un cuadro de dialogo.

En el caso que el usuario seleccione SI, el progreso de descarga de actualizaciones se

indica según la Imagen 7

Imagen 7- Descarga de build

FlexAB – FlexAB Updater

5
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf
 Caso contrario, no se realizara la descarga correspondiente.

Los builds descargados son guardados en la carpeta Updates\Builds, dentro del directorio
de instalación de FlexAB.

4) Update request confirmation:

Al seleccionar esta instancia estamos obligando a Flex Tray a pedir confirmación de
Instalación (Imagen 5), si esta instancia no se selecciona la actualización se instalara sin
solicitarle confirmación al usuario, por lo que la imagen 5 no se mostrara
Es importante destacar que si no se encuentran actualizaciones para instalar se le informa
al usuario por medio de la imagen 6

Imagen 6 –No hay actualizaciones para

Imagen 5 – No hay Updates disponibles
instalar

En el caso que el usuario seleccione SI, el progreso de Instalación de actualizaciones se

indica según la Imagen 8

Imagen 8– Proceso de Instalación

Caso contrario, no se realizara la instalación correspondiente.

FlexAB – FlexAB Updater

6
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf
 Otra manera que FlexTray tiene para instalar Build es por medio de la ventana Select a Build.
(Imagen 10)
Esta ventana contiene un listado de buils a instalar donde el usuario podrá instalar o eliminar
aquellos que seleccione.
Esta opción se la puede acceder según la imagen 9

Una vez descargada la actualización el menú “Install Update” quedará habilitado1. Seleccionando
esta opción se mostrará la siguiente ventana:

Imagen 10- Selección de build

En esta ventana seleccionaremos que build deseamos instalar. Solo se listarán builds compatibles
con la instalación actual, es decir todos aquellos cuyo segundo par de números sean iguales. En el caso
de la ilustración, mostraría todos los builds con nombre v01.01.xx byy. Esto se debe a que los builds cuyo
segundo par es distinto requieren una instalación limpia, es decir quitar la versión instalada y ejecutar el
Instalador desde cero.

Para elegir la versión a la que deseamos pasar, debemos tildar el cuadrado contiguo a la versión,
y presionar “Install”. Esto cerrará la aplicación y ejecutará el “Updater”. La función de este programa es la
de tomar un build y realizar todos los pasos de instalación necesarios. Debido a que no se pueden pisar
archivos mientras se están ejecutando, el Updater esperará a que el usuario cierre las aplicaciones de
FlexAB que tenga abiertas (si las tuviere). Si la herramienta no encuentra ninguna aplicación de FlexAB
ejecutándose procederá a instalar el build.

Al terminar la operación, el actualizador se cerrará y ya quedará listo FlexAB con la versión

elegida.

De la misma manera, seleccionamos que Build se desea eliminar y presionando Delete el mismo
desaparecerá de la lista cerrando la ventana

1
Es probable que el menú ya se encuentre habilitado si en la carpeta donde quedan las actualizaciones
había archivos.
FlexAB – FlexAB Updater
7
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf
Otra opción que posee FlexTray es la incorporación Multilenguaje, Imagen 11

Imagen 11- multilenguaje

Seleccionando el tipo de lenguaje que se desee el sistema tomara esta configuración y se traducirá todas
sus etiquetas y menú al lenguaje deseado.

FlexAB – FlexAB Updater

8
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf
M AN U A L DEL A D MI N I S T R A D OR
La llegada de FlexAB Updater viene a cubrir una necesidad tanto de usuarios como de
administradores. Actualizar una instalación de FlexAB en una máquina es una tarea sencilla para un
administrador, sin embargo, los administradores no manejan solo una máquina, sino que suelen ser
responsables por todas las instalaciones de los usuarios. Con anterioridad, si un administrador deseaba
automatizar este proceso, debía hacer un script que obtuviera el build, lo descomprimiera y registre las
dll’s. Esto depositaba en los usuarios, la responsabilidad de ejecutar el script y tener cerradas todas las
aplicaciones. Además de producirse un error, el administrador no tenía forma de enterarse, lo cual llevaba
a que los usuarios reportaran problemas al ingresar a los distintos sistemas que utilizaban.

Con el updater, los usuarios tienen una forma amena de obtenerse versiones e incluso de reportar
si tuvieron un problema durante el proceso de instalación.

Para que los usuarios puedan hacer uso del actualizador, es necesario realizar ciertas tareas en el
servidor por parte del administrador.

Dentro de la carpeta “Root”2 del File Server se debe crear una nueva carpeta llamada “Updates” y
dentro de esta otras dos carpetas llamadas “Builds” y “Versions”. Estas carpetas contendran los builds
descargados por el administrador y los instaladores.

Luego cuando el administrador descargue actualizaciones (cualquiera sea el tipo) deberá dejarlas
en estas carpetas y estarán disponibles para el usuario. No cualquier archivo se podrá descargar de esas
carpetas. El usuario verá como disponibles solo los archivos cuyo nombre coincida con los patrones

Para la carpeta Builds: FlexAB Ejecutables vXX.YY.ZZ b<numero_de_build>.zip

Para la carpeta Versions: Setup vXX.YY.ZZ.exe

Solo estos archivos serán visibles al usuario final y podrán ser descargados. Además el proceso de
actualización del lado del cliente solo puede utilizar estos archivos como fuente.

Vale aclarar que si bien el administrador puede dejar versiones disponibles estas pueden ser de
versiones o builds que aun no fueron puestos en marcha en los servidores. El usuario podrá elegirlos para
bajar e incluso instalar, pero no podrá utilizarlas hasta que el servidor tenga la misma versión.

Los usuarios solo ven listados builds correspondientes a la versión que tienen activa al momento
de consultar los updates, e instaladores de versiones posteriores. No es posible pasar de una versión a
otra anterior mediante el updater, ni pisar la instalación con ejecutables correspondientes a un build de
otra versión.

Las carpetas con builds e instaladores, no se limpian de manera automática ni en el servidor ni en

los clientes, es responsabilidad del administrador ir eliminando builds o versiones que no vayan a ser
requeridos. Se recomienda hacer esto ya que de acumularse se estará ocupando espacio de manera inútil
y puede confundir a los usuarios al ver una lista muy extensa de builds.

2
A diferencia de los universos, clases y aplicaciones, no hay forma de almacenar los builds en distintas
distribuciones.
FlexAB – FlexAB Updater
9
v01.02.01 Revisión Nº2 - 15_(DOC)UPD-FlexABUpdater.pdf