Guía de instalación en Linux para digna Release 2026.11¶

Versión: 2026.11

Última actualización: 7 de noviembre de 2026

Tabla de contenidos¶

1. Introducción
2. Requisitos del sistema
3. Preparación antes de la instalación
4. Configuración del servidor PostgreSQL
5. Configuración del servidor web
6. Instalación inicial
7. Configuración del backend
8. Configuración del dashboard
9. Ejecutar digna como servicio systemd
10. Actualización a una nueva versión

Introducción¶

Acerca de digna¶

digna es una plataforma completa impulsada por IA diseñada para optimizar la gestión de la calidad de datos en distintos entornos de datos como almacenes, data lakes y lakehouses. Diseñada para ser altamente escalable y adaptable, digna aborda los retos modernos de datos mediante automatización, monitorización en tiempo real y detección de anomalías.

digna consta de dos componentes principales:

• digna: el núcleo de la aplicación, responsable de procesar los datos y realizar las comprobaciones de calidad. Combina el backend y la interfaz de línea de comandos en un único ejecutable, sustituyendo a los programas separados dignabackend y dignacli de versiones anteriores.
• dignadashboard: Una interfaz web alojada en un servidor web, que proporciona una forma amigable de interactuar con la plataforma digna y visualizar métricas de calidad de datos.

Novedades en la Release 2026.11¶

Esta versión añade digna Data Reconciliation, digna Agentic con el digna MCP Server y el digna Engine, que puede perfilar datos dentro de digna y comprobar la integridad referencial entre distintas tecnologías de bases de datos. Consulta las notas de la versión para obtener detalles completos.

Para una instalación, la versión trae un nuevo mecanismo de migración del repositorio, una sección [duckdb] opcional en config.toml para el digna Engine y un nuevo archivo de licencia. La sección de actualización trata cada uno de ellos.

¿Buscas Windows o macOS?¶

Esta guía cubre Linux. Para otras plataformas, consulta la Guía de instalación para Windows o la Guía de instalación para macOS.

¿Qué distribución cubre esta guía?¶

Las instrucciones están escritas para las dos familias de servidor más comunes. Donde difieren, se muestran ambos comandos:

• familia Debian — Debian, Ubuntu. Gestor de paquetes: apt.
• familia RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Gestor de paquetes: dnf.

Cualquier distribución moderna con systemd funcionará; solo cambian algunos nombres de paquetes y rutas de configuración.

Requisitos del sistema¶

Antes de comenzar la instalación, asegúrate de que tu sistema cumpla los siguientes requisitos mínimos:

Opciones de instalación de la base de datos¶

Si PostgreSQL ya está instalado: Puedes añadir una nueva base de datos para digna en tu servidor PostgreSQL existente.

Si vas a instalar PostgreSQL en la misma máquina que digna:

Comprobar tu distribución y arquitectura¶

Varios comandos en esta guía difieren entre las familias Debian y RHEL. Para comprobar en cuál estás, ejecuta:

cat /etc/os-release
uname -m

• ID=ubuntu o ID=debian — usa los comandos apt.
• ID=rhel, rocky, almalinux o fedora — usa los comandos dnf.
• x86_64 o aarch64 — la arquitectura del paquete de instalación que necesitas.

Preparación antes de la instalación¶

Antes de instalar digna, asegúrate de que dos prerrequisitos clave estén en su lugar:

1. Servidor PostgreSQL – para almacenar métricas calculadas y datos de rendimiento
2. Servidor web – para alojar el dashboard de digna

Si estos componentes no están instalados, sigue las secciones siguientes para instalarlos y configurarlos.

Actualizar el índice de paquetes¶

Actualiza las listas de paquetes antes de instalar cualquier cosa:

sudo apt update

sudo dnf check-update

Configuración del servidor PostgreSQL¶

Si ya tienes PostgreSQL¶

