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

De SIU
Saltar a: navegación, buscar
 
Línea 1: Línea 1:
−
[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version1.2.0]]
+
== Actualización ==
 +
=== Recomendaciones previas a la actualización ===
  
−
== Esquema de actualización de SIU-Sanavirón-Quilmes ==
+
Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.
−
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>
+
<source lang="bash" enclose="div">
−
Image:SQ - Instalacion actualizacion.png
+
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.
−
rect 302 71 1246 121 [[SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq#Desactivaci.C3.B3n_de_componentes_para_la_actualizaci.C3.B3n|Prueba]]
+
</source>
−
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]]
+
===== Verificar configuración del entorno de la instalación anterior =====
−
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]]
+
Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''SIU-Pilaga-anterior/instalacion/entorno_toba.env''''
−
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]]
+
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
−
</imagemap>
+
 
−
<br />
+
<source lang="bash" enclose="div">
 +
export TOBA_DIR=/ruta_instalacion_a_pilaga/vendor/siu-toba/framework
 +
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>
 +
 
 +
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''''
 +
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
  
−
<div>__TOC__</div>
+
set toba_dir=/ruta_instalacion_a_pilaga/vendor/siu-toba/framework
  
−
== Desactivación de componentes para la actualización ==
+
set pilaga_dir=/ruta_instalacion_a_pilaga
 +
</source>
  
−
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.
+
===== Verificar configuración de la instancia de la instalación anterior =====
  
−
<big>Desactivar los Workers</big>
+
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
 +
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.
  
−
Ejecutar en la consola:
+
<source lang="bash" enclose="div">
−
<source lang="php" enclose="div"> kill -9 $(cat unidad-venta/config/scheduler_squnidadventa.pid)
+
[pilaga]
−
kill -9 $(cat unidad-venta/config/workers_squnidadventa.pid)
+
path = "/ruta_instalacion_a_pilaga"
−
kill -9 $(cat nucleo/config/scheduler_sqnucleo.pid)
+
url = "/pilaga"
−
kill -9 $(cat nucleo/config/workers_sqnucleo.pid)
+
full_url = "http://localhost/pilaga"
 +
url_pers = "/pilaga_pers/"
 +
usar_perfiles_propios = "1"
 
</source>
 
</source>
  
 +
===== Verificar permisos de lectura y escritura de la instalación anterior =====
  
−
<big> Editar el archivo nucleo/toba/proyecto.ini</big>
+
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="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 />
+
<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>
  
−
== Actualización del Núcleo ==
+
=== Actualización de una instalación sin personalizaciones ===
 +
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]]
  
−
<big> Iniciar el entorno para utilizar los comandos: </big>
+
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.
−
<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):
+
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
−
<source lang="php" enclose="div"> git checkout <ruta_archivo_modificado> </source>
+
proceso de actualización:
−
<big> Actualizar la instalación vía Git:</big>
 
−
<source lang="php" enclose="div"> git pull origin master  </source>
 
−
<big> Actualizar librerías:</big>
 
−
<source lang="php" enclose="div"> composer install </source>
 
−
Si en este punto nos advierte que existen cambios locales en alguna librería descartarlos
 
−
<big> Regenerar el proyecto:</big>
 
−
<source lang="php" enclose="div"> toba proyecto regenerar -p sq_nucleo -i desarrollo  </source>
 
−
<big> Ejecutar cambios de la versión:</big>
 
−
<source lang="php" enclose="div"> toba proyecto inicializar_versionador -p sq_nucleo -e -v <id_version>  </source>
 
−
<big> Migrar/Crear Auditoría</big>
 
−
<source lang="php" enclose="div"> toba proyecto crear_auditoria -p sq_nucleo -i desarrollo  </source>
 
−
Si pregunta ‘Desea mantener los datos de auditoria actuales? (Si o No)’ setear ‘n’
 
−
<big> Validación básica de la instalación (postgres, conexión entre sistemas, etc)</big>
 
