Diferencia entre revisiones de «SIU-Sanaviron-Quilmes/version1.2.0/actualizar sq»

De SIU
Saltar a: navegación, buscar
 
(→‎Recomendaciones previas a la actualización)
 
(No se muestran 40 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
 
[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version1.2.0]]
 
[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version1.2.0]]
  
−
== Esquema de actualización de SIU-Sanavirón-Quilmes ==
+
= Esquema de actualización de SIU-Sanavirón-Quilmes =
−
Antes de realizar cualquier acción, se debe controlar que se cumplan los [[SIU-Sanaviron-Quilmes/version1.2.0/instalacion_desde_cero/requisitos_previos/linux|requisitos previos]].<br>
 
−
Para ver el detalle de los pasos a realizar en cada acción, se debe hacer click en el recuadro correspondiente.
 
  
−
<imagemap>
+
<div class="noautonum">__TOC__</div>  
−
Image:SQ - Instalacion actualizacion.png
 
−
rect 302 71 1246 121 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Desactivaci.C3.B3n_de_componentes_para_la_actualizaci.C3.B3n|Prueba]]
 
−
rect 303 152 456 656 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Actualizaci.C3.B3n_del_N.C3.BAcleo|Actualizar Nucleo]]
 
−
rect 495 153 645 657 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Actualizar_Unidad_de_venta|Actualizar Unidad de Ventas]]
 
−
rect 695 287 847 458 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Actualizar_el_Gateway_de_cobros_Online_.28GCO.29|Actualizar Gateway de cobros online]]
 
−
rect 893 286 1247 393 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Actualizar_SQ_Pagos|Actualizar SQ Pagos]]
 
−
rect 302 705 1246 744 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Activaci.C3.B3n_final_de_componentes|Activar componentes]]
 
−
rect 302 771 646 812 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Activar_los_Workers|Iniciar workers]]
 
−
</imagemap>
 
−
<br />
 
  
−
<div>__TOC__</div>
+
== Recomendaciones previas a la actualización ==
  
−
== Desactivación de componentes para la actualización ==
+
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.
  
−
En este momento vamos a desactivar todos los componentes del módulo SIU-Sanaviron-Quilmes. De esta manera evitamos que se generen inconsistencias y pérdidas de datos.
+
<source lang="bash" enclose="div">
 +
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.
 +
</source>
  
−
<big>Desactivar los Workers</big>
+
=== SQ Núcleo ===
  
−
Ejecutar en la consola:
+
#'''Verificar configuración de la instancia de la instalación anterior.'''<br />Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '<nowiki/>'''nucleo/config/i__produccion/instancia.ini'<nowiki/>''' y dentro de este verificar si esta configurado el parámetro '<nowiki/>'''usar_perfiles_propios = "1"'<nowiki/>''' el cual es necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación. <source lang="bash" enclose="div">
−
<source lang="php" enclose="div"> kill -9 $(cat unidad-venta/config/scheduler_squnidadventa.pid)
+
[sq_nucleo]
−
kill -9 $(cat unidad-venta/config/workers_squnidadventa.pid)
+
path = "/ruta_instalacion_a_nucleo/toba"
−
kill -9 $(cat nucleo/config/scheduler_sqnucleo.pid)
+
url = "/sq_nucleo"
−
  kill -9 $(cat nucleo/config/workers_sqnucleo.pid)
+
full_url = "http://localhost/sq_nucleo"
 +
url_pers = "/sq_nucleo_pers/"
 +
usar_perfiles_propios = "1"
 +
</source>
 +
#'''Verificar permisos de lectura y escritura de la instalación anterior.'''<br />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. <source lang="bash" enclose="div">
 +
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.
 +
</source>
 +
#'''Descarga de fuentes.'''<br />Posicionarse en la ubicación deseada para la nueva instalación del proyecto:<source lang="php" enclose="div">cd /usr/local/proyectos/sanaviron_quilmes/</source>El proyecto está disponible en [https://hub.siu.edu.ar/SIU https://hub.siu.edu.ar]<syntaxhighlight lang="bash" enclose="div">
 +
