Windows-installationsvejledning for digna Release 2026.06¶

Release: 2026.06

Senest opdateret: 30. august 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 Windows-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 såsom warehouses, lakes og lakehouses. Bygget til at være meget skalerbar og tilpasningsdygtig, adresserer digna moderne dataudfordringer gennem automatisering, realtidsmonitorering 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.06¶

Denne release bringer dataobservabilitet direkte ind i din kode, hvilket gør det muligt for udviklere at overvåge datakvalitet ved kilden. Se udgivelsesnoterne for fulde detaljer.

Leder du efter macOS eller Linux?¶

Denne vejledning dækker Windows. For andre platforme, se macOS-installationsvejledningen eller Linux-installationsvejledningen.

Systemkrav¶

Før du påbegynder installationen, skal du sikre dig, at dit system opfylder følgende minimumskrav:

Databaseinstallationsmuligheder¶

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

Hvis du installerer PostgreSQL på samme maskine som digna:

Forberedende opsætning¶

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

1. PostgreSQL Server – til lagring af beregnede målinger og ydelsesdata
2. Webserver – til hosting af digna Dashboard

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

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 videre til næste afsnit.

Installation af PostgreSQL¶

Følg disse trin for at installere PostgreSQL på Windows:

Trin 1: Download PostgreSQL¶

1. Besøg PostgreSQL Downloads page
2. Vælg Windows
3. Download den nyeste installer

Trin 2: Kør installatøren¶

1. Dobbeltklik på den downloadede installerfil
2. Følg anvisningerne i installationsguiden

Trin 3: Vælg installationsmappe¶

Vælg den mappe, hvor PostgreSQL skal installeres. Standardplaceringen er som regel passende.

Trin 4: Vælg komponenter¶

For en standardopsætning beholdes de forvalgte komponenter.

Trin 5: Angiv PostgreSQL-superbrugerens adgangskode¶

Indtast og bekræft en adgangskode for PostgreSQL-superbrugeren (postgres). Gem denne adgangskode sikkert — du får brug for den senere.

Trin 6: Konfigurer portnummer¶

Standardporten for PostgreSQL er 5432. Du kan bruge standarden eller angive en anden port efter behov.

Trin 7: Vælg lokalitet (locale)¶

Vælg lokalitet for din database. Standardindstillingen er som regel passende for de fleste installationer.

Trin 8: Afslut installation¶

Klik Næste gennem de resterende trin, og klik derefter Finish.

Trin 9: Bekræft installation¶

Åbn Kommandoprompt og verificer, at PostgreSQL er installeret:

psql --version

Du burde se PostgreSQL-versionen, hvis installationen var vellykket.

Webserverkonfiguration¶

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

• Internet Information Services (IIS)
• Apache Tomcat

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

IIS-opsætning¶

Oversigt¶

Internet Information Services (IIS) er Microsofts webserver til hosting af websites og webapplikationer.

Aktivering af IIS¶

1. Åbn Kontrolpanel
2. Tryk Win + R

3. Skriv control og tryk Enter

4. Gå til Windows-funktioner

5. Klik Programmer

6. Vælg Slå Windows-funktioner til eller fra

7. Aktivér Internet Information Services

8. Rul ned og find Internet Information Services (IIS)
9. Sæt flueben for at aktivere det

10. Klik på + for at udvide og verificere, at disse underkomponenter er valgt:

    • Web Management Tools
    • World Wide Web Services

11. Klik OK for at anvende ændringerne

12. Bekræft IIS-installation

13. Åbn din browser
14. Naviger til http://localhost
15. Du bør se IIS Velkomstsiden

Påkrævet: URL Rewrite-modulet¶

IIS kræver URL Rewrite-komponenten. Download og installer det fra den officielle Microsoft-side.

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

For at sikre, at Markdown-filer (.md) serveres korrekt af IIS:

