Linux-installatiehandleiding voor digna Release 2026.11¶

Release: 2026.11

Laatst bijgewerkt: 7 november 2026

Inhoudsopgave¶

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

Introductie¶

Over digna¶

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

digna bestaat uit twee hoofdcomponenten:

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

Wat is nieuw in Release 2026.11¶

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

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

Op zoek naar Windows of macOS?¶

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

Voor welke distributie geldt deze handleiding?¶

De instructies zijn geschreven voor de twee meest voorkomende serverfamilies. Waar ze verschillen, worden beide commando's gegeven:

• Debian-familie — Debian, Ubuntu. Pakketbeheerder: apt.
• RHEL-familie — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Pakketbeheerder: dnf.

Elke moderne distributie met systemd werkt; alleen de pakketnamen en enkele configuratiepaden verschillen.

Systeemvereisten¶

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

Opties voor database-installatie¶

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

Als je PostgreSQL op dezelfde machine als digna installeert:

Controleren van distributie en architectuur¶

Verschillende commando's in deze handleiding verschillen tussen de Debian- en RHEL-families. Om te controleren welke u gebruikt, voer uit:

cat /etc/os-release
uname -m

• ID=ubuntu of ID=debian — gebruik de apt-commando's.
• ID=rhel, rocky, almalinux of fedora — gebruik de dnf-commando's.
• x86_64 of aarch64 — de architectuur van het installatiepakket dat u nodig hebt.

Voorbereiding vóór installatie¶

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

1. PostgreSQL-server – voor het opslaan van berekende metrics 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.

Vernieuwen van de pakketindex¶

Werk uw pakketlijsten bij voordat u iets installeert:

sudo apt update

sudo dnf check-update

PostgreSQL-serverconfiguratie¶

Als u al PostgreSQL heeft¶

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

PostgreSQL installeren¶

Stap 1: Installeer het serverpakket¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Stap 2: Initialiseer de databasecluster¶

Bij de Debian-familie maakt en start het pakket automatisch een cluster — sla deze stap dan over.

Bij de RHEL-familie moet de cluster expliciet worden aangemaakt:

sudo postgresql-setup --initdb

Stap 3: Start en zet de service aan¶

sudo systemctl enable --now postgresql

Dit start PostgreSQL onmiddellijk en zorgt ervoor dat het ook automatisch start bij het opstarten.

Stap 4: Verifieer de installatie¶

psql --version
sudo systemctl status postgresql

U zou de PostgreSQL-versie en een active (running) service moeten zien.

Stap 5: Verbinden met de server¶

Een Linux PostgreSQL-pakket maakt een postgres systeemaccount dat de cluster bezit. Verbind hiermee:

sudo -u postgres psql

Stap 6: Bevestig de poort¶

De standaard PostgreSQL-poort is 5432. Om te bevestigen op welke poort uw server luistert:

sudo -u postgres psql -c "SHOW port;"

Noteer de waarde — u heeft deze nodig bij het configureren van de digna-backend.

Stap 7: Schakel wachtwoordverificatie in voor de digna-gebruiker¶

digna maakt verbinding met PostgreSQL via TCP als digna_user, wat wachtwoordverificatie vereist in plaats van peer authentication. Controleer dat uw pg_hba.conf dit toestaat.

Vind het bestand:

sudo -u postgres psql -c "SHOW hba_file;"

Open het in een editor en controleer of de lokale TCP-regels scram-sha-256 (of md5 op oudere servers) gebruiken in plaats van ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Herlaad PostgreSQL na elke wijziging:

sudo systemctl reload postgresql

Stap 8: Als PostgreSQL op een andere machine draait¶

Om verbindingen van een andere host te accepteren, stel listen_addresses in postgresql.conf in en voeg een bijpassende host-regel toe voor uw netwerk in pg_hba.conf:

listen_addresses = '*'

Open vervolgens de poort in de firewall en start de service opnieuw:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Webserverconfiguratie¶

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

• nginx — lichtgewicht en aanbevolen
• Apache httpd — veelgebruikte alternatieve

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

Beide secties configureren twee zaken waarvan het dashboard afhankelijk is:

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

nginx-configuratie¶

Overzicht¶

nginx is een lichtgewicht, hoogpresterende webserver, goed geschikt voor het serveren van het statische digna-dashboard.

Installatie¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx starten¶

sudo systemctl enable --now nginx

Verifieer de installatie¶

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

Firewall openen¶

Als de server vanaf andere machines bereikbaar is, sta HTTP-verkeer toe:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Een site configureren voor het dashboard¶

nginx include elke file in zijn conf.d-map op beide distributiefamilies. Maak daar een dedicated configuratiebestand voor digna:

sudo nano /etc/nginx/conf.d/digna.conf

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

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

De standaardsite uitschakelen¶