Si PostgreSQL ya está instalado y en ejecución en tu máquina local o si estás usando un servidor PostgreSQL gestionado de forma remota, puedes saltar a la sección siguiente.

Instalación de PostgreSQL¶

Paso 1: Instalar el paquete del servidor¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Paso 2: Inicializar el clúster de la base de datos¶

En la familia Debian, el paquete crea y arranca un clúster automáticamente — pasa al siguiente paso.

En la familia RHEL, el clúster debe crearse explícitamente:

sudo postgresql-setup --initdb

Paso 3: Iniciar y habilitar el servicio¶

sudo systemctl enable --now postgresql

Esto inicia PostgreSQL inmediatamente y lo configura para que arranque automáticamente en el inicio.

Paso 4: Verificar la instalación¶

psql --version
sudo systemctl status postgresql

Deberías ver la versión de PostgreSQL y el servicio con estado active (running).

Paso 5: Conectarse al servidor¶

El paquete PostgreSQL para Linux crea una cuenta del sistema postgres que posee el clúster. Conéctate a través de ella:

sudo -u postgres psql

Paso 6: Confirmar el puerto¶

El puerto por defecto de PostgreSQL es 5432. Para confirmar el puerto en el que tu servidor está escuchando:

sudo -u postgres psql -c "SHOW port;"

Anota el valor — lo necesitarás al configurar el backend de digna.

Paso 7: Habilitar la autenticación por contraseña para el usuario digna¶

digna se conecta a PostgreSQL por TCP como digna_user, lo que requiere autenticación por contraseña en lugar de peer. Comprueba que tu pg_hba.conf lo permita.

Localiza el archivo:

sudo -u postgres psql -c "SHOW hba_file;"

Ábrelo en un editor y confirma que las líneas TCP locales usen scram-sha-256 (o md5 en servidores más antiguos) en lugar de ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Recarga PostgreSQL tras cualquier cambio:

sudo systemctl reload postgresql

Paso 8: Si PostgreSQL se ejecuta en otra máquina¶

Para aceptar conexiones desde un host distinto, ajusta listen_addresses en postgresql.conf y añade una línea host correspondiente para tu red en pg_hba.conf:

listen_addresses = '*'

Luego abre el puerto en el cortafuegos y reinicia el servicio:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Configuración del servidor web¶

digna requiere un servidor web para alojar el dashboard. Elige una de las siguientes opciones:

• nginx — ligero y recomendado
• Apache httpd — alternativa ampliamente desplegada

Solo necesitas instalar y configurar uno de estos servidores.

Ambas secciones configuran dos cosas de las que depende el dashboard:

• Fallback para aplicaciones de una sola página (SPA), para que refrescar una URL del dashboard no devuelva un 404
• Un tipo MIME para .md, para que los archivos Markdown se sirvan correctamente

Configuración de nginx¶

Descripción general¶

nginx es un servidor web ligero y de alto rendimiento, bien adaptado para servir el dashboard estático de digna.

Instalación¶

sudo apt install -y nginx

sudo dnf install -y nginx

Iniciar nginx¶

sudo systemctl enable --now nginx

Verificar la instalación¶

1. Abre tu navegador
2. Navega a http://localhost
3. Deberías ver la página de bienvenida de nginx

Abrir el cortafuegos¶

Si el servidor va a ser accesible desde otras máquinas, permite el tráfico HTTP:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Configurar un sitio para el dashboard¶

nginx incluye todos los archivos de su directorio conf.d en ambas familias de distribución. Crea un archivo de configuración dedicado para digna allí:

sudo nano /etc/nginx/conf.d/digna.conf

Pega lo siguiente, reemplazando /opt/digna/dashboard por la ruta real a tu carpeta dashboard extraída:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Deshabilitar el sitio por defecto¶

Solo puede haber un bloque server que sea default_server para un puerto. En la familia Debian, elimina el sitio por defecto empaquetado para que no entre en conflicto:

sudo rm /etc/nginx/sites-enabled/default

