macOS-installatiehandleiding voor digna Release 2026.06¶

Release: 2026.06

Laatst bijgewerkt: 5 september 2026

Inhoudsopgave¶

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

Introductie¶

Over digna¶

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

digna bestaat uit twee hoofdcomponenten:

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

Wat is nieuw in Release 2026.06¶

Deze release brengt data-observability-mogelijkheden rechtstreeks in uw code, zodat ontwikkelaars datakwaliteit aan de bron kunnen monitoren. Zie de release notes voor volledige details.

Op zoek naar Windows of Linux?¶

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

Systeemvereisten¶

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

Opties voor database-installatie¶

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

Als u PostgreSQL op dezelfde machine als digna installeert:

Uw architectuur controleren¶

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

uname -m

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

Voorbereiding vóór installatie¶

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

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

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

Homebrew installeren¶

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

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

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

brew --version

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

Stap 2: Installeer Homebrew¶

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

Stap 3: Voeg Homebrew toe aan uw PATH¶

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

brew --prefix

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

PostgreSQL-serverconfiguratie¶

Als u PostgreSQL al hebt¶

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

Installatieopties¶

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

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

PostgreSQL installeren met Homebrew¶

Stap 1: Installeer de PostgreSQL-formule¶

brew install postgresql@16

Stap 2: Voeg PostgreSQL toe aan uw PATH¶

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

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

Stap 3: Start de PostgreSQL-service¶

brew services start postgresql@16

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

Stap 4: Verifieer de installatie¶

psql --version

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

Stap 5: Verbinden met de server¶

psql postgres

Stap 6: Bevestig de poort¶

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

psql postgres -c "SHOW port;"

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

PostgreSQL installeren met Postgres.app¶

Als u de voorkeur geeft aan een grafische installatie:

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

psql --version

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

Webserverconfiguratie¶

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

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

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

Beide secties configureren twee zaken waarvan het dashboard afhankelijk is:

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

nginx-configuratie¶

Overzicht¶

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

Installatie¶

brew install nginx

nginx starten¶

brew services start nginx

Verifieer de installatie¶

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

Een site configureren voor het dashboard¶

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

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

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

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

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

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

Pas de configuratie toe¶

Test de configuratie op syntaxfouten en herlaad daarna nginx:

nginx -t
brew services restart nginx

Apache httpd-configuratie¶

Overzicht¶

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

Apache starten¶

sudo apachectl start

Verifieer de installatie¶

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

Vereist: mod_rewrite inschakelen¶

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

sudo nano /etc/apache2/httpd.conf

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

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Vereist: .htaccess-overrides toestaan¶

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

AllowOverride None

in:

AllowOverride All

Vereist: MIME-type voor Markdown-bestanden¶

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

AddType text/markdown .md

Pas de configuratie toe¶

Controleer de configuratie op syntaxfouten en herstart daarna Apache:

sudo apachectl configtest
sudo apachectl restart

Initiële installatie¶

Stap 1: Zet de digna-repository op¶

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

Maak het repository-schema en de gebruiker aan¶

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

CREATE SCHEMA <digna_repo_schema>;

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

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

Vervang de volgende placeholders:

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

Voorbeeld:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

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

psql postgres

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

Stap 2: Pak het digna-installatiepakket uit¶

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

Om vanuit de Terminal uit te pakken:

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

Maak het uitvoerbare bestand uitvoerbaar¶

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

cd /opt/digna
chmod +x digna

Als macOS de applicatie blokkeert¶

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

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

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

Stap 3: Installeer het licentiebestand¶

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

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

Mapstructuur na installatie:

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

Backendconfiguratie¶

Stap 1: Maak en bewerk het configuratiebestand¶

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

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

Locatie: /opt/digna/config.toml

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

[app] Sectie¶

Deze sectie configureert de applicatie-instellingen van de digna-backend:

[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 = ["*"]

[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!"

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

[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_BACKUP_COUNT = 10

Stap 2: Configuratie valideren¶

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

./digna config check

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

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

Overall: OK

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

Stap 3: Initialiseer de repository¶

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

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

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

Stap 4: Installeer het repository-schema¶

Voer in dezelfde map uit:

./digna repo install

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

Stap 5: Maak een admin-gebruiker aan¶

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

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

Voorbeeld:

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

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

Stap 6: Start de digna-server¶

In de digna-installatiemap start u de server met:

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

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

U 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

Dashboardconfiguratie¶

Stap 1: Zet het dashboard uit op de webserver¶

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

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

Kies uw webserver en volg de bijbehorende deployment-stappen.

Deployen naar nginx¶

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

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

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

4. Zorg dat de map leesbaar is

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

5. Herlaad nginx

   nginx -t
   brew services restart nginx
   

6. Test de installatie

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

Deployen naar Apache httpd¶

1. Kopieer het dashboard naar de document root

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

2. Voeg de rewrite-regels toe

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

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

Plak het volgende:

RewriteEngine On
RewriteBase /digna/

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

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

1. Herstart Apache

   sudo apachectl restart
   

2. Open het dashboard

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

digna als achtergrondservice draaien¶

Waarom digna als service draaien?¶

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

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

Bestanden voor servicebeheer¶

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

De volgende shellscripts zijn beschikbaar:

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

De scripts uitvoerbaar maken¶

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

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

De service installeren¶

1. Open Terminal

2. Navigeer naar de bin-map

   cd /opt/digna/bin
   

3. Voer het installatiescript uit

   sudo ./install_service.sh
   

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

De service starten en stoppen¶

Om de service te starten¶

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

   sudo ./start_service.sh
   

Om de service te stoppen¶

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

   sudo ./stop_service.sh
   

De service verifiëren¶

Om te bevestigen dat de service geregistreerd is en draait:

sudo launchctl list | grep digna

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

De service naar een nieuwe map verplaatsen¶

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

1. Deïnstalleer de huidige service

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

2. Verplaats de applicatiebestanden

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

3. Installeer de service opnieuw

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

4. Start de service

   sudo ./start_service.sh
   

De service verwijderen¶

1. Stop de draaiende service

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

2. Deïnstalleer de service

   sudo ./uninstall_service.sh
   

De digna-server is nu bij launchd gederegistreerd.

Upgraden naar een nieuwe release¶

Voordat u gaat upgraden¶

Controleer eerst alle databaseverbindingen

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

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

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

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

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

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

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

Om een backup vanuit de Terminal te maken:

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

Upgradeproces¶

Stap 1: Stop de digna-service¶

Als digna als achtergrondservice draait, stop deze dan eerst:

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

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

Stap 2: Huidige installatie veiligstellen¶

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Stap 3: Pak de nieuwe versie uit en deploy¶

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

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

Stap 4: Herstel uw configuratiebestanden¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

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

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

Stap 5: Herlaad de webserver¶

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

Stap 6: Configuratie valideren¶

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

./digna config check

Elke sectie moet OK melden. Los alles op wat als FAILED wordt gemeld en voer het commando opnieuw uit voordat u verdergaat.

Stap 7: Vervang het licentiebestand¶

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

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

./digna license check

Stap 8: Upgrade het repository-schema¶

Navigeer naar uw digna-installatiemap en voer uit:

cd /opt/digna
./digna repo upgrade

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

Stap 9: Herstart services¶

Als digna als achtergrondservice draait:

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

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

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

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

brew services restart nginx

sudo apachectl restart

Stap 10: Verifieer de upgrade¶

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