macOS installasjonsveiledning for digna Release 2026.11¶

Release: 2026.11

Sist oppdatert: 7. november 2026

Innholdsfortegnelse¶

1. Introduksjon
2. Systemkrav
3. Forberedelser før installasjon
4. PostgreSQL-serveroppsett
5. Webserverkonfigurasjon
6. Første installasjon
7. Backend-konfigurasjon
8. Dashboard-konfigurasjon
9. Kjøre digna som en bakgrunnstjeneste
10. Oppgradere til en ny release

Introduksjon¶

Om digna¶

digna er en omfattende, AI-drevet plattform designet for å optimalisere datakvalitetsstyring på tvers av ulike dataomgivelser som warehouses, lakes og lakehouses. Bygget for høy skalerbarhet og tilpasningsevne, møter digna moderne datautfordringer gjennom automatisering, sanntidsovervåking og anomalideteksjon.

digna består av to hovedkomponenter:

• digna: kjernen i applikasjonen, ansvarlig for å behandle data og utføre kvalitetskontroller. Den samler backend og kommandolinjegrensesnittet i én kjørbar fil og erstatter dermed de separate programmene dignabackend og dignacli fra tidligere utgivelser.
• dignadashboard: Et nettbasert grensesnitt hostet på en webserver, som gir en brukervennlig måte å samhandle med digna-plattformen og visualisere datakvalitetsmetrikker.

Hva er nytt i Release 2026.11¶

Denne utgivelsen legger til digna Data Reconciliation, digna Agentic med digna MCP Server, og digna Engine, som kan profilere data inne i digna og kontrollere referanseintegritet mellom ulike databaseteknologier. Se utgivelsesnotatene for fullstendige detaljer.

For en installasjon bringer utgivelsen en ny mekanisme for repository-migreringer, en valgfri [duckdb]-seksjon i config.toml for digna Engine, og en ny lisensfil. Oppgraderingsavsnittet tar for seg hver av dem.

Ser du etter Windows eller Linux?¶

Denne veiledningen dekker macOS. For andre plattformer, se Windows Installation Guide eller Linux Installation Guide.

Systemkrav¶

Før du begynner installasjonen, sørg for at systemet ditt møter følgende minimumskrav:

Databaseinstallasjonsvalg¶

Hvis PostgreSQL allerede er installert: Du kan legge til en ny database for digna i din eksisterende PostgreSQL-server.

Hvis du installerer PostgreSQL på samme maskin som digna:

Sjekke arkitekturen din¶

Flere stier i denne veiledningen varierer mellom Apple Silicon og Intel-Mac. For å sjekke hvilken du har, åpne Terminal og kjør:

uname -m

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

Forberedelser før installasjon¶

Før du installerer digna, sørg for at tre viktige forutsetninger er på plass:

1. Homebrew – pakkebehandleren som brukes til å installere komponentene nedenfor
2. PostgreSQL Server – for lagring av beregnede metrikker og ytelsesdata
3. Webserver – for hosting av digna Dashboard

Hvis disse komponentene ikke allerede er konfigurert, følg seksjonene nedenfor for å installere og konfigurere dem.

Installere Homebrew¶

Homebrew er standard pakkebehandler for macOS og brukes gjennom hele denne veiledningen for å installere PostgreSQL og nginx.

Trinn 1: Sjekk om Homebrew allerede er installert¶

Åpne Terminal (trykk Cmd + Space, skriv Terminal, trykk Enter) og kjør:

brew --version

Hvis et versjonsnummer returneres, hopp til avsnittet om PostgreSQL-serveroppsett.

Trinn 2: Installer Homebrew¶

Hvis kommandoen ikke ble funnet, installer Homebrew ved å følge instruksjonene på offisielle Homebrew-nettsiden. Installeringsprogrammet installerer også Xcode Command Line Tools hvis de ikke allerede er til stede.

Trinn 3: Legg Homebrew til i PATH¶

På Apple Silicon skriver installasjonsprogrammet to kommandoer for å legge Homebrew til ditt shell-miljø. Kjør dem som angitt, og bekreft deretter:

brew --prefix

Dette skal skrive ut /opt/homebrew på Apple Silicon eller /usr/local på Intel.

PostgreSQL-serveroppsett¶

Hvis du allerede har PostgreSQL¶

