Windows Installation Guide for digna Release 2026.06¶
Release: 2026.06
Last Updated: August 30, 2026
Table of Contents¶
- Introduksjon
- Systemkrav
- Forberedelser før installasjon
- PostgreSQL-serveroppsett
- Webserverkonfigurasjon
- Initial installasjon
- Backend-konfigurasjon
- Dashboard-konfigurasjon
- Kjøre digna som en Windows-tjeneste
- 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
dignabackendogdignaclifra 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:
- PostgreSQL-server – for lagring av beregnede målinger og ytelsesdata
- 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¶
- Besøk PostgreSQL-nedlastingssiden
- Velg Windows
- Last ned den nyeste installasjonsfilen
Trinn 2: Kjør installasjonsprogrammet¶
- Dobbeltklikk på den nedlastede installasjonsfilen
- 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:
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¶
- Åpne Kontrollpanel
- Trykk
Win + R -
Skriv
controlog trykk Enter -
Gå til Windows-funksjoner
- Klikk Programs
-
Velg Turn Windows features on or off
-
Aktiver Internet Information Services
- Bla ned og finn Internet Information Services (IIS)
- Kryss av for å aktivere den
-
Klikk på + for å utvide og verifiser at disse underkomponentene er valgt:
- Web Management Tools
- World Wide Web Services
-
Klikk OK for å anvende endringene
-
Verifiser IIS-installasjonen
- Åpne nettleseren din
- Naviger til
http://localhost - 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:
- Åpne IIS Manager (trykk
Win + R, skrivinetmgr, trykk Enter) - Naviger til Your Site > MIME Types
- Klikk Add...
- Konfigurer:
- File name extension:
.md - 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¶
- Last ned Apache Tomcat
- Besøk Apache Tomcat Downloads
-
Last ned Windows ZIP-distribusjonen
-
Pakk ut arkivet
- Pakk ut ZIP-filen til en katalog på systemet ditt
-
Eksempel:
C:\Program Files\Apache Tomcat -
Verifiser at Tomcat kjører
- Åpne nettleseren din
- Naviger til
http://localhost:8080 - 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¶
- Finn digna-installasjons-ZIP-filen som er levert til deg
- Pakk den ut til ønsket installasjonssted
- Etter utpakking skal du se følgende elementer:
dashboard/— Web dashboard-grensesnittdigna— 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.
- Finn
license.toml-filen som er levert til deg - Kopier den inn i rotmappen for digna-installasjonen (der
config.tomlogdigna-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.
| 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:
| 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:
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¶
- Åpne Kommandoprompt
- Naviger til din digna-installasjonsmappe (der
config.tomlogdigna-kjørbar ligger) - Kjør tilkoblingstesten:
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:
Denne kommandoen installerer nødvendige tabeller og skjema i din PostgreSQL-database.
Trinn 5: Opprett en adminbruker¶
- Åpne et nytt Kommandoprompt-vindu
- Naviger til din digna-installasjonsmappe
- Kjør følgende kommando for å opprette en adminbruker:
Eksempel:
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:
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¶
- Åpne IIS Manager
-
Trykk
Win + R, skrivinetmgr, trykk Enter -
Opprett et nytt nettsted
- I venstre panel, høyreklikk Sites
-
Velg Add Website...
-
Konfigurer nettstedet
- Site Name: Skriv inn et navn (f.eks. "dignaDashboard")
- Physical Path: Klikk Browse og velg din
dashboard-mappe -
Binding: Sett IP-adresse og port (standard port 80 for HTTP, 443 for HTTPS)
-
Start nettstedet
- Klikk OK for å opprette siden
-
Høyreklikk det nye nettstedet og velg Start
-
Test installasjonen
- Åpne nettleseren din
- Naviger til
http://localhost(eller din konfigurerte URL) - Du skal se påloggingssiden for digna-dashboardet
Deploy til Apache Tomcat¶
- Kopier dashboard til Tomcat
- Kopier
dashboard-mappen til Tomcat sinwebapps-katalog - Gi den nytt navn om nødvendig (f.eks. til
digna) -
Eksempel:
C:\Program Files\Apache Tomcat\webapps\digna -
Verifiser deploy
- Oppdater eller last inn Tomcat-administrasjonssiden på nytt (http://localhost:8080)
-
Du skal se "digna" (eller det navnet du valgte) listet blant deployerte applikasjoner
-
Tilgang til dashboardet
- Åpne nettleseren din
- Naviger til
http://localhost:8080/digna - 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¶
- Åpne Kommandoprompt som administrator
- Høyreklikk Kommandoprompt
-
Velg "Run as Administrator"
-
Naviger til digna-installasjonskatalogen din
-
Registrer tjenesten
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å:
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¶
For å stoppe tjenesten¶
Tips
Stopp alltid tjenesten før du oppdaterer applikasjonsfiler.
Flytte tjenesten til en ny katalog¶
Hvis du trenger å flytte digna-installasjonen:
-
Stopp og avregistrer den nåværende tjenesten
-
Flytt applikasjonsfilene
-
Flytt hele digna-installasjonsmappen til det nye stedet
-
Registrer tjenesten på nytt fra det nye stedet
Gjenta eventuelle verdier for --address, --port eller --account som du brukte første gang — den forrige registreringen er borte.
- Start tjenesten
Avinstallere tjenesten¶
-
Stopp tjenesten som kjører
-
Avregistrer tjenesten
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:
- 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.
- 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.
- 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å:
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:
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:
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¶
- Pakk ut den nye digna-installasjons-ZIP-filen
- Kopier den nye
digna-kjørbare, ogdashboard-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¶
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:
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:
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:
Trinn 8: Oppgrader repositories-skjemaet¶
Naviger til din digna-installasjonsmappe og kjør:
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:
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:
Hvis du bruker IIS eller Tomcat, restart den respektive webserveren.
Trinn 10: Verifiser oppgraderingen¶
- Åpne digna-dashboardet
- Verifiser at grensesnittet laster riktig
- Sjekk serverloggene for eventuelle feil
- Legg om hver tilkobling som ennå ikke brukte ODBC, til ODBC, og test deretter alle tilkoblinger — se Teste en tilkobling