Diferencia entre revisiones de «SIU-Guarani/version3.15.0/instalacion paralela/gestion/linux»
(Se agrega página para versión paralela) |
|||
Línea 1: | Línea 1: | ||
− | = | + | <span style="float: right; margin: 0 0 15px 15px;">__TOC__</span> |
+ | == Mantener mi versión actual e instalar la nueva versión en entorno de desarrollo con personalizaciones == | ||
+ | |||
{| class="simple" border="1" | {| class="simple" border="1" | ||
− | ! | + | ! <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 | + | |
− | + | === Requisitos previos === | |
− | + | * Previamente se deberán tener exportadas las personalizaciones de la versión anterior. Pasos del concentrador del 1 al 2.http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion | |
− | + | ||
− | + | ||
− | + | === Pasos para la instalación === | |
+ | * Seguir los pasos para la instalación del siguiente link. http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/instalacion_desde_cero/instalacion/gestion/linux | ||
+ | |||
+ | #Migrar las personalizaciones | ||
+ | #:Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores. <br> | ||
+ | ##Mergear la carpeta '''personalizacion''' a la nueva versión | ||
+ | ##:En la instancia actual de la actualización, la carpeta '''personalizacion''' tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción ''svn merge''. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto ('''<path proyecto Guaraní>''') ejecutar: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/ | ||
+ | </source> | ||
+ | ##Activar el esquema de personalizaciones | ||
+ | ##:Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | ./guarani esquema_pers iniciar | ||
+ | </source> | ||
+ | ##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: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | ./guarani esquema_pers conflictos | ||
+ | </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. | ||
+ | ##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: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | ./guarani esquema_pers importar | ||
+ | </source> | ||
+ | ##Agregar al repositorio las personalizaciones importadas | ||
+ | ##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | svn commit -m "3.15.x Merge de las personalizaciones realizadas en versiones anteriores" | ||
+ | </source> | ||
+ | ##Exportar las personalizaciones | ||
+ | ##:Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). Dentro de la carpeta 'bin' del proyecto Guaraní ('''<path proyecto Guaraní>/bin''') ejecutar: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | ./guarani exportar | ||
+ | </source> | ||
+ | ##Versionar las personalizaciones | ||
+ | ##:Posicionados en la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: | ||
+ | ##:<source lang="bash" enclose="div"> | ||
+ | svn commit -m "3.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores" | ||
+ | </source> | ||
+ | |||
+ | == Pasos a realizar por el resto del equipo == | ||
+ | '''Observación:''' Recordar que, tal como se indicó en los '''[[SIU-Guarani/Version3.15.0/actualizacion_con_personalizaciones/gestion#Requisitos_previos| Requisitos Previos]]''', todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las ''working copies'' del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un <source lang="bash" enclose="div"> svn status</source> sobre la raíz del proyecto. | ||
+ | |||
+ | '''Una vez que el Concentrador terminó de actualizar todo''', el resto del equipo deberá realizar los siguientes pasos: | ||
+ | #Verificar que se cumplan en cada servidor de desarrollo todos los [[SIU-Guarani/Version3.15.0/instalacion_desde_cero/requisitos_previos/linux|requisitos técnicos de la versión]]. | ||
+ | #Exportar la información local de la instancia. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar: | ||
#:<source lang="bash" enclose="div"> | #:<source lang="bash" enclose="div"> | ||
− | + | ./guarani instancia_exp_local | |
</source> | </source> | ||
− | # | + | #Cambiar a la nueva versión del sistema. Dentro de la carpeta del proyecto ('''<path proyecto Guaraní>''') ejecutar: |
#:<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 | |
</source> | </source> | ||
− | # | + | #: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. | |
− | |||
− | . | ||
</source> | </source> | ||
− | #: | + | #:en este 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 | |
− | + | </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> | </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"> | #:<source lang="bash" enclose="div"> | ||
− | + | composer install | |
− | |||
− | |||
− | |||
− | |||
</source> | </source> | ||
− | # | + | #:'''Verificar que el comando anterior finalice sin errores para continuar.''' |
+ | #En una consola en '''<path_proyecto>/bin''' ejecutar: | ||
#:<source lang="bash" enclose="div"> | #:<source lang="bash" enclose="div"> | ||
− | + | ./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. |
− | # | + | #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"> | #:<source lang="bash" enclose="div"> | ||
− | + | service apache2 restart | |
</source> | </source> | ||
− | # | + | #Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar: |
− | |||
#:<source lang="bash" enclose="div"> | #:<source lang="bash" enclose="div"> | ||
− | ./ | + | ./toba instancia regenerar -i desarrollo |
</source> | </source> | ||
− | #:'''Nota | + | #:'''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' ('''<path proyecto Guaraní>/bin''') ejecutar: |
#:<source lang="bash" enclose="div"> | #:<source lang="bash" 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. | |
− | + | #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: | |
− | #:'''Nota''' | + | #:Para ello, dentro de la carpeta '''<path proyecto Guaraní>''' ejecutar: |
− | + | #:<source lang="bash" enclose="div"> | |
− | + | cp menu.ini.tmpl menu.ini | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | # | ||
− | #: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | # | ||
− | |||
− | |||
− | |||
</source> | </source> | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Revisión del 15:27 29 jun 2018
Mantener mi versión actual e instalar la nueva versión en entorno de desarrollo con personalizaciones
Importante: Antes de comenzar el proceso de actualización, verificar las novedades técnicas de la versión. |
---|
Requisitos previos
- Previamente se deberán tener exportadas las personalizaciones de la versión anterior. Pasos del concentrador del 1 al 2.http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/actualizacion_con_personalizaciones/gestion
Pasos para la instalación
- Seguir los pasos para la instalación del siguiente link. http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/instalacion_desde_cero/instalacion/gestion/linux
- Migrar las personalizaciones
- Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores.
- Mergear la carpeta personalizacion a la nueva versión
- En la instancia actual de la actualización, la carpeta personalizacion tiene únicamente los archivos distribuidos por el SIU. Se debe combinar con las personalizaciones realizadas en la versión anterior, realizando la acción svn merge. Usando la línea de comandos, posicionados en la carpeta raíz del proyecto (<path proyecto Guaraní>) ejecutar:
- svn merge -r0:HEAD https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.y.z/personalizacion/ ./personalizacion/
- 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.15.x Merge de las personalizaciones realizadas en versiones anteriores"
- Exportar las personalizaciones
- Deben exportarse las personalizaciones para que las mismas queden disponibles para los demás miembros del equipo (recordar que el único que ejecuta los comandos relativos a personalización es el concentrador). 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.15.x Se versionan metadatos exportados de las personalizaciones realizadas en versiones anteriores"
- Luego de seguir los pasos anteriores, se tiene una instalación de la versión 3.15.x del sistema tal como la distribuye el SIU. Ahora es el turno de incorporar las personalizaciones desarrolladas en versiones anteriores.
Pasos a realizar por el resto del equipo
Observación: Recordar que, tal como se indicó en los Requisitos Previos, todos los miembros del equipo deberán haber subido sus cambios al SVN, por lo que en las working copies del resto del equipo no habrá cambios locales antes de ejecutar los siguientes pasos. Esto puede verificarse ejecutando un svn status
Una vez que el Concentrador terminó de actualizar todo, el resto del equipo deberá realizar los siguientes pasos:
- Verificar que se cumplan en cada servidor de desarrollo todos los requisitos técnicos de la versión.
- Exportar la información local de la instancia. Dentro de la carpeta 'bin' (<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.15.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.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:
- composer install
- Verificar que el comando anterior finalice sin errores para continuar.
- 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
- 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.
- Migrar la base de datos de negocio. Dentro de la carpeta 'bin' (<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.
- 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:
- Para ello, dentro de la carpeta <path proyecto Guaraní> ejecutar:
- cp menu.ini.tmpl menu.ini