Windows Installatiehandleiding voor digna Release 2026.06¶
Release: 2026.06
Laatst bijgewerkt: 30 augustus 2026
Inhoudsopgave¶
- Inleiding
- Systeemeisen
- Voorbereiding vóór installatie
- PostgreSQL Server Setup
- Webserverconfiguratie
- Initiële installatie
- Backendconfiguratie
- Dashboardconfiguratie
- digna als Windows-service uitvoeren
- 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
dignabackendendignacliuit 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:
- PostgreSQL Server – voor het opslaan van berekende metriek en prestatiegegevens
- 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¶
- Bezoek de PostgreSQL-downloadpagina
- Selecteer Windows
- Download de meest recente installer
Stap 2: Start de installer¶
- Dubbelklik op het gedownloade installerbestand
- 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:
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¶
- Open Configuratiescherm
- Druk
Win + R -
Typ
controlen druk op Enter -
Navigeer naar Windows-onderdelen
- Klik Programma's
-
Selecteer Windows-onderdelen in- of uitschakelen
-
Schakel Internet Information Services in
- Scroll naar beneden en vind Internet Information Services (IIS)
- Vink het selectievakje aan om het in te schakelen
-
Klik op het + om uit te vouwen en controleer of de volgende subcomponenten zijn geselecteerd:
- Web Management Tools
- World Wide Web Services
-
Klik OK om de wijzigingen toe te passen
-
Verifieer IIS-installatie
- Open je browser
- Navigeer naar
http://localhost - 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:
- Open IIS Manager (druk
Win + R, typinetmgr, druk Enter) - Navigeer naar Uw Site > MIME Types
- Klik Toevoegen...
- Configureer:
- Bestandsextensie:
.md - 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¶
- Download Apache Tomcat
- Bezoek Apache Tomcat Downloads
-
Download de Windows ZIP-distributie
-
Pak het archief uit
- Pak het ZIP-bestand uit naar een map op je systeem
-
Voorbeeld:
C:\Program Files\Apache Tomcat -
Verifieer dat Tomcat draait
- Open je browser
- Navigeer naar
http://localhost:8080 - 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¶
- Zoek het aan jou geleverde digna-installatie-ZIP-bestand
- Pak het uit naar de gewenste installatieplek
- Na het uitpakken zou je de volgende items moeten zien:
dashboard/— Webdashboard-interfacedigna— 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.
- Zoek het
license.toml-bestand dat aan jou is geleverd - Kopieer het naar de root van de digna-installatiemap (waar
config.tomlen hetdigna-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.
| 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:
| 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:
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¶
- Open Opdrachtprompt
- Navigeer naar je digna-installatiemap (waar
config.tomlen hetdigna-uitvoerbare bestand zich bevinden) - Voer de verbindingscontrole uit:
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:
Dit commando installeert de benodigde tabellen en het schema in je PostgreSQL-database.
Stap 5: Maak een admin-gebruiker aan¶
- Open een nieuw Opdrachtprompt-venster
- Navigeer naar je digna-installatiemap
- Voer het volgende commando uit om een admin-gebruiker aan te maken:
Voorbeeld:
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:
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¶
- Open IIS Manager
-
Druk
Win + R, typinetmgr, druk Enter -
Maak een nieuwe website
- Klik met de rechtermuisknop op Sites in het linkerpaneel
-
Selecteer Website toevoegen...
-
Configureer de website
- Sitenaam: Voer een naam in (bijv. "dignaDashboard")
- Fysiek pad: Klik Bladeren en selecteer je
dashboard-map -
Binding: Stel IP-adres en poort in (standaard poort 80 voor HTTP, 443 voor HTTPS)
-
Start de website
- Klik OK om de site te maken
-
Klik met de rechtermuisknop op de nieuwe site en selecteer Start
-
Test de installatie
- Open je browser
- Navigeer naar
http://localhost(of je geconfigureerde URL) - Je zou de inlogpagina van het digna-dashboard moeten zien
Deployen naar Apache Tomcat¶
- Kopieer Dashboard naar Tomcat
- Kopieer de
dashboard-map naar dewebapps-directory van Tomcat - Hernoem indien nodig (bijv. naar
digna) -
Voorbeeld:
C:\Program Files\Apache Tomcat\webapps\digna -
Verifieer deployment
- Ververs of herlaad de Tomcat-beheerpagina (http://localhost:8080)
-
Je zou "digna" (of de door jou gekozen naam) moeten zien in de lijst met gedeployde applicaties
-
Toegang tot het dashboard
- Open je browser
- Navigeer naar
http://localhost:8080/digna - 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¶
- Open Opdrachtprompt als Administrator
- Klik met de rechtermuisknop op Opdrachtprompt
-
Kies "Als administrator uitvoeren"
-
Navigeer naar uw digna-installatiemap
-
Registreer de service
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:
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¶
Om de service te stoppen¶
Tip
Stop de service altijd voordat je applicatiebestanden bijwerkt.
De service naar een nieuwe map verplaatsen¶
Als je de digna-installatie wilt verplaatsen:
-
Stop en deregistreer de huidige service
-
Verplaats de applicatiebestanden
-
Verplaats de volledige digna-installatiemap naar de nieuwe locatie
-
Registreer de service opnieuw vanaf de nieuwe locatie
Herhaal alle waarden voor --address, --port of --account die u de eerste keer hebt gebruikt — de vorige registratie bestaat niet meer.
- Start de service
De service verwijderen¶
-
Stop de draaiende service
-
Deregistreer de service
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:
- Loop elke in uw installatie gedefinieerde databaseverbinding na en noteer welke nog geen ODBC gebruiken — elk daarvan moet opnieuw worden geconfigureerd.
- 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.
- 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:
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:
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:
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¶
- Pak het nieuwe digna-installatie-ZIP-bestand uit
- Kopieer het nieuwe
digna-uitvoerbare bestand en dedashboard-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¶
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:
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:
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:
Stap 8: Upgrade het repository-schema¶
Navigeer naar je digna-installatiemap en voer uit:
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:
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:
Als je IIS of Tomcat gebruikt, herstart dan de betreffende webserver.
Stap 10: Verifieer de upgrade¶
- Open het digna-dashboard
- Controleer of de interface correct laadt
- Controleer de serverlogs op eventuele fouten
- Zet elke verbinding die nog geen ODBC gebruikte om naar ODBC en test daarna alle verbindingen — zie Een verbinding testen