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 nueva 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 nucleo_xxx
   cd nucleo_xxx
   Descargar las dependencias mediante Composer
    composer install --no-dev
4. Configuración de la instalación
   Hay que definir muchas variables para completar la instalación. No hay que preocuparse si hay algo mal definido ya que todo lo que se define acá puede ser modificado luego a través de archivos de configuración de SIU-Sanavirón-Quilmes. Para mayor comodidad, se entrega un archivo instalador.env de variables de entorno listo para ser completado. En la página Variables de entorno para la instalación del se explica en detalle cada una. El instalador dispone de un comando para inicializar el archivo de variables de entorno:
    ./bin/instalador proyecto:definir-variables
   Esto creará el archivo en la raíz del proyecto, el cual debe ser editado según las necesidades. Una vez editado el archivo, se puede proceder a realizar la instalación de SIU-Sanaviron-Quilmes: Núcleo
   Nota: Muchas de las configuraciones se podrán obtener desde la instalación anterior dentro de la carpeta config (bases.ini, sq.ini).
5. 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.
   El instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización:
   ./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
6. 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
7. 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
8. 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.
9. 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.

SQ Académico

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 'academico/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_uv]
   path = "/ruta_instalacion_a_academico/toba"
   url = "/sq_academico"
   full_url = "http://localhost/sq_academico"
   url_pers = "/sq_academico_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 nueva 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/academico.git academico_xxx
   cd academico_xxx
   Descargar las dependencias mediante Composer
    composer install --no-dev
4. Configuración de la instalación
   Hay que definir muchas variables para completar la instalación. No hay que preocuparse si hay algo mal definido ya que todo lo que se define acá puede ser modificado luego a través de archivos de configuración de SIU-Sanavirón-Quilmes. Para mayor comodidad, se entrega un archivo instalador.env de variables de entorno listo para ser completado. En la página Variables de entorno para la instalación del se explica en detalle cada una. El instalador dispone de un comando para inicializar el archivo de variables de entorno:
    ./bin/instalador proyecto:definir-variables
   Esto creará el archivo en la raíz del proyecto, el cual debe ser editado según las necesidades. Una vez editado el archivo, se puede proceder a realizar la instalación de SIU-Sanaviron-Quilmes: Académico
   Nota: Muchas de las configuraciones se podrán obtener desde la instalación anterior dentro de la carpeta config (bases.ini, sq.ini).
5. 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.
   El instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización:
   ./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
6. 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
7. 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
8. 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/academico/config/toba.conf /etc/apache2/sites-enabled/sq_academico.conf
   Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
9. 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-Académico abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/sq_academico.

SQ G.C.O.

1. 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.
2. Descarga de fuentes.
   Posicionarse en la ubicación deseada para la nueva 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/gco.git gco_xxx
   cd gco_xxx
   Descargar las dependencias mediante Composer
    composer install
3. Configuración de la instalación
   Hay que definir muchas variables para completar la instalación. No hay que preocuparse si hay algo mal definido ya que todo lo que se define acá puede ser modificado luego a través de archivos de configuración de SIU-Sanavirón-Quilmes. Para mayor comodidad, se entrega un archivo instalador.env de variables de entorno listo para ser completado. En la página Variables de entorno para la instalación del se explica en detalle cada una. El instalador dispone de un comando para inicializar el archivo de variables de entorno:
    ./bin/instalador proyecto:definir-variables
   Esto creará el archivo en la raíz del proyecto, el cual debe ser editado según las necesidades. Una vez editado el archivo, se puede proceder a realizar la instalación de SIU-Sanaviron-Quilmes: G.C.O.
   Nota: Muchas de las configuraciones se podrán obtener desde la instalación anterior dentro de la carpeta config (config.ini).
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.
   El instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización:
   ./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
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/gco/config/alias.conf /etc/apache2/sites-enabled/sq_gco.conf
   Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

SQ Pagos

1. Descarga de fuentes.
   Posicionarse en la ubicación deseada para la nueva 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/sq_pagos.git sq_pagos_xxx
   cd sq_pagos_xxx
2. Configuración de la instalación
   Editar el archivo config/angular-config.json:
   {
           "entorno": "desarrollo",
           "desarrollo": {
                   "config": {
                           "api_backend_url": "http://localhost/sq_pagos_backend/",
                           "titulo": "Universidad de prueba :: Plataforma de pagos :: SIU­-Sanaviron-Quilmes"
                   }
           },
           "produccion": {
                   "config": {
                           "api_backend_url": "http://sq_server.edu.ar/sq_pagos_backend/",
                           "titulo": "Universidad de prueba :: Plataforma de pagos :: SIU­-Sanaviron-Quilmes"
                   }
           }
   }
3. Instalar el sistema
   
   export NODE_VERSION=4.5.0
   export NVM_DIR=/home/node/.nvm
   git clone https://github.com/creationix/nvm.git ~/.nvm && cd ~/.nvm && git checkout `git describe --abbrev=0 --tags`
   . ~/.nvm/nvm.sh && nvm install $NODE_VERSION
   echo ". ~/.nvm/nvm.sh" >> ~/.bashrc
   . ~/.nvm/nvm.sh && nvm use $NODE_VERSION
   npm install --unsafe-perm
4. Configurar el servidor web Apache
   
   ln -s ./config/sq_pagos.conf /etc/apache2/sites-enabled/sq_pagos.conf
   Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache
    sudo a2enmod rewrite
    sudo service apache2 restart