Actualizar de 2.2 a 2.3

Esta versión de Usuarios, presenta pocos cambios en el proyecto a nivel de configuración. A continuación se describen los pasos típicos para realizar la actualización de versión.

NO OLVIDE REALIZAR UNA COPIA DE SEGURIDAD DE LA APLICACIÓN Y LAS BASES DE DATOS ANTES DE CONTINUAR

Consideraciones iniciales

Es necesario contar con una instalación de SIU-Araí: Usuarios en la versión 2.2. Se debe tener en cuenta que el proceso de actualización es realizado como una nueva instalación. Esto quiere decir que trabaja sobre una rama de código fuente paralela a la existente. Se supone entonces, que tanto la instalación existente como la nueva versión se clonaron desde hub.siu.edu.ar.

Requerimientos

La versión 2.3 mantiene los requerimientos mínimos iniciales de la versión anterior:

• PHP requerido en versión 7.1 únicamente
• PostgreSQL requerido en versión mínima 9.6 y máxima 10

Para mayores detalles ver los requerimientos para la instalación

Ajustes previos

Es necesario realizar una serie de ajustes mínimos pero obligatorios a la instalación existente de SIU-Araí: Usuarios, de modo que al momento de su actualización no se produzcan inconvenientes.

1. Permisos del proyecto

   Es de suma importancia que el usuario con el que se vaya a realizar la actualización posea permisos de acceso a todos los archivos de la instalación. Para ello podemos ejecutar:

    sudo ./bin/instalador permisos:simple
   

2. Poner en modo En mantenimiento

   Para iniciar la actualización, es necesario evitar que tanto los usuarios como aplicaciones accedan por un momento a la instalación del sistema. Para ello podemos ejecutar el comando

    ./bin/instalador instalacion:modo-mantenimiento
   

   Recuerde, tanto el IDP como el IDM deben quedar en mantenimiento, por lo que se deben procurar los mecanismos adicionales para evitar el acceso de autenticación (como ser vía SAML, api REST y/o LDAP).

Actualización

1. Actualizar el código fuente

   Como la actualización se realiza sobre una nueva instalación, la forma recomendada es simplemente descargar en paralelo el código fuente de la nueva versión. Se debe proceder a descargar desde hub.siu.edu.ar de la siguiente forma:

    git clone --branch v2.3.0 https://hub.siu.edu.ar/siu-arai/arai-usuarios.git 2.3
   

   En general, la versión a descargar es la última estable de la rama 2.3

2. Descargar las librerías del proyecto

   Como las librerías del proyecto se gestionan de forma individual, es necesario volver a ejecutar la descarga de las mismas. Para ello se debe realizar:

    composer install --no-dev --prefer-dist
   

3. Actualizar las variables de entorno

   Podremos copiar del archivo arai-usuarios.env de la instalación existente a la nueva ruta (tener en cuenta cambiar las variables como ARAI_USUARIOS_DIR para evitar grandes conflictos). Por otro lado, si lo deseamos, podemos comenzar a configurar de cero las variables de entorno arrancando sin un archivo de variables, para ello se debe ejecutar:

    ./bin/instalador proyecto:definir-variables
   

   De todas formas, se podría cambiar información de manera consistente. Luego, si queremos corroborar que todo se encuentre en armonía, es necesario ejecutar el comando de verificación de la siguiente manera:

    ./bin/instalador proyecto:verificar --instalacion-anterior /ruta/arai-usuarios/2.2
   

   Recordar que se tiene que indicar en --instalacion-anterior la ruta a donde tengamos la instalación previa

4. Actualizar el proyecto

   El siguiente paso es la actualización propiamente dicha de la configuración del proyecto así como de la estructura de la base de datos. Para ello, se debe ejecutar el siguiente comando:

    ./bin/instalador proyecto:actualizar --instalacion-anterior /ruta/arai-usuarios/2.2
   

   Recordar que se tiene que indicar en --instalacion-anterior la ruta a donde tengamos la instalación previa

Ajustes posteriores

1. Corregir los permisos de la instalación

   El último paso consiste en corregir los permisos de los archivos del proyecto.

    sudo ./bin/instalador permisos:simple
   

   Recordar que este comando asigna un esquema de permisos simple, basado en usuario:grupo

2. Actualizar en SIU-Araí: Registry

   Una vez instalada la aplicación, se debe notificar a Registry de la actualización. Simplemente se debe realizar la sincronización ejecutando el siguiente comando:

    ./bin/arai-cli registry:sync --aceptar-pedidos-acceso
   

   A partir de la versión 2.6.0 del cliente AraiCli) no acepta por defecto los consumos de clientes de nuestros servicios. Es necesario autorizarlos explícitamente.

3. Salir de modo En mantenimiento

   Una vez finalizada la actualización, podemos volver a activar el sistema o sacarlo de mantenimiento. Para ello podemos ejecutar el comando

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