Guía de instalación en Windows para digna Release 2026.06¶

Release: 2026.06

Última actualización: 30 de agosto de 2026

Tabla de contenidos¶

1. Introducción
2. Requisitos del sistema
3. Preparativos previos a 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 panel (dashboard)
9. Ejecutar digna como servicio de Windows
10. Actualizar a una nueva versión

Introducción¶

Acerca de digna¶

digna es una plataforma integral impulsada por IA diseñada para optimizar la gestión de la calidad de los datos en diversos entornos, como data warehouses, data lakes y lakehouses. Diseñada para ser altamente escalable y adaptable, digna aborda los desafíos modernos de datos mediante automatización, monitoreo 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 ofrece una forma amigable de interactuar con la plataforma digna y visualizar las métricas de calidad de datos.

Novedades en la Release 2026.06¶

Esta versión incorpora capacidades de observabilidad de datos directamente en tu código, permitiendo a los desarrolladores supervisar la calidad de los datos en el origen. Consulta las notas de la versión para obtener detalles completos.

¿Buscas macOS o Linux?¶

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

Requisitos del sistema¶

Antes de comenzar la instalación, asegúrate de que tu sistema cumpla con 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:

Preparativos previos a 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 digna Dashboard

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

Configuración del servidor PostgreSQL¶

Si ya tienes PostgreSQL¶

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

Instalación de PostgreSQL¶

Sigue estos pasos para instalar PostgreSQL en Windows:

Paso 1: Descargar PostgreSQL¶

1. Visita la página de descargas de PostgreSQL
2. Selecciona Windows
3. Descarga el instalador más reciente

Paso 2: Ejecutar el instalador¶

1. Haz doble clic en el archivo del instalador descargado
2. Sigue las indicaciones del asistente de instalación

Paso 3: Elegir el directorio de instalación¶

Selecciona el directorio donde se instalará PostgreSQL. La ubicación predeterminada suele ser adecuada.

Paso 4: Seleccionar componentes¶

Para una configuración estándar, mantiene las opciones de componentes predeterminadas seleccionadas.

Paso 5: Establecer la contraseña del superusuario de PostgreSQL¶

Introduce y confirma una contraseña para el superusuario de PostgreSQL (postgres). Guarda esta contraseña de forma segura — la necesitarás más adelante.

Paso 6: Configurar el número de puerto¶

El puerto predeterminado de PostgreSQL es 5432. Puedes usar el predeterminado o especificar otro puerto si es necesario.

Paso 7: Elegir la configuración regional (locale)¶

Selecciona la configuración regional para tu base de datos. La opción predeterminada suele ser adecuada para la mayoría de las instalaciones.

Paso 8: Completar la instalación¶

Haz clic en Next en los pasos restantes y luego en Finish.

Paso 9: Verificar la instalación¶

Abre el Símbolo del sistema y verifica que PostgreSQL esté instalado:

psql --version

Deberías ver la versión de PostgreSQL si la instalación fue exitosa.

Configuración del servidor web¶

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

• Internet Information Services (IIS)
• Apache Tomcat

Solo necesitas instalar y configurar uno de estos servidores.

Configuración de IIS¶

Descripción general¶

Internet Information Services (IIS) es el servidor web de Microsoft para alojar sitios web y aplicaciones web.

Habilitar IIS¶

1. Abrir el Panel de control
2. Presiona Win + R

3. Escribe control y presiona Enter

4. Ir a Funciones de Windows

5. Haz clic en Programs

6. Selecciona Turn Windows features on or off

7. Habilitar Internet Information Services

8. Desplázate y busca Internet Information Services (IIS)
9. Marca la casilla para habilitarlo

10. Haz clic en el + para expandir y verifica que estos subcomponentes estén seleccionados:

    • Web Management Tools
    • World Wide Web Services

11. Haz clic en OK para aplicar los cambios

12. Verificar la instalación de IIS

13. Abre tu navegador
14. Navega a http://localhost
15. Deberías ver la página de bienvenida de IIS

Requerido: módulo URL Rewrite¶

IIS requiere el componente URL Rewrite. Descárgalo e instálalo desde la página oficial de Microsoft.

Requerido: tipo MIME para archivos Markdown¶

Para asegurar que los archivos Markdown (.md) se sirvan correctamente en IIS:

1. Abre IIS Manager (presiona Win + R, escribe inetmgr, presiona Enter)
2. Navega a Your Site > MIME Types
3. Haz clic en Add...
4. Configura:
5. File name extension: .md
6. MIME type: text/markdown

Configuración de Apache Tomcat¶

Descripción general¶

Apache Tomcat es un contenedor de servlets Java y servidor web de código abierto.

Instalación¶

1. Descargar Apache Tomcat
2. Visita Apache Tomcat Downloads

3. Descarga la distribución ZIP para Windows

4. Extraer el archivo

5. Extrae el archivo ZIP en un directorio de tu sistema

6. Ejemplo: C:\Program Files\Apache Tomcat

7. Verificar que Tomcat esté en ejecución

8. Abre tu navegador
9. Navega a http://localhost:8080
10. Deberías ver la página de bienvenida de Apache Tomcat

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 de PostgreSQL (pgAdmin, psql u otro) y ejecuta los siguientes comandos 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:

• <digna_repo_schema> — El nombre de esquema que desees (p. ej., dignarepo)
• <digna_repo_user> — El nombre de usuario que desees (p. 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;

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 el archivo en la ubicación de instalación deseada
3. Después de extraer, deberías ver los siguientes elementos:
4. dashboard/ — Interfaz web del panel
5. digna — Ejecutable principal (backend + CLI combinados)

Paso 3: Instalar el archivo de licencia¶

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

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

Estructura de directorios después de la configuración:

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

Configuración del backend¶

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

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

Ubicación: digna_installation/config.toml

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

Sección [app]¶

Esta sección configura los ajustes de la aplicación backend de digna:

[app]
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]

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!"

Sección [base]¶

Esta sección contiene ajustes de seguridad y cookies:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

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):

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

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

Overall: OK

Corrija todo lo que se informe como FAILED y vuelva a ejecutar el comando antes de continuar. La lista completa de opciones está en la referencia de la CLI.

Paso 3: Inicializar el repositorio¶

1. Abre el Símbolo del sistema
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:

digna repo check

Deberías ver una confirmación de que la conexión se ha establecido (el repositorio en sí aún no se ha inicializado).

Paso 4: Instalar el esquema del repositorio¶

En el mismo directorio, ejecuta:

digna repo install

Este comando instala las tablas y el esquema necesarios en tu base de datos PostgreSQL.

Paso 5: Crear un usuario administrador¶

1. Abre una ventana nueva del Símbolo del sistema
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 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 - --port — Puerto del servidor

Deberías ver mensajes de inicio confirmando que el servidor está en ejecución:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

Configuración del panel (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.

Despliegue en IIS¶

1. Abrir IIS Manager

2. Presiona Win + R, escribe inetmgr, presiona Enter

3. Crear un nuevo sitio web

4. En el panel izquierdo, clic derecho en Sites

5. Selecciona Add Website...

6. Configurar el sitio

7. Site Name: Introduce un nombre (p. ej., "dignaDashboard")
8. Physical Path: Haz clic en Browse y selecciona tu carpeta dashboard

9. Binding: Configura la dirección IP y el puerto (puerto 80 para HTTP, 443 para HTTPS por defecto)

10. Iniciar el sitio

11. Haz clic en OK para crear el sitio

12. Clic derecho en el nuevo sitio y selecciona Start

13. Probar la instalación

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

Despliegue en Apache Tomcat¶

1. Copiar el dashboard a Tomcat
2. Copia la carpeta dashboard a tu directorio webapps de Tomcat
3. Renómbrala si es necesario (p. ej., a digna)

4. Ejemplo: C:\Program Files\Apache Tomcat\webapps\digna

5. Verificar el despliegue

6. Actualiza o recarga la página de administración de Tomcat (http://localhost:8080)

7. Deberías ver "digna" (o el nombre elegido) listado en las aplicaciones desplegadas

8. Acceder al dashboard

9. Abre tu navegador
10. Navega a http://localhost:8080/digna
11. Deberías ver la página de inicio de sesión del dashboard de digna

Ejecutar digna como servicio de Windows¶

¿Por qué usar un servicio de Windows?¶

Ejecutar el backend de digna como servicio de Windows asegura que: - Se inicie automáticamente al arrancar el servidor - Se ejecute en segundo plano sin necesidad de una ventana del Símbolo del sistema abierta - Se reinicie automáticamente si se bloquea - Se pueda gestionar a través de Servicios de Windows

Los comandos windows¶

El servicio se gestiona con el propio ejecutable digna, mediante los subcomandos digna windows. No hay archivos batch que ejecutar.

Cada comando acepta --name para dirigirse a un servicio registrado con un nombre distinto del predeterminado. La lista completa de opciones está en la referencia de la CLI.

Instalar el servicio¶

1. Abrir Símbolo del sistema como Administrador
2. Clic derecho en Símbolo del sistema

3. Selecciona "Run as Administrator"

4. Navegar a tu directorio de instalación de digna

   cd C:\path\to\digna
   

5. Registrar el servicio

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

El servicio se registra con inicio automático, por lo que se iniciará con Windows. No se inicia inmediatamente — consulta la sección siguiente.

Opciones de instalación¶

Iniciar y detener el servicio¶

Para iniciar el servicio¶

digna windows start

Para detener el servicio¶

digna windows stop

Mover el servicio a un nuevo directorio¶

Si necesitas reubicar la instalación de digna:

1. Detener el servicio actual y anular su registro

   cd C:\old\path\digna
   digna windows stop
   digna windows uninstall
   

2. Mover los archivos de la aplicación

3. Mueve toda la carpeta de instalación de digna a la nueva ubicación

4. Registrar de nuevo el servicio desde la nueva ubicación

   cd C:\new\path\digna
   digna windows install
   

Repite los valores de --address, --port o --account que usaste la primera vez: el registro anterior ya no existe.

1. Iniciar el servicio

   digna windows start
   

Desinstalar el servicio¶

1. Detener el servicio en ejecución

   cd C:\path\to\digna
   digna windows stop
   

2. Anular el registro del servicio

   digna windows uninstall
   

El servidor digna ahora está dado de baja como servicio de Windows.

Actualizar a una nueva versión¶

Antes de actualizar¶

Verifique primero todas las conexiones de base de datos

A partir de la versión 2026.06, digna accede a cada tecnología de origen mediante ODBC. Las versiones anteriores ofrecían la opción entre un controlador propio por tecnología y ODBC, seleccionada con el conmutador Use ODBC. El equipo de digna decidió apoyarse únicamente en ODBC, porque una interfaz única y estándar aporta más que un conjunto de controladores a medida:

• Autenticación — la autenticación forma parte de ODBC, por lo que una conexión puede usar todo lo que admita su controlador: contraseñas, tokens y PAT, Kerberos y Active Directory, MFA e inicio de sesión único desde el navegador, identidades en la nube, certificados de cliente y TLS. Los métodos nuevos llegan con una actualización del controlador, en lugar de esperar a una versión de digna.
• Controladores mantenidos por los fabricantes de bases de datos — el controlador del propio fabricante sigue las nuevas versiones del servidor y las correcciones de seguridad, y puede actualizarlo según su propio calendario, con independencia de digna.
• Una única forma de configurarlo todo — cada tecnología es una lista de propiedades clave/valor, con la misma interfaz, el mismo cifrado de valores sensibles y la misma resolución de problemas, en lugar de un conjunto de campos distinto por origen.
• Ajuste y alcance — las opciones del controlador, como tiempos de espera, configuración TLS, proxies y tamaños de lectura, están disponibles para todos los orígenes, y puede conectarse cualquier tecnología con un controlador ODBC conforme, incluidas aquellas para las que digna no publica una guía específica.

En la práctica, esto significa que el conmutador Use ODBC y los campos separados de host, puerto, base de datos, usuario y contraseña ya no existen. Toda conexión que no use ya ODBC debe convertirse a ODBC: no hay conversión automática, así que planifíquelo antes de actualizar:

1. Revise cada conexión de base de datos definida en su instalación y anote las que aún no usan ODBC: cada una deberá reconfigurarse.
2. Instale el controlador ODBC correspondiente en el host de digna: las conexiones se abren desde el servidor que ejecuta el backend de digna, no desde el navegador. Consulte Instalar el controlador ODBC en el host de digna.
3. Tenga preparadas las propiedades ODBC de cada conexión afectada. Las guías por tecnología indican, para cada origen, un conjunto de propiedades probado.

Después de la actualización, convierta a ODBC cada conexión afectada y pruébela desde el panel: consulte Crear una conexión de base de datos y Probar una conexión.

Es obligatorio crear una copia de seguridad del repositorio de digna

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

Proceso de actualización¶

Paso 1: Detener el servicio antiguo y anular su registro¶

Si digna se está ejecutando como servicio de Windows, detenlo con los archivos batch de tu instalación actual: los comandos digna windows pertenecen a la nueva versión y todavía no están disponibles:

cd C:\path\to\digna\bin
stop_service.bat

A continuación, anula el registro del servicio, de nuevo con el archivo batch antiguo. El registro apunta al ejecutable antiguo y a sus scripts, que esta actualización sustituye, por lo que no puede reutilizarse:

uninstall_service.bat

Paso 2: Respaldar la instalación actual¶

En su directorio de instalación de digna, cambie el nombre de las carpetas de la instalación actual para que la nueva versión pueda desplegarse junto a ellas:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

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

Paso 4: Restaurar tus archivos de configuración¶

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[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'

[oidc_clients.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¶

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

digna config check

Todas las secciones deben informar OK. Corrija todo lo que se informe como FAILED y vuelva a ejecutar el comando antes de continuar.

Paso 7: Sustituir el archivo de licencia¶

Cada versión se licencia por separado. Copia el license.toml que el equipo de digna te proporcionó para esta versión en el directorio de instalación, sustituyendo el anterior:

copy /Y C:\path\to\new\license.toml license.toml

digna license check

Paso 8: Actualizar el esquema del repositorio¶

Navega a tu directorio de instalación de digna y ejecuta:

digna repo upgrade

Esto actualiza el esquema de PostgreSQL a la versión más reciente preservando todos los datos existentes.

Paso 9: Registrar e iniciar el servicio¶

El registro antiguo se eliminó en el paso 1, así que el servicio se vuelve a registrar, esta vez con el ejecutable digna, que no tiene archivos batch:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

Indica en --address y --port los valores en los que servía el servicio antiguo, salvo que quieras los nuevos valores predeterminados 127.0.0.1 y 8000; se guardan en el registro del servicio y ya no se leen de config.toml. Añade --account y --password si el servicio antiguo se ejecutaba con una cuenta de dominio. Consulta Ejecutar digna como servicio de Windows para ver la lista completa de opciones.

Si se ejecuta manualmente, reinicia el servidor:

cd C:\path\to\digna
digna serve --address <address> --port <port>

Si usas IIS o Tomcat, reinicia el servidor web correspondiente.

Paso 10: Verificar la actualización¶

1. Accede al dashboard de digna
2. Verifica que la interfaz se cargue correctamente
3. Revisa los registros del servidor en busca de errores
4. Convierta a ODBC todas las conexiones que aún no lo usaran y después pruebe todas las conexiones: consulte Probar una conexión