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 39 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
−
== Actualización ==
+
[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version1.2.0]]
−
=== 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.
+
= Esquema de actualización de SIU-Sanavirón-Quilmes =
−
 
 
−
<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>
 
  
−
===== Verificar configuración del entorno de la instalación anterior =====
+
<div class="noautonum">__TOC__</div>
  
−
Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''SIU-Pilaga-anterior/instalacion/entorno_toba.env''''
+
== Recomendaciones previas a la actualización ==
  
−
Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Pilaga
+
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.
  
 
<source lang="bash" enclose="div">
 
<source lang="bash" enclose="div">
−
export TOBA_DIR=/ruta_instalacion_a_pilaga/vendor/siu-toba/framework
+
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.
−
export TOBA_INSTANCIA=produccion
 
−
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_pilaga/instalacion
 
−
export PATH="$TOBA_DIR/bin:$PATH"
 
−
echo "Entorno cargado."
 
−
echo "Ejecute 'toba' para ver la lista de comandos disponibles."
 
 
</source>
 
</source>
  
−
Para el caso de una instalación en un servidor con sistema operativo Windows, en el caso de no disponer del archivo '<nowiki/>'''SIU-Pilaga/instalacion/entorno_toba.env'<nowiki/>''', debemos validar la existencia del archivo '<nowiki/>'''SIU-Pilaga-anterior/bin/pilaga.bat''''
+
=== SQ Núcleo ===
−
y dentro de este verificar que se encuentre correctamente configurada la ruta de instalación a SIU-Pilaga.
 
−
 
 
−
<source lang="bash" enclose="div">
 
−
set TOBA_PROYECTO=pilaga
 
−
set TOBA_INSTANCIA=produccion
 
−
set TOBA_INSTALACION_DIR=/ruta_instalacion_a_pilaga/instalacion
 
−
 
 
−
set toba_dir=/ruta_instalacion_a_pilaga/vendor/siu-toba/framework
 
  
−
set pilaga_dir=/ruta_instalacion_a_pilaga
+
#'''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>
+
[sq_nucleo]
−
 
+
path = "/ruta_instalacion_a_nucleo/toba"
−
===== Verificar configuración de la instancia de la instalación anterior =====
+
url = "/sq_nucleo"
−
 
+
full_url = "http://localhost/sq_nucleo"
−
Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '<nowiki/>'''SIU-Pilaga/instalacion/i__produccion/instancia.ini'<nowiki/>''' y dentro de este verificar si esta configurado el parámetro '<nowiki/>'''usar_perfiles_propios = "1"'''' el cual es  
+
url_pers = "/sq_nucleo_pers/"
−
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.
 
−
 
 
−
<source lang="bash" enclose="div">
 
−
[pilaga]
 
−
path = "/ruta_instalacion_a_pilaga"
 
−
url = "/pilaga"
 
−
full_url = "http://localhost/pilaga"
 
−
url_pers = "/pilaga_pers/"
 
 
usar_perfiles_propios = "1"
 
usar_perfiles_propios = "1"
 
</source>
 
</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">
−
===== 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-Pilaga 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.
 
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>
 
</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">
−
=== Actualización de una instalación sin personalizaciones ===
+
git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/nucleo.git nucleo_xxx
−
Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Pilaga/Version_3.1.5/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]
+
cd nucleo_xxx
−
 
+
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install --no-dev </source>
−
Para realizar una actualización sin personalizaciones, es necesario iniciar una instalación en modo producción. El instalador no soporta actualizaciones de instalaciones en entorno de desarrollo.
+
#'''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">
−
Una vez realizado lo explicado en el ítem de [[SIU-Pilaga/Version_3.1.5/instalacion_actualizacion#Pasos_previos_a_un_proceso_de_instalaci.C3.B3n|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:
 
−
 
 
−
Para actualizar en entorno de producción se ejecuta el siguiente comando:
 
−
<source lang="bash" enclose="div">
 
 
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
 
./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>
  
−
Una vez ejecutado el comando de actualización, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Pilaga/Version_3.1.5/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]
+
Finalmente, podrá acceder al sistema SIU-SQ-Núcleo abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/sq_nucleo.
  
−
=== Actualización de una instalación con personalizaciones ===
+
=== SQ Académico ===
  
−
Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Pilaga/Version_3.1.5/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]
+
#'''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]
−
Cada vez que para el SIU-Pilagá este disponible una nueva versión (versión original generada por el equipo de SIU), se deberá migrar manualmente desde un entorno de desarrollo previo. El procedimiento de trabajo implica migrar la personalización desde la versión anterior a la siguiente sin saltearse ninguna versión intermedia. Para ello, desde un repositorio se tendrá que descargar la nueva versión y realizar la instalación nueva en modo desarrollo.  
+
path = "/ruta_instalacion_a_academico/toba"
−
 