Hvis PostgreSQL allerede er installert og kjører på din lokale maskin, eller hvis du bruker en administrert ekstern PostgreSQL-server, kan du hoppe til neste avsnitt: Webserverkonfigurasjon.

Installasjonsalternativer¶

macOS tilbyr to enkle måter å installere PostgreSQL på. Velg én:

• Homebrew — kommandolinjeinstallasjon, anbefales for serverdistribusjoner
• Postgres.app — grafisk installasjon, praktisk for lokal evaluering

Installere PostgreSQL med Homebrew¶

Trinn 1: Installer PostgreSQL-formelen¶

brew install postgresql@16

Trinn 2: Legg PostgreSQL til i PATH¶

Versjonsbundne PostgreSQL-formler er keg-only, som betyr at Homebrew ikke lenker kommandoene deres inn i PATH automatisk. Legg dem til selv:

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

Trinn 3: Start PostgreSQL-tjenesten¶

brew services start postgresql@16

Dette starter PostgreSQL umiddelbart og konfigurerer den til å starte automatisk når du logger inn.

Trinn 4: Verifiser installasjonen¶

psql --version

Du skal se PostgreSQL-versjonen hvis installasjonen var vellykket.

Trinn 5: Koble til serveren¶

psql postgres

Trinn 6: Bekreft porten¶

Standard PostgreSQL-port er 5432. For å bekrefte hvilken port serveren lytter på:

psql postgres -c "SHOW port;"

Noter verdien — du vil trenge den når du konfigurerer digna-backenden.

Installere PostgreSQL med Postgres.app¶

Hvis du foretrekker en grafisk installasjon:

1. Last ned Postgres.app og dra den til Applications-mappen
2. Åpne appen og klikk Initialize for å opprette en ny server
3. Følg appens instruksjoner for å legge til dens kommandolinjeverktøy i PATH
4. Verifiser installasjonen:

psql --version

Postgres.app oppretter også en superbruker med navnet til din macOS-konto.

Webserverkonfigurasjon¶

digna krever en webserver for å hoste dashboardet. Velg ett av følgende alternativer:

• nginx — installert via Homebrew, anbefales
• Apache httpd — inkludert i macOS

Du trenger bare å installere og konfigurere én av disse serverne.

Begge seksjonene konfigurerer to ting som dashboardet er avhengig av:

• Fallback for single-page application, slik at oppdatering av en dashboard-URL ikke gir 404
• En .md MIME-type, slik at Markdown-filer serveres riktig

nginx-oppsett¶

Oversikt¶

nginx er en lettvekts, høyytelses webserver godt egnet til å servere det statiske digna-dashboardet.

Installering¶

brew install nginx

Starte nginx¶

brew services start nginx

Verifiser installasjonen¶

1. Åpne nettleseren din
2. Naviger til http://localhost:8080
3. Du skal se nginx-velkomstsiden

Konfigurere et nettsted for dashboardet¶

Homebrews nginx-konfigurasjon inkluderer alle filer i katalogen servers. Opprett en dedikert konfigurasjonsfil for digna der:

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

Lim inn følgende og erstatt /path/to/digna/dashboard med den faktiske banen til din utpakkede 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;
    }
}

Bruk konfigurasjonen¶

Test konfigurasjonen for syntaksfeil, og last deretter nginx på nytt:

nginx -t
brew services restart nginx

Apache httpd-oppsett¶

Oversikt¶

macOS inkluderer Apache httpd, så ingen installasjon er nødvendig. Tjenesten er deaktivert som standard.

Starte Apache¶

sudo apachectl start

Verifiser installasjonen¶

1. Åpne nettleseren din
2. Naviger til http://localhost
3. Du skal se meldingen "It works!"

Påkrevd: Aktivere mod_rewrite¶

Dashboardet krever URL-omskriving. Åpne Apache-konfigurasjonen:

sudo nano /etc/apache2/httpd.conf

Finn følgende linje og fjern ledende # for å avkommentere den:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Påkrevd: Tillat .htaccess-overstyringer¶

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

AllowOverride None

til:

AllowOverride All

Påkrevd: MIME-type for Markdown-filer¶

Fremdeles i httpd.conf, legg til følgende linje slik at Markdown-filer serveres riktig:

AddType text/markdown .md

