SIU-Tehuelche/version 4.3/actualizacion

De SIU
Saltar a: navegación, buscar

Proceso de Actualización

El proceso de actualización del módulo mantiene la versión base en su directorio original, pero en modo mantenimiento, para proceder a instalar la nueva versión, migrar su contenido y apuntar a la base de datos en uso. Para este proceso, entonces, se sugiere situarse en el mismo nivel en el que se encuentra el directorio de la instalación de la versión base a ser actualizada.

  • Ejemplo: si el directorio de la versión base es /siu/tehuelche/4.0.1 nos situaremos en /siu/tehuelche para realizar el proceso de actualización.


1. Primeramente vamos a crear la carpeta para la nueva versión del módulo. Entonces, siguiendo el ejemplo anterior y suponiendo que deseamos actualizar el módulo desde la versión 4.0.1 a 4.3.0 creamos la carpeta para la nueva instalación dentro de la carpeta tehuelche, obteniendo de esta manera /siu/tehuelche/4.3.0. Luego, debemos copiar el código fuente desde el repositorio, para esto nos situamos dentro de la carpeta recién creada y utilizamos el comando clone de Git de las siguiente manera:

git clone --branch 4.3.x https://hub.siu.edu.ar/siu/tehuelche.git .

2. Nos posicionamos en el directorio creado y realizaremos la instalación de dependencias mediante Composer:

composer install --no-dev

3. Realizar siempre un backup de la base de datos de la instalación. El instalador sugiere el comando pg_dump.

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

cp -a instalador.env.dist instalador.env

5. Configurar archivo instalador.env

Por ejemplo, algunos valores que pueden ser de interés modificar para personalizar la instalación son:

  • PROYECTO_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar
  • TOBA_DB_DBNAME="xxx" ---> nombre de la base de datos de la versión que deseamos actualizar
  • TOBA_URL_BASE="http://url" ---> URL base de acceso al servidor
  • TOBA_USUARIO="usuario" ---> usuario para primer acceso a la nueva versión del módulo
  • TOBA_PASSWORD="contraseña1234" ---> contraseña del usuario para primer acceso a la nueva versión del módulo
  • TOBA_PROYECTO_DIR="./siu/tehuelche/4.3.x/" ---> directorio del proyecto (paso 1)
  • TOBA_INSTALACION_DIR="./siu/tehuelche/4.3.x/instalacion" ---> directorio de la instalación de la nueva versión (URL anterior adicionando /instalacion)
  • TOBA_ALIAS_PROYECTO="/xxx" ---> alias de acceso al módulo (este alias se adicionará a la URL base del servidor)
  • TOBA_ALIAS_NUCLEO="/alias_proyecto_kolla" ---> reemplazar "alias" por el designado anteriormente
  • TOBA_ALIAS_TOBA_USUARIOS="/alias_toba_usuarios" ---> reemplazar "alias" por el designado anteriormente

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

chmod +x vendor/siu-toba/framework/bin/toba

7. Ejecutar el instalador de la siguiente manera:

./bin/instalador proyecto:actualizar

8. Revisar instalador.log para verificar que el proceso haya culminado con éxito. Si se quiere seguir el log del proceso de instalación, en otra terminal ejecutar:

tail -f instalador.log

9. Seguir las instrucciones que brinda el instalador para:

  • Acomodar permisos de archivos y direcotorios
sudo ./bin/instalador permisos:simple
  • Configurar el servidor web (crear el enlace simbólico al toba.conf del proyecto)
  • Quitar el modo mantenimiento del proyecto
 ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento

10. Reiniciar el servidor web para que tome los nuevos cambios.

< Volver