Diferencia entre revisiones de «SIU-Guarani/version3.15.0/actualizacion/gestion»
Línea 8: | Línea 8: | ||
<br><br> | <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 |
− | * <siglas institución>: por las siglas correspondientes a la institución que realiza la instalación | + | * '''<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.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> | <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]]. | ||
#'''Resguardar los datos de la versión actual''' | #'''Resguardar los datos de la versión actual''' | ||
##Exportar la información local de la instancia | ##Exportar la información local de la instancia | ||
− | ##:Dentro de la carpeta 'bin' de SIU-Guaraní ( | + | ##:Dentro de la carpeta 'bin' de SIU-Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar: |
− | ##:<source lang=" | + | ##:<source lang="bash" enclose="div"> |
./guarani instancia_exp_local | ./guarani instancia_exp_local | ||
</source> | </source> | ||
##Resguardar la base de datos de negocio | ##Resguardar la base de datos de negocio | ||
− | ##:Dentro de la carpeta 'bin' ( | + | ##:Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar: |
− | ##:<source lang=" | + | ##:<source lang="bash" enclose="div"> |
./guarani resguardar_base | ./guarani resguardar_base | ||
</source> | </source> | ||
#'''Actualizar el entorno de desarrollo a la nueva versión''' | #'''Actualizar el entorno de desarrollo a la nueva versión''' | ||
##Cambiar la versión del código a la nueva versión del sistema | ##Cambiar la versión del código a la nueva versión del sistema | ||
− | ##:Dentro de la carpeta del proyecto ( | + | ##:Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: |
− | ##:<source lang=" | + | ##:<source lang="bash" enclose="div"> |
− | svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x | + | sudo 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 ( | + | ##: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=" | + | ##:<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=" | + | ##:<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=" | + | ##:<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 | + | sudo svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry |
+ | </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: | ||
+ | ##:<source lang="ini" enclose="div"> | ||
+ | composer --version | ||
+ | bower --version | ||
+ | </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: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | sudo composer install | ||
+ | </source> | ||
+ | ##En una consola en '''<path_proyecto>/bin''' ejecutar: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | sudo ./reestructurar | ||
+ | </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. | ||
+ | ##Seguir las instrucciones finales brindadas por el comando, relativo al ajuste de archivos de configuración de Apache. | ||
+ | ##Reiniciar Apache. | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | sudo 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: | ##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 | + | ##:Desde '''<path proyecto Guaraní>''' ejecutar: |
− | ##:<source lang=" | + | ##:<source lang="bash" enclose="div"> |
cp menu.ini.tmpl menu.ini | cp menu.ini.tmpl menu.ini | ||
</source> | </source> | ||
##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]] | ##:Completar el archivo [[SIU-Guarani/Version3.15.0/personalizaciones/formas_de_menu| menu.ini]] | ||
##Regenerar la instancia Toba | ##Regenerar la instancia Toba | ||
− | ##:Dentro de la carpeta 'bin' de Toba ( | + | ##:Dentro de la carpeta 'bin' de Toba ('''<path proyecto Guaraní>/lib/toba/bin''') ejecutar: |
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
./toba instancia regenerar -i desarrollo | ./toba instancia regenerar -i desarrollo | ||
Línea 57: | Línea 78: | ||
##:'''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' del proyecto SIU-Guaraní ( | + | ##:Dentro de la carpeta 'bin' del proyecto SIU-Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar: |
##:<source lang="php" 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''', | + | ##:'''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. |
<br><br> | <br><br> | ||
[[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 del 09:54 21 mar 2018
Actualización del SIU-Guaraní Gestión a la versión 3.15.x en entorno de desarrollo sin personalizaciones
Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institució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:
- Verificar que se cumplan todos los requisitos técnicos de la versión.
- Resguardar los datos de la versión actual
- Exportar la información local de la instancia
- Dentro de la carpeta 'bin' de SIU-Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani instancia_exp_local
- Resguardar la base de datos de negocio
- Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani resguardar_base
- Exportar la información local de la instancia
- 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:
- sudo 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:
- sudo svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x --ignore-ancestry
- 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
- 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:
- sudo composer install
- En una consola en <path_proyecto>/bin ejecutar:
- sudo ./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.
- sudo service apache2 restart
- 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
- Regenerar la instancia Toba
- Dentro de la carpeta 'bin' de Toba (<path proyecto Guaraní>/lib/toba/bin) ejecutar:
- ./toba instancia regenerar -i desarrollo
- Nota: ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder n.
- Migrar la base de datos de negocio
- Dentro de la carpeta 'bin' del proyecto SIU-Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani migrar_base
- 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.
- Cambiar la versión del código a la nueva versión del sistema