Diferencia entre revisiones de «SIU-Kolla/Version 4.3.0/actualizacion»

De SIU
Saltar a: navegación, buscar
(Pasos para la Actualización)
(Configuración adicional)
 
(No se muestran 10 ediciones intermedias de 3 usuarios)
Línea 11: Línea 11:
 
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0
 
* Actualizar desde la versión en la que se encuentra a la versión 4.1.0
 
* Actualizar desde 4.1.0 a la versión 4.3 de SIU-Kolla
 
* Actualizar desde 4.1.0 a la versión 4.3 de SIU-Kolla
<br />
 
  
 
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.
 
Los pasos para completar la actualización a 4.1.x se puede consultar en la [[SIU-Kolla/Version 4.1.0/actualizacion#Esquema de migraci.C3.B3n hasta la versi.C3.B3n 4.1.X|sección correspondiente]] de la documentación.
 
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.3.x.
 
Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.3.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.  
+
Este proceso 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, o personalizaciones que se hayan realizado en el módulo de encuestas.  
  
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. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.
  
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).
 
 
<br />
 
 
=== Librerías y módulos adicionales ===
 
=== Librerías y módulos adicionales ===
 
Al actualizar a la versión 4.3.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.
 
Al actualizar a la versión 4.3.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.
Línea 30: Línea 26:
 
* Apache 2.2.x
 
* Apache 2.2.x
 
* PHP 7.1.x a 7.2.13 (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_com_dotnet).
 
* PHP 7.1.x a 7.2.13 (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_com_dotnet).
 
  
 
==== Pasos para la Actualización ====
 
==== Pasos para la Actualización ====
Línea 42: Línea 37:
 
4. Hacer dump/backup de la base de datos de la instalación.  
 
4. Hacer dump/backup de la base de datos de la instalación.  
  
5. Configurar archivo '''instalador.env'''
+
5. Copiar el archivo '''instalador.env.dist''' y renombrar a '''instalador.env'''. En linux se puede utilizar el siguiente comando:
 +
 
 +
cp instalador.env.dist instalador.env
 +
 
 +
6. Configurar archivo '''instalador.env'''
 
* Datos de la base de negocio y de Toba tal como están en el archivo '''bases.ini''' de la instalación a actualizar
 
* Datos de la base de negocio y de Toba tal como están en el archivo '''bases.ini''' de la instalación a actualizar
 
* Datos para Toba
 
* Datos para Toba
Línea 48: Línea 47:
 
  TOBA_INSTALACION_DIR="<path del paso anterior/instalacion>"<br />
 
  TOBA_INSTALACION_DIR="<path del paso anterior/instalacion>"<br />
 
  TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br />
 
  TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"<br />
TOBA_ALIAS_NUCLEO="<alias para toba>"<br />
+
  TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias de acceso a Kolla>_toba_usuarios"</small><br />
  TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias_de_kolla>_toba_usuarios"</small><br />
+
*Datos para el smtp de mail
 +
7. Verificar que en la instalación a actualizar el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla.
  
6. Verificar que en la instalación a actualizar el archivo '''/kolla/instalacion/i__produccion/instancia.ini''' tenga el valor '''1''' en el parámetro '''usar_perfiles_propios''' para el proyecto kolla
+
8. Dar permisos de ejecución al archivo toba que se encuentra en el directorio '''bin''' del framework Toba.
 +
<...>/vendor/siu-toba/framework/bin/toba
  
7. Dar permisos de ejecución al archivo toba que se encuentra en el directorio bin del framework Toba
+
9. Ejecutar el instalador de esta manera:
/kolla/aplicacion/vendor/siu-toba/framework/bin/toba
 
 
 
8. Ejecutar el instalador de esta manera:
 
 
  ./bin/instalador proyecto:actualizar
 
  ./bin/instalador proyecto:actualizar
  
9. Revisar instalador.log para verificar que el proceso haya culminado con éxito
+
10. Revisar '''instalador.log''' para verificar que el proceso haya culminado con éxito.
 
 
10. Seguir las instrucciones que brinda el instalador para acomodar permisos crear o actualizar el link simbólico al toba.conf creado
 
 
 
11. Quitar el modo mantenimiento de la nueva instalación del proyecto
 
  
 +
11. Seguir las instrucciones que brinda el instalador para acomodar permisos crear o actualizar el link simbólico al '''toba.conf''' creado.
  
 +
12. Quitar el modo mantenimiento de la nueva instalación del proyecto.
 
==== Configuración adicional ====
 
==== Configuración adicional ====
  
 
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.
 
Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.
  
 +
1. Configurar el acceso a Habilitaciones Públicas (desde 4.3.0). Para eso, buscar el archivo '''"../kolla/instalacion/toba.conf"''' dentro de los tags '''<Directory> </Directory>''' de la sección '''#Proyecto: kolla''' se debe agregar la siguiente linea:
  
'''1)''' Ubicar el archivo '''instancia.ini''' de la instalación y realizar un backup del mismo.
+
RewriteRule ^responder(.*)$ publica.php$1 [L]
 
 
Su ubicación debería ser la siguiente:
 
<source lang="php" enclose="div">
 
<kolla>/instalacion/i__produccion/instancia.ini
 
</source>
 
 
 
 
 
'''2)''' En este archivo modificar las definiciones de '''url''' y '''path''' para '''toba_usuarios''':
 
 
 
Debe quedar de esta manera:
 
<source lang="php" enclose="div">
 
[toba_usuarios]
 
...
 
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"
 
</source>
 
 
 
 
 
'''3)''' Crear la entrada para el proyecto en '''bases.ini''':
 
 
 
<source lang="php" enclose="div">
 
[produccion toba_usuarios toba_usuarios]
 
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>
 
</source>
 
 
 
 
 
'''4)''' Realizar un backup del archivo toba.conf:
 
 
 
<source lang="php" enclose="div">
 
<kolla>/instalacion/toba.conf
 
</source>
 
 
 
 
 
'''5)''' Cargar el entorno de toba ubicado en: <kolla>/instalacion/ corriendo en Terminal el siguiente comando:
 
 
 
<source lang="php" enclose="div">
 
. entorno_toba.env
 
</source>
 
 
 
 
 
'''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:
 
 
 
<source lang="php" enclose="div">
 
toba instalacion despublicar
 
 
 
sudo /etc/init.d/apache2 restart
 
 
 
toba instalacion publicar
 
 
 
sudo /etc/init.d/apache2 restart
 
</source>
 
 
 
''De ser necesario agregue previamente permisos de ejecución (sudo chmod +x toba) al archivo: ''
 
'''<kolla>/aplicacion/vendor/siu-toba/framework/bin/toba'''
 
 
 
 
 
'''7)''' Configurar el acceso a Habilitaciones Públicas (desde 4.3.0). Para eso, buscar el archivo '''"../kolla/instalacion/toba.conf"''' dentro de los tags '''<Directory> </Directory>''' de la sección '''#Proyecto: kolla''' se debe agregar la siguiente linea:
 
 
 
