Instalación
Breadcrumbs

Instalación

Esta documentación recoge los requerimientos técnicos y arquitectónicos necesarios para desplegar la plataforma Anjana Data y/o sus plugins en infraestructuras del cliente, ya sea en entornos IaaS, PaaS, SaaS Hybrid u OnPremise.

El objetivo es ofrecer una guía clara y estructurada sobre:

  • Sistemas operativos, bases de datos y tecnologías soportadas.

  • Condiciones y prerequisitos para el despliegue.

  • Mapa de software y componentes principales.

  • Conectividad necesaria entre nodos y servicios externos.

  • Arquitecturas recomendadas según el tipo de entorno.

De esta manera, los equipos de infraestructura y operaciones del cliente podrán preparar correctamente sus entornos antes de iniciar la instalación, asegurando un despliegue exitoso y alineado con las buenas prácticas de Anjana Data.

Pre-requisitos del despliegue

Sistemas Operativos y Tecnologías Soportadas

  • Sistemas Operativos: Ubuntu, RedHat .

  • Bases de Datos Relacionales: PostgreSQL , AWS RDS/Aurora PostgreSQL, AzureDB for PostgreSQL, GCP Cloud SQL for PostgreSQL, Embedded en VM

  • Persistencias S3: AWS S3, MinIO

  • Indexador: SolR

  • Otros componentes: Ansible, Python, Zookeeper

Nota: Todo el detalle acerca de las versiones soportadas está disponible en la documentación de Ansible

Ajustes de Sistema Operativo Requeridos

Además de la versión de SO soportada, es necesario validar los siguientes ajustes en cada nodo antes de lanzar el despliegue:

  • SELinux (RedHat): debe estar en modo Permissive o Disabled. En modo Enforcing el despliegue falla. Este ajuste es un prerequisito, no una incidencia del kit.

  • Parámetros de kernel: se recomienda ajustar vm.max_map_count a al menos 262144 (valor recomendado para el correcto funcionamiento de Solr como motor de indexación).

  • Ulimits: se recomienda que el usuario de servicio (anjana) disponga, como mínimo, de nofile (ficheros abiertos): 65536 y nproc (procesos): 4096.

  • Sincronización horaria (NTP): todos los nodos del entorno deben tener el reloj sincronizado (chronyd/ntpd activo). Un desajuste de reloj entre nodos puede provocar fallos de validación de certificados TLS y de coordinación en Zookeeper.

Los valores de vm.max_map_count y de ulimits son los mínimos recomendados según buenas prácticas habituales para este tipo de despliegues (Solr/Java). Anjana Data no dispone de cifras propias validadas distintas a estas.

Requerimientos de Despliegue

  • Usuario con acceso SSH y permisos root en todas las máquinas y servicios gestionados provisionados.

    • No es imprescindible autenticar directamente como root por SSH. Es válido un usuario con sudo sin contraseña (NOPASSWD) para las tareas de plataformado y despliegue, siempre que tenga privilegios de escalado completos. Debe utilizarse autenticación por clave SSH (fichero .pem): no se ha verificado que la autenticación por contraseña funcione correctamente con Ansible, por lo que actualmente la clave SSH es la única vía confirmada.

  • Conectividad requerida hacia:

    • https://releases.anjanadata.com para descarga del instalador, artefactos y paquetes de software.

    • https://veltesta.anjanadata.com para activación y validación de licencias.

    • Entre los nodos con los servicios gestionados RDS y S3, si aplica.

    • Entre todos los nodos provisionados en arquitecturas Standard y Balanced, por SSH.

    • En modalidad SaaS Hybrid, desde los nodos de plugins (puertos 15001+) hacia los sistemas de datos gobernados y hasta el módulo Tot. Ver documentación de Plugins TOT.

    • Desde nodos Anjana (Zeus) hacia/desde los sistemas de gestión de identidades. Ver documentación de Autenticación.

    • Descarga de software desde los repositorios del sistema operativo (ver lista en la documentación de los kits de Ansible).

  • Firewall de host y puertos entre nodos: en arquitecturas Distribuidas o Balanceadas, el firewall local de cada máquina (firewalld/iptables/security groups) debe permitir el tráfico entre los nodos del propio entorno Anjana en los puertos de los microservicios y persistencias desplegados, además de la conectividad externa indicada arriba. Un firewall de host mal configurado es una causa habitual de fallos de arranque en entornos multi-nodo aunque la conectividad de red a nivel de VPC/subnet sea correcta.

  • Acceso tras despliegue a portales:

    • 443 → /login, /configpanel, /swagger/swagger-ui.html

    • 9001 (Minio)

    • 8983 (SolR)

    • 9999 (Horus)

  • En caso de BBDD gestionada: debe existir una base de datos llamada anjana y un usuario con permisos de creación.

  • En caso de S3 gestionado: deben existir 7 buckets (CDN, DSA, IMPORTS, TEXTAREA, WORKFLOWS, ANJANABACKUPS, ANJANALOGS).

  • El despliegue se realiza mediante un kit Ansible ejecutado desde un nodo central.

  • La máquina que ejecute el kit Ansible debe disponer de salida a Internet.

  • Arquitectura requerida: x86_64 (Intel/AMD 64 bits).

  • Espacio en disco: todo montado en el directorio raíz, con uso de /opt y /tmp.

