Diferencia entre revisiones de «SIU-Guarani/version3.15.0/actualizacion/gestion»

De SIU
Saltar a: navegación, buscar
(Backup de <path>/lib/toba/instalacion.)
 
(No se muestran 18 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
 +
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
 
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo sin personalizaciones ==
 
== Actualización del SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo sin personalizaciones ==
−
{| border=1 class="simple"
+
{| class="simple" border="1"
−
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.
+
! <u>Importante</u>: Antes de comenzar el proceso de actualización, verificar las <u>[[SIU-Guarani/Version3.15.0/Novedades tecnicas|novedades técnicas]]</u> de la versión.
 
|}
 
|}
  
 
=== Pasos para la actualizació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).
 
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).
−
<br><br>
+
 
 
'''A lo largo de los pasos se deberá reemplazar:'''
 
'''A lo largo de los pasos se deberá reemplazar:'''
 
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto
 
* '''<path proyecto Guaraní>''': por el path donde está instalado el proyecto
Línea 12: Línea 13:
 
* '''3.y.z''': por la versión actual del sistema
 
* '''3.y.z''': por la versión actual del sistema
 
* '''3.15.x''': por la versión a la que se quiere actualizar
 
* '''3.15.x''': por la versión a la que se quiere actualizar
−
<br>
+
 
 
'''Los pasos a realizar son:'''
 
'''Los pasos a realizar son:'''
 
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].
 
#Verificar que se cumplan todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]].
−
#'''Resguardar los datos de la versión actual'''
+
#Cambiar la versión del código a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:  
−
##Exportar la información local de la instancia
+
#:(*) '''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">
−
##:Dentro de la carpeta 'bin' de SIU-Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:
 
−
##:<source lang="bash" enclose="div">
 
−
./guarani instancia_exp_local
 
−
</source>
 
−
##Resguardar la base de datos de negocio
 
−
##:Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
 
−
##:<source lang="bash" enclose="div">
 
−
./guarani resguardar_base
 
−
</source>
 
−
#'''Actualizar el entorno de desarrollo a la nueva versión'''
 
−
##Cambiar la versión del código a la nueva versión del sistema
 
−
##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar:
 
−
##:<source lang="bash" enclose="div">
 
 
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x
 
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x
 
</source>
 
</source>
−
##: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:  
+
#: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:  
−
##:<source lang="bash" enclose="div">
+
#:<source lang="bash" enclose="div">
 
svn status
 
svn status
 
</source>
 
</source>
−
##:y verificar que no existan archivos con estado 'S'.
+
#:y verificar que no existan archivos con estado 'S'.
−
##:'''Importante''': en versiones nuevas de svn puede salir un error:
+
#:'''Importante''': en versiones nuevas de svn puede salir un error:
−
##:<source lang="bash" enclose="div">
+
#:<source lang="bash" enclose="div">
 
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location.  Use --ignore-ancestry to disable this check.
 
svn: E195012: Path '.' does not share common version control ancestry with the requested switch location.  Use --ignore-ancestry to disable this check.
 
</source>
 
</source>
−
##:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:
+
#:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje:
−
##:<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.15.x --ignore-ancestry
 
svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.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 '''bower''' 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
 
bower --version
 
</source>
 
</source>
−
##Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''.
+
#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:
+
#:<source lang="bash" enclose="div">
−
##:<source lang="bash" enclose="div">
 
 
composer install
 
composer install
 
</source>
 
</source>
−
##En una consola en '''<path_proyecto>/bin''' ejecutar:  
+
#:'''Verificar que el comando anterior finalice sin errores para continuar.'''
−
##:<source lang="bash" enclose="div">
+
#'''Si se está actualizando a 3.15.1 desde 3.15.0, omitir este paso.'''
 +
#:Realizar un backup de la carpeta '''<path_proyecto>/lib/toba/instalacion'''.
 +
#:En una consola en '''<path_proyecto>/bin''' ejecutar:  
 +
#:<source lang="bash" enclose="div">
 
./reestructurar
 
./reestructurar
 
</source>
 
</source>
−
##: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.
+
#: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.
+
#:Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache.
−
##Reiniciar Apache.
+
#:Reiniciar Apache.
−
##:<source lang="bash" enclose="div">
+
#:<source lang="bash" enclose="div">
 
service apache2 restart
 
service apache2 restart
 
</source>
 
</source>
−
##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:
+
#Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
−
##:Desde '''<path proyecto Guaraní>''' ejecutar:
+
#:<source lang="bash" enclose="div">
−
##:<source lang="bash" enclose="div">
 
−
cp menu.ini.tmpl menu.ini
 
−
</source>
 
−
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]
 
−
##Regenerar la instancia Toba
 
−
##:Dentro de la carpeta 'bin' de Toba ('''<path proyecto Guaraní>/lib/toba/bin''') ejecutar:
 
−
##:<source lang="php" enclose="div">
 
 
./toba instancia regenerar -i desarrollo
 
./toba instancia regenerar -i desarrollo
 
</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'''.
−
##Migrar la base de datos de negocio
+
#Migrar la base de datos de negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar:
−
##:Dentro de la carpeta 'bin' del proyecto SIU-Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar:
+
#:<source lang="bash" enclose="div">
−
##:<source lang="php" enclose="div">
 
 
./guarani migrar_base
 
./guarani migrar_base
 
</source>
 
</source>
−
##:'''Nota:''' si al ejecutar el comando de migración se muestra el mensaje ''No pudo resguardarse la base actual. Desea continuar? (Si o No)'', probablemente no se encuentre el directorio 'bin' de PostgreSQL en el path del sistema operativo. Responder '''n''', agregar la carpeta al path y volver a intentarlo.
+
#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:
−
<br><br>
+
#:Desde '''<path proyecto Guaraní>''' ejecutar:
 +
#:<source lang="bash" enclose="div">
 +
cp menu.ini.tmpl menu.ini
 +
</source>
 +
#:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]]
 +
 
 
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]
 
[[SIU-Guarani/Version3.15.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]

Revisión actual del 17:14 27 feb 2019

Actualización del SIU-Guaraní Gestión a la versión 3.15.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.15.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. 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.
    svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x
    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.15.x --ignore-ancestry
  3. 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
  4. 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.
  5. Si se está actualizando a 3.15.1 desde 3.15.0, 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
  6. 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.
  7. Migrar la base de datos de negocio. Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
    ./guarani migrar_base
  8. 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

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.15.0/actualizacion/gestion&oldid=53435»