Windows-installationsguide för digna Release 2026.06¶

Release: 2026.06

Senast uppdaterad: 30 augusti 2026

Innehållsförteckning¶

1. Introduktion
2. Systemkrav
3. Förberedelser inför installation
4. PostgreSQL-serverinställning
5. Webbserverkonfiguration
6. Första installationen
7. Backendkonfiguration
8. Dashboardkonfiguration
9. Köra digna som Windows-tjänst
10. Uppgradera till en ny release

Introduktion¶

Om digna¶

digna är en omfattande AI-driven plattform utformad för att optimera hanteringen av datakvalitet över olika data-miljöer såsom datalager, data lakes och lakehouses. Byggd för att vara mycket skalbar och anpassningsbar, adresserar digna moderna datautmaningar genom automation, realtidsövervakning och anomalidetektion.

digna består av två huvudkomponenter:

• digna: applikationens kärna, ansvarig för att bearbeta data och utföra kvalitetskontroller. Den förenar backend och kommandoradsgränssnittet i en enda körbar fil och ersätter därmed de separata programmen dignabackend och dignacli från tidigare releaser.
• dignadashboard: Ett webbaserat gränssnitt hostat på en webbserver, som ger ett användarvänligt sätt att interagera med digna-plattformen och visualisera datakvalitetsmått.

Nytt i Release 2026.06¶

Denna release för in data-observability-funktioner direkt i din kod, vilket gör det möjligt för utvecklare att övervaka datakvalitet vid källan. Se release notes för fullständiga detaljer.

Letar du efter macOS eller Linux?¶

Denna guide täcker Windows. För andra plattformar, se macOS-installationsguide eller Linux-installationsguide.

Systemkrav¶

Innan du påbörjar installationen, se till att ditt system uppfyller följande minimikrav:

Alternativ för databasinstallation¶

Om PostgreSQL redan är installerat: Du kan lägga till en ny databas för digna i din befintliga PostgreSQL-server.

Om PostgreSQL installeras på samma maskin som digna:

Förberedelser inför installation¶

Innan du installerar digna, se till att två viktiga förutsättningar är på plats:

1. PostgreSQL Server – för att lagra beräknade mått och prestandadata
2. Webbserver – för att hosta digna Dashboard

Om dessa komponenter inte redan är uppsatta, följ avsnitten nedan för att installera och konfigurera dem.

PostgreSQL-serverinställning¶

Om du redan har PostgreSQL¶

Om PostgreSQL redan är installerat och körs på din lokala maskin eller om du använder en hanterad fjärr-PostgreSQL-server, kan du hoppa till nästa avsnitt.

Installera PostgreSQL¶

Följ dessa steg för att installera PostgreSQL på Windows:

Steg 1: Ladda ner PostgreSQL¶

1. Besök PostgreSQL:s nedladdningssida
2. Välj Windows
3. Ladda ner den senaste installatören

Steg 2: Kör installatören¶

1. Dubbelklicka på den nedladdade installatörsfilen
2. Följ anvisningarna i installationsguiden

Steg 3: Välj installationskatalog¶

Välj katalog där PostgreSQL ska installeras. Standardplatsen är vanligtvis lämplig.

Steg 4: Välj komponenter¶

För en standardinstallation, behåll standardvalen av komponenter.

Steg 5: Ange lösenord för PostgreSQL-superanvändaren¶

Ange och bekräfta ett lösenord för PostgreSQL-superanvändaren (postgres). Spara detta lösenord säkert — du kommer att behöva det senare.

Steg 6: Konfigurera portnummer¶

Standardporten för PostgreSQL är 5432. Du kan använda standardporten eller ange en annan port vid behov.

Steg 7: Välj locale¶

Välj locale för din databas. Standardinställningen är vanligtvis lämplig för de flesta installationer.

Steg 8: Slutför installationen¶

Klicka Next genom återstående steg och sedan Finish.

Steg 9: Verifiera installationen¶

Öppna Kommandotolken och verifiera att PostgreSQL är installerat:

psql --version

Du bör se PostgreSQL-versionen om installationen lyckades.

Webbserverkonfiguration¶

digna kräver en webbserver för att hosta dashboarden. Välj ett av följande alternativ:

• Internet Information Services (IIS)
• Apache Tomcat

Du behöver endast installera och konfigurera en av dessa servrar.

IIS-inställning¶

Översikt¶

Internet Information Services (IIS) är Microsofts webbserver för att hosta webbplatser och webbaserade applikationer.

Aktivera IIS¶

1. Öppna Kontrollpanelen
2. Tryck Win + R

3. Skriv control och tryck Enter

4. Gå till Windows-funktioner

5. Klicka Programs

6. Välj Turn Windows features on or off

7. Aktivera Internet Information Services

8. Scrolla ner och hitta Internet Information Services (IIS)
9. Markera kryssrutan för att aktivera den

10. Klicka på + för att expandera och verifiera att dessa underkomponenter är valda:

    • Web Management Tools
    • World Wide Web Services

11. Klicka OK för att tillämpa ändringarna

12. Verifiera IIS-installationen

13. Öppna din webbläsare
14. Navigera till http://localhost
15. Du bör se IIS välkomstsida

Krävs: URL Rewrite-modulen¶

IIS kräver URL Rewrite-komponenten. Ladda ner och installera den från officiella Microsoft-sidan.

Krävs: MIME-typ för Markdown-filer¶

För att säkerställa att Markdown-filer (.md) serveras korrekt av IIS:

1. Öppna IIS Manager (tryck Win + R, skriv inetmgr, tryck Enter)
2. Navigera till Din webbplats > MIME Types
3. Klicka Add...
4. Konfigurera:
5. File name extension: .md
6. MIME type: text/markdown

Apache Tomcat-inställning¶

Översikt¶

Apache Tomcat är en öppen källkods Java-servlet-container och webbserver.

Installation¶

1. Ladda ner Apache Tomcat
2. Besök Apache Tomcat Downloads

3. Ladda ner Windows ZIP-distributionen

4. Packa upp arkivet

5. Packa upp ZIP-filen till en katalog på din maskin

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

7. Verifiera att Tomcat körs

8. Öppna din webbläsare
9. Navigera till http://localhost:8080
10. Du bör se Apache Tomcat välkomstsida

Första installationen¶

Steg 1: Konfigurera digna-repositoryt¶

digna-repositoryt lagrar alla mått som beräknas av digna. Det fungerar som den centrala databasen för analytiska och prestandadata.

Skapa schema och användare för repositoryt¶

Öppna din PostgreSQL-klient (pgAdmin, psql eller liknande) och kör följande SQL-kommandon:

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

Ersätt följande platshållare:

• <digna_repo_schema> — Ditt önskade schema-namn (t.ex. dignarepo)
• <digna_repo_user> — Ditt önskade användarnamn (t.ex. digna_user)
• <digna_repo_password> — Ett säkert lösenord för denna användare

Exempel:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Steg 2: Packa upp digna-installationspaketet¶

1. Lokalisera digna-installations-ZIP-filen som tillhandahållits till dig
2. Packa upp den till önskad installationsplats
3. Efter uppackning bör du se följande objekt:
4. dashboard/ — Webbgränssnittet
5. digna — Huvudexekverbara filen (backend + CLI kombinerat)

Steg 3: Installera licensfilen¶

1. Lokalisera license.toml-filen som tillhandahållits till dig
2. Kopiera den till root i digna-installationskatalogen (där config.toml och den körbara digna-filen finns)

Varför detta är viktigt: Licensfilen innehåller din kundinformation, licensens utgångsdatum och digital signatur. Ändra inte filen — eventuella ändringar gör den ogiltig.

Katalogstruktur efter setup:

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

Backendkonfiguration¶

Steg 1: Skapa och redigera konfigurationsfilen¶

Filen config_template.toml levereras i din digna-installationskatalog. Du behöver bara byta namn på den till config.toml.

Plats: digna_installation/config.toml