Requisitos de Navegador

Para el acceso a las interfaces web de Anjana Data (Anjana UI y Portuno UI/configpanel), el navegador soportado oficialmente es:

  • Google Chrome - última versión estable

No se garantiza el correcto funcionamiento en otros navegadores (Firefox, Edge, Safari, etc.), al no estar contemplados en el soporte oficial de Anjana Data.

Mapa de Software

La plataforma Anjana Data está organizada en distintas zonas funcionales, cada una compuesta por módulos especializados que cubren la experiencia completa de gobierno de datos e inteligencia artificial. En la Descripción General encontrarás la explicación detallada de cada módulo (funcionalidades, tecnologías y casos de uso).

Arquitectura de Conexiones

La arquitectura de Anjana Data está diseñada para gobernar diferentes tecnologías, clústeres y entornos de manera agnóstica y flexible, permitiendo su despliegue en escenarios complejos como entornos multi-cloud, híbridos, big data o on-premise, y ofreciendo la capacidad de evolucionar junto con las nuevas tecnologías.

Gracias a su diseño modular basado en Spring Cloud y microservicios, Anjana Data Platform asegura:

  • Independencia de versiones de productos de terceros.

  • Alta disponibilidad y escalabilidad horizontal prácticamente ilimitada.

  • Despliegues adaptables tanto a entornos gestionados en la nube como a infraestructuras on-premise.

  • Interoperabilidad y extensibilidad mediante APIs y conectores/plugins.

Para una descripción completa de la arquitectura técnica y funcional, consulta la documentación oficial de Descripción general.

Diagrama de Conectividad de Red

Para facilitar el proceso de apertura de accesos con el equipo de seguridad del cliente, se detalla a continuación la tabla completa de conectividad: origen, destino, protocolo, puerto, dirección y condición de aplicabilidad de cada regla.

1. Conectividad requerida durante la instalación

#

Origen

Destino

Protocolo

Puerto

Descripción

Dir.

1

Nodo Ansible

releases.anjanadata.com

HTTPS

443

Descarga del kit, artefactos y paquetes de Anjana Data

OUT

2

Nodo Ansible

Repositorios del SO (apt.ubuntu.com, rpm mirrors, etc.)

HTTP/S

80, 443

Instalación de paquetes del sistema operativo (Python, Java, etc.)

OUT

3

Nodo Ansible

Todos los nodos del despliegue

SSH

22

Acceso SSH para despliegue automatizado (Ansible). Requerido desde nodo central hacia todos los nodos

OUT

2. Conectividad requerida en operación (runtime)

#

Origen

Destino

Protocolo

Puerto

Descripción

Dir.

4

Nodo Anjana (core)

veltesta.anjanadata.com

HTTPS

443

Activación y validación de licencia de producto. Periódico, no continuo

OUT

5

Nodo Anjana (core)

Servidor PostgreSQL / RDS gestionado

TCP

5432

Base de datos relacional. Solo si se usa BBDD gestionada externa (no aplica en arquitectura Test/POC con BBDD en la misma VM)

OUT

6a

Nodo Anjana (core)

AWS S3

HTTPS

443

Almacenamiento de objetos en AWS S3 (CDN, DSA, IMPORTS, TEXTAREA, WORKFLOWS, backups, logs). Solo si se usa AWS S3 como persistencia gestionada

OUT

6b

Nodo Anjana (core)

MinIO externo

TCP

9000

Almacenamiento de objetos en MinIO externo. Solo si se usa MinIO como servicio gestionado en otra máquina. MinIO embebido en la misma VM no requiere regla de firewall

OUT

7

Nodo Anjana (core)

Servidor LDAP / Active Directory del cliente

LDAP

389 / 636

