SIU-Tehuelche/version 4.2/actualizacion

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.2.0 creamos la carpeta para la nueva instalación dentro de la carpeta tehuelche, obteniendo de esta manera /siu/tehuelche/4.2.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.2.x https://hub.siu.edu.ar/siu/tehuelche.git .

2) Ingresaremos al directorio creado y realizaremos la instalación de dependencias mediante Composer:

composer install

3) Realizar siempre un backup de la base de datos de la instalación.

4) Configurar el archivo de actualización. Dentro de la carpeta de instalación se encuentra el archivo instalador.env.dist. Debemos copiar este y renombrarlo como instalador.env. Una vez hecho esto, podemos editar este nuevo archivo de configuración, ingresando los valores que deseamos utilizar en la actualización.

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.2.x/" ---> directorio del proyecto (paso 1)
• TOBA_INSTALACION_DIR="./siu/tehuelche/4.2.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

5) Verificar que en la instalación a actualizar el archivo /siu/tehuelche/4.0.1/instalacion/i__produccion/instancia.ini (si tomamos el ejemplo mencionado anteriormente) tenga el valor 1 en el parámetro usar_perfiles_propios para el proyecto tehuelche.

6) Correr el actualizador del proyecto. Para esto ejecutamos el siguiente comando:

bin/instalador proyecto:actualizar

Observación: Durante la actualización, al finalizar el paso 8 (Actualizar proyecto) puede suceder que arroje el siguiente mensaje de error:

[ERROR] No se pudo generar el autoload porque existen clases repetidas.

El mismo, no representa un error en sí mismo y es posible seguir adelante sin ningún problema.

7) Verificar posibles errores o warnings que haya arrojado el instalador y corregirlos

• Es muy probable que haya configuraciones del archivo /etc/php/<versión PHP>/cli/php.ini que nos informe el instalador que debemos modificar.

8) Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):

cp www/img/iso_tehuelche.png www/siu/manejador_salida_bootstrap/img/logo-iso.png

9) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:

sudo bin/instalador permisos:simple

10) Correr el comando para incorporar el link simbólico. El instalador indicará en pantalla un comando similar al siguiente, que deberemos ejecutar (notar que ruta_a_la_instalación dependerá de la instalación puntual realizada):

sudo ln -s /ruta_a_la_instalacion/instalacion/toba.conf /etc/apache2/sites-enabled/tehuelche.conf

11) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:

sudo service apache2 reload

12) Quitar el modo mantenimiento al sistema. Para llevar a cabo esto tenemos dos opciones:

• Es posible editar el archivo proyecto.ini y asignar cero a la variable modo_mantenimiento.
• Otra opción es utilizar el siguiente comando del instalador:

bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento

12) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación instalador.env.

< Volver