Bruk konfigurasjonen¶

Sjekk konfigurasjonen for syntaksfeil, og start deretter Apache på nytt:

sudo apachectl configtest
sudo apachectl restart

Første installasjon¶

Trinn 1: Sett opp digna-repositoriet¶

digna-repositoriet lagrer alle metrikker som beregnes av digna. Det fungerer som den sentrale databasen for analytiske og ytelsesrelaterte data.

Opprett repositories-skjema og bruker¶

Åpne din PostgreSQL-klient (psql, pgAdmin eller lignende) og utfø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>;

Erstatt følgende plassholdere:

• <digna_repo_schema> — Ønsket skjema-navn (f.eks. dignarepo)
• <digna_repo_user> — Ønsket brukernavn (f.eks. digna_user)
• <digna_repo_password> — Et sikkert passord for denne brukeren

Eksempel:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

For å kjøre disse fra Terminal i ett steg:

psql postgres

Lim deretter inn utsagnene ved postgres=# prompten og skriv \q for å avslutte.

Trinn 2: Pakk ut digna-installasjonspakken¶

1. Finn digna-installasjons ZIP-filen du har fått
2. Pakk den ut til ønsket installasjonssted — for eksempel /opt/digna eller ~/digna
3. Etter utpakking bør du se følgende elementer:
4. dashboard/ — Web dashboard-grensesnitt
5. digna — Hovedkjørbar fil (backend + CLI kombinert)

For å pakke ut fra Terminal:

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

Gjør den kjørbare filen kjørbar¶

Avhengig av hvordan arkivet ble overført, kan den kjørbare biten mangle etter utpakking. Sett den eksplisitt:

cd /opt/digna
chmod +x digna

Hvis macOS blokkerer applikasjonen¶

Filer lastet ned via en nettleser eller mailklient tagges med et karanteneattributt. Hvis macOS rapporterer at appen "cannot be opened because the developer cannot be verified", fjern attributtet fra installasjonskatalogen:

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

Alternativt, åpne System Settings → Privacy & Security, finn det blokkerte elementet nær bunnen av siden, og klikk Open Anyway.

Trinn 3: Installer lisensfilen¶

1. Finn license.toml-filen som er levert til deg
2. Kopier den inn i rotmappen for digna-installasjonen (der config.toml og den kjørbare digna-filen ligger)

Hvorfor dette er viktig: Lisensfilen inneholder kundeinformasjon, lisensens utløpsdato og digital signatur. Endre ikke denne filen — eventuelle endringer vil ugyldiggjøre den.

Katalogstruktur etter oppsett:

/opt/digna/
├── config.toml         (konfigurasjonsfil)
├── license.toml        (DIN LISENSFIL - kopier hit)
├── digna               (hovedkjørbar fil)
├── bin/                (skripter for tjenestehåndtering)
└── dashboard/          (webgrensesnitt)
    └── (dashboard-filer)

Backend-konfigurasjon¶

Trinn 1: Opprett og rediger konfigurasjonsfilen¶

Filen config_template.toml leveres i digna-installasjonskatalogen. Du trenger bare å gi den nytt navn til config.toml.

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

Plassering: /opt/digna/config.toml

Åpne config.toml i en teksteditor og konfigurer hver seksjon nedenfor.

[app] Seksjonen¶

Denne seksjonen konfigurerer cross-origin resource sharing (CORS) mellom dashboardet og backend:

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

[repo] Seksjonen¶

Denne seksjonen konfigurerer tilkoblingen 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] Seksjonen¶

Denne seksjonen inneholder sikkerhets-, cookie- og inspeksjonsinnstillinger:

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

Denne seksjonen inneholder nøkkelen som brukes til å kryptere sensitive verdier i repositoryet. Den er påkrevd — config check rapporterer seksjonen [encryption] som FAILED hvis nøkkelen mangler.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Seksjonen¶

Denne seksjonen konfigurerer loggeadferd:

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

[duckdb] Seksjonen (valgfri)¶

Nytt i Release 2026.11. Denne seksjonen angir ressursene til digna Engine, som profilerer data inne i digna for databasetilkoblinger med profileringsstedet digna Engine, og som kjører kontroller av referanseintegritet mellom datakilder på ulike databasetilkoblinger. Se Profileringssted.