En la familia RHEL, comenta o elimina el bloque server { ... } dentro de /etc/nginx/nginx.conf.

Aplicar la configuración¶

Prueba la configuración en busca de errores de sintaxis y luego recarga nginx:

sudo nginx -t
sudo systemctl reload nginx

Configuración de Apache httpd¶

Descripción general¶

Apache httpd está disponible en los repositorios predeterminados de todas las distribuciones compatibles. El paquete se llama apache2 en la familia Debian y httpd en la familia RHEL.

Instalación¶

sudo apt install -y apache2

sudo dnf install -y httpd

Iniciar Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Verificar la instalación¶

1. Abre tu navegador
2. Navega a http://localhost
3. Deberías ver la página predeterminada de Apache de la distribución

Requisito: habilitar mod_rewrite¶

El dashboard requiere reescritura de URL.

En la familia Debian, habilita el módulo y reinicia:

sudo a2enmod rewrite
sudo systemctl restart apache2

En la familia RHEL, mod_rewrite se carga por defecto. Compruébalo:

httpd -M | grep rewrite

Requisito: permitir overrides con .htaccess¶

Abre el archivo de configuración de la raíz de documentos:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Localiza el bloque <Directory> que cubre tu raíz de documentos (/var/www/html en ambas familias) y cambia:

AllowOverride None

por:

AllowOverride All

Requisito: tipo MIME para archivos Markdown¶

En el mismo archivo, añade la siguiente línea para que los archivos Markdown se sirvan correctamente:

AddType text/markdown .md

Aplicar la configuración¶

Comprueba la configuración en busca de errores de sintaxis y luego reinicia Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Instalación inicial¶

Paso 1: Configurar el repositorio de digna¶

El repositorio de digna almacena todas las métricas calculadas por digna. Actúa como la base de datos central para datos analíticos y de rendimiento.

Crear esquema y usuario del repositorio¶

Abre tu cliente PostgreSQL (psql, pgAdmin o similar) y ejecuta las siguientes sentencias SQL:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Reemplaza los siguientes marcadores de posición:

• <digna_repo_schema> — El nombre de esquema que desees (por ej., dignarepo)
• <digna_repo_user> — El nombre de usuario que desees (por ej., digna_user)
• <digna_repo_password> — Una contraseña segura para este usuario

Ejemplo:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Para ejecutar esto desde la shell en un solo paso:

sudo -u postgres psql

Luego pega las sentencias en el prompt postgres=# y escribe \q para salir.

Paso 2: Extraer el paquete de instalación de digna¶

1. Localiza el archivo ZIP de instalación de digna que se te proporcionó
2. Extrae su contenido en la ubicación deseada — por ejemplo /opt/digna
3. Después de la extracción, deberías ver los siguientes elementos:
4. dashboard/ — Interfaz web del dashboard
5. digna — Ejecutable principal (backend + CLI combinados)

Para extraerlo desde la shell:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Hacer el ejecutable ejecutable¶

Dependiendo de cómo se transfirió el archivo, el bit de ejecutable puede no preservarse tras la extracción. Establécelo explícitamente:

cd /opt/digna
sudo chmod +x digna

Crear una cuenta de servicio¶

Se recomienda ejecutar el backend como un usuario dedicado y sin privilegios para despliegues en producción:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Paso 3: Instalar el archivo de licencia¶

1. Localiza el archivo license.toml que se te proporcionó
2. Cópialo al directorio raíz de instalación de digna (donde están config.toml y el ejecutable digna)

Por qué es importante: El archivo de licencia contiene la información del cliente, la fecha de expiración y la firma digital. No modifiques este archivo — cualquier cambio lo invalidará.

Estructura de directorios tras la configuración:

/opt/digna/
├── config.toml         (archivo de configuración)
├── license.toml        (TU ARCHIVO DE LICENCIA - cópialo aquí)
├── digna               (ejecutable principal)
├── bin/                (scripts de gestión del servicio)
└── dashboard/          (interfaz web)
    └── (archivos del dashboard)

