Guida all'installazione su macOS per digna Release 2026.06¶

Release: 2026.06

Ultimo aggiornamento: 5 settembre 2026

Sommario¶

1. Introduzione
2. Requisiti di sistema
3. Prerequisiti prima dell'installazione
4. Configurazione del server PostgreSQL
5. Configurazione del web server
6. Installazione iniziale
7. Configurazione del backend
8. Configurazione della dashboard
9. Esecuzione di digna come servizio in background
10. Aggiornamento a una nuova release

Introduzione¶

Informazioni su digna¶

digna è una piattaforma completa guidata dall'AI progettata per ottimizzare la gestione della qualità dei dati in diversi ambienti dati come data warehouse, data 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 di 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 intuitivo per interagire con la piattaforma digna e visualizzare le metriche di qualità dei dati.

Novità nella Release 2026.06¶

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

Cerchi Windows o Linux?¶

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

Requisiti di sistema¶

Prima di iniziare l'installazione, assicurati che il tuo 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:

Verificare l'architettura¶

Diversi percorsi in questa guida differiscono tra Mac Apple Silicon e Intel. Per verificare quale hai, apri il Terminale ed esegui:

uname -m

• arm64 — Apple Silicon. Homebrew installa in /opt/homebrew.
• x86_64 — Intel. Homebrew installa in /usr/local.

Prerequisiti prima dell'installazione¶

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

1. Homebrew – il package manager usato per installare i componenti seguenti
2. Server PostgreSQL – per memorizzare le metriche calcolate e i dati di performance
3. Web Server – per ospitare la Dashboard di digna

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

Installare Homebrew¶

Homebrew è il package manager standard per macOS ed è usato in tutta la guida per installare PostgreSQL e nginx.

Passo 1: Verificare se Homebrew è già installato¶

Apri il Terminale (premi Cmd + Space, digita Terminal, premi Invio) ed esegui:

brew --version

Se viene restituito un numero di versione, passa alla sezione Configurazione del server PostgreSQL.

Passo 2: Installare Homebrew¶

Se il comando non è stato trovato, installa Homebrew seguendo le istruzioni sul sito ufficiale di Homebrew. L'installer installa anche gli Xcode Command Line Tools se non sono già presenti.

Passo 3: Aggiungere Homebrew al PATH¶

Su Apple Silicon, l'installer stampa due comandi per aggiungere Homebrew all'ambiente della shell. Eseguili come indicato, poi conferma:

brew --prefix

Questo dovrebbe stampare /opt/homebrew su Apple Silicon o /usr/local su Intel.

Configurazione del server PostgreSQL¶

Se hai già PostgreSQL¶

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

Opzioni di installazione¶

macOS offre due modi semplici per installare PostgreSQL. Scegli uno:

• Homebrew — installazione da riga di comando, raccomandata per distribuzioni server
• Postgres.app — installazione grafica, comoda per valutazioni locali

Installare PostgreSQL con Homebrew¶

Passo 1: Installare la formula PostgreSQL¶

brew install postgresql@16

Passo 2: Aggiungere PostgreSQL al PATH¶

Le formule PostgreSQL versionate sono keg-only, il che significa che Homebrew non collega automaticamente i loro comandi nel tuo PATH. Aggiungili manualmente:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Passo 3: Avviare il servizio PostgreSQL¶

brew services start postgresql@16

Questo avvia PostgreSQL immediatamente e lo configura per l'avvio automatico al login.

Passo 4: Verificare l'installazione¶

psql --version

Dovresti vedere la versione di PostgreSQL se l'installazione ha avuto successo.

Passo 5: Collegarsi al server¶

psql postgres

Passo 6: Confermare la porta¶

La porta predefinita di PostgreSQL è 5432. Per confermare su quale porta il server è in ascolto:

psql postgres -c "SHOW port;"

Annota il valore — ti servirà quando configurerai il backend di digna.

Installare PostgreSQL con Postgres.app¶

Se preferisci un'installazione grafica:

1. Scarica Postgres.app e trascinalo nella cartella Applications
2. Apri l'app e clicca su Initialize per creare un nuovo server
3. Segui le istruzioni dell'app per aggiungere gli strumenti da riga di comando al tuo PATH
4. Verifica l'installazione:

psql --version

Postgres.app crea anch'esso un superuser con il nome del tuo account macOS.

Configurazione del web server¶

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

• nginx — installato tramite Homebrew, raccomandato
• Apache httpd — incluso con macOS

Devi installare e configurare solo uno di questi server.

Entrambe le sezioni configurano due aspetti di cui la dashboard dipende:

• Fallback per single-page application, in modo che aggiornare un URL della dashboard non ritorni un 404
• Tipo MIME per i file .md, in modo che i file Markdown vengano serviti correttamente

