Actualizacin de Libertya versin 16.04 a versin 17.

05

Este documento presenta los pasos a seguir para realizar la actualizacin de Libertya
desde la versin 16.04 hacia la versin 17.05

Es importante que siga paso a paso las instrucciones detalladas en este documento y en
caso de no estar seguro en la realizacin de uno o varios de los pasos recuerde que
puede acudir al foro para exponer sus dudas y/o problemas al respecto.

ndice
Actualizacin de Libertya versin 16.04 a versin 17.05....................................................................1
Introduccin: Importante LEER PRIMERO....................................................................................2
Instalacin en instancia sin modificaciones.....................................................................................3
Pasos para la instalacin.............................................................................................................3
Etapa 1: Actualizacin de los binarios...................................................................................3
Etapa 2: Actualizacin de la base de datos.............................................................................3
Instalacin en instancia con modificaciones bajo convenciones.....................................................5
Actualizacin en instancia modificada........................................................................................5
Pasos para la instalacin.............................................................................................................5
Etapa 1: Actualizacin de los binarios...................................................................................5
Etapa 2: Actualizacin de la base de datos.............................................................................5
Instalacin en instancia con modificaciones fuera de convenciones...............................................7
Actualizacin en instancia modificada........................................................................................7
Pasos para la instalacin.............................................................................................................8
Etapa 1: Actualizacin de los binarios...................................................................................8
Etapa 2: Actualizacin de la base de datos.............................................................................8
Otras consideraciones....................................................................................................................10
Limpieza de Cache....................................................................................................................10
En caso de error.........................................................................................................................10
Introduccin: Importante LEER PRIMERO

Antes de comenzar: IMPORTANTE!

Se recomienda REALIZAR UN BACKUP de su actual base de datos antes de

comenzar con el proceso.
Asimismo, se recomienda REALIZAR UN BACKUP de sus archivos binarios
(directorio ServidorOXP)

Una vez realizados los backups estamos en condiciones de comenzar con la actualizacin
de Libertya. Bsicamente el proceso est dividido en dos etapas:

1. Actualizacin de los binarios

2. Actualizacin de la base de datos

IMPORTANTE: Si actualmente est utilizando la distribucin con Localizacin Argentina,

deber instalar la actualizacin correspondiente: org.libertya.localeAr.upgrade1.6-1.7.jar
recin LUEGO de finalizar la actualizacin de Libertya a la versin 17.05.

El presente documento contiene tres guas de instalacin. En funcin de las

modificaciones que haya realizado sobre la instancia de Libertya, deber seguir el
instructivo correspondiente.

Instalacin en instancia sin modificaciones

Utilice esta gua si usted no realiz modificacin alguna sobre el diccionario de datos del
sistema accediendo a la aplicacin mediante el perfil System Administrator. Este es el
caso ms general.

Instalacin en instancia con modificaciones bajo convenciones

Utilice esta gua si usted realiz modificaciones sobre el diccionario de datos del sistema
accediendo a la aplicacin mediante el perfil System Administrator, pero respetando las
convenciones de la Arquitectura Libertya Components.

Instalacin en instancia sin modificaciones fuera de convenciones

Utilice esta gua si usted realiz modificaciones sobre el diccionario de datos del sistema
accediendo a la aplicacin mediante el perfil System Administrator, pero sin haber
respetado las convenciones de la Arquitectura Libertya Components.
Instalacin en instancia sin modificaciones

Pasos para la instalacin

Etapa 1: Actualizacin de los binarios

Esta tarea simplemente implica la actualizacin de los componentes contenidos en el

directorio ServidorOXP.

1. Descargar los archivos binarios correspondientes a la versin 17.05 de Libertya

(ServidorOXP_V17.05.zip) desde el rea de descargas.
2. Detener el servidor de aplicaciones si ste est actualmente ejecutndose
(mediante DetenerServidor.sh o DetenerServidor.bat).
3. Descomprimir el archivo descargado, sobreescribiendo todos los archivos
existentes previamente, correspondientes a la versin 16.04 (alojado en
/ServidorOXP o bien en C:\ServidorOXP). En caso de contar con componentes
adicionales ya instalados dentro del directorio lib/plugins, los mismos no sufrirn
modificacin alguna.
4. Ejecutar la reconfiguracin de Libertya utilizando el script de configuracin
Configurar.sh (Linux) o el ejecutable Configurar.exe (Windows) sin realizar
modificaciones y guardar. Esto es necesario para propagar los nuevos binarios
reemplazados en el punto 3.

Una vez realizados estos pasos hemos culminado con la primer etapa de la actualizacin.
Vale la aclaracin de que en este punto el sistema no est funcional, es decir, estamos
utilizando los binarios de la versin 17.05 sobre la base de datos 16.04. Con lo cual
debemos continuar con el proceso tal como se explica en la siguiente seccin.

