Ga naar inhoud

Windows Installatiehandleiding voor digna Release 2026.06

Release: 2026.06

Laatst bijgewerkt: 30 augustus 2026


Inhoudsopgave

  1. Inleiding
  2. Systeemeisen
  3. Voorbereiding vóór installatie
  4. PostgreSQL Server Setup
  5. Webserverconfiguratie
  6. Initiële installatie
  7. Backendconfiguratie
  8. Dashboardconfiguratie
  9. digna als Windows-service uitvoeren
  10. Upgraden naar een nieuwe release

Inleiding

Over digna

digna is een uitgebreid AI-gestuurd platform ontworpen om het beheer van datakwaliteit te optimaliseren in verschillende dataomgevingen zoals warehouses, lakes en lakehouses. Ontworpen voor hoge schaalbaarheid en aanpasbaarheid, lost digna moderne dataproblemen op via automatisering, realtime monitoring en anomaliedetectie.

digna bestaat uit twee hoofcomponenten:

  • 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 datakwaliteitsmetriek te visualiseren.

Wat is nieuw in Release 2026.06

Deze release brengt data-observability mogelijkheden direct in je code, waarmee ontwikkelaars datakwaliteit bij de bron kunnen monitoren. Zie de release notes voor volledige details.

Op zoek naar macOS of Linux?

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


Systeemeisen

Voordat je met de installatie begint, zorg dat je systeem voldoet aan de volgende minimale vereisten:

Vereiste Specificatie
Besturingssysteem Windows Server of Windows 10/11
Geheugen (Minimale setup) 16 GB RAM
Schijfruimte 10 GB beschikbare opslag
Database PostgreSQL Server 12 of hoger
Webserver IIS, Apache Tomcat of equivalent

Opties voor database-installatie

Als PostgreSQL al geïnstalleerd is: Je kunt een nieuwe database voor digna toevoegen aan je bestaande PostgreSQL Server.

Als je PostgreSQL op dezelfde machine als digna installeert:

Aanbevolen specificaties

  • Geheugen: 32 GB RAM (in plaats van 16 GB)
  • Schijfruimte: 50 GB beschikbare opslag (in plaats van 10 GB)

Deze hogere specificaties accommoderen zowel digna als de PostgreSQL-database die gelijktijdig draaien.


Voorbereiding vóór installatie

Voordat je digna installeert, zorg dat twee belangrijke vereisten aanwezig zijn:

  1. PostgreSQL Server – voor het opslaan van berekende metriek en prestatiegegevens
  2. 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.


PostgreSQL Server Setup

Als je al PostgreSQL hebt

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

PostgreSQL installeren

Volg deze stappen om PostgreSQL op Windows te installeren:

Stap 1: Download PostgreSQL

  1. Bezoek de PostgreSQL-downloadpagina
  2. Selecteer Windows
  3. Download de meest recente installer

Stap 2: Start de installer

  1. Dubbelklik op het gedownloade installerbestand
  2. Volg de aanwijzingen in de setup-wizard

Stap 3: Kies installatiefolder

Selecteer de map waar PostgreSQL wordt geïnstalleerd. De standaardlocatie is meestal geschikt.

Stap 4: Selecteer componenten

Voor een standaardopstelling kun je de standaardcomponentopties behouden.

Stap 5: Stel het PostgreSQL superuser-wachtwoord in

Voer een wachtwoord in en bevestig dit voor de PostgreSQL superuser (postgres). Bewaar dit wachtwoord veilig — je hebt het later nodig.

Stap 6: Configureer poortnummer

De standaard PostgreSQL-poort is 5432. Je kunt de standaard gebruiken of een andere poort opgeven indien nodig.

Tip

Als poort 5432 al in gebruik is, kies een alternatieve poort en noteer deze voor latere configuratie.

Stap 7: Kies locale

Selecteer de locale voor je database. De standaardinstelling is meestal geschikt voor de meeste installaties.

Stap 8: Voltooi de installatie

Klik Volgende door de resterende stappen en klik vervolgens op Voltooien.

Stap 9: Verifieer installatie

