Linux-installationsvejledning for digna Release 2026.06¶

Release: 2026.06

Sidst opdateret: 5. september 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:

• dignabackend: Applikationens kerne­motor, ansvarlig for databehandling og kvalitetstjek.
• 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.06¶

Denne release bringer dataobservabilitet direkte ind i din kode, så udviklere kan overvåge datakvalitet ved kilden. Se release notes for fulde detaljer.

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)
6. config.toml — Konfigurationsfil
7. license.toml — Licensfil (kopiér din fil her)

For at udpakke fra shell:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.06-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 digna-backend applikationsindstillinger:

[app]
digna_APP_HOST = "localhost"
digna_APP_PORT = 8082
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] 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!"

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

[base] Sektion¶

Denne sektion indeholder sikkerheds- og cookie-indstillinger:

[base]
digna_FERNET_KEY = "your-fernet-key"
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

[logging] Sektion¶

Denne sektion konfigurerer logningsadfærd:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Trin 2: 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

Du bør se en bekræftelse på, at forbindelsen er etableret (selve repositoriet er endnu ikke initialiseret).

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

Trin 3: Installer repository-schemaet¶

I samme mappe, kør:

./digna repo install

Denne kommando installerer de nødvendige tabeller og schema i din PostgreSQL-database.

Trin 4: Start digna-serveren¶

I digna-installationsmappen, start serveren med:

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

Parametre: - --address — Serverens hostname/IP - --port — Serverport

Du bør se opstartsbeskeder, der bekræfter, at serveren kører:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

sudo ufw allow 8082/tcp

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

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 <username> "<full_name>" <password> --su

Eksempel:

./digna user add admin "Admin User" 'AdminPassword123!' --su

Dette opretter en bruger med brugernavnet admin og fulde administrative rettigheder.

Dashboard-konfiguration¶

Trin 1: Deploy dashboard til webserver¶

Digna-dashboardet har sin egen separate config.toml-fil placeret i dashboard/-mappen. Denne konfiguration medfølger og kræver normalt ikke ændringer under initial opsætning. Du skal kun ændre den, hvis du vil tilpasse backend-forbindelsen.

Hvis du skal modificere dashboard-konfigurationen (fx ved multi-instance deployment), se dashboardets dokumentation.

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¶

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

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: Backup af nuværende backend-installation¶

I din digna-installationsmappe:

cd /opt/digna
sudo mv digna digna_old

sudo mv dashboard dashboard_old

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

Trin 5: Opgrader repository-schemaet¶

Gå til din digna-installationsmappe og kør:

cd /opt/digna
./digna repo upgrade

Dette opdaterer PostgreSQL-schemaet til den nyeste version samtidig med, at alle eksisterende data bevares.

Trin 6: 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 7: Bekræft opgraderingen¶

1. Tilgå digna-dashboardet
2. Bekræft, at interfacet indlæses korrekt
3. Tjek serverloggene for eventuelle fejl:

sudo journalctl -u digna -n 100