Seksjonen er valgfri. Uten den gjelder standardverdiene nedenfor.

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

mkdir -p /opt/digna/tmp

Trinn 2: Valider konfigurasjonen¶

Kontroller at config.toml er fullstendig og korrekt bygget opp før du initialiserer repositoryet. Kjør i digna-installasjonskatalogen:

./digna config check

Hver seksjon valideres for seg, slik at én enkelt feil ikke skjuler tilstanden til de andre:

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

Rett alt som rapporteres som FAILED, og kjør kommandoen på nytt før du går videre. En WARNING under Unknown keys viser nøkler i config.toml som digna ikke leser; de har ingen effekt, så fjern dem eller rett stavemåten. Den fullstendige listen over valg finnes i CLI-referansen.

Trinn 3: Initialiser repositoriet¶

1. Åpne Terminal
2. Naviger til din digna-installasjonsmappe (der config.toml og den kjørbare digna-filen ligger)
3. Kjør tilkoblingstesten:

cd /opt/digna
./digna repo check

På et nytt skjema kobler kommandoen til og rapporterer deretter at det ikke er installert noe repository ennå:

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

På dette tidspunktet er det det forventede resultatet: det bekrefter at digna når PostgreSQL og skjemaet. En tilkoblings- eller autentiseringsfeil peker i stedet på [repo]-seksjonen eller på PostgreSQL-oppsettet.

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

Trinn 4: Installer repositories-skjemaet¶

I samme katalog, kjør:

./digna repo upgrade

Denne kommandoen installerer de nødvendige tabellene i repository-skjemaet og avslutter med:

✅ Repo schema 'dignarepo' is up to date.

Trinn 5: Opprett en admin-bruker¶

Administratorbrukeren opprettes direkte mot repository-skjemaet, så serveren trenger ikke å kjøre ennå. Kjør i digna-installasjonskatalogen:

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

Eksempel:

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

Dette oppretter en bruker med e-postadressen admin@example.com og fulle administratorrettigheter.

Trinn 6: Start digna-serveren¶

I digna-installasjonskatalogen, start serveren med:

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

Parametere: - --address — Serverens vertsnavn/IP (standard 127.0.0.1) - --port — Serverport (standard 8000)

Når serveren er oppe, skriver den ut adressen den lytter på:

Server running on http://127.0.0.1:8082

Dashboard-konfigurasjon¶

Trinn 1: Distribuer dashboardet til webserveren¶

digna-dashboardet leser sin egen konfigurasjon fra dashboard/dashboard_config.toml. Den filen følger ikke med installasjonen — du oppretter den i dashboard/-katalogen sammen med dashboardfilene.

Innholdet er beskrevet under Enkel pålogging, som også er der filen trengs: den inneholder påloggingsalternativene dashboardet tilbyr og, for distribusjoner med flere instanser, backend-tilkoblingen.

Velg din webserver og følg de tilsvarende distribusjonstrinnene.

Distribuere til nginx¶

Hvis du fulgte nginx-oppsettet er serverblokken allerede pekt mot din dashboard-mappe og ingen kopiering er nødvendig.

1. Bekreft banen
2. Åpne $(brew --prefix)/etc/nginx/servers/digna.conf

3. Bekreft at root peker til din utpakkede dashboard-mappe

4. Sørg for at mappen er lesbar

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

5. Last inn nginx på nytt

   nginx -t
   brew services restart nginx
   

6. Test installasjonen

7. Åpne nettleseren din
8. Naviger til http://localhost:8080 (eller din konfigurerte URL)
9. Du skal se innloggingssiden for digna-dashboardet

Distribuere til Apache httpd¶

1. Kopier dashboardet til dokumentroten

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

2. Legg til omskrivingsreglene

Opprett en .htaccess-fil inne i den deployerte mappen slik at dashboard-ruter overlever en nettleseroppdatering:

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

Lim inn 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. Start Apache på nytt

   sudo apachectl restart
   

2. Åpne dashboardet

3. Åpne nettleseren din
4. Naviger til http://localhost/digna
5. Du skal se innloggingssiden for digna-dashboardet

Kjøre digna som en bakgrunnstjeneste¶

Hvorfor kjøre digna som en tjeneste?¶

Å kjøre digna-backenden som en bakgrunnstjeneste sikrer at den:

• Startes automatisk når maskinen booter
• Kjører i bakgrunnen uten et åpent Terminal-vindu
• Startes på nytt automatisk hvis den krasjer
• Kan administreres via launchctl, macOS sin tjenestehåndterer

Filer for tjenesteadministrasjon¶

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

Følgende shell-skript er tilgjengelige:

• install_service.sh — registrerer digna med launchd
• uninstall_service.sh — avregistrerer tjenesten
• start_service.sh — starter den registrerte tjenesten
• stop_service.sh — stopper den kjørende tjenesten

Gjør skriptene kjørbare¶

Utpakking kan fjernet kjørbar-bit. Før første bruk:

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

Installere tjenesten¶

1. Åpne Terminal

2. Gå til bin-mappen

   cd /opt/digna/bin
   

3. Kjør installasjonsskriptet

   sudo ./install_service.sh
   

digna-serveren er nå registrert hos launchd med automatisk oppstart aktivert. Tjenesten starter ikke umiddelbart — se neste seksjon for å starte den.

Starte og stoppe tjenesten¶

For å starte tjenesten¶

1. Åpne Terminal
2. Naviger til /opt/digna/bin
3. Kjør:

   sudo ./start_service.sh
   

For å stoppe tjenesten¶

1. Åpne Terminal
2. Naviger til /opt/digna/bin
3. Kjør:

   sudo ./stop_service.sh
   

Verifisere tjenesten¶

For å bekrefte at tjenesten er registrert og kjører:

sudo launchctl list | grep digna

En linje som begynner med en prosess-ID indikerer at tjenesten kjører. En - i den første kolonnen betyr at den er registrert, men stoppet.

Flytte tjenesten til en ny katalog¶

launchd lagrer den absolutte banen til den kjørbare filen, så relokering krever re-registrering av tjenesten:

1. Avinstaller gjeldende tjeneste

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

2. Flytt applikasjonsfilene

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

3. Installer tjenesten på nytt

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

4. Start tjenesten

   sudo ./start_service.sh
   

Avinstallere tjenesten¶

1. Stopp den kjørende tjenesten

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

2. Avinstaller tjenesten

   sudo ./uninstall_service.sh
   

digna-serveren er nå avregistrert fra launchd.

Oppgradere til en ny release¶

Denne delen oppgraderer en installasjon av Release 2026.06 til Release 2026.11. Hvis installasjonen din er eldre, les først Oppgradere fra en utgivelse før 2026.06.

Før du oppgraderer¶

Det er obligatorisk å ta backup av digna-repositoriet

Før du oppgraderer digna, ta backup av repositoriet (PostgreSQL) for å beskytte mot datatap. En backup sikrer at du kan gjenopprette hvis oppgraderingen møter uventede problemer.

For å lage en backup fra Terminal:

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

Be om lisensfilen for Release 2026.11

Release 2026.11 krever en ny license.toml. Be digna-teamet om den før du starter, og ha den klar til trinn 7.

Oppgradere fra en utgivelse før 2026.06¶

Release 2026.06 innførte tre endringer som fortsatt gjelder når du oppgraderer en eldre installasjon direkte til 2026.11:

• Kun ODBC. digna når hver kildeteknologi via ODBC. Hver databasetilkobling som ennå ikke bruker ODBC, må legges om til ODBC etter oppgraderingen; det finnes ingen automatisk konvertering. Installer ODBC-driverne på digna-verten på forhånd, se Installer ODBC-driveren på digna-verten, og ha egenskapene for hver tilkobling klare fra teknologiveiledningene. Databricks Legacy-koblingen finnes ikke lenger; flytt disse tilkoblingene til Databricks-koblingen.
• Én kjørbar fil. dignabackend og dignacli erstattes av den ene kjørbare filen digna, som samler backend og CLI.
• config.toml. [encryption]-seksjonen er påkrevd, og DIGNA_APP_HOST og DIGNA_APP_PORT leses ikke lenger: serveren henter adresse og port fra digna serve. Sammenlign filen din med Backend-konfigurasjon.

Trinnene nedenfor viser hvor en eldre installasjon trenger noe annet. Repository-oppgraderingen i trinn 8 bringer et repository fra en hvilken som helst tidligere utgivelse direkte til 2026.11.

Oppgraderingsprosess¶