Configuración del backend¶

Paso 1: Crear y editar el archivo de configuración¶

El archivo config_template.toml se proporciona en tu directorio de instalación de digna. Solo necesitas renombrarlo a config.toml.

cd /opt/digna
sudo mv config_template.toml config.toml

Ubicación: /opt/digna/config.toml

Abre config.toml en un editor de texto y configura cada sección que se indica a continuación.

Sección [app]¶

Esta sección configura el intercambio de recursos entre orígenes (CORS) entre el dashboard y el backend:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

Sección [repo]¶

Esta sección configura la conexión a la base de datos PostgreSQL:

[repo]
DIGNA_REPO_HOST = "localhost"
DIGNA_REPO_PORT = 5432
DIGNA_REPO_DB = "postgres"
DIGNA_REPO_SCHEMA = "dignarepo"
DIGNA_REPO_USER = "digna_user"
DIGNA_REPO_PASSWORD = "YourSecurePassword123!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

Sección [base]¶

Esta sección contiene ajustes de seguridad, cookies e inspecciones:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

Sección [encryption]¶

Esta sección contiene la clave utilizada para cifrar los valores sensibles almacenados en el repositorio. Es obligatoria: config check informa de la sección [encryption] como FAILED si falta la clave.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Sección [logging]¶

Esta sección configura el comportamiento del registro:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

Sección [duckdb] (opcional)¶

Novedad de la Release 2026.11. Esta sección define los recursos del digna Engine, que perfila datos dentro de digna para las conexiones de base de datos cuya ubicación de perfilado es digna Engine, y ejecuta comprobaciones de integridad referencial entre fuentes de datos de distintas conexiones de base de datos. Consulta Ubicación de perfilado.

La sección es opcional. Sin ella, se aplican los valores por defecto que se indican a continuación.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

Paso 2: Validar la configuración¶

Antes de inicializar el repositorio, compruebe que config.toml está completo y bien formado. En su directorio de instalación de digna, ejecute:

./digna config check

Cada sección se valida por separado, de modo que un único error no oculta el estado del resto:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Corrija todo lo que se informe como FAILED y vuelva a ejecutar el comando antes de continuar. Un WARNING en Unknown keys enumera las claves de config.toml que digna no lee; no tienen ningún efecto, así que elimínelas o corrija su ortografía. La lista completa de opciones está en la referencia de la CLI.

Paso 3: Inicializar el repositorio¶

1. Abre un terminal
2. Navega al directorio de instalación de digna (donde están config.toml y el ejecutable digna)
3. Ejecuta la prueba de conexión:

cd /opt/digna
./digna repo check

En un esquema nuevo, el comando se conecta y después informa de que aún no hay ningún repositorio instalado:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

En este punto, ese es el resultado esperado: confirma que digna llega a PostgreSQL y al esquema. En cambio, un error de conexión o de autenticación apunta a la sección [repo] o a la configuración de PostgreSQL.

sudo ln -s /opt/digna/digna /usr/local/bin/digna

Paso 4: Instalar el esquema del repositorio¶

En el mismo directorio, ejecuta:

./digna repo upgrade

Este comando instala las tablas necesarias en el esquema del repositorio y termina con:

✅ Repo schema 'dignarepo' is up to date.

Paso 5: Crear un usuario administrador¶

1. Abre una ventana de terminal nueva
2. Navega al directorio de instalación de digna
3. Ejecuta el siguiente comando para crear un usuario administrador:

./digna user add <email> <password> "<display_name>" --admin

Ejemplo:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

Esto crea un usuario con el correo electrónico admin@example.com y privilegios administrativos completos.

Paso 6: Iniciar el servidor digna¶

En el directorio de instalación de digna, inicia el servidor con:

./digna serve --address <host> --port <port>

