macOS Installation Guide for digna Release 2026.11¶

Release: 2026.11

Sidst opdateret: 7. november 2026

Table of Contents¶

1. Introduktion
2. Systemkrav
3. Forudgående opsætning
4. PostgreSQL-serveropsætning
5. Webserverkonfiguration
6. Initial installation
7. Backend-konfiguration
8. Dashboard-konfiguration
9. Køre digna som baggrundstjeneste
10. Opgradering til en ny release

Introduktion¶

Om digna¶

digna er en omfattende AI-drevet platform designet til at optimere data-kvalitetsstyring på tværs af forskellige data-miljøer som warehouses, lakes og lakehouses. Bygget til at være højt skalerbar og tilpasningsdygtig, adresserer digna moderne dataudfordringer gennem automatisering, realtidsovervågning og anomalidetektion.

digna består af to hovedkomponenter:

• digna: applikationens kerne, ansvarlig for at behandle data og udføre kvalitetskontroller. Den samler backend og kommandolinjegrænsefladen i én eksekverbar fil og erstatter dermed de separate programmer dignabackend og dignacli fra tidligere releases.
• dignadashboard: Et webbaseret interface hostet på en webserver, som giver en brugervenlig måde at interagere med digna-platformen og visualisere datakvalitetsmålinger.

Hvad er nyt i Release 2026.11¶

Denne release tilføjer digna Data Reconciliation, digna Agentic med digna MCP Server samt digna Engine, som kan profilere data inde i digna og kontrollere referentiel integritet mellem forskellige databaseteknologier. Se release notes for fulde detaljer.

For en installation bringer releasen en ny migreringsmekanisme for repositoriet, en valgfri [duckdb]-sektion i config.toml til digna Engine og en ny licensfil. Opgraderingsafsnittet gennemgår hver af dem.

Leder du efter Windows eller Linux?¶

Denne vejledning dækker macOS. For andre platforme, se Windows Installation Guide eller Linux Installation Guide.

Systemkrav¶

Før du begynder installationen, sørg for at dit system opfylder følgende minimumskrav:

Database-installationsmuligheder¶

Hvis PostgreSQL allerede er installeret: Du kan tilføje en ny database til digna på din eksisterende PostgreSQL-server.

Hvis du installerer PostgreSQL på samme maskine som digna:

Tjek din arkitektur¶

Flere stier i denne vejledning adskiller sig mellem Apple Silicon og Intel Macs. For at tjekke hvilken du har, åbn Terminal og kør:

uname -m

• arm64 — Apple Silicon. Homebrew installeres til /opt/homebrew.
• x86_64 — Intel. Homebrew installeres til /usr/local.

Forudgående opsætning¶

Før du installerer digna, skal du sikre, at tre nøgleforudsætninger er på plads:

1. Homebrew – pakkestyringsværktøjet brugt til at installere komponenterne nedenfor
2. PostgreSQL Server – til lagring af beregnede metrikker og performance-data
3. Web Server – til hosting af digna Dashboard

Hvis disse komponenter ikke allerede er opsat, følg afsnittene nedenfor for at installere og konfigurere dem.

Installation af Homebrew¶

Homebrew er standard pakkestyringsværktøj for macOS og bruges i hele denne vejledning til at installere PostgreSQL og nginx.

Trin 1: Tjek om Homebrew allerede er installeret¶

Åbn Terminal (tryk Cmd + Space, skriv Terminal, tryk Enter) og kør:

brew --version

Hvis der returneres et versionsnummer, spring videre til afsnittet PostgreSQL-serveropsætning.

Trin 2: Installer Homebrew¶

Hvis kommandoen ikke blev fundet, installer Homebrew ved at følge instruktionerne på den officielle Homebrew-side. Installationsprogrammet installerer også Xcode Command Line Tools, hvis de ikke allerede er til stede.

Trin 3: Tilføj Homebrew til din PATH¶

På Apple Silicon printer installatøren to kommandoer til at tilføje Homebrew til dit shell-miljø. Kør dem som instrueret, og bekræft derefter:

brew --prefix

Dette bør udskrive /opt/homebrew på Apple Silicon eller /usr/local på Intel.