1. Åbn IIS Manager (tryk Win + R, skriv inetmgr, tryk Enter)
2. Naviger til Your Site > MIME Types
3. Klik Add...
4. Konfigurer:
5. File name extension: .md
6. MIME type: text/markdown

Apache Tomcat-opsætning¶

Oversigt¶

Apache Tomcat er en open-source Java servlet-container og webserver.

Installation¶

1. Download Apache Tomcat
2. Besøg Apache Tomcat Downloads

3. Download Windows ZIP-distributionen

4. Udpak arkivet

5. Udpak ZIP-filen til en mappe på dit system

6. Eksempel: C:\Program Files\Apache Tomcat

7. Bekræft, at Tomcat kører

8. Åbn din browser
9. Naviger til http://localhost:8080
10. Du bør se Apache Tomcat velkomstsiden

Initial installation¶

Trin 1: Opret digna-repositoriet¶

Digna-repositoriet gemmer alle målinger beregnet af digna. Det fungerer som den centrale database for analytiske og ydelsesdata.

Opret repositorieschema og bruger¶

Åbn din PostgreSQL-klient (pgAdmin, psql 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 schemanavn (f.eks. dignarepo)
• <digna_repo_user> — Dit ønskede brugernavn (f.eks. 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;

Trin 2: Udpak digna-installationspakken¶

1. Find digna-installations-ZIP-filen, der er leveret til dig
2. Udpak den til det ønskede installationssted
3. Efter udpakning bør du se følgende elementer:
4. dashboard/ — Webdashboard-interface
5. digna — Hoved-udførbar fil (backend + CLI kombineret)

Trin 3: Installer license-filen¶

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

Hvorfor det er vigtigt: License-filen indeholder dine kundeoplysninger, licensens udløbsdato og digital signatur. Rediger ikke denne fil — ændringer vil ugyldiggøre den.

Mappe struktur efter opsætning:

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

Backend-konfiguration¶

Trin 1: Opret og rediger konfigurationsfilen¶

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

Placering: digna_installation/config.toml

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

[app] Sektionen¶

Denne sektion konfigurerer digna backend-applikationens indstillinger:

[app]
digna_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
digna_APP_CORS_ALLOW_CREDENTIALS = true
digna_APP_CORS_ALLOW_METHODS = ["*"]
digna_APP_CORS_ALLOW_HEADERS = ["*"]

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

[base] Sektionen¶

Denne sektion indeholder sikkerheds- og cookie-indstillinger:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption] 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ærd:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

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

Overall: OK

Ret alt, der rapporteres som FAILED, og kør kommandoen igen, før du fortsætter. Den fulde liste over muligheder findes i CLI-referencen.

Trin 3: Initialiser repositoriet¶

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

digna repo check

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

Trin 4: 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 5: Opret en admin-bruger¶

1. Åbn et nyt Kommandoprompt-vindue
2. Skift 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 fulde administrative rettigheder.

Trin 6: Start digna-serveren¶

I digna-installationsmappen, start serveren med:

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

Parametre: - --address — Serverens hostnavn/IP - --port — Serverens port

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

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-trin nedenfor.

Deploy til IIS¶

1. Åbn IIS Manager

2. Tryk Win + R, skriv inetmgr, tryk Enter

3. Opret et nyt website

4. I venstre panel, højreklik på Sites

5. Vælg Add Website...

6. Konfigurer websitet

7. Site Name: Indtast et navn (f.eks. "dignaDashboard")
8. Physical Path: Klik Browse og vælg din dashboard-mappe

9. Binding: Sæt IP-adresse og port (standard port 80 for HTTP, 443 for HTTPS)

10. Start websitet

11. Klik OK for at oprette sitet

12. Højreklik på det nye site og vælg Start

13. Test installationen

14. Åbn din browser
15. Naviger til http://localhost (eller din konfigurerede URL)
16. Du bør se digna-dashboardets login-side

Deploy til Apache Tomcat¶

1. Kopier dashboard til Tomcat
2. Kopiér dashboard-mappen til din Tomcat webapps-mappe
3. Omdøb den om nødvendigt (f.eks. til digna)

4. Eksempel: C:\Program Files\Apache Tomcat\webapps\digna

5. Bekræft deployment

6. Opdater eller genindlæs Tomcat administrationssiden (http://localhost:8080)

7. Du bør se "digna" (eller dit valgte navn) listet under deployerede applikationer

8. Adgang til dashboardet

9. Åbn din browser
10. Naviger til http://localhost:8080/digna
11. Du bør se digna-dashboardets login-side

Kørsel af digna som en Windows-service¶

Hvorfor bruge en Windows-service?¶

At køre digna-backend som en Windows-service sikrer, at den: - Starter automatisk, når serveren booter - Kører i baggrunden uden et åbent Kommandoprompt-vindue - Genstarter automatisk, hvis den crasher - Kan administreres via Windows Services

windows-kommandoerne¶

Servicen administreres af selve den eksekverbare digna-fil via underkommandoerne digna windows. Der er ingen batch-filer at køre.

Hver kommando accepterer --name for at adressere en service, der er registreret under et ikke-standardnavn. Den fulde liste over indstillinger findes i CLI-referencen.

Installation af servicen¶

1. Åbn Kommandoprompt som Administrator
2. Højreklik på Kommandoprompt

3. Vælg "Kør som administrator"

4. Skift til din digna-installationsmappe

   cd C:\path\to\digna
   

5. Registrer servicen

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Servicen registreres med automatisk opstart, så den starter sammen med Windows. Den starter ikke umiddelbart — se næste afsnit.

Installationsindstillinger¶

Start og stop af servicen¶

For at starte servicen¶

digna windows start

For at stoppe servicen¶

digna windows stop

Flytning af servicen til en ny mappe¶

Hvis du skal flytte digna-installationen:

1. Stop og afregistrer den nuværende service

   cd C:\old\path\digna
   digna windows stop
   digna windows uninstall
   

2. Flyt applikationsfilerne

3. Flyt hele digna-installationsmappen til den nye placering

4. Registrer servicen igen fra den nye placering

   cd C:\new\path\digna
   digna windows install
   

Gentag de værdier for --address, --port eller --account, du brugte første gang — den tidligere registrering er væk.

1. Start servicen

   digna windows start
   

Afinstallation af servicen¶

1. Stop den kørende service

   cd C:\path\to\digna
   digna windows stop
   

2. Afregistrer servicen

   digna windows uninstall
   

Digna-serveren er nu fjernet som en Windows-service.

Opgradering til en ny release¶

Før du opgraderer¶

Verificér alle databaseforbindelser først

Fra Release 2026.06 når digna hver kildeteknologi via ODBC. Tidligere releases gav et valg mellem en teknologispecifik driver og ODBC, valgt med kontakten Use ODBC. digna-teamet har besluttet udelukkende at bygge på ODBC, fordi én enkelt standardgrænseflade giver mere end et sæt skræddersyede drivere:

• Godkendelse — godkendelse er en del af ODBC, så en forbindelse kan bruge alt, hvad dens driver understøtter: adgangskoder, tokens og PAT'er, Kerberos og Active Directory, MFA og browserbaseret single sign-on, cloud-identiteter, klientcertifikater og TLS. Nye metoder kommer med en driveropdatering i stedet for at vente på en digna-release.
• Drivere, der vedligeholdes af databaseleverandørerne — leverandørens egen driver følger nye serverversioner og sikkerhedsrettelser, og du kan opdatere den efter din egen plan, uafhængigt af digna.
• Én måde at konfigurere alt på — hver teknologi er en liste af nøgle/værdi-egenskaber, med samme grænseflade, samme kryptering af følsomme værdier og samme fejlfinding, i stedet for forskellige felter pr. kilde.
• Finjustering og rækkevidde — driverindstillinger som timeouts, TLS-indstillinger, proxyer og fetch-størrelser er tilgængelige for alle kilder, og enhver teknologi med en kompatibel ODBC-driver kan tilsluttes, også dem digna ikke udgiver en særskilt vejledning til.

I praksis betyder det, at kontakten Use ODBC og de separate felter til vært, port, database, bruger og adgangskode ikke længere findes. Enhver forbindelse, der ikke allerede bruger ODBC, skal lægges om til ODBC — der er ingen automatisk konvertering, så planlæg det før opgraderingen:

1. Gennemgå hver databaseforbindelse, der er defineret i din installation, og notér, hvilke der endnu ikke bruger ODBC — hver enkelt skal konfigureres om.
2. Installér den tilsvarende ODBC-driver på digna-værten — forbindelser åbnes fra den server, der kører digna-backend, ikke fra browseren. Se Installér ODBC-driveren på digna-værten.
3. Hav ODBC-egenskaberne klar for hver berørt forbindelse. Teknologivejledningerne angiver et gennemprøvet sæt egenskaber pr. kilde.

Efter opgraderingen lægger du hver berørt forbindelse om til ODBC og tester den fra dashboardet — se Opret en databaseforbindelse og Test en forbindelse.

Det er obligatorisk at lave en backup af digna-repositoriet

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

Opgraderingsproces¶

Trin 1: Stop og afregistrer den gamle service¶

Hvis digna kører som Windows-service, stop den med batch-filerne fra din nuværende installation — digna windows-kommandoerne hører til den nye release og er endnu ikke tilgængelige:

cd C:\path\to\digna\bin
stop_service.bat

Afregistrer derefter servicen, igen med den gamle batch-fil. Registreringen peger på den gamle eksekverbare fil og dens scripts, som begge udskiftes ved denne opgradering, så den kan ikke genbruges:

uninstall_service.bat

Trin 2: Sikkerhedskopiér nuværende installation¶

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

Trin 3: Udpak og deploy ny version¶

1. Udpak den nye digna-installations-ZIP-fil
2. Kopiér den nye digna-eksekverbare fil og dashboard-mappen til din installationsmappe

Trin 4: Gendan dine konfigurationsfiler¶

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

[oidc_clients.microsoft]
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

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 den opdaterede 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, og kør kommandoen igen, før du fortsætter.

Trin 7: Udskift licensfilen¶

Hver release licenseres separat. Kopiér den license.toml, som digna-teamet har leveret til denne release, til installationsmappen, så den erstatter den gamle:

copy /Y C:\path\to\new\license.toml license.toml

digna license check

Trin 8: Opgrader repository-schemaet¶

Naviger til din digna-installationsmappe og kør:

digna repo upgrade

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

Trin 9: Registrer og start servicen¶

Den gamle registrering blev fjernet i Trin 1, så servicen registreres igen — denne gang med den eksekverbare digna-fil, som ikke har nogen batch-filer:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

Giv --address og --port de værdier, den gamle service kørte på, medmindre du ønsker de nye standardværdier 127.0.0.1 og 8000; de gemmes i registreringen og læses ikke længere fra config.toml. Tilføj --account og --password, hvis den gamle service kørte under en domænekonto. Se Kørsel af digna som en Windows-service for den fulde liste over indstillinger.

Hvis du kører manuelt, genstart serveren:

cd C:\path\to\digna
digna serve --address <address> --port <port>

Hvis du bruger IIS eller Tomcat, genstart den pågældende webserver.

Trin 10: Bekræft opgraderingen¶

1. Åbn digna-dashboardet
2. Bekræft, at interfacet loader korrekt
3. Tjek serverens logfiler for eventuelle fejl
4. Læg hver forbindelse, der endnu ikke brugte ODBC, om til ODBC, og test derefter alle forbindelser — se Test en forbindelse