Etapa 2: Actualizacin de la base de datos

Esta etapa comprende la actualizacin de la base de datos del ncleo de Libertya a la

versin ms actual de la misma. Para realizar este proceso utilizaremos el framework de
Componentes de Libertya.

IMPORTANTE:
Si an no realiz un backup de su base de datos actual, todava est a tiempo, por
favor hgalo!

Los pasos a continuacin se deben realizar tanto para la distribucin Internacional como para la
distribucin de Argentina.

1. Iniciar el Cliente Libertya mediante Libertya.sh (en caso de estar en Windows,

especficamente para esta actualizacin es necesario que se inicie Libertya
mediante el archivo /ServidorOXP/utils/Libertya.bat). El Servidor de Aplicaciones
no debe estar ejecutndose.
2. Acceder mediante el usuario System contrasea System, y seleccionar el perfil
System Administrator. El sistema dar un aviso de que la base de datos est
desactualizada. Omitir esta advertencia y hacer click en NO.
3. Acceder a la ventana Instalador de Componentes, la cual se encuentra en:
Configuracin -> Configuracin del Sistema -> Configuracin de
 Componentes. Esta ventana permite seleccionar un archivo jar que sea un componente
de Libertya y efectuar la instalacin del mismo. Aqu, debemos seleccionar el archivo jar
provisto que se encargar de actualizar el core de Libertya desde la versin 16.04 hacia la
versin 17.05. El archivo es:

org.libertya.core.upgrade_16.04-17.05.jar

Seleccionamos este archivo y hacemos click en Instalar. El proceso requerir

varios minutos (20 o incluso ms) hasta finalizar la actualizacin del sistema.
Este valor podra llegar a variar en funcin del equipo donde se est
realizando la instalacin.
4. Si todo funcion correctamente la ventana mostrar un mensaje de informacin
indicando que la instalacin fue satisfactoria.

Cabe mencionar que, en caso de presentarse uno o varios errores durante la instalacin
de la base de datos, el usuario tendr la posibilidad de cancelar las modificaciones
realizadas, haciendo que el estado de la misma vuelva a su configuracin anterior, sin
necesidad de restaurar una copia de respaldo de la misma (ver apartado En caso de
error). Si por el contrario, se considera que los errores no son significativos, el usuario
podr confirmar los cambios.
Instalacin en instancia con modificaciones bajo convenciones

Actualizacin en instancia modificada

Si usted ha realizado modificaciones respetando las convenciones de desarrollo de la

Arquitectura Libertya Components, el proceso de actualizacon no deber presentar
mayores inconvenientes.

IMPORTANTE: La actualizacin del CORE de Libertya tambin incluye las modificaciones

y ampliaciones a los informes y reportes Jasper correspondientes. El proceso de
actualizacin de la base de datos se encarga tambin de realizar la sobreescritura de los
mismos, a partir de los archivos contenidos en el directorio binarios, del archivo de
actualizacin org.libertya.core.upgrade_16.04_17.05.jar. En caso de haber realizado
modificaciones a alguno de estos reportes y no querer contar con la nueva versin,
simplemente se deben eliminar del .jar los reportes que no se quieran actualizar, a fin de
que el proceso de actualizacin omita dichos archivos.

Pasos para la instalacin

Etapa 1: Actualizacin de los binarios

Esta tarea simplemente implica la actualizacin de los componentes contenidos en el

directorio ServidorOXP.

1. Descargar los archivos binarios correspondientes a la versin 17.05 de Libertya

(ServidorOXP_V17.05.zip) desde el rea de descargas.
2. Detener el servidor de aplicaciones si ste est actualmente ejecutndose
(mediante DetenerServidor.sh o DetenerServidor.bat).
3. Descomprimir el archivo descargado, sobreescribiendo todos los archivos
existentes previamente, correspondientes a la versin 16.04 (alojado en
/ServidorOXP o bien en C:\ServidorOXP). En caso de contar con componentes
adicionales ya instalados dentro del directorio lib/plugins, los mismos no sufrirn
modificacin alguna.
4. Ejecutar la reconfiguracin de Libertya utilizando el script de configuracin
Configurar.sh (Linux) o el ejecutable Configurar.exe (Windows) sin realizar
modificaciones y guardar. Esto es necesario para propagar los nuevos binarios
reemplazados en el punto 3.

Una vez realizados estos pasos hemos culminado con la primer etapa de la actualizacin.
Vale la aclaracin de que en este punto el sistema no est funcional, es decir, estamos
utilizando los binarios de la versin 17.05 sobre la base de datos 16.04. Con lo cual
debemos continuar con el proceso tal como se explica en la siguiente seccin.

Etapa 2: Actualizacin de la base de datos

Esta etapa comprende la actualizacin de la base de datos del ncleo de Libertya a la

