SIU-Tehuelche/version 4.1/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) 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:
Notaremos que este primer paso del proceso de actualización (la copia del código fuente desde el repositorio) creará un nuevo directorio "4.1.0" 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:
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.1.0/" ---> directorio del proyecto (paso 1)
- TOBA_INSTALACION_DIR="./siu/tehuelche/4.1.0/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) Correr el actualizador del proyecto. Para esto ejecutamos el siguiente comando:
6) 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.
7) 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):
8) Ejecutar un comando de copiado. Simplemente correr el siguiente comando (dentro de la raíz de la instalación):
9) Cambiar los permisos de la instalación realizada. Utilizamos el siguiente comando del instalador:
10) Volver a cargar apache para que tomen efectos los cambios incorporados: Corremos el siguiente comando:
11) 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:
12) Ingresar al sistema. Para esto utilice el usuario y contraseña definidos en el archivo de configuración de instalación instalador.env.
