NotasTecnicas/ActualEntornoDesa35

<volver>

Actualización de Guarani3 a la versión 3.5


Descripción de los pasos:


1 Requisitos

Que el sistema se encuentre en la versión 3.4.0 o superior. Chequear esto en el menú:

Ayuda -> Acerca de.


2 Migración a la versión 3.5

La migración a la versión 3.5 del sistema involucra cambios muy importantes ya que se incorpora el nuevo esquema de personalización del proyecto.
Por este motivo es importante que se respeten todos los pasos involucrados en este manual y se consulte ante cualquier error con el SIU, para evitar pérdidas de personalizaciones ya implementadas o modificaciones en archivos del sistema.
Si no se realizó personalización alguna, la migración a la nueva versión del sistema es casi trivial y similar a las realizadas para versiones anteriores.
Como siempre, y por lo expuesto anteriormente, para realizar la migración a la nueva versión del sistema se recomienda hacer un Backup de la carpeta de archivos del sistema (carpeta 'guarani') El backup de la BD de negocios del sistema se realizará automáticamente cuando se ejecute el comando de migración de la misma a la nueva versión.


2.1 Actualizar la copia local de SIU-Toba

Usando la línea de comando, posicionados en la carpeta de la instalación Toba (por defecto C:\Toba):

          svn update

Usando el cliente gráfico TortoiseSVN:

source:/trunk/img/Actualización31-2.png


2.2 Exportar la información local de la instancia

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar

toba.bat

para cargar el entorno y a continuación:

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba instancia exportar_local –i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".


2.3 Exportar el proyecto SIU-Guaraní 3

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba proyecto exportar –p guarani –i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".


2.4 Resguardo de la BD de negocios y código

Antes de comenzar se debe resguardar la BD de negocios para restaurarla ante cualquier error que surja en el procedimiento de actualización de la versión. Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba proyecto resguardar_base –i <id_instancia> -p guarani

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".

Es ALTAMENTE RECOMENDABLE hacer un backup completo de la carpeta de código del proyecto (carpeta 'guarani'). Dado que en esta versión se incorpora el nuevo esquema de personalizaciones, las mismas deberán ser migradas al nuevo esquema por lo que es probable que lo desarrollado en versiones anteriores sufra modificaciones. Es por eso, que se debe realizar una exportación / backup de los archivos ya que en el paso siguiente se eliminarán los cambios realizados. Este paso es necesario en caso de tener archivos modificados o personalizaciones desarrolladas; si cuentan con archivos que difieren de los que se encuentran en el svn. Para realizar esto se debe simplemente mover (cortar y pegar) la carpeta 'guarani' a un directorio de resguardo fuera de la carpeta 'Toba' (los dirs '.svn' incluidos en cada subcarpeta de la misma, podrán desecharse luego).


2.5 Actualizar la versión de SIU-Guaraní 3

Dado que en el paso anterior se quitó la carpeta 'guarani' del directorio 'proyectos' de Toba (por defecto C:\Toba\proyectos\guarani) se debe crear nuevamente la misma y bajar el código de la nueva versión del sistema:

• Crear una carpeta dentro de la carpeta proyectos con el nombre ‘guarani’.
• Hacer un SVN checkout sobre la misma desde el repositorio de Guaraní 3.
La URL de descarga es:

http://repositorio.siu.edu.ar/svn/guarani/versiones/3.5.0 

En linux:

  • dentro de la carpeta guarani:
 svn co http://repositorio.siu.edu.ar/svn/guarani/versiones/3.5.0 ./

Ejemplo:

source:/trunk/img/Actualización35-1.png


source:/trunk/img/Actualización35-3.png


source:/trunk/img/Actualización35-4.png

En las migraciones a las versiones previas se usaba el comando 'SVN SWITCH' en lugar de 'SVN CHECKOUT', el fin es el mismo. En lugar de remplazar el código mediante las acciones del comando 'SVN SWITCH', se eliminan y se vuelven a crear con el comando 'SVN CHECKOUT'. En definitiva, se obtiene el mismo resultado.


2.6 Regenerar el proyecto SIU-Guaraní 3

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba proyecto regenerar –p guarani -i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".


2.7 Actualizar la base de datos de negocio a la nueva versión

Actualizar la base de negocio con los cambios introducidos entre versiones.

toba proyecto migrar_base -p guarani –i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".

Nota: si al ejecutar el comando de actualización se muestra el mensaje No pudo resguardarse la base actual. Desea continuar? (Si o No) , probablemente no se encuentre el directorio ‘bin’ de PostgreSQL en el path del sistema operativo. Responda "No", agregue la carpeta al path y vuelva a intentarlo.


3 Esquema de personalizaciones

Luego de ejecutar todos los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.5.0. Si se desean realizar personalizaciones sobre el sistema, se deben correr los dos comandos que se detallan a continuación. La ejecución de los mismos es opcional si aún no se van a realizar personalizaciones. Se puede postergar hasta el momento en el que se desee realizarlas. Se debe tener en cuenta que una vez que se inicia el esquema de personalizaciones, luego hay que realizar un mantenimiento del mismo con un par de comandos extras cada vez que se realicen cambios en el sistema. Sin embargo estos comandos se deben correr para comenzar con el proceso de personalizaciones de cualquier tipo en Guaraní 3.


3.1 Publicar URL con recursos personalizados

Publicar la URL en apache de los recursos personalizados que se incluirán.
Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba proyecto publicar_pers –i <id_instancia> -p guarani

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".


3.2 Iniciar el esquema de personalizaciones

Este paso es fundamental y usualmente demora varios minutos. Genera un nuevo esquema en la BD para incorporar los metadatos que se personalizaran en el proyecto.

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar toba.bat para cargar el entorno (si no fue ejecutado previamente) y a continuación:

toba personalizacion iniciar -p guarani –i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".


<volver>