Configurazione di nginx¶

Panoramica¶

nginx è un web server leggero e ad alte prestazioni, adatto per servire la dashboard statica di digna.

Installazione¶

brew install nginx

Avvio di nginx¶

brew services start nginx

Verificare l'installazione¶

1. Apri il browser
2. Vai a http://localhost:8080
3. Dovresti vedere la pagina di benvenuto di nginx

Configurare un sito per la Dashboard¶

La configurazione di nginx di Homebrew include ogni file nella directory servers. Crea un file di configurazione dedicato per digna lì:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Incolla quanto segue, sostituendo /path/to/digna/dashboard con il percorso effettivo alla cartella dashboard estratta:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/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;
    }
}

Applicare la configurazione¶

Testa la configurazione per errori di sintassi, poi ricarica nginx:

nginx -t
brew services restart nginx

Configurazione di Apache httpd¶

Panoramica¶

macOS include Apache httpd, quindi non è richiesta alcuna installazione. È disabilitato di default.

Avviare Apache¶

sudo apachectl start

Verificare l'installazione¶

1. Apri il browser
2. Vai a http://localhost
3. Dovresti vedere il messaggio "It works!"

Obbligatorio: Abilitare mod_rewrite¶

La dashboard richiede la riscrittura degli URL. Apri la configurazione di Apache:

sudo nano /etc/apache2/httpd.conf

Trova la seguente riga e rimuovi il # iniziale per decommentarla:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Obbligatorio: Consentire override tramite .htaccess¶

Nello stesso file, individua il blocco <Directory "/Library/WebServer/Documents"> e cambia:

AllowOverride None

in:

AllowOverride All

Obbligatorio: Tipo MIME per i file Markdown¶

Sempre in httpd.conf, aggiungi la seguente riga in modo che i file Markdown vengano serviti correttamente:

AddType text/markdown .md

Applicare la configurazione¶

Controlla la configurazione per errori di sintassi, poi riavvia Apache:

sudo apachectl configtest
sudo apachectl restart

Installazione iniziale¶

Passo 1: Configurare il Repository digna¶

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

Creare lo schema del repository e l'utente¶