Parámetros: - --address — Nombre de host/IP del servidor (por defecto 127.0.0.1) - --port — Puerto del servidor (por defecto 8000)

Cuando el servidor está en marcha, muestra la dirección en la que escucha:

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

Configuración del dashboard¶

Paso 1: Desplegar el dashboard en el servidor web¶

El dashboard de digna lee su propia configuración de dashboard/dashboard_config.toml. Ese archivo no se incluye en la instalación: lo creas en el directorio dashboard/, junto a los archivos del dashboard.

Su contenido se describe en Inicio de sesión único, que es también donde se necesita el archivo: contiene las opciones de inicio de sesión que ofrece el dashboard y, para despliegues multi-instancia, la conexión al backend.

Elige tu servidor web y sigue los pasos de despliegue correspondientes.

Desplegar en nginx¶

Si seguiste la sección de Configuración de nginx, el bloque del servidor ya apunta a tu carpeta dashboard y no es necesario copiar nada.

1. Confirma la ruta
2. Abre /etc/nginx/conf.d/digna.conf

3. Verifica que root apunte a tu carpeta dashboard extraída

4. Asegura que la carpeta sea legible

   sudo chmod -R a+rX /opt/digna/dashboard
   

5. Recargar nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Probar la instalación

7. Abre tu navegador
8. Navega a http://localhost (o la URL configurada)
9. Deberías ver la página de inicio de sesión del dashboard de digna

Desplegar en Apache httpd¶

1. Copiar el dashboard al Document Root

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Agregar las reglas de reescritura

Crea un archivo .htaccess dentro de la carpeta desplegada para que las rutas del dashboard sobrevivan a un refresco del navegador:

sudo nano /var/www/html/digna/.htaccess

Pega lo siguiente:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Reiniciar Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Acceder al dashboard

3. Abre tu navegador
4. Navega a http://localhost/digna
5. Deberías ver la página de inicio de sesión del dashboard de digna

Paso 2: SELinux (solo familia RHEL)¶

En RHEL, Rocky, AlmaLinux y Fedora, SELinux está en modo enforcing por defecto y bloqueará al servidor web para leer archivos fuera de sus ubicaciones esperadas. Comprueba si está activo:

getenforce

Si el resultado es Enforcing y estás sirviendo el dashboard desde /opt/digna/dashboard, etiqueta el directorio para que el servidor web pueda leerlo:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

Ejecutar digna como servicio systemd¶

¿Por qué ejecutar digna como servicio?¶

Ejecutar el backend de digna como servicio systemd asegura que:

• Arranque automáticamente cuando la máquina lo haga
• Se ejecute en segundo plano sin una ventana de terminal abierta
• Se reinicie automáticamente si falla
• Puede gestionarse mediante systemctl, el gestor de servicios estándar de Linux

Archivos de gestión del servicio¶

Todos los archivos necesarios se encuentran en el directorio de instalación de digna bajo: bin/

Los siguientes scripts shell están disponibles:

• install_service.sh — Registra digna en systemd
• uninstall_service.sh — Desregistra el servicio
• start_service.sh — Inicia el servicio registrado
• stop_service.sh — Detiene el servicio en ejecución

Hacer los scripts ejecutables¶

La extracción puede no preservar el bit de ejecutable. Antes del primer uso:

cd /opt/digna/bin
sudo chmod +x *.sh

Instalar el servicio¶

1. Abre un terminal

2. Navega a la carpeta bin

   cd /opt/digna/bin
   

3. Ejecuta el script de instalación

   sudo ./install_service.sh
   

El servidor digna ahora está registrado en systemd con el arranque automático habilitado. El servicio no se inicia de forma inmediata — consulta la sección siguiente para iniciarlo.

Iniciar y detener el servicio¶

Para iniciar el servicio¶

1. Abre un terminal
2. Navega a /opt/digna/bin
3. Ejecuta:

   sudo ./start_service.sh
   

Para detener el servicio¶

