SIU - Contribuciones del usuario [es]

SIU-Sanaviron-Quilmes/version2.11.0/variables.de.entorno.para.la.instalacion

2025-11-28T17:42:50Z

Falvez: /* Configuración Redis */

= Variables de entorno para la instalación =
A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación de SIU-Sanaviron-Quilmes. Éstas están en el archivo <big>'''instalacion.env'''</big>

== Configuración del instalador ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|INSTALADOR_TIMEOUT
|tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 360 segundos
|-
|ENTORNO_PRODUCCION
|indica si la instalación es un entorno de producción. El valor 1 es producción, 0 solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|TOBA_URL_BASE
|Ej: `http://localhost
|-
|TOBA_URL_PORT
|opcional, el puerto de la url definida en la variable anterior
|-
|TOBA_USUARIO
|el usuario administrador del proyecto
|-
|TOBA_PASSWORD
|el password del usuario administrador
|-
|TOBA_INSTALACION_DIR
|el directorio donde va a quedar los archivos de la instalación del proyecto toba. Por defecto `/var/local/sqnucleo/config`
|-
|TOBA_PROYECTO_DIR
|el directorio donde está el proyecto toba. No es modificable
|-
|TOBA_ALIAS_PROYECTO
|el alias Apache para el acceso al proyecto. Por defecto `/sq_nucleo`
|-
|TOBA_ALIAS_NUCLEO
|el alias Apache para acceso al núcleo de Toba
|-
|TOBA_ID_DESARROLLADOR
|el id desarrollador toba. Por defecto es `0` si no se va a desarrollar
|-
|TOBA_SESSION_NAME
|el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
|-
|TOBA_FORZAR_HTTPS
|opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser `off` u `on`. Por defecto `off`
|-
|TOBA_SALT
|opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba. Por defecto caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|PROYECTO_DB_HOST
|el host/ip del equipo donde corre la base de datos
|-
|PROYECTO_DB_PORT
|el puerto donde corre la base de datos
|-
|PROYECTO_DB_DBNAME
|el nombre de la base de datos
|-
|PROYECTO_DB_USERNAME
|el usuario para la conectarse a la base de datos
|-
|PROYECTO_DB_PASSWORD
|la clave del usuario para conectarse a la base de datos
|-
|PROYECTO_DB_SCHEMA
|el nombre del esquema dentro de la base de datos. Por ahora solo funciona con `usuarios`
|-
|PROYECTO_DB_ENCODING
|la codificación de caracteres de la base de datos. Debe ser `LATIN1`
|}

== Configuración de la base de datos de Toba ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|TOBA_DB_HOST
|el host o dirección ip del equipo donde corre la base de datos
|-
|TOBA_DB_PORT
|el puerto donde corre la base de datos
|-
|TOBA_DB_DBNAME
|el nombre de la base de datos
|-
|TOBA_DB_USERNAME
|el usuario para la conectarse a la base de datos
|-
|TOBA_DB_PASSWORD
|la clave del usuario para conectarse a la base de datos
|-
|TOBA_DB_SCHEMA
|el nombre del esquema dentro de la base de datos
|-
|TOBA_DB_ENCODING
|la codificación de caracteres de la base de datos. Debe ser `LATIN1`
|}

== Configuración para envío de mails ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|ENVIA_EMAILS
|puede ser 1 o 0. por defecto en `0` (desactivado).
|-
|EMAIL_ENVIOS_DESARROLLO
|valor para entorno de desarrollo
|-
|ES_DESARROLLO
|valor para entorno de desarrollo
|-
|SMTP_HOST
|host del servicio SMTP
|-
|SMTP_PORT
|puerto del servicio SMTP
|-
|SMTP_USUARIO
|el usuario con el cual autenticar en el SMTP
|-
|SMTP_CLAVE
|la clave del usuario
|-
|SMTP_AUTH
|si requiere autenticación. Puede ser 1 o 0
|-
|SMTP_SEGURIDAD
|el tipo de seguridad SMPT. Puede ser ssl o tls
|-
|SMTP_AUTO_TLS
|habilita tls si el server lo soporta. Puede ser 1 o 0
|}

== Configuración Redis ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|REST_HOOKS_ACTIVO
|puede ser 1 o 0. Por defecto 1
|-
|REST_HOOKS_MAX_INTENTOS
|cantidad de reintentos
|-
|REST_HOOKS_TIEMPO_BASE
|el tiempo "base" entre reintentos
|}

== Configuración API-Rest ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|API_REST_AUTENTICATION
|puede ser `basic` o `digest`
|-
|API_REST_USUARIO
|usuario de la API-Rest
|-
|API_REST_PASSWORD
|clave de la API-Rest
|}

== Configuración de conexión con la unidad de venta ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|PROYECTO_UV_API_URL
|url de la APi-Rest
|-
|PROYECTO_UV_API_USUARIO
|usuario de la API-Rest
|-
|PROYECTO_UV_API_PASSWORD
|clave de la API-Rest
|-
|PROYECTO_UV_API_METHOD
|puede ser `basic` o `digest`
|}

== Configuración de conexión con el núcleo ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|PROYECTO_NUCLEO_API_URL
|url de la APi-Rest
|-
|PROYECTO_NUCLEOO_API_USUARIO
|usuario de la API-Rest
|-
|PROYECTO_NUCLEO_API_PASSWORD
|clave de la API-Rest
|-
|PROYECTO_NUCLEO_API_METHOD
|puede ser `basic` o `digest`
|}

== Configuración de conexión con G.C.O. ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|PROYECTO_GCO_API_URL
|url de la APi-Rest
|-
|PROYECTO_GCO_API_USUARIO
|usuario de la API-Rest
|-
|PROYECTO_GCO_API_PASSWORD
|clave de la API-Rest
|-
|PROYECTO_GCO_API_METHOD
|puede ser `basic` o `digest`
|}

== Configuración de conexión con SIU-Pilagá ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|PROYECTO_PILAGA_API_URL
|url de la APi-Rest
|-
|PROYECTO_PILAGA_API_USUARIO
|usuario de la API-Rest
|-
|PROYECTO_PILAGA_API_PASSWORD
|clave de la API-Rest
|-
|PROYECTO_PILAGA_API_METHOD
|puede ser `basic` o `digest`
|}
== Configuración del proyecto GCO ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|PROYECTO_ALIAS
|el alias Apache para el acceso al proyecto. Por defecto `/sq_pagos_backend`
|-
|ELIGE_GESTOR
|no editable. Por defecto `0`
|-
|GESTOR_PAGO_POR_DEFECTO
|no editable. Por defecto `mercado_pago`
|-
|JWT_PASSWORD
|clave para generar los Json web tokens.
|-
|JWT_TIEMPO_EXP
|tiempo de caducidad de los Json web tokens.
|-
|JWT_ALGORITMO
|algoritmo de encriptación del token JWT, valores posibles (HS256, HS384, HS512), valor por defecto HS512
|-
|GESTORES_PAGO_IMAGEN_PRODUCTO_DEFAULT
|url pública a la imagen que mostrará el gestor de pagos. Por ejemplo "https://<URL-PUBLICA>/sq_pagos_backend/img/logo.png"
|-
|GESTORES_PAGO_URL_NOTIFICACIONES
|url pública que será invocada por el gestor de pagos para notificar distintos mensajes . Por ejemplo "https://<URL-PUBLICA>/sq_pagos_backend/notifications/notification?"
|-
|MERCADO_PAGO_CLIENT_ID
|# Configuración Mercado Pago (http://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.11.0/mercado.pago)
|-
|MERCADO_PAGO_CLIENT_SECRET
|# Configuración Mercado Pago (http://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.11.0/mercado.pago)
|-
|MERCADO_PAGO_BACK_URL
|url invocada por el gestor de pagos. Por ejemplo "http://127.0.0.1/sq_pagos_backend/mercado_pago/"
|-
|'''MERCADO_PAGO_URL_NOTIFICACIONES'''
|url invocada por el gestor de pagos. Por ejemplo "http://127.0.0.1/sq_pagos_backend/notifications/notification?gestor=MP&"
|-
|'''MERCADO_PAGO_ACCES_TOKEN'''
|# Configuración Mercado Pago (http://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.11.0/mercado.pago)
|-
|PAYPERTIC_USERNAME
|# Configuración PayperTic (http://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.11.0/paypertic)
|-
|PAYPERTIC_PASSWORD
|# Configuración PayperTic (http://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.11.0/paypertic)
|-
|PAYPERTIC_CLIENT_ID
|# Configuración PayperTic (http://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.11.0/paypertic)
|-
|PAYPERTIC_CLIENT_SECRET
|# Configuración PayperTic (http://documentacion.siu.edu.ar/wiki/SIU-Sanaviron-Quilmes/version2.11.0/paypertic)
|-
|PAYPERTIC_BACK_URL
|url invocada por el gestor de pagos. Por ejemplo "http://127.0.0.1/sq_pagos_backend/paypertic/callback"
|-
|'''PAYPERTIC_URL_NOTIFICACIONES'''
|url invocada por el gestor de pagos. Por ejemplo "http://127.0.0.1/sq_pagos_backend/notifications/notification?gestor=PPT&"
|-
|IP_UV
|ip del servidor donde se encuentra la unidad de venta
|-
|LOGIN_UV_USER
|usuario de la API-Rest para conectarse a la unidad de venta
|-
|LOGIN_UV_PWD
|clave de la API-Rest para conectarse a la unidad de venta
|-
|IP_NUCLEO
|ip del servidor donde se encuentra la núcleo
|-
|LOGIN_NUCLEO_USER
|usuario de la API-Rest para conectarse a la núcleo
|-
|LOGIN_NUCLEO_PWD
|clave de la API-Rest para conectarse a la núcleo
|-
|CONNECT_TIMEOUT
|
|-
|TIMEOUT
|
|}
== Configuración de variables de Logs ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|LOG_HANDLER
|el manejador de la salida de logs, puede ser `file`, `errorlog` o `graylog`
|-
|LOG_LEVEL
|nivel de verbosidad de la salida de logs, puede ser `DEBUG`, `INFO`, `NOTICE`, `WARNING`, `ERROR`, `CRITICAL`, `ALERT` o `EMERGENCY`. Se recomienda `INFO` para producción o `DEBUG` en pruebas o desarrollo
|-
|LOG_MAX_FILES
|en caso de que el `LOG_HANDLER` sea `file`, se especifica la cantidad de archivos de logs que se generan y pasado esa cantidad se hace rotación de logs.
|-
|LOG_HOST
|opcional, en caso de que el `LOG_HANDLER` sea `graylog`, es el HOST del servidor
|-
|LOG_PORT
|opcional, en caso de que el `LOG_HANDLER` sea `graylog`, es el PORT del servidor
|}
== Configuración de comprobantes ==
{| class="wikitable"
!Variable de entorno
!Descripción
|-
|COMPROBANTES_TRANSFERENCIAS_PATH
|opcional, ruta absoluta a donde se van a almacenar los archivos de los comprobantes de transferencia, (el path tiene que ser accesible por apache para lectura y escritura). Por defecto `ruta-absoluta-proyecto/toba/www/img/comprobantes`
|}

SIU-Sanaviron-Quilmes/version2.11.0/actualizar sq

2025-11-11T18:01:48Z

Falvez: /* SQ Núcleo */

{{TOClimit|5}}
[[Archivo:ISOSIU-SQ.png|derecha|60px||derecha|link=SIU-Sanaviron-Quilmes/version2.11.0/documentacion_de_las_operacionesf]] 

[[SIU-Sanaviron-Quilmes/version2.11.0/instalacion actualizacion|'''< Volver''']]

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

== Recomendaciones previas a la actualización ==

Antes iniciar el proceso de actualización se deberá considerar que los módulos reciben y envían mensajes por lo que se deberá planear el "apagado" en un orden determinado.

# Avisar a '''SIU-Guaraní''' que el sistema SQ se encuentra en actualización
# '''GCO''': Editar el archivo "config/config.ini" y pasar el valor de los gestores de pago utilizados de ACTIVO=1 a ACTIVO=0
# '''SQ-Pagos''': Detener el servidor.
# '''Académico''': Detener el servidor.
# '''Núcleo''': Detener el servidor.
# '''GCO''': Detener el servidor.
# '''Workers''' Detener los servicios y procesos de Núcleo y Académico (Supervisord).
# '''Cron''' que ejecuta las tareas planificadas de Núcleo y Académico.

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

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.11.0/requisitos.para.version|Requisitos para la versión]]

== SQ Núcleo ==

#'''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 '<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">
[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"
</source>
#'''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. <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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-nucleo-xyz
cd sq-nucleo-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib nucleo
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div">cd nucleo
composer install --prefer-dist --no-dev --optimize-autoloader</source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.11.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 '''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.''' 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/version2.11.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/nucleo
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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.''' 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.''' 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>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto NUCLEO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo los siguientes comandos independinetes en el servidor: <source lang="bash" enclose="div">./bin/sq iniciar_workers
./bin/sq iniciar_queue_workers
</source> Una vez ejecutado los comandos, estos inician los workers que quedarán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor]
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''

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

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ Académico ==

#'''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 '<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.''' 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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-academico-xyz
cd sq-academico-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib academico
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div">cd academico
composer install --prefer-dist --no-dev --optimize-autoloader </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.11.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 '''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.''' 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/version2.11.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/academico
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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.''' 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.''' 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>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto ACADEMICO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo los siguientes comandos independinetes en el servidor: <source lang="bash" enclose="div">./bin/sq iniciar_workers
./bin/sq iniciar_queue_workers
</source> Una vez ejecutado los comandos, estos inician los workers que quedarán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que los comandos corran de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps '''Supervisor'''] '''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.''' 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 realizar validaciones generales puede ejecutar el comando''' <source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ G.C.O. ==

#'''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. <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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-gco-xyz
cd sq-gco-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib gco
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.8.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. '''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.''' 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/version2.8.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/gco
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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>
#'''Dar Permisos a la carpeta sq-gco/lib''' <source lang="php" enclose="div">
cd ..
chmod 755 lib -R</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/gco/config/alias.conf /etc/apache2/sites-enabled/sq_gco.conf
</source> Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
#Para realizar validaciones generales puede ejecutar el comando <source lang="php" enclose="div">
cd bin
sq validar_instalacion</source>

== SQ Pagos ==

#'''Descarga de fuentes.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-pagos-xyz
cd sq-pagos-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set sq_pagos
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Configuración de la instalación''' 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>
#'''Instalar el sistema''' <source lang="php" enclose="div">export NODE_VERSION=4.5.0
export NVM_DIR=<dir_sq_pagos>/bin/.nvm
git clone https://github.com/creationix/nvm.git $NVM_DIR && cd $NVM_DIR && git checkout `git describe --abbrev=0 --tags`
. $NVM_DIR/nvm.sh && nvm install $NODE_VERSION
echo ". $NVM_DIR/nvm.sh" >> ~/.bashrc
. $NVM_DIR/nvm.sh && nvm use $NODE_VERSION
cd <dir_sq_pagos>
npm install --unsafe-perm
</source>
#'''Editar el archivo sq_pagos.conf''' Se deberá modificar el el valor "path-to-sq-pagos" por la ruta absoluta, por ejemplo: "/var/local/sq_pagos/app" <source lang="php" enclose="div">
Alias /sq_pagos "path-to-sq-pagos/app"
<Directory "path-to-sq-pagos/app/">
Options MultiViews FollowSymLinks
AllowOverride None
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
</Directory>
</source>
#'''Configurar el servidor web Apache''' <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

== Recomendaciones posteriores a la actualización ==

Cuando ya haya concluido el proceso de actualización se deberán iniciar los módulos y servícios en un orden determinado.

# '''Núcleo''': Iniciar el servidor.
# '''Académico''': Iniciar el servidor.
# '''SQ-Pagos''': Iniciar el servidor.
# '''GCO''': Editar el archivo "config/config.ini" y pasar el valor de los gestores de pago utilizados de ACTIVO=0 a ACTIVO=1
# '''GCO''': Iniciar el servidor.
# '''Workers''' Iniciar los workers de Núcleo y Académico (Supervisord).
# '''Cron''' que ejecuta las tareas planificadas de Núcleo y Académico.
# Avisar a '''SIU-Guaraní''' que el sistema SQ se encuentra actualizado.

SIU-Sanaviron-Quilmes/version2.12.0/actualizar sq

2025-11-11T18:01:48Z

Falvez:

{{TOClimit|5}}
[[Archivo:ISOSIU-SQ.png|derecha|60px||derecha|link=SIU-Sanaviron-Quilmes/version2.12.0/documentacion_de_las_operacionesf]] 

[[SIU-Sanaviron-Quilmes/version2.12.0/instalacion actualizacion|'''< Volver''']]

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

== Recomendaciones previas a la actualización ==

Antes iniciar el proceso de actualización se deberá considerar que los módulos reciben y envían mensajes por lo que se deberá planear el "apagado" en un orden determinado.

# Avisar a '''SIU-Guaraní''' que el sistema SQ se encuentra en actualización
# '''GCO''': Editar el archivo "config/config.ini" y pasar el valor de los gestores de pago utilizados de ACTIVO=1 a ACTIVO=0
# '''SQ-Pagos''': Detener el servidor.
# '''Académico''': Detener el servidor.
# '''Núcleo''': Detener el servidor.
# '''GCO''': Detener el servidor.
# '''Workers''' Detener los servicios y procesos de Núcleo y Académico (Supervisord).
# '''Cron''' que ejecuta las tareas planificadas de Núcleo y Académico.

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

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.12.0/requisitos.para.version|Requisitos para la versión]]

== SQ Núcleo ==

#'''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 '<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">
[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"
</source>
#'''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. <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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-nucleo-xyz
cd sq-nucleo-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib nucleo
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div">cd nucleo
composer install --prefer-dist --no-dev --optimize-autoloader</source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.12.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 '''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.''' 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/version2.12.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/nucleo
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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.''' 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.''' 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>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto NUCLEO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo los siguientes comandos independinetes en el servidor: <source lang="bash" enclose="div">./bin/sq iniciar_workers
./bin/sq iniciar_queue_workers
</source> Una vez ejecutado los comandos, estos inician los workers que quedarán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor]
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''

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

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ Académico ==

#'''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 '<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.''' 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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-academico-xyz
cd sq-academico-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib academico
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div">cd academico
composer install --prefer-dist --no-dev --optimize-autoloader </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.12.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 '''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.''' 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/version2.12.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/academico
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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.''' 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.''' 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>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto ACADEMICO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo los siguientes comandos independinetes en el servidor: <source lang="bash" enclose="div">./bin/sq iniciar_workers
./bin/sq iniciar_queue_workers
</source> Una vez ejecutado los comandos, estos inician los workers que quedarán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que los comandos corran de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps '''Supervisor'''] '''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.''' 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 realizar validaciones generales puede ejecutar el comando''' <source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ G.C.O. ==

#'''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. <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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-gco-xyz
cd sq-gco-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib gco
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.8.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. '''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.''' 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/version2.8.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/gco
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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>
#'''Dar Permisos a la carpeta sq-gco/lib''' <source lang="php" enclose="div">
cd ..
chmod 755 lib -R</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/gco/config/alias.conf /etc/apache2/sites-enabled/sq_gco.conf
</source> Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
#Para realizar validaciones generales puede ejecutar el comando <source lang="php" enclose="div">
cd bin
sq validar_instalacion</source>

== SQ Pagos ==

#'''Descarga de fuentes.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-pagos-xyz
cd sq-pagos-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set sq_pagos
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Configuración de la instalación''' 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>
#'''Instalar el sistema''' <source lang="php" enclose="div">export NODE_VERSION=4.5.0
export NVM_DIR=<dir_sq_pagos>/bin/.nvm
git clone https://github.com/creationix/nvm.git $NVM_DIR && cd $NVM_DIR && git checkout `git describe --abbrev=0 --tags`
. $NVM_DIR/nvm.sh && nvm install $NODE_VERSION
echo ". $NVM_DIR/nvm.sh" >> ~/.bashrc
. $NVM_DIR/nvm.sh && nvm use $NODE_VERSION
cd <dir_sq_pagos>
npm install --unsafe-perm
</source>
#'''Editar el archivo sq_pagos.conf''' Se deberá modificar el el valor "path-to-sq-pagos" por la ruta absoluta, por ejemplo: "/var/local/sq_pagos/app" <source lang="php" enclose="div">
Alias /sq_pagos "path-to-sq-pagos/app"
<Directory "path-to-sq-pagos/app/">
Options MultiViews FollowSymLinks
AllowOverride None
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
</Directory>
</source>
#'''Configurar el servidor web Apache''' <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

== Recomendaciones posteriores a la actualización ==

Cuando ya haya concluido el proceso de actualización se deberán iniciar los módulos y servícios en un orden determinado.

# '''Núcleo''': Iniciar el servidor.
# '''Académico''': Iniciar el servidor.
# '''SQ-Pagos''': Iniciar el servidor.
# '''GCO''': Editar el archivo "config/config.ini" y pasar el valor de los gestores de pago utilizados de ACTIVO=0 a ACTIVO=1
# '''GCO''': Iniciar el servidor.
# '''Workers''' Iniciar los workers de Núcleo y Académico (Supervisord).
# '''Cron''' que ejecuta las tareas planificadas de Núcleo y Académico.
# Avisar a '''SIU-Guaraní''' que el sistema SQ se encuentra actualizado.

SIU-Sanaviron-Quilmes/version2.13.0/actualizar sq

2025-11-11T18:01:48Z

Falvez:

{{TOClimit|5}}
[[Archivo:ISOSIU-SQ.png|derecha|60px||derecha|link=SIU-Sanaviron-Quilmes/version2.13.0/documentacion_de_las_operacionesf]] 

[[SIU-Sanaviron-Quilmes/version2.13.0/instalacion actualizacion|'''< Volver''']]

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

== Recomendaciones previas a la actualización ==

Antes iniciar el proceso de actualización se deberá considerar que los módulos reciben y envían mensajes por lo que se deberá planear el "apagado" en un orden determinado.

# Avisar a '''SIU-Guaraní''' que el sistema SQ se encuentra en actualización
# '''GCO''': Editar el archivo "config/config.ini" y pasar el valor de los gestores de pago utilizados de ACTIVO=1 a ACTIVO=0
# '''SQ-Pagos''': Detener el servidor.
# '''Académico''': Detener el servidor.
# '''Núcleo''': Detener el servidor.
# '''GCO''': Detener el servidor.
# '''Workers''' Detener los servicios y procesos de Núcleo y Académico (Supervisord).
# '''Cron''' que ejecuta las tareas planificadas de Núcleo y Académico.

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

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.13.0/requisitos.para.version|Requisitos para la versión]]

== SQ Núcleo ==

#'''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 '<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">
[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"
</source>
#'''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. <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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-nucleo-xyz
cd sq-nucleo-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib nucleo
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div">cd nucleo
composer install --prefer-dist --no-dev --optimize-autoloader</source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.13.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 '''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.''' 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/version2.13.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/nucleo
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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.''' 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.''' 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>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto NUCLEO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo los siguientes comandos independinetes en el servidor: <source lang="bash" enclose="div">./bin/sq iniciar_workers
./bin/sq iniciar_queue_workers
</source> Una vez ejecutado los comandos, estos inician los workers que quedarán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor]
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''

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

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ Académico ==

#'''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 '<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.''' 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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-academico-xyz
cd sq-academico-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib academico
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div">cd academico
composer install --prefer-dist --no-dev --optimize-autoloader </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.13.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 '''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.''' 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/version2.13.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/academico
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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.''' 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.''' 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>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto ACADEMICO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo los siguientes comandos independinetes en el servidor: <source lang="bash" enclose="div">./bin/sq iniciar_workers
./bin/sq iniciar_queue_workers
</source> Una vez ejecutado los comandos, estos inician los workers que quedarán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que los comandos corran de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps '''Supervisor'''] '''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.''' 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 realizar validaciones generales puede ejecutar el comando''' <source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ G.C.O. ==

#'''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. <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.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-gco-xyz
cd sq-gco-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set lib gco
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Descargar las dependencias mediante Composer'''<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.8.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. '''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.''' 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/version2.8.0/actualizar_sq#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]. 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 /usr/local/proyectos/sanaviron_quilmes__INSTALACION_ANTERIOR/gco
</source>
#'''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: :<source lang="bash" enclose="div">
less instalador.log </source>
#'''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: <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>
#'''Dar Permisos a la carpeta sq-gco/lib''' <source lang="php" enclose="div">
cd ..
chmod 755 lib -R</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/gco/config/alias.conf /etc/apache2/sites-enabled/sq_gco.conf
</source> Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.
#Para realizar validaciones generales puede ejecutar el comando <source lang="php" enclose="div">
cd bin
sq validar_instalacion</source>

== SQ Pagos ==

#'''Descarga de fuentes.''' 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/siu/sanaviron-quilmes/sanaviron-quilmes.git sq-pagos-xyz
cd sq-pagos-xyz
git config core.sparseCheckout true
git sparse-checkout init --cone
git sparse-checkout set sq_pagos
</syntaxhighlight>'''Nota:''' ''A Partir de la versión 2.7.0 Sanaviron-Quilmes paso a ser un solo repositorio. La opción de git sparse-checkout esta disponible desde la versión de git 2.7.0. Este nos permite hacer un clone de un proyecto parcialmente y no descargar todo el árbol de directorio.''
#'''Configuración de la instalación''' 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>
#'''Instalar el sistema''' <source lang="php" enclose="div">export NODE_VERSION=4.5.0
export NVM_DIR=<dir_sq_pagos>/bin/.nvm
git clone https://github.com/creationix/nvm.git $NVM_DIR && cd $NVM_DIR && git checkout `git describe --abbrev=0 --tags`
. $NVM_DIR/nvm.sh && nvm install $NODE_VERSION
echo ". $NVM_DIR/nvm.sh" >> ~/.bashrc
. $NVM_DIR/nvm.sh && nvm use $NODE_VERSION
cd <dir_sq_pagos>
npm install --unsafe-perm
</source>
#'''Editar el archivo sq_pagos.conf''' Se deberá modificar el el valor "path-to-sq-pagos" por la ruta absoluta, por ejemplo: "/var/local/sq_pagos/app" <source lang="php" enclose="div">
Alias /sq_pagos "path-to-sq-pagos/app"
<Directory "path-to-sq-pagos/app/">
Options MultiViews FollowSymLinks
AllowOverride None
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
</Directory>
</source>
#'''Configurar el servidor web Apache''' <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

== Recomendaciones posteriores a la actualización ==

Cuando ya haya concluido el proceso de actualización se deberán iniciar los módulos y servícios en un orden determinado.

# '''Núcleo''': Iniciar el servidor.
# '''Académico''': Iniciar el servidor.
# '''SQ-Pagos''': Iniciar el servidor.
# '''GCO''': Editar el archivo "config/config.ini" y pasar el valor de los gestores de pago utilizados de ACTIVO=0 a ACTIVO=1
# '''GCO''': Iniciar el servidor.
# '''Workers''' Iniciar los workers de Núcleo y Académico (Supervisord).
# '''Cron''' que ejecuta las tareas planificadas de Núcleo y Académico.
# Avisar a '''SIU-Guaraní''' que el sistema SQ se encuentra actualizado.

2024-10-28T18:37:54Z

Pirapire/version3.1.0/instalacion actualizacion

2023-11-24T19:32:15Z

Falvez:

[[Archivo:pirapire_iso.png|derecha|link=Pirapire/version3.1.0]] 
[[Pirapire/version_3.1.0|<Volver]]

= Instalación/Actualización del sistema Pirapire =

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema Pirapire fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Requerimientos ==

Para poder comenzar con la instalación debe tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.

Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar.

=== Requisitos LINUX ===
Los requerimientos para instalación/actualización en un servidor GNU/Linux son las siguientes: [http://documentacion.siu.edu.ar/wiki/Pirapire/Version_3.1.0/instalacion_actualizacion/requisitos_previos/linux Instalación manual en GNU/Linux]

=== Tabla de requerimientos de versiones ===
{| class="wikitable"
|-
!Requisito !!Versión
|-
| PostgreSQL
|| 11.x
|-
| Apache
|| 2.4.x
|-
| PHP
|| 7.4.x (con las extensiones: xml, gd, pdo_pgsql, curl, zip).
|-
| Composer
|| 2.2.x
|-
| Git
||
|-
| Yarn
||
|-
| Redis
||
|}

== Instalación ==

La instalación del sistema Pirapire se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación o actualización verificar [[Pirapire/version3.1.0/instalacion actualizacion#Requerimientos|Requerimientos Previos]]
#Descargar el sistema de Pirapire desde el sitio https://gitlab.sistemas.unam.edu.ar/sistemas/pirapire mediante Git.
#Descomprimir el archivo y copiar el directorio Pirapire en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego ingresar al directorio recién descomprimido de Pirapire (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Luego ejecutar el comando para inicializar el archivo de variables de entorno.
#:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>
#:Esto creará el archivo '''instalador.env''', luego configurar con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador podemos configurar por separado la base de datos de negocio de Pirapire y la de Toba, o podemos tener las dos dentro de una misma base de datos como es la opción por defecto, lo recomendable para un ambiente de producción es que tanto los schemas de de la base de datos negocio de Pirapire y los schemas de Toba estén todos dentro de una misma base de datos . Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/Pirapire/version3.1.0/instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación desde cero ===

Para realizar una instalación de cero, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.1.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[Pirapire/Version_3.1.0/instalacion_actualizacion#Post_Instalaci.C3.B3n|Post instalación]]

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

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

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''Pirapire-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 Pirapire

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_pirapire/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_pirapire/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
#echo "Entorno cargado."
#echo "Ejecute 'toba' para ver la lista de comandos disponibles."
</source>

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

=== 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 [[Pirapire/Version_3.1.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.1.0/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
</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 [[Pirapire/Version_3.1.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

== 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:
:<source lang="bash" enclose="div">
less instalador.log
</source>

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

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

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/pirapire/instalacion/toba.conf /etc/apache2/sites-enabled/pirapire.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 Pirapire en un servidor Linux, 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 Pirapire en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Pirapire 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/pirapire/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 Pirapire abriendo en un navegador la dirección url <nowiki>http://servidor.universidad.edu.ar/pirapire</nowiki>.

=== 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/pirapire/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/pirapire/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>

=== Sincronizar medios de pagos de SQ Núcleo ===
Las Condiciones de venta y Medios de pago que están disponible en Pirapire al momento de generar un comprobante se obtienen de SQ Núcleo, al sincronizar mediante el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto sinc_condicion_venta --reportables-pilaga -p pirapire
</source>

Cada vez que se modifican en SQ Núcleo los Medios de pagos o Condiciones de ventas se debe ejecutar este comando para que mantenga sincronizado en Pirapire lo que existe en SQ.

=== Lanzar worker de envío de solicitudes a SQ Núcleo ===
Para que Pirapire envíe las peticiones de generación o anulación de comprobantes a ser procesados por SQ Núcleo, es requerido que este activo y permanentemente ejecutándose el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto worker_envio_sq -p pirapire
</source>

El comando lee la cola de peticiones encoladas en la Redis y ejecuta los procesos de los workers de forma asíncrona con SQ Núcleo.

Para asegurar que el worker este siempre en ejecución una opción es hacerlo mediante un sistema de control de procesos como supervisord (http://supervisord.org/), este se encarga de que el proceso siempre este activo y si se reinicia el servidor el proceso también se inicie.

Se recomienda el siguiente ejemplo de instalación y configuración de [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps supervisord]

El siguiente ejemplo muestra una configuración para el worker, creado en '''/etc/supervisor/conf.d/worker-envio-sq.conf''':

'''''Ejemplo de configuración en Supervisord (worker-envio-sq.conf):'''''

:<source lang="php" enclose="div">
[program:worker-envio-sq]
command=<pirapire-path>/bin/toba proyecto worker_envio_sq -p pirapire
autostart=true
autorestart=true
stderr_logfile=/var/log/worker-envio-sq_err.log
stderr_logfile_maxbytes=2MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
stdout_logfile=/var/log/worker-envio-sq_stdout.log
stdout_logfile_maxbytes=10MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1MB
</source>

==== Actualización del worker ====

Una vez realizada la actualización del sistema el '''<pirapire-path>''' deberá modificarse en el archivo anteriormente configurado. 
Seguido a esto para que el Supervisord tome los cambios correspondientes deberán ejecutarse los siguientes comandos en este orden: 
:<source lang="php" enclose="div">
sudo supervisorctl stop
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start all
</source>

----

[[Pirapire/version_3.1.0|<Volver]]

SIU-Sanaviron-Quilmes/version2.4.0/requisitos.para.version

2023-10-02T18:16:43Z

Falvez:

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.2.0/requisitos.para.version|Requisitos para la versión]]

{| class="wikitable"
|-
! '''''Herramientas''''' !! '''Núcleo''' !! '''Académico''' !! '''G.C.O.'''!! '''SQ Pagos'''
|-
| Git || Si || Si || Si|| Si
|-
| SVN || Si || Si || ||
|-
| Postgres|| 11.x || 11.x || ||
|-
| PHP || 7.4 || 7.4 || 7.4||7.4
|-
| Extensiones PHP || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-curl||
|-
| PHP-Composer || Si || Si || Si
|
|-
| NodeJS || Si
| Si
| || SI
|-
|Bower
|Si
|Si
|
|
|-
|Java
|openjdk version 1.8.0
|openjdk version 1.8.0
|
|
|}

:'''Nota''': La base de datos debe tener la codificación es_AR.UTF8 

PHP Composer: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx

NodeJs: https://nodejs.org/en/download/package-manager

== Instalación ==

Si no tiene instalado Apache y los módulos puede ejecutarlos con la siguiente linea: 
<code>
apt install apache2 libapache2-mod-php7.4 php7.4-cli php7.4-pgsql php7.4-gd php7.4-curl php7.4-mbstring php7.4-dom php7.4-soap php7.4-zip php7.4-apcu
</code>

Iniciar módulo rewrite 
<code>
a2enmod rewrite
</code>

Instalación de bower

<code>
sudo npm install -g bower
</code>

Definir zona horaria en PHP
<code>date.timezone=America/Argentina/Buenos_Aires</code>

El servidor debe tener configurada la fecha correctamente para que la comunicación entre los sistemas propios y externos no genere inconvenientes.

Se recomienda utilizar el servicio NTP y utilizar los servidores de south-america.pool.ntp.org

Instalación:

<code>
<nowiki>#</nowiki> apt-get install ntp
</code>

<code>
<nowiki>#</nowiki> vi /etc/ntp.conf
</code>

* server 0.south-america.pool.ntp.org
* server 1.south-america.pool.ntp.org
* server 2.south-america.pool.ntp.org
* server 3.south-america.pool.ntp.org

<code>
<nowiki>#</nowiki> /etc/init.d/ntp restart
</code>

SIU-Sanaviron-Quilmes/version2.5.0/requisitos.para.version

2023-10-02T18:16:43Z

Falvez:

SIU-Sanaviron-Quilmes/version2.6.0/requisitos.para.version

2023-10-02T18:16:43Z

Falvez:

SIU-Sanaviron-Quilmes/version2.3.0/instalar sq produccion

2023-06-22T22:39:08Z

Falvez: /* SQ Pagos */

[[Archivo:ISOSIU-SQ.png|derecha|60px|link=SIU-Sanaviron-Quilmes/version2.3.0]]

{{TOClimit|5}}

[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version2.3.0]]

= Esquema de instalación y configuración de SIU-Sanavirón-Quilmes =
[[Archivo:SQ_Comunicacion.v2.png|800px||Comunicación entre Modulos]]
 

'''En esta sección se va a encontrar información sobre:'''
* Requisitos para la instalación.
* Instalación de los distintos sub módulos de SIU Sanaviron Quilmes.
* Configuración para establecer la comunicación entre los distintos sub módulos y otros módulos (SIU Pilagá, SIU Guaraní, Agentes de cobranza)

<div class="noautonum">__TOC__</div>

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.3.0/requisitos.para.version|Requisitos para la versión]]

== SQ Núcleo ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd nucleo
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.0/variables.de.entorno.para.la.instalacion|'''<big>Variables de entorno para la instalación</big>''']] 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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/<big>'''instalador instalación de soluciones SIU'''</big>]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_nucleo.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto NUCLEO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor] 
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''
'''Importante:''' En caso de utilizar solamente la instalación del Núcleo sin módulos adicionales (Académico, G.C.O., SQ-Pagos) se deberá modificar la siguiente variable en el archivo /config/sq.ini<source lang="bash" enclose="div"> [sq_nucleo]
...
...
standalone="true" </source>

== SQ Académico ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd academico
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_uv.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto UV>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
# '''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor]
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ G.C.O. ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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/gco.git
cd gco
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.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.
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U <mi-usuario> -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/alias.conf /etc/apache2/sites-enabled/gco.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ Pagos ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd sq_pagos
</syntaxhighlight>
#'''Configuración de la instalación''' Editar el archivo config/angular-config.json:<source lang="php" enclose="div">
{
"entorno": "produccion",
"desarrollo": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones al día de la fecha"
}

},
"produccion": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones al día de la fecha"
}

}
}
</source>'''IMPORTANTE:''' Si realiza cambios en este archivo posteriormente a la instalación deberá ejecutar nuevamente el punto 3 (Instalar sistema).
#'''Instalar el sistema''' <source lang="php" enclose="div">export NODE_VERSION=4.5.0
export NVM_DIR=<dir_sq_pagos>/bin/.nvm
git clone https://github.com/creationix/nvm.git $NVM_DIR && cd $NVM_DIR && git checkout `git describe --abbrev=0 --tags`
. $NVM_DIR/nvm.sh && nvm install $NODE_VERSION
echo ". $NVM_DIR/nvm.sh" >> ~/.bashrc
. $NVM_DIR/nvm.sh && nvm use $NODE_VERSION
cd <dir_sq_pagos>
npm install --unsafe-perm
</source>
#'''Editar el archivo sq_pagos.conf''' Se deberá modificar el el valor "path-to-sq-pagos" por la ruta absoluta, por ejemplo: "/var/local/sq_pagos/app" <source lang="php" enclose="div">
Alias /sq_pagos "path-to-sq-pagos/app"
<Directory "path-to-sq-pagos/app/">
Options MultiViews FollowSymLinks
AllowOverride None
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
</Directory>
</source>
#'''Configurar el servidor web Apache''' <source lang="php" enclose="div">
ln -s ./config/sq_pagos.conf /etc/apache2/sites-enabled/sq_pagos.conf
</source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

=== Agente de cobranzas ===

==== [[SIU-Sanaviron-Quilmes/version2.3.0/mercado.pago|Configurar Mercado Pago]] ====

==== [[SIU-Sanaviron-Quilmes/version2.3.0/paypertic|Configurar PayperTic]] ====

SIU-Sanaviron-Quilmes/version2.4.0/instalar sq produccion

2023-06-22T22:39:08Z

Falvez:

[[Archivo:ISOSIU-SQ.png|derecha|60px|link=SIU-Sanaviron-Quilmes/version2.4.0]]

{{TOClimit|5}}

[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version2.4.0]]

= Esquema de instalación y configuración de SIU-Sanavirón-Quilmes =
[[Archivo:SQ_Comunicacion.v2.png|800px||Comunicación entre Modulos]]
 

'''En esta sección se va a encontrar información sobre:'''
* Requisitos para la instalación.
* Instalación de los distintos sub módulos de SIU Sanaviron Quilmes.
* Configuración para establecer la comunicación entre los distintos sub módulos y otros módulos (SIU Pilagá, SIU Guaraní, Agentes de cobranza)

<div class="noautonum">__TOC__</div>

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.4.0/requisitos.para.version|Requisitos para la versión]]

== SQ Núcleo ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd nucleo
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.4.0/variables.de.entorno.para.la.instalacion|'''<big>Variables de entorno para la instalación</big>''']] 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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/<big>'''instalador instalación de soluciones SIU'''</big>]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_nucleo.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto NUCLEO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor] 
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''
'''Importante:''' En caso de utilizar solamente la instalación del Núcleo sin módulos adicionales (Académico, G.C.O., SQ-Pagos) se deberá modificar la siguiente variable en el archivo /config/sq.ini<source lang="bash" enclose="div"> [sq_nucleo]
...
...
standalone="true" </source>

== SQ Académico ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd academico
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.4.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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_uv.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto UV>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
# '''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor]
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ G.C.O. ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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/gco.git
cd gco
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.4.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.
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U <mi-usuario> -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/alias.conf /etc/apache2/sites-enabled/gco.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ Pagos ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd sq_pagos
</syntaxhighlight>
#'''Configuración de la instalación''' Editar el archivo config/angular-config.json:<source lang="php" enclose="div">
{
"entorno": "produccion",
"desarrollo": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones al día de la fecha"
}

},
"produccion": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones al día de la fecha"
}

}
}
</source>'''IMPORTANTE:''' Si realiza cambios en este archivo posteriormente a la instalación deberá ejecutar nuevamente el punto 3 (Instalar sistema).
#'''Instalar el sistema''' <source lang="php" enclose="div">export NODE_VERSION=4.5.0
export NVM_DIR=<dir_sq_pagos>/bin/.nvm
git clone https://github.com/creationix/nvm.git $NVM_DIR && cd $NVM_DIR && git checkout `git describe --abbrev=0 --tags`
. $NVM_DIR/nvm.sh && nvm install $NODE_VERSION
echo ". $NVM_DIR/nvm.sh" >> ~/.bashrc
. $NVM_DIR/nvm.sh && nvm use $NODE_VERSION
cd <dir_sq_pagos>
npm install --unsafe-perm
</source>
#'''Editar el archivo sq_pagos.conf''' Se deberá modificar el el valor "path-to-sq-pagos" por la ruta absoluta, por ejemplo: "/var/local/sq_pagos/app" <source lang="php" enclose="div">
Alias /sq_pagos "path-to-sq-pagos/app"
<Directory "path-to-sq-pagos/app/">
Options MultiViews FollowSymLinks
AllowOverride None
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
</Directory>
</source>
#'''Configurar el servidor web Apache''' <source lang="php" enclose="div">
ln -s ./config/sq_pagos.conf /etc/apache2/sites-enabled/sq_pagos.conf
</source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

=== Agente de cobranzas ===

==== [[SIU-Sanaviron-Quilmes/version2.4.0/mercado.pago|Configurar Mercado Pago]] ====

==== [[SIU-Sanaviron-Quilmes/version2.4.0/paypertic|Configurar PayperTic]] ====

SIU-Sanaviron-Quilmes/version2.3.0/instalar sq produccion

2023-06-22T22:26:47Z

Falvez: /* SQ Pagos */

[[Archivo:ISOSIU-SQ.png|derecha|60px|link=SIU-Sanaviron-Quilmes/version2.3.0]]

{{TOClimit|5}}

[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version2.3.0]]

= Esquema de instalación y configuración de SIU-Sanavirón-Quilmes =
[[Archivo:SQ_Comunicacion.v2.png|800px||Comunicación entre Modulos]]
 

'''En esta sección se va a encontrar información sobre:'''
* Requisitos para la instalación.
* Instalación de los distintos sub módulos de SIU Sanaviron Quilmes.
* Configuración para establecer la comunicación entre los distintos sub módulos y otros módulos (SIU Pilagá, SIU Guaraní, Agentes de cobranza)

<div class="noautonum">__TOC__</div>

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.3.0/requisitos.para.version|Requisitos para la versión]]

== SQ Núcleo ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd nucleo
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.0/variables.de.entorno.para.la.instalacion|'''<big>Variables de entorno para la instalación</big>''']] 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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/<big>'''instalador instalación de soluciones SIU'''</big>]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_nucleo.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto NUCLEO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor] 
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''
'''Importante:''' En caso de utilizar solamente la instalación del Núcleo sin módulos adicionales (Académico, G.C.O., SQ-Pagos) se deberá modificar la siguiente variable en el archivo /config/sq.ini<source lang="bash" enclose="div"> [sq_nucleo]
...
...
standalone="true" </source>

== SQ Académico ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd academico
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_uv.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto UV>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
# '''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor]
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ G.C.O. ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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/gco.git
cd gco
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.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.
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U <mi-usuario> -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/alias.conf /etc/apache2/sites-enabled/gco.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ Pagos ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd sq_pagos
</syntaxhighlight>
#'''Configuración de la instalación''' Editar el archivo config/angular-config.json:<source lang="php" enclose="div">
{
"entorno": "produccion",
"desarrollo": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones a posgrados al día de la fecha"
}

},
"produccion": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones a posgrados al día de la fecha"
}

}
}
</source>'''IMPORTANTE:''' Si realiza cambios en este archivo posteriormente a la instalación deberá ejecutar nuevamente el punto 3 (Instalar sistema).
#'''Instalar el sistema''' <source lang="php" enclose="div">export NODE_VERSION=4.5.0
export NVM_DIR=<dir_sq_pagos>/bin/.nvm
git clone https://github.com/creationix/nvm.git $NVM_DIR && cd $NVM_DIR && git checkout `git describe --abbrev=0 --tags`
. $NVM_DIR/nvm.sh && nvm install $NODE_VERSION
echo ". $NVM_DIR/nvm.sh" >> ~/.bashrc
. $NVM_DIR/nvm.sh && nvm use $NODE_VERSION
cd <dir_sq_pagos>
npm install --unsafe-perm
</source>
#'''Editar el archivo sq_pagos.conf''' Se deberá modificar el el valor "path-to-sq-pagos" por la ruta absoluta, por ejemplo: "/var/local/sq_pagos/app" <source lang="php" enclose="div">
Alias /sq_pagos "path-to-sq-pagos/app"
<Directory "path-to-sq-pagos/app/">
Options MultiViews FollowSymLinks
AllowOverride None
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
</Directory>
</source>
#'''Configurar el servidor web Apache''' <source lang="php" enclose="div">
ln -s ./config/sq_pagos.conf /etc/apache2/sites-enabled/sq_pagos.conf
</source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

=== Agente de cobranzas ===

==== [[SIU-Sanaviron-Quilmes/version2.3.0/mercado.pago|Configurar Mercado Pago]] ====

==== [[SIU-Sanaviron-Quilmes/version2.3.0/paypertic|Configurar PayperTic]] ====

SIU-Sanaviron-Quilmes/version2.3.0/instalar sq produccion

2023-06-22T22:26:25Z

Falvez: /* SQ Pagos */

[[Archivo:ISOSIU-SQ.png|derecha|60px|link=SIU-Sanaviron-Quilmes/version2.3.0]]

{{TOClimit|5}}

[[Archivo:Siu-sanaviron-quilmes.png|derecha|link=SIU-Sanaviron-Quilmes/version2.3.0]]

= Esquema de instalación y configuración de SIU-Sanavirón-Quilmes =
[[Archivo:SQ_Comunicacion.v2.png|800px||Comunicación entre Modulos]]
 

'''En esta sección se va a encontrar información sobre:'''
* Requisitos para la instalación.
* Instalación de los distintos sub módulos de SIU Sanaviron Quilmes.
* Configuración para establecer la comunicación entre los distintos sub módulos y otros módulos (SIU Pilagá, SIU Guaraní, Agentes de cobranza)

<div class="noautonum">__TOC__</div>

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.3.0/requisitos.para.version|Requisitos para la versión]]

== SQ Núcleo ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd nucleo
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.0/variables.de.entorno.para.la.instalacion|'''<big>Variables de entorno para la instalación</big>''']] 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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/<big>'''instalador instalación de soluciones SIU'''</big>]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_nucleo.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto NUCLEO>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
#'''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor] 
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''
'''Importante:''' En caso de utilizar solamente la instalación del Núcleo sin módulos adicionales (Académico, G.C.O., SQ-Pagos) se deberá modificar la siguiente variable en el archivo /config/sq.ini<source lang="bash" enclose="div"> [sq_nucleo]
...
...
standalone="true" </source>

== SQ Académico ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd academico
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.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
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar --crear-db </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U www-data -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda '''Importante''': Si utiliza como usuario y grupo www-data deberá agregar el usuario que ejecutará el cron al grupo www-data. El grupo www-data deberá tener permisos de escritura para los usuarios del grupo.
#'''Sacar al sistema de modo mantenimiento''' <source lang="php" enclose="div"> sudo ./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento </source>
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/toba.conf /etc/apache2/sites-enabled/sq_uv.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>
#'''Iniciar el servidor Jasper''' Para poder generar los comprobantes será necesario iniciar el servidor Jasper. <source lang="php" enclose="div">java -jar ./vendor/siu-toba/jasper/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
#'''Configurar el cron''' <source lang="php" enclose="div"> crontab -e </source> Para que el planificador de tareas se ejecute cada un minuto en búsqueda de tareas programadas hay que agregar al crontab la siguiente línea:<source lang="bash" enclose="div"> * * * * * <path proyecto UV>/bin/sq tareas_planificadas </source>'''Nota''': Se ponen los 5 asteriscos para que este comando se ejecute cada un minuto. Este comando se encarga de verificar cada minuto si es el momento de ejecutar determinada tarea según se haya configurado en la operación toba Procesos > Planificador de tareas. Luego guardar el archivo y reiniciar la pc. '''Configurar la ejecución programada de procesos''' En toba hay que ir a la operación Procesos > Planificador de tareas. Por cada proceso se agrega una fila en el formulario multilínea. La idea es que elijan como frecuencia DIARIO y los programen con 30 minutos de separación entre cada proceso.
# '''Iniciar Workers (cola de mensajes)''' Una vez finalizada la instalación o actualización del sistema, este deberá quedar preparado para enviar los mensajes a los sistemas correspondientes. Para que esta cola de mensajes sea leída en forma asíncrona y realice los envíos se debe mantener corriendo el siguiente comando en el servidor:<source lang="bash" enclose="div"> ./bin/sq iniciar_workers </source>Una vez ejecutado el comando, este inicia los workers que quedán a la espera de nuevos mensajes que se enviarán a la cola para posteriormente realizar el envío al destinatario correspondiente. Para que el comando corra de manera ininterrumpida se puede utilizar el siguiente enfoque: [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps Supervisor]
'''Si modifica alguna credencial en el archivo "sq.ini" no tomará los cambios al enviar los mensajes hasta que reinicie los workers.'''

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ G.C.O. ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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/gco.git
cd gco
</syntaxhighlight>Descargar las dependencias mediante Composer<source lang="php" enclose="div"> composer install </source>
#'''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 [[SIU-Sanaviron-Quilmes/version2.3.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.
#'''Instalar el sistema''' El proceso de instalar es simple y estándar, basado en el proyecto para [https://gitlab.siu.edu.ar/siu/instalador instalación de soluciones SIU]. En la misma consola, ejecutar:<source lang="php" enclose="div"> ./bin/instalador proyecto:instalar </source>
#'''Corregir los permisos''' Es imprescindible que se configuren los permisos de forma adecuada. Para ello una forma es asignar permisos de usuario de modo que <mi-usuario> pueda leer, modificar y ejecutar los archivos del proyecto mientras asignar los permisos de grupo al que corre el servidor web para que este pueda acceder a los archivos. Esto se logra ejecutando como administrador:<source lang="php" enclose="div"> sudo ./bin/instalador permisos:simple -U <mi-usuario> -W www-data </source>'''Nota''': Existen otras variantes del esquema de permisos y opciones, ver más con ./bin/instalador ayuda
#'''Configurar el servidor web Apache''' Se proporciona un archivo de configuración muy simple, a modo de guía y con las rutas necesarias. Para probarlo, basta con ejecutar:<source lang="php" enclose="div"> sudo ln -s ./config/alias.conf /etc/apache2/sites-enabled/gco.conf </source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache:<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

Para realizar validaciones generales puede ejecutar el comando
<source lang="php" enclose="div">cd bin
sq validar_instalacion</source>

== SQ Pagos ==

#'''Descarga de fuentes.''' Posicionarse en la ubicación deseada para la 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
cd sq_pagos
</syntaxhighlight>
#'''Configuración de la instalación''' Editar el archivo config/angular-config.json:<source lang="php" enclose="div">
{
"entorno": "desarrollo",
"desarrollo": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones a posgrados al día de la fecha"
}

},
"produccion": {
"config": {
"api_backend_url": "http://ip_servidor/sq_pagos_backend/",
"titulo": "Universidad de prueba :: Plataforma de pagos :: SIU-Sanaviron-Quilmes"
},
"mensajes": {
"inscripciones_sin_inscripciones": "No posee inscripciones a posgrados al día de la fecha"
}

}
}
</source>'''IMPORTANTE:''' Si realiza cambios en este archivo posteriormente a la instalación deberá ejecutar nuevamente el punto 3 (Instalar sistema).
#'''Instalar el sistema''' <source lang="php" enclose="div">export NODE_VERSION=4.5.0
export NVM_DIR=<dir_sq_pagos>/bin/.nvm
git clone https://github.com/creationix/nvm.git $NVM_DIR && cd $NVM_DIR && git checkout `git describe --abbrev=0 --tags`
. $NVM_DIR/nvm.sh && nvm install $NODE_VERSION
echo ". $NVM_DIR/nvm.sh" >> ~/.bashrc
. $NVM_DIR/nvm.sh && nvm use $NODE_VERSION
cd <dir_sq_pagos>
npm install --unsafe-perm
</source>
#'''Editar el archivo sq_pagos.conf''' Se deberá modificar el el valor "path-to-sq-pagos" por la ruta absoluta, por ejemplo: "/var/local/sq_pagos/app" <source lang="php" enclose="div">
Alias /sq_pagos "path-to-sq-pagos/app"
<Directory "path-to-sq-pagos/app/">
Options MultiViews FollowSymLinks
AllowOverride None
<IfModule !mod_authz_core.c>
Order allow,deny
Allow from all
</IfModule>
<IfModule mod_authz_core.c>
Require all granted
</IfModule>
</Directory>
</source>
#'''Configurar el servidor web Apache''' <source lang="php" enclose="div">
ln -s ./config/sq_pagos.conf /etc/apache2/sites-enabled/sq_pagos.conf
</source>Por último, se requiere tener activo el módulo de reescritura de url del servidor web Apache<source lang="php" enclose="div"> sudo a2enmod rewrite
sudo service apache2 restart </source>

=== Agente de cobranzas ===

==== [[SIU-Sanaviron-Quilmes/version2.3.0/mercado.pago|Configurar Mercado Pago]] ====

==== [[SIU-Sanaviron-Quilmes/version2.3.0/paypertic|Configurar PayperTic]] ====

SIU-Sanaviron-Quilmes/version2.3.0/requisitos.para.version

2023-06-15T20:51:08Z

Falvez: /* Instalación */

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.2.0/requisitos.para.version|Requisitos para la versión]]

{| class="wikitable"
|-
! '''''Herramientas''''' !! '''Núcleo''' !! '''Académico''' !! '''G.C.O.'''!! '''SQ Pagos'''
|-
| Git || Si || Si || Si|| Si
|-
| SVN || Si || Si || ||
|-
| Postgres|| 11.x || 11.x || ||
|-
| PHP || 7.4 || 7.4 || 7.4||7.4
|-
| Extensiones PHP || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-curl||
|-
| PHP-Composer || Si || Si || Si
|
|-
| NodeJS || Si
| Si
| || SI
|-
|Bower
|Si
|Si
|
|
|-
|Java
|openjdk version 1.8.0
|openjdk version 1.8.0
|
|
|}

:'''Nota''': La base de datos debe tener la codificación es_AR.UTF8 

PHP Composer: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx

NodeJs: https://nodejs.org/en/download/package-manager

== Instalación ==

Si no tiene instalado Apache y los módulos puede ejecutarlos con la siguiente linea: 
<code>
apt install apache2 libapache2-mod-php7.4 php7.4-cli php7.4-pgsql php7.4-gd php7.4-curl php7.4-mbstring php7.4-dom php7.4-soap php7.4-zip
</code>

Iniciar módulo rewrite 
<code>
a2enmod rewrite
</code>

Instalación de bower

<code>
sudo npm install -g bower
</code>

Definir zona horaria en PHP
<code>date.timezone=America/Argentina/Buenos_Aires</code>

El servidor debe tener configurada la fecha correctamente para que la comunicación entre los sistemas propios y externos no genere inconvenientes.

Se recomienda utilizar el servicio NTP y utilizar los servidores de south-america.pool.ntp.org

Instalación:

<code>
<nowiki>#</nowiki> apt-get install ntp
</code>

<code>
<nowiki>#</nowiki> vi /etc/ntp.conf
</code>

* server 0.south-america.pool.ntp.org
* server 1.south-america.pool.ntp.org
* server 2.south-america.pool.ntp.org
* server 3.south-america.pool.ntp.org

<code>
<nowiki>#</nowiki> /etc/init.d/ntp restart
</code>

SIU-Sanaviron-Quilmes/version2.4.0/requisitos.para.version

2023-06-15T20:51:08Z

Falvez:

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.2.0/requisitos.para.version|Requisitos para la versión]]

{| class="wikitable"
|-
! '''''Herramientas''''' !! '''Núcleo''' !! '''Académico''' !! '''G.C.O.'''!! '''SQ Pagos'''
|-
| Git || Si || Si || Si|| Si
|-
| SVN || Si || Si || ||
|-
| Postgres|| 11.x || 11.x || ||
|-
| PHP || 7.4 || 7.4 || 7.4||7.4
|-
| Extensiones PHP || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-curl||
|-
| PHP-Composer || Si || Si || Si
|
|-
| NodeJS || Si
| Si
| || SI
|-
|Bower
|Si
|Si
|
|
|-
|Java
|openjdk version 1.8.0
|openjdk version 1.8.0
|
|
|}

:'''Nota''': La base de datos debe tener la codificación es_AR.UTF8 

PHP Composer: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx

NodeJs: https://nodejs.org/en/download/package-manager

== Instalación ==

Si no tiene instalado Apache y los módulos puede ejecutarlos con la siguiente linea: 
<code>
apt install apache2 libapache2-mod-php7.4 php7.4-cli php7.4-pgsql php7.4-gd php7.4-curl php7.4-mbstring php7.4-dom php7.4-soap php7.4-zip
</code>

Iniciar módulo rewrite 
<code>
a2enmod rewrite
</code>

Instalación de bower

<code>
sudo npm install -g bower
</code>

Definir zona horaria en PHP
<code>date.timezone=America/Argentina/Buenos_Aires</code>

El servidor debe tener configurada la fecha correctamente para que la comunicación entre los sistemas propios y externos no genere inconvenientes.

Se recomienda utilizar el servicio NTP y utilizar los servidores de south-america.pool.ntp.org

Instalación:

<code>
<nowiki>#</nowiki> apt-get install ntp
</code>

<code>
<nowiki>#</nowiki> vi /etc/ntp.conf
</code>

* server 0.south-america.pool.ntp.org
* server 1.south-america.pool.ntp.org
* server 2.south-america.pool.ntp.org
* server 3.south-america.pool.ntp.org

<code>
<nowiki>#</nowiki> /etc/init.d/ntp restart
</code>

SIU-Sanaviron-Quilmes/version2.3.0/requisitos.para.version

2023-06-15T20:39:40Z

Falvez: /* Instalación */

== Requisitos ==

[[SIU-Sanaviron-Quilmes/version2.2.0/requisitos.para.version|Requisitos para la versión]]

{| class="wikitable"
|-
! '''''Herramientas''''' !! '''Núcleo''' !! '''Académico''' !! '''G.C.O.'''!! '''SQ Pagos'''
|-
| Git || Si || Si || Si|| Si
|-
| SVN || Si || Si || ||
|-
| Postgres|| 11.x || 11.x || ||
|-
| PHP || 7.4 || 7.4 || 7.4||7.4
|-
| Extensiones PHP || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-pgsql, php-gd, php-curl, php-mbstring, php-dom || php-curl||
|-
| PHP-Composer || Si || Si || Si
|
|-
| NodeJS || Si
| Si
| || SI
|-
|Bower
|Si
|Si
|
|
|-
|Java
|openjdk version 1.8.0
|openjdk version 1.8.0
|
|
|}

:'''Nota''': La base de datos debe tener la codificación es_AR.UTF8 

PHP Composer: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx

NodeJs: https://nodejs.org/en/download/package-manager

== Instalación ==

Si no tiene instalado Apache y los módulos puede ejecutarlos con la siguiente linea: 
<code>
apt install apache2 libapache2-mod-php7.4 php7.4-cli php7.4-pgsql php7.4-gd php7.4-curl php7.4-mbstring php7.4-dom php7.4-soap
</code>

Iniciar módulo rewrite 
<code>
a2enmod rewrite
</code>

Instalación de bower

<code>
sudo npm install -g bower
</code>

Definir zona horaria en PHP
<code>date.timezone=America/Argentina/Buenos_Aires</code>

El servidor debe tener configurada la fecha correctamente para que la comunicación entre los sistemas propios y externos no genere inconvenientes.

Se recomienda utilizar el servicio NTP y utilizar los servidores de south-america.pool.ntp.org

Instalación:

<code>
<nowiki>#</nowiki> apt-get install ntp
</code>

<code>
<nowiki>#</nowiki> vi /etc/ntp.conf
</code>

* server 0.south-america.pool.ntp.org
* server 1.south-america.pool.ntp.org
* server 2.south-america.pool.ntp.org
* server 3.south-america.pool.ntp.org

<code>
<nowiki>#</nowiki> /etc/init.d/ntp restart
</code>

Pirapire/version3.0.0/instalacion actualizacion

2022-11-02T22:56:01Z

Falvez: /* Lanzar worker de envío de solicitudes a SQ Núcleo */

[[Archivo:pirapire_iso.png|derecha|link=Pirapire/version3.0.0]] 
[[Pirapire/version_3.0.0|<Volver]]

= Instalación/Actualización del sistema Pirapire =

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema Pirapire fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Requerimientos ==

Para poder comenzar con la instalación debe tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.

Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar.

=== Requisitos LINUX ===
Los requerimientos para instalación/actualización en un servidor GNU/Linux son las siguientes: [http://documentacion.siu.edu.ar/wiki/Pirapire/Version_3.0.0/instalacion_actualizacion/requisitos_previos/linux Instalación manual en GNU/Linux]

=== Tabla de requerimientos de versiones ===
{| class="wikitable"
|-
!Requisito !!Versión
|-
| PostgreSQL
|| 11.x
|-
| Apache
|| 2.4.x
|-
| PHP
|| 7.4.x (con las extensiones: xml, gd, pdo_pgsql, curl, zip).
|-
| Composer
|| 1.10.x
|-
| Git
||
|-
| Yarn
||
|-
| Redis
||
|}

== Instalación ==

La instalación del sistema Pirapire se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación o actualización verificar [[Pirapire/version3.0.0/instalacion actualizacion#Requerimientos|Requerimientos Previos]]
#Descargar el sistema de Pirapire desde el sitio https://gitlab.sistemas.unam.edu.ar/sistemas/pirapire mediante Git.
#Descomprimir el archivo y copiar el directorio Pirapire en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego ingresar al directorio recién descomprimido de Pirapire (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Luego ejecutar el comando para inicializar el archivo de variables de entorno.
#:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>
#:Esto creará el archivo '''instalador.env''', luego configurar con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador podemos configurar por separado la base de datos de negocio de Pirapire y la de Toba, o podemos tener las dos dentro de una misma base de datos como es la opción por defecto, lo recomendable para un ambiente de producción es que tanto los schemas de de la base de datos negocio de Pirapire y los schemas de Toba estén todos dentro de una misma base de datos . Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/Pirapire/version3.0.0/instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación desde cero ===

Para realizar una instalación de cero, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n|Post instalación]]

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

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

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''Pirapire-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 Pirapire

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_pirapire/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_pirapire/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
#echo "Entorno cargado."
#echo "Ejecute 'toba' para ver la lista de comandos disponibles."
</source>

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

=== 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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/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
</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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

== 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:
:<source lang="bash" enclose="div">
less instalador.log
</source>

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

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

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/pirapire/instalacion/toba.conf /etc/apache2/sites-enabled/pirapire.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 Pirapire en un servidor Linux, 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 Pirapire en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Pirapire 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/pirapire/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 Pirapire abriendo en un navegador la dirección url <nowiki>http://servidor.universidad.edu.ar/pirapire</nowiki>.

=== 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/pirapire/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/pirapire/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>

=== Sincronizar medios de pagos de SQ Núcleo ===
Las Condiciones de venta y Medios de pago que están disponible en Pirapire al momento de generar un comprobante se obtienen de SQ Núcleo, al sincronizar mediante el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto sinc_condicion_venta --reportables-pilaga -p pirapire
</source>

Cada vez que se modifican en SQ Núcleo los Medios de pagos o Condiciones de ventas se debe ejecutar este comando para que mantenga sincronizado en Pirapire lo que existe en SQ.

=== Lanzar worker de envío de solicitudes a SQ Núcleo ===
Para que Pirapire envíe las peticiones de generación o anulación de comprobantes a ser procesados por SQ Núcleo, es requerido que este activo y permanentemente ejecutándose el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto worker_envio_sq -p pirapire
</source>

El comando lee la cola de peticiones encoladas en la Redis y ejecuta los procesos de los workers de forma asíncrona con SQ Núcleo.

Para asegurar que el worker este siempre en ejecución una opción es hacerlo mediante un sistema de control de procesos como supervisord (http://supervisord.org/), este se encarga de que el proceso siempre este activo y si se reinicia el servidor el proceso también se inicie.

Se recomienda el siguiente ejemplo de instalación y configuración de [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps supervisord]

El siguiente ejemplo muestra una configuración para el worker, creado en '''/etc/supervisor/conf.d/worker-envio-sq.conf''':

'''''Ejemplo de configuración en Supervisord (worker-envio-sq.conf):'''''

:<source lang="php" enclose="div">
[program:worker-envio-sq]
command=<pirapire-path>/bin/toba proyecto worker_envio_sq -p pirapire
autostart=true
autorestart=true
stderr_logfile=/var/log/worker-envio-sq_err.log
stderr_logfile_maxbytes=2MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
stdout_logfile=/var/log/worker-envio-sq_stdout.log
stdout_logfile_maxbytes=10MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1MB
</source>

==== Actualización del worker ====

Una vez realizada la actualización del sistema el '''<pirapire-path>''' deberá modificarse en el archivo anteriormente configurado. 
Seguido a esto para que el Supervisord tome los cambios correspondientes deberán ejecutarse los siguientes comandos en este orden: 
:<source lang="php" enclose="div">
sudo supervisorctl stop
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start all
</source>

----

[[Pirapire/version_3.0.0|<Volver]]

Pirapire/version3.0.0/instalacion actualizacion

2022-11-02T22:53:12Z

Falvez: /* Sincronizar medios de pagos de SQ Núcleo */

[[Archivo:pirapire_iso.png|derecha|link=Pirapire/version3.0.0]] 
[[Pirapire/version_3.0.0|<Volver]]

= Instalación/Actualización del sistema Pirapire =

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema Pirapire fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Requerimientos ==

Para poder comenzar con la instalación debe tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.

Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar.

=== Requisitos LINUX ===
Los requerimientos para instalación/actualización en un servidor GNU/Linux son las siguientes: [http://documentacion.siu.edu.ar/wiki/Pirapire/Version_3.0.0/instalacion_actualizacion/requisitos_previos/linux Instalación manual en GNU/Linux]

=== Tabla de requerimientos de versiones ===
{| class="wikitable"
|-
!Requisito !!Versión
|-
| PostgreSQL
|| 11.x
|-
| Apache
|| 2.4.x
|-
| PHP
|| 7.4.x (con las extensiones: xml, gd, pdo_pgsql, curl, zip).
|-
| Composer
|| 1.10.x
|-
| Git
||
|-
| Yarn
||
|-
| Redis
||
|}

== Instalación ==

La instalación del sistema Pirapire se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación o actualización verificar [[Pirapire/version3.0.0/instalacion actualizacion#Requerimientos|Requerimientos Previos]]
#Descargar el sistema de Pirapire desde el sitio https://gitlab.sistemas.unam.edu.ar/sistemas/pirapire mediante Git.
#Descomprimir el archivo y copiar el directorio Pirapire en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego ingresar al directorio recién descomprimido de Pirapire (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Luego ejecutar el comando para inicializar el archivo de variables de entorno.
#:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>
#:Esto creará el archivo '''instalador.env''', luego configurar con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador podemos configurar por separado la base de datos de negocio de Pirapire y la de Toba, o podemos tener las dos dentro de una misma base de datos como es la opción por defecto, lo recomendable para un ambiente de producción es que tanto los schemas de de la base de datos negocio de Pirapire y los schemas de Toba estén todos dentro de una misma base de datos . Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/Pirapire/version3.0.0/instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación desde cero ===

Para realizar una instalación de cero, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n|Post instalación]]

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

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

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''Pirapire-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 Pirapire

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_pirapire/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_pirapire/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
#echo "Entorno cargado."
#echo "Ejecute 'toba' para ver la lista de comandos disponibles."
</source>

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

=== 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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/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
</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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

== 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:
:<source lang="bash" enclose="div">
less instalador.log
</source>

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

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

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/pirapire/instalacion/toba.conf /etc/apache2/sites-enabled/pirapire.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 Pirapire en un servidor Linux, 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 Pirapire en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Pirapire 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/pirapire/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 Pirapire abriendo en un navegador la dirección url <nowiki>http://servidor.universidad.edu.ar/pirapire</nowiki>.

=== 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/pirapire/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/pirapire/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>

=== Sincronizar medios de pagos de SQ Núcleo ===
Las Condiciones de venta y Medios de pago que están disponible en Pirapire al momento de generar un comprobante se obtienen de SQ Núcleo, al sincronizar mediante el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto sinc_condicion_venta --reportables-pilaga -p pirapire
</source>

Cada vez que se modifican en SQ Núcleo los Medios de pagos o Condiciones de ventas se debe ejecutar este comando para que mantenga sincronizado en Pirapire lo que existe en SQ.

=== Lanzar worker de envío de solicitudes a SQ Núcleo ===
Para que Pirapire envíe las peticiones de generación o anulación de comprobantes a ser procesados por SQ Núcleo, es requerido que este activo y permanentemente ejecutándose el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto worker_envio_sq -p pirapire
</source>

El comando lee la cola de peticiones encoladas en la Redis y ejecuta los procesos de los workers de forma asíncrona con SQ Núcleo.

Para asegurar que el worker este siempre en ejecución una opción es hacerlo mediante un sistema de control de procesos como supervisord (http://supervisord.org/), este se encarga de que el proceso siempre este activo y si se reinicia el servidor el proceso también se inicie.

Se recomienda el siguiente ejemplo de instalación y configuración de [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps supervisord]

El siguiente ejemplo muestra una configuración para el worker, creado en '''/etc/supervisor/conf.d/worker-envio-sq.conf''':

'''''Ejemplo de configuración en Supervisord (worker-envio-sq.conf):'''''

:<source lang="php" enclose="div">
[program:worker-envio-sq
command=<pirapire-path>/bin/toba proyecto worker_envio_sq -p pirapire
autostart=true
autorestart=true
stderr_logfile=/var/log/worker-envio-sq_err.log
stderr_logfile_maxbytes=2MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
stdout_logfile=/var/log/worker-envio-sq_stdout.log
stdout_logfile_maxbytes=10MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1MB
</source>

==== Actualización del worker ====

Una vez realizada la actualización del sistema el '''<pirapire-path>''' deberá modificarse en el archivo anteriormente configurado. 
Seguido a esto para que el Supervisord tome los cambios correspondientes deberán ejecutarse los siguientes comandos en este orden: 
:<source lang="php" enclose="div">
sudo supervisorctl stop
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start all
</source>

----

[[Pirapire/version_3.0.0|<Volver]]

Pirapire/version3.0.0/instalacion actualizacion

2022-11-02T22:52:49Z

Falvez:

[[Archivo:pirapire_iso.png|derecha|link=Pirapire/version3.0.0]] 
[[Pirapire/version_3.0.0|<Volver]]

= Instalación/Actualización del sistema Pirapire =

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema Pirapire fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Requerimientos ==

Para poder comenzar con la instalación debe tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.

Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar.

=== Requisitos LINUX ===
Los requerimientos para instalación/actualización en un servidor GNU/Linux son las siguientes: [http://documentacion.siu.edu.ar/wiki/Pirapire/Version_3.0.0/instalacion_actualizacion/requisitos_previos/linux Instalación manual en GNU/Linux]

=== Tabla de requerimientos de versiones ===
{| class="wikitable"
|-
!Requisito !!Versión
|-
| PostgreSQL
|| 11.x
|-
| Apache
|| 2.4.x
|-
| PHP
|| 7.4.x (con las extensiones: xml, gd, pdo_pgsql, curl, zip).
|-
| Composer
|| 1.10.x
|-
| Git
||
|-
| Yarn
||
|-
| Redis
||
|}

== Instalación ==

La instalación del sistema Pirapire se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación o actualización verificar [[Pirapire/version3.0.0/instalacion actualizacion#Requerimientos|Requerimientos Previos]]
#Descargar el sistema de Pirapire desde el sitio https://gitlab.sistemas.unam.edu.ar/sistemas/pirapire mediante Git.
#Descomprimir el archivo y copiar el directorio Pirapire en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego ingresar al directorio recién descomprimido de Pirapire (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Luego ejecutar el comando para inicializar el archivo de variables de entorno.
#:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>
#:Esto creará el archivo '''instalador.env''', luego configurar con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador podemos configurar por separado la base de datos de negocio de Pirapire y la de Toba, o podemos tener las dos dentro de una misma base de datos como es la opción por defecto, lo recomendable para un ambiente de producción es que tanto los schemas de de la base de datos negocio de Pirapire y los schemas de Toba estén todos dentro de una misma base de datos . Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/Pirapire/version3.0.0/instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación desde cero ===

Para realizar una instalación de cero, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n|Post instalación]]

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

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

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''Pirapire-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 Pirapire

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_pirapire/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_pirapire/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
#echo "Entorno cargado."
#echo "Ejecute 'toba' para ver la lista de comandos disponibles."
</source>

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

=== 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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/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
</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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

== 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:
:<source lang="bash" enclose="div">
less instalador.log
</source>

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

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

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/pirapire/instalacion/toba.conf /etc/apache2/sites-enabled/pirapire.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 Pirapire en un servidor Linux, 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 Pirapire en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Pirapire 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/pirapire/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 Pirapire abriendo en un navegador la dirección url <nowiki>http://servidor.universidad.edu.ar/pirapire</nowiki>.

=== 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/pirapire/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/pirapire/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>

=== Sincronizar medios de pagos de SQ Núcleo ===
Las Condiciones de venta y Medios de pago que están disponible en Pirapire al momento de generar un comprobante se obtienen de SQ Núcleo, al sincronizar mediante el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto sinc_condicion_venta --reportables-pilaga -ppirapire
</source>

Cada vez que se modifican en SQ Núcleo los Medios de pagos o Condiciones de ventas se debe ejecutar este comando para que mantenga sincronizado en Pirapire lo que existe en SQ.

=== Lanzar worker de envío de solicitudes a SQ Núcleo ===
Para que Pirapire envíe las peticiones de generación o anulación de comprobantes a ser procesados por SQ Núcleo, es requerido que este activo y permanentemente ejecutándose el siguiente comando:

<source lang="bash" enclose="div">
./bin/toba proyecto worker_envio_sq -p pirapire
</source>

El comando lee la cola de peticiones encoladas en la Redis y ejecuta los procesos de los workers de forma asíncrona con SQ Núcleo.

Para asegurar que el worker este siempre en ejecución una opción es hacerlo mediante un sistema de control de procesos como supervisord (http://supervisord.org/), este se encarga de que el proceso siempre este activo y si se reinicia el servidor el proceso también se inicie.

Se recomienda el siguiente ejemplo de instalación y configuración de [https://www.digitalocean.com/community/tutorials/how-to-install-and-manage-supervisor-on-ubuntu-and-debian-vps supervisord]

El siguiente ejemplo muestra una configuración para el worker, creado en '''/etc/supervisor/conf.d/worker-envio-sq.conf''':

'''''Ejemplo de configuración en Supervisord (worker-envio-sq.conf):'''''

:<source lang="php" enclose="div">
[program:worker-envio-sq
command=<pirapire-path>/bin/toba proyecto worker_envio_sq -p pirapire
autostart=true
autorestart=true
stderr_logfile=/var/log/worker-envio-sq_err.log
stderr_logfile_maxbytes=2MB
stderr_logfile_backups=10
stderr_capture_maxbytes=1MB
stdout_logfile=/var/log/worker-envio-sq_stdout.log
stdout_logfile_maxbytes=10MB
stdout_logfile_backups=10
stdout_capture_maxbytes=1MB
</source>

==== Actualización del worker ====

Una vez realizada la actualización del sistema el '''<pirapire-path>''' deberá modificarse en el archivo anteriormente configurado. 
Seguido a esto para que el Supervisord tome los cambios correspondientes deberán ejecutarse los siguientes comandos en este orden: 
:<source lang="php" enclose="div">
sudo supervisorctl stop
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start all
</source>

----

[[Pirapire/version_3.0.0|<Volver]]

Pirapire/version3.0.0/instalacion actualizacion

2022-08-17T17:57:10Z

Falvez: /* Instalación desde cero */

[[Archivo:pirapire_iso.png|derecha|link=Pirapire/version3.0.0]] 
[[Pirapire/version_3.0.0|<Volver]]

= Instalación/Actualización del sistema Pirapire =

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema Pirapire fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Requerimientos ==

Para poder comenzar con la instalación debe tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.

Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar.

=== Requisitos LINUX ===
Los requerimientos para instalación/actualización en un servidor GNU/Linux son las siguientes: [http://documentacion.siu.edu.ar/wiki/Pirapire/Version_3.0.0/instalacion_actualizacion/requisitos_previos/linux Instalación manual en GNU/Linux]

=== Tabla de requerimientos de versiones ===
{| class="wikitable"
|-
!Requisito !!Versión
|-
| PostgreSQL
|| 11.x
|-
| Apache
|| 2.4.x
|-
| PHP
|| 7.4.x (con las extensiones: xml, gd, pdo_pgsql, curl, zip).
|-
| Composer
|| 1.10.x
|-
| Git
||
|-
| Yarn
||
|-
| Redis
||
|}

== Instalación ==

La instalación del sistema Pirapire se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación o actualización verificar [[Pirapire/version3.0.0/instalacion actualizacion#Requerimientos|Requerimientos Previos]]
#Descargar el sistema de Pirapire desde el sitio https://gitlab.sistemas.unam.edu.ar/sistemas/pirapire mediante Git.
#Descomprimir el archivo y copiar el directorio Pirapire en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego ingresar al directorio recién descomprimido de Pirapire (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Luego ejecutar el comando para inicializar el archivo de variables de entorno.
#:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>
#:Esto creará el archivo '''instalador.env''', luego configurar con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador podemos configurar por separado la base de datos de negocio de Pirapire y la de Toba, o podemos tener las dos dentro de una misma base de datos como es la opción por defecto, lo recomendable para un ambiente de producción es que tanto los schemas de de la base de datos negocio de Pirapire y los schemas de Toba estén todos dentro de una misma base de datos . Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/Pirapire/version3.0.0/instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación desde cero ===

Para realizar una instalación de cero, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n|Post instalación]]

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

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

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''Pirapire-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 Pirapire

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_pirapire/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_pirapire/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
#echo "Entorno cargado."
#echo "Ejecute 'toba' para ver la lista de comandos disponibles."
</source>

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

=== 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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Una vez realizado lo explicado en el ítem de [[Pirapire/Version_3.0.0/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
</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 [[Pirapire/Version_3.0.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

== 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:
:<source lang="bash" enclose="div">
less instalador.log
</source>

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

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

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/pirapire/instalacion/toba.conf /etc/apache2/sites-enabled/pirapire.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 Pirapire en un servidor Linux, 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 Pirapire en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Pirapire 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/pirapire/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 Pirapire abriendo en un navegador la dirección url <nowiki>http://servidor.universidad.edu.ar/pirapire</nowiki>.

=== 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/pirapire/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/pirapire/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>

[[Pirapire/version_3.0.0|<Volver]]

Pirapire/version3.0.0/instalacion actualizacion/instalador env vars

2022-07-06T20:50:24Z

Falvez: /* Configuración para uso de Workers */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="20%"| Variable de entorno
!width="50%"| Descripción
!width="30%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://pirapire.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>pirapire/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/pirapire</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_pirapire</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_PILAGA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="40%"| Descripción
!width="35%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración para uso de Redis ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REDIS_HOST
| Host del servicio Redis
|-
| REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Se utiliza para validar conexión al servidor redis y configurar en el sistema para el envío de peticiones asincronas a SQ Núcleo.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="30%"| Variable de entorno
!width="70%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración para uso de Workers ==

{| class="wikitable"
!width="35%"| Variable de entorno
!width="35%"| Descripción
!width="30%"| Valor por defecto
|-
| WORKER_TRANSPORT
| Mecanismo por el cual se utiliza para encolar las peticiones de los workers.
| <code>redis</code>
|-
| WORKER_REINTENTOS
| Cantidad de reintentos en el caso que el envio de una petición falle.
| <code>5</code>
|-
| WORKER_RETRASO
| Tiempo en milisegundos de retraso entre peticiones en una cola. El tiempo va aumentando exponencialmente entre reintentos.
| <code>2000</code>
|-
| WORKER_EXPIRACION
| Opcional, tiempo de expiración de una petición dentro de una cola.
|
|-
| WORKER_PRIORIDAD
| Opcional, prioridad de un mensaje en la cola.
|
|}

Pirapire/version3.1.0/instalacion actualizacion/instalador env vars

2022-07-06T20:50:24Z

Falvez:

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="20%"| Variable de entorno
!width="50%"| Descripción
!width="1%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://pirapire.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>pirapire/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/pirapire</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_pirapire</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_PILAGA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="40%"| Descripción
!width="35%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración para uso de Redis ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REDIS_HOST
| Host del servicio Redis
|-
| REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Se utiliza para validar conexión al servidor redis y configurar en el sistema para el envío de peticiones asincronas a SQ Núcleo.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="1%"| Variable de entorno
!width="70%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración para uso de Workers ==

{| class="wikitable"
!width="35%"| Variable de entorno
!width="35%"| Descripción
!width="1%"| Valor por defecto
|-
| WORKER_TRANSPORT
| Mecanismo por el cual se utiliza para encolar las peticiones de los workers.
| <code>redis</code>
|-
| WORKER_REINTENTOS
| Cantidad de reintentos en el caso que el envio de una petición falle.
| <code>5</code>
|-
| WORKER_RETRASO
| Tiempo en milisegundos de retraso entre peticiones en una cola. El tiempo va aumentando exponencialmente entre reintentos.
| <code>2000</code>
|-
| WORKER_EXPIRACION
| Opcional, tiempo de expiración de una petición dentro de una cola.
|
|-
| WORKER_PRIORIDAD
| Opcional, prioridad de un mensaje en la cola.
|
|}

Pirapire/version3.0.0/instalacion actualizacion/instalador env vars

2022-07-06T20:49:19Z

Falvez: /* Configuración para uso de Workers */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="20%"| Variable de entorno
!width="50%"| Descripción
!width="30%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://pirapire.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>pirapire/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/pirapire</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_pirapire</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_PILAGA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="40%"| Descripción
!width="35%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración para uso de Redis ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REDIS_HOST
| Host del servicio Redis
|-
| REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Se utiliza para validar conexión al servidor redis y configurar en el sistema para el envío de peticiones asincronas a SQ Núcleo.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="30%"| Variable de entorno
!width="70%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración para uso de Workers ==

{| class="wikitable"
!width="35%"| Variable de entorno
!width="35%"| Descripción
!width="30%"| Valor por defecto
|-
| WORKER_TRANSPORT
| Mecanismo por el cual se utiliza para encolar las peticiones de los workers.
| <code>redis</code>
|-
| WORKER_REINTENTOS
| Cantidad de reintentos en el caso que el envio de una petición falle.
| <code>5</code>
|-
| WORKER_RETRASO
| Tiempo en milisegundos de retraso entre peticiones en una cola.
| <code>2000</code>
|-
| WORKER_EXPIRACION
| Opcional, tiempo de expiración de una petición dentro de una cola.
|
|-
| WORKER_PRIORIDAD
| Opcional, prioridad de un mensaje en la cola.
|
|}

Pirapire/version3.0.0/instalacion actualizacion/instalador env vars

2022-07-06T20:49:01Z

Falvez: /* Configuración para uso de Workers */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="20%"| Variable de entorno
!width="50%"| Descripción
!width="30%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://pirapire.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>pirapire/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/pirapire</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_pirapire</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_PILAGA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="40%"| Descripción
!width="35%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración para uso de Redis ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REDIS_HOST
| Host del servicio Redis
|-
| REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Se utiliza para validar conexión al servidor redis y configurar en el sistema para el envío de peticiones asincronas a SQ Núcleo.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="30%"| Variable de entorno
!width="70%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración para uso de Workers ==

{| class="wikitable"
!width="35%"| Variable de entorno
!width="35%"| Descripción
!width="30%"| Valor por defecto
|-
| WORKER_TRANSPORT
| Mecanismo por el cual se utiliza para encolar las peticiones de los workers.
| <code>redis</code>
|-
| WORKER_REINTENTOS
| Cantidad de reintentos en el caso que el envio de una petición falle.
| <code>5</code>
|-
| WORKER_RETRASO
| Tiempo en milisegundos de retraso entre peticiones en una cola.
| <code>2000</code>
|-
| WORKER_EXPIRACION
| Opcional, tiempo de expiración de una petición dentro de una cola.
| <code></code>
|-
| WORKER_PRIORIDAD
| Opcional, prioridad de un mensaje en la cola.
| <code></code>
|}

Pirapire/version3.0.0/instalacion actualizacion/instalador env vars

2022-07-06T20:47:56Z

Falvez: /* Configuración para uso de API REST */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="20%"| Variable de entorno
!width="50%"| Descripción
!width="30%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://pirapire.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>pirapire/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/pirapire</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_pirapire</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_PILAGA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="40%"| Descripción
!width="35%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración para uso de Redis ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REDIS_HOST
| Host del servicio Redis
|-
| REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Se utiliza para validar conexión al servidor redis y configurar en el sistema para el envío de peticiones asincronas a SQ Núcleo.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="30%"| Variable de entorno
!width="70%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración para uso de Workers ==

{| class="wikitable"
!width="35%"| Variable de entorno
!width="35%"| Descripción
!width="30%"| Valor por defecto
|-
| WORKER_TRANSPORT
| Mecanismo por el cual se utiliza para encolar las peticiones de los workers.
| <code>redis</code>
|-
| WORKER_REINTENTOS
| Cantidad de reintentos en el caso que el envio de una petición falle.
| <code>5</code>
|-
| WORKER_RETRASO
| Tiempo en milisegundos de retraso entre peticiones en una cola.
| <code>2000</code>
|-
| WORKER_EXPIRACION
| Opcional, tiempo de expiración de una petición dentro de una cola.
|-
| WORKER_PRIORIDAD
| Opcional, prioridad de un mensaje en la cola.
|}

Pirapire/version3.0.0/instalacion actualizacion/instalador env vars

2022-07-06T20:47:31Z

Falvez: /* Configuración interna de Toba */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="20%"| Variable de entorno
!width="50%"| Descripción
!width="30%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://pirapire.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>pirapire/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/pirapire</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_pirapire</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_PILAGA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="40%"| Descripción
!width="35%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración para uso de Redis ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REDIS_HOST
| Host del servicio Redis
|-
| REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Se utiliza para validar conexión al servidor redis y configurar en el sistema para el envío de peticiones asincronas a SQ Núcleo.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración para uso de Workers ==

{| class="wikitable"
!width="35%"| Variable de entorno
!width="35%"| Descripción
!width="30%"| Valor por defecto
|-
| WORKER_TRANSPORT
| Mecanismo por el cual se utiliza para encolar las peticiones de los workers.
| <code>redis</code>
|-
| WORKER_REINTENTOS
| Cantidad de reintentos en el caso que el envio de una petición falle.
| <code>5</code>
|-
| WORKER_RETRASO
| Tiempo en milisegundos de retraso entre peticiones en una cola.
| <code>2000</code>
|-
| WORKER_EXPIRACION
| Opcional, tiempo de expiración de una petición dentro de una cola.
|-
| WORKER_PRIORIDAD
| Opcional, prioridad de un mensaje en la cola.
|}

Pirapire/version3.0.0/instalacion actualizacion/instalador env vars

2022-07-06T20:46:51Z

Falvez: /* Configuración de la base de datos de negocio */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="9%"| Variable de entorno
!width="24%"| Descripción
!width="7%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://pirapire.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>pirapire/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/pirapire</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_pirapire</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_PILAGA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="40%"| Descripción
!width="35%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración para uso de Redis ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REDIS_HOST
| Host del servicio Redis
|-
| REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Se utiliza para validar conexión al servidor redis y configurar en el sistema para el envío de peticiones asincronas a SQ Núcleo.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="40%"| Variable de entorno
!width="60%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración para uso de Workers ==

{| class="wikitable"
!width="35%"| Variable de entorno
!width="35%"| Descripción
!width="30%"| Valor por defecto
|-
| WORKER_TRANSPORT
| Mecanismo por el cual se utiliza para encolar las peticiones de los workers.
| <code>redis</code>
|-
| WORKER_REINTENTOS
| Cantidad de reintentos en el caso que el envio de una petición falle.
| <code>5</code>
|-
| WORKER_RETRASO
| Tiempo en milisegundos de retraso entre peticiones en una cola.
| <code>2000</code>
|-
| WORKER_EXPIRACION
| Opcional, tiempo de expiración de una petición dentro de una cola.
|-
| WORKER_PRIORIDAD
| Opcional, prioridad de un mensaje en la cola.
|}