Öppna config.toml i en textredigerare och konfigurera varje avsnitt nedan.

Avsnittet [app]¶

Detta avsnitt konfigurerar digna-backendens applikationsinställningar:

[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 = ["*"]

Avsnittet [repo]¶

Detta avsnitt konfigurerar anslutningen till 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!"

Avsnittet [base]¶

Detta avsnitt innehåller säkerhets- och cookie-inställningar:

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

Avsnittet [encryption]¶

Detta avsnitt innehåller nyckeln som används för att kryptera känsliga värden i repositoryt. Det är obligatoriskt — config check rapporterar sektionen [encryption] som FAILED om nyckeln saknas.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Avsnittet [logging]¶

Detta avsnitt konfigurerar loggningen:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Steg 2: Validera konfigurationen¶

Kontrollera att config.toml är fullständig och korrekt uppbyggd innan du initierar repositoryt. Kör i din digna-installationskatalog:

digna config check

Varje sektion valideras för sig, så att ett enskilt fel inte döljer tillståndet hos de övriga:

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

Åtgärda allt som rapporteras som FAILED och kör kommandot igen innan du fortsätter. Den fullständiga listan över alternativ finns i CLI-referensen.

Steg 3: Initiera repositoryt¶

1. Öppna Kommandotolken
2. Navigera till din digna-installationskatalog (där config.toml och den körbara digna-filen finns)
3. Kör anslutningstestet:

digna repo check

Du bör se en bekräftelse på att anslutningen upprättats (själva repositoryt har ännu inte initialiserats).

Steg 4: Installera repositoryschemat¶

I samma katalog, kör:

digna repo install

Detta kommando installerar nödvändiga tabeller och schema i din PostgreSQL-databas.

Steg 5: Skapa en admin-användare¶

1. Öppna ett nytt Kommandotolksfönster
2. Navigera till din digna-installationskatalog
3. Kör följande kommando för att skapa en admin-användare:

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

Exempel:

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

Detta skapar en användare med fullständiga administrativa privilegier.

Steg 6: Starta digna-servern¶

I digna-installationskatalogen, starta servern med:

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

Parametrar: - --address — Serverns hostname/IP - --port — Serverns port

Du bör se startmeddelanden som bekräftar att servern körs:

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

Dashboardkonfiguration¶

Steg 1: Distribuera dashboarden till webbservern¶

digna-dashboarden läser sin egen konfiguration från dashboard/dashboard_config.toml. Den filen medföljer inte installationen — du skapar den i katalogen dashboard/ bredvid dashboardfilerna.

Dess innehåll beskrivs under Enkel inloggning (SSO), som också är där filen behövs: den innehåller de inloggningsalternativ som dashboarden erbjuder och, vid uppsättningar med flera instanser, backend-anslutningen.

Välj din webbserver och följ motsvarande deploy-steg.

Distribuera till IIS¶

1. Öppna IIS Manager

2. Tryck Win + R, skriv inetmgr, tryck Enter

3. Skapa en ny webbplats

4. I vänster panel, högerklicka på Sites

5. Välj Add Website...

6. Konfigurera webbplatsen

7. Site Name: Ange ett namn (t.ex. "dignaDashboard")
8. Physical Path: Klicka Browse och välj din dashboard-mapp

9. Binding: Ställ in IP-adress och port (standardport 80 för HTTP, 443 för HTTPS)

10. Starta webbplatsen

11. Klicka OK för att skapa webbplatsen

12. Högerklicka på den nya webbplatsen och välj Start

13. Testa installationen

14. Öppna din webbläsare
15. Navigera till http://localhost (eller din konfigurerade URL)
16. Du bör se digna-dashboardens inloggningssida

Distribuera till Apache Tomcat¶

1. Kopiera dashboard till Tomcat
2. Kopiera dashboard-mappen till din Tomcat webapps-katalog
3. Byt namn vid behov (t.ex. till digna)

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

5. Verifiera distributionen

6. Uppdatera eller ladda om Tomcat-hanteringssidan (http://localhost:8080)

7. Du bör se "digna" (eller ditt valda namn) listad bland distribuerade applikationer

8. Öppna dashboarden

9. Öppna din webbläsare
10. Navigera till http://localhost:8080/digna
11. Du bör se digna-dashboardens inloggningssida

Köra digna som Windows-tjänst¶

Varför använda en Windows-tjänst?¶

Att köra digna-backend som en Windows-tjänst säkerställer att den: - Startar automatiskt när servern bootar - Körs i bakgrunden utan öppen Kommandotolk - Startar om automatiskt om den kraschar - Kan hanteras via Windows Services

Kommandona windows¶

Tjänsten hanteras av den körbara filen digna själv, via underkommandona digna windows. Det finns inga batch-filer att köra.

Varje kommando accepterar --name för att adressera en tjänst som registrerats under ett annat namn än standardnamnet. Den fullständiga listan över alternativ finns i CLI-referensen.

Installera tjänsten¶

1. Öppna Kommandotolken som administratör
2. Högerklicka på Kommandotolken

3. Välj "Run as Administrator"

4. Navigera till din digna-installationskatalog

   cd C:\path\to\digna
   

5. Registrera tjänsten

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Tjänsten registreras med automatisk start, så den startar tillsammans med Windows. Den startar inte omedelbart — se nästa avsnitt.

Installationsalternativ¶

Starta och stoppa tjänsten¶

Starta tjänsten¶

digna windows start

Stoppa tjänsten¶

digna windows stop

Flytta tjänsten till en ny katalog¶

Om du behöver flytta digna-installationen:

1. Stoppa och avregistrera den nuvarande tjänsten

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

2. Flytta applikationsfilerna

3. Flytta hela digna-installationsmappen till den nya platsen

4. Registrera tjänsten igen från den nya platsen

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

Upprepa de värden för --address, --port eller --account som du använde första gången — den tidigare registreringen är borta.

1. Starta tjänsten

   digna windows start
   

Avinstallera tjänsten¶

1. Stoppa den körande tjänsten

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

2. Avregistrera tjänsten

   digna windows uninstall
   

digna-servern är nu avregistrerad som en Windows-tjänst.

Uppgradera till en ny release¶

Innan du uppgraderar¶

Verifiera alla databasanslutningar först

Från Release 2026.06 når digna varje källteknologi via ODBC. Tidigare releaser erbjöd ett val mellan en teknikspecifik drivrutin och ODBC, via omkopplaren Use ODBC. digna-teamet har valt att bygga enbart på ODBC, eftersom ett enda standardiserat gränssnitt ger mer än en uppsättning skräddarsydda drivrutiner:

• Autentisering — autentisering är en del av ODBC, så en anslutning kan använda allt som dess drivrutin stöder: lösenord, tokens och PAT:ar, Kerberos och Active Directory, MFA och webbläsarbaserad enkel inloggning, molnidentiteter, klientcertifikat och TLS. Nya metoder kommer med en uppdatering av drivrutinen i stället för att vänta på en digna-release.
• Drivrutiner som underhålls av databasleverantörerna — leverantörens egen drivrutin följer nya serverversioner och säkerhetsfixar, och du kan uppdatera den enligt ditt eget schema, oberoende av digna.
• Ett enda sätt att konfigurera allt — varje teknik är en lista med nyckel/värde-egenskaper, med samma gränssnitt, samma kryptering av känsliga värden och samma felsökning, i stället för olika fält per källa.
• Finjustering och räckvidd — drivrutinsalternativ som timeouts, TLS-inställningar, proxyservrar och hämtningsstorlekar är tillgängliga för varje källa, och varje teknik med en kompatibel ODBC-drivrutin kan anslutas, även sådana som digna inte publicerar någon egen guide för.

I praktiken innebär detta att omkopplaren Use ODBC och de separata fälten för värd, port, databas, användare och lösenord inte längre finns. Varje anslutning som inte redan använder ODBC måste läggas om till ODBC — det finns ingen automatisk konvertering, så planera för detta före uppgraderingen:

1. Gå igenom varje databasanslutning som är definierad i din installation och notera vilka som ännu inte använder ODBC — var och en av dem måste konfigureras om.
2. Installera motsvarande ODBC-drivrutin på digna-värden — anslutningar öppnas från den server som kör digna-backend, inte från webbläsaren. Se Installera ODBC-drivrutinen på digna-värden.
3. Ha ODBC-egenskaperna redo för varje berörd anslutning. Teknikguiderna listar en beprövad uppsättning egenskaper per källa.

Efter uppgraderingen lägger du om varje berörd anslutning till ODBC och testar den från dashboarden — se Skapa en databasanslutning och Testa en anslutning.

Det är obligatoriskt att säkerhetskopiera digna-repositoryt

Innan du uppgraderar digna, säkerhetskopiera ditt repository (PostgreSQL) för att skydda mot dataförlust. En backup säkerställer att du kan återställa om uppgraderingen stöter på oväntade problem.

Uppgraderingsprocess¶

Steg 1: Stoppa och avregistrera den gamla tjänsten¶

Om digna körs som en Windows-tjänst, stoppa den med batch-filerna i din nuvarande installation — kommandona digna windows hör till den nya releasen och är ännu inte tillgängliga:

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

Avregistrera sedan tjänsten, även här med den gamla batch-filen. Registreringen pekar på den gamla körbara filen och dess skript, som båda ersätts av den här uppgraderingen, så den kan inte återanvändas:

uninstall_service.bat

Steg 2: Säkerhetskopiera nuvarande installation¶

Byt namn på mapparna i din nuvarande installation i digna-installationskatalogen, så att den nya releasen kan distribueras vid sidan av 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

Steg 3: Packa upp och distribuera den nya versionen¶

1. Packa upp den nya digna-installations-ZIP-filen
2. Kopiera den nya digna-exekverbara filen och dashboard-mappen till din installationskatalog

Steg 4: Återställ dina 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'

Steg 5: Ladda om webbservern¶

Dashboarden är en uppsättning statiska filer, så din webbserver — och webbläsaren — kan fortfarande leverera den tidigare versionen. Ladda om eller starta om den webbserver som är värd för mappen dashboard och ladda sedan om sidan med en hård uppdatering (Ctrl+F5).

Steg 6: Validera konfigurationen¶

Kontrollera att den uppdaterade config.toml är fullständig innan du rör repositoryt:

digna config check

Varje sektion måste rapportera OK. Åtgärda allt som rapporteras som FAILED och kör kommandot igen innan du fortsätter.

Steg 7: Ersätt licensfilen¶

Varje release licensieras separat. Kopiera den license.toml som digna-teamet tillhandahållit för denna release till installationskatalogen och ersätt den gamla:

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

digna license check

Steg 8: Uppgradera repositoryschemat¶

Navigera till din digna-installationskatalog och kör:

digna repo upgrade

Detta uppdaterar PostgreSQL-schemat till senaste versionen samtidigt som all befintlig data bevaras.

Steg 9: Registrera och starta tjänsten¶

Den gamla registreringen togs bort i steg 1, så tjänsten registreras på nytt — den här gången med den körbara filen digna, som inte har några batch-filer:

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

Ge --address och --port de värden som den gamla tjänsten lyssnade på, om du inte vill ha de nya standardvärdena 127.0.0.1 och 8000; de sparas i registreringen och läses inte längre från config.toml. Lägg till --account och --password om den gamla tjänsten kördes under ett domänkonto. Se Köra digna som Windows-tjänst för den fullständiga listan över alternativ.

Om du kör manuellt, starta om servern:

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

Om du använder IIS eller Tomcat, starta om respektive webbserver.

Steg 10: Verifiera uppgraderingen¶

1. Öppna digna-dashboarden
2. Verifiera att gränssnittet laddar korrekt
3. Kontrollera serverloggarna efter eventuella fel
4. Lägg om varje anslutning som ännu inte använde ODBC till ODBC och testa sedan alla anslutningar — se Testa en anslutning