1. Abre un terminal
2. Navega a /opt/digna/bin
3. Ejecuta:

   sudo ./stop_service.sh
   

Gestionar el servicio con systemctl¶

Una vez registrado, el servicio también puede controlarse con los comandos systemd estándar desde cualquier directorio:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Verificar el servicio¶

Para confirmar que el servicio está registrado y en ejecución:

systemctl is-enabled digna
systemctl is-active digna

enabled significa que el servicio arranca en el inicio; active significa que se está ejecutando ahora.

Ver los registros del servicio¶

systemd captura todo lo que el backend escribe en la consola. Para leerlo:

sudo journalctl -u digna -n 100

Para seguir el registro en vivo mientras reproduces un problema:

sudo journalctl -u digna -f

Mover el servicio a un nuevo directorio¶

El unit file almacena la ruta absoluta al ejecutable, por lo que mover la instalación requiere volver a registrar el servicio:

1. Desinstalar el servicio actual

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Mover los archivos de la aplicación

   sudo mv /old/path/digna /new/path/digna
   

3. Reinstalar el servicio

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Iniciar el servicio

   sudo ./start_service.sh
   

Desinstalar el servicio¶

1. Detener el servicio en ejecución

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Desinstalar el servicio

   sudo ./uninstall_service.sh
   

El servidor digna ahora está desregistrado de systemd.

Actualización a una nueva versión¶

Esta sección actualiza una instalación de la Release 2026.06 a la Release 2026.11. Si tu instalación es más antigua, lee primero Actualizar desde una versión anterior a la 2026.06.

Antes de actualizar¶

Es obligatorio crear una copia de seguridad del repositorio digna

Antes de actualizar digna, haz una copia de seguridad de tu repositorio (PostgreSQL) para protegerte contra pérdidas de datos. Una copia de seguridad garantiza que puedas recuperar los datos si la actualización encuentra problemas inesperados.

Para crear una copia de seguridad desde la shell:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Solicitar el archivo de licencia para la Release 2026.11

La Release 2026.11 necesita un nuevo license.toml. Solicítalo al equipo de digna antes de empezar y tenlo preparado para el paso 7.

Actualizar desde una versión anterior a la 2026.06¶

La Release 2026.06 introdujo tres cambios que siguen aplicándose cuando actualizas una instalación más antigua directamente a la 2026.11:

• Solo ODBC. digna accede a cada tecnología de origen mediante ODBC. Toda conexión de base de datos que aún no use ODBC debe cambiarse a ODBC después de la actualización; no hay conversión automática. Instala de antemano los controladores ODBC en el host de digna (consulta Instalar el controlador ODBC en el host de digna) y ten preparadas las propiedades de cada conexión a partir de las guías por tecnología. El conector Databricks Legacy ya no existe; traslada esas conexiones al conector Databricks.
• Un único ejecutable. dignabackend y dignacli se sustituyen por el ejecutable único digna, que combina el backend y la CLI.
• config.toml. La sección [encryption] es obligatoria, y DIGNA_APP_HOST y DIGNA_APP_PORT ya no se leen: el servidor toma su dirección y su puerto de digna serve. Compara tu archivo con Configuración del backend.

Los pasos siguientes indican dónde una instalación más antigua necesita algo distinto. La actualización del repositorio del paso 8 lleva un repositorio de cualquier versión anterior directamente a la 2026.11.

Proceso de actualización¶

Paso 1: Detener el servicio digna¶

Si digna se ejecuta como servicio systemd, deténlo primero:

cd /opt/digna/bin
sudo ./stop_service.sh

Si digna se está ejecutando en primer plano, presiona Ctrl+C en su ventana de terminal.

Paso 2: Respaldar la instalación actual¶

En tu directorio de instalación de digna, cambia el nombre del ejecutable y de la carpeta del dashboard de tu instalación actual, para que la nueva versión pueda desplegarse junto a ellos:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