−
<source lang="php" enclose="div"> sq validar_instalacion  </source>
 
  
−
<br />
+
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
 +
</source>
  
−
== Actualizar Unidad de venta ==
+
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]]
−
En este caso se actualiza la unidad de ventas de cursos
 
  
−
<big> Iniciar el entorno para utilizar los comandos:</big>
+
=== Actualización de una instalación con personalizaciones ===
−
<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>
+
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]]
−
<source lang="php" enclose="div"> toba instancia exportar -i desarrollo </source>
 
  
−
<big> Generar Backup del sistema de archivos y las bases de datos (sq_uv y toba)</big>
+
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.  
−
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):</big>
+
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:
−
<source lang="php" enclose="div"> git checkout <ruta_archivo_modificado> </source>
 
  
−
<big> Actualizar la instalación vía Git:</big>
+
:<source lang="bash" enclose="div">
−
<source lang="php" enclose="div"> git pull origin master </source>
+
# Descarga la nueva version
 +
svn checkout https://repositorio/svn/pilaga/nodos/<sigla institucion>/trunk/3.1.5/ 
  
−
<big> Actualizar librerías:</big>
+
# En la nueva versión realiza una instalación en desarrollo con base de datos de negocio existente
−
<source lang="php" enclose="div"> composer install </source>
+
./bin/instalador proyecto:instalar --db-negocio-existente
−
Si en este punto nos advierte que existen cambios locales en alguna librería descartarlos.
 
−
<big> Regenerar el proyecto:</big>
 
−
<source lang="php" enclose="div"> toba proyecto regenerar -p sq_uv -i desarrollo </source>
 
  
−
<big> Ejecutar cambios de la versión:</big>
+
# Mezcla los cambios hechos en la version 3.1.5 hacia esta nueva version 
−
<source lang="php" enclose="div"> toba proyecto inicializar_versionador -p sq_uv -e -v <id_version> </source>
+
svn merge https://repositorio/svn/pilaga/nodos/<sigla institucion>/trunk/3.1.5/personalizacion    carpeta_proyecto/personalizacion
  
−
<big> Migrar/Crear Auditoría</big>
+
# Inicia la personalizacion
−
<source lang="php" enclose="div"> toba proyecto crear_auditoria -p sq_uv -i desarrollo </source>
+
toba personalizacion iniciar
−
Si pregunta ‘Desea mantener los datos de auditoria actuales? (Si o No)’ setear ‘n’
 
  
−
<br />
+
# Chequea si hay posibles conflictos
 +
toba personalizacion conflictos
  
−
==  Actualizar el Gateway de cobros Online (GCO) ==
+
# Toma los archivos .xml de la carpeta personalización y los carga a metadatos en la base
 +
toba personalizacion importar
  
−
Si tienen fixes aplicados y estos están incorporados a la nueva versión se deben eliminar de la siguiente forma (excepto carpeta config):
+
# Exporta los metadatos como archivos .sql en la carpeta metadatos
−
<source lang="php" enclose="div"> git checkout <ruta_archivo_modificado> </source>
+
toba proyecto exportar
−
<big> Actualizar la instalación vía Git</big>
 
−
<source lang="php" enclose="div"> git pull origin master </source>
 
  
−
<br />
+
svn commit 
 +
</source>
  
−
== Actualizar SQ Pagos ==
+
== Post Instalación/Actualización ==
  
−
Si tienen fixes aplicados y estos están incorporados a la nueva versión se deben eliminar de la siguiente forma (excepto carpeta config):
+
Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.
−
<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 />
+
=== 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.
  
−
== Activación final de componentes ==
+
Una de las alternativas para visualizar el archivo de log es de la siguiente manera:
−
<big> Editar el archivo nucleo/toba/proyecto.ini</big>
+
:<source lang="bash" enclose="div">
−
<source lang="php" enclose="div"> modo_mantenimiento = 0 </source>
+
less instalador.log
−
<big> Editar el archivo unidad-venta/toba/proyecto.ini</big>
+
</source>
−
<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>
+
=== Modificar permisos ===
−
<source lang="php" enclose="div"> sq validar_instalacion </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.
  