Apri il tuo client PostgreSQL (psql, pgAdmin 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;

Per eseguire questi comandi dal Terminale in un unico passaggio:

psql postgres

Poi incolla le istruzioni al prompt postgres=# e digita \q per uscire.

Passo 2: Estrarre il pacchetto di installazione di digna¶

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

Per estrarre dal Terminale:

unzip digna-2026.06-macos.zip -d /opt/digna

Rendere l'eseguibile eseguibile¶

A seconda di come è stato trasferito l'archivio, il bit eseguibile potrebbe non essere preservato. Impostalo esplicitamente:

cd /opt/digna
chmod +x digna

Se macOS blocca l'applicazione¶

I file scaricati tramite browser o client di posta sono contrassegnati con un attributo di quarantine. Se macOS segnala che l'app "non può essere aperta perché lo sviluppatore non può essere verificato", rimuovi l'attributo dalla directory di installazione:

xattr -dr com.apple.quarantine /opt/digna

In alternativa, apri Impostazioni di Sistema → Privacy e sicurezza, trova l'elemento bloccato verso il fondo della pagina e clicca Apri comunque.

Passo 3: Installare il file di licenza¶

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

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

Struttura di directory dopo la configurazione:

/opt/digna/
├── config.toml         (file di configurazione)
├── license.toml        (IL TUO FILE DI LICENZA - copialo qui)
├── digna               (eseguibile principale)
├── bin/                (script per la gestione del servizio)
└── dashboard/          (interfaccia web)
    └── (file della dashboard)

Configurazione del backend¶

Passo 1: Creare e modificare il file di configurazione¶

Il file config_template.toml è fornito nella directory di installazione di digna. È sufficiente rinominarlo in config.toml.

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

Posizione: /opt/digna/config.toml

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

Sezione [app]¶

Questa sezione configura le impostazioni dell'app 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: Inizializzare il Repository¶

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

cd /opt/digna
./digna repo check

Dovresti vedere una conferma che la connessione è stabilita (il repository in sé non è ancora stato inizializzato).

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

Passo 4: Installare 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: Creare un utente amministratore¶

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

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

Esempio:

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

Questo crea un utente con l'indirizzo e-mail admin@example.com e privilegi amministrativi completi.

Passo 6: Avviare 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 che il server è in esecuzione:

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: Distribuire 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 corrispondenti passi di distribuzione.

Distribuzione su nginx¶

Se hai seguito la sezione nginx Setup, il blocco server punta già alla tua cartella dashboard ed è quindi inutile copiare i file.

1. Conferma il percorso
2. Apri $(brew --prefix)/etc/nginx/servers/digna.conf

3. Verifica che root punti alla cartella dashboard estratta

4. Assicurati che la cartella sia leggibile

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

5. Ricarica nginx

   nginx -t
   brew services restart nginx
   

6. Test dell'installazione

7. Apri il browser
8. Vai a http://localhost:8080 (o all'URL configurato)
9. Dovresti vedere la pagina di login della dashboard di digna

Distribuzione su Apache httpd¶

1. Copiare la dashboard nella Document Root

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Aggiungere le regole di riscrittura

Crea un file .htaccess nella cartella distribuita in modo che le route della dashboard sopravvivano a un refresh del browser:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Incolla quanto segue:

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. Riavviare Apache

   sudo apachectl restart
   

2. Accedere alla Dashboard

3. Apri il browser
4. Vai a http://localhost/digna
5. Dovresti vedere la pagina di login della dashboard di digna

Esecuzione di digna come servizio in background¶

Perché eseguire digna come servizio?¶

Eseguire il backend digna come servizio in background garantisce che:

• Si avvii automaticamente all'accensione della macchina
• Giri in background senza una finestra Terminale aperta
• Si riavvii automaticamente in caso di crash
• Possa essere gestito tramite launchctl, il gestore di servizi di macOS

File per la gestione del servizio¶

Tutti i file necessari si trovano nella directory di installazione di digna sotto: bin/

Gli script shell disponibili sono:

• install_service.sh — Registra digna con launchd
• uninstall_service.sh — Annulla la registrazione del servizio
• start_service.sh — Avvia il servizio registrato
• stop_service.sh — Ferma il servizio in esecuzione

Rendere gli script eseguibili¶

L'estrazione potrebbe non preservare il bit eseguibile. Prima del primo uso:

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

Installare il servizio¶

1. Apri il Terminale

2. Vai nella cartella bin

   cd /opt/digna/bin
   

3. Esegui lo script di installazione

   sudo ./install_service.sh
   

Il server digna è ora registrato con launchd con l'avvio automatico abilitato. Il servizio non parte immediatamente — vedi la sezione successiva per avviarlo.

Avviare e fermare il servizio¶

Per avviare il servizio¶

1. Apri il Terminale
2. Vai in /opt/digna/bin
3. Esegui:

   sudo ./start_service.sh
   

Per fermare il servizio¶

1. Apri il Terminale
2. Vai in /opt/digna/bin
3. Esegui:

   sudo ./stop_service.sh
   

Verificare il servizio¶

Per confermare che il servizio è registrato e in esecuzione:

sudo launchctl list | grep digna

Una riga che inizia con un process ID indica che il servizio è in esecuzione. Un - nella prima colonna significa che è registrato ma fermo.

Spostare il servizio in una nuova directory¶

launchd memorizza il percorso assoluto dell'eseguibile, quindi spostare l'installazione richiede la registrazione nuovamente del servizio:

1. Disinstallare il servizio corrente

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

2. Spostare i file dell'applicazione

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

3. Reinstallare il servizio

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

4. Avviare il servizio

   sudo ./start_service.sh
   

Disinstallare il servizio¶

1. Fermare il servizio in esecuzione

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

2. Disinstallare il servizio

   sudo ./uninstall_service.sh
   

Il server digna è ora rimosso dalla registrazione in launchd.

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 perdite di dati. Un backup ti permette di recuperare in caso l'aggiornamento incontri problemi inattesi.

Per creare un backup dal Terminale:

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

Processo di aggiornamento¶

Passo 1: Fermare il servizio digna¶

Se digna è in esecuzione come servizio in background, fermalo prima:

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

Se digna è in esecuzione in primo piano, premi Ctrl + C nella finestra Terminale in cui è in esecuzione.

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:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Passo 3: Estrarre e distribuire 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
3. Ripristina il bit eseguibile e, se necessario, rimuovi l'attributo di quarantine:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Passo 4: Ripristinare i file di configurazione¶

cp 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 (Cmd+Shift+R).

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:

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

./digna license check

Passo 8: Aggiornare lo schema del Repository¶

Vai nella directory di installazione di digna ed esegui:

cd /opt/digna
./digna repo upgrade

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

Passo 9: Riavviare i servizi¶

Se stai eseguendo digna come servizio in background:

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

Se lo esegui manualmente, riavvia il server:

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

Se usi nginx o Apache, riavvia il relativo web server:

brew services restart nginx

sudo apachectl restart

Passo 10: Verificare l'aggiornamento¶

1. Accedi alla dashboard di digna
2. Verifica che l'interfaccia venga caricata 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