G3/gestion/3.9.0/DocTecnica/ActualizacionConPersonalizaciones

Actualización del Sistema de Gestión Académica SIU-Guaraní 3 a la versión 3.9.0 en entorno de desarrollo con personalizaciones

Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio colab para la institución.

Pasos a seguir

1. Requisitos

  • Que el sistema se encuentre en la versión 3.8.x. Puede verificar esta condición desde la operación "? > Acerca de SIU-Guaraní 3".

2. Resguardo de datos de la versión actual

Cada actualización del sistema implica modificaciones importantes, por este motivo es primordial que se respeten todos los pasos detallados. Ante cualquier inconveniente consulte con el equipo SIU-Guaraní (vía foro o GdS).

La actualización a la versión 3.9.0 involucra la utilización de la versión 2.5 del framework SIU-Toba.

2.1. Exportar la información local de la instancia

Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani instancia_exp_local

2.2. Resguardo de la base de datos de negocio

Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani resguardar_base

3. Actualización del entorno de desarrollo a la nueva versión

3.1. Cambiar la versión del código

Hacer un SVN SWITCH a la nueva versión del sistema. Usando la línea de comando, dentro de la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:

 svn sw https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.9.0

Nota: reemplazar <siglas institución> por las siglas correspondientes a la institución que realiza la instalación.

3.2. Mergear la carpeta personalizaciones a la nueva versión

Una vez obtenido el código de la nueva versión, la carpeta personalizaciones tendrá los archivos estándar. Luego hay que obtener todas las personalizaciones realizadas en la versión anterior (si es que existieran). Para esto, se debe hacer un SVN MERGE sobre la carpeta 'personalizaciones'. Usando la línea de comando, posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:

 svn merge https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.8.x/personalizacion ./personalizacion

Nota: reemplazar <siglas institución> y el último dígito de la versión (3.8.x) según el caso de la institución.

3.3. Desactivar el esquema de personalizaciones

Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>\bin) ejecutar:

 guarani esquema_pers desactivar

3.4. Regenerar la instancia Toba

Dentro de la carpeta 'bin' de Toba (<path proyecto Guaraní>/lib/toba/bin) ejecutar:

 toba instancia regenerar -i desarrollo

Nota: ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder "No".

3.5. Migrar la base de datos de negocio

Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani migrar_base

Nota: si al ejecutar el comando de migració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.

4. Migración de personalizaciones

Luego de ejecutar los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.9.0 del sistema. Es decir, el sistema debería estar corriendo en la nueva versión con las operaciones estándares enviadas por el SIU. Sin embargo, si en la versión anterior se habían desarrollado personalizaciones es necesario incorporarlas a la nueva versión.
En el paso 3.2 se realizó el MERGE de la carpeta de personalizaciones de la versión anterior a ésta. Para la migración del esquema de personalizaciones realizar los pasos detallados.

4.1. Activar 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' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani esquema_pers iniciar 

4.2. Chequear conflictos de las personalizaciones con la nueva versión

Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani esquema_pers conflictos

Nota: si al ejecutar el comando llegara a reportarse algún conflicto consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos.

4.3. Importar las personalizaciones

A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani esquema_pers importar

5. Ajuste de alias de Apache

Editar el archivo de configuración toba.conf (<path proyecto Guaraní>/lib/toba/instalacion/toba.conf). Dentro de la sección correspondiente al proyecto Guaraní (identificada como "#Proyecto: guarani") reemplazar las directivas:

 <Files aplicacion.php>
     SetEnv TOBA_INSTANCIA "desarrollo"
 </Files>
 <Files servicios.php>
     SetEnv TOBA_INSTANCIA "desarrollo"
 </Files>

Por:

 SetEnv TOBA_INSTANCIA "desarrollo"

Además agregar:

 <Files rest>
     ForceType application/x-httpd-php
 </Files>

Importante: para estar en condiciones de actualizar el servidor de producción ver Creación de una nueva versión propia del sistema con personalizaciones.