Manual de administración#
Este manual explica cómo se instala, se configura, se asegura, se opera y se integra Empowerment Center 8.0. Está pensado para quien tiene que dejar ECenter funcionando y mantenerlo así, con todos los datos exactos: variables, puertos, rutas, privilegios y códigos de error.
A quién va dirigido#
| Perfil | Qué hace con ECenter | Por dónde empezar |
|---|---|---|
| Ingeniero de sistemas | Prepara los servidores, instala los contenedores, pone el proxy y el certificado, hace las copias y actualiza de versión. | Arquitectura e Instalación |
| Administrador de la aplicación | Instala la licencia, da de alta las conexiones, los usuarios y los roles, vigila la consola de operación y la auditoría. | Primer arranque y puesta en marcha y Seguridad |
| Diseñador del metadata | Describe las bases de datos de los clientes para que los usuarios puedan analizarlas: tablas de hechos, dimensiones, métricas, relaciones, privilegios y universos. | Conexiones y Metadata |
| Responsable de integraciones | Conecta ECenter con otras aplicaciones: la API de consulta, el servidor MCP, la incrustación y el intercambio del metadata. | Integraciones |
Quien usa ECenter para analizar datos o leer el portal tiene su propio Manual de usuario. Los términos que se repiten en los dos manuales están en el Glosario.
Los dos manuales van con la instalación, en /ayuda/ (https://ecenter.example.org/ayuda/), y se abren desde el menú Ayuda de la aplicación: Ayuda de esta pantalla (F1), Manual de usuario y, para quien ve alguna entrada de Administración, Manual de administración. Cómo los sirve el frontal y cómo se mantiene la ayuda de cada pantalla está en Los manuales en /ayuda/.
Organización del manual#
El manual sigue el orden en que se pone en marcha una instalación.
Instalar
- Arquitectura: las piezas que forman ECenter, qué guarda cada una y cómo viaja una petición. Sus requisitos de hardware, software y red.
- Instalación: con Docker Compose o sin contenedores, el proxy inverso y TLS, la licencia, los servicios opcionales y la lista de comprobación de la puesta en marcha.
- Configuración: la referencia de todas las variables de entorno y propiedades, con su valor por defecto y cuándo conviene cambiarlas.
- Mantenimiento: copias de seguridad, restauración, actualizaciones de versión, registros y limpieza.
Asegurar
- Seguridad: usuarios y roles, la referencia de privilegios, sesiones y retardo tras intentos fallidos, inicio de sesión único (OIDC y SAML), aprovisionamiento por SCIM, universos y seguridad por columnas.
Preparar los datos
- Conexiones: las bases de datos de los clientes (Oracle, SQL Server y PostgreSQL) y su catálogo.
- Metadata: el editor del metadata, exportarlo e importarlo, sus copias y la validación del contenido.
- Capas geográficas: las capas de los mapas y los motores de rutas.
Operar
- Operación: la consola de operación, las alertas operativas, las métricas y la salud.
- Auditoría: qué queda registrado, cómo se busca y se exporta, y cuánto se conserva.
- Planificación: procedimientos programados, grupos de recálculo y avisos.
- Solución de problemas: síntomas frecuentes y códigos de error.
Integrar y migrar
- Integraciones: credenciales de servicio, API de consulta, servidor MCP, incrustación e intercambio del metadata sin sesión.
- Migración desde EC7: el importador de instalaciones de Empowerment Center 7.
Convenciones#
| Convención | Significado |
|---|---|
| Negrita | Un texto de la interfaz tal como aparece: un botón, una pestaña, un menú o un mensaje. |
| Administración › Licencia | Un camino por la barra lateral o por los menús de la aplicación. |
monoespaciado |
Una variable de entorno, una propiedad, un fichero, una ruta, una URL o un valor literal. |
ecenter.jobs.max-queued-per-user |
Una propiedad de configuración. Su variable de entorno equivalente se forma como se explica en Configuración. |
30s, 5m, 12h, 90d |
Duraciones: segundos, minutos, horas y días, como se escriben en la configuración. |
100MB, 1GB |
Tamaños, como se escriben en la configuración del servidor. |
| Ctrl+K | Una combinación de teclas. |
En los ejemplos se usan nombres y valores evidentes, como ecenter.example.org o cambie-esta-clave. Sustitúyalos por los de su instalación.
Los códigos de error que se citan (por ejemplo, LICENSE_INVALID) son los que devuelve el servidor en el campo code de la respuesta. La aplicación los traduce a un mensaje; los clientes de la API los reciben tal cual.
Administración del Sistema#
Casi todo lo que describe este manual exige el privilegio Administración del Sistema. Es el privilegio que lo abre todo:
- Quien lo tiene recibe a la vez todos los demás privilegios del sistema: Administración del Metadata, Administración de Usuarios, Administración de Libros, Administración del Portal, Acceso a Empowerment Center, Acceso al Portal y los demás de la referencia de privilegios.
- Da acceso a lo que solo él permite: la licencia, las conexiones, la consola de operación, la auditoría, las credenciales de servicio de toda la instalación, la incrustación, los grupos de recálculo y los procedimientos programados de la planificación, y el importador de Empowerment Center 7.
- Solo quien tiene Administración del Sistema puede darla o quitarla, y cambiar la contraseña, el estado, el login o el correo de otro usuario que la tenga. Si alguien sin ella lo intenta, el servidor responde 403
ADMIN_SYSTEM_REQUIRED. - ECenter no deja que una instalación se quede sin ningún administrador del sistema que pueda entrar con contraseña.
Nota
Administración del Sistema implica los privilegios del sistema, no los privilegios de datos que crea el diseñador del metadata para proteger dimensiones y métricas. Un administrador del sistema no ve por serlo una columna protegida con un privilegio de datos: necesita ese privilegio en alguno de sus roles, como cualquier otro usuario. Los detalles están en Seguridad.
El rol inicial Administrador Sistema lleva este privilegio. Lo recibe el primer administrador que se crea al instalar (véase Primer arranque y puesta en marcha). Conviene que lo tengan pocas personas y que cada una entre con su propio usuario: la auditoría anota quién hace cada cosa.
Versión#
Este manual describe Empowerment Center 8.0 (versión del servidor 8.0.0). La versión instalada se ve en la pantalla de entrada, en Acerca de Empowerment Center, del menú Ayuda (el icono de interrogación de la barra superior), y en Administración › Operación › Resumen, y la devuelve GET /api/about.