Configuración#
Empowerment Center se configura en el servidor, con variables de entorno y, para lo que tiene estructura, con un fichero application.yml propio. Esta parte es la referencia de todo lo que se puede configurar, con su valor por defecto y cuándo conviene cambiarlo.
Casi todo trae un valor por defecto pensado para una instalación normal. Lo imprescindible está en Variables de entorno.
Las páginas de la referencia#
| Página | Qué configura |
|---|---|
| Variables de entorno | Las variables de la instalación: las obligatorias, las del backend, las del frontal y las de Docker Compose. |
| Recursos, trabajos y consultas | La memoria, la BD propia, los pools de las BD de los clientes, las colas de trabajos, las consultas, los cubos, los gráficos, los formularios, las listas, los datos externos y las agrupaciones. |
| Correo y avisos | El servidor de correo, el remitente, los avisos de la operación y de la planificación, y las suscripciones y alertas de datos. |
| Sesiones, seguridad y licencia | Las sesiones, el retardo tras intentos fallidos, la clave de los secretos, las credenciales de servicio, la licencia y la pantalla de entrada. |
| Operación, auditoría y planificación | Las alertas operativas, el mantenimiento, la actividad de la consola, la auditoría, el planificador, las copias de los libros, las plantillas y el metadata. |
| Servicios: render, mapas, API y MCP | El navegador sin interfaz, los mapas y el motor de rutas, la API de consulta, el servidor MCP, la incrustación y el puerto de gestión. |
El inicio de sesión único (OIDC y SAML) y SCIM se configuran como se explica en Seguridad.
Propiedades y variables#
Cada opción tiene un nombre de propiedad, como ecenter.jobs.max-queued-per-user, y se puede dar como variable de entorno con las reglas de Spring Boot:
- Se escribe en mayúsculas.
- Los puntos se cambian por
_. - Los guiones se quitan.
| Propiedad | Variable de entorno |
|---|---|
ecenter.jobs.max-queued-per-user |
ECENTER_JOBS_MAXQUEUEDPERUSER |
ecenter.operations.notifications.mode |
ECENTER_OPERATIONS_NOTIFICATIONS_MODE |
ecenter.datasource.pool.max-size |
ECENTER_DATASOURCE_POOL_MAXSIZE |
spring.datasource.hikari.maximum-pool-size |
SPRING_DATASOURCE_HIKARI_MAXIMUMPOOLSIZE o SPRING_DATASOURCE_HIKARI_MAXIMUM_POOL_SIZE |
Algunas opciones tienen además una variable corta propia, como ECENTER_SESSION_TIMEOUT para spring.session.timeout. Están en Variables de entorno.
Las listas (varios destinatarios, varios dominios) y los mapas (un valor por clase de trabajo) se escriben mejor en el application.yml propio. Como variable, una lista se puede dar separada por comas (ECENTER_OPERATIONS_NOTIFICATIONS_RECIPIENTS=sistemas@example.org,guardia@example.org).
Formatos#
| Tipo | Cómo se escribe | Ejemplos |
|---|---|---|
| Duración | Un número y su unidad: ms, s, m, h o d. |
500ms, 30s, 5m, 12h, 90d |
| Tamaño | Un número y su unidad: KB, MB o GB. |
256KB, 100MB, 1GB |
| Sí o no | true o false. |
ECENTER_MCP_ENABLED=true |
| Zona horaria | Un identificador de zona. | Europe/Madrid, Atlantic/Canary |
Un valor que no vale (una duración negativa, un porcentaje fuera de rango) impide arrancar al backend, y su registro dice qué propiedad está mal y por qué: por ejemplo, «ecenter.operations.alerts.memory-percent va de 1 a 100».
Un application.yml propio#
Para lo que tiene estructura (los proveedores de identidad, el mapa base, los enlaces del pie de la pantalla de entrada, las listas de destinatarios), monte un fichero en el backend:
# deploy/compose.yaml, servicio backend
volumes:
- ./config/application.yml:/opt/ecenter/config/application.yml:ro
Y escriba en él las propiedades con su estructura:
# deploy/config/application.yml
ecenter:
about:
login-help: ¿Problemas para entrar? Llame a la extensión 1234
links:
- label: Aviso legal
url: https://intranet.example.org/aviso-legal
operations:
notifications:
mode: CRITICAL
recipients: [sistemas@example.org]
Sin contenedores, el fichero va en la carpeta config/ del directorio de trabajo del backend.
Qué manda sobre qué. Las variables de entorno mandan sobre el application.yml propio, y este sobre los valores por defecto de la aplicación. Si una opción no cambia al editar el fichero, compruebe que no está también en deploy/.env.
Cuándo se aplica. La configuración se lee al arrancar. Tras cambiarla, vuelva a crear el backend (docker compose -f deploy/compose.yaml up -d backend, que lo recrea si cambia .env) o reinícielo (docker compose -f deploy/compose.yaml restart backend, si solo cambió el application.yml).
Importante
En deploy/.env, una variable vacía cuenta como definida. SPRING_MAIL_HOST= sin valor no es lo mismo que no poner la variable. Para dejar una opción con su valor por defecto, quite la línea o coméntela con #.
Ver la configuración en vigor#
Administración › Operación › Políticas enseña lo que está en vigor de las alertas, los avisos por correo, el mantenimiento, la conservación de los resultados, las copias de los libros, las plantillas y el metadata, el bloqueo de los libros y la caducidad de las sesiones. Se lee del servidor: es la forma de comprobar que un cambio se ha aplicado.
