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

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 # 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 TOBA_PROYECTO_DIR y TOBA_INSTALACION_DIR, esto es útil para casos especiales.

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

Configuración del instalador

Variable de entorno	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 1 es producción, 0 solo en casos de ambientes de desarrollo

Configuración interna de Toba

Variable de entorno	Descripción	Valor por defecto
TOBA_URL_BASE	La url base pública de acceso al sistema, sin alias del proyecto. Ej: https://pirapire.institucion.edu.ar	http://localhost
TOBA_USUARIO	El usuario administrador del proyecto, en caso de actualización dejar valor por defecto	toba
TOBA_PASSWORD	El password del usuario administrador, en caso de actualización dejar valor por defecto	toba123*-a
TOBA_INSTALACION_DIR	Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.	pirapire/instalacion
TOBA_PROYECTO_DIR	Opcional, el directorio donde está el proyecto toba
TOBA_ALIAS_PROYECTO	El alias Apache para el acceso al proyecto	/pirapire
TOBA_ALIAS_NUCLEO	Opcional, el alias Apache para acceso al núcleo de Toba	/toba_pirapire
TOBA_ALIAS_TOBA_USUARIOS	Opcional, el alias Apache para el acceso al proyecto Toba-usuarios	/toba_usuarios
TOBA_ALIAS_TOBA_EDITOR	Opcional, el alias Apache para el acceso al proyecto Toba-editor	/toba_editor
TOBA_ALIAS_TOBA_REFERENCIA	Opcional, el alias Apache para el acceso al proyecto Toba-referencia	/toba_referencia
TOBA_ID_DESARROLLADOR	Opcional, el id desarrollador toba.	0
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	TOBA_PILAGA
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	Off
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

Variable de entorno	Descripción	Valor por defecto
PROYECTO_DB_HOST	el host/ip del equipo donde corre la base de datos	localhost
PROYECTO_DB_PORT	el puerto donde corre la base de datos	5432
PROYECTO_DB_DBNAME	el nombre de la base de datos de negocio	db_proyecto
PROYECTO_DB_USERNAME	el usuario para la conectarse a la base de datos	postgres
PROYECTO_DB_PASSWORD	la clave del usuario para conectarse a la base de datos	postgres
PROYECTO_DB_SCHEMA	el nombre del esquema dentro de la base de datos	public
PROYECTO_DB_ENCODING	la codificación de caracteres de la base de datos	LATIN1

Configuración de la base de datos de Toba

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

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

Configuración para uso de Redis

Variable de entorno	Descripción
REDIS_HOST	Host del servicio Redis
REDIS_PORT	Puerto del servicio Redis

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.

Configuración para uso de SSO vía IDP

Variable de entorno	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 0 y 1
SSO_SP_AUTH_SOURCE	El auth source del SP, por defecto suele ser default-sp
SSO_SP_COOKIE_NAME	Nombre de la cookie manejada por OneLogin, por ej. TOBA_SESSID
SSO_SP_IDP_NAME	Nombre del IDP

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

Configuración para uso de API REST

Variable de entorno	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 basic o digest
REST_SERVIDOR_AUTH	El tipo de autenticación del servidor REST basic o digest
REST_ARAI_SYNC_KEY_FILE	Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí arai-sync.key

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

Configuración para uso de la API de AFIP

Variable de entorno	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).

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

Configuración para uso de Workers

Variable de entorno	Descripción	Valor por defecto
WORKER_TRANSPORT	Mecanismo por el cual se utiliza para encolar las peticiones de los workers.	redis
WORKER_REINTENTOS	Cantidad de reintentos en el caso que el envio de una petición falle.	5
WORKER_RETRASO	Tiempo en milisegundos de retraso entre peticiones en una cola. El tiempo va aumentando exponencialmente entre reintentos.	2000
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.