git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/nucleo.git nucleo_xxx
 +
cd nucleo_xxx
 +
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install --no-dev </source>
 +
#'''Configuración de la instalación'''<br />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 [[SIU-Sanaviron-Quilmes/version1.2.0/variables.de.entorno.para.la.instalacion|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:<source lang="php" enclose="div"> ./bin/instalador proyecto:definir-variables  </source>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<br />'''Nota:''' Muchas de las configuraciones se podrán obtener desde la instalación anterior dentro de la carpeta '''config''' (bases.ini, sq.ini).
 +
#'''Actualización de una instalación.'''<br />Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]].<br />El instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización: <source lang="bash" enclose="div">
 +
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
 +
</source>
 +
#'''Verificar archivo de log del instalador.'''<br />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: :<source lang="bash" enclose="div">
 +
less instalador.log </source>
 +
#'''Modificar permisos.'''<br />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.<br />Ejecute el siguiente comando como superusuario: <source lang="bash" enclose="div">
 +
sudo ./bin/instalador permisos:simple
 +
</source> 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: <source lang="bash" enclose="div">
 +
sudo ./bin/instalador permisos:simple -U usuario -W www-data
 +
</source>
 +
#'''Configuración del servidor de aplicaciones.'''<br />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: <source lang="bash" enclose="div">
 +
ln -s /ruta_instalacion/nucleo/config/toba.conf /etc/apache2/sites-enabled/sq_nucleo.conf   
 +
</source>  Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
 +
#'''Activar el sistema.'''<br />Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando: <source lang="bash" enclose="div">
 +
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 
</source>
 
</source>
  
 +
Finalmente, podrá acceder al sistema SIU-SQ-Núcleo abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/sq_nucleo.
  
−
<big> Editar el archivo nucleo/toba/proyecto.ini</big>
+
=== SQ Académico ===
−
<source lang="php" enclose="div"> modo_mantenimiento = 1 </source>
 
−
<big> Editar el archivo unidad-venta/toba/proyecto.ini</big>
 
−
<source lang="php" enclose="div"> modo_mantenimiento = 1 </source>
 
−
<big> Desactivar el servicio de Apache de todos los componentes</big>
 
−
<source lang="php" enclose="div"> sudo /etc/init.d/apache2 stop </source>
 
−
(Si el núcleo, la unidad de venta, GCO y SQ-Pagos están en servidores separados desactivar los servicios de Apache en todos)
 
  
−
<br />
+
#'''Verificar configuración de la instancia de la instalación anterior.'''<br />Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '<nowiki/>'''academico/config/i__produccion/instancia.ini'<nowiki/>''' y dentro de este verificar si esta configurado el parámetro '<nowiki/>'''usar_perfiles_propios = "1"'<nowiki/>''' el cual es necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación. <source lang="bash" enclose="div">
 +