Trinn 1: Stopp digna-tjenesten¶

Hvis digna kjører som en bakgrunnstjeneste, stopp den først:

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

Hvis digna kjører i forgrunnen, trykk Ctrl+C i Terminal-vinduet der den kjører.

Trinn 2: Sikkerhetskopier gjeldende installasjon¶

Gi den kjørbare filen og dashboard-mappen i den gjeldende installasjonen nye navn i digna-installasjonskatalogen, slik at den nye utgivelsen kan distribueres ved siden av dem:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Behold digna_old til du har verifisert oppgraderingen, og dashboard_old til du har gjenopprettet konfigurasjonsfilene dine fra den (se trinn 4). Deretter kan du slette begge.

Trinn 3: Pakk ut og distribuer ny versjon¶

1. Pakk ut den nye digna-installasjons-ZIP-filen
2. Kopier den nye kjørbare digna-filen og dashboard-mappen til installasjonskatalogen din
3. Gjenopprett kjørbar-biten og fjern om nødvendig karanteneattributtet:

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

Trinn 4: Gjenopprett konfigurasjonsfilene¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 krever ingen endring i config.toml: en fil som fungerer med Release 2026.06, fortsetter å fungere. To endringer er valgfrie:

• Legg til en [duckdb]-seksjon hvis databasetilkoblinger skal bruke digna Engine og standardverdiene ikke passer for verten din.
• Utelat [app]-seksjonen hvis en omvendt proxy serverer dashboardet og backend under samme 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'

Trinn 5: Last inn webserveren på nytt¶

Dashboardet er et sett med statiske filer, så webserveren din — og nettleseren — kan fortsatt levere den forrige versjonen. Last inn på nytt eller start på nytt den webserveren som er vert for dashboard-mappen, og last deretter inn siden på nytt med en hard oppdatering (Cmd+Shift+R).

Trinn 6: Valider konfigurasjonen¶

Bekreft at config.toml er fullstendig før du rører repositoriet:

./digna config check

Hver seksjon må rapportere OK. Rett alt som rapporteres som FAILED, fjern nøklene som vises under Unknown keys, og kjør kommandoen på nytt før du går videre.

Trinn 7: Erstatt lisensfilen¶

En lisensfil følger normalt med fra én utgivelse til den neste. Release 2026.11 er et unntak: den legger til to lisensierte moduler, digna Data Reconciliation og digna Agentic, og en lisens utstedt før 2026.11 inneholder dem ikke. Kopier license.toml som digna-teamet har levert for Release 2026.11, til installasjonskatalogen, slik at den erstatter den gamle:

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

./digna license check

Trinn 8: Oppgrader repository-skjemaet¶

Kjør i digna-installasjonskatalogen:

cd /opt/digna
./digna repo upgrade

Release 2026.11 håndterer repository-skjemaet med versjonerte migreringer. Den første oppgraderingen fra en tidligere utgivelse bringer skjemaet til siste versjon av den tidligere ordningen, registrerer dette som utgangspunkt og bruker deretter migreringene i Release 2026.11. Den avslutter med:

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

Alle eksisterende data bevares. For å se tilstanden til repositoriet når som helst, kjør ./digna repo check: den viser den sist anvendte migreringen og eventuelle ventende migreringer.

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

Trinn 9: Start tjenestene på nytt¶

Hvis du kjører som en bakgrunnstjeneste:

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

Hvis du kjører manuelt, start serveren på nytt:

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

Hvis du bruker nginx eller Apache, start den aktuelle webserveren på nytt:

brew services restart nginx

sudo apachectl restart

Trinn 10: Verifiser oppgraderingen¶

1. Bekreft utgivelsen til den nye kjørbare filen:

   ./digna version
   

   Den første linjen må være Release: 2026.11.

2. Åpne digna-dashboardet og bekreft at grensesnittet lastes inn riktig.

3. Sjekk serverutdataene og filene i logs-katalogen for feil.
4. Test databasetilkoblingene dine — se Teste en tilkobling. Etter en oppgradering fra en utgivelse før 2026.06 legger du først om hver tilkobling som ikke allerede brukte ODBC, til ODBC.

For å komme i gang med de nye modulene, se digna Data Reconciliation, Koble til en AI-agent for digna MCP Server, og Profileringssted for digna Engine.