<source lang="php" enclose="div">
 
RewriteRule ^responder(.*)$ publica.php$1 [L]
 
</source>
 
  
 
Luego, se debe '''reiniciar Apache''' para que esta modificación impacte correctamente.
 
Luego, se debe '''reiniciar Apache''' para que esta modificación impacte correctamente.
  
 
+
2. 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.
'''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.
 
  
 
[[Archivo:KOL_mantenimiento_V1.png]]
 
[[Archivo:KOL_mantenimiento_V1.png]]
Línea 150: Línea 78:
  
 
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 '''.<br />
 
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 '''.<br />
A partir de este momento debería ser posible acceder a SIU-Kolla v4.3.X exitosamente.
 
  
 +
3. Como parte del proceso de instalación en ocasiones surgen problemas al crear los enlaces simbólicos correspondientes a los assets y bt-assets. En caso de que esto ocurra y para recrearlos recomendamos ejecutar, situados en la carpeta www, los siguientes comandos:
  
'''9)''' El proceso de actualización desde una versión 3.X.X a 4.3.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.3.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.
+
ln -s ../vendor/components/ assets <br />
 +
ln -s ../php/extension_toba/bootstrap/assets/ bt-assets
  
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)'''
+
A partir de este momento debería ser posible acceder a SIU-Kolla v4.3.X exitosamente.
 
 
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:
 
 
 
<source lang="php" enclose="div">
 
Toba Usuarios | Menú > Servicios Web > SOAP > Servicios Ofrecidos.
 
</source>
 
 
 
Luego, desde la fila del servicio web en cuestión y en la columna '''Activo''' seleccionamos la opción '''No''' para activarlo.
 
 
 
 
 