Open Opdrachtprompt en controleer of PostgreSQL is geïnstalleerd:

psql --version

Je zou de PostgreSQL-versie moeten zien als de installatie succesvol was.


Webserverconfiguratie

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

Je hoeft maar één van deze servers te installeren en te configureren.

IIS Setup

Overzicht

Internet Information Services (IIS) is Microsofts webserver voor het hosten van websites en webapplicaties.

IIS inschakelen

  1. Open Configuratiescherm
  2. Druk Win + R
  3. Typ control en druk op Enter

  4. Navigeer naar Windows-onderdelen

  5. Klik Programma's
  6. Selecteer Windows-onderdelen in- of uitschakelen

  7. Schakel Internet Information Services in

  8. Scroll naar beneden en vind Internet Information Services (IIS)
  9. Vink het selectievakje aan om het in te schakelen
  10. Klik op het + om uit te vouwen en controleer of de volgende subcomponenten zijn geselecteerd:

    • Web Management Tools
    • World Wide Web Services
  11. Klik OK om de wijzigingen toe te passen

  12. Verifieer IIS-installatie

  13. Open je browser
  14. Navigeer naar http://localhost
  15. Je zou de IIS-welkomstpagina moeten zien

Verplicht: URL Rewrite-module

IIS vereist de URL Rewrite-component. Download en installeer deze vanaf de officiële Microsoft-pagina.

Verplicht: MIME-type voor Markdown-bestanden

Om ervoor te zorgen dat Markdown-bestanden (.md) correct door IIS worden geserveerd:

  1. Open IIS Manager (druk Win + R, typ inetmgr, druk Enter)
  2. Navigeer naar Uw Site > MIME Types
  3. Klik Toevoegen...
  4. Configureer:
  5. Bestandsextensie: .md
  6. MIME-type: text/markdown

Belangrijk

Zonder deze instelling kunnen .md-bestanden mogelijk niet correct worden geserveerd.


Apache Tomcat Setup

Overzicht

Apache Tomcat is een open-source Java servlet-container en webserver.

Installatie

  1. Download Apache Tomcat
  2. Bezoek Apache Tomcat Downloads
  3. Download de Windows ZIP-distributie

  4. Pak het archief uit

  5. Pak het ZIP-bestand uit naar een map op je systeem
  6. Voorbeeld: C:\Program Files\Apache Tomcat

  7. Verifieer dat Tomcat draait

  8. Open je browser
  9. Navigeer naar http://localhost:8080
  10. Je zou de Apache Tomcat-welkomstpagina moeten zien

Tip

Apache Tomcat start normaal gesproken automatisch na installatie. Als dat niet het geval is, navigeer dan naar de bin-map en voer startup.bat uit.


Initiële installatie

Stap 1: Richt de digna-repository in

De digna-repository slaat alle door digna berekende metriek op. Het fungeert als de centrale database voor analytische- en prestatiegegevens.

Maak repository-schema en gebruiker aan

