SIU-Guarani/version3.18.0/actualizacion/gestion

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.

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.

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.

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