Autenticación de usuarios vía LDAP (389) o LDAPS con SSL (636). Solo si se configura autenticación LDAP/AD corporativa. No requerido si se usan usuarios locales de Anjana

OUT

8

Nodo Anjana (core)

Servidor IdP OIDC / SSO (Azure AD, Keycloak, etc.)

HTTPS

443

Autenticación federada OIDC/SSO. Solo si se configura SSO corporativo. No requerido si se usan usuarios locales de Anjana

OUT

3. Conectividad de acceso de usuarios y administración

#

Origen

Destino

Protocolo

Puerto

Descripción

Dir.

9

Navegador de usuario final

Nodo Anjana

HTTPS

443

Acceso a la plataforma Anjana Data (UI web, API REST)

IN

10

Administrador / Equipo técnico

Nodo MinIO

TCP

9001

Consola de administración MinIO. Solo uso administrativo, recomendado restringir a red interna o VPN

IN

11

Administrador / Equipo técnico

Nodo SolR

TCP

8983

Consola de administración SolR. Solo uso administrativo, recomendado restringir a red interna o VPN

IN

12

Administrador / Equipo técnico

Nodo Horus

TCP

9999

Consola de monitorización y métricas. Solo uso administrativo, recomendado restringir a red interna o VPN

IN

4. Conectividad adicional en modalidad SaaS Hybrid (solo si aplica)

#

Origen

Destino

Protocolo

Puerto

Descripción

Dir.

13

Nodo Plugins (infraestructura cliente)

Módulo Tot (SaaS Anjana)

HTTPS

443

Los plugins se registran en Tot al arrancar. Conexión saliente del cliente hacia Anjana SaaS

OUT

14

Módulo Tot (SaaS Anjana)

Nodo Plugins (infraestructura cliente)

HTTPS

15001-15025

Tot orquesta los plugins: lanza extracciones y consultas llamando directamente al plugin registrado. El puerto exacto depende del plugin instalado; consultar a Anjana Data según los plugins requeridos

IN

Notas adicionales:

  • SSL/TLS obligatorio: todas las conexiones se securizan mediante SSL/TLS. Se requiere certificado wildcard del dominio del cliente (fullchain.pem + privatekey.pem).

  • Salida a Internet obligatoria: el nodo Anjana necesita salida a Internet para contactar releases.anjanadata.com (instalación) y veltesta.anjanadata.com (licencias).

  • Filas 5, 6a y 6b (BBDD y S3 gestionados): solo aplican si el cliente usa servicios gestionados externos. En arquitectura Test/POC (1 VM), PostgreSQL y MinIO corren en la misma máquina y no requieren regla de firewall.

  • Filas 7-8 (LDAP/OIDC): solo aplican si el cliente configura autenticación corporativa. Anjana soporta usuarios locales sin necesidad de LDAP ni SSO.

  • Filas 10-12 (puertos admin): se recomienda restringir su acceso a red interna o VPN del cliente. No deben exponerse a Internet.

  • Sección 4 (SaaS Hybrid): solo aplica en modalidad híbrida (plugins en cliente, núcleo Anjana en SaaS). En despliegue IaaS puro todos los plugins corren en la misma infraestructura del cliente y no requieren apertura de puertos hacia Internet.

Arquitecturas recomendadas

Anjana Data proporciona diferentes configuraciones recomendadas para entornos que permiten adaptar el despliegue a distintos volúmenes de usuarios y datos.

Estas arquitecturas están pensadas para garantizar:

  • Correcta distribución de cargas.

  • Escalabilidad y redundancia según la criticidad del entorno.

  • Integración con servicios gestionados de BBDD y almacenamiento S3.

Todo el detalle acerca de las arquitecturas recomendadas se encuentra en la documentación de Despliegue.

Certificados

Todas las conexiones entre los componentes de Anjana Data se securizan mediante SSL/TLS, por lo que es imprescindible disponer de un certificado wildcard asociado al dominio de cada instancia de la plataforma o de los plugins en caso de despliegues SaaS híbridos
(ejemplo: *.anjanadata.cliente.com o *.pluginsanjana.cliente.com).

Para el correcto despliegue se requieren exclusivamente los ficheros:

  • fullchain.pem

  • privatekey.pem

Importante:

  • Los certificados que se utilizan en infraestructura del cliente deben ser proporcionados y gestionados por el cliente. Anjana Data no realiza en ningún caso la generación del CSR.

  • El despliegue no utiliza en ningún caso el CSR.

El detalle completo de cómo generar, ubicar e integrar los certificados se encuentra en la documentación oficial: