Guida all'installazione per Windows di digna Release 2026.06¶

Rilascio: 2026.06

Ultimo aggiornamento: 30 agosto 2026

Indice¶

1. Introduzione
2. Requisiti di sistema
3. Configurazione pre-installazione
4. Configurazione del server PostgreSQL
5. Configurazione del web server
6. Installazione iniziale
7. Configurazione del backend
8. Configurazione della dashboard
9. Eseguire digna come servizio Windows
10. Aggiornamento a una nuova release

Introduzione¶

Informazioni su digna¶

digna è una piattaforma completa guidata dall'IA progettata per ottimizzare la gestione della qualità dei dati in diversi ambienti dati come warehouse, lake e lakehouse. Progettata per essere altamente scalabile e adattabile, digna affronta le sfide moderne dei dati tramite automazione, monitoraggio in tempo reale e rilevamento delle anomalie.

digna è composta da due componenti principali:

• digna: il cuore dell'applicazione, responsabile dell'elaborazione dei dati e dell'esecuzione dei controlli di qualità. Unisce il backend e l'interfaccia a riga di comando in un unico eseguibile, sostituendo i programmi separati dignabackend e dignacli delle versioni precedenti.
• dignadashboard: un'interfaccia web ospitata su un web server, che fornisce un modo user-friendly per interagire con la piattaforma digna e visualizzare le metriche di qualità dei dati.

Novità nella Release 2026.06¶

Questa release integra funzionalità di osservabilità dei dati direttamente nel tuo codice, permettendo agli sviluppatori di monitorare la qualità dei dati alla fonte. Vedi le note di rilascio per i dettagli completi.

Cerchi macOS o Linux?¶

Questa guida copre Windows. Per altre piattaforme, consulta la Guida all'installazione per macOS o la Guida all'installazione per Linux.

Requisiti di sistema¶

Prima di iniziare l'installazione, assicurati che il sistema soddisfi i seguenti requisiti minimi:

Opzioni di installazione del database¶

Se PostgreSQL è già installato: Puoi aggiungere un nuovo database per digna al tuo server PostgreSQL esistente.

Se installi PostgreSQL sulla stessa macchina di digna:

Configurazione pre-installazione¶

Prima di installare digna, assicurati che siano presenti due prerequisiti chiave:

1. Server PostgreSQL – per memorizzare le metriche calcolate e i dati di performance
2. Web Server – per ospitare la digna Dashboard

Se questi componenti non sono già configurati, segui le sezioni seguenti per installarli e configurarli.

Configurazione del server PostgreSQL¶

Se PostgreSQL è già installato¶

Se PostgreSQL è già installato e in esecuzione sulla tua macchina locale o se stai usando un server PostgreSQL gestito remoto, puoi saltare alla sezione successiva.

Installazione di PostgreSQL¶

Segui questi passaggi per installare PostgreSQL su Windows:

Passo 1: Scarica PostgreSQL¶

1. Visita la pagina dei download di PostgreSQL
2. Seleziona Windows
3. Scarica l'installer più recente

Passo 2: Esegui l'Installer¶

1. Fai doppio clic sul file dell'installer scaricato
2. Segui le istruzioni della procedura guidata di installazione

Passo 3: Scegli la directory di installazione¶

Seleziona la directory in cui verrà installato PostgreSQL. La posizione predefinita è solitamente appropriata.

Passo 4: Seleziona i componenti¶

Per una configurazione standard, mantieni le opzioni dei componenti predefinite selezionate.

Passo 5: Imposta la password del superuser PostgreSQL¶

Inserisci e conferma una password per il superuser PostgreSQL (postgres). Salva questa password in modo sicuro — ti servirà più avanti.

Passo 6: Configura il numero di porta¶

La porta predefinita di PostgreSQL è 5432. Puoi usare la porta predefinita o specificarne un'altra se necessario.

Passo 7: Scegli la localizzazione (locale)¶

Seleziona la localizzazione per il tuo database. La predefinita è generalmente adatta alla maggior parte delle installazioni.

Passo 8: Completa l'installazione¶

Clicca su Avanti attraverso le restanti schermate, quindi clicca Fine.

Passo 9: Verifica l'installazione¶

Apri il Prompt dei comandi e verifica che PostgreSQL sia installato:

psql --version

Dovresti vedere la versione di PostgreSQL se l'installazione è andata a buon fine.

Configurazione del web server¶

digna richiede un web server per ospitare la dashboard. Scegli una delle seguenti opzioni:

• Internet Information Services (IIS)
• Apache Tomcat

Devi installare e configurare solo uno di questi server.

Configurazione di IIS¶

Panoramica¶

Internet Information Services (IIS) è il web server di Microsoft per ospitare siti web e applicazioni web.

Abilitare IIS¶

1. Apri il Pannello di controllo
2. Premi Win + R

3. Digita control e premi Invio

4. Vai a Funzionalità Windows

5. Clicca Programmi

6. Seleziona Attiva o disattiva funzionalità di Windows

7. Abilita Internet Information Services

8. Scorri verso il basso e trova Internet Information Services (IIS)
9. Seleziona la casella per abilitarlo

10. Clicca il + per espandere e verifica che questi sottocomponenti siano selezionati:

    • Web Management Tools
    • World Wide Web Services

11. Clicca OK per applicare le modifiche

12. Verifica l'installazione di IIS

13. Apri il browser
14. Vai a http://localhost
15. Dovresti vedere la pagina di benvenuto di IIS

Obbligatorio: URL Rewrite Module¶

IIS richiede il componente URL Rewrite. Scaricalo e installalo dalla pagina ufficiale Microsoft.

Obbligatorio: Tipo MIME per i file Markdown¶

Per assicurare che i file Markdown (.md) siano serviti correttamente da IIS:

1. Apri IIS Manager (premi Win + R, digita inetmgr, premi Invio)
2. Vai a Your Site > MIME Types
3. Clicca Add...
4. Configura:
5. File name extension: .md
6. MIME type: text/markdown

Configurazione di Apache Tomcat¶

Panoramica¶

Apache Tomcat è un contenitore di servlet Java open-source e un web server.

Installazione¶

1. Scarica Apache Tomcat
2. Visita Apache Tomcat Downloads

3. Scarica la distribuzione ZIP per Windows

4. Estrai l'archivio

5. Estrai il file ZIP in una directory sul tuo sistema

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

7. Verifica che Tomcat sia in esecuzione

8. Apri il browser
9. Vai a http://localhost:8080
10. Dovresti vedere la pagina di benvenuto di Apache Tomcat

Installazione iniziale¶

Passo 1: Configura il repository digna¶

Il repository digna memorizza tutte le metriche calcolate da digna. Funziona come database centrale per dati analitici e di performance.

Crea lo schema del repository e l'utente¶

Apri il client PostgreSQL (pgAdmin, psql o simili) ed esegui i seguenti comandi 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>;

Sostituisci i seguenti segnaposto:

• <digna_repo_schema> — Il nome dello schema desiderato (es., dignarepo)
• <digna_repo_user> — Il nome utente desiderato (es., digna_user)
• <digna_repo_password> — Una password sicura per questo utente

Esempio:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Passo 2: Estrai il pacchetto di installazione di digna¶

1. Individua il file ZIP di installazione di digna fornito a te
2. Estrailo nella posizione di installazione desiderata
3. Dopo l'estrazione, dovresti vedere i seguenti elementi:
4. dashboard/ — Interfaccia web della dashboard
5. digna — Eseguibile principale (backend + CLI combinati)

Passo 3: Installa il file di licenza¶

1. Individua il file license.toml fornito a te
2. Copialo nella directory di installazione principale di digna (dove si trovano config.toml e l'eseguibile digna)

Perché è importante: Il file di licenza contiene le informazioni del cliente, la data di scadenza della licenza e la firma digitale. Non modificare questo file — qualsiasi modifica lo invaliderà.

Struttura delle directory dopo la configurazione:

digna_installation/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
└── dashboard/          (web interface)
    └── (dashboard files)

Configurazione del backend¶

Passo 1: Crea e modifica il file di configurazione¶

Il file config_template.toml è fornito nella directory di installazione di digna. Devi solo rinominarlo in config.toml.

Posizione: digna_installation/config.toml

Apri config.toml in un editor di testo e configura ciascuna sezione descritta di seguito.

Sezione [app]¶

Questa sezione configura le impostazioni dell'applicazione backend di 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 = ["*"]

Sezione [repo]¶

Questa sezione configura la connessione al database 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!"

Sezione [base]¶

Questa sezione contiene impostazioni di sicurezza e cookie:

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

Sezione [encryption]¶

Questa sezione contiene la chiave usata per cifrare i valori sensibili memorizzati nel repository. È obbligatoria: config check segnala la sezione [encryption] come FAILED se la chiave manca.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Sezione [logging]¶

Questa sezione configura il comportamento del logging:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Passo 2: Verificare la configurazione¶

Prima di inizializzare il repository, verificate che config.toml sia completo e ben formato. Nella directory di installazione di digna eseguite:

digna config check

Ogni sezione viene validata singolarmente, così un singolo errore non nasconde lo stato delle altre:

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

Correggete tutto ciò che viene segnalato come FAILED e rieseguite il comando prima di proseguire. L'elenco completo delle opzioni è nel riferimento CLI.

Passo 3: Inizializza il repository¶

1. Apri il Prompt dei comandi
2. Vai nella directory di installazione di digna (dove si trovano config.toml e l'eseguibile digna)
3. Esegui il test di connessione:

digna repo check

Dovresti vedere una conferma che la connessione è stabilita (il repository vero e proprio non è ancora stato inizializzato).

Passo 4: Installa lo schema del repository¶

Nella stessa directory, esegui:

digna repo install

Questo comando installa le tabelle e lo schema necessari nel tuo database PostgreSQL.

Passo 5: Crea un utente Admin¶

1. Apri una nuova finestra del Prompt dei comandi
2. Vai nella directory di installazione di digna
3. Esegui il seguente comando per creare un utente amministratore:

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

Esempio:

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

Questo crea un utente con pieni privilegi amministrativi.

Passo 6: Avvia il server digna¶

Nella directory di installazione di digna, avvia il server con:

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

Parametri: - --address — Hostname/IP del server - --port — Porta del server

Dovresti vedere messaggi di avvio che confermano l'esecuzione del server:

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

Configurazione della dashboard¶

Passo 1: Distribuisci la dashboard sul web server¶

La dashboard digna legge la propria configurazione da dashboard/dashboard_config.toml. Questo file non è incluso nell'installazione: lo create nella directory dashboard/, insieme ai file della dashboard.

Il suo contenuto è descritto in Single Sign-On, che è anche il punto in cui il file diventa necessario: contiene le opzioni di accesso offerte dalla dashboard e, per i deployment multi-istanza, la connessione al backend.

Scegli il tuo web server e segui i relativi passaggi di deployment.

Distribuzione su IIS¶

1. Apri IIS Manager

2. Premi Win + R, digita inetmgr, premi Invio

3. Crea un nuovo sito web

4. Nel pannello a sinistra, fai clic destro su Sites

5. Seleziona Add Website...

6. Configura il sito

7. Site Name: Inserisci un nome (es., "dignaDashboard")
8. Physical Path: Clicca Browse e seleziona la cartella dashboard

9. Binding: Imposta indirizzo IP e porta (porta predefinita 80 per HTTP, 443 per HTTPS)

10. Avvia il sito

11. Clicca OK per creare il sito

12. Fai clic destro sul nuovo sito e seleziona Start

13. Testa l'installazione

14. Apri il browser
15. Vai a http://localhost (o all'URL configurato)
16. Dovresti vedere la pagina di login della dashboard digna

Distribuzione su Apache Tomcat¶

1. Copia la dashboard in Tomcat
2. Copia la cartella dashboard nella directory webapps di Tomcat
3. Rinominala se necessario (es., in digna)

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

5. Verifica il deployment

6. Aggiorna o ricarica la pagina di gestione di Tomcat (http://localhost:8080)

7. Dovresti vedere "digna" (o il nome scelto) elencata nelle applicazioni deployate

8. Accedi alla dashboard

9. Apri il browser
10. Vai a http://localhost:8080/digna
11. Dovresti vedere la pagina di login della dashboard digna

Eseguire digna come servizio Windows¶

Perché utilizzare un servizio di Windows?¶

Eseguire il backend digna come servizio di Windows garantisce che: - Si avvii automaticamente all'accensione del server - Sia in esecuzione in background senza un Prompt dei comandi aperto - Si riavvii automaticamente in caso di crash - Possa essere gestito tramite i Servizi di Windows

I comandi windows¶

Il servizio viene gestito dall'eseguibile digna stesso, tramite i sottocomandi digna windows. Non ci sono file batch da eseguire.

Ogni comando accetta --name per indicare un servizio registrato con un nome diverso da quello predefinito. L'elenco completo delle opzioni si trova nel riferimento della CLI.

Installazione del servizio¶

1. Apri il Prompt dei comandi come Amministratore
2. Fai clic destro su Prompt dei comandi

3. Seleziona "Esegui come amministratore"

4. Vai nella directory di installazione di digna

   cd C:\path\to\digna
   

5. Registra il servizio

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Il servizio viene registrato con avvio automatico, quindi si avvierà insieme a Windows. Non si avvia immediatamente — vedi la sezione successiva.

Opzioni di installazione¶

Avviare e fermare il servizio¶

Per avviare il servizio¶

digna windows start

Per fermare il servizio¶

digna windows stop

Spostare il servizio in una nuova directory¶

Se è necessario spostare l'installazione di digna:

1. Ferma e deregistra il servizio corrente

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

2. Sposta i file dell'applicazione

3. Sposta l'intera cartella di installazione digna nella nuova posizione

4. Registra di nuovo il servizio dalla nuova posizione

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

Ripeti gli eventuali valori di --address, --port o --account usati la prima volta: la registrazione precedente non esiste più.

1. Avvia il servizio

   digna windows start
   

Disinstallare il servizio¶

1. Ferma il servizio in esecuzione

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

2. Deregistra il servizio

   digna windows uninstall
   

Il server digna è ora deregistrato come servizio di Windows.

Aggiornamento a una nuova release¶

Prima di aggiornare¶

Verificate prima tutte le connessioni ai database

A partire dalla Release 2026.06, digna raggiunge ogni tecnologia sorgente tramite ODBC. Le versioni precedenti offrivano la scelta tra un driver specifico per tecnologia e ODBC, selezionata con l'interruttore Use ODBC. Il team digna ha deciso di basarsi solo su ODBC, perché un'unica interfaccia standard offre più di un insieme di driver su misura:

• Autenticazione — l'autenticazione fa parte di ODBC, quindi una connessione può usare tutto ciò che il suo driver supporta: password, token e PAT, Kerberos e Active Directory, MFA e single sign-on da browser, identità cloud, certificati client e TLS. I nuovi metodi arrivano con un aggiornamento del driver, senza attendere una release di digna.
• Driver mantenuti dai produttori dei database — il driver del produttore segue le nuove versioni del server e le correzioni di sicurezza, e potete aggiornarlo secondo i vostri tempi, indipendentemente da digna.
• Un solo modo di configurare tutto — ogni tecnologia è un elenco di proprietà chiave/valore, con la stessa interfaccia, la stessa cifratura dei valori sensibili e la stessa diagnostica, invece di un insieme di campi diverso per ogni sorgente.
• Regolazione e portata — le opzioni del driver come timeout, impostazioni TLS, proxy e dimensioni di fetch sono disponibili per ogni sorgente, e qualsiasi tecnologia con un driver ODBC conforme può essere collegata, comprese quelle per cui digna non pubblica una guida dedicata.

In pratica questo significa che l'interruttore Use ODBC e i campi separati host, porta, database, utente e password non esistono più. Ogni connessione che non usa già ODBC deve essere convertita a ODBC: non esiste una conversione automatica, quindi pianificatela prima dell'aggiornamento:

1. Esaminate ogni connessione definita nella vostra installazione e annotate quelle che non usano ancora ODBC: ciascuna dovrà essere riconfigurata.
2. Installate il driver ODBC corrispondente sull'host digna: le connessioni vengono aperte dal server che esegue il backend digna, non dal browser. Vedi Installare il driver ODBC sull'host digna.
3. Tenete pronte le proprietà ODBC per ogni connessione interessata. Le guide per tecnologia riportano, per ogni sorgente, un insieme di proprietà collaudato.

Dopo l'aggiornamento, convertite a ODBC ogni connessione interessata e provatela dalla dashboard: vedi Creare una connessione al database e Testare una connessione.

È obbligatorio creare un backup del repository digna

Prima di aggiornare digna, esegui il backup del tuo repository (PostgreSQL) per proteggerti da perdita di dati. Un backup garantisce il recupero in caso di problemi imprevisti durante l'aggiornamento.

Procedura di aggiornamento¶

Passo 1: Ferma e deregistra il vecchio servizio¶

Se digna è in esecuzione come servizio di Windows, fermalo con i file batch dell'installazione attuale: i comandi digna windows appartengono alla nuova release e non sono ancora disponibili:

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

Poi deregistra il servizio, sempre con il vecchio file batch. La registrazione punta al vecchio eseguibile e ai suoi script, entrambi sostituiti da questo aggiornamento, quindi non può essere riutilizzata:

uninstall_service.bat

Passo 2: Eseguire il backup dell'installazione attuale¶

Nella directory di installazione di digna, rinominate le cartelle dell'installazione attuale in modo che la nuova release possa essere distribuita accanto a esse:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

Passo 3: Estrai e distribuisci la nuova versione¶

1. Estrai il nuovo file ZIP di installazione di digna
2. Copia il nuovo eseguibile digna e la cartella dashboard nella directory di installazione

Passo 4: Ripristina i tuoi file di configurazione¶

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'

Passo 5: Ricaricare il web server¶

La dashboard è un insieme di file statici, quindi il web server (e il browser) potrebbe ancora servire la versione precedente. Ricaricate o riavviate il web server che ospita la cartella dashboard, quindi ricaricate la pagina con un aggiornamento forzato (Ctrl+F5).

Passo 6: Verificare la configurazione¶

Verificate che il config.toml aggiornato sia completo prima di toccare il repository:

digna config check

Ogni sezione deve riportare OK. Correggete tutto ciò che viene segnalato come FAILED e rieseguite il comando prima di proseguire.

Passo 7: Sostituire il file di licenza¶

Ogni release ha una licenza separata. Copiate il license.toml che il team digna vi ha fornito per questa release nella directory di installazione, sostituendo quello vecchio:

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

digna license check

Passo 8: Aggiorna lo schema del repository¶

Vai nella directory di installazione di digna ed esegui:

digna repo upgrade

Questo aggiorna lo schema PostgreSQL all'ultima versione preservando tutti i dati esistenti.

Passo 9: Registrare e avviare il servizio¶

La vecchia registrazione è stata rimossa nel Passo 1, quindi il servizio va registrato di nuovo, questa volta con l'eseguibile digna, che non ha file batch:

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

Indicate per --address e --port i valori su cui rispondeva il vecchio servizio, a meno che non vogliate i nuovi valori predefiniti 127.0.0.1 e 8000; vengono salvati nella registrazione e non sono più letti da config.toml. Aggiungete --account e --password se il vecchio servizio veniva eseguito con un account di dominio. Vedi Eseguire digna come servizio Windows per l'elenco completo delle opzioni.

Se in esecuzione manualmente, riavvia il server:

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

Se usi IIS o Tomcat, riavvia il relativo web server.

Passo 10: Verifica l'aggiornamento¶

1. Accedi alla dashboard di digna
2. Verifica che l'interfaccia si carichi correttamente
3. Controlla i log del server per eventuali errori
4. Convertite a ODBC ogni connessione che non lo usava ancora, poi testate tutte le connessioni: vedi Testare una connessione