Linux-installationsvejledning for digna Release 2026.11¶

Release: 2026.11

Sidst opdateret: 7. november 2026

Indholdsfortegnelse¶

1. Introduktion
2. Systemkrav
3. Forberedende opsætning
4. PostgreSQL-serveropsætning
5. Webserverkonfiguration
6. Initial installation
7. Backend-konfiguration
8. Dashboard-konfiguration
9. Kørsel af digna som systemd-service
10. Opgradering til en ny release

Introduktion¶

Om digna¶

digna er en omfattende AI-drevet platform designet til at optimere datakvalitetsstyring på tværs af forskellige data­miljøer som warehouses, lakes og lakehouses. Bygget til høj skalerbarhed og fleksibilitet adresserer digna moderne dataudfordringer gennem automatisering, realtids­overvågning og anomali­detektion.

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.

Nyheder 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 macOS?¶

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

Hvilken distribution dækker denne vejledning?¶

Instruktionerne er skrevet for de to mest almindelige serverfamilier. Hvor de to adskiller sig, er begge kommandoer angivet:

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

Enhver moderne distribution med systemd vil fungere; kun pakkenavne og nogle få konfigurationsstier ændrer sig.

Systemkrav¶

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

Databaseinstallationsmuligheder¶

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

Hvis du installerer PostgreSQL på samme maskine som digna:

Kontrol af distribution og arkitektur¶

Flere kommandoer i denne vejledning adskiller sig mellem Debian- og RHEL-familierne. For at kontrollere hvilken du kører, kør:

cat /etc/os-release
uname -m

• ID=ubuntu eller ID=debian — brug apt-kommandoerne.
• ID=rhel, rocky, almalinux eller fedora — brug dnf-kommandoerne.
• x86_64 eller aarch64 — arkitekturen til installationspakken, du skal bruge.

Forberedende opsætning¶

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

1. PostgreSQL-server – til lagring af beregnede målinger og performance-data
2. Webserver – til hosting af digna Dashboard

Hvis disse komponenter ikke allerede er opsat, følg nedenstående afsnit for at installere og konfigurere dem.

Opdatering af pakkelisten¶

Opdater dine pakkelister, før du installerer noget:

sudo apt update

sudo dnf check-update

PostgreSQL-serveropsætning¶

Hvis du allerede har PostgreSQL¶

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

Installation af PostgreSQL¶

Trin 1: Installer serverpakken¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Trin 2: Initialiser databaseklustret¶

På Debian-familien opretter og starter pakken et cluster automatisk — spring til næste trin.

På RHEL-familien skal clustret oprettes eksplicit:

sudo postgresql-setup --initdb

Trin 3: Start og aktiver servicen¶

sudo systemctl enable --now postgresql

Dette starter PostgreSQL med det samme og konfigurerer det til automatisk start ved boot.

Trin 4: Bekræft installationen¶

psql --version
sudo systemctl status postgresql

Du bør se PostgreSQL-versionen og en active (running) service.

Trin 5: Forbind til serveren¶

En Linux PostgreSQL-pakke opretter en postgres systemkonto, som ejer clustret. Forbind via denne konto:

sudo -u postgres psql

Trin 6: Bekræft porten¶

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

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

Notér værdien — du får brug for den, når du konfigurerer digna-backend.

Trin 7: Aktivér adgangskodeautentifikation for digna-brugeren¶

digna forbinder til PostgreSQL over TCP som digna_user, hvilket kræver adgangskodeautentifikation fremfor peer. Kontroller, at din pg_hba.conf tillader det.

Find filen:

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

Åbn den i en editor og bekræft, at de lokale TCP-linjer bruger scram-sha-256 (eller md5 på ældre servere) i stedet for 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

Genindlæs PostgreSQL efter enhver ændring:

sudo systemctl reload postgresql

Trin 8: Hvis PostgreSQL kører på en anden maskine¶

For at acceptere forbindelser fra en anden vært, sæt listen_addresses i postgresql.conf og tilføj en matchende host-linje for dit netværk i pg_hba.conf:

listen_addresses = '*'

Åbn derefter porten i firewall'en og genstart servicen:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Webserverkonfiguration¶

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

• nginx — letvægt og anbefalet
• Apache httpd — bredt udbredt alternativ

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å genindlæsning af en dashboard-URL ikke giver 404
• En .md MIME-type, så Markdown-filer serveres korrekt

nginx-opsætning¶

Oversigt¶

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

Installation¶

sudo apt install -y nginx

sudo dnf install -y nginx

Start af nginx¶

sudo systemctl enable --now nginx

Bekræft installationen¶

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

Åbning af firewall¶

Hvis serveren tilgås fra andre maskiner, tillad HTTP-trafik:

sudo ufw allow 'Nginx Full'

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

Konfigurering af et site til dashboardet¶

nginx inkluderer alle filer i conf.d-mappen på begge distributionsfamilier. Opret en dedikeret konfigurationsfil til digna dér:

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

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

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

Deaktiver standardsitet¶

Kun én serverblok kan være default_server for en port. På Debian-familien fjern den pakkede default, så den ikke konflikter:

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

På RHEL-familien kommentér eller slet server { ... }-blokken inde i /etc/nginx/nginx.conf.

Anvend konfigurationen¶

Test konfigurationen for syntaksfejl, og genindlæs nginx:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd-opsætning¶

Oversigt¶

Apache httpd findes i standardlageret for alle understøttede distributioner. Pakken hedder apache2 på Debian-familien og httpd på RHEL-familien.

Installation¶

sudo apt install -y apache2

sudo dnf install -y httpd

Start af Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Bekræft installationen¶

1. Åbn din browser
2. Gå til http://localhost
3. Du bør se distributionens standard Apache-side

Krævet: Aktivér mod_rewrite¶

Dashboardet kræver URL-omskrivning.

På Debian-familien, aktivér modulet og genstart:

sudo a2enmod rewrite
sudo systemctl restart apache2

På RHEL-familien er mod_rewrite indlæst som standard. Bekræft det:

httpd -M | grep rewrite

Krævet: Tillad .htaccess-overrides¶

Åbn konfigurationsfilen for din dokumentrod:

sudo nano /etc/apache2/apache2.conf

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

Find <Directory>-blokken, der dækker din dokumentrod (/var/www/html på begge familier) og ændr:

AllowOverride None

til:

AllowOverride All

Krævet: MIME-type for Markdown-filer¶

I samme fil, tilføj følgende linje, så Markdown-filer serveres korrekt:

AddType text/markdown .md

Anvend konfigurationen¶

Tjek konfigurationen for syntaksfejl, og genstart Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Initial installation¶

Trin 1: Opret digna-repositoriet¶

digna-repositoriet lagrer alle målinger, som digna beregner. Det fungerer som den centrale database for analytiske- og performance-data.

Opret repository-schema 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> — En sikker adgangskode 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 shell i ét trin:

sudo -u postgres psql

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

Trin 2: Pak digna-installationspakken ud¶

1. Find digna-installations-ZIP-filen, som er leveret til dig
2. Pak den ud til din ønskede installationssti — for eksempel /opt/digna
3. Efter udpakning bør du se følgende elementer:
4. dashboard/ — Webdashboard-interface
5. digna — Hovedkørbar fil (backend + CLI kombineret)

For at udpakke fra shell:

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

Gør den eksekverbare fil kørbar¶

Afhængigt af hvordan arkivet blev overført, kan den eksekverbare bit være tabt under udpakning. Sæt den eksplicit:

cd /opt/digna
sudo chmod +x digna

Opret en servicekonto¶

Det anbefales at køre backend som en dedikeret uprivilegeret bruger i produktionsmiljøer:

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

Trin 3: Installer licensfilen¶

1. Find den license.toml-fil, som er leveret til dig
2. Kopiér den ind i rodinstallationsmappen for digna (hvor config.toml og den eksekverbare digna ligger)

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

Mappe­struktur efter opsætning:

/opt/digna/
├── config.toml         (konfigurationsfil)
├── license.toml        (DIN LICENSFIL - kopier her)
├── digna               (hovedkørbar fil)
├── bin/                (servicehåndteringsscripts)
└── dashboard/          (webinterface)
    └── (dashboard-filer)

Backend-konfiguration¶

Trin 1: Opret og rediger konfigurationsfilen¶

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

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

Placering: /opt/digna/config.toml

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

[app] Sektion¶

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

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

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

[base] Sektion¶

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

Denne sektion konfigurerer logningsadfærd:

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

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /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: Initialiser repositoriet¶

1. Åbn en terminal
2. Gå til din digna-installationsmappe (hvor config.toml og den eksekverbare digna er placeret)
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.

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

Trin 4: Installer repository-schemaet¶

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 adminbruger¶

1. Åbn et nyt terminalvindue
2. Gå til din digna-installationsmappe
3. Kør følgende kommando for at oprette en adminbruger:

./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 — Serverens 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

sudo ufw allow 8082/tcp

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

Dashboard-konfiguration¶

Trin 1: Deploy dashboard til webserver¶

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 deployment backend-forbindelsen.

Vælg din webserver og følg de tilsvarende deploy-trin.

Deploy til nginx¶

Hvis du fulgte nginx-opsætningen, peger serverblokken allerede på din dashboard-mappe, og ingen kopiering er nødvendig.

1. Bekræft stien
2. Åbn /etc/nginx/conf.d/digna.conf

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

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

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

