Diferencia entre revisiones de «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)
 
(No se muestran 5 ediciones intermedias de 4 usuarios)
Línea 4: Línea 4:
 
! <u>Importante</u>: Antes de comenzar el proceso de actualización, verificar las <u>[[SIU-Guarani/Version3.18.0/Novedades tecnicas|novedades técnicas]]</u> de la versión.
 
! <u>Importante</u>: Antes de comenzar el proceso de actualización, verificar las <u>[[SIU-Guarani/Version3.18.0/Novedades tecnicas|novedades técnicas]]</u> 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 ===
 
=== Pasos para la actualización ===
Línea 18: Línea 20:
 
#Mover la carpeta de procesos background de <path_guarani>/temp a <path_guarani>/instalacion/i__desarrollo/p__guarani/logs/ [[SIU-Guarani/Version3.18.0/Gestion/Refactorizacion|mas info]]
 
#Mover la carpeta de procesos background de <path_guarani>/temp a <path_guarani>/instalacion/i__desarrollo/p__guarani/logs/ [[SIU-Guarani/Version3.18.0/Gestion/Refactorizacion|mas info]]
 
#Cambiar la versión del código a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:  
 
#Cambiar la versión del código a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:  
−
#:(*) '''Si está actualizando desde la versión 3.15.0:''' Eliminar el archivo composer.lock de la raíz de la aplicación antes de ejecutar el comando.<source lang="bash" enclose="div">
+
<source lang="bash" enclose="div">
 
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.18.x
 
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.18.x
 
</source>
 
</source>
Línea 34: Línea 36:
 
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.18.x --ignore-ancestry
 
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.18.x --ignore-ancestry
 
</source>
 
</source>
−
#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:
+
#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:
 
#:<source lang="ini" enclose="div">
 
#:<source lang="ini" enclose="div">
 
composer --version
 
composer --version
−
bower --version
+
yarn --version
 
</source>
 
</source>
 
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:
 
#Instalar vía ''Composer'' las dependencias del proyecto. Posicionados en la raíz '''<path proyecto Guaraní>''', ejecutar:
Línea 44: Línea 46:
 
</source>
 
</source>
 
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''
 
#:'''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.
 
#Si se está actualizando desde una versión 3.15.0 o posterior,  '''omitir este paso'''.
 
#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'''.  
 
#:Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''.  
Línea 61: Línea 67:
 
</source>
 
</source>
 
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.
 
#:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder '''n'''.
 +
#:Luego compilar los metadatos de Toba Usuarios:
 +
#:<source lang="bash" enclose="div">
 +
./toba proyecto compilar -i desarrollo -p toba_usuarios
 +
</source>
 
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
 
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
 
#:<source lang="bash" enclose="div">
 
#:<source lang="bash" enclose="div">

Revisión actual del 10:52 5 nov 2020

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

Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.18.0/actualizacion/gestion&oldid=69429»