+
url = "/sq_academico"
−
Es recomendable no utilizar el entorno de desarrollo anterior, así este puede ser utilizado para realizar bugfixes y correcciones que sean necesarios para la actual versión en producción. Procediendo sobre una nueva instalación de SIU-Pilagá, realizar:
+
full_url = "http://localhost/sq_academico"
−
 
+
url_pers = "/sq_academico_pers/"
−
:<source lang="bash" enclose="div">
+
usar_perfiles_propios = "1"
−
# Descarga la nueva version
+
</source>
−
svn checkout https://repositorio/svn/pilaga/nodos/<sigla institucion>/trunk/3.1.5/
+
#'''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.
−
# En la nueva versión realiza una instalación en desarrollo con base de datos de negocio existente
 
−
./bin/instalador proyecto:instalar --db-negocio-existente
 
−
 
 
−
# Mezcla los cambios hechos en la version 3.1.5 hacia esta nueva version 
 
−
svn merge https://repositorio/svn/pilaga/nodos/<sigla institucion>/trunk/3.1.5/personalizacion    carpeta_proyecto/personalizacion
 
−
 
 
−
# Inicia la personalizacion
 
−
toba personalizacion iniciar
 
−
 
 
−
# Chequea si hay posibles conflictos
 
−
toba personalizacion conflictos
 
−
 
 
−
# Toma los archivos .xml de la carpeta personalización y los carga a metadatos en la base
 
−
toba personalizacion importar
 
−
 
 
−
# Exporta los metadatos como archivos .sql en la carpeta metadatos
 
−
toba proyecto exportar
 
−
 
 
−
svn commit 
 
 
</source>
 
</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">
−
== Post Instalación/Actualización ==
+
git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/academico.git academico_xxx
−
 
+
cd academico_xxx
−
Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.
+
</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).
−
=== Verificar archivo de log del instalador ===
+
#'''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">
−
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
+
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
−
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>
 
</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">
−
=== Modificar permisos ===
+
less instalador.log </source>
−
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.  
+
#'''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">
−
 
 
−
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:
 
−
 
 
−
:<source lang="bash" enclose="div">
 
 
sudo ./bin/instalador permisos:simple
 
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>
 
</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">
−
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:
+
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.
−
:<source lang="bash" enclose="div">
+
#'''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">
−
sudo ./bin/instalador permisos:simple -U usuario -W www-data
+
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
 
</source>
 
</source>
  
−
=== Configuración del servidor de aplicaciones ===
+
Finalmente, podrá acceder al sistema SIU-SQ-Académico abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/sq_academico.
  
−
Para la configuración del servidor web les proponemos las siguientes opciones.
+
=== SQ G.C.O. ===
  
−
Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:
+
#'''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 lang="bash" enclose="div">
 
−
ln -s /ruta_instalacion/pilaga/instalacion/toba.conf /etc/apache2/sites-enabled/SIU-Pilaga.conf   
 
 
</source>
 
</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">
−
Para servidores windows, agregar la siguiente linea al archivo de configuración de Apache (httpd.conf)
+
git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/gco.git gco_xxx
−
 