versin ms actual de la misma. Para realizar este proceso utilizaremos el framework de
Componentes de Libertya.
IMPORTANTE:
Si an no realiz un backup de su base de datos actual, todava est a tiempo, por
favor hgalo!

Los pasos a continuacin se deben realizar tanto para la distribucin Internacional como para la
distribucin de Argentina.

1. Iniciar el Cliente Libertya mediante Libertya.sh (en caso de estar en Windows,

especficamente para esta actualizacin es necesario que se inicie Libertya
mediante el archivo /ServidorOXP/utils/Libertya.bat). El Servidor de Aplicaciones
no debe estar ejecutndose.
2. Acceder mediante el usuario System contrasea System, y seleccionar el perfil
System Administrator. El sistema dar un aviso de que la base de datos est
desactualizada. Omitir esta advertencia y hacer click en NO.
3. Acceder a la ventana Instalador de Componentes, la cual se encuentra en:
Configuracin -> Configuracin del Sistema -> Configuracin de
Componentes. Esta ventana permite seleccionar un archivo jar que sea un componente
de Libertya y efectuar la instalacin del mismo. Aqu, debemos seleccionar el archivo jar
provisto que se encargar de actualizar el core de Libertya desde la versin 16.04 hacia la
versin 17.05. El archivo es:

org.libertya.core.upgrade_16.04-17.05.jar

Seleccionamos este archivo y hacemos click en Instalar. El proceso requerir

varios minutos (20 o incluso ms) hasta finalizar la actualizacin del sistema.
Este valor podra llegar a variar en funcin del equipo donde se est
realizando la instalacin.
4. Si todo funcion correctamente la ventana mostrar un mensaje de informacin
indicando que la instalacin fue satisfactoria.

Cabe mencionar que, en caso de presentarse uno o varios errores durante la instalacin
de la base de datos, el usuario tendr la posibilidad de cancelar las modificaciones
realizadas, haciendo que el estado de la misma vuelva a su configuracin anterior, sin
necesidad de restaurar una copia de respaldo de la misma (ver apartado En caso de
error). Si por el contrario, se considera que los errores no son significativos, el usuario
podr confirmar los cambios.
Instalacin en instancia con modificaciones fuera de convenciones

Actualizacin en instancia modificada

Si usted ha realizado modificaciones en el diccionario de datos sin respetar las

convenciones de la Arquitectura Libertya Components, existe la probabilidad que el
proceso no realice correctamente los cambios requeridos para la actualizacin, y que el
mismo presente uno o ms errores.

Algunos ejemplos de modificaciones que podran generar conflictos son:

Haber eliminado algn registro que el proceso de actualizacin haga

referencia (REFERENCE NOT FOUND ERROR).
Haber creado previamente una columna con el mismo nombre de una que el
proceso de actualizacin intente insertar (COLUMN ALREADY EXISTS
ERROR).
Haber agregado permisos para una ventana a la cual el proceso de
actualizacin intentar dar permisos (DUPLICATE KEY ERROR).

Algunos ejemplos de modificaciones que NO generan conflictos:

Realizar cambios en las propiedades bsicas de una tabla o una columna;

as como de una ventana, pestaa o campo (solo lectura, registros
eliminables, etc.).
Realizar cambios en un formato de impresin (ordenamiento, campos a
mostrar, etc.)
Realizar modificaciones sobre traducciones.

En caso de haber creado otras compaas adems de la que brinda Libertya por defecto,
las mismas no reflejarn cambio alguno en sus entradas de men, accesos o permisos. El
proceso solo actualiza la compaa Libertya.

Si alguna de las condiciones previamente descriptas no se cumple, el comportamiento del

proceso de actualizacin no est garantizado aunque podra funcionar de todos modos.

IMPORTANTE: La actualizacin del CORE de Libertya tambin incluye las modificaciones

y ampliaciones a los informes y reportes Jasper correspondientes. El proceso de
actualizacin de la base de datos se encarga tambin de realizar la sobreescritura de los
mismos, a partir de los archivos contenidos en el directorio binarios, del archivo de
actualizacin org.libertya.core.upgrade_16.04_17.05.jar. En caso de haber realizado
modificaciones a alguno de estos reportes y no querer contar con la nueva versin,
simplemente se deben eliminar del .jar los reportes que no se quieran actualizar, a fin de
que el proceso de actualizacin omita dichos archivos.
Pasos para la instalacin

Etapa 1: Actualizacin de los binarios

Esta tarea simplemente implica la actualizacin de los componentes contenidos en el

directorio ServidorOXP.

4. Descargar los archivos binarios correspondientes a la versin 17.05 de Libertya

