SIU-Tehuelche/version 4.0/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.0 nos situaremos en ./siu/tehuelche para realizar el proceso de actualización.


1) Copiar el código fuente de la nueva versión desde el repositorio. Para esto utilizamos el comando clone de Git de las siguiente manera:

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

Notaremos que este primer paso del proceso de actualización (la copia del código fuente desde el repositorio) creará un nuevo directorio "4.0.1" que convivirá junto al directorio de la versión base. Dentro del mismo se encontrarán todos los archivos necesarios para la actualización del módulo.


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

composer install


3) Configurar el archivo de instalación/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.0.1/" ---> directorio del proyecto (paso 1)
  • TOBA_INSTALACION_DIR="./siu/tehuelche/4.0.1/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
  • Es importante que las variables PROYECTO_DB_SCHEMA y TOBA_DB_SCHEMA este configurada con el valor tehuelche. Caso contrario fallará el proceso de actualización.


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

bin/instalador proyecto:actualizar


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

  • Es muy probable que haya configuraciones del archivo /etc/php/7.1/cli/php.ini que nos informe el instalador que debemos modificar.


6) 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


7) 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


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

sudo bin/instalador permisos:simple


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

sudo service apache2 reload


10) 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


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


< Volver