SIU-Guarani/version3.13.0/actualizacion con personalizaciones/gestion

Actualización del SIU-Guaraní Gestión a la versión 3.13.x 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.

Requisitos previos

1. Que todos los miembros del equipo hayan subido sus cambios al SVN.

Pasos para la actualización

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).
A continuación se diferenciarán las tareas que debe llevar a cabo el Concentrador y las que debe realizar el resto del equipo.
Importante: el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.

A lo largo de los pasos se deberá reemplazar:

• <path proyecto Guaraní>: por el path donde está instalado el proyecto
• <siglas institución>: por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación.
• 3.y.z: por la versión actual del sistema
• 3.13.x: por la versión a la que se quiere actualizar

Pasos a realizar por el Concentrador

1. Resguardar los datos de la versión actual (backup de las personalizaciones)
   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. Resguardar la base de datos de negocio

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

      ./guarani resguardar_base

   3. Verificar y versionar personalizaciones
      1. Antes de continuar con la actualización, se deben exportar las personalizaciones existentes en la carpeta /guarani/personalizaciones:

         ./guarani esquema_pers exportar

         Importante: Controlar los mensajes que surgen de aplicar el comando anterior.

      2. Desactivar el esquema de personalizaciones para evitar conflictos de SVN

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

         ./guarani esquema_pers desactivar

      3. Verificar si hay cambios para subir, ejecutando dentro de la carpeta de Guaraní (<path proyecto Guaraní>)

         svn status

         Si dentro del directorio de personalizaciones aparece el signo ?, se debe ejecutar el siguiente comando para que luego el directorio que tiene el ? sea considerado para subir al SVN:

         svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)>

      4. Versionar el resultado de los comandos anteriores. Para ello, posicionados en la carpeta de Guaraní (<path proyecto Guaraní>) ejecutar:

         svn commit -m "Se versionan las personalizaciones para cambio de versión"

2. Actualizar el entorno de desarrollo a la nueva versión
   1. Cambiar la versión del código

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

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

      En versiones nuevas de svn puede salir un error:

      svn: E195012: Path '.' does not share common version control ancestry with the requested switch location.  Use --ignore-ancestry to disable this check.

      en este caso Ejecutar el comando anterior siguiendo lo recomendado en el mensaje:

      svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.13.x --ignore-ancestry

   2. Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:

      svn status

      y verificar que no existan archivos con estado 'S'.

   3. En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta <path proyecto Guaraní>/personalizacion.
   4. A partir de la versión 3.13.0, es necesario registrar manualmente la fuente de datos del proyecto toba_usuarios, usado para el manejo de perfiles y auditoría. Para ello, en el archivo <path proyecto Guaraní>/lib/toba/instalacion/bases.ini, si no existe una entrada con el encabezado [desarrollo toba_usuarios toba_usuarios], agregarla, con idéndica configuración a la instancia de Toba (primera entrada de ese archivo). Ejemplo:

      [desarrollo toba_usuarios toba_usuarios]
      motor = "postgres7"
      profile = "localhost"
      usuario = "postgres"
      clave = "**********"
      base = "guarani3"
      puerto = "5432"
      encoding = "LATIN1"
      schema = "desarrollo"

   5. En caso de no tener una configuración anterior de la manera de ver el menú de la aplicación, se puede establecer de la siguiente manera:

      Para ello, dentro de la carpeta <path proyecto Guaraní> ejecutar:

      cp menu.ini.tmpl menu.ini

      Completar el archivo menu.ini

   6. 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 n.

   7. 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. Responder n, agregue la carpeta al path y vuelva a intentarlo.

3. Migrar las personalizaciones

   Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.13.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores.
   

   1. Mergear la carpeta personalizacion a la nueva versión

      En la instancia actual de la actualización, la carpeta personalizacion tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción svn merge. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto (<path proyecto Guaraní>) ejecutar:

      svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/

   2. Activar el esquema de personalizaciones

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

      ./guarani esquema_pers iniciar

   3. 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

      Importante: si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.

   4. 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. Agregar al repositorio las personalizaciones importadas

      Posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:

      svn commit -m "3.13.x Merge de las personalizaciones realizadas en versiones anteriores"

   6. Exportar las personalizaciones

      Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:

      ./guarani exportar

   7. Versionar las personalizaciones

      Posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:

      svn commit -m "3.13.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores"

Pasos a realizar por el resto del equipo

Una vez que el Concentrador terminó de actualizar todo, el resto del equipo deberá realizar los siguientes pasos:

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. Cambiar a la nueva versión del sistema

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

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

3. Regenerar la instancia Toba

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

   ./toba instancia regenerar -i desarrollo

4. 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. Responder n, agregue la carpeta al path y vuelva a intentarlo.

Ir al esquema de instalación y actualización de la versión