macOS-installatiehandleiding voor digna Release 2026.11¶

Release: 2026.11

Laatst bijgewerkt: 7 november 2026

Inhoudsopgave¶

1. Introductie
2. Systeemvereisten
3. Voorbereiding vóór installatie
4. PostgreSQL-serverconfiguratie
5. Webserverconfiguratie
6. Initiële installatie
7. Backendconfiguratie
8. Dashboardconfiguratie
9. digna als achtergrondservice draaien
10. Upgraden naar een nieuwe release

Introductie¶

Over digna¶

digna is een uitgebreid AI-gestuurd platform dat is ontworpen om het beheer van datakwaliteit te optimaliseren in uiteenlopende dataomgevingen zoals warehouses, lakes en lakehouses. Het is gebouwd om zeer schaalbaar en aanpasbaar te zijn en pakt moderne data-uitdagingen aan via automatisering, realtime monitoring en anomaliedetectie.

digna bestaat uit twee hoofdcomponenten:

• digna: de kern van de applicatie, verantwoordelijk voor het verwerken van gegevens en het uitvoeren van kwaliteitscontroles. Het combineert de backend en de opdrachtregelinterface in één uitvoerbaar bestand en vervangt daarmee de losse programma's dignabackend en dignacli uit eerdere releases.
• dignadashboard: Een webgebaseerde interface gehost op een webserver, die een gebruiksvriendelijke manier biedt om met het digna-platform te werken en datakwaliteitsstatistieken te visualiseren.

Wat is nieuw in Release 2026.11¶

Deze release voegt digna Data Reconciliation toe, digna Agentic met de digna MCP Server, en de digna Engine, die data binnen digna kan profileren en referentiële integriteit kan controleren tussen verschillende databasetechnologieën. Zie de release notes voor volledige details.

Voor een installatie brengt de release een nieuw migratiemechanisme voor de repository, een optionele [duckdb]-sectie in config.toml voor de digna Engine en een nieuw licentiebestand. De upgradesectie behandelt elk daarvan.

Op zoek naar Windows of Linux?¶

Deze handleiding behandelt macOS. Voor andere platforms, zie de Windows-installatiehandleiding of de Linux-installatiehandleiding.

Systeemvereisten¶

Voordat u met de installatie begint, zorgt u ervoor dat uw systeem aan de volgende minimale vereisten voldoet:

Opties voor database-installatie¶

Als PostgreSQL al is geïnstalleerd: U kunt een nieuwe database voor digna toevoegen aan uw bestaande PostgreSQL-server.

Als u PostgreSQL op dezelfde machine als digna installeert:

Uw architectuur controleren¶

Verschillende paden in deze handleiding verschillen tussen Macs met Apple Silicon en Intel. Om te controleren welke u hebt, opent u Terminal en voert u uit:

uname -m

• arm64 — Apple Silicon. Homebrew installeert naar /opt/homebrew.
• x86_64 — Intel. Homebrew installeert naar /usr/local.

Voorbereiding vóór installatie¶

Voordat u digna installeert, zorgt u dat drie belangrijke vereisten aanwezig zijn:

1. Homebrew – de pakketbeheerder waarmee de onderstaande componenten worden geïnstalleerd
2. PostgreSQL-server – voor het opslaan van berekende metrics en prestatiegegevens
3. Webserver – voor het hosten van het digna-dashboard

Als deze componenten nog niet zijn ingesteld, volg dan de onderstaande secties om ze te installeren en te configureren.

Homebrew installeren¶

Homebrew is de standaardpakketbeheerder voor macOS en wordt in deze hele handleiding gebruikt om PostgreSQL en nginx te installeren.

Stap 1: Controleer of Homebrew al is geïnstalleerd¶

Open Terminal (druk op Cmd + Space, typ Terminal, druk op Enter) en voer uit:

brew --version

Als er een versienummer wordt getoond, ga dan direct naar de sectie PostgreSQL-serverconfiguratie.

Stap 2: Installeer Homebrew¶

Als het commando niet werd gevonden, installeer Homebrew dan volgens de instructies op de officiële Homebrew-site. Het installatieprogramma installeert ook de Xcode Command Line Tools als die nog niet aanwezig zijn.

Stap 3: Voeg Homebrew toe aan uw PATH¶

Op Apple Silicon toont het installatieprogramma twee commando's om Homebrew aan uw shell-omgeving toe te voegen. Voer ze uit zoals aangegeven en controleer daarna:

brew --prefix

Dit zou /opt/homebrew moeten tonen op Apple Silicon of /usr/local op Intel.

PostgreSQL-serverconfiguratie¶

Als u PostgreSQL al hebt¶

Als PostgreSQL al is geïnstalleerd en draait op uw lokale machine, of als u een beheerde externe PostgreSQL-server gebruikt, kunt u doorgaan naar de volgende sectie.

Installatieopties¶

macOS biedt twee eenvoudige manieren om PostgreSQL te installeren. Kies er één:

• Homebrew — installatie via de opdrachtregel, aanbevolen voor serverimplementaties
• Postgres.app — grafische installatie, handig voor lokale evaluatie

PostgreSQL installeren met Homebrew¶

Stap 1: Installeer de PostgreSQL-formule¶

brew install postgresql@16

Stap 2: Voeg PostgreSQL toe aan uw PATH¶

Formules van PostgreSQL met een versienummer zijn keg-only, wat betekent dat Homebrew hun commando's niet automatisch in uw PATH koppelt. Voeg ze zelf toe:

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

Stap 3: Start de PostgreSQL-service¶

brew services start postgresql@16

Dit start PostgreSQL direct en stelt het zo in dat het automatisch opnieuw start wanneer u zich aanmeldt.

Stap 4: Verifieer de installatie¶

psql --version

U zou de PostgreSQL-versie moeten zien als de installatie is geslaagd.

Stap 5: Verbinden met de server¶

psql postgres

Stap 6: Bevestig de poort¶

De standaardpoort van PostgreSQL is 5432. Om te bevestigen op welke poort uw server luistert:

psql postgres -c "SHOW port;"

Noteer de waarde — u hebt die nodig bij het configureren van de digna-backend.

PostgreSQL installeren met Postgres.app¶

Als u de voorkeur geeft aan een grafische installatie:

1. Download Postgres.app en sleep het naar uw map Applications
2. Open de app en klik op Initialize om een nieuwe server aan te maken
3. Volg de instructies van de app om de opdrachtregelprogramma's aan uw PATH toe te voegen
4. Verifieer de installatie:

psql --version

Postgres.app maakt ook een superuser aan met de naam van uw macOS-account.

Webserverconfiguratie¶

digna heeft een webserver nodig om het dashboard te hosten. Kies een van de volgende opties:

• nginx — geïnstalleerd via Homebrew, aanbevolen
• Apache httpd — meegeleverd met macOS

U hoeft slechts één van deze servers te installeren en te configureren.

Beide secties configureren twee zaken waarvan het dashboard afhankelijk is:

• Een fallback voor single-page-applicaties, zodat het vernieuwen van een dashboard-URL geen 404 oplevert
• Een .md-MIME-type, zodat Markdown-bestanden correct worden geserveerd

nginx-configuratie¶

Overzicht¶

nginx is een lichtgewicht, krachtige webserver die zeer geschikt is voor het serveren van het statische digna-dashboard.

Installatie¶

brew install nginx

nginx starten¶

brew services start nginx

Verifieer de installatie¶

1. Open uw browser
2. Navigeer naar http://localhost:8080
3. U zou de welkomstpagina van nginx moeten zien

Een site configureren voor het dashboard¶

De nginx-configuratie van Homebrew neemt elk bestand in de map servers op. Maak daar een apart configuratiebestand voor digna aan:

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

Plak het volgende en vervang /path/to/digna/dashboard door het werkelijke pad naar uw uitgepakte dashboard-map:

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;
    }
}

Pas de configuratie toe¶

Test de configuratie op syntaxfouten en herlaad daarna nginx:

nginx -t
brew services restart nginx

Apache httpd-configuratie¶

Overzicht¶

macOS bevat Apache httpd, dus er is geen installatie nodig. Het is standaard uitgeschakeld.

Apache starten¶

sudo apachectl start

Verifieer de installatie¶

1. Open uw browser
2. Navigeer naar http://localhost
3. U zou het bericht "It works!" moeten zien

Vereist: mod_rewrite inschakelen¶

Het dashboard vereist URL-herschrijving. Open de Apache-configuratie:

sudo nano /etc/apache2/httpd.conf

Zoek de volgende regel en verwijder het voorloop-# om de regel te activeren:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Vereist: .htaccess-overrides toestaan¶

