macOS installasjonsveiledning for digna Release 2026.06¶

Release: 2026.06

Sist oppdatert: 5. september 2026

Innholdsfortegnelse¶

1. Introduksjon
2. Systemkrav
3. Forberedelser før installasjon
4. PostgreSQL-serveroppsett
5. Webserverkonfigurasjon
6. Første installasjon
7. Backend-konfigurasjon
8. Dashboard-konfigurasjon
9. Kjøre digna som en bakgrunnstjeneste
10. Oppgradere til en ny release

Introduksjon¶

Om digna¶

digna er en omfattende, AI-drevet plattform designet for å optimalisere datakvalitetsstyring på tvers av ulike dataomgivelser som warehouses, lakes og lakehouses. Bygget for høy skalerbarhet og tilpasningsevne, møter 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 datakvalitetsmetrikker.

Hva er nytt i Release 2026.06¶

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

Ser du etter Windows eller Linux?¶

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

Systemkrav¶

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

Databaseinstallasjonsvalg¶

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 arkitekturen din¶

Flere stier i denne veiledningen varierer mellom Apple Silicon og Intel-Mac. For å sjekke hvilken du har, åpne Terminal og kjør:

uname -m

• arm64 — Apple Silicon. Homebrew installeres til /opt/homebrew.
• x86_64 — Intel. Homebrew installeres til /usr/local.

Forberedelser før installasjon¶

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

1. Homebrew – pakkebehandleren som brukes til å installere komponentene nedenfor
2. PostgreSQL Server – for lagring av beregnede metrikker og ytelsesdata
3. Webserver – for hosting av digna Dashboard

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

Installere Homebrew¶

Homebrew er standard pakkebehandler for macOS og brukes gjennom hele denne veiledningen for å installere PostgreSQL og nginx.

Trinn 1: Sjekk om Homebrew allerede er installert¶

Åpne Terminal (trykk Cmd + Space, skriv Terminal, trykk Enter) og kjør:

brew --version

Hvis et versjonsnummer returneres, hopp til avsnittet om PostgreSQL-serveroppsett.

Trinn 2: Installer Homebrew¶

Hvis kommandoen ikke ble funnet, installer Homebrew ved å følge instruksjonene på offisielle Homebrew-nettsiden. Installeringsprogrammet installerer også Xcode Command Line Tools hvis de ikke allerede er til stede.

Trinn 3: Legg Homebrew til i PATH¶

På Apple Silicon skriver installasjonsprogrammet to kommandoer for å legge Homebrew til ditt shell-miljø. Kjør dem som angitt, og bekreft deretter:

brew --prefix

Dette skal skrive ut /opt/homebrew på Apple Silicon eller /usr/local på Intel.

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 ekstern PostgreSQL-server, kan du hoppe til neste avsnitt: Webserverkonfigurasjon.

Installasjonsalternativer¶

macOS tilbyr to enkle måter å installere PostgreSQL på. Velg én:

• Homebrew — kommandolinjeinstallasjon, anbefales for serverdistribusjoner
• Postgres.app — grafisk installasjon, praktisk for lokal evaluering

Installere PostgreSQL med Homebrew¶

Trinn 1: Installer PostgreSQL-formelen¶

brew install postgresql@16

Trinn 2: Legg PostgreSQL til i PATH¶

Versjonsbundne PostgreSQL-formler er keg-only, som betyr at Homebrew ikke lenker kommandoene deres inn i PATH automatisk. Legg dem til selv:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Trinn 3: Start PostgreSQL-tjenesten¶

brew services start postgresql@16

Dette starter PostgreSQL umiddelbart og konfigurerer den til å starte automatisk når du logger inn.

Trinn 4: Verifiser installasjonen¶

psql --version

Du skal se PostgreSQL-versjonen hvis installasjonen var vellykket.

Trinn 5: Koble til serveren¶

psql postgres

Trinn 6: Bekreft porten¶

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

psql postgres -c "SHOW port;"

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

Installere PostgreSQL med Postgres.app¶

Hvis du foretrekker en grafisk installasjon:

1. Last ned Postgres.app og dra den til Applications-mappen
2. Åpne appen og klikk Initialize for å opprette en ny server
3. Følg appens instruksjoner for å legge til dens kommandolinjeverktøy i PATH
4. Verifiser installasjonen:

psql --version

Postgres.app oppretter også en superbruker med navnet til din macOS-konto.

Webserverkonfigurasjon¶

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

• nginx — installert via Homebrew, anbefales
• Apache httpd — inkludert i macOS

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

Begge seksjonene konfigurerer to ting som dashboardet er avhengig av:

• Fallback for single-page application, slik at oppdatering av en dashboard-URL ikke gir 404
• En .md MIME-type, slik at Markdown-filer serveres riktig

