SIU-Guarani/version3.18.0/actualizacion/gestion

De SIU
Saltar a: navegación, buscar

Actualización del SIU-Guaraní Gestión a la versión 3.18.x en entorno de desarrollo sin personalizaciones

Importante: Antes de comenzar el proceso de actualización, verificar las novedades técnicas de la versión.

Requisitos previos

  • Se deben quitar las directivas echo dentro del archivo <path proyecto Guaraní>/entorno_toba.env.

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 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.y.z: por la versión actual del sistema
  • 3.18.x: por la versión 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. Mover la carpeta de procesos background de <path_guarani>/temp a <path_guarani>/instalacion/i__desarrollo/p__guarani/logs/ mas info
  3. Cambiar la versión del código 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.18.x
  1. 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'.
    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/trunk/3.18.x --ignore-ancestry
  2. Antes de ejecutar el siguiente paso, es fundamental asegurar tener composer y yarn instalados. Para verificarlo, se pueden correr los siguientes comandos y verificar que no surjan errores:
    composer --version
    yarn --version
  3. Instalar vía Composer las dependencias del proyecto. Posicionados en la raíz <path proyecto Guaraní>, ejecutar:
    composer install
    Verificar que el comando anterior finalice sin errores para continuar.
    Nota: Si ha modificado algún archivo de la carpeta vendor y obtiene algún mensaje como este:
    Updating siu-arai/documentos-cli (v1.0.2 => v1.0.3):     
    The package has modified files: M tests/src/SIU/Queue/QueueTest.php Discard changes [y,n,v,d,s,?]? y
    Contestar y para descartar los cambios que se hayan realizado.
  4. Si se está actualizando desde una versión 3.15.0 o posterior, omitir este paso.
    Realizar un backup de la carpeta <path_proyecto>/lib/toba/instalacion.
    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.
    Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.
    Reiniciar Apache.
    service apache2 restart
  5. Regenerar la instancia Toba. Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
    ./toba instancia regenerar -i desarrollo
    Nota: ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder n.
    Luego compilar los metadatos de Toba Usuarios:
    ./toba proyecto compilar -i desarrollo -p toba_usuarios
  6. Migrar la base de datos de negocio. Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
    ./guarani migrar_base
  7. 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:
    Desde <path proyecto Guaraní> ejecutar:
    cp menu.ini.tmpl menu.ini
    Completar el archivo menu.ini
  8. Configurar la API REST
    API SIU-Guaraní - Perfil Funcional

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