+
cd gco_xxx
−
<source lang="apache" enclose="div">
+
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
−
Include /ruta_instalacion/pilaga/instalacion/toba.conf
+
#'''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).
 +
#'''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>
 
</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">
−
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
+
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">
−
Otra opción de configuración, independientemente de si se va a realizar la instalación del sistema SIU-Pilagá en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Pilagá en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.
+
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">
−
Proceder a crear un archivo de nombre pilagá con el siguiente contenido:
+
sudo ./bin/instalador permisos:simple -U usuario -W www-data
−
 
 
−
<source lang="apache" enclose="div">
 
−
<VirtualHost *:80>
 
−
    ServerAdmin webmaster@localhost
 
−
    ServerName servidor.universidad.edu.ar
 
−
 
 
−
    ### INICIO INCLUSION CONTENIDO toba.conf ###
 
−
 
 
−
    Include /ruta_instalacion/pilaga/instalacion/toba.conf
 
−
 
 
−
    ### FIN INCLUSION CONTENIDO toba.conf ###
 
−
 
 
−
</VirtualHost>
 
−
</source>
 
−
 
 
−
Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual accederá al sistema.
 
−
 
 
−
Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio  sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea).
 
−
 
 
−
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
 
−
 
 
−
Finalmente, podrá acceder al sistema SIU-Pilagá abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/pilaga.
 
−
 
 
−
=== Chequear requerimientos web ===
 
−
Antes de activar el sistema sacándolo del modo mantenimiento es recomendable que ejecute el link que le proporciona el instalador al finalizar la instalación en un navegador web de modo que se pueda hacer un chequeo de los requerimientos en el servidor web y de esa forma asegurarnos que tenemos configurado correctamente el php.ini que corre el apache y luego sacarlo del modo mantenimiento.
 
−
 
 
−
<source lang="apt_sources" enclose="div">
 
−
 
 
−
### AL FINALIZAR LA INSTALACIÓN EL INSTALADOR LE GENERA UN LINK AL CHEQUEO WEB CON LA URL CONFIGURADA EN LA INSTALACIÓN ###
 
−
 
 
−
http://servidor.universidad.edu.ar/pilaga/WebCheck.php
 
−
 
 
 
</source>
 
</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.
  
−
El chequeo web no permite ejecutar remotamente desde un navegador, para el caso que el servidor no disponga una interfaz gráfica para ejecutar de forma local el chequeo en el navegador web, una alternativa puede ser
+
=== SQ Pagos ===
−
instalar la aplicación '''lynx''' para poder ejecutar un navegador web desde linea de comando de la siguiente manera:
 
−
 
 
−
<source lang="bash" enclose="div">
 
−
 
 
−
### Chequeo web desde un navegador web por consola de comandos
 
−
 
 
−
lynx http://servidor.universidad.edu.ar/pilaga/WebCheck.php
 
  
 +
#'''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/sq_pagos.git sq_pagos_xxx
 +
cd sq_pagos_xxx
 +
</syntaxhighlight>
 +
#'''Configuración de la instalación'''<br />Editar el archivo config/angular-config.json:<source lang="php" enclose="div">
 +
{
 +
"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"
 +
}
 +
}
 +
}
 
</source>
 
</source>
−
 
+
#'''Instalar el sistema'''<br /><source lang="php" enclose="div">export NODE_VERSION=4.5.0
−
=== Activar el sistema ===
+
export NVM_DIR=/home/node/.nvm
−
Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando:
+
git clone https://github.com/creationix/nvm.git ~/.nvm && cd ~/.nvm && git checkout `git describe --abbrev=0 --tags`
−
<source lang="bash" enclose="div">
+
. ~/.nvm/nvm.sh && nvm install $NODE_VERSION
−
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
+
echo ". ~/.nvm/nvm.sh" >> ~/.bashrc
 +
. ~/.nvm/nvm.sh && nvm use $NODE_VERSION
 +
npm install --unsafe-perm
 
</source>
 
</source>
 +
#'''Configurar el servidor web Apache'''<br /><source lang="php" enclose="div">
 +
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

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»