nginx-oppsett¶

Oversikt¶

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

Installering¶

brew install nginx

Starte nginx¶

brew services start nginx

Verifiser installasjonen¶

1. Åpne nettleseren din
2. Naviger til http://localhost:8080
3. Du skal se nginx-velkomstsiden

Konfigurere et nettsted for dashboardet¶

Homebrews nginx-konfigurasjon inkluderer alle filer i katalogen servers. Opprett en dedikert konfigurasjonsfil for digna der:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Lim inn følgende og erstatt /path/to/digna/dashboard med den faktiske banen til din utpakkede dashboard-mappe:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/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;
    }
}

Bruk konfigurasjonen¶

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

nginx -t
brew services restart nginx

Apache httpd-oppsett¶

Oversikt¶

macOS inkluderer Apache httpd, så ingen installasjon er nødvendig. Tjenesten er deaktivert som standard.

Starte Apache¶

sudo apachectl start

Verifiser installasjonen¶

1. Åpne nettleseren din
2. Naviger til http://localhost
3. Du skal se meldingen "It works!"

Påkrevd: Aktivere mod_rewrite¶

Dashboardet krever URL-omskriving. Åpne Apache-konfigurasjonen:

sudo nano /etc/apache2/httpd.conf

Finn følgende linje og fjern ledende # for å avkommentere den:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Påkrevd: Tillat .htaccess-overstyringer¶

I samme fil, lokaliser blokken <Directory "/Library/WebServer/Documents"> og endre:

AllowOverride None

til:

AllowOverride All

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

Fremdeles i httpd.conf, legg til følgende linje slik at Markdown-filer serveres riktig:

AddType text/markdown .md

Bruk konfigurasjonen¶

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

sudo apachectl configtest
sudo apachectl restart

Første installasjon¶

Trinn 1: Sett opp digna-repositoriet¶

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

Opprett repositories-skjema og bruker¶

Åpne din PostgreSQL-klient (psql, pgAdmin eller lignende) og utfø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 Terminal i ett steg:

psql postgres

Lim deretter inn utsagnene ved postgres=# prompten og skriv \q for å avslutte.

Trinn 2: Pakk ut digna-installasjonspakken¶

1. Finn digna-installasjons ZIP-filen du har fått
2. Pakk den ut til ønsket installasjonssted — for eksempel /opt/digna eller ~/digna
3. Etter utpakking bør du se følgende elementer:
4. dashboard/ — Web dashboard-grensesnitt
5. digna — Hovedkjørbar fil (backend + CLI kombinert)

For å pakke ut fra Terminal:

unzip digna-2026.06-macos.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
chmod +x digna

Hvis macOS blokkerer applikasjonen¶

Filer lastet ned via en nettleser eller mailklient tagges med et karanteneattributt. Hvis macOS rapporterer at appen "cannot be opened because the developer cannot be verified", fjern attributtet fra installasjonskatalogen:

xattr -dr com.apple.quarantine /opt/digna

Alternativt, åpne System Settings → Privacy & Security, finn det blokkerte elementet nær bunnen av siden, og klikk Open Anyway.

Trinn 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-filen ligger)

Hvorfor dette er viktig: Lisensfilen inneholder kundeinformasjon, lisensens utløpsdato og digital signatur. Endre ikke denne filen — eventuelle endringer vil ugyldiggjøre den.

Katalogstruktur etter oppsett:

/opt/digna/
├── config.toml         (konfigurasjonsfil)
├── license.toml        (DIN LISENSFIL - kopier hit)
├── digna               (hovedkjørbar fil)
├── bin/                (skripter for tjenestehåndtering)
└── dashboard/          (webgrensesnitt)
    └── (dashboard-filer)

Backend-konfigurasjon¶

Trinn 1: Opprett og rediger konfigurasjonsfilen¶

Filen config_template.toml leveres i digna-installasjonskatalogen. Du trenger bare å gi den nytt navn til config.toml.

cd /opt/digna
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 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 = ["*"]

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

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

