Diferencia entre revisiones de «SIU-Guarani/Version3.15.0/actualizacion de produccion/gestion»
| (No se muestran 4 ediciones intermedias del mismo usuario) | |||
| Línea 5: | Línea 5: | ||
=== Configuraciones del servidor de producción === | === Configuraciones del servidor de producción === | ||
| − | Chequear que el servidor de producción esté configurado como se indica [[SIU-Guarani/version3.15.0/instalacion_desde_cero/configuracion_produccion_gestion| | + | Chequear que el servidor de producción esté configurado como se indica en esta [[SIU-Guarani/version3.15.0/instalacion_desde_cero/configuracion_produccion_gestion|documentación]]. |
=== Actualización de la versión === | === Actualización de la versión === | ||
'''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.15.x.y: por la versión propia a la que se quiere actualizar | + | * '''3.15.x.y''': por la versión propia a la que se quiere actualizar |
'''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]]. |
| − | # | + | #Realizar un backup integral de la base de datos. |
| − | + | #Exportar datos locales. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar: | |
| − | #:<source lang=" | + | #:<source lang="bash" enclose="div"> |
./guarani instancia_exp_local | ./guarani instancia_exp_local | ||
</source> | </source> | ||
#Apuntar el servidor de producción a la nueva versión 3.15.x.y | #Apuntar el servidor de producción a la nueva versión 3.15.x.y | ||
| − | #: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/versiones/3.15.x.y | svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y | ||
</source> | </source> | ||
| − | # | + | #:'''Importante''': en versiones nuevas de svn puede salir un error: |
| − | #: | + | #:<source lang="bash" enclose="div"> |
| − | #:<source lang=" | + | svn: E195012: Path '.' does not share common version control ancestry with the requested switch location. Use --ignore-ancestry to disable this check. |
| + | </source> | ||
| + | #:en ese caso, ejecutar el comando anterior siguiendo lo recomendado en el mensaje: | ||
| + | #:<source lang="bash" enclose="div"> | ||
| + | svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y --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="bash" 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"> | ||
| + | composer install | ||
| + | </source> | ||
| + | #:'''Verificar que el comando anterior finalice sin errores para continuar.''' | ||
| + | #'''Si se está actualizando a 3.15.1 desde 3.15.0, omitir este paso.''' | ||
| + | #:En una consola en '''<path_proyecto>/bin''' ejecutar: | ||
| + | #:<source lang="bash" enclose="div"> | ||
| + | ./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"> | ||
| + | service apache2 restart | ||
| + | </source> | ||
| + | #Regenerar la instancia Toba. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar: | ||
| + | #:<source lang="bash" enclose="div"> | ||
./toba instancia regenerar -i desarrollo | ./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 negocio | + | #Migrar la base de datos negocio. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar: |
| − | + | #:<source lang="bash" enclose="div"> | |
| − | #:<source lang=" | ||
./guarani migrar_base | ./guarani migrar_base | ||
</source> | </source> | ||
| − | #:'''Importante:''': si | + | #:'''Importante:''': si se contara con personalizaciones de base de datos, y como parte de las mismas se diera el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden aparecer errores en la migración. En ese caso, la recomendación es borrarlas, ejecutar el comando, y luego volver a crearlas. |
| − | #Compilar metadatos | + | #Compilar metadatos. Dentro de la carpeta 'bin' ('''<path proyecto Guaraní>/bin''') ejecutar: |
| − | + | #:<source lang="bash" enclose="div"> | |
| − | |||
./guarani compilar | ./guarani compilar | ||
</source> | </source> | ||
| − | + | #:Al compilar los metadatos se generará la carpeta '''<path proyecto Guaraní>/metadatos_compilados''', que no debe versionarse (''svn commit'') ya que se regenerará cada vez que se actualice la versión de producción. | |
| − | + | #Editar el archivo '''aplicacion.php''' ('''<path proyecto Guaraní>/www/aplicacion.php'''): | |
| + | ##Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados: | ||
##:<source lang="php" enclose="div"> | ##:<source lang="php" enclose="div"> | ||
define('apex_pa_metadatos_compilados', 1); | define('apex_pa_metadatos_compilados', 1); | ||
</source> | </source> | ||
| − | < | + | ##Establecer el nivel de log en un nivel razonable para producción (notice o error), descomentando y editando la siguiente línea: |
| + | ##:<source lang="php" enclose="div"> | ||
| + | define("apex_pa_log_archivo_nivel", 3); // 3: error | 5: notice | ||
| + | </source> | ||
| + | |||
[[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 10:33 16 may 2018
Actualización del SIU-Guaraní Gestión a la versión 3.15.x.y en entorno de producción
Requisitos previos a la actualización
- Haber creado la versión propia de SIU-Guaraní Gestión
Configuraciones del servidor de producción
Chequear que el servidor de producción esté configurado como se indica en esta documentación.
Actualización de la versión
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.15.x.y: por la versión propia a la que se quiere actualizar
Los pasos a realizar son:
- Verificar que se cumplan todos los requisitos técnicos de la versión.
- Realizar un backup integral de la base de datos.
- Exportar datos locales. Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani instancia_exp_local
- Apuntar el servidor de producción a la nueva versión 3.15.x.y
- Dentro de la carpeta del proyecto (<path proyecto Guaraní>) ejecutar:
- svn switch https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/versiones/3.15.x.y
- 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/versiones/3.15.x.y --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.
- Si se está actualizando a 3.15.1 desde 3.15.0, omitir este paso.
- 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 negocio. Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani migrar_base
- Importante:: si se contara con personalizaciones de base de datos, y como parte de las mismas se diera el caso de vistas que referencian a tablas (u otras vistas) que desde el SIU modificamos, pueden aparecer errores en la migración. En ese caso, la recomendación es borrarlas, ejecutar el comando, y luego volver a crearlas.
- Compilar metadatos. Dentro de la carpeta 'bin' (<path proyecto Guaraní>/bin) ejecutar:
- ./guarani compilar
- Al compilar los metadatos se generará la carpeta <path proyecto Guaraní>/metadatos_compilados, que no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice la versión de producción.
- Editar el archivo aplicacion.php (<path proyecto Guaraní>/www/aplicacion.php):
- Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados:
- define('apex_pa_metadatos_compilados', 1);
- Establecer el nivel de log en un nivel razonable para producción (notice o error), descomentando y editando la siguiente línea:
- define("apex_pa_log_archivo_nivel", 3); // 3: error | 5: notice
- Descomentar la siguiente línea para indicar que se trabajará con metadatos compilados:
