Linux-installasjonsveiledning for digna Release 2026.11¶

Release: 2026.11

Sist oppdatert: 7. november 2026

Innholdsfortegnelse¶

1. Introduksjon
2. Systemkrav
3. Forberedelser før installasjon
4. Oppsett av PostgreSQL-server
5. Webserverkonfigurasjon
6. Første installasjon
7. Backend-konfigurasjon
8. Dashboard-konfigurasjon
9. Kjøre digna som en systemd-tjeneste
10. Oppgradere til en ny utgivelse

Introduksjon¶

Om digna¶

digna er en omfattende, AI-drevet plattform designet for å optimalisere datakvalitetsstyring på tvers av ulike data-miljøer som warehouses, lakes og lakehouses. Bygget for å være svært skalerbar og tilpasningsdyktig, håndterer digna moderne datautfordringer gjennom automatisering, sanntidsovervåking og anomalideteksjon.

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 nettbasert grensesnitt hostet på en webserver, som gir en brukervennlig måte å samhandle med digna-plattformen og visualisere datakvalitetsmål.

Hva er nytt i Release 2026.11¶

Denne utgivelsen legger til digna Data Reconciliation, digna Agentic med digna MCP Server, og digna Engine, som kan profilere data inne i digna og kontrollere referanseintegritet mellom ulike databaseteknologier. Se utgivelsesnotatene for fullstendige detaljer.

For en installasjon bringer utgivelsen en ny mekanisme for repository-migreringer, en valgfri [duckdb]-seksjon i config.toml for digna Engine, og en ny lisensfil. Oppgraderingsavsnittet tar for seg hver av dem.

Ser du etter Windows eller macOS?¶

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

Hvilken distribusjon dekker denne veiledningen?¶

Instruksjonene er skrevet for de to mest vanlige serverfamiliene. Der de to avviker, er begge kommandoene oppgitt:

• Debian-familien — Debian, Ubuntu. Pakkehåndterer: apt.
• RHEL-familien — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Pakkehåndterer: dnf.

Enhver moderne distribusjon med systemd vil fungere; det er bare pakkenavn og noen konfigurasjonsstier som endres.

Systemkrav¶

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

Databaseinstallasjonsalternativer¶

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

Hvis du installerer PostgreSQL på samme maskin som digna:

Sjekke distribusjon og arkitektur¶

Flere kommandoer i denne veiledningen skiller seg mellom Debian- og RHEL-familiene. For å sjekke hvilken du bruker, kjør:

cat /etc/os-release
uname -m

• ID=ubuntu eller ID=debian — bruk apt-kommandoene.
• ID=rhel, rocky, almalinux eller fedora — bruk dnf-kommandoene.
• x86_64 eller aarch64 — arkitekturen for installasjonspakken du trenger.

Forberedelser før installasjon¶

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

1. PostgreSQL-server – for å lagre beregnede metrikker og ytelsesdata
2. Webserver – for hosting av digna Dashboard

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

Oppdatering av pakkelisten¶

Oppdater pakkelistene før du installerer noe:

sudo apt update

sudo dnf check-update

Oppsett av PostgreSQL-server¶

Hvis du allerede har PostgreSQL¶

Hvis PostgreSQL allerede er installert og kjører lokalt eller hvis du bruker en administrert ekstern PostgreSQL-server, kan du hoppe til neste seksjon.

Installere PostgreSQL¶

Steg 1: Installer serverpakken¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Steg 2: Initialiser databaseklyngen¶

På Debian-familien oppretter og starter pakken en klynge automatisk — hopp til neste steg.

På RHEL-familien må klyngen opprettes eksplisitt:

sudo postgresql-setup --initdb

Steg 3: Start og aktiver tjenesten¶

sudo systemctl enable --now postgresql

Dette starter PostgreSQL umiddelbart og konfigurerer den til å starte automatisk ved oppstart.

Steg 4: Verifiser installasjonen¶

psql --version
sudo systemctl status postgresql

Du bør se PostgreSQL-versjonen og en active (running)-tjeneste.

