SIU-Kolla/Version 4.1.0/actualizacion
Sumario
Actualizar a una versión posterior
Acerca de Migraciones desde Versiones Anteriores
En primer lugar y como una forma de entender la evolución del módulo de gestión de encuestas SIU-Kolla, haremos un breve repaso por las últimas versiones publicadas.
- La versión 3.1 introduce mejoras importantes respecto a la 3.0. Ésta última es la versión mas antigua de SIU-Kolla desde la cual se permite llegar a las versiones mas nuevas publicadas.
- La versión 3.1.2 surge como evolución de la 3.1.0 con el objetivo concreto de cubrir las necesidades del Relevamiento de datos censales en carreras de ingeniería. Por este motivo no se aconseja como actualización de versión.
- La versión 3.4 de SIU-Kolla además de agregar nueva funcionalidad e incluir mejoras, agrega dos características importantes: El concepto de Formulario de Encuestas y la posibilidad de vincular SIU-Kolla con sistemas externos a través de Servicios Web.
- La versión 3.5 incorpora al SIU-Kolla el concepto de Unidad de Gestión: Se introducen los Perfiles de Datos.
- La versión 3.6 realiza un cambio importante en el esquema de migración y actualización del módulo que facilita la puesta a disposición de correcciones y publicaciones. Incluye además novedades en funcionalidad, correcciones en problemas detectados y mejoras varias.
- La versión 3.7 agrega nuevas operaciones y mejoras en el módulo de encuestas. Además se suman más servicios web para ser consumidos por sistemas externos permitiendo obtener resultados de las encuestas.
- La versión 4.1 presenta una interfaz completamente renovada y optimizada para dispositivos móviles. Esta nueva interfaz facilita aún más el proceso de creación y administración de encuestas haciendo al módulo intuitivo y fácil de usar. Además se han introducido numerosas mejoras y soluciones a bugs reportados.
Esquema de migración hasta la versión 4.1.X
La actualización a la versión 4.1 requiere contar con una instalación de SIU-Kolla 3.5.2 o posterior.
Dependiendo de la versión con la que se cuente, los pasos a completar pueden ser:
- Actualizar desde la versión en la que se encuentra a la versión 3.5.2 (contemplado desde 3.0 en adelante)
- Actualizar desde 3.5.2 a la versión 4.1 de SIU-Kolla
El proceso de actualización desde 3.0 a 3.5.2 se puede consultar en la documentación correspondiente.
Una vez que se cuenta con la aplicación en la versión 3.5.2 o posterior, se puede actualizar a 4.1.X.
El instalador se encargará de realizar un backup del esquema kolla que contiene las tablas del modelo de datos de SIU-Kolla. Luego se realizan las actualizaciones correspondientes a la nueva versión.
El proceso de actualización se ocupa de actualizar la estructura de la base de datos de acuerdo al modelo de datos considerando las encuestas implementadas junto a las respuestas ya obtenidas. La migración no incluye desarrollos, por personalizaciones que se hayan realizado en el módulo de encuestas.
El esquema toba_kolla conservará los datos del framework de toba, mientras que el esquema kolla será el destinatario de todas las tablas de negocio de la aplicación SIU-Kolla. A estos esquemas se migrarán los datos del esquema pre existente en la base de datos, mientras que el esquema pre existente se conserva en la base de datos con un nuevo nombre pero no será utilizado por la nueva versión (backup).
Pasos para la Actualización
A continuación se muestran cada uno de los pasos que se deben completar para actualizar la aplicación a la última versión:
Inicio
Seleccionar la opción Actualizar una instalación existente.
Bienvenida
Seleccionar Comenzar Actualización para iniciar el proceso. El instalador irá guiando paso hasta completar la correcta actualización del módulo de encuestas.
Requisitos Previos
Seleccionando Comenzar Actualización se realiza, el control de requisitos previos. En el caso en que se necesite hacer un ajuste o cambio de configuración, el instalador dará aviso del mismo con un detalle de cómo resolver la situación.
Directorio
Una vez que se cumplen con todos los requisitos, el siguiente paso solicita indicar el directorio completo donde se encuentra actualmente la instalación. Mediante la opción Verificar Directorio, el actualizador controlará la existencia de la ruta indicada, para poder avanzar al siguiente paso.
Resguardo
En este paso se advierte sobre los cambios en la aplicación y se recomienda realizar una copia de seguridad del código, configuraciones y datos existentes:
Migración
En la pantalla siguiente se muestra un resumen de datos acerca de lo que se está por migrar. Se debe verificar la correctitud de los datos de la instalación actual. Por otra parte se solicitan datos para que el proceso de actualización pueda completar la migración en la base de datos. Para esto se requiere contar con un usuario de la base de datos con permisos de superusuario.
Seleccionando Actualizar aplicación comienza el proceso de actualización propiamente dicho. Ante cualquier problema que se detecte, se informa en este mismo paso dando detalles del error y la posibilidad de corregirlo o solicitar diagnóstico mediante la recolección de datos para poder identificar la causa del problema.
Si el proceso termina normalmente, se avanza al siguiente paso.
Es recomendable que a continuación se eliminen las copias temporales de los archivos de la aplicación y datos de usuario que el instalador genera. Se aconseja por motivos de seguridad que una vez comprobado el correcto funcionamiento de la aplicación también se elimine el instalador, ya que de otra manera quedará accesible para cualquier usuario.
Al completar el proceso de actualización es posible que se muestre una serie de warnings relacionados a la migración de ciertos perfiles de usuarios. Estas modificaciones se presentan a partir de la versión 4.1.0 en adelante, por lo que no representan un problema sino únicamente notifican de ciertos cambios a nivel backend de perfiles funcionales.
Se podrá considerar la actualización como exitosa.
Configuración adicional
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.
1) Ubicar el archivo instancia.ini de la instalación y realizar un backup del mismo.
Su ubicación debería ser la siguiente:
2) En este archivo modificar las definiciones de url y path para toba_usuarios:
Debe quedar de esta manera:
...
url = "<url del servidor host para la instalación>/kolla_toba_usuarios"
path = "<directorio de la instalación>/kolla/aplicacion/vendor/siu-toba/framework/proyectos/toba_usuarios"
3) Crear la entrada para el proyecto en bases.ini:
motor = <idem al que figure en la entrada toba_kolla>
profile = <idem al que figure en la entrada toba_kolla>
puerto = <idem al que figure en la entrada toba_kolla>
usuario = <idem al que figure en la entrada toba_kolla>
clave = <idem al que figure en la entrada toba_kolla>
base = <idem al que figure en la entrada toba_kolla>
schema = <idem al que figure en la entrada toba_kolla>
encoding = <idem al que figure en la entrada toba_kolla>
4) Realizar un backup del archivo toba.conf:
5) Cargar el entorno de toba ubicado en: <kolla>/instalacion/ corriendo en Terminal el siguiente comando:
6) Despublicar y publicar nuevamente la instalación, reiniciando el servidor Apache, para ir aplicando los cambios. Para ello, se deben ejecutar los siguientes comandos en Terminal:
sudo /etc/init.d/apache2 restart
toba instalacion publicar
sudo /etc/init.d/apache2 restart
De ser necesario agregue previamente permisos de ejecución (sudo chmod +x toba) al archivo: <kolla>/aplicacion/vendor/siu-toba/framework/bin/toba
7) Verificar que se sea posible acceder correctamente a la nueva versión del módulo.
8) Una vez finalizada al actualización de la aplicación, se debe tener presente que la misma queda en Modo Mantenimiento, para permitirle a quien esté llevando adelante estas tareas, concluir con los detalles de configuración, evitando que a la vez cualquier usuario del módulo acceda al mismo en esos momentos.
Para sacar la aplicación del Modo Mantenimiento, se debe acceder al archivo proyecto.ini, identificar la entrada modo_mantenimiento, y setear el valor a 0 .
A partir de este momento debería ser posible acceder a SIU-Kolla v4.1.X exitosamente.
9) El proceso de actualización desde una versión 3.X.X a 4.1.X puede presentar inconvenientes con el vínculo entre Apache y los directorios de SIU-Kolla y Toba Usuarios. En caso de que surgan errores al intentar acceder a la nueva versión del módulo se puede deber a lo siguiente: el instalador de la versión 4.1.X cuenta con la tecnología Composer, la cual plantea una nueva dinámica entre Apache y SIU-Kolla. Para solventar posibles errores es necesario realizar ajustes correspondientes para que Apache apunte correctamente a SIU-Kolla y a Toba Usuarios.
Esto debería regularizarse con el procedimiento de Despublicación y Publicación de la instalación descrito en el paso 6). En caso de persistir algún tipo de error, se deberá chequear que el contenido del archivo kolla.conf ubicado en la carpeta sites-enabled de Apache (/etc/apache2) debe tener el mismo contenido que el archivo toba.conf ubicado en la carpeta de instalación de SIU-Kolla (/directorio de instalación/kolla/instalacion)
De esta manera, nos aseguraremos que Apache está apuntando a los directorios de SIU-Kolla correctos para completar el proceso de carga del módulo y del entorno Toba Usuarios.
10) Se deben volver a activar los servicios web, ya que por motivos de seguridad luego de una actualización del sistema los servicios web ofrecidos se desactivan. Para ello, se debe acceder a:
Luego, desde la fila del servicio web en cuestión y en la columna Activo seleccionamos la opción No para activarlo.
Migración de Encuestas Precargadas
La migración de dichas encuestas se realizó teniendo en cuenta fundamentalmente dos cosas: Garantizar el correcto uso y reservar de los identificadores de las mismas.
Por otro lado, se controla que las encuestas pre cargadas de SIU-Kolla no se puedan modificar, ya que se tratan de modelos propuestos por comités de usuarios que han estudiado cada tema y elaborado las encuestas presentadas.
Estas encuestas se pueden usar tal como están definidas o pueden ser tomadas como base para crear nuevas encuestas. En ningún caso se las puede modificar.
Por todo esto, en las versiones 3.1.2 y anteriores, si alguna de las encuestas pre-cargadas tuviera habilitaciones, el proceso de migración debe asumir que son nuevas encuestas ya que no se puede prever si las mismas sufrieron modificaciones. Por este motivo al migrar esas encuestas se crean como nuevas, con identificadores dentro del rango liberado.
El módulo de gestión de encuestas SIU-Kolla presenta un conjunto de encuestas pre-definidas:
- Encuesta al recién graduado
- Encuesta al año de graduado
- Encuesta a los 5 años de graduado
Para la definición de estas encuestas y todas las que se vayan a incorporar en sucesivas versiones de SIU-Kolla hay un conjunto de IDs reservados para los distintos componentes involucrados en las definiciones de encuestas.
Personalizaciones
Es importante destacar que este tipo de personalización nada tiene que ver con la personalización de proyectos que propone el framework SIU-Toba, sino que son modificaciones de código que se realizan fuera ese esquema.
Para el caso de las encuestas que se hayan implementado, cuando se actualiza SIU-Kolla se migrarán todas las encuestas, sin incluir las modificaciones que se les haya hecho a las mismas modificando el código fuente, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión.
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente y la complejidad de la migración de estos cambios dependerá del tipo de personalización que se haya desarrollado quedando a cargo de la Institución que lo haya realizado.