Slechts één serverblok kan default_server voor een poort zijn. Bij de Debian-familie, verwijder de meegeleverde default zodat deze niet in conflict komt:

sudo rm /etc/nginx/sites-enabled/default

Bij de RHEL-familie, zet het server { ... }-blok in /etc/nginx/nginx.conf uit door het te commentariëren of te verwijderen.

Pas de configuratie toe¶

Test de configuratie op syntaxisfouten en herlaad nginx:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd-configuratie¶

Overzicht¶

Apache httpd is beschikbaar in de standaardrepositories van alle ondersteunde distributies. Het pakket heet apache2 op de Debian-familie en httpd op de RHEL-familie.

Installatie¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache starten¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Verifieer de installatie¶

1. Open uw browser
2. Navigeer naar http://localhost
3. U zou de standaard Apache-pagina van de distributie moeten zien

Vereist: mod_rewrite inschakelen¶

Het dashboard vereist URL-rewriting.

Bij de Debian-familie, schakel de module in en herstart:

sudo a2enmod rewrite
sudo systemctl restart apache2

Bij de RHEL-familie wordt mod_rewrite standaard geladen. Controleer dit:

httpd -M | grep rewrite

Vereist: .htaccess-overrides toestaan¶

Open het configuratiebestand voor uw documentroot:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Zoek het <Directory>-blok dat uw documentroot dekt (/var/www/html op beide families) en wijzig:

AllowOverride None

naar:

AllowOverride All

Vereist: MIME-type voor Markdown-bestanden¶

Voeg in hetzelfde bestand de volgende regel toe zodat Markdown-bestanden correct worden geserveerd:

AddType text/markdown .md

Pas de configuratie toe¶

Controleer de configuratie op syntaxisfouten en herstart Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Initiële installatie¶

Stap 1: Zet de digna-repository op¶

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

Maak de repository-schema en gebruiker aan¶

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

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Vervang de volgende placeholders:

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

Voorbeeld:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

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

sudo -u postgres psql

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

Stap 2: Pak het digna-installatiepakket uit¶

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

Om vanuit de shell uit te pakken:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Maak het uitvoerbare bestand uitvoerbaar¶

Afhankelijk van hoe het archief is overgezet, kan het uitvoerbit verloren zijn gegaan. Stel het expliciet in:

cd /opt/digna
sudo chmod +x digna

Maak een serviceaccount aan¶

Het is aanbevolen om de backend als een dedicated niet-geprivilegieerde gebruiker te draaien voor productie-omgevingen:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Stap 3: Installeer het licentiebestand¶

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

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

Mapstructuur na installatie:

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

Backendconfiguratie¶

Stap 1: Maak en bewerk het configuratiebestand¶

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

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

Locatie: /opt/digna/config.toml

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

[app] Sectie¶

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

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

[repo] Sectie¶

Deze sectie configureert de verbinding met de PostgreSQL-database:

[repo]
DIGNA_REPO_HOST = "localhost"
DIGNA_REPO_PORT = 5432
DIGNA_REPO_DB = "postgres"
DIGNA_REPO_SCHEMA = "dignarepo"
DIGNA_REPO_USER = "digna_user"
DIGNA_REPO_PASSWORD = "YourSecurePassword123!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

[base] Sectie¶

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

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

[encryption] Sectie¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Sectie¶

Deze sectie configureert het loggedrag:

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

[duckdb] Sectie (optioneel)¶

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

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

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

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

Stap 2: Configuratie valideren¶

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

./digna config check

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

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

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

Stap 3: Initialiseer de repository¶

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

cd /opt/digna
./digna repo check

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

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

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

sudo ln -s /opt/digna/digna /usr/local/bin/digna

Stap 4: Installeer het repository-schema¶

Voer in dezelfde map uit:

./digna repo upgrade

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

✅ Repo schema 'dignarepo' is up to date.

Stap 5: Maak een admin-gebruiker aan¶

1. Open een nieuw terminalvenster
2. Navigeer naar uw 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

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

Stap 6: Start de digna-server¶

In de digna-installatiemap start u de server met:

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

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

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

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

Dashboardconfiguratie¶

Stap 1: Zet het dashboard uit op de webserver¶

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

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

Kies uw webserver en volg de bijbehorende deployment-stappen.

Deployen naar nginx¶

Als u de nginx Setup heeft gevolgd, wijst het serverblok al naar uw dashboard-map en is er geen kopiëren nodig.

1. Bevestig het pad
2. Open /etc/nginx/conf.d/digna.conf

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

4. Zorg dat de map leesbaar is

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

5. Herlaad nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Test de installatie

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

Deployen naar Apache httpd¶

1. Kopieer het dashboard naar de documentroot

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Voeg de rewrite-regels toe

Maak een .htaccess-bestand in de gedeployde map zodat dashboard-routes een browserrefresh overleven:

sudo nano /var/www/html/digna/.htaccess

Plak het volgende:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Herstart Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Toegang tot het dashboard

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

Stap 2: SELinux (alleen RHEL-familie)¶

Op RHEL, Rocky, AlmaLinux en Fedora staat SELinux standaard in enforcing en zal de webserver blokkeren om bestanden buiten de verwachte locaties te lezen. Controleer of het actief is:

getenforce

Als het resultaat Enforcing is en u serveert het dashboard vanaf /opt/digna/dashboard, label dan de map zodat de webserver deze kan lezen:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

digna als systemd-service draaien¶

Waarom digna als service draaien?¶

Het draaien van de digna-backend als systemd-service zorgt ervoor dat deze:

• Automatisch start bij het opstarten van de machine
• Op de achtergrond draait zonder een geopend terminalvenster
• Automatisch opnieuw start als het crasht
• Beheerd kan worden via systemctl, de standaard Linux-servicemanager

Servicebeheerbestanden¶

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

De volgende shellscripts zijn beschikbaar:

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

Maak de scripts uitvoerbaar¶

Bij extractie kan het uitvoerbit verloren zijn gegaan. Voor eerste gebruik:

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

De service installeren¶

1. Open een terminal

2. Navigeer naar de bin-map

   cd /opt/digna/bin
   

3. Voer het installatiescript uit

   sudo ./install_service.sh
   

De digna-server is nu geregistreerd bij systemd met automatisch opstarten ingeschakeld. De service start niet onmiddellijk — zie de volgende sectie om deze te starten.

De service starten en stoppen¶

Om de service te starten¶

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

   sudo ./start_service.sh
   

Om de service te stoppen¶

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

   sudo ./stop_service.sh
   

Beheren van de service met systemctl¶

Zodra geregistreerd, kan de service ook gecontroleerd worden met de standaard systemd-commando's vanuit elke map:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Verifiëren van de service¶

Om te bevestigen dat de service geregistreerd is en draait:

systemctl is-enabled digna
systemctl is-active digna

enabled betekent dat de service bij het opstarten start; active betekent dat deze nu draait.

Bekijk de servicelogboeken¶

systemd captureert alles wat de backend naar de console schrijft. Om het te lezen:

sudo journalctl -u digna -n 100

Om de log realtime te volgen terwijl u een probleem reproduceert:

sudo journalctl -u digna -f

De service naar een nieuwe map verplaatsen¶

De unit-file slaat het absolute pad naar het uitvoerbare bestand op, dus het verplaatsen van de installatie vereist het opnieuw registreren van de service:

1. Verwijder de huidige service

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

2. Verplaats de applicatiebestanden

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

3. Installeer de service opnieuw

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

4. Start de service

   sudo ./start_service.sh
   

De service verwijderen¶

1. Stop de draaiende service

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

2. Verwijder de service

   sudo ./uninstall_service.sh
   

De digna-server is nu van systemd losgekoppeld.

Upgraden naar een nieuwe release¶

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

Voordat u gaat upgraden¶

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

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

Om een backup vanaf de shell te maken:

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

Het licentiebestand voor Release 2026.11 aanvragen

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

Upgraden vanaf een release vóór 2026.06¶

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

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

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

Upgradeproces¶

Stap 1: Stop de digna-service¶

Als digna als systemd-service draait, stop deze dan eerst:

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

Als digna op de voorgrond draait, druk dan op Ctrl+C in het terminalvenster.

Stap 2: Huidige installatie veiligstellen¶

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

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

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

Stap 3: Pak de nieuwe versie uit en deploy¶

1. Pak het nieuwe digna-installatie-ZIP-bestand uit
2. Kopieer het nieuwe digna-uitvoerbare bestand en de dashboard-map naar uw installatiemap
3. Herstel het uitvoerbit en de eigendom voor het serviceaccount:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Stap 4: Herstel uw configuratiebestanden¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

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

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

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

Stap 5: Herlaad de webserver¶

Het dashboard bestaat uit statische bestanden, dus uw webserver — en de browser — kan nog steeds de vorige versie serveren. Herlaad of herstart de webserver die de dashboard-map host, en herlaad de pagina daarna met een harde vernieuwing (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:

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

./digna license check

Stap 8: Upgrade het repository-schema¶

Voer in uw digna-installatiemap uit:

cd /opt/digna
./digna repo upgrade

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

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

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

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

Stap 9: Herstart services¶

Als u als systemd-service draait:

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

Als u handmatig draait, start de server opnieuw:

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

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

sudo systemctl reload nginx

sudo systemctl restart apache2

Op de RHEL-familie, breng de SELinux-labels opnieuw aan als de dashboard-map is vervangen:

sudo restorecon -Rv /opt/digna/dashboard

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 serverlogs op fouten:

   sudo journalctl -u digna -n 100
   

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.