Steg 5: Koble til serveren¶

En Linux PostgreSQL-pakke oppretter en systemkonto postgres som eier klyngen. Koble til via denne kontoen:

sudo -u postgres psql

Steg 6: Bekreft porten¶

Standard PostgreSQL-port er 5432. For å bekrefte hvilken port serveren lytter på:

sudo -u postgres psql -c "SHOW port;"

Noter verdien — du vil trenge den når du konfigurerer digna-backend.

Steg 7: Aktiver passordautentisering for digna-brukeren¶

digna kobler til PostgreSQL over TCP som digna_user, noe som krever passordautentisering fremfor peer authentication. Sjekk at pg_hba.conf tillater dette.

Finn filen:

sudo -u postgres psql -c "SHOW hba_file;"

Åpne den i en editor og bekreft at de lokale TCP-linjene bruker scram-sha-256 (eller md5 på eldre servere) i stedet for ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Reload PostgreSQL etter enhver endring:

sudo systemctl reload postgresql

Steg 8: Hvis PostgreSQL kjører på en annen maskin¶

For å akseptere tilkoblinger fra en annen vert, sett listen_addresses i postgresql.conf og legg til en tilsvarende host-linje for nettverket ditt i pg_hba.conf:

listen_addresses = '*'

Deretter åpner du porten i brannmuren og starter tjenesten på nytt:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Webserverkonfigurasjon¶

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

• nginx — lettvekts og anbefalt
• Apache httpd — et mye brukt alternativ

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

Begge seksjonene konfigurerer to ting dashboardet er avhengig av:

• En single-page-application fallback, slik at oppfrisking av en dashboard-URL ikke returnerer 404
• En .md MIME-type, slik at Markdown-filer serveres riktig

nginx-oppsett¶

Oversikt¶

nginx er en lettvekts, høyytelses webserver som egner seg godt til å servere det statiske digna-dashboardet.

Installasjon¶

sudo apt install -y nginx

sudo dnf install -y nginx

Starte nginx¶

sudo systemctl enable --now nginx

Verifiser installasjonen¶

1. Åpne nettleseren
2. Gå til http://localhost
3. Du bør se nginx-velkomstsiden

Åpne brannmuren¶

Hvis serveren nås fra andre maskiner, tillat HTTP-trafikk:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Konfigurere et nettsted for dashboardet¶

nginx inkluderer alle filer i conf.d-katalogen på begge distribusjonsfamilier. Lag en dedikert konfigurasjonsfil for digna der:

sudo nano /etc/nginx/conf.d/digna.conf

Lim inn følgende, og erstatt /opt/digna/dashboard med den faktiske stien til din utpakkede dashboard-mappe:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

(Kommentarene over er i konfigurasjonen; de kan hjelpe ved feilsøking.)

Deaktiver standardnettstedet¶

Kun én serverblokk kan være default_server for en port. På Debian-familien, fjern den medfølgende standarden slik at den ikke konflikter:

sudo rm /etc/nginx/sites-enabled/default

På RHEL-familien, kommenter ut eller slett server { ... }-blokken inne i /etc/nginx/nginx.conf.

Aktiver konfigurasjonen¶

Test konfigurasjonen for syntaksfeil, og last deretter nginx på nytt:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd-oppsett¶

Oversikt¶

Apache httpd er tilgjengelig i standardreposene for alle støttede distribusjoner. Pakken heter apache2 på Debian-familien og httpd på RHEL-familien.

Installasjon¶

sudo apt install -y apache2

sudo dnf install -y httpd

Starte Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Verifiser installasjonen¶

1. Åpne nettleseren
2. Gå til http://localhost
3. Du bør se distribusjonens standard Apache-side

Påkrevd: Aktiver mod_rewrite¶

Dashboardet krever URL-omskriving.

På Debian-familien, aktiver modulen og start på nytt:

sudo a2enmod rewrite
sudo systemctl restart apache2

På RHEL-familien lastes mod_rewrite som regel inn som standard. Bekreft det:

httpd -M | grep rewrite

Påkrevd: Tillat .htaccess-overstyringer¶

Åpne konfigurasjonsfilen for dokumentroten:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Finn <Directory>-blokken som dekker dokumentroten din (/var/www/html på begge familier) og endre:

AllowOverride None

til:

AllowOverride All

Påkrevd: MIME-type for Markdown-filer¶

I samme fil, legg til følgende linje slik at Markdown-filer serveres riktig:

AddType text/markdown .md

Aktiver konfigurasjonen¶

Sjekk konfigurasjonen for syntaksfeil, og start deretter Apache på nytt:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Første installasjon¶

Steg 1: Sett opp digna-repositoriet¶

digna-repositoriet lagrer alle metrikker som beregnes av digna. Det fungerer som den sentrale databasen for analytiske og ytelsesdata.

Opprett repositories-skjema og bruker¶

Åpne din PostgreSQL-klient (psql, pgAdmin 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> — ønsket skjema-navn (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;

For å kjøre disse fra shell i ett trinn:

sudo -u postgres psql

Lim så inn uttalelsene ved postgres=#-prompten og skriv \q for å avslutte.

Steg 2: Pakk ut digna-installasjonspakken¶

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

For å pakke ut fra shell:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Gjør den kjørbare filen kjørbar¶

Avhengig av hvordan arkivet ble overført, kan den kjørbare biten mangle etter utpakking. Sett den eksplisitt:

cd /opt/digna
sudo chmod +x digna

Opprett en tjenestekonto¶

Det anbefales å kjøre backend som en dedikert, uprivilegert bruker for produksjonsdistribusjoner:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Steg 3: Installer lisensfilen¶

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

Hvorfor dette er viktig: Lisensfilen inneholder kundeinformasjon, lisensutløpsdato og digital signatur. Ikke endre denne filen — enhver endring vil ugyldiggjøre den.

Katalogstruktur etter oppsett:

/opt/digna/
├── config.toml         (konfigurasjonsfil)
├── license.toml        (DIN LISENSFIL - kopier hit)
├── digna               (hovedkjørbar)
├── bin/                (skript for tjenesteadministrasjon)
└── dashboard/          (webgrensesnitt)
    └── (dashboard-filer)

Backend-konfigurasjon¶

Steg 1: Opprett og rediger konfigurasjonsfilen¶

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

cd /opt/digna
sudo mv config_template.toml config.toml

Plassering: /opt/digna/config.toml

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

[app]-seksjonen¶

Denne seksjonen konfigurerer cross-origin resource sharing (CORS) mellom dashboardet og backend:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

[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!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

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

[base]-seksjonen¶

Denne seksjonen inneholder sikkerhets-, cookie- og inspeksjonsinnstillinger:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

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

[logging]-seksjonen¶

Denne seksjonen konfigurerer loggingsatferd:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[duckdb]-seksjonen (valgfri)¶

Nytt i Release 2026.11. Denne seksjonen angir ressursene til digna Engine, som profilerer data inne i digna for databasetilkoblinger med profileringsstedet digna Engine, og som kjører kontroller av referanseintegritet mellom datakilder på ulike databasetilkoblinger. Se Profileringssted.

Seksjonen er valgfri. Uten den gjelder standardverdiene nedenfor.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

Steg 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
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Rett alt som rapporteres som FAILED, og kjør kommandoen på nytt før du går videre. En WARNING under Unknown keys viser nøkler i config.toml som digna ikke leser; de har ingen effekt, så fjern dem eller rett stavemåten. Den fullstendige listen over valg finnes i CLI-referansen.

Steg 3: Initialiser repositoriet¶

1. Åpne et terminalvindu
2. Gå til din digna-installasjonsmappe (der config.toml og digna-kjørbar ligger)
3. Kjør tilkoblingstesten:

cd /opt/digna
./digna repo check

På et nytt skjema kobler kommandoen til og rapporterer deretter at det ikke er installert noe repository ennå:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

På dette tidspunktet er det det forventede resultatet: det bekrefter at digna når PostgreSQL og skjemaet. En tilkoblings- eller autentiseringsfeil peker i stedet på [repo]-seksjonen eller på PostgreSQL-oppsettet.

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

Steg 4: Installer repositories-skjemaet¶

I samme katalog, kjør:

./digna repo upgrade

Denne kommandoen installerer de nødvendige tabellene i repository-skjemaet og avslutter med:

✅ Repo schema 'dignarepo' is up to date.

Steg 5: Opprett en administratorbruker¶

Administratorbrukeren opprettes direkte mot repository-skjemaet, så serveren trenger ikke å kjøre ennå. Kjør i digna-installasjonskatalogen:

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

Eksempel:

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

Dette oppretter en bruker med e-postadressen admin@example.com og fulle administratorrettigheter.

Steg 6: Start digna-serveren¶

I digna-installasjonskatalogen, start serveren med:

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

Parametere: - --address — Serverens hostnavn/IP (standard 127.0.0.1) - --port — Serverport (standard 8000)

Når serveren er oppe, skriver den ut adressen den lytter på:

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

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

Dashboard-konfigurasjon¶

Steg 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 tilsvarende distribusjonstrinn.

Deploy til nginx¶

Hvis du fulgte nginx-oppsettet, peker serverblokken allerede på din dashboard-mappe og ingen kopiering er nødvendig.

1. Bekreft stien
2. Åpne /etc/nginx/conf.d/digna.conf

3. Verifiser at root peker til din utpakkede dashboard-mappe

4. Sørg for at mappen er lesbar

   sudo chmod -R a+rX /opt/digna/dashboard
   

5. Reload nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Test installasjonen

7. Åpne nettleseren
8. Gå til http://localhost (eller din konfigurerte URL)
9. Du skal se digna-dashboardets innloggingsside

Deploy til Apache httpd¶

1. Kopier dashboardet til dokumentroten

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Legg til omskrivingsreglene

Opprett en .htaccess-fil inne i den deployerte mappen slik at dashboard-ruter overlever en oppfriskning i nettleseren:

sudo nano /var/www/html/digna/.htaccess

Lim inn følgende:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Restart Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Åpne dashboardet

3. Åpne nettleseren
4. Gå til http://localhost/digna
5. Du skal se digna-dashboardets innloggingsside

Steg 2: SELinux (kun RHEL-familien)¶

På RHEL, Rocky, AlmaLinux og Fedora er SELinux som regel enforcing og vil blokkere webserveren fra å lese filer utenfor forventede steder. Sjekk om det er aktivt:

getenforce

Hvis resultatet er Enforcing og du serverer dashboardet fra /opt/digna/dashboard, merk katalogen slik at webserveren kan lese den:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

Kjøre digna som en systemd-tjeneste¶

Hvorfor kjøre digna som en tjeneste?¶

Å kjøre digna-backend som en systemd-tjeneste sikrer at den:

• Starter automatisk når maskinen boot-er
• Kjører i bakgrunnen uten et åpent terminalvindu
• Starter på nytt automatisk hvis den krasjer
• Kan administreres via systemctl, standard Linux-tjenestebehandler

Filer for tjenesteadministrasjon¶

Alle nødvendige filer ligger i digna-installasjonskatalogen under: bin/

Følgende shell-skript er tilgjengelige:

• install_service.sh — registrerer digna hos systemd
• uninstall_service.sh — fjerner registreringen
• start_service.sh — starter den registrerte tjenesten
• stop_service.sh — stopper den kjørende tjenesten

Gjøre skriptene kjørbare¶

Utpakking bevarer kanskje ikke kjørbar-bit. Før første bruk:

cd /opt/digna/bin
sudo chmod +x *.sh

Installere tjenesten¶

1. Åpne et terminalvindu

2. Gå til bin-mappen

   cd /opt/digna/bin
   

3. Kjør installasjonsskriptet

   sudo ./install_service.sh
   

digna-serveren er nå registrert hos systemd med automatisk oppstart aktivert. Tjenesten starter ikke umiddelbart — se neste seksjon for å starte den.

Starte og stoppe tjenesten¶

For å starte tjenesten¶

1. Åpne et terminalvindu
2. Gå til /opt/digna/bin
3. Kjør:

   sudo ./start_service.sh
   

For å stoppe tjenesten¶

1. Åpne et terminalvindu
2. Gå til /opt/digna/bin
3. Kjør:

   sudo ./stop_service.sh
   

Administrere tjenesten med systemctl¶

Når den er registrert, kan tjenesten også kontrolleres med standard systemd-kommandoer fra hvilken som helst katalog:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Verifisere tjenesten¶

For å bekrefte at tjenesten er registrert og kjører:

systemctl is-enabled digna
systemctl is-active digna

enabled betyr at tjenesten starter ved boot; active betyr at den kjører nå.

Vise tjenestelogger¶

systemd fanger opp alt backend skriver til konsollen. For å lese det:

sudo journalctl -u digna -n 100

For å følge loggen i sanntid mens du reproduserer et problem:

sudo journalctl -u digna -f

Flytte tjenesten til en ny katalog¶

Enhetsfilen lagrer den absolutte stien til den kjørbare filen, så flytting av installasjonen krever ny registrering av tjenesten:

1. Avinstaller den nåværende tjenesten

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Flytt applikasjonsfilene

   sudo mv /old/path/digna /new/path/digna
   

3. Installer tjenesten på nytt

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Start tjenesten

   sudo ./start_service.sh
   

Avinstallere tjenesten¶

1. Stopp den kjørende tjenesten

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Avinstaller tjenesten

   sudo ./uninstall_service.sh
   

digna-serveren er nå avregistrert fra systemd.

Oppgradere til en ny utgivelse¶

Denne delen oppgraderer en installasjon av Release 2026.06 til Release 2026.11. Hvis installasjonen din er eldre, les først Oppgradere fra en utgivelse før 2026.06.

Før du oppgraderer¶

Det er obligatorisk å ta backup av digna-repositoriet

Før du oppgraderer digna, ta backup av repositoriet (PostgreSQL) for å beskytte mot datatap. En backup sikrer at du kan gjenopprette hvis oppgraderingen møter uventede problemer.

For å lage en backup fra shell:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Be om lisensfilen for Release 2026.11

Release 2026.11 krever en ny license.toml. Be digna-teamet om den før du starter, og ha den klar til steg 7.

Oppgradere fra en utgivelse før 2026.06¶

Release 2026.06 innførte tre endringer som fortsatt gjelder når du oppgraderer en eldre installasjon direkte til 2026.11:

• Kun ODBC. digna når hver kildeteknologi via ODBC. Hver databasetilkobling som ennå ikke bruker ODBC, må legges om til ODBC etter oppgraderingen; det finnes ingen automatisk konvertering. Installer ODBC-driverne på digna-verten på forhånd, se Installer ODBC-driveren på digna-verten, og ha egenskapene for hver tilkobling klare fra teknologiveiledningene. Databricks Legacy-koblingen finnes ikke lenger; flytt disse tilkoblingene til Databricks-koblingen.
• Én kjørbar fil. dignabackend og dignacli erstattes av den ene kjørbare filen digna, som samler backend og CLI.
• config.toml. [encryption]-seksjonen er påkrevd, og DIGNA_APP_HOST og DIGNA_APP_PORT leses ikke lenger: serveren henter adresse og port fra digna serve. Sammenlign filen din med Backend-konfigurasjon.

Stegene nedenfor viser hvor en eldre installasjon trenger noe annet. Repository-oppgraderingen i steg 8 bringer et repository fra en hvilken som helst tidligere utgivelse direkte til 2026.11.

Oppgraderingsprosess¶

Steg 1: Stopp digna-tjenesten¶

Hvis digna kjører som en systemd-tjeneste, stopp den først:

cd /opt/digna/bin
sudo ./stop_service.sh

Hvis digna kjører i forgrunnen, trykk Ctrl+C i terminalvinduet der den kjører.

Steg 2: Sikkerhetskopier gjeldende installasjon¶

Gi den kjørbare filen og dashboard-mappen i den gjeldende installasjonen nye navn i digna-installasjonskatalogen, slik at den nye utgivelsen kan distribueres ved siden av dem:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

Behold digna_old til du har verifisert oppgraderingen, og dashboard_old til du har gjenopprettet konfigurasjonsfilene dine fra den (se steg 4). Deretter kan du slette begge.

Steg 3: Pakk ut og distribuer ny versjon¶

1. Pakk ut den nye digna-installasjons-ZIP-filen
2. Kopier den nye kjørbare digna-filen og dashboard-mappen til installasjonskatalogen din
3. Gjenopprett kjørbar-biten og eierskapet til tjenestekontoen:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Steg 4: Gjenopprett konfigurasjonsfilene¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 krever ingen endring i config.toml: en fil som fungerer med Release 2026.06, fortsetter å fungere. To endringer er valgfrie:

• Legg til en [duckdb]-seksjon hvis databasetilkoblinger skal bruke digna Engine og standardverdiene ikke passer for verten din.
• Utelat [app]-seksjonen hvis en omvendt proxy serverer dashboardet og backend under samme origin.

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

Steg 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).

Steg 6: Valider konfigurasjonen¶

Bekreft at config.toml er fullstendig før du rører repositoriet:

./digna config check

Hver seksjon må rapportere OK. Rett alt som rapporteres som FAILED, fjern nøklene som vises under Unknown keys, og kjør kommandoen på nytt før du går videre.

Steg 7: Erstatt lisensfilen¶

En lisensfil følger normalt med fra én utgivelse til den neste. Release 2026.11 er et unntak: den legger til to lisensierte moduler, digna Data Reconciliation og digna Agentic, og en lisens utstedt før 2026.11 inneholder dem ikke. Kopier license.toml som digna-teamet har levert for Release 2026.11, til installasjonskatalogen, slik at den erstatter den gamle:

sudo cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Steg 8: Oppgrader repository-skjemaet¶

Kjør i digna-installasjonskatalogen:

cd /opt/digna
./digna repo upgrade

Release 2026.11 håndterer repository-skjemaet med versjonerte migreringer. Den første oppgraderingen fra en tidligere utgivelse bringer skjemaet til siste versjon av den tidligere ordningen, registrerer dette som utgangspunkt og bruker deretter migreringene i Release 2026.11. Den avslutter med:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Alle eksisterende data bevares. For å se tilstanden til repositoriet når som helst, kjør ./digna repo check: den viser den sist anvendte migreringen og eventuelle ventende migreringer.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

Steg 9: Start tjenestene på nytt¶

Hvis du kjører som en systemd-tjeneste:

cd /opt/digna/bin
sudo ./start_service.sh

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

cd /opt/digna
./digna serve --address <address> --port <port>

Hvis du bruker nginx eller Apache, last inn den aktuelle webserveren på nytt:

sudo systemctl reload nginx

sudo systemctl restart apache2

På RHEL-familien bruker du SELinux-merkingen på nytt hvis dashboard-katalogen ble erstattet:

sudo restorecon -Rv /opt/digna/dashboard

Steg 10: Verifiser oppgraderingen¶

1. Bekreft utgivelsen til den nye kjørbare filen:

   ./digna version
   

   Den første linjen må være Release: 2026.11.

2. Åpne digna-dashboardet og bekreft at grensesnittet lastes inn riktig.

3. Sjekk serverloggene for feil:

   sudo journalctl -u digna -n 100
   

4. Test databasetilkoblingene dine — se Teste en tilkobling. Etter en oppgradering fra en utgivelse før 2026.06 legger du først om hver tilkobling som ikke allerede brukte ODBC, til ODBC.

For å komme i gang med de nye modulene, se digna Data Reconciliation, Koble til en AI-agent for digna MCP Server, og Profileringssted for digna Engine.