<small>[[#Actualizar a una versión posterior|Subir]]</small>
 
------
 
<br />
 
 
 
=== 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.<br>
 
 
 
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.<br>
 
 
 
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.<br>
 
  
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:
 
* Encuestas para el seguimiento de graduados
 
* Encuestas para el acompañamiento al estudio de desgranamiento universitario
 
* Formulario de solicitudes de becas
 
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.
 
  
 
<small>[[#Actualizar a una versión posterior|Subir]]</small>
 
<small>[[#Actualizar a una versión posterior|Subir]]</small>
 
------
 
------
<br />
 
  
 
=== Personalizaciones ===
 
=== Personalizaciones ===
Línea 197: Línea 94:
 
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.
 
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.
  
Todo cambio implementado sobre el módulo SIU-Kolla no se migra automáticamente sino que va a depender pura y exclusivamente del tipo de personalización que se haya desarrollado.
+
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.  
 
 
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, como por ejemplo archivos javascript para comportamientos determinados. Estos cambios se deben reescribir para mantenerlos en la nueva versión.  
 
  
En relación a esto, el equipo de desarrollo SIU-Kolla colaborará dando el soporte necesario para evaluar la complejidad para llevar esta implementación a la versión deseada.
+
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.
  
 
<small>[[#Actualizar a una versión posterior|Subir]]</small>
 
<small>[[#Actualizar a una versión posterior|Subir]]</small>

Revisión actual del 11:21 29 oct 2020

Siu-kolla iso.png

Actualizar a una versión posterior

Esquema de migración hasta la versión 4.3.X

La actualización a la versión 4.3 requiere contar con una instalación de SIU-Kolla 4.1.0 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 4.1.0
  • Actualizar desde 4.1.0 a la versión 4.3 de SIU-Kolla

Los pasos para completar la actualización a 4.1.x se puede consultar en la sección correspondiente de la documentación. Una vez que se cuenta con la aplicación en la versión 4.1.0 o posterior, se puede actualizar a 4.3.x.

Este proceso 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, o 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. Vale aclarar que estos nombres de los esquemas son los sugeridos, pero podrían ser otros de acuerdo a lo que hayan indicado al instalar la versión existente.

Librerías y módulos adicionales

Al actualizar a la versión 4.3.x se debe tener en cuenta actualizar las siguientes librerías: Postgres, Apache y PHP.

Las versiones recomendadas son:

  • PostgresSQL 10.x a 11
  • Apache 2.2.x
  • PHP 7.1.x a 7.2.13 (con las extensiones: php_gd, php_pdo, php_pdo_pgsql, php_com_dotnet).

Pasos para la Actualización

1. Descargar el paquete de instalación del proyecto desde el Repositorio disponible en el Portal de Servicios de Comunidad). Se pueden consultar mas detalles de cómo acceder al instalador en la sección Acceso a última versión.

2. Descomprimir el archivo y copiar el directorio donde se desea realizar la actualización.

3. Ingresar al directorio y ejecutar:

composer install

4. Hacer dump/backup de la base de datos de la instalación.

5. Copiar el archivo instalador.env.dist y renombrar a instalador.env. En linux se puede utilizar el siguiente comando:

cp instalador.env.dist instalador.env

6. Configurar archivo instalador.env

  • Datos de la base de negocio y de Toba tal como están en el archivo bases.ini de la instalación a actualizar
  • Datos para Toba
TOBA_PROYECTO_DIR="<path a la carpeta en la que está el Kolla nuevo>"
TOBA_INSTALACION_DIR="<path del paso anterior/instalacion>"
TOBA_ALIAS_PROYECTO="<alias de acceso a Kolla>"
TOBA_ALIAS_TOBA_USUARIOS="<alias para toba usuarios, recomendamos <alias de acceso a Kolla>_toba_usuarios"

  • Datos para el smtp de mail

7. Verificar que en la instalación a actualizar el archivo /kolla/instalacion/i__produccion/instancia.ini tenga el valor 1 en el parámetro usar_perfiles_propios para el proyecto kolla.

8. Dar permisos de ejecución al archivo toba que se encuentra en el directorio bin del framework Toba.

<...>/vendor/siu-toba/framework/bin/toba

9. Ejecutar el instalador de esta manera:

./bin/instalador proyecto:actualizar

10. Revisar instalador.log para verificar que el proceso haya culminado con éxito.

11. Seguir las instrucciones que brinda el instalador para acomodar permisos crear o actualizar el link simbólico al toba.conf creado.

12. Quitar el modo mantenimiento de la nueva instalación del proyecto.

Configuración adicional

Una vez finalizada la actualización se deben realizar algunas configuraciones adicionales para poder acceder a la nueva versión.

1. Configurar el acceso a Habilitaciones Públicas (desde 4.3.0). Para eso, buscar el archivo "../kolla/instalacion/toba.conf" dentro de los tags <Directory> </Directory> de la sección #Proyecto: kolla se debe agregar la siguiente linea:

RewriteRule ^responder(.*)$ publica.php$1 [L]

Luego, se debe reiniciar Apache para que esta modificación impacte correctamente.

2. 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.

KOL mantenimiento V1.png


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 .

3. Como parte del proceso de instalación en ocasiones surgen problemas al crear los enlaces simbólicos correspondientes a los assets y bt-assets. En caso de que esto ocurra y para recrearlos recomendamos ejecutar, situados en la carpeta www, los siguientes comandos:

ln -s ../vendor/components/ assets 
ln -s ../php/extension_toba/bootstrap/assets/ bt-assets

A partir de este momento debería ser posible acceder a SIU-Kolla v4.3.X exitosamente.


Subir


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.

Subir


< Volver