Open je PostgreSQL-client (pgAdmin, psql 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;

Beste werkwijze

Gebruik sterke, complexe wachtwoorden voor databasegebruikers. Vermijd gemakkelijk te raden inloggegevens.


Stap 2: Pak het digna-installatiepakket uit

  1. Zoek het aan jou geleverde digna-installatie-ZIP-bestand
  2. Pak het uit naar de gewenste installatieplek
  3. Na het uitpakken zou je de volgende items moeten zien:
  4. dashboard/ — Webdashboard-interface
  5. digna — Hoofduitvoerbaar bestand (backend + CLI gecombineerd)

Het configuratie- en licentiebestand zitten niet in het pakket

Noch config.toml noch dashboard/dashboard_config.toml wordt met de installatie meegeleverd — u maakt beide zelf aan, in Backendconfiguratie en Dashboardconfiguratie. Ook license.toml wordt niet meegeleverd; digna levert het afzonderlijk, zoals Stap 3 beschrijft.

Stap 3: Installeer het licentiebestand

Belangrijk

Het licentiebestand is niet opgenomen in het installatiepakket en wordt afzonderlijk door digna geleverd.

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

Waarom dit belangrijk is: Het licentiebestand bevat je klantgegevens, vervaldatum van de licentie en digitale handtekening. Wijzig dit bestand niet — elke wijziging ongeldigt de licentie.

Mapstructuur na installatie:

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

Backendconfiguratie

Stap 1: Maak en bewerk het configuratiebestand

Het bestand config_template.toml wordt meegeleverd in je digna-installatiemap. Je hoeft het alleen te hernoemen naar config.toml.

Locatie: digna_installation/config.toml

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

[app] Sectie

Deze sectie configureert de digna-backend applicatie-instellingen:

[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 = ["*"]
Parameter Waarde Opmerkingen
digna_APP_CORS_ALLOW_ORIGINS Frontend-URL Als het dashboard op een andere server staat, voeg dan de URL toe
digna_APP_CORS_ALLOW_CREDENTIALS true Vereist voor CORS met credentials
digna_APP_CORS_ALLOW_METHODS ["*"] Sta alle HTTP-methodes toe
digna_APP_CORS_ALLOW_HEADERS ["*"] Sta alle headers toe

[repo] Sectie

Deze sectie configureert de verbinding naar 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!"
Parameter Waarde Opmerkingen
digna_REPO_HOST localhost of IP PostgreSQL-server hostnaam/IP
digna_REPO_PORT 5432 (standaard) PostgreSQL-poort
digna_REPO_DB postgres Databasenaam
digna_REPO_SCHEMA dignarepo Eerder aangemaakt schema
digna_REPO_USER digna_user Gebruiker aangemaakt in PostgreSQL-setup
digna_REPO_PASSWORD Je wachtwoord Wachtwoord ingesteld tijdens schema-creatie

[base] Sectie

Deze sectie bevat beveiligings- en cookie-instellingen:

[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"
Parameter Waarde Opmerkingen
DIGNA_FERNET_KEY Encryptiesleutel Gebruikt om tokens en cookies te versleutelen (standaard meegeleverd)
digna_COOKIE_DOMAIN localhost Komt overeen met je frontend-domein
digna_COOKIE_SECURE false (lokaal) / true (productie) Gebruik true voor HTTPS-verbindingen
digna_COOKIE_HTTPONLY true Altijd ingeschakeld voor veiligheid
digna_COOKIE_SAME_SITE lax Voorkomt CSRF-aanvallen
digna_TOKEN_EXPIRES_IN 86400 (24 uur) Sessie-timeout in seconden
digna_MAX_WORKERS Aantal CPU-cores - 1 Aantal parallelle inspectietaken
DIGNA_SCHEDULER_MAX_DELAY 100 Maximale vertraging, in seconden, die de scheduler mag toevoegen voordat een openstaande taak start
DIGNA_CLEANUP_TIME "12:00" Tijdstip (24-uursnotatie HH:MM) waarop de dagelijkse opschoning begint

[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='
Parameter Waarde Opmerkingen
DIGNA_ENCRYPTION_KEY Base64-gecodeerde sleutel Versleutelt gevoelige waarden die in de digna-repository zijn opgeslagen

Bescherm config.toml

Deze sleutel is een vaste waarde, identiek in alle digna-installaties, en het is de sleutel die de gevoelige waarden in uw repository ontsleutelt. Beperk config.toml tot het account waaronder digna draait, houd het bestand buiten versiebeheer en gedeelde schijven, en sluit het uit van elke back-up die minder veilig wordt bewaard dan de repository zelf.

[logging] Sectie

Deze sectie configureert het loggedrag:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
Parameter Waarde Opmerkingen
digna_LOGGING_MODE INFO of DEBUG INFO voor productie, DEBUG voor probleemoplossing
digna_LOGGING_BACKUP_COUNT 10 Aantal dagelijkse logbackups om te bewaren

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

Overall: OK

Los alles op wat als FAILED wordt gemeld en voer het commando opnieuw uit voordat u verdergaat. De volledige lijst met opties staat in de CLI-referentie.

Stap 3: Initialiseer de repository

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

Je zou een bevestiging moeten zien dat de verbinding tot stand is gebracht (de repository zelf is nog niet geïnitialiseerd).

Stap 4: Installeer het repository-schema

Voer in dezelfde map uit:

digna repo install

Dit commando installeert de benodigde tabellen en het schema in je PostgreSQL-database.

Stap 5: Maak een admin-gebruiker aan

  1. Open een nieuw Opdrachtprompt-venster
  2. Navigeer naar je digna-installatiemap
  3. Voer het volgende commando uit om een admin-gebruiker aan te maken:
digna user add <email> <password> "<display_name>" --admin

Voorbeeld:

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

Dit maakt een gebruiker aan met volledige beheerdersrechten.

Beste werkwijze

Gebruik een sterk wachtwoord met een mix van hoofdletters, kleine letters, cijfers en speciale tekens.


Stap 6: Start de digna-server

Start in de digna-installatiemap de server met:

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

Parameters: - --address — Server hostname/IP - --port — Serverpoort

Je zou opstartberichten moeten zien die bevestigen dat de server draait:

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

De server houdt de terminal bezet

serve draait op de voorgrond en blijft draaien totdat u het stopt met Ctrl+C. Laat het draaien terwijl u de installatie afrondt; zie voor automatisch starten bij het opstarten digna als Windows-service uitvoeren.

Dashboardconfiguratie

Stap 1: Zet het dashboard uit naar 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-deployments, de backendverbinding.

Kies je webserver en volg de bijbehorende deploymentstappen.

Deployen naar IIS

  1. Open IIS Manager
  2. Druk Win + R, typ inetmgr, druk Enter

  3. Maak een nieuwe website

  4. Klik met de rechtermuisknop op Sites in het linkerpaneel
  5. Selecteer Website toevoegen...

  6. Configureer de website

  7. Sitenaam: Voer een naam in (bijv. "dignaDashboard")
  8. Fysiek pad: Klik Bladeren en selecteer je dashboard-map
  9. Binding: Stel IP-adres en poort in (standaard poort 80 voor HTTP, 443 voor HTTPS)

  10. Start de website

  11. Klik OK om de site te maken
  12. Klik met de rechtermuisknop op de nieuwe site en selecteer Start

  13. Test de installatie

  14. Open je browser
  15. Navigeer naar http://localhost (of je geconfigureerde URL)
  16. Je zou de inlogpagina van het digna-dashboard moeten zien

Deployen naar Apache Tomcat

  1. Kopieer Dashboard naar Tomcat
  2. Kopieer de dashboard-map naar de webapps-directory van Tomcat
  3. Hernoem indien nodig (bijv. naar digna)
  4. Voorbeeld: C:\Program Files\Apache Tomcat\webapps\digna

  5. Verifieer deployment

  6. Ververs of herlaad de Tomcat-beheerpagina (http://localhost:8080)
  7. Je zou "digna" (of de door jou gekozen naam) moeten zien in de lijst met gedeployde applicaties

  8. Toegang tot het dashboard

  9. Open je browser
  10. Navigeer naar http://localhost:8080/digna
  11. Je zou de inlogpagina van het digna-dashboard moeten zien

digna als Windows-service uitvoeren

Waarom een Windows-service gebruiken?

Het draaien van de digna-backend als een Windows-service zorgt ervoor dat deze: - Automatisch start wanneer de server opstart - Op de achtergrond draait zonder een open Opdrachtprompt - Automatisch opnieuw start als deze crasht - Beheerd kan worden via Windows Services

De windows-commando's

De service wordt beheerd door het digna-uitvoerbare bestand zelf, via de subcommando's van digna windows. Er zijn geen batchbestanden meer om uit te voeren.

Commando Doel
digna windows install Registreert digna als een Windows-service
digna windows start Start de geregistreerde service
digna windows stop Stopt de draaiende service
digna windows uninstall Deregistreert de service

Beheerdersrechten vereist

Alle vier de commando's moeten worden uitgevoerd vanuit een Opdrachtprompt die als Administrator is geopend.

Elk commando accepteert --name om een service aan te spreken die onder een andere dan de standaardnaam is geregistreerd. De volledige lijst met opties staat in de CLI-referentie.

De service installeren

  1. Open Opdrachtprompt als Administrator
  2. Klik met de rechtermuisknop op Opdrachtprompt
  3. Kies "Als administrator uitvoeren"

  4. Navigeer naar uw digna-installatiemap

    cd C:\path\to\digna
    

  5. Registreer de service

    digna windows install
    

Geef adres en poort op, tenzij de standaardwaarden volstaan

install legt het adres en de poort vast in de serviceregistratie, en de service bindt zich precies aan wat is vastgelegd. De standaardwaarden zijn 127.0.0.1 en 8000, die alleen verbindingen van de machine zelf accepteren. Een dashboard op een andere host kan die niet bereiken, dus geef het adres op waarop de backend moet luisteren:

digna windows install --address 0.0.0.0 --port 8082

Deze waarden worden niet uit config.toml gelezen. Om ze later te wijzigen, verwijdert u de service en installeert u deze opnieuw met de nieuwe waarden.

De service wordt geregistreerd met automatische opstart, zodat deze met Windows meestart. De service start niet direct — zie de volgende sectie.

Installatieopties

Optie Standaard Doel
--name digna Naam waaronder de service wordt geregistreerd
--display-name digna Naam die in services.msc wordt getoond
--description digna data quality backend Beschrijving die in services.msc wordt getoond
--address 127.0.0.1 Adres waaraan de service zijn API bindt
--port 8000 Poort waaraan de service zijn API bindt
--working-dir de map van het digna-uitvoerbare bestand Map met config.toml en license.toml, die de service als werkmap gebruikt
--start-type auto auto start met Windows, manual start alleen op verzoek, disabled registreert de service maar weigert deze te starten
--account LocalSystem Account waaronder de service draait, bijv. DOMAIN\user of .\user
--password Wachtwoord van --account

Draaien onder een domeinaccount

LocalSystem heeft geen netwerkidentiteit, dus Windows-verificatie bij SQL Server en elke toegang tot een netwerkshare mislukken. Installeer met --account en --password wanneer de service als een specifieke gebruiker bij resources moet kunnen.

De service starten en stoppen

Om de service te starten

digna windows start

Om de service te stoppen

digna windows stop

Tip

Stop de service altijd voordat je applicatiebestanden bijwerkt.

De service naar een nieuwe map verplaatsen

Als je de digna-installatie wilt verplaatsen:

  1. Stop en deregistreer de huidige service

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

  2. Verplaats de applicatiebestanden

  3. Verplaats de volledige digna-installatiemap naar de nieuwe locatie

  4. Registreer de service opnieuw vanaf de nieuwe locatie

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

Herhaal alle waarden voor --address, --port of --account die u de eerste keer hebt gebruikt — de vorige registratie bestaat niet meer.

  1. Start de service
    digna windows start
    

De service verwijderen

  1. Stop de draaiende service

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

  2. Deregistreer de service

    digna windows uninstall
    

De digna-server is nu afgehandeld als Windows-service.


Upgraden naar een nieuwe release

Voordat je upgrade

Controleer eerst alle databaseverbindingen

Vanaf Release 2026.06 benadert digna elke brontechnologie via ODBC. Eerdere releases boden de keuze tussen een stuurprogramma per technologie en ODBC, te kiezen met de schakelaar Use ODBC. Het digna-team heeft besloten alleen op ODBC te bouwen, omdat één standaardinterface meer biedt dan een verzameling maatwerkstuurprogramma's:

  • Authenticatie — authenticatie maakt deel uit van ODBC, dus een verbinding kan alles gebruiken wat het stuurprogramma ondersteunt: wachtwoorden, tokens en PAT's, Kerberos en Active Directory, MFA en single sign-on via de browser, cloudidentiteiten, clientcertificaten en TLS. Nieuwe methoden komen met een update van het stuurprogramma, in plaats van te wachten op een digna-release.
  • Stuurprogramma's die door de databaseleveranciers worden onderhouden — het stuurprogramma van de leverancier volgt nieuwe serverversies en beveiligingsfixes, en u kunt het op uw eigen moment bijwerken, los van digna.
  • Eén manier om alles te configureren — elke technologie is een lijst met sleutel-waardeparen, met dezelfde interface, dezelfde versleuteling van gevoelige waarden en dezelfde probleemoplossing, in plaats van een andere set velden per bron.
  • Afstemming en bereik — stuurprogramma-opties zoals time-outs, TLS-instellingen, proxy's en fetch-groottes zijn voor elke bron beschikbaar, en elke technologie met een conform ODBC-stuurprogramma kan worden aangesloten, ook technologieën waarvoor digna geen aparte handleiding publiceert.

In de praktijk betekent dit dat de schakelaar Use ODBC en de afzonderlijke velden host, poort, database, gebruiker en wachtwoord niet meer bestaan. Elke verbinding die nog geen ODBC gebruikt, moet naar ODBC worden omgezet — er is geen automatische conversie, plan dit dus vóór de upgrade:

  1. Loop elke in uw installatie gedefinieerde databaseverbinding na en noteer welke nog geen ODBC gebruiken — elk daarvan moet opnieuw worden geconfigureerd.
  2. Installeer het bijbehorende ODBC-stuurprogramma op de digna-host — verbindingen worden geopend vanaf de server waarop de digna-backend draait, niet vanuit de browser. Zie Het ODBC-stuurprogramma op de digna-host installeren.
  3. Zorg dat u de ODBC-eigenschappen van elke betrokken verbinding bij de hand hebt. De technologiehandleidingen geven per bron een beproefde set eigenschappen.

Zet na de upgrade elke betrokken verbinding om naar ODBC en test ze vanuit het dashboard — zie Een databaseverbinding maken en Een verbinding testen.

Databricks Legacy-verbindingen

De Databricks Legacy-connector is in deze release verwijderd. Migreer die verbindingen naar de Databricks-connector.

Het maken van een digna-repositorybackup is verplicht

Maak vóór het upgraden van digna een back-up van je repository (PostgreSQL) om gegevensverlies te voorkomen. Een back-up zorgt dat je kunt herstellen als de upgrade onverwachte problemen tegenkomt.

Upgradeproces

Stap 1: Stop en deregistreer de oude service

Als digna als Windows-service draait, stop deze dan met de batchbestanden van uw huidige installatie — de digna windows-commando's horen bij de nieuwe release en zijn nog niet beschikbaar:

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

Deregistreer de service daarna, opnieuw met het oude batchbestand. De registratie verwijst naar het oude uitvoerbare bestand en de bijbehorende scripts, die beide door deze upgrade worden vervangen, dus ze kan niet opnieuw worden gebruikt:

uninstall_service.bat

Deregistreer voordat u iets hernoemt

uninstall_service.bat staat in de bin-map die u zo meteen gaat hernoemen, en het is het enige dat de registratie kan verwijderen die het heeft aangemaakt. Voer het uit terwijl de oude installatie nog op zijn plaats staat. Als de map al is hernoemd, zet de naam dan terug, deregistreer, en ga daarna verder.

Noteer het account waaronder de service draaide, en het adres en de poort waarop deze bereikbaar was — u hebt ze nodig in Stap 9.

Stap 2: Huidige installatie veiligstellen

Hernoem in uw digna-installatiemap de mappen van uw huidige installatie, zodat de nieuwe release ernaast kan worden uitgerold:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old
# Rename the folder containing dignacli
ren dignacli dignacli_old
# Rename dashboard
ren dashboard dashboard_old

dignabackend en dignacli worden niet meer gebruikt

Vanaf Release 2026.06 worden dignabackend en dignacli vervangen door het enkele uitvoerbare bestand digna, dat backend en CLI combineert. Bewaar dignabackend_old en dignacli_old alleen totdat u de upgrade hebt geverifieerd — daarna kunt u beide mappen verwijderen. Bewaar dashboard_old totdat u uw configuratiebestanden eruit hebt teruggezet (zie stap 4). Ook de bin-map verdwijnt: de batchbestanden daarin stuurden de oude service aan en 2026.06 levert ze niet meer mee, dus zodra de service in Stap 1 is gederegistreerd, doen ze niets anders dan misleiden.

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 je installatiemap

Belangrijk

Noch config.toml noch dashboard/dashboard_config.toml wordt ooit in het installatie-ZIP opgenomen — het digna-team levert geen van beide bestanden mee. Uw bestaande configuratie blijft bij de upgrade dus onaangeroerd, en de kopieën in de hernoemde *_old-mappen zijn de enige die u hebt.

Stap 4: Herstel je configuratiebestanden

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

Release 2026.06 wijzigt config.toml

Drie instellingen zijn nieuw en verplicht, twee worden niet meer gebruikt. Een config.toml die uit een eerdere release is overgenomen, bevat de nieuwe instellingen niet, en digna start niet zolang ze ontbreken. Voeg het volgende toe aan uw bestaande config.toml:

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Voeg de twee [base]-sleutels toe aan uw bestaande [base]-sectie en voeg [encryption] toe als nieuwe sectie. Verwijder daarna de twee instellingen die niet meer worden gebruikt, digna_APP_HOST en digna_APP_PORT, uit [app] — de server haalt zijn adres en poort nu uit digna serve.

Wat elke instelling doet, staat in Backend-configuratie.

Eenmalige aanmelding: de indeling van [oidc_clients] is gewijzigd

Release 2026.06 vervangt de array van tabellen door één tabel per provider, genoemd naar de providersleutel. DIGNA_OIDC_KEY verdwijnt — de sleutel maakt nu deel uit van de sectiekop.

Voor:

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

Na:

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

Herhaal de sectie voor elke provider en houd elke sleutel gelijk aan de key in dashboard_config.toml. digna config check meldt oidc_clients als FAILED zolang de oude vorm nog aanwezig is. Alleen installaties die eenmalige aanmelding gebruiken zijn betroffen.

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 (Ctrl+F5).

Stap 6: Configuratie valideren

Controleer of de bijgewerkte 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 en voer het commando opnieuw uit voordat u verdergaat.

Stap 7: Vervang het licentiebestand

Elke release krijgt een eigen licentie. Kopieer het license.toml dat het digna-team voor deze release heeft geleverd naar de installatiemap, ter vervanging van het oude:

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

Behoud de vorige licentie niet

Een license.toml die voor een eerdere release is uitgegeven, dekt deze release niet, en elk commando dat de licentie controleert — user, inspection, repo — breekt af voordat het de repository aanraakt wanneer de controle mislukt. Controleer de licentie voordat u verdergaat:

digna license check

Stap 8: Upgrade het repository-schema

Navigeer naar je digna-installatiemap en voer uit:

digna repo upgrade

Dit werkt het PostgreSQL-schema bij naar de nieuwste versie terwijl alle bestaande data behouden blijven.

Stap 9: Registreer en start de service

De oude registratie is in Stap 1 verwijderd, dus de service wordt opnieuw geregistreerd — dit keer met het digna-uitvoerbare bestand, dat geen batchbestanden heeft:

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

Geef --address en --port de waarden waarop de oude service bereikbaar was, tenzij u de nieuwe standaardwaarden 127.0.0.1 en 8000 wilt; ze worden in de registratie vastgelegd en niet meer uit config.toml gelezen. Voeg --account en --password toe als de oude service onder een domeinaccount draaide. Zie digna als Windows-service uitvoeren voor de volledige lijst met opties.

Als je handmatig draait, start de server opnieuw:

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

Als je IIS of Tomcat gebruikt, herstart dan de betreffende webserver.

Stap 10: Verifieer de upgrade

  1. Open het digna-dashboard
  2. Controleer of de interface correct laadt
  3. Controleer de serverlogs op eventuele fouten
  4. Zet elke verbinding die nog geen ODBC gebruikte om naar ODBC en test daarna alle verbindingen — zie Een verbinding testen