Conserva digna_old hasta que hayas verificado la actualización, y dashboard_old hasta que hayas restaurado desde ella tus archivos de configuración (consulta el paso 4). Después puedes eliminar ambos.

Paso 3: Extraer y desplegar la nueva versión¶

1. Extrae el nuevo archivo ZIP de instalación de digna
2. Copia el nuevo ejecutable digna y la carpeta dashboard a tu directorio de instalación
3. Restaura el bit de ejecutable y la propiedad a la cuenta de servicio:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Paso 4: Restaurar tus archivos de configuración¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

La Release 2026.11 no requiere ningún cambio en config.toml: un archivo que funciona con la Release 2026.06 sigue funcionando. Hay dos cambios opcionales:

• Añade una sección [duckdb] si las conexiones de base de datos van a usar el digna Engine y sus valores por defecto no se ajustan a tu host.
• Omite la sección [app] si un proxy inverso sirve el dashboard y el backend bajo un mismo origen.

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

Paso 5: Recargar el servidor web¶

El dashboard es un conjunto de archivos estáticos, por lo que tu servidor web —y el navegador— pueden seguir sirviendo la versión anterior. Recarga o reinicia el servidor web que aloje la carpeta dashboard y, a continuación, recarga la página forzando la actualización (Ctrl+F5).

Paso 6: Validar la configuración¶

Confirma que config.toml está completo antes de tocar el repositorio:

./digna config check

Todas las secciones deben informar OK. Corrige todo lo que se informe como FAILED, elimina las claves enumeradas en Unknown keys y vuelve a ejecutar el comando antes de continuar.

Paso 7: Sustituir el archivo de licencia¶

Normalmente, un archivo de licencia sigue sirviendo de una versión a la siguiente. La Release 2026.11 es una excepción: añade dos módulos con licencia, digna Data Reconciliation y digna Agentic, y una licencia emitida antes de la 2026.11 no los contiene. Copia el license.toml que el equipo de digna te proporcionó para la Release 2026.11 en el directorio de instalación, sustituyendo el anterior:

sudo cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Paso 8: Actualizar el esquema del repositorio¶

En tu directorio de instalación de digna, ejecuta:

cd /opt/digna
./digna repo upgrade

La Release 2026.11 gestiona el esquema del repositorio con migraciones versionadas. La primera actualización desde una versión anterior lleva el esquema a la última versión del sistema anterior, registra ese estado como punto de partida y, a continuación, aplica las migraciones de la Release 2026.11. Termina con:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Se conservan todos los datos existentes. Para ver el estado del repositorio en cualquier momento, ejecuta ./digna repo check: muestra la última migración aplicada y las que estén pendientes.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

Paso 9: Reiniciar los servicios¶

Si se ejecuta como servicio systemd:

cd /opt/digna/bin
sudo ./start_service.sh

Si se ejecuta manualmente, reinicia el servidor:

cd /opt/digna
./digna serve --address <address> --port <port>

Si usas nginx o Apache, recarga el servidor web correspondiente:

sudo systemctl reload nginx

sudo systemctl restart apache2

En la familia RHEL, vuelve a aplicar el etiquetado SELinux si se sustituyó el directorio dashboard:

sudo restorecon -Rv /opt/digna/dashboard

Paso 10: Verificar la actualización¶

1. Confirma la versión del nuevo ejecutable:

   ./digna version
   

   La primera línea debe ser Release: 2026.11.

2. Accede al dashboard de digna y verifica que la interfaz carga correctamente.

3. Revisa los registros del servidor por si hay errores:

   sudo journalctl -u digna -n 100
   

4. Prueba tus conexiones de base de datos: consulta Probar una conexión. Tras una actualización desde una versión anterior a la 2026.06, convierte primero a ODBC todas las conexiones que aún no lo usaran.

Para empezar con los nuevos módulos, consulta digna Data Reconciliation, Conectar un agente de IA para el digna MCP Server y Ubicación de perfilado para el digna Engine.