[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"
 +
</source>
 +
#'''Verificar permisos de lectura y escritura de la instalación anterior.'''<br />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. <source lang="bash" enclose="div">
 +
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.
 +
</source>
 +
#'''Descarga de fuentes.'''<br />Posicionarse en la ubicación deseada para la nueva instalación del proyecto:<source lang="php" enclose="div">cd /usr/local/proyectos/sanaviron_quilmes/</source>El proyecto está disponible en [https://hub.siu.edu.ar/SIU https://hub.siu.edu.ar]<syntaxhighlight lang="bash" enclose="div">
 +
git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/academico.git academico_xxx
 +
cd academico_xxx
 +
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install --no-dev </source>
 +
#'''Configuración de la instalación'''<br />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 [[SIU-Sanaviron-Quilmes/version1.2.0/variables.de.entorno.para.la.instalacion|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:<source lang="php" enclose="div"> ./bin/instalador proyecto:definir-variables  </source>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<br />'''Nota:''' Muchas de las configuraciones se podrán obtener desde la instalación anterior dentro de la carpeta '''config''' (bases.ini, sq.ini).
 +
#'''Actualización de una instalación.'''<br />Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]].<br />El instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización: <source lang="bash" enclose="div">
 +
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
 +
</source>
 +
#'''Verificar archivo de log del instalador.'''<br />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: :<source lang="bash" enclose="div">
 +
less instalador.log </source>
 +
#'''Modificar permisos.'''<br />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.<br />Ejecute el siguiente comando como superusuario: <source lang="bash" enclose="div">
 +
sudo ./bin/instalador permisos:simple
 +
</source> 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: <source lang="bash" enclose="div">
 +
sudo ./bin/instalador permisos:simple -U usuario -W www-data
 +
</source>
 +
#'''Configuración del servidor de aplicaciones.'''<br />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: <source lang="bash" enclose="div">
 +
ln -s /ruta_instalacion/academico/config/toba.conf /etc/apache2/sites-enabled/sq_academico.conf   
 +
</source>  Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
 +
#'''Activar el sistema.'''<br />Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando: <source lang="bash" enclose="div">
 +
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 +
</source>
  
−
== Actualización del Núcleo ==
+
Finalmente, podrá acceder al sistema SIU-SQ-Académico abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/sq_academico.
  
−
<big> Iniciar el entorno para utilizar los comandos: </big>
+
=== SQ G.C.O. ===
−
<source lang="php" enclose="div"> source config/entorno_toba.env  </source>
 
−
<big> Exportar los usuarios y grupos de acceso existentes en la instalación:</big>
 
−
<source lang="php" enclose="div">toba instancia exportar -i desarrollo  </source>
 
−
<big> Generar Backup del sistema de archivos y las bases de datos (sq_nucleo y toba)</big>
 
−
Para el backup de las bases de datos utilizar el comando:
 
−
<source lang="php" enclose="div"> pg_dump -Uuser -hhost -pport nombre_de_base > archivo_backup.sql  </source>
 
  
−
Si tienen fixes aplicados y estos están incorporados a la nueva versión se deben eliminar de la siguiente forma (excepto carpeta config):
+
#'''Verificar permisos de lectura y escritura de la instalación anterior.'''<br />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. <source lang="bash" enclose="div">
−
<source lang="php" enclose="div"> git checkout <ruta_archivo_modificado> </source>
+
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.
−
<big> Actualizar la instalación vía Git:</big>
+
</source>
−
<source lang="php" enclose="div"> git pull origin master  </source>
+
#'''Descarga de fuentes.'''<br />Posicionarse en la ubicación deseada para la nueva instalación del proyecto:<source lang="php" enclose="div">cd /usr/local/proyectos/sanaviron_quilmes/</source>El proyecto está disponible en [https://hub.siu.edu.ar/SIU https://hub.siu.edu.ar]<syntaxhighlight lang="bash" enclose="div">
−
<big> Actualizar librerías:</big>  
+
git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/gco.git gco_xxx
−
<source lang="php" enclose="div"> composer install </source>
+
cd gco_xxx
−
  Si en este punto nos advierte que existen cambios locales en alguna librería descartarlos
+
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>  
−
<big> Regenerar el proyecto:</big>
+
#'''Configuración de la instalación'''<br />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 [[SIU-Sanaviron-Quilmes/version1.2.0/variables.de.entorno.para.la.instalacion|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:<source lang="php" enclose="div"> ./bin/instalador proyecto:definir-variables </source>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.<br />'''Nota:''' Muchas de las configuraciones se podrán obtener desde la instalación anterior dentro de la carpeta '''config''' (config.ini).
−
<source lang="php" enclose="div"> toba proyecto regenerar -p sq_nucleo -i desarrollo </source>
+
#'''Actualización de una instalación.'''<br />Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]].<br />El instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización: <source lang="bash" enclose="div">
−
<big> Ejecutar cambios de la versión:</big>  
+
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
−
<source lang="php" enclose="div"> toba proyecto inicializar_versionador -p sq_nucleo -e -v <id_version> </source>
+
</source>
−
<big> Migrar/Crear Auditoría</big>  
+
#'''Verificar archivo de log del instalador.'''<br />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: :<source lang="bash" enclose="div">
−
<source lang="php" enclose="div"> toba proyecto crear_auditoria -p sq_nucleo -i desarrollo  </source>
+
less instalador.log </source>
−
Si pregunta ‘Desea mantener los datos de auditoria actuales? (Si o No)’ setear ‘n’
+
#'''Modificar permisos.'''<br />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.<br />Ejecute el siguiente comando como superusuario: <source lang="bash" enclose="div">
−
<big> Validación básica de la instalación (postgres, conexión entre sistemas, etc)</big>
+
sudo ./bin/instalador permisos:simple
−
<source lang="php" enclose="div"> sq validar_instalacion  </source>
+
</source> 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: <source lang="bash" enclose="div">
 +
sudo ./bin/instalador permisos:simple -U usuario -W www-data
 +
</source>
 +
#'''Configuración del servidor de aplicaciones.'''<br />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: <source lang="bash" enclose="div">
 +
ln -s /ruta_instalacion/gco/config/alias.conf /etc/apache2/sites-enabled/sq_gco.conf   
 +
</source> Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
  
−
<br />
+
=== SQ Pagos ===
  
−
== Actualizar Unidad de venta ==
+
#'''Descarga de fuentes.'''<br />Posicionarse en la ubicación deseada para la nueva instalación del proyecto:<source lang="php" enclose="div">cd /usr/local/proyectos/sanaviron_quilmes/</source>El proyecto está disponible en [https://hub.siu.edu.ar/SIU https://hub.siu.edu.ar]<syntaxhighlight lang="bash" enclose="div">
−
En este caso se actualiza la unidad de ventas de cursos
+
git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/sq_pagos.git sq_pagos_xxx
−
 
+
cd sq_pagos_xxx
−
<big> Iniciar el entorno para utilizar los comandos:</big>
+
</syntaxhighlight>
−
<source lang="php" enclose="div">source config/entorno_toba.env </source>
+
#'''Configuración de la instalación'''<br />Editar el archivo config/angular-config.json:<source lang="php" enclose="div">
−
 
+
{
−
<big> Exportar los usuarios y grupos de acceso existentes en la instalación:</big>
+
"entorno": "desarrollo",
−
<source lang="php" enclose="div"> toba instancia exportar -i desarrollo </source>
+
"desarrollo": {
−
 
+
"config": {
−
<big> Generar Backup del sistema de archivos y las bases de datos (sq_uv y toba)</big>  
+
"api_backend_url": "http://localhost/sq_pagos_backend/",
−
Para el backup de las bases de datos utilizar el comando:
+
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU­-Sanaviron-Quilmes"
−
<source lang="php" enclose="div"> pg_dump -Uuser -hhost -pport nombre_de_base > archivo_backup.sql </source>
+
}
−
 
+
},
−
Si tienen fixes aplicados y estos están incorporados a la nueva versión se deben eliminar de la siguiente forma (excepto carpeta config):</big>
+
"produccion": {
−
<source lang="php" enclose="div"> git checkout <ruta_archivo_modificado> </source>
+
"config": {
−
 
+
"api_backend_url": "http://sq_server.edu.ar/sq_pagos_backend/",
−
<big> Actualizar la instalación vía Git:</big>
+
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU­-Sanaviron-Quilmes"
−
<source lang="php" enclose="div"> git pull origin master </source>
+
}
−
 
+
}
−
<big> Actualizar librerías:</big>
+
}
−
<source lang="php" enclose="div"> composer install </source>
+
</source>
−
Si en este punto nos advierte que existen cambios locales en alguna librería descartarlos.
+
#'''Instalar el sistema'''<br /><source lang="php" enclose="div">export NODE_VERSION=4.5.0
−
<big> Regenerar el proyecto:</big>
+
export NVM_DIR=/home/node/.nvm
−
<source lang="php" enclose="div"> toba proyecto regenerar -p sq_uv -i desarrollo </source>
+
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
−
<big> Ejecutar cambios de la versión:</big>
+
echo ". ~/.nvm/nvm.sh" >> ~/.bashrc
−
<source lang="php" enclose="div"> toba proyecto inicializar_versionador -p sq_uv -e -v <id_version> </source>
+
. ~/.nvm/nvm.sh && nvm use $NODE_VERSION
−
 
+
npm install --unsafe-perm
−
<big> Migrar/Crear Auditoría</big>
+
</source>
−
<source lang="php" enclose="div"> toba proyecto crear_auditoria -p sq_uv -i desarrollo </source>
+
#'''Configurar el servidor web Apache'''<br /><source lang="php" enclose="div">
−
Si pregunta ‘Desea mantener los datos de auditoria actuales? (Si o No)’ setear ‘n’
+
ln -s ./config/sq_pagos.conf /etc/apache2/sites-enabled/sq_pagos.conf
−
 
+
</source>Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios
−
<br />
 
−
 
 
−
==  Actualizar el Gateway de cobros Online (GCO) ==
 
−
 
 
−
Si tienen fixes aplicados y estos están incorporados a la nueva versión se deben eliminar de la siguiente forma (excepto carpeta config):
 
−
<source lang="php" enclose="div"> git checkout <ruta_archivo_modificado> </source>
 
−
<big> Actualizar la instalación vía Git</big>  
 
−
<source lang="php" enclose="div"> git pull origin master </source>
 
−
 
 
−
<br />
 
−
 
 
−
== Actualizar SQ Pagos ==
 
−
 
 
−
Si tienen fixes aplicados y estos están incorporados a la nueva versión se deben eliminar de la siguiente forma (excepto carpeta config):
 
−
<source lang="php" enclose="div"> git checkout <ruta_archivo_modificado> </source>
 
−
<big> Actualizar la instalación vía Git</big>
 
−
<source lang="php" enclose="div"> git pull origin master </source>
 
−
 
 
−
<br />
 
−
 
 
−
== Activación final de componentes ==
 
−
<big> Editar el archivo nucleo/toba/proyecto.ini</big>
 
−
<source lang="php" enclose="div"> modo_mantenimiento = 0 </source>
 
−
<big> Editar el archivo unidad-venta/toba/proyecto.ini</big>
 
−
<source lang="php" enclose="div"> modo_mantenimiento = 0 </source>
 
−
<big> Activar el servicio de Apache de todos los componentes</big>
 
−
<source lang="php" enclose="div"> sudo /etc/init.d/apache2 start </source>
 
−
(Si el núcleo, la unidad de venta, GCO y SQ-Pagos están en servidores separados activar todos los servicios de Apache)
 
−
Validación básica de la instalación (postgres, conexión entre sistemas, etc)
 
−
<big> Núcleo</big>
 
−
<source lang="php" enclose="div"> sq validar_instalacion </source>
 
−
 
 
−
<big> Ejecutar en la consola de la unidad de venta</big>  
 
−
<source lang="php" enclose="div"> sq validar_instalacion </source>
 
−
 
 
−
<br />
 
−
 
 
−
== Activar los Workers ==
 
−
<big> Núcleo</big>
 
−
<source lang="php" enclose="div"> sq iniciar_workers > /dev/null 2>&1 & </source>
 
−
<big> Unidad de venta</big>
 
−
<source lang="php" enclose="div"> sq iniciar_workers > /dev/null 2>&1 & </source>
 

Revisión actual del 15:40 4 oct 2018

Siu-sanaviron-quilmes.png

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 -b master 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 -b master 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 -b master 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 -b master 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
    Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios
Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq&oldid=45663»