[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 loggeadferd:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

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 Terminal
2. Naviger til din digna-installasjonsmappe (der config.toml og den kjørbare digna-filen ligger)
3. Kjør tilkoblingstesten:

cd /opt/digna
./digna repo check

Du bør se en bekreftelse på at tilkoblingen er etablert (selve repositoriet er ennå ikke initialisert).

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

Trinn 4: Installer repositories-skjemaet¶

I samme katalog, kjør:

./digna repo install

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

Trinn 5: Opprett en admin-bruker¶

1. Åpne et nytt Terminal-vindu
2. Naviger til digna-installasjonsmappen
3. Kjør følgende kommando for å opprette en admin-bruker:

./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.

Trinn 6: Start digna-serveren¶

I digna-installasjonskatalogen, start serveren med:

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

Parametere: - --address — Serverens vertsnavn/IP - --port — Serverport

Du skal se oppstarts-meldinger 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

Dashboard-konfigurasjon¶

Trinn 1: Distribuer 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 din webserver og følg de tilsvarende distribusjonstrinnene.

Distribuere til nginx¶

Hvis du fulgte nginx-oppsettet er serverblokken allerede pekt mot din dashboard-mappe og ingen kopiering er nødvendig.

1. Bekreft banen
2. Åpne $(brew --prefix)/etc/nginx/servers/digna.conf

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

4. Sørg for at mappen er lesbar

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

5. Last inn nginx på nytt

   nginx -t
   brew services restart nginx
   

6. Test installasjonen

7. Åpne nettleseren din
8. Naviger til http://localhost:8080 (eller din konfigurerte URL)
9. Du skal se innloggingssiden for digna-dashboardet

Distribuere til Apache httpd¶

1. Kopier dashboardet til dokumentroten

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Legg til omskrivingsreglene

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

sudo nano /Library/WebServer/Documents/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. Start Apache på nytt

   sudo apachectl restart
   

2. Åpne dashboardet

3. Åpne nettleseren din
4. Naviger til http://localhost/digna
5. Du skal se innloggingssiden for digna-dashboardet

Kjøre digna som en bakgrunnstjeneste¶

Hvorfor kjøre digna som en tjeneste?¶

Å kjøre digna-backenden som en bakgrunnstjeneste sikrer at den:

• Startes automatisk når maskinen booter
• Kjører i bakgrunnen uten et åpent Terminal-vindu
• Startes på nytt automatisk hvis den krasjer
• Kan administreres via launchctl, macOS sin tjenestehåndterer

Filer for tjenesteadministrasjon¶

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

Følgende shell-skript er tilgjengelige:

• install_service.sh — registrerer digna med launchd
• uninstall_service.sh — avregistrerer tjenesten
• start_service.sh — starter den registrerte tjenesten
• stop_service.sh — stopper den kjørende tjenesten

Gjør skriptene kjørbare¶

Utpakking kan fjernet kjørbar-bit. Før første bruk:

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

Installere tjenesten¶

1. Åpne Terminal

2. Gå til bin-mappen

   cd /opt/digna/bin
   

3. Kjør installasjonsskriptet

   sudo ./install_service.sh
   

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

Starte og stoppe tjenesten¶

For å starte tjenesten¶

1. Åpne Terminal
2. Naviger til /opt/digna/bin
3. Kjør:

   sudo ./start_service.sh
   

For å stoppe tjenesten¶

1. Åpne Terminal
2. Naviger til /opt/digna/bin
3. Kjør:

   sudo ./stop_service.sh
   

Verifisere tjenesten¶

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

sudo launchctl list | grep digna

En linje som begynner med en prosess-ID indikerer at tjenesten kjører. En - i den første kolonnen betyr at den er registrert, men stoppet.

Flytte tjenesten til en ny katalog¶

launchd lagrer den absolutte banen til den kjørbare filen, så relokering krever re-registrering av tjenesten:

1. Avinstaller gjeldende tjeneste

   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 launchd.

Oppgradere til en ny release¶

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.

Å lage en backup av digna-repositoriet er obligatorisk

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

For å lage en backup fra Terminal:

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

Oppgraderingsprosessen¶

Trinn 1: Stopp digna-tjenesten¶

Hvis digna kjører som en bakgrunnstjeneste, stopp den først:

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

Hvis digna kjører i forgrunnen, trykk Ctrl + C i Terminal-vinduet hvor den kjører.

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:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Trinn 3: Pakk ut og distribuer ny versjon¶

1. Pakk ut den nye digna-installasjons ZIP-filen
2. Kopier den nye digna-kjørbare filen og dashboard-mappen til installasjonskatalogen din
3. Gjenopprett kjørbar-bit og, hvis nødvendig, fjern karanteneattributtet:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Trinn 4: Gjenopprett konfigurasjonsfilene dine¶

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

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 (Cmd+Shift+R).

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:

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

./digna license check

Trinn 8: Oppgrader repository-skjemaet¶

Naviger til din digna-installasjonskatalog og kjør:

cd /opt/digna
./digna repo upgrade

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

Trinn 9: Start tjenestene på nytt¶

Hvis du kjører som en bakgrunnstjeneste:

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, start den respektive webserveren på nytt:

brew services restart nginx

sudo apachectl restart

Trinn 10: Verifiser oppgraderingen¶

1. Åpne digna-dashboardet
2. Bekreft 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