G3/gestion/3.10.0/DocTecnica/ActualizacionProduccion

Actualización del Sistema de Gestión Académica SIU-Guaraní 3 a la versión 3.10.x en entorno de producción

Configuraciones del servidor de producción

En el archivo <path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini configurar:

 es_produccion = 1

Para facilitar la actualización de versiones y evitar cometer errores en el pasaje desde desarrollo, los perfiles se definen en el entorno de producción. Para ello, en el archivo <path proyecto Guaraní>/lib/toba/instalacion/i__desarrollo/instancia.ini, dentro de la sección destinada al proyecto (indicada por "[guarani]") configurar:

 [guarani]
 usar_perfiles_propios = 1

La combinación de estos dos flags permite que la exportación de perfiles se haga en la carpeta <path proyecto Guaraní>/lib/toba/instalacion/i__desarrollo/p__guarani/perfiles en lugar de la carpeta usual <path proyecto Guaraní>/metadatos/permisos. Cuando se actualiza el sistema se toma este nuevo lugar para insertar los perfiles definidos localmente.

Por cuestiones de performance se recomienda además incluir en el archivo de inicialización de la instancia (<path proyecto Guaraní>/lib/toba/instalacion/i__desarrollo/instancia.ini) la directiva "metadatos_compilados":

[guarani]
usar_perfiles_propios = 1
metadatos_compilados = 1

Actualización de la versión

1. Exportar datos locales

Como primera medida se exportan los datos locales para preservarlos. Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>\bin) ejecutar:

 guarani instancia_exp_local

2. Apuntar el servidor de producción a la nueva versión

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

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

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

3. Regenerar la instancia

Para impactar los metadatos en la base de producción, dentro de la carpeta 'bin' de Toba (<path proyecto Guaraní>/lib/toba/bin) ejecutar:

 toba instancia regenerar -i desarrollo

Nota: si se visualiza un warning por algún perfil funcional revisar el mismo.

4. Migrar la base de datos negocio

Para migrar la base de datos negocio a la nueva versión, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>\bin) ejecutar:

 guarani migrar_base

5. Compilar metadatos

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

 guarani compilar

Al compilar los metadatos se generará la carpeta <path proyecto Guaraní>/metadatos_compilados que no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice el servidor.