Diferencia entre revisiones de «SIU-Guarani/version3.11.0/actualizacion con personalizaciones/gestion»
(→Pasos a realizar por el Concentrador) |
(→Actualización del SIU-Guaraní Gestión a la versión 3.11.x en entorno de desarrollo con personalizaciones) |
||
| (No se muestran 18 ediciones intermedias del mismo usuario) | |||
| Línea 3: | Línea 3: | ||
{| border=1 class="simple" | {| border=1 class="simple" | ||
| − | ! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio | + | ! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución. |
|} | |} | ||
=== Requisitos previos a la migración === | === Requisitos previos a la migración === | ||
| − | #Que el sistema se encuentre en la versión 3.10. Puede verificar esta condición desde la operación "? > Acerca de SIU-Guaraní 3". | + | #Que el sistema se encuentre en la versión 3.10.z. Puede verificar esta condición desde la operación "? > Acerca de SIU-Guaraní 3". |
#Que todos los miembros del equipo hayan subido sus cambios al SVN. | #Que todos los miembros del equipo hayan subido sus cambios al SVN. | ||
=== Pasos para la migración === | === Pasos para la migració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).<br> | 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> | ||
| − | A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.11.0/concentrador | Concentrador]]''' y las que debe realizar el resto del equipo.<br> | + | A continuación se diferenciarán las tareas que debe llevar a cabo el '''[[SIU-Guarani/Version3.11.0/concentrador|Concentrador]]''' y las que debe realizar el resto del equipo.<br> |
'''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo. | '''Importante:''' el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo. | ||
| + | <br><br> | ||
| + | '''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.10.z: por la versión actual del sistema | ||
| + | * 3.11.x: por la versión a la que se quiere actualizar | ||
==== Pasos a realizar por el Concentrador ==== | ==== Pasos a realizar por el Concentrador ==== | ||
#'''Resguardar los datos de la versión actual (backup de las personalizaciones)''' | #'''Resguardar los datos de la versión actual (backup de las personalizaciones)''' | ||
| Línea 18: | Línea 24: | ||
##:Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ##:Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./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' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ##:Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./guarani resguardar_base | |
</source> | </source> | ||
##Verificar y versionar personalizaciones | ##Verificar y versionar personalizaciones | ||
| − | ## | + | ###Antes de continuar con la migración, se deben exportar las personalizaciones existentes en la carpeta ''/guarani/personalizaciones'': |
| − | ##:<source lang="php" enclose="div"> | + | ###:<source lang="php" enclose="div"> |
| − | + | ./guarani esquema_pers exportar | |
</source> | </source> | ||
| − | ##: | + | ###:'''Importante:''' Controlar los mensajes que surgen de aplicar el comando anterior. |
| − | ##:<source lang="php" enclose="div"> | + | ###Desactivar el esquema de personalizaciones para evitar conflictos de SVN |
| − | + | ###:Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | |
| − | + | ###:<source lang="php" enclose="div"> | |
| + | ./guarani esquema_pers desactivar | ||
</source> | </source> | ||
| − | # | + | ###Verificar si hay cambios para subir, ejecutando dentro de la carpeta de Guaraní (<tt><path proyecto Guaraní></tt>) |
| − | ## | + | ###:<source lang="php" enclose="div"> |
| − | ##:<source lang="php" enclose="div"> | + | svn status |
| − | svn | ||
| − | |||
</source> | </source> | ||
| − | ## | + | ###:Si dentro del directorio de personalizaciones aparece el signo '''?''', se debe ejecutar el siguiente comando para que luego el directorio que tiene el '''?''' sea considerado para subir al SVN: |
| − | ##: | + | ###:<source lang = "php" enclose="div"> |
| − | ##:<source lang="php" enclose="div"> | + | svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)> |
| − | + | </source> | |
| + | ###:Se deben subir los cambios, si es que los hubiera. Para ello, posicionados en la carpeta de Guaraní (<tt><path proyecto Guaraní></tt>) ejecutar: | ||
| + | ###:<source lang="php" enclose="div"> | ||
| + | svn commit -m "Se versionan las personalizaciones para la migración a la próxima versión" | ||
</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 | ##Cambiar la versión del código | ||
| − | ##: | + | ##:Dentro de la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: |
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x | |
</source> | </source> | ||
| − | ##: | + | ##:En versiones nuevas de svn puede salir un error: |
| − | |||
| − | |||
##:<source lang="php" enclose="div"> | ##:<source lang="php" 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. | ||
| Línea 60: | Línea 66: | ||
##:en este caso Ejecutar el comando anterior siguiendo lo recomendado en el mensaje: | ##:en este caso Ejecutar el comando anterior siguiendo lo recomendado en el mensaje: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x --ignore-ancestry | |
| + | </source> | ||
| + | ##Una vez concluído el switch debemos verificar que el mismo se haya completado correctamente. Para ello, dentro de la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: | ||
| + | ##:<source lang="php" enclose="div"> | ||
| + | svn status | ||
| + | </source> | ||
| + | ##:y verificar que no existan archivos con estado 'S'. | ||
| + | ##En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta <tt><path proyecto Guaraní>/personalizacion</tt>. | ||
| + | ##Configurar de qué manera se desea ver el menú de la aplicación (solo si se está pasando desde una versión 3.10.z o anterior). | ||
| + | ##:Para ello, dentro de la carpeta <tt><path proyecto Guaraní></tt> ejecutar: | ||
| + | ##:<source lang="php" enclose="div"> | ||
| + | cp menu.ini.tmpl menu.ini | ||
</source> | </source> | ||
| − | |||
| − | |||
##:Completar el archivo [[SIU-Guarani/Version3.11.0/personalizaciones/formas_de_menu| menu.ini]] | ##:Completar el archivo [[SIU-Guarani/Version3.11.0/personalizaciones/formas_de_menu| menu.ini]] | ||
##Mergear la carpeta personalizaciones a la nueva versión | ##Mergear la carpeta personalizaciones a la nueva versión | ||
##:Una vez obtenido el código de la nueva versión, la carpeta personalizaciones tendrá los archivos estándar. Luego hay que obtener todas las personalizaciones realizadas en la versión anterior (si es que existieran). Para esto, se debe hacer un SVN MERGE sobre la carpeta '''personalizaciones'''. Usando la línea de comando, posicionados en la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: | ##:Una vez obtenido el código de la nueva versión, la carpeta personalizaciones tendrá los archivos estándar. Luego hay que obtener todas las personalizaciones realizadas en la versión anterior (si es que existieran). Para esto, se debe hacer un SVN MERGE sobre la carpeta '''personalizaciones'''. Usando la línea de comando, posicionados en la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.10.z/personalizacion/ ./personalizacion/ | |
</source> | </source> | ||
| − | |||
##Regenerar la instancia Toba | ##Regenerar la instancia Toba | ||
##:Dentro de la carpeta 'bin' de Toba (<tt><path proyecto Guaraní>/lib/toba/bin</tt>) ejecutar: | ##:Dentro de la carpeta 'bin' de Toba (<tt><path proyecto Guaraní>/lib/toba/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./toba instancia regenerar -i desarrollo | |
</source> | </source> | ||
| − | ##:'''Nota''': ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder | + | ##:'''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 Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ##:Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./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. | + | ##:'''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''', agregue la carpeta al path y vuelva a intentarlo. |
#'''Migrar las personalizaciones''' | #'''Migrar las personalizaciones''' | ||
#:Luego de ejecutar los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.11.x del sistema. Es decir, el sistema debería estar corriendo en la nueva versión con las operaciones estándares enviadas por el SIU. Sin embargo, si en la versión anterior se habían desarrollado personalizaciones es necesario incorporarlas a la nueva versión. <br> | #:Luego de ejecutar los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.11.x del sistema. Es decir, el sistema debería estar corriendo en la nueva versión con las operaciones estándares enviadas por el SIU. Sin embargo, si en la versión anterior se habían desarrollado personalizaciones es necesario incorporarlas a la nueva versión. <br> | ||
| Línea 89: | Línea 103: | ||
##:Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ##:Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./guarani esquema_pers iniciar | |
</source> | </source> | ||
##Chequear conflictos de las personalizaciones con la nueva versión | ##Chequear conflictos de las personalizaciones con la nueva versión | ||
##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ##:Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./guarani esquema_pers conflictos | |
</source> | </source> | ||
##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio. | ##:'''Importante''': si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio. | ||
| Línea 100: | Línea 114: | ||
##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ##:A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./guarani esquema_pers importar | |
| + | </source> | ||
| + | ##Agregar al repositorio las personalizaciones importadas | ||
| + | ##:Posicionados en la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: | ||
| + | ##:<source lang="php" enclose="div"> | ||
| + | svn commit -m "3.11.x Merge de las personalizaciones realizadas en versiones anteriores" | ||
</source> | </source> | ||
##Exportar las personalizaciones | ##Exportar las personalizaciones | ||
##:Dado que se mejoró el trabajo con el esquema de personalizaciones a partir de la versión 2.6 de Toba, se deben exportar las mismas en la carpeta ''guarani/metadatos'' para versionarse y se encuentren disponibles para los demás miembros del equipo. A continuación se procede con la exportación de las personalizaciones desarrolladas. Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ##:Dado que se mejoró el trabajo con el esquema de personalizaciones a partir de la versión 2.6 de Toba, se deben exportar las mismas en la carpeta ''guarani/metadatos'' para versionarse y se encuentren disponibles para los demás miembros del equipo. A continuación se procede con la exportación de las personalizaciones desarrolladas. Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | ./guarani exportar | |
</source> | </source> | ||
##Versionar las personalizaciones | ##Versionar las personalizaciones | ||
##:Posicionados en la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: | ##:Posicionados en la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
| − | + | svn commit -m "3.11.x Export de las personalizaciones realizadas en versiones anteriores" | |
</source> | </source> | ||
| Línea 118: | Línea 137: | ||
#:Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | #:Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
#:<source lang="php" enclose="div"> | #:<source lang="php" enclose="div"> | ||
| − | + | ./guarani instancia_exp_local | |
</source> | </source> | ||
| − | # | + | #Cambiar a la nueva versión del sistema |
| + | #:Dentro de la carpeta del proyecto (<tt><path proyecto Guaraní></tt>) ejecutar: | ||
#:<source lang="php" enclose="div"> | #:<source lang="php" enclose="div"> | ||
| − | + | svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x | |
</source> | </source> | ||
| − | |||
#Regenerar la instancia Toba | #Regenerar la instancia Toba | ||
#:Dentro de la carpeta 'bin' de Toba (<tt><path proyecto Guaraní>/lib/toba/bin</tt>) ejecutar: | #:Dentro de la carpeta 'bin' de Toba (<tt><path proyecto Guaraní>/lib/toba/bin</tt>) ejecutar: | ||
#:<source lang="php" enclose="div"> | #:<source lang="php" enclose="div"> | ||
| − | + | ./toba instancia regenerar -i desarrollo | |
| + | </source> | ||
| + | #Migrar la base de datos de negocio | ||
| + | #:Dentro de la carpeta 'bin' del proyecto Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar: | ||
| + | #:<source lang="php" enclose="div"> | ||
| + | ./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''', agregue la carpeta al path y vuelva a intentarlo. |
| + | <br><br> | ||
| + | [[SIU-Guarani/Version3.11.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]] | ||
Revisión actual del 16:21 4 feb 2016
Sumario
Actualización del SIU-Guaraní Gestión a la versión 3.11.x en entorno de desarrollo con personalizaciones
| Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución. |
|---|
Requisitos previos a la migración
- Que el sistema se encuentre en la versión 3.10.z. Puede verificar esta condición desde la operación "? > Acerca de SIU-Guaraní 3".
- Que todos los miembros del equipo hayan subido sus cambios al SVN.
Pasos para la migració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 continuación se diferenciarán las tareas que debe llevar a cabo el Concentrador y las que debe realizar el resto del equipo.
Importante: el resto del equipo de trabajo debe realizar los pasos que le corresponden una vez que el Concentrador terminó de actualizar todo.
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.10.z: por la versión actual del sistema
- 3.11.x: por la versión a la que se quiere actualizar
Pasos a realizar por el Concentrador
- Resguardar los datos de la versión actual (backup de las personalizaciones)
- Exportar la información local de la instancia
- Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani instancia_exp_local
- Resguardar la base de datos de negocio
- Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani resguardar_base
- Verificar y versionar personalizaciones
- Antes de continuar con la migración, se deben exportar las personalizaciones existentes en la carpeta /guarani/personalizaciones:
- ./guarani esquema_pers exportar
- Importante: Controlar los mensajes que surgen de aplicar el comando anterior.
- Desactivar el esquema de personalizaciones para evitar conflictos de SVN
- Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani esquema_pers desactivar
- Verificar si hay cambios para subir, ejecutando dentro de la carpeta de Guaraní (<path proyecto Guaraní>)
- svn status
- Si dentro del directorio de personalizaciones aparece el signo ?, se debe ejecutar el siguiente comando para que luego el directorio que tiene el ? sea considerado para subir al SVN:
- svn add <path del directorio que se tiene que agregar (el que tiene el signo ?)>
- Se deben subir los cambios, si es que los hubiera. Para ello, posicionados en la carpeta de Guaraní (<path proyecto Guaraní>) ejecutar:
- svn commit -m "Se versionan las personalizaciones para la migración a la próxima versión"
- Antes de continuar con la migración, se deben exportar las personalizaciones existentes en la carpeta /guarani/personalizaciones:
- 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
- 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.11.x
- 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 este 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.11.x --ignore-ancestry
- 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'.
- En caso de existir un conflicto SVN en el archivo personalizacion.ini, resolverlo dejando la opción de la nueva versión del SIU. Una forma de hacerlo es borrando los archivos en conflicto y realizando un svn update de la carpeta <path proyecto Guaraní>/personalizacion.
- Configurar de qué manera se desea ver el menú de la aplicación (solo si se está pasando desde una versión 3.10.z o anterior).
- Para ello, dentro de la carpeta <path proyecto Guaraní> ejecutar:
- cp menu.ini.tmpl menu.ini
- Completar el archivo menu.ini
- Mergear la carpeta personalizaciones a la nueva versión
- Una vez obtenido el código de la nueva versión, la carpeta personalizaciones tendrá los archivos estándar. Luego hay que obtener todas las personalizaciones realizadas en la versión anterior (si es que existieran). Para esto, se debe hacer un SVN MERGE sobre la carpeta personalizaciones. Usando la línea de comando, posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:
- svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.10.z/personalizacion/ ./personalizacion/
- 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 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, agregue la carpeta al path y vuelva a intentarlo.
- Cambiar la versión del código
- Migrar las personalizaciones
- Luego de ejecutar los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.11.x del sistema. Es decir, el sistema debería estar corriendo en la nueva versión con las operaciones estándares enviadas por el SIU. Sin embargo, si en la versión anterior se habían desarrollado personalizaciones es necesario incorporarlas a la nueva versión.
- En el paso 2.2 se realizó el MERGE de la carpeta de personalizaciones de la versión anterior a ésta. Para la migración del esquema de personalizaciones realizar los pasos detallados.
- Activar el esquema de personalizaciones
- Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani esquema_pers iniciar
- Chequear conflictos de las personalizaciones con la nueva versión
- Dado que el sistema Guaraní funciona sobre el framework SIU-Toba, utilizando su esquema de metadatos, es necesario chequear si existe algún conflicto entre las personalizaciones realizadas y la nueva versión. Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani esquema_pers conflictos
- Importante: si al ejecutar el comando llegara a reportarse algún conflicto irresoluble, consultar con el equipo SIU-Guaraní (vía foro o GdS) para ser guiados en el tratamiento de los mismos. Si los conflictos son solubles, cuando se proceda con el proceso de importación de personalizaciones se preguntará si desea incorporar o no este cambio.
- Importar las personalizaciones
- A continuación se procede a incorporar las personalizaciones desarrolladas en la versión anterior a la actual. Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani esquema_pers importar
- Agregar al repositorio las personalizaciones importadas
- Posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:
- svn commit -m "3.11.x Merge de las personalizaciones realizadas en versiones anteriores"
- Exportar las personalizaciones
- Dado que se mejoró el trabajo con el esquema de personalizaciones a partir de la versión 2.6 de Toba, se deben exportar las mismas en la carpeta guarani/metadatos para versionarse y se encuentren disponibles para los demás miembros del equipo. A continuación se procede con la exportación de las personalizaciones desarrolladas. Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani exportar
- Versionar las personalizaciones
- Posicionados en la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:
- svn commit -m "3.11.x Export de las personalizaciones realizadas en versiones anteriores"
- Luego de ejecutar los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.11.x del sistema. Es decir, el sistema debería estar corriendo en la nueva versión con las operaciones estándares enviadas por el SIU. Sin embargo, si en la versión anterior se habían desarrollado personalizaciones es necesario incorporarlas a la nueva versión.
Pasos a realizar por el resto del equipo
Una vez que el Concentrador terminó de actualizar todo, el resto del equipo deberá realizar los siguientes pasos:
- Exportar la información local de la instancia
- Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani instancia_exp_local
- Cambiar 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.11.x
- Regenerar la instancia Toba
- Dentro de la carpeta 'bin' de Toba (<path proyecto Guaraní>/lib/toba/bin) ejecutar:
- ./toba instancia regenerar -i desarrollo
- Migrar la base de datos de negocio
- Dentro de la carpeta 'bin' del proyecto 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, agregue la carpeta al path y vuelva a intentarlo.