PostgreSQL-serveropsætning¶

Hvis du allerede har PostgreSQL¶

Hvis PostgreSQL allerede er installeret og kører på din lokale maskine, eller hvis du bruger en administreret fjern-PostgreSQL-server, kan du springe til næste afsnit.

Installationsmuligheder¶

macOS tilbyder to ligetil måder at installere PostgreSQL på. Vælg én:

• Homebrew — kommandolinjeinstallation, anbefalet til serverudrulninger
• Postgres.app — grafisk installation, praktisk til lokal evaluering

Installation af PostgreSQL med Homebrew¶

Trin 1: Installer PostgreSQL-formulaen¶

brew install postgresql@16

Trin 2: Tilføj PostgreSQL til din PATH¶

Versionerede PostgreSQL-formulaer er keg-only, hvilket betyder, at Homebrew ikke linker deres kommandoer ind i din PATH automatisk. Tilføj dem selv:

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

Trin 3: Start PostgreSQL-tjenesten¶

brew services start postgresql@16

Dette starter PostgreSQL med det samme og konfigurerer den til at starte automatisk, når du logger ind.

Trin 4: Verificer installationen¶

psql --version

Du bør se PostgreSQL-versionen, hvis installationen lykkedes.

Trin 5: Forbind til serveren¶

psql postgres

Trin 6: Bekræft porten¶

Standard PostgreSQL-port er 5432. For at bekræfte hvilken port din server lytter på:

psql postgres -c "SHOW port;"

Notér værdien — du skal bruge den når du konfigurerer digna-backenden.

Installation af PostgreSQL med Postgres.app¶

Hvis du foretrækker en grafisk installation:

1. Download Postgres.app og træk den ind i din Applications-mappe
2. Åbn appen og klik Initialize for at oprette en ny server
3. Følg appens instruktioner for at tilføje dens kommandolinjeværktøjer til din PATH
4. Verificer installationen:

psql --version

Postgres.app opretter også en superuser med navnet på din macOS-konto.

Webserverkonfiguration¶

digna kræver en webserver til at hoste dashboardet. Vælg én af følgende muligheder:

• nginx — installeret via Homebrew, anbefalet
• Apache httpd — inkluderet i macOS

Du behøver kun at installere og konfigurere én af disse servere.

Begge sektioner konfigurerer to ting, som dashboardet afhænger af:

• En single-page-application fallback, så en opdatering af en dashboard-URL ikke returnerer en 404
• En .md MIME-type, så Markdown-filer serveres korrekt

nginx-opsætning¶

Oversigt¶

nginx er en letvægts, højtydende webserver velegnet til at serve det statiske digna-dashboard.

Installation¶

brew install nginx

Start nginx¶

brew services start nginx

Bekræft installationen¶

1. Åbn din browser
2. Navigér til http://localhost:8080
3. Du bør se nginx-velkomstsiden

Konfiguration af et site til dashboardet¶

Homebrew's nginx-konfiguration inkluderer alle filer i dens servers-mappe. Opret en dedikeret konfigurationsfil til digna der:

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

Indsæt følgende, og erstat /path/to/digna/dashboard med den faktiske sti til din udpakkede dashboard-mappe:

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

Anvend konfigurationen¶

Test konfigurationen for syntaksfejl, og genindlæs derefter nginx:

nginx -t
brew services restart nginx

Apache httpd-opsætning¶

Oversigt¶

macOS inkluderer Apache httpd, så ingen installation er påkrævet. Den er deaktiveret som standard.

Start Apache¶

sudo apachectl start

Bekræft installationen¶

1. Åbn din browser
2. Navigér til http://localhost
3. Du bør se beskeden "It works!"

Påkrævet: Aktivér mod_rewrite¶

Dashboardet kræver URL-omskrivning. Åbn Apache-konfigurationen:

sudo nano /etc/apache2/httpd.conf

Find følgende linje og fjern den indledende # for at gøre den aktiv:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Påkrævet: Tillad .htaccess-overrides¶

I samme fil, lokaliser <Directory "/Library/WebServer/Documents">-blokken og ændr:

AllowOverride None

til:

AllowOverride All

Påkrævet: MIME-type for Markdown-filer¶

Stadig i httpd.conf, tilføj følgende linje, så Markdown-filer serveres korrekt:

AddType text/markdown .md

Anvend konfigurationen¶

Tjek konfigurationen for syntaksfejl, og genstart derefter Apache:

sudo apachectl configtest
sudo apachectl restart

Initial installation¶

Trin 1: Opret digna-repositoriet¶

Digna-repositoriet lagrer alle metrikker beregnet af digna. Det fungerer som den centrale database for analytiske og performance-data.

Opret repositorieschema og bruger¶

Åbn din PostgreSQL-klient (psql, pgAdmin eller lignende) og udfør følgende SQL-kommandoer:

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

Erstat følgende pladsholdere:

• <digna_repo_schema> — Dit ønskede schema-navn (fx dignarepo)
• <digna_repo_user> — Dit ønskede brugernavn (fx digna_user)
• <digna_repo_password> — Et sikkert password til denne bruger

Eksempel:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

For at køre disse fra Terminal i ét trin:

psql postgres

Indsæt derefter statements ved prompten postgres=# og skriv \q for at afslutte.

Trin 2: Pak digna-installationspakken ud¶

1. Find digna-installations-ZIP-filen leveret til dig
2. Pak den ud til din ønskede installationsplacering — for eksempel /opt/digna eller ~/digna
3. Efter udpakning bør du se følgende elementer:
4. dashboard/ — Web dashboard interface
5. digna — Hoved-eksekverbar (backend + CLI kombineret)

For at udpakke fra Terminal:

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

Gør den eksekverbare fil kørbar¶

Afhængig af hvordan arkivet blev overført, overlever den eksekverbare bit måske ikke ved udpakning. Sæt den eksplicit:

cd /opt/digna
chmod +x digna

Hvis macOS blokerer applikationen¶

Filer downloadet gennem en browser eller mailklient er mærket med et quarantine-attribut. Hvis macOS rapporterer, at appen "cannot be opened because the developer cannot be verified", fjern attributten fra installationsmappen:

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

Alternativt, åbn System Settings → Privacy & Security, find det blokerede element nær bunden af siden, og klik Open Anyway.

Trin 3: Installér licensfilen¶

1. Find den license.toml-fil der er leveret til dig
2. Kopiér den ind i root af digna-installationsmappen (hvor config.toml og den eksekverbare digna ligger)

Hvorfor det er vigtigt: Licensfilen indeholder dine kundeoplysninger, licensens udløbsdato og et digitalt signatur. Ændr ikke filen — enhver ændring vil ugyldiggøre den.

Mappe-struktur efter opsætning:

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

Backend-konfiguration¶

Trin 1: Opret og rediger konfigurationsfilen¶

Filen config_template.toml leveres i din digna-installationsmappe. Du skal blot omdøbe den til config.toml.

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

Placering: /opt/digna/config.toml

Åbn config.toml i en teksteditor og konfigurer hver sektion nedenfor.

[app] Sektionen¶

Denne sektion konfigurerer cross-origin resource sharing (CORS) mellem dashboardet og backend:

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

[repo] Sektionen¶

Denne sektion konfigurerer forbindelsen til PostgreSQL-databasen:

[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

[base] Sektionen¶

Denne sektion indeholder indstillinger for sikkerhed, cookies og inspektioner:

[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] Sektion¶

Denne sektion indeholder nøglen, der bruges til at kryptere følsomme værdier i repositoryet. Den er påkrævet — config check rapporterer sektionen [encryption] som FAILED, hvis nøglen mangler.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Sektionen¶

Denne sektion konfigurerer logningsadfærden:

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

[duckdb] Sektion (valgfri)¶

Nyt i Release 2026.11. Denne sektion fastlægger ressourcerne for digna Engine, som profilerer data inde i digna for databaseforbindelser, hvis profileringssted er digna Engine, og kører kontroller af referentiel integritet mellem datakilder på forskellige databaseforbindelser. Se Profileringssted.

Sektionen er valgfri. Uden den gælder standardværdierne nedenfor.

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

mkdir -p /opt/digna/tmp

Trin 2: Validér konfigurationen¶

Kontrollér, at config.toml er fuldstændig og korrekt opbygget, før du initialiserer repositoryet. Kør i din digna-installationsmappe:

./digna config check

Hver sektion valideres for sig, så en enkelt fejl ikke skjuler tilstanden af de øvrige:

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

Ret alt, der rapporteres som FAILED, og kør kommandoen igen, før du fortsætter. En WARNING under Unknown keys viser nøgler i config.toml, som digna ikke læser; de har ingen effekt, så fjern dem eller ret deres stavemåde. Den fulde liste over muligheder findes i CLI-referencen.

Trin 3: Initialisér repositoriet¶

1. Åbn Terminal
2. Navigér til din digna-installationsmappe (hvor config.toml og den eksekverbare digna ligger)
3. Kør forbindelsestesten:

cd /opt/digna
./digna repo check

På et nyt schema opretter kommandoen forbindelse og melder derefter, at der endnu ikke er installeret noget repository:

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

På dette tidspunkt er det det forventede resultat: det bekræfter, at digna når PostgreSQL og schemaet. En forbindelses- eller godkendelsesfejl peger i stedet på sektionen [repo] eller på PostgreSQL-opsætningen.

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

Trin 4: Installer repositorieschemaet¶

I samme mappe, kør:

./digna repo upgrade

Denne kommando installerer de nødvendige tabeller i repository-schemaet og afslutter med:

✅ Repo schema 'dignarepo' is up to date.

Trin 5: Opret en admin-bruger¶

1. Åbn et nyt Terminal-vindue
2. Navigér til din digna-installationsmappe
3. Kør følgende kommando for at oprette en admin-bruger:

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

Eksempel:

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

Dette opretter en bruger med e-mailadressen admin@example.com og fulde administratorrettigheder.

Trin 6: Start digna-serveren¶

I digna-installationsmappen, start serveren med:

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

Parametre: - --address — Server hostname/IP (standard 127.0.0.1) - --port — Serverport (standard 8000)

Når serveren er oppe, udskriver den den adresse, den lytter på:

Server running on http://127.0.0.1:8082

Dashboard-konfiguration¶

Trin 1: Deploy dashboardet til webserveren¶

digna-dashboardet læser sin egen konfiguration fra dashboard/dashboard_config.toml. Den fil følger ikke med installationen — du opretter den i dashboard/-mappen sammen med dashboardfilerne.

Dens indhold er beskrevet under Single Sign-On, som også er der, hvor filen er nødvendig: den indeholder de login-muligheder, dashboardet tilbyder, og ved multi-instance udrulninger backend-forbindelsen.

Vælg din webserver og følg de tilsvarende deployments-steps.

Deploy til nginx¶

Hvis du fulgte afsnittet nginx Setup, peger server-blokken allerede på din dashboard-mappe og der er ingen kopiering nødvendig.

1. Bekræft stien
2. Åbn $(brew --prefix)/etc/nginx/servers/digna.conf

3. Bekræft at root peger på din udpakkede dashboard-mappe

4. Sørg for at mappen er læsbar

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

5. Genindlæs nginx

   nginx -t
   brew services restart nginx
   

6. Test installationen

7. Åbn din browser
8. Navigér til http://localhost:8080 (eller din konfigurerede URL)
9. Du bør se digna-dashboardets login-side

Deploy til Apache httpd¶

1. Kopier dashboardet til document root

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

2. Tilføj rewrite-reglerne

Opret en .htaccess-fil inde i den deployerede mappe, så dashboard-routes overlever en browser-refresh:

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

Indsæt følgende:

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

   sudo apachectl restart
   

2. Adgang til dashboardet

3. Åbn din browser
4. Navigér til http://localhost/digna
5. Du bør se digna-dashboardets login-side

Køre digna som baggrundstjeneste¶

Hvorfor køre digna som en tjeneste?¶

At køre digna-backenden som en baggrundstjeneste sikrer, at den:

• Starter automatisk når maskinen booter
• Kører i baggrunden uden et åbent Terminal-vindue
• Genstarter automatisk, hvis den crasher
• Kan administreres via launchctl, macOS's tjenestestyring

Tjeneste-styringsfiler¶

Alle nødvendige filer ligger i digna-installationsmappen under: bin/

Følgende shell-scripts er tilgængelige:

• install_service.sh — registrerer digna hos launchd
• uninstall_service.sh — af-registrerer tjenesten
• start_service.sh — starter den registrerede tjeneste
• stop_service.sh — stopper den kørende tjeneste

Gør scripts kørbare¶

Udpakning bevarer måske ikke den eksekverbare bit. Før første brug:

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

Installér tjenesten¶

1. Åbn Terminal

2. Navigér til bin-mappen

   cd /opt/digna/bin
   

3. Kør installationsscriptet

   sudo ./install_service.sh
   

Digna-serveren er nu registreret hos launchd med automatisk opstart aktiveret. Tjenesten starter ikke umiddelbart — se næste afsnit for at starte den.

Start og stop af tjenesten¶

For at starte tjenesten¶

1. Åbn Terminal
2. Navigér til /opt/digna/bin
3. Kør:

   sudo ./start_service.sh
   

For at stoppe tjenesten¶

1. Åbn Terminal
2. Navigér til /opt/digna/bin
3. Kør:

   sudo ./stop_service.sh
   

Verificér tjenesten¶

For at bekræfte at tjenesten er registreret og kørende:

sudo launchctl list | grep digna

En linje der begynder med et proces-ID indikerer, at tjenesten kører. Et - i den første kolonne betyder, at den er registreret men stoppet.

Flyt tjenesten til en ny mappe¶

launchd gemmer den absolutte sti til den eksekverbare fil, så flytning af installationen kræver gen-registrering af tjenesten:

1. Afinstaller den nuværende tjeneste

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

2. Flyt applikationsfilerne

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

3. Geninstalér tjenesten

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

4. Start tjenesten

   sudo ./start_service.sh
   

Afinstallér tjenesten¶

1. Stop den kørende tjeneste

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

2. Afinstallér tjenesten

   sudo ./uninstall_service.sh
   

Digna-serveren er nu af-registreret fra launchd.

Opgradering til en ny release¶

Dette afsnit opgraderer en installation af Release 2026.06 til Release 2026.11. Hvis din installation er ældre, så læs først Opgradering fra en release før 2026.06.

Før du opgraderer¶

Det er obligatorisk at lave en backup af digna-repositoriet

Før du opgraderer digna, sikkerhedskopier dit repositorie (PostgreSQL) for at beskytte imod datatab. En backup sikrer, at du kan gendanne, hvis opgraderingen støder på uventede problemer.

For at lave en backup fra Terminal:

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

Anmod om licensfilen til Release 2026.11

Release 2026.11 kræver en ny license.toml. Anmod digna-teamet om den, før du starter, og hav den klar til Trin 7.

Opgradering fra en release før 2026.06¶

Release 2026.06 bragte tre ændringer, som stadig gælder, når du opgraderer en ældre installation direkte til 2026.11:

• Kun ODBC. digna når hver kildeteknologi via ODBC. Hver databaseforbindelse, der endnu ikke bruger ODBC, skal lægges om til ODBC efter opgraderingen; der er ingen automatisk konvertering. Installér ODBC-driverne på digna-værten på forhånd, se Installér ODBC-driveren på digna-værten, og hav egenskaberne for hver forbindelse klar fra teknologivejledningerne. Databricks Legacy-connectoren findes ikke længere; flyt disse forbindelser til Databricks-connectoren.
• Én eksekverbar fil. dignabackend og dignacli er erstattet af den enkelte eksekverbare fil digna, som samler backend og CLI.
• config.toml. Sektionen [encryption] er påkrævet, og DIGNA_APP_HOST og DIGNA_APP_PORT læses ikke længere: serveren henter sin adresse og port fra digna serve. Sammenlign din fil med Backend-konfiguration.

Trinene nedenfor angiver, hvor en ældre installation kræver noget andet. Opgraderingen af repositoriet i Trin 8 bringer et repository fra enhver tidligere release direkte til 2026.11.

Opgraderingsproces¶

Trin 1: Stop digna-tjenesten¶

Hvis digna kører som en baggrundstjeneste, stop den først:

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

Hvis digna kører i forgrunden, tryk Ctrl+C i dets Terminal-vindue.

Trin 2: Sikkerhedskopiér nuværende installation¶

Omdøb den eksekverbare fil og dashboard-mappen i din nuværende installation i digna-installationsmappen, så den nye release kan udrulles ved siden af dem:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Behold digna_old, indtil du har verificeret opgraderingen, og dashboard_old, indtil du har gendannet dine konfigurationsfiler fra den (se Trin 4). Derefter kan du slette begge.

Trin 3: Udpak og deploy den nye version¶

1. Udpak den nye digna-installations-ZIP-fil
2. Kopiér den nye digna-eksekverbare og dashboard-mappen til din installationsmappe
3. Genskab den eksekverbare bit og, hvis nødvendigt, fjern quarantine-attributten:

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

Trin 4: Gendan dine konfigurationsfiler¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 kræver ingen ændring af config.toml: en fil, der virker med Release 2026.06, virker fortsat. To ændringer er valgfrie:

• Tilføj en [duckdb]-sektion, hvis databaseforbindelser skal bruge digna Engine, og dens standardværdier ikke passer til din vært.
• Udelad sektionen [app], hvis en reverse proxy leverer dashboardet og backend under én origin.

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

Trin 5: Genindlæs webserveren¶

Dashboardet er et sæt statiske filer, så din webserver — og browseren — kan stadig levere den tidligere version. Genindlæs eller genstart den webserver, der hoster dashboard- mappen, og genindlæs derefter siden med en hård opdatering (Cmd+Shift+R).

Trin 6: Validér konfigurationen¶

Bekræft, at config.toml er fuldstændig, før du rører repositoryet:

./digna config check

Hver sektion skal rapportere OK. Ret alt, der rapporteres som FAILED, fjern de nøgler, der vises under Unknown keys, og kør kommandoen igen, før du fortsætter.

Trin 7: Udskift licensfilen¶

En licensfil overføres normalt fra én release til den næste. Release 2026.11 er en undtagelse: den tilføjer to licenserede moduler, digna Data Reconciliation og digna Agentic, og en licens udstedt før 2026.11 indeholder dem ikke. Kopiér den license.toml, som digna-teamet har leveret til Release 2026.11, til installationsmappen, så den erstatter den gamle:

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

./digna license check

Trin 8: Opgrader repositorieschemaet¶

Kør i din digna-installationsmappe:

cd /opt/digna
./digna repo upgrade

Release 2026.11 styrer repository-schemaet med versionerede migreringer. Den første opgradering fra en tidligere release bringer schemaet til den sidste version i den tidligere ordning, registrerer den som sit udgangspunkt og anvender derefter migreringerne fra Release 2026.11. Den afslutter med:

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

Alle eksisterende data bevares. For at se repositoriets tilstand når som helst, kør ./digna repo check: den viser den senest anvendte migrering og eventuelle ventende.

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

Trin 9: Genstart tjenesterne¶

Hvis du kører som baggrundstjeneste:

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

Hvis du kører manuelt, genstart serveren:

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

Hvis du bruger nginx eller Apache, genstart den respektive webserver:

brew services restart nginx

sudo apachectl restart

Trin 10: Verificér opgraderingen¶

1. Bekræft releasen af den nye eksekverbare fil:

   ./digna version
   

   Den første linje skal lyde Release: 2026.11.

2. Tilgå digna-dashboardet, og bekræft, at interfacet indlæses korrekt.

3. Tjek serverens output og filerne i mappen logs for fejl.
4. Test dine databaseforbindelser — se Test en forbindelse. Efter en opgradering fra en release før 2026.06 skal du først lægge hver forbindelse, der ikke allerede brugte ODBC, om til ODBC.

For at komme i gang med de nye moduler, se digna Data Reconciliation, Forbind en AI-agent for digna MCP Server og Profileringssted for digna Engine.