Zoek in hetzelfde bestand het blok <Directory "/Library/WebServer/Documents"> en wijzig:

AllowOverride None

in:

AllowOverride All

Vereist: MIME-type voor Markdown-bestanden¶

Voeg, nog steeds in httpd.conf, de volgende regel toe zodat Markdown-bestanden correct worden geserveerd:

AddType text/markdown .md

Pas de configuratie toe¶

Controleer de configuratie op syntaxfouten en herstart daarna Apache:

sudo apachectl configtest
sudo apachectl restart

Initiële installatie¶

Stap 1: Zet de digna-repository op¶

De digna-repository slaat alle door digna berekende metrics op. Ze fungeert als centrale database voor analytische en prestatiegegevens.

Maak het repository-schema en de gebruiker aan¶

Open uw PostgreSQL-client (psql, pgAdmin of vergelijkbaar) en voer de volgende SQL-commando's uit:

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>;

Vervang de volgende placeholders:

• <digna_repo_schema> — De gewenste schemanaam (bijv. dignarepo)
• <digna_repo_user> — De gewenste gebruikersnaam (bijv. digna_user)
• <digna_repo_password> — Een veilig wachtwoord voor deze gebruiker

Voorbeeld:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Om deze in één stap vanuit de Terminal uit te voeren:

psql postgres

Plak daarna de statements bij de prompt postgres=# en typ \q om af te sluiten.

Stap 2: Pak het digna-installatiepakket uit¶

1. Zoek het digna-installatie-ZIP-bestand dat aan u is geleverd
2. Pak het uit naar uw gewenste installatieplek — bijvoorbeeld /opt/digna of ~/digna
3. Na uitpakken zou u de volgende items moeten zien:
4. dashboard/ — Webdashboard-interface
5. digna — Hoofdprogramma (backend + CLI gecombineerd)

Om vanuit de Terminal uit te pakken:

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

Maak het uitvoerbare bestand uitvoerbaar¶

Afhankelijk van hoe het archief is overgedragen, blijft het uitvoerbaar-bit bij het uitpakken mogelijk niet behouden. Stel het expliciet in:

cd /opt/digna
chmod +x digna

Als macOS de applicatie blokkeert¶

Bestanden die via een browser of mailprogramma zijn gedownload, krijgen een quarantaine-attribuut. Als macOS meldt dat de app "niet kan worden geopend omdat de ontwikkelaar niet kan worden geverifieerd", verwijder het attribuut dan uit de installatiemap:

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

U kunt ook System Settings → Privacy & Security openen, het geblokkeerde item onderaan de pagina zoeken en op Open Anyway klikken.

Stap 3: Installeer het licentiebestand¶

1. Zoek het license.toml-bestand dat aan u is geleverd
2. Kopieer het in de root van de digna-installatiemap (waar config.toml en het digna-uitvoerbare bestand zich bevinden)

Waarom dit van belang is: Het licentiebestand bevat uw klantgegevens, licentievervaldatum en digitale handtekening. Wijzig dit bestand niet — elke aanpassing maakt de licentie ongeldig.

Mapstructuur na installatie:

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

Backendconfiguratie¶

Stap 1: Maak en bewerk het configuratiebestand¶

Het config_template.toml-bestand wordt meegeleverd in uw digna-installatiemap. U hoeft het alleen maar te hernoemen naar config.toml.

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

Locatie: /opt/digna/config.toml

Open config.toml in een teksteditor en configureer elke sectie hieronder.

[app] Sectie¶

Deze sectie configureert cross-origin resource sharing (CORS) tussen het dashboard en de backend:

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

[repo] Sectie¶

Deze sectie configureert de verbinding met de PostgreSQL-database:

[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

[base] Sectie¶

Deze sectie bevat beveiligings-, cookie- en inspectie-instellingen:

[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

[encryption] Sectie¶

Deze sectie bevat de sleutel waarmee gevoelige waarden in de repository worden versleuteld. Ze is verplicht — config check meldt de sectie [encryption] als FAILED wanneer de sleutel ontbreekt.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Sectie¶

Deze sectie configureert het loggedrag:

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

[duckdb] Sectie (optioneel)¶

Nieuw in Release 2026.11. Deze sectie bepaalt de resources van de digna Engine, die data binnen digna profileert voor databaseverbindingen met digna Engine als profileringslocatie, en die controles op referentiële integriteit uitvoert tussen datasources op verschillende databaseverbindingen. Zie Profileringslocatie.

De sectie is optioneel. Zonder deze sectie gelden de onderstaande standaardwaarden.

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

mkdir -p /opt/digna/tmp

Stap 2: Configuratie valideren¶

Controleer voordat u de repository initialiseert of config.toml volledig en correct opgebouwd is. Voer in uw digna-installatiemap uit:

./digna config check

Elke sectie wordt afzonderlijk gevalideerd, zodat één fout de toestand van de rest niet verbergt:

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

Los alles op wat als FAILED wordt gemeld en voer het commando opnieuw uit voordat u verdergaat. Een WARNING onder Unknown keys somt sleutels in config.toml op die digna niet leest; ze hebben geen effect, dus verwijder ze of corrigeer de spelling. De volledige lijst met opties staat in de CLI-referentie.

Stap 3: Initialiseer de repository¶

1. Open Terminal
2. Navigeer naar uw digna-installatiemap (waar config.toml en het digna-uitvoerbare bestand zich bevinden)
3. Voer de verbindingscontrole uit:

cd /opt/digna
./digna repo check

Bij een nieuw schema maakt het commando verbinding en meldt het vervolgens dat er nog geen repository is geïnstalleerd:

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

Op dit punt is dat het verwachte resultaat: het bevestigt dat digna PostgreSQL en het schema bereikt. Een verbindings- of authenticatiefout wijst daarentegen op de [repo]-sectie of op de PostgreSQL-installatie.

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

Stap 4: Installeer het repository-schema¶

Voer in dezelfde map uit:

./digna repo upgrade

Dit commando installeert de benodigde tabellen in het repository-schema en eindigt met:

✅ Repo schema 'dignarepo' is up to date.

Stap 5: Maak een admin-gebruiker aan¶

De admin-gebruiker wordt rechtstreeks in het repository-schema aangemaakt, dus de server hoeft nog niet te draaien. Voer in de digna-installatiemap uit:

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

Voorbeeld:

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

Hiermee wordt een gebruiker aangemaakt met het e-mailadres admin@example.com en volledige beheerdersrechten.

Stap 6: Start de digna-server¶

In de digna-installatiemap start u de server met:

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

Parameters: - --address — Server hostname/IP (standaard 127.0.0.1) - --port — Serverpoort (standaard 8000)

Zodra de server draait, toont hij het adres waarop hij luistert:

Server running on http://127.0.0.1:8082

Dashboardconfiguratie¶

Stap 1: Zet het dashboard uit op de webserver¶

Het digna-dashboard leest zijn eigen configuratie uit dashboard/dashboard_config.toml. Dat bestand wordt niet met de installatie meegeleverd — u maakt het aan in de dashboard/-map, naast de dashboardbestanden.

De inhoud ervan wordt beschreven onder Single Sign-On, en daar is het bestand ook nodig: het bevat de aanmeldopties die het dashboard aanbiedt en, voor multi-instance-implementaties, de backend-verbinding.

Kies uw webserver en volg de bijbehorende deployment-stappen.

Deployen naar nginx¶

Als u de sectie nginx-configuratie hebt gevolgd, verwijst het serverblok al naar uw dashboard-map en hoeft er niets te worden gekopieerd.

1. Bevestig het pad
2. Open $(brew --prefix)/etc/nginx/servers/digna.conf

3. Controleer of root naar uw uitgepakte dashboard-map verwijst

4. Zorg dat de map leesbaar is

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

5. Herlaad nginx

   nginx -t
   brew services restart nginx
   

6. Test de installatie

7. Open uw browser
8. Navigeer naar http://localhost:8080 (of uw geconfigureerde URL)
9. U zou de aanmeldpagina van het digna-dashboard moeten zien

Deployen naar Apache httpd¶

1. Kopieer het dashboard naar de document root

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

2. Voeg de rewrite-regels toe

Maak een .htaccess-bestand aan in de uitgerolde map, zodat dashboardroutes een browservernieuwing overleven:

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

Plak het volgende:

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

   sudo apachectl restart
   

2. Open het dashboard

3. Open uw browser
4. Navigeer naar http://localhost/digna
5. U zou de aanmeldpagina van het digna-dashboard moeten zien

digna als achtergrondservice draaien¶

Waarom digna als service draaien?¶

Door de digna-backend als achtergrondservice te draaien, zorgt u ervoor dat deze:

• Automatisch start wanneer de machine opstart
• Op de achtergrond draait zonder een geopend Terminal-venster
• Automatisch opnieuw start als deze crasht
• Beheerd kan worden via launchctl, de servicebeheerder van macOS

Bestanden voor servicebeheer¶

Alle benodigde bestanden bevinden zich in de digna-installatiemap onder: bin/

De volgende shellscripts zijn beschikbaar:

• install_service.sh — Registreert digna bij launchd
• uninstall_service.sh — Deregistreert de service
• start_service.sh — Start de geregistreerde service
• stop_service.sh — Stopt de draaiende service

De scripts uitvoerbaar maken¶

Bij het uitpakken blijft het uitvoerbaar-bit mogelijk niet behouden. Vóór het eerste gebruik:

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

De service installeren¶

1. Open Terminal

2. Navigeer naar de bin-map

   cd /opt/digna/bin
   

3. Voer het installatiescript uit

   sudo ./install_service.sh
   

De digna-server is nu bij launchd geregistreerd met automatische opstart ingeschakeld. De service start niet direct — zie de volgende sectie om deze te starten.

De service starten en stoppen¶

Om de service te starten¶

1. Open Terminal
2. Navigeer naar /opt/digna/bin
3. Voer uit:

   sudo ./start_service.sh
   

Om de service te stoppen¶

1. Open Terminal
2. Navigeer naar /opt/digna/bin
3. Voer uit:

   sudo ./stop_service.sh
   

De service verifiëren¶

Om te bevestigen dat de service geregistreerd is en draait:

sudo launchctl list | grep digna

Een regel die met een proces-ID begint, geeft aan dat de service draait. Een - in de eerste kolom betekent dat de service geregistreerd maar gestopt is.

De service naar een nieuwe map verplaatsen¶

launchd slaat het absolute pad naar het uitvoerbare bestand op, dus het verplaatsen van de installatie vereist dat de service opnieuw wordt geregistreerd:

1. Deïnstalleer de huidige service

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

2. Verplaats de applicatiebestanden

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

3. Installeer de service opnieuw

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

4. Start de service

   sudo ./start_service.sh
   

De service verwijderen¶

1. Stop de draaiende service

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

2. Deïnstalleer de service

   sudo ./uninstall_service.sh
   

De digna-server is nu bij launchd gederegistreerd.

Upgraden naar een nieuwe release¶

Deze sectie beschrijft de upgrade van een installatie van Release 2026.06 naar Release 2026.11. Is uw installatie ouder, lees dan eerst Upgraden vanaf een release vóór 2026.06.

Voordat u gaat upgraden¶

Het aanmaken van een backup van de digna-repository is verplicht

Maak vóór het upgraden een backup van uw repository (PostgreSQL) om gegevensverlies te voorkomen. Een backup zorgt ervoor dat u kunt herstellen als de upgrade onverwachte problemen veroorzaakt.

Om een backup vanuit de Terminal te maken:

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

Het licentiebestand voor Release 2026.11 aanvragen

Release 2026.11 heeft een nieuw license.toml nodig. Vraag het bij het digna-team aan voordat u begint, en houd het gereed voor Stap 7.

Upgraden vanaf een release vóór 2026.06¶

Release 2026.06 bracht drie wijzigingen die nog steeds gelden wanneer u een oudere installatie rechtstreeks naar 2026.11 upgradet:

• Alleen ODBC. digna benadert elke brontechnologie via ODBC. Elke databaseverbinding die nog geen ODBC gebruikt, moet na de upgrade naar ODBC worden omgezet; er is geen automatische conversie. Installeer vooraf de ODBC-stuurprogramma's op de digna-host, zie Het ODBC-stuurprogramma op de digna-host installeren, en houd de eigenschappen van elke verbinding gereed aan de hand van de technologiehandleidingen. De Databricks Legacy-connector bestaat niet meer; zet die verbindingen over naar de Databricks-connector.
• Eén uitvoerbaar bestand. dignabackend en dignacli zijn vervangen door het enkele uitvoerbare bestand digna, dat de backend en de CLI combineert.
• config.toml. De sectie [encryption] is verplicht, en DIGNA_APP_HOST en DIGNA_APP_PORT worden niet meer gelezen: de server haalt zijn adres en poort uit digna serve. Vergelijk uw bestand met Backendconfiguratie.

De onderstaande stappen geven aan waar een oudere installatie iets anders nodig heeft. De repository-upgrade in Stap 8 brengt een repository van elke eerdere release rechtstreeks naar 2026.11.

Upgradeproces¶

Stap 1: Stop de digna-service¶

Als digna als achtergrondservice draait, stop deze dan eerst:

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

Als digna op de voorgrond draait, druk dan op Ctrl+C in het bijbehorende Terminal-venster.

Stap 2: Huidige installatie veiligstellen¶

Hernoem in uw digna-installatiemap het uitvoerbare bestand en de dashboardmap van uw huidige installatie, zodat de nieuwe release ernaast kan worden uitgerold:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Bewaar digna_old totdat u de upgrade hebt geverifieerd, en dashboard_old totdat u uw configuratiebestanden eruit hebt teruggezet (zie Stap 4). Daarna kunt u beide verwijderen.

Stap 3: Pak de nieuwe versie uit en deploy¶

1. Pak het nieuwe digna-installatie-ZIP-bestand uit
2. Kopieer het nieuwe digna-uitvoerbare bestand en de dashboard-map naar uw installatiemap
3. Herstel het uitvoerbaar-bit en verwijder zo nodig het quarantaine-attribuut:

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

Stap 4: Herstel uw configuratiebestanden¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 vereist geen wijziging in config.toml: een bestand dat met Release 2026.06 werkt, blijft werken. Twee wijzigingen zijn optioneel:

• Voeg een [duckdb]-sectie toe als databaseverbindingen de digna Engine moeten gebruiken en de standaardwaarden ervan niet bij uw host passen.
• Laat de [app]-sectie weg als een reverse proxy het dashboard en de backend onder één origin serveert.

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

Stap 5: Herlaad de webserver¶

Het dashboard bestaat uit statische bestanden, dus uw webserver — en de browser — kan nog steeds de vorige versie serveren. Herlaad of herstart de webserver die de dashboard-map host, en herlaad de pagina daarna met een harde vernieuwing (Cmd+Shift+R).

Stap 6: Configuratie valideren¶

Controleer of config.toml volledig is voordat u de repository aanraakt:

./digna config check

Elke sectie moet OK melden. Los alles op wat als FAILED wordt gemeld, verwijder de sleutels die onder Unknown keys staan, en voer het commando opnieuw uit voordat u verdergaat.

Stap 7: Vervang het licentiebestand¶

Een licentiebestand gaat normaal gesproken mee van de ene release naar de volgende. Release 2026.11 is een uitzondering: deze release voegt twee gelicentieerde modules toe, digna Data Reconciliation en digna Agentic, en een licentie die vóór 2026.11 is uitgegeven, bevat ze niet. Kopieer het license.toml dat het digna-team voor Release 2026.11 heeft geleverd naar de installatiemap, ter vervanging van het oude:

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

./digna license check

Stap 8: Upgrade het repository-schema¶

Voer in uw digna-installatiemap uit:

cd /opt/digna
./digna repo upgrade

Release 2026.11 beheert het repository-schema met geversioneerde migraties. De eerste upgrade vanaf een eerdere release brengt het schema naar de laatste versie van het vorige mechanisme, legt dat vast als startpunt en past daarna de migraties van Release 2026.11 toe. De upgrade eindigt met:

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

Alle bestaande gegevens blijven behouden. Voer op elk moment ./digna repo check uit om de toestand van de repository te zien: het commando toont de laatst toegepaste migratie en eventuele openstaande migraties.

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

Stap 9: Herstart services¶

Als digna als achtergrondservice draait:

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

Als u de server handmatig draait, start deze dan opnieuw:

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

Als u nginx of Apache gebruikt, herstart dan de betreffende webserver:

brew services restart nginx

sudo apachectl restart

Stap 10: Verifieer de upgrade¶

1. Controleer de release van het nieuwe uitvoerbare bestand:

   ./digna version
   

   De eerste regel moet Release: 2026.11 luiden.

2. Ga naar het digna-dashboard en controleer of de interface correct laadt.

3. Controleer de serveruitvoer en de bestanden in de map logs op fouten.
4. Test uw databaseverbindingen — zie Een verbinding testen. Zet na een upgrade vanaf een release vóór 2026.06 eerst elke verbinding die nog geen ODBC gebruikte om naar ODBC.

Om met de nieuwe modules te beginnen, zie digna Data Reconciliation, Een AI-agent verbinden voor de digna MCP Server, en Profileringslocatie voor de digna Engine.