SIU-Sanaviron-Quilmes/version1.2.0/actualizar sq

Esquema de actualización de SIU-Sanavirón-Quilmes

Recomendaciones previas a la actualización

Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.

Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.

SQ Núcleo

1. Verificar configuración de la instancia de la instalación anterior.
   Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo 'nucleo/config/i__produccion/instancia.ini' y dentro de este verificar si esta configurado el parámetro 'usar_perfiles_propios = "1"' el cual es necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.
   [sq_nucleo]
   path = "/ruta_instalacion_a_nucleo/toba"
   url = "/sq_nucleo"
   full_url = "http://localhost/sq_nucleo"
   url_pers = "/sq_nucleo_pers/"
   usar_perfiles_propios = "1"
2. Verificar permisos de lectura y escritura de la instalación anterior.
   Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-SQ anterior.
   El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.
3. Descarga de fuentes.
   Posicionarse en la ubicación deseada para la instalación del proyecto:
   cd /usr/local/proyectos/sanaviron_quilmes/
   El proyecto está disponible en https://hub.siu.edu.ar
   git clone https://hub.siu.edu.ar/sanaviron-quilmes/nucleo.git
   cd nucleo
   Descargar las dependencias mediante Composer
    composer install --no-dev
4. Actualización de una instalación.
   Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en Recomendaciones previas actualización. Para realizar una actualización, es necesario iniciar una instalación en modo producción. El instalador no soporta actualizaciones de instalaciones en entorno de desarrollo. Una vez realizado lo explicado en el ítem de Pasos previos a un proceso de instalación, y luego de chequear los requerimientos previos a la actualización, el instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización:
   ./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
   Una vez ejecutado el comando de actualización, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado Post actualización
5. Verificar archivo de log del instalador.
   El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla. Una de las alternativas para visualizar el archivo de log es de la siguiente manera: :
   less instalador.log
6. Modificar permisos.
   Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración. Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.
   Ejecute el siguiente comando como superusuario:
   sudo ./bin/instalador permisos:simple
   Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:
   sudo ./bin/instalador permisos:simple -U usuario -W www-data
7. Configuración del servidor de aplicaciones.
   Para la configuración del servidor web les proponemos las siguientes opciones. Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:
   ln -s /ruta_instalacion/nucleo/config/toba.conf /etc/apache2/sites-enabled/sq_nucleo.conf
   Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
8. Activar el sistema.
   Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando:
   ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento

Finalmente, podrá acceder al sistema SIU-SQ-Núcleo abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/sq_nucleo.