5. Genindlæs nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Test installationen

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

Deploy til Apache httpd¶

1. Kopier dashboardet til dokumentroden

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

2. Tilføj omskrivningsreglerne

Opret en .htaccess-fil inde i den deployerede mappe, så dashboard-ruter overlever en browser-genindlæsning:

sudo nano /var/www/html/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 systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Tilgå dashboardet

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

Trin 2: SELinux (kun RHEL-familien)¶

På RHEL, Rocky, AlmaLinux og Fedora er SELinux som standard i enforcing-tilstand og vil blokere webserveren fra at læse filer uden for forventede placeringer. Kontroller om den er aktiv:

getenforce

Hvis resultatet er Enforcing og du servicerer dashboardet fra /opt/digna/dashboard, label mappen, så webserveren kan læse den:

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

Kørsel af digna som en systemd-service¶

Hvorfor køre digna som en service?¶

At køre digna-backend som en systemd-service sikrer, at den:

• Starter automatisk, når maskinen booter
• Kører i baggrunden uden et åbent terminalvindue
• Genstarter automatisk, hvis den crasher
• Kan administreres via systemctl, standard Linux service‑manager

Filer til servicehåndtering¶

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

Følgende shell-scripts er tilgængelige:

• install_service.sh — registrerer digna hos systemd
• uninstall_service.sh — afregistrerer servicen
• start_service.sh — starter den registrerede service
• stop_service.sh — stopper den kørende service

Gør scripts eksekverbare¶

Udpakning bevarer muligvis ikke eksekveringsrettigheder. Før første brug:

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

Installer servicen¶

1. Åbn en terminal

2. Gå til bin-mappen

   cd /opt/digna/bin
   

3. Kør installationsscriptet

   sudo ./install_service.sh
   

Digna-serveren er nu registreret hos systemd med automatisk opstart aktiveret. Servicen starter ikke nødvendigvis med det samme — se næste sektion for at starte den.

Start og stop servicen¶

For at starte servicen¶

1. Åbn en terminal
2. Gå til /opt/digna/bin
3. Kør:

   sudo ./start_service.sh
   

For at stoppe servicen¶

1. Åbn en terminal
2. Gå til /opt/digna/bin
3. Kør:

   sudo ./stop_service.sh
   

Administrer servicen med systemctl¶

Når den er registreret, kan servicen også kontrolleres med standard systemd-kommandoer fra enhver mappe:

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

Bekræft servicen¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled betyder, at servicen starter ved boot; active betyder, at den kører nu.

Vis serviceloggen¶

systemd fanger alt, backend skriver til konsollen. For at læse den:

sudo journalctl -u digna -n 100

For at følge loggen live mens du reproducerer et problem:

sudo journalctl -u digna -f

Flyt servicen til en ny mappe¶

Unit-filen gemmer den absolutte sti til den eksekverbare fil, så flytning af installationen kræver re-registrering af servicen:

1. Afinstaller den nuværende service

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

2. Flyt applikationsfilerne

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

3. Geninstaller servicen

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

4. Start servicen

   sudo ./start_service.sh
   

Afinstallation af servicen¶

1. Stop den kørende service

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

2. Afinstaller servicen

   sudo ./uninstall_service.sh
   

Digna-serveren er nu afregistreret fra systemd.

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¶

Oprettelse af backup af digna-repositoriet er obligatorisk

Før du opgraderer digna, tag en backup af dit repositorium (PostgreSQL) for at beskytte mod datatab. En backup sikrer, at du kan gendanne, hvis opgraderingen støder på uventede problemer.

For at skabe en backup fra shell:

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-servicen¶

Hvis digna kører som en systemd-service, stop den først:

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

Hvis digna kører i forgrunden, tryk Ctrl+C i terminalvinduet.

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
sudo mv digna digna_old
sudo 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 ny version¶

1. Pak den nye digna-installations-ZIP-fil ud
2. Kopiér den nye digna-eksekverbare og dashboard-mappen til din installationsmappe
3. Genskab den eksekverbare bit og ejerskab til servicekontoen:

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

Trin 4: Gendan dine konfigurationsfiler¶

sudo 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 (Ctrl+F5).

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:

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

./digna license check

Trin 8: Opgrader repository-schemaet¶

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 services¶

Hvis du kører som systemd-service:

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, genindlæs den respektive webserver:

sudo systemctl reload nginx

sudo systemctl restart apache2

På RHEL-familien, genanvend SELinux-labeling, hvis dashboard-mappen blev udskiftet:

sudo restorecon -Rv /opt/digna/dashboard

Trin 10: Bekræft 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 serverloggene for fejl:

   sudo journalctl -u digna -n 100
   

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.