Gå til innhold

Windows Installation Guide for digna Release 2026.06

Release: 2026.06

Last Updated: August 30, 2026


Table of Contents

  1. Introduksjon
  2. Systemkrav
  3. Forberedelser før installasjon
  4. PostgreSQL-serveroppsett
  5. Webserverkonfigurasjon
  6. Initial installasjon
  7. Backend-konfigurasjon
  8. Dashboard-konfigurasjon
  9. Kjøre digna som en Windows-tjeneste
  10. Oppgradering til ny utgave

Introduksjon

Om digna

digna er en omfattende AI-drevet plattform utviklet for å optimalisere styring av datakvalitet på tvers av ulike data-miljøer som warehouses, lakes og lakehouses. Bygget for høy skalerbarhet og tilpasning, adresserer digna moderne datautfordringer gjennom automatisering, sanntidsovervåking og anomali-deteksjon.

digna består av to hovedkomponenter:

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

Hva er nytt i Release 2026.06

Denne utgaven bringer dataobservability-funksjonalitet direkte inn i koden din, slik at utviklere kan overvåke datakvalitet ved kilden. Se utgivelsesnotatene for fullstendige detaljer.

Ser du etter macOS eller Linux?

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


Systemkrav

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

Krav Spesifikasjon
Operativsystem Windows Server eller Windows 10/11
Minne (Minimal oppsett) 16 GB RAM
Diskplass 10 GB tilgjengelig lagring
Database PostgreSQL Server 12 eller nyere
Webserver IIS, Apache Tomcat eller tilsvarende

Databaseinstallasjonsvalg

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

Hvis du installerer PostgreSQL på samme maskin som digna:

Anbefalte spesifikasjoner

  • Minne: 32 GB RAM (i stedet for 16 GB)
  • Diskplass: 50 GB tilgjengelig lagring (i stedet for 10 GB)

Disse høyere spesifikasjonene tar høyde for at både digna og PostgreSQL-databasen kjører samtidig.


Forberedelser før installasjon

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

  1. PostgreSQL-server – for lagring av beregnede målinger og ytelsesdata
  2. Webserver – for hosting av digna Dashboard

Hvis disse komponentene ikke allerede er satt opp, følg avsnittene nedenfor for å installere og konfigurere dem.


PostgreSQL-serveroppsett

Hvis du allerede har PostgreSQL

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

Installere PostgreSQL

Følg disse trinnene for å installere PostgreSQL på Windows:

Trinn 1: Last ned PostgreSQL

  1. Besøk PostgreSQL-nedlastingssiden
  2. Velg Windows
  3. Last ned den nyeste installasjonsfilen

Trinn 2: Kjør installasjonsprogrammet

  1. Dobbeltklikk på den nedlastede installasjonsfilen
  2. Følg instruksjonene i oppsettveiviseren

Trinn 3: Velg installasjonsmappe

Velg katalogen hvor PostgreSQL skal installeres. Standardplasseringen er normalt passende.

Trinn 4: Velg komponenter

For et standardoppsett, behold standard komponentvalg.

Trinn 5: Angi PostgreSQL-superbrukerpassord

Skriv inn og bekreft et passord for PostgreSQL-superbrukeren (postgres). Lagre dette passordet sikkert — du vil trenge det senere.

Trinn 6: Konfigurer portnummer

Standard PostgreSQL-port er 5432. Du kan bruke standard eller angi en annen port om nødvendig.

Tips

Hvis port 5432 allerede er i bruk, velg en alternativ port og noter den for senere konfigurasjon.

Trinn 7: Velg locale

Velg locale for databasen. Standard er vanligvis egnet for de fleste installasjoner.

Trinn 8: Fullfør installasjonen

Klikk Next gjennom de gjenværende trinnene, og klikk deretter Finish.

Trinn 9: Verifiser installasjonen

Åpne Kommandoprompt og verifiser at PostgreSQL er installert:

psql --version

Du bør se PostgreSQL-versjonen dersom installasjonen var vellykket.


Webserverkonfigurasjon

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

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

IIS-oppsett

Oversikt

Internet Information Services (IIS) er Microsofts webserver for hosting av nettsteder og webapplikasjoner.

Aktivere IIS

  1. Åpne Kontrollpanel
  2. Trykk Win + R
  3. Skriv control og trykk Enter

  4. Gå til Windows-funksjoner

  5. Klikk Programs
  6. Velg Turn Windows features on or off

  7. Aktiver Internet Information Services

  8. Bla ned og finn Internet Information Services (IIS)
  9. Kryss av for å aktivere den
  10. Klikk på + for å utvide og verifiser at disse underkomponentene er valgt:

    • Web Management Tools
    • World Wide Web Services
  11. Klikk OK for å anvende endringene

  12. Verifiser IIS-installasjonen

  13. Åpne nettleseren din
  14. Naviger til http://localhost
  15. Du skal se IIS velkomstside

Påkrevd: URL Rewrite-modul

IIS krever URL Rewrite-komponenten. Last ned og installer den fra Microsofts offisielle side.

Påkrevd: MIME-type for Markdown-filer

For å sikre at Markdown-filer (.md) blir servert riktig av IIS:

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

Viktig

Uten denne innstillingen kan .md-filer bli servert feil.


Apache Tomcat-oppsett

Oversikt

Apache Tomcat er en åpen kildekode Java servlet-container og webserver.

Installasjon

  1. Last ned Apache Tomcat
  2. Besøk Apache Tomcat Downloads
  3. Last ned Windows ZIP-distribusjonen

  4. Pakk ut arkivet

  5. Pakk ut ZIP-filen til en katalog på systemet ditt
  6. Eksempel: C:\Program Files\Apache Tomcat

  7. Verifiser at Tomcat kjører

  8. Åpne nettleseren din
  9. Naviger til http://localhost:8080
  10. Du skal se Apache Tomcat velkomstside

Tips

Apache Tomcat starter vanligvis automatisk etter installasjon. Hvis den ikke gjør det, gå til bin-mappen og kjør startup.bat.


Initial installasjon

Trinn 1: Sett opp digna-repositoriet

digna-repositoriet lagrer alle målinger beregnet av digna. Det fungerer som den sentrale databasen for analytiske og ytelsesrelaterte data.

Opprett repositories-skjema og bruker

Åpne din PostgreSQL-klient (pgAdmin, psql eller lignende) og kjør følgende SQL-kommandoer:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Erstatt følgende plassholdere:

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

Eksempel:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Beste praksis

Bruk sterke, komplekse passord for databasebrukere. Unngå lett gjettbare påloggingsopplysninger.


Trinn 2: Pakk ut digna-installasjonspakken

  1. Finn digna-installasjons-ZIP-filen som er levert til deg
  2. Pakk den ut til ønsket installasjonssted
  3. Etter utpakking skal du se følgende elementer:
  4. dashboard/ — Web dashboard-grensesnitt
  5. digna — Hovedkjørbar fil (backend + CLI kombinert)

Konfigurasjons- og lisensfilene er ikke med i pakken

Verken config.toml eller dashboard/dashboard_config.toml følger med installasjonen — du oppretter begge selv, i Backend-konfigurasjon og Dashboard-konfigurasjon. license.toml følger heller ikke med; digna leverer den separat, slik Trinn 3 beskriver.

Trinn 3: Installer lisensfilen

Viktig

Lisensfilen er ikke inkludert i installasjonspakken og vil bli levert separat av digna.

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

Hvorfor dette er viktig: Lisensfilen inneholder kundeinformasjon, lisensens utløpsdato og digital signatur. Ikke endre denne filen — eventuelle endringer vil gjøre den ugyldig.

Katalogstruktur etter oppsett:

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

Backend-konfigurasjon

Trinn 1: Opprett og rediger konfigurasjonsfilen

Filen config_template.toml leveres i din digna-installasjonsmappe. Du trenger kun å gi den nytt navn til config.toml.

Plassering: digna_installation/config.toml

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

[app] Seksjonen

Denne seksjonen konfigurerer innstillingene for digna-backend-applikasjonen:

[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 = ["*"]
Parameter Verdi Merknader
digna_APP_CORS_ALLOW_ORIGINS Frontend-URL Hvis dashboardet er på en annen server, inkluder dens URL
digna_APP_CORS_ALLOW_CREDENTIALS true Påkrevet for CORS med credentials
digna_APP_CORS_ALLOW_METHODS ["*"] Tillat alle HTTP-metoder
digna_APP_CORS_ALLOW_HEADERS ["*"] Tillat alle headere

[repo] Seksjonen

Denne seksjonen konfigurerer tilkoblingen til PostgreSQL-databasen:

[repo]
digna_REPO_HOST = "localhost"
digna_REPO_PORT = 5432
digna_REPO_DB = "postgres"
digna_REPO_SCHEMA = "dignarepo"
digna_REPO_USER = "digna_user"
digna_REPO_PASSWORD = "YourSecurePassword123!"
Parameter Verdi Merknader
digna_REPO_HOST localhost eller IP PostgreSQL-serverens hostnavn/IP
digna_REPO_PORT 5432 (standard) PostgreSQL-port
digna_REPO_DB postgres Databasenavn
digna_REPO_SCHEMA dignarepo Skjema opprettet tidligere
digna_REPO_USER digna_user Bruker opprettet i PostgreSQL-oppsettet
digna_REPO_PASSWORD Ditt passord Passord satt under skjemaopprettelsen

[base] Seksjonen

Denne seksjonen inneholder sikkerhets- og cookie-innstillinger:

[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"
Parameter Verdi Merknader
DIGNA_FERNET_KEY Krypteringsnøkkel Brukes for å kryptere tokens og cookies (standard levert)
digna_COOKIE_DOMAIN localhost Match ditt frontend-domene
digna_COOKIE_SECURE false (lokalt) / true (produksjon) Bruk true for HTTPS-tilkoblinger
digna_COOKIE_HTTPONLY true Alltid aktivert for sikkerhet
digna_COOKIE_SAME_SITE lax Forhindrer CSRF-angrep
digna_TOKEN_EXPIRES_IN 86400 (24 timer) Session timeout i sekunder
digna_MAX_WORKERS Antall CPU-kjerner - 1 Antall parallelle inspeksjonsoppgaver
DIGNA_SCHEDULER_MAX_DELAY 100 Maksimal forsinkelse, i sekunder, som planleggeren kan legge til før en forfalt jobb startes
DIGNA_CLEANUP_TIME "12:00" Tidspunkt (24-timersformat HH:MM) da den daglige oppryddingen starter

[encryption]-seksjonen

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Parameter Verdi Notater
DIGNA_ENCRYPTION_KEY Base64-kodet nøkkel Krypterer sensitive verdier som er lagret i digna-repositoryet

Beskytt config.toml

Denne nøkkelen er en fast verdi som er identisk i alle digna-installasjoner, og det er den som dekrypterer de sensitive verdiene i repositoryet ditt. Begrens config.toml til kontoen som kjører digna, hold filen utenfor versjonskontroll og delte disker, og utelat den fra enhver sikkerhetskopi som oppbevares mindre sikkert enn selve repositoryet.

[logging] Seksjonen

Denne seksjonen konfigurerer loggeadferd:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
Parameter Verdi Merknader
digna_LOGGING_MODE INFO eller DEBUG INFO for produksjon, DEBUG for feilsøking
digna_LOGGING_BACKUP_COUNT 10 Antall daglige logg-backup som beholdes

Trinn 2: Valider konfigurasjonen

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

digna config check

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

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK

Overall: OK

Rett alt som rapporteres som FAILED, og kjør kommandoen på nytt før du går videre. Den fullstendige listen over valg finnes i CLI-referansen.

Trinn 3: Initialiser repositoriet

  1. Åpne Kommandoprompt
  2. Naviger til din digna-installasjonsmappe (der config.toml og digna-kjørbar ligger)
  3. Kjør tilkoblingstesten:
digna repo check

Du skal se en bekreftelse på at tilkoblingen er opprettet (selve repositoriet er ennå ikke initialisert).

Trinn 4: Installer repositories-skjemaet

I samme mappe, kjør:

digna repo install

Denne kommandoen installerer nødvendige tabeller og skjema i din PostgreSQL-database.

Trinn 5: Opprett en adminbruker

  1. Åpne et nytt Kommandoprompt-vindu
  2. Naviger til din digna-installasjonsmappe
  3. Kjør følgende kommando for å opprette en adminbruker:
digna user add <email> <password> "<display_name>" --admin

Eksempel:

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

Dette oppretter en bruker med full administrative rettigheter.

Beste praksis

Bruk et sterkt passord med en blanding av store og små bokstaver, tall og spesialtegn.


Trinn 6: Start digna-serveren

I digna-installasjonsmappen, start serveren med:

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

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

Du bør se oppstartsmeldinger som bekrefter at serveren kjører:

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

Serveren opptar terminalen

serve kjører i forgrunnen og fortsetter til du stopper den med Ctrl+C. La den kjøre mens du fullfører oppsettet; for å starte den automatisk ved oppstart, se Kjøre digna som Windows-tjeneste.

Dashboard-konfigurasjon

Trinn 1: Deploy dashboardet til webserveren

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

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

Velg webserver og følg de tilsvarende deploy-trinnene.

Deploy til IIS

  1. Åpne IIS Manager
  2. Trykk Win + R, skriv inetmgr, trykk Enter

  3. Opprett et nytt nettsted

  4. I venstre panel, høyreklikk Sites
  5. Velg Add Website...

  6. Konfigurer nettstedet

  7. Site Name: Skriv inn et navn (f.eks. "dignaDashboard")
  8. Physical Path: Klikk Browse og velg din dashboard-mappe
  9. Binding: Sett IP-adresse og port (standard port 80 for HTTP, 443 for HTTPS)

  10. Start nettstedet

  11. Klikk OK for å opprette siden
  12. Høyreklikk det nye nettstedet og velg Start

  13. Test installasjonen

  14. Åpne nettleseren din
  15. Naviger til http://localhost (eller din konfigurerte URL)
  16. Du skal se påloggingssiden for digna-dashboardet

Deploy til Apache Tomcat

  1. Kopier dashboard til Tomcat
  2. Kopier dashboard-mappen til Tomcat sin webapps-katalog
  3. Gi den nytt navn om nødvendig (f.eks. til digna)
  4. Eksempel: C:\Program Files\Apache Tomcat\webapps\digna

  5. Verifiser deploy

  6. Oppdater eller last inn Tomcat-administrasjonssiden på nytt (http://localhost:8080)
  7. Du skal se "digna" (eller det navnet du valgte) listet blant deployerte applikasjoner

  8. Tilgang til dashboardet

  9. Åpne nettleseren din
  10. Naviger til http://localhost:8080/digna
  11. Du skal se påloggingssiden for digna-dashboardet

Kjøre digna som en Windows-tjeneste

Hvorfor bruke en Windows-tjeneste?

Å kjøre digna-backend som en Windows-tjeneste sikrer at den: - Starter automatisk ved serveroppstart - Kjører i bakgrunnen uten et åpent Kommandoprompt-vindu - Starter på nytt automatisk hvis den krasjer - Kan administreres gjennom Windows Services

windows-kommandoene

Tjenesten administreres av selve den kjørbare filen digna, gjennom underkommandoene digna windows. Det finnes ingen batchfiler å kjøre.

Kommando Formål
digna windows install Registrerer digna som en Windows-tjeneste
digna windows start Starter den registrerte tjenesten
digna windows stop Stopper tjenesten som kjører
digna windows uninstall Avregistrerer tjenesten

Administrator påkrevd

Alle fire kommandoene må kjøres fra en Kommandoprompt som er åpnet som administrator.

Hver kommando godtar --name for å adressere en tjeneste som er registrert under et annet navn enn standardnavnet. Den fullstendige listen over alternativer finnes i CLI-referansen.

Installere tjenesten

  1. Åpne Kommandoprompt som administrator
  2. Høyreklikk Kommandoprompt
  3. Velg "Run as Administrator"

  4. Naviger til digna-installasjonskatalogen din

    cd C:\path\to\digna
    

  5. Registrer tjenesten

    digna windows install
    

Angi adresse og port med mindre standardverdiene passer for deg

install lagrer adressen og porten i tjenesteregistreringen, og tjenesten binder seg til nøyaktig det som ble lagret. Standardverdiene er 127.0.0.1 og 8000, som bare godtar tilkoblinger fra selve maskinen. Et dashboard på en annen vert kan ikke nå dette, så angi adressen backend skal lytte på:

digna windows install --address 0.0.0.0 --port 8082

Disse leses ikke fra config.toml. For å endre dem senere må du avinstallere tjenesten og installere den på nytt med de nye verdiene.

Tjenesten registreres med automatisk oppstart, så den starter sammen med Windows. Den starter ikke umiddelbart — se neste seksjon.

Installasjonsalternativer

Alternativ Standard Formål
--name digna Navnet tjenesten registreres under
--display-name digna Navnet som vises i services.msc
--description digna data quality backend Beskrivelsen som vises i services.msc
--address 127.0.0.1 Adressen tjenesten binder API-et sitt til
--port 8000 Porten tjenesten binder API-et sitt til
--working-dir katalogen til den kjørbare filen digna Katalogen som inneholder config.toml og license.toml, og som tjenesten bruker som arbeidskatalog
--start-type auto auto starter sammen med Windows, manual starter bare på forespørsel, disabled registrerer tjenesten, men nekter å starte den
--account LocalSystem Kontoen tjenesten kjører som, f.eks. DOMAIN\user eller .\user
--password Passordet til --account

Kjøre under en domenekonto

LocalSystem har ingen nettverksidentitet, så Windows-autentisering mot SQL Server og all tilgang til en nettverksressurs vil mislykkes. Installer med --account og --password der tjenesten må nå ressurser som en bestemt bruker.

Starte og stoppe tjenesten

For å starte tjenesten

digna windows start

For å stoppe tjenesten

digna windows stop

Tips

Stopp alltid tjenesten før du oppdaterer applikasjonsfiler.

Flytte tjenesten til en ny katalog

Hvis du trenger å flytte digna-installasjonen:

  1. Stopp og avregistrer den nåværende tjenesten

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

  2. Flytt applikasjonsfilene

  3. Flytt hele digna-installasjonsmappen til det nye stedet

  4. Registrer tjenesten på nytt fra det nye stedet

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

Gjenta eventuelle verdier for --address, --port eller --account som du brukte første gang — den forrige registreringen er borte.

  1. Start tjenesten
    digna windows start
    

Avinstallere tjenesten

  1. Stopp tjenesten som kjører

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

  2. Avregistrer tjenesten

    digna windows uninstall
    

digna-serveren er nå avregistrert som en Windows-tjeneste.


Oppgradering til ny utgave

Før du oppgraderer

Verifiser alle databasetilkoblinger først

Fra utgivelse 2026.06 når digna hver kildeteknologi via ODBC. Tidligere utgivelser ga et valg mellom en teknologispesifikk driver og ODBC, valgt med bryteren Use ODBC. digna-teamet har bestemt seg for å bygge utelukkende på ODBC, fordi ett enkelt standardgrensesnitt gir mer enn et sett med skreddersydde drivere:

  • Autentisering — autentisering er en del av ODBC, så en tilkobling kan bruke alt driveren støtter: passord, tokener og PAT-er, Kerberos og Active Directory, MFA og nettleserbasert enkel pålogging, skyidentiteter, klientsertifikater og TLS. Nye metoder kommer med en driveroppdatering i stedet for å vente på en digna-utgivelse.
  • Drivere som vedlikeholdes av databaseleverandørene — leverandørens egen driver følger nye serverversjoner og sikkerhetsfikser, og du kan oppdatere den etter din egen plan, uavhengig av digna.
  • Én måte å konfigurere alt på — hver teknologi er en liste med nøkkel/verdi-egenskaper, med samme grensesnitt, samme kryptering av sensitive verdier og samme feilsøking, i stedet for ulike felt per kilde.
  • Finjustering og rekkevidde — driveralternativer som tidsavbrudd, TLS-innstillinger, proxyer og hentestørrelser er tilgjengelige for alle kilder, og enhver teknologi med en kompatibel ODBC-driver kan kobles til, også slike digna ikke publiserer en egen veiledning for.

I praksis betyr dette at bryteren Use ODBC og de separate feltene for vert, port, database, bruker og passord ikke lenger finnes. Enhver tilkobling som ikke allerede bruker ODBC, må legges om til ODBC — det finnes ingen automatisk konvertering, så planlegg dette før oppgraderingen:

  1. Gå gjennom hver databasetilkobling som er definert i installasjonen din, og noter hvilke som ennå ikke bruker ODBC — hver av dem må konfigureres på nytt.
  2. Installer den tilsvarende ODBC-driveren på digna-verten — tilkoblinger åpnes fra serveren som kjører digna-backend, ikke fra nettleseren. Se Installer ODBC-driveren på digna-verten.
  3. Ha ODBC-egenskapene klare for hver berørt tilkobling. Teknologiveiledningene angir et utprøvd sett med egenskaper per kilde.

Etter oppgraderingen legger du om hver berørt tilkobling til ODBC og tester den fra dashbordet — se Opprette en databasetilkobling og Teste en tilkobling.

Databricks Legacy-tilkoblinger

Databricks Legacy-koblingen er fjernet i denne utgivelsen. Migrer disse tilkoblingene til Databricks-koblingen.

Å ta backup av digna-repositoriet er obligatorisk

Før du oppgraderer digna, ta sikkerhetskopi av ditt repositorium (PostgreSQL) for å beskytte mot datatap. En backup sikrer at du kan gjenopprette dersom oppgraderingen støter på uventede problemer.

Oppgraderingsprosess

Trinn 1: Stopp og avregistrer den gamle tjenesten

Hvis digna kjører som en Windows-tjeneste, stopper du den med batchfilene i den nåværende installasjonen — digna windows-kommandoene hører til den nye utgivelsen og er ikke tilgjengelige ennå:

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

Avregistrer deretter tjenesten, igjen med den gamle batchfilen. Registreringen peker på den gamle kjørbare filen og skriptene dens, som begge erstattes av denne oppgraderingen, så den kan ikke gjenbrukes:

uninstall_service.bat

Avregistrer før du gir noe nytt navn

uninstall_service.bat ligger i bin-mappen som du snart skal gi nytt navn, og den er det eneste som kan fjerne registreringen den opprettet. Kjør den mens den gamle installasjonen fortsatt er på plass. Hvis mappen allerede har fått nytt navn, gir du den det opprinnelige navnet tilbake, avregistrerer og fortsetter deretter.

Noter kontoen tjenesten kjørte under, og adressen og porten den leverte på — du vil trenge dem i trinn 9.

Trinn 2: Sikkerhetskopier gjeldende installasjon

Gi mappene i den gjeldende installasjonen nye navn i digna-installasjonskatalogen, slik at den nye utgivelsen kan distribueres ved siden 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

dignabackend og dignacli brukes ikke lenger

Fra utgivelse 2026.06 erstattes dignabackend og dignacli av den ene kjørbare filen digna, som samler backend og CLI. Behold dignabackend_old og dignacli_old bare til du har verifisert oppgraderingen — deretter kan du slette begge mappene. Behold dashboard_old til du har gjenopprettet konfigurasjonsfilene dine fra den (se trinn 4). bin-mappen skal også bort: batchfilene i den styrte den gamle tjenesten, og 2026.06 leverer dem ikke, så når tjenesten er avregistrert i trinn 1, gjør de ikke annet enn å villede.

Trinn 3: Pakk ut og deploy ny versjon

  1. Pakk ut den nye digna-installasjons-ZIP-filen
  2. Kopier den nye digna-kjørbare, og dashboard-mappen til din installasjonsmappe

Viktig

Verken config.toml eller dashboard/dashboard_config.toml er noensinne inkludert i installasjons-ZIP-en — digna-teamet leverer aldri noen av filene. Din eksisterende konfigurasjon berøres derfor ikke av oppgraderingen, og kopiene i de omdøpte *_old-mappene er de eneste du har.

Trinn 4: Gjenopprett konfigurasjonsfilene dine

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

Utgivelse 2026.06 endrer config.toml

Tre innstillinger er nye og påkrevde, og to brukes ikke lenger. En config.toml som er videreført fra en tidligere utgivelse, inneholder ikke de nye innstillingene, og digna starter ikke så lenge de mangler. Legg til følgende i din eksisterende config.toml:

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Legg de to [base]-nøklene til i din eksisterende [base]-seksjon, og legg til [encryption] som ny seksjon. Fjern deretter de to innstillingene som ikke lenger brukes, digna_APP_HOST og digna_APP_PORT, fra [app] — serveren henter nå adresse og port fra digna serve.

Hva hver innstilling gjør, er beskrevet i Backend-konfigurasjon.

Enkel pålogging: formatet for [oidc_clients] er endret

Utgivelse 2026.06 erstatter tabellarrayen med én tabell per leverandør, oppkalt etter leverandørnøkkelen. DIGNA_OIDC_KEY er borte — nøkkelen er nå en del av seksjonsoverskriften.

Før:

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

Etter:

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

Gjenta seksjonen for hver leverandør, og hold hver nøkkel lik key i dashboard_config.toml. digna config check rapporterer oidc_clients som FAILED så lenge den gamle formen fortsatt finnes. Bare installasjoner som bruker enkel pålogging er berørt.

Trinn 5: Last inn webserveren på nytt

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

Trinn 6: Valider konfigurasjonen

Bekreft at den oppdaterte config.toml er fullstendig før du rører repositoryet:

digna config check

Hver seksjon må rapportere OK. Rett alt som rapporteres som FAILED, og kjør kommandoen på nytt før du går videre.

Trinn 7: Erstatt lisensfilen

Hver utgivelse lisensieres separat. Kopier license.toml som digna-teamet har levert for denne utgivelsen, til installasjonskatalogen, slik at den erstatter den gamle:

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

Ikke behold den forrige lisensen

En license.toml utstedt for en tidligere utgivelse dekker ikke denne, og alle kommandoer som kontrollerer lisensen — user, inspection, repo — avbrytes før de berører repositoriet når kontrollen feiler. Verifiser den før du går videre:

digna license check

Trinn 8: Oppgrader repositories-skjemaet

Naviger til din digna-installasjonsmappe og kjør:

digna repo upgrade

Dette oppdaterer PostgreSQL-skjemaet til siste versjon samtidig som alle eksisterende data bevares.

Trinn 9: Registrer og start tjenesten

Den gamle registreringen ble fjernet i trinn 1, så tjenesten registreres på nytt — denne gangen med den kjørbare filen digna, som ikke har noen batchfiler:

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

Gi --address og --port de verdiene den gamle tjenesten leverte på, med mindre du vil bruke de nye standardverdiene 127.0.0.1 og 8000; de lagres i registreringen og leses ikke lenger fra config.toml. Legg til --account og --password hvis den gamle tjenesten kjørte under en domenekonto. Se Kjøre digna som en Windows-tjeneste for den fullstendige listen over alternativer.

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

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

Hvis du bruker IIS eller Tomcat, restart den respektive webserveren.

Trinn 10: Verifiser oppgraderingen

  1. Åpne digna-dashboardet
  2. Verifiser at grensesnittet laster riktig
  3. Sjekk serverloggene for eventuelle feil
  4. Legg om hver tilkobling som ennå ikke brukte ODBC, til ODBC, og test deretter alle tilkoblinger — se Teste en tilkobling