SIU-Guarani/Version3.15.0/actualizacion de produccion/gestion

De SIU
Saltar a: navegación, buscar

Actualización del SIU-Guaraní Gestión a la versión 3.15.x.y en entorno de producción

Requisitos previos a la actualización

Configuraciones del servidor de producción

Chequear que el servidor de producción esté configurado como se indica en esta documentación.

Actualización de la versión

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 a la institución que realiza la instalación
  • 3.15.x.y: por la versión propia a la que se quiere actualizar

Los pasos a realizar son:

  1. Verificar que se cumplan todos los requisitos técnicos de la versión.
  2. Realizar un backup integral de la base de datos.
  3. Exportar datos locales
    Como primera medida se exportan los datos locales para preservarlos.
    Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
    ./guarani instancia_exp_local
  4. Apuntar el servidor de producción a la nueva versión 3.15.x.y
    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.15.x.y
    Importante: 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 ese 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/versiones/3.15.x.y --ignore-ancestry
  5. Antes de ejecutar el siguiente paso, es fundamental asegurar tener composer y bower instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:
    composer --version
    bower --version
  6. Realizar un backup de la carpeta <path_proyecto>/lib/toba/instalacion.
  7. Instalar vía Composer las dependencias del proyecto. Posicionados en la raíz <path proyecto Guaraní>, ejecutar:
    composer install
  8. En una consola en <path_proyecto>/bin ejecutar:
    ./reestructurar
    Es un comando que se corre por única vez para reubicar la carpeta instalacion, que pasa a estar en la raíz del proyecto, eliminar recursos obsoletos y ajustar paths en los archivos de configuración.
  9. Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.
  10. Reiniciar Apache.
    service apache2 restart
  11. Migrar la base de datos negocio. Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
    ./guarani migrar_base
    Importante:: si se contara con personalizaciones de base de datos, y como parte de las mismas se diera el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden aparecer errores en la migración. En ese caso, la recomendación es borrarlas, ejecutar el comando, y luego volver a crearlas.
  12. Compilar metadatos. Dentro de la carpeta 'bin' (<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 la versión de producción.
  13. Editar el archivo aplicacion.php (<path proyecto Guaraní>/www/aplicacion.php):
    1. Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados:
      define('apex_pa_metadatos_compilados', 1);
    2. Establecer el nivel de log en un nivel razonable para producción (notice o error), descomentando y editando la siguiente línea:
      define("apex_pa_log_archivo_nivel", 3); // 3: error | 5: notice

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