Ga naar inhoud

Windows Installatiehandleiding voor digna Release 2026.11

Release: 2026.11

Laatst bijgewerkt: 7 november 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.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 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

digna Engine

Databaseverbindingen die de digna Engine als profileringslocatie gebruiken, worden op de digna-host zelf geprofileerd. Plan daarvoor extra geheugen en schijfruimte in, zie de [duckdb]-sectie.

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 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
Parameter Waarde Opmerkingen
DIGNA_APP_CORS_ALLOW_ORIGINS Dashboard-URL's De URL's van waaruit het dashboard wordt geserveerd. Browserverzoeken van elke andere origin worden geweigerd
DIGNA_APP_CORS_ALLOW_CREDENTIALS true Vereist, zodat de browser bij elk verzoek de sessiecookie meestuurt

De [app]-sectie is optioneel

Vanaf Release 2026.11 mogen beide sleutels, en de hele [app]-sectie, worden weggelaten. Dat is de juiste opzet wanneer een reverse proxy het dashboard en de backend onder één origin serveert: de browser doet dan geen cross-origin-verzoeken, en standaard wordt er geen enkele toegestaan.

[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!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16
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
DIGNA_REPO_SSLMODE prefer (standaard) Optioneel. PostgreSQL SSL-modus: disable, allow, prefer, require, verify-ca of verify-full
DIGNA_REPO_NUM_CONNS 16 (standaard) Optioneel. Aantal verbindingen dat digna open houdt naar de repository

[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
Parameter Waarde Opmerkingen
DIGNA_FERNET_KEY Hierboven getoonde waarde Sleutel van de versleuteling die eerdere releases gebruikten. Deze moet aanwezig zijn; behoud de getoonde waarde
DIGNA_COOKIE_DOMAIN localhost Host waaronder het dashboard bereikbaar is. "" stelt geen domein in; dat is juist achter een proxy die het dashboard en de backend onder één origin serveert
DIGNA_COOKIE_SECURE false (HTTP) / true (HTTPS) Moet true zijn zodra digna via HTTPS wordt geserveerd
DIGNA_COOKIE_HTTPONLY true Houdt de sessiecookie buiten bereik van scripts
DIGNA_TOKEN_EXPIRES_IN 86400 (24 uur) Sessie-timeout in seconden
DIGNA_MAX_WORKERS Aantal CPU-cores - 1 Aantal inspecties dat tegelijk mag draaien
DIGNA_FRONTEND_BASEURL Dashboard-URL Vereist. Wordt gebruikt voor de links in meldingsberichten en moet dus een URL zijn die de ontvangers kunnen openen
DIGNA_SOURCE_QUERY_TIMEOUT_SEC 3600 (standaard) Optioneel. Aantal seconden dat één query op een brondatabase mag draaien voordat deze wordt afgebroken; 0 schakelt de time-out uit
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC 30 (standaard) Optioneel. Aantal seconden dat wordt gewacht op een verbinding met een brondatabase; 0 wacht onbeperkt

[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_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30
Parameter Waarde Opmerkingen
DIGNA_LOGGING_MODE INFO of DEBUG INFO voor productie, DEBUG voor probleemoplossing. TRACE, WARN en ERROR worden ook geaccepteerd
DIGNA_LOGGING_DIR logs (standaard) Optioneel. Map voor de roterende logbestanden, relatief ten opzichte van de werkmap
DIGNA_LOGGING_MAX_FILES 30 (standaard) Optioneel. Aantal geroteerde logbestanden dat wordt bewaard

Behoud de logmap wanneer digna als service draait

Een Windows-service heeft geen console, dus de logbestanden zijn de enige registratie van wat de service doet. Stel DIGNA_LOGGING_DIR niet in op een lege string; daarmee worden de logbestanden uitgeschakeld.

[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 = "C:\\path\\to\\digna\\tmp"
Parameter Waarde Opmerkingen
DIGNA_DUCKDB_MEMORY_LIMIT_MB 1024 (standaard) Geheugen, in MB, dat één run van de digna Engine mag gebruiken. Er kunnen tot DIGNA_MAX_WORKERS runs tegelijk actief zijn
DIGNA_DUCKDB_TEMP_DIRECTORY Standaard: de tijdelijke map van het account waaronder digna draait (%TEMP%) Map voor tijdelijke bestanden wanneer de data niet in het geheugen past

De digna Engine dimensioneren

Reken op maximaal DIGNA_MAX_WORKERS × DIGNA_DUCKDB_MEMORY_LIMIT_MB aan geheugen op de digna-host, bovenop wat digna zelf gebruikt, en op voldoende vrije schijfruimte in de tijdelijke map voor de grootste geïnspecteerde datum van de datasources die de digna Engine gebruiken. Laat DIGNA_DUCKDB_TEMP_DIRECTORY verwijzen naar een schijf met die ruimte, beschrijfbaar voor het account waaronder digna draait:

mkdir C:\path\to\digna\tmp

U hebt deze sectie alleen nodig als ten minste één databaseverbinding de digna Engine gebruikt, of als een controle op referentiële integriteit datasources op verschillende verbindingen vergelijkt.


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

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.

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.

repo upgrade installeert en upgradet

Vanaf Release 2026.11 installeert repo upgrade een nieuwe repository en upgradet het een bestaande. repo install werkt nog steeds als andere naam voor hetzelfde commando.

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

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

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

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.

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

Open een Opdrachtprompt als Administrator en stop de service met het digna-uitvoerbare bestand van uw huidige installatie:

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

De service blijft geregistreerd. Het nieuwe uitvoerbare bestand neemt in dezelfde map de plaats in van het oude, zodat de registratie naar het juiste bestand blijft verwijzen.

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

Upgraden vanaf een release vóór 2026.06

Releases vóór 2026.06 registreerden de service met batchbestanden. Stop en deregistreer de service met de batchbestanden van uw huidige installatie, voordat u in Stap 2 iets hernoemt:

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

Noteer het account waaronder de service draaide, en het adres en de poort waarop deze bereikbaar was. U registreert de service in Stap 9 opnieuw.

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 C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

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

Upgraden vanaf een release vóór 2026.06

Hernoem in plaats van het uitvoerbare bestand de mappen dignabackend en dignacli: ren dignabackend dignabackend_old en ren dignacli dignacli_old. Release 2026.11 gebruikt geen van beide mappen, en ook de bin-map met batchbestanden niet.

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

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

Instellingen die digna niet leest

Eerdere versies van deze handleiding toonden enkele instellingen die digna niet leest. Ze hebben geen effect, en config check vermeldt ze in Stap 6 onder Unknown keys. Verwijder of corrigeer ze:

  • DIGNA_SCHEDULER_MAX_DELAY, DIGNA_CLEANUP_TIME, digna_COOKIE_PATH, digna_COOKIE_SAME_SITE, digna_APP_CORS_ALLOW_METHODS, digna_APP_CORS_ALLOW_HEADERS en digna_LOGGING_BACKUP_COUNT bestaan niet. Verwijder ze.
  • Namen van instellingen zijn hoofdlettergevoelig. digna leest DIGNA_REPO_HOST, niet digna_REPO_HOST. Schrijf elke naam in hoofdletters, zoals in Backendconfiguratie.

Eenmalige aanmelding: behoud [[oidc_clients]]

digna leest providers voor eenmalige aanmelding als een lijst van [[oidc_clients]]-items, elk met een eigen DIGNA_OIDC_KEY. Als u uw providers hebt omgezet naar [oidc_clients.<key>]-secties, zoals een eerdere versie van deze handleiding toonde, zet ze dan terug. config check meldt OIDC config(s) als FAILED zolang die vorm aanwezig is:

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

Herhaal het item voor elke provider en houd elke DIGNA_OIDC_KEY gelijk aan de key in dashboard_config.toml. Alleen installaties die eenmalige aanmelding gebruiken, worden hierdoor geraakt.

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

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

Behoud de vorige licentie niet

Met de vorige licentie start digna nog wel, maar digna Data Reconciliation en de digna MCP Server blijven uitgeschakeld. Elk commando dat de licentie controleert — user, inspection, repo — breekt af voordat het de repository aanraakt wanneer de controle mislukt. Controleer de nieuwe licentie voordat u verdergaat:

digna license check

Stap 8: Upgrade het repository-schema

Voer in uw digna-installatiemap uit:

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.

digna start niet op een verouderde repository

Vanaf Release 2026.11 weigert de server te starten zolang de repository een upgrade nodig heeft, en meldt dat, bijvoorbeeld:

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

Voer repo upgrade uit voordat u de server of de service start.

Stap 9: Herstart services

Als digna als Windows-service draait, start deze dan opnieuw:

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

Als u vanaf een release vóór 2026.06 hebt geüpgraded en de service in Stap 1 hebt gederegistreerd, registreer deze dan eerst opnieuw met het digna-uitvoerbare bestand:

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 standaardwaarden 127.0.0.1 en 8000 wilt. 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 u handmatig draait, start de server dan opnieuw:

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

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

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 bestanden in de map logs van de installatie 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.