−
<br />
+
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.
  
−
== Activar los Workers ==  
+
Ejecute el siguiente comando como superusuario:
−
<big> Núcleo</big>  
+
 
−
<source lang="php" enclose="div"> sq iniciar_workers > /dev/null 2>&1 & </source>
+
:<source lang="bash" enclose="div">
−
<big> Unidad de venta</big>  
+
sudo ./bin/instalador permisos:simple
−
<source lang="php" enclose="div"> sq iniciar_workers > /dev/null 2>&1 & </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 ===
 +
 
 +
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/pilaga/instalacion/toba.conf /etc/apache2/sites-enabled/SIU-Pilaga.conf   
 +
</source>
 +
 
 +
Para servidores windows, agregar la siguiente linea al archivo de configuración de Apache (httpd.conf)
 +
 
 +
<source lang="apache" enclose="div">
 +
Include /ruta_instalacion/pilaga/instalacion/toba.conf
 +
</source>
 +
 
 +
Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
 +
 
 +
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.
 +
 
 +
Proceder a crear un archivo de nombre pilagá con el siguiente contenido:
 +
 
 +
<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>
 +
 
 +
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
 +
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
 +
 
 +
</source>
 +
 
 +
=== Activar el sistema ===
 +
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>

Revisión del 16:07 28 sep 2018

Actualización

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.
Verificar configuración del entorno de la instalación anterior

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior 'SIU-Pilaga-anterior/instalacion/entorno_toba.env'

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

export TOBA_DIR=/ruta_instalacion_a_pilaga/vendor/siu-toba/framework
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."

Para el caso de una instalación en un servidor con sistema operativo Windows, en el caso de no disponer del archivo 'SIU-Pilaga/instalacion/entorno_toba.env', debemos validar la existencia del archivo 'SIU-Pilaga-anterior/bin/pilaga.bat' y dentro de este verificar que se encuentre correctamente configurada la ruta de instalación a SIU-Pilaga.

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

Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo 'SIU-Pilaga/instalacion/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.

[pilaga]
path = "/ruta_instalacion_a_pilaga"
url = "/pilaga"
full_url = "http://localhost/pilaga"
url_pers = "/pilaga_pers/"
usar_perfiles_propios = "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-Pilaga 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.

Actualización de una instalación sin personalizaciones

Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en Recomendaciones previas actualización

Para realizar una actualización sin personalizaciones, es necesario iniciar una instalación en modo producción. El instalador no soporta actualizaciones de instalaciones en entorno de desarrollo.

Una vez realizado lo explicado en el ítem de Pasos previos a un proceso de instalación, y luego de chequear los requerimientos previos a la actualización, el instalador nos proporciona el siguiente comando para ejecutar el proceso de actualización:

Para actualizar en entorno de producción se ejecuta el siguiente comando:

./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR

Una vez ejecutado el comando de actualización, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado Post actualización

Actualización de una instalación con personalizaciones

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

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.

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:

# Descarga la nueva version
svn checkout https://repositorio/svn/pilaga/nodos/<sigla institucion>/trunk/3.1.5/  

# 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

Post Instalación/Actualización

Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.

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

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

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/pilaga/instalacion/toba.conf /etc/apache2/sites-enabled/SIU-Pilaga.conf

Para servidores windows, agregar la siguiente linea al archivo de configuración de Apache (httpd.conf)

Include /ruta_instalacion/pilaga/instalacion/toba.conf

Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

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.

Proceder a crear un archivo de nombre pilagá con el siguiente contenido:

<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>

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.

### 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

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 instalar la aplicación lynx para poder ejecutar un navegador web desde linea de comando de la siguiente manera:

### Chequeo web desde un navegador web por consola de comandos

lynx http://servidor.universidad.edu.ar/pilaga/WebCheck.php

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
Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Sanaviron-Quilmes/version1.2.0/actualizar_sq&oldid=45412»