(ServidorOXP_V17.05.zip) desde el rea de descargas.
5. Detener el servidor de aplicaciones si ste est actualmente ejecutndose
(mediante DetenerServidor.sh o DetenerServidor.bat).
6. Descomprimir el archivo descargado, sobreescribiendo todos los archivos
existentes previamente, correspondientes a la versin 16.04 (alojado en
/ServidorOXP o bien en C:\ServidorOXP). En caso de contar con componentes
adicionales ya instalados dentro del directorio lib/plugins, los mismos no sufrirn
modificacin alguna.
4. Ejecutar la reconfiguracin de Libertya utilizando el script de configuracin
Configurar.sh (Linux) o el ejecutable Configurar.exe (Windows) sin realizar
modificaciones y guardar. Esto es necesario para propagar los nuevos binarios
reemplazados en el punto 3.

Una vez realizados estos pasos hemos culminado con la primer etapa de la actualizacin.
Vale la aclaracin de que en este punto el sistema no est funcional, es decir, estamos
utilizando los binarios de la versin 17.05 sobre la base de datos 16.04. Con lo cual
debemos continuar con el proceso tal como se explica en la siguiente seccin.

Etapa 2: Actualizacin de la base de datos

Esta etapa comprende la actualizacin de la base de datos del ncleo de Libertya a la

versin ms actual de la misma. Para realizar este proceso utilizaremos el framework de
Componentes de Libertya.

IMPORTANTE:
Si an no realiz un backup de su base de datos actual, todava est a tiempo, por
favor hgalo!

Los pasos a continuacin se deben realizar tanto para la distribucin Internacional como para la
distribucin de Argentina.

1. Iniciar el Cliente Libertya mediante Libertya.sh (en caso de estar en Windows,

especficamente para esta actualizacin es necesario que se inicie Libertya
mediante el archivo /ServidorOXP/utils/Libertya.bat). El Servidor de Aplicaciones
no debe estar ejecutndose.
2. Acceder mediante el usuario System contrasea System, y seleccionar el perfil
System Administrator. El sistema dar un aviso de que la base de datos est
desactualizada. Omitir esta advertencia y hacer click en NO.
3. Acceder a la ventana Instalador de Componentes, la cual se encuentra en:
Configuracin -> Configuracin del Sistema -> Configuracin de
Componentes. Esta ventana permite seleccionar un archivo jar que sea un componente
de Libertya y efectuar la instalacin del mismo. Aqu, debemos seleccionar el archivo jar
provisto que se encargar de actualizar el core de Libertya desde la versin 16.04 hacia la
 versin 17.05. El archivo es:

org.libertya.core.upgrade_16.04-17.05.jar

Seleccionamos este archivo y hacemos click en Instalar. El proceso requerir

varios minutos (20 o incluso ms) hasta finalizar la actualizacin del sistema.
Este valor podra llegar a variar en funcin del equipo donde se est
realizando la instalacin.
4. Si todo funcion correctamente la ventana mostrar un mensaje de informacin
indicando que la instalacin fue satisfactoria.

Cabe mencionar que, en caso de presentarse uno o varios errores durante la instalacin
de la base de datos, el usuario tendr la posibilidad de cancelar las modificaciones
realizadas, haciendo que el estado de la misma vuelva a su configuracin anterior, sin
necesidad de restaurar una copia de respaldo de la misma (ver apartado En caso de
error). Si por el contrario, se considera que los errores no son significativos, el usuario
podr confirmar los cambios.
Otras consideraciones

Limpieza de Cache

En caso de acceder a la aplicacin mediante JNLP (Java Web Start), se sugiere

previamente eliminar la cache, tanto del navegador web como de Java (esta ltima desde
las opciones de Java ubicadas en Preferencias -> Sun Java Control Panel (Linux) o
desde Panel de Control Java (Windows)), a fin de evitar conflictos al iniciar Libertya.

En caso de error

En caso de presentarse errores al realizar la etapa 2, Libertya le pedir que confirme o

cancele las modificaciones a la base de datos (dependiendo de la instancia en la que se
encuentra la instalacin, Libertya tambin podra llegar a cancelarla de manera
automtica). En caso de duda, podr cancelar y verificar cada uno de los errores y su
detalle tanto en pantalla como en el archivo que se genera para el caso en el directorio
ServidorOXP, bajo el nombre:

Component_install_YYYYMMDD_HHMMSS.log

Esto le servir de ayuda a fin de llevar adelante las acciones correctivas del caso, o bien
para determinar que los errores no son significativos y llevar adelante las modificaciones.
Recuerde que puede exponer sus inquietudes al respecto en el foro de Libertya.

Si no puede resolver el conflicto y desea volver a la versin 16.04, simplemente deber

restaurar el directorio ServidorOXP a su configuracin previa mediante la copia de
respaldo correspondiente.

La base de datos no requiere correccin alguna dado que la etapa 2 se realiza bajo una
nica transaccin.