macOS Installation Guide for digna Release 2026.06¶

Release: 2026.06

Last Updated: September 5, 2026

Table of Contents¶

1. Introduktion
2. Systemkrav
3. Forudgående opsætning
4. PostgreSQL-serveropsætning
5. Webserverkonfiguration
6. Initial installation
7. Backend-konfiguration
8. Dashboard-konfiguration
9. Køre digna som baggrundstjeneste
10. Opgradering til en ny release

Introduktion¶

Om digna¶

digna er en omfattende AI-drevet platform designet til at optimere data-kvalitetsstyring på tværs af forskellige data-miljøer som warehouses, lakes og lakehouses. Bygget til at være højt skalerbar og tilpasningsdygtig, adresserer digna moderne dataudfordringer gennem automatisering, realtidsovervågning og anomalidetektion.

digna består af to hovedkomponenter:

• digna: applikationens kerne, ansvarlig for at behandle data og udføre kvalitetskontroller. Den samler backend og kommandolinjegrænsefladen i én eksekverbar fil og erstatter dermed de separate programmer dignabackend og dignacli fra tidligere releases.
• dignadashboard: Et webbaseret interface hostet på en webserver, som giver en brugervenlig måde at interagere med digna-platformen og visualisere datakvalitetsmålinger.

Hvad er nyt i Release 2026.06¶

Denne release bringer data-observability-funktionalitet direkte ind i din kode, så udviklere kan overvåge datakvalitet ved kilden. Se release notes for fulde detaljer.

Leder du efter Windows eller Linux?¶

Denne vejledning dækker macOS. For andre platforme, se Windows Installation Guide eller Linux Installation Guide.

Systemkrav¶

Før du begynder installationen, sørg for at dit system opfylder følgende minimumskrav:

Database-installationsmuligheder¶

Hvis PostgreSQL allerede er installeret: Du kan tilføje en ny database til digna på din eksisterende PostgreSQL-server.

Hvis du installerer PostgreSQL på samme maskine som digna:

Tjek din arkitektur¶

Flere stier i denne vejledning adskiller sig mellem Apple Silicon og Intel Macs. For at tjekke hvilken du har, åbn Terminal og kør:

uname -m

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

Forudgående opsætning¶

Før du installerer digna, skal du sikre, at tre nøgleforudsætninger er på plads:

1. Homebrew – pakkestyringsværktøjet brugt til at installere komponenterne nedenfor
2. PostgreSQL Server – til lagring af beregnede metrikker og performance-data
3. Web Server – til hosting af digna Dashboard

Hvis disse komponenter ikke allerede er opsat, følg afsnittene nedenfor for at installere og konfigurere dem.

Installation af Homebrew¶

Homebrew er standard pakkestyringsværktøj for macOS og bruges i hele denne vejledning til at installere PostgreSQL og nginx.

Trin 1: Tjek om Homebrew allerede er installeret¶

Åbn Terminal (tryk Cmd + Space, skriv Terminal, tryk Enter) og kør:

brew --version

Hvis der returneres et versionsnummer, spring videre til afsnittet PostgreSQL-serveropsætning.

Trin 2: Installer Homebrew¶

Hvis kommandoen ikke blev fundet, installer Homebrew ved at følge instruktionerne på den officielle Homebrew-side. Installationsprogrammet installerer også Xcode Command Line Tools, hvis de ikke allerede er til stede.

Trin 3: Tilføj Homebrew til din PATH¶

På Apple Silicon printer installatøren to kommandoer til at tilføje Homebrew til dit shell-miljø. Kør dem som instrueret, og bekræft derefter:

brew --prefix

Dette bør udskrive /opt/homebrew på Apple Silicon eller /usr/local på Intel.

PostgreSQL-serveropsætning¶

Hvis du allerede har PostgreSQL¶

Hvis PostgreSQL allerede er installeret og kører på din lokale maskine, eller hvis du bruger en administreret fjern-PostgreSQL-server, kan du springe til næste afsnit.

Installationsmuligheder¶

macOS tilbyder to ligetil måder at installere PostgreSQL på. Vælg én:

• Homebrew — kommandolinjeinstallation, anbefalet til serverudrulninger
• Postgres.app — grafisk installation, praktisk til lokal evaluering

Installation af PostgreSQL med Homebrew¶

Trin 1: Installer PostgreSQL-formulaen¶

brew install postgresql@16

Trin 2: Tilføj PostgreSQL til din PATH¶

Versionerede PostgreSQL-formulaer er keg-only, hvilket betyder, at Homebrew ikke linker deres kommandoer ind i din PATH automatisk. Tilføj dem selv:

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

Trin 3: Start PostgreSQL-tjenesten¶

brew services start postgresql@16

Dette starter PostgreSQL med det samme og konfigurerer den til at starte automatisk, når du logger ind.

Trin 4: Verificer installationen¶

psql --version

Du bør se PostgreSQL-versionen, hvis installationen lykkedes.

Trin 5: Forbind til serveren¶

psql postgres

Trin 6: Bekræft porten¶

Standard PostgreSQL-port er 5432. For at bekræfte hvilken port din server lytter på:

psql postgres -c "SHOW port;"

Notér værdien — du skal bruge den når du konfigurerer digna-backenden.

Installation af PostgreSQL med Postgres.app¶

Hvis du foretrækker en grafisk installation:

1. Download Postgres.app og træk den ind i din Applications-mappe
2. Åbn appen og klik Initialize for at oprette en ny server
3. Følg appens instruktioner for at tilføje dens kommandolinjeværktøjer til din PATH
4. Verificer installationen:

psql --version

Postgres.app opretter også en superuser med navnet på din macOS-konto.

Webserverkonfiguration¶

digna kræver en webserver til at hoste dashboardet. Vælg én af følgende muligheder:

• nginx — installeret via Homebrew, anbefalet
• Apache httpd — inkluderet i macOS

Du behøver kun at installere og konfigurere én af disse servere.

Begge sektioner konfigurerer to ting, som dashboardet afhænger af:

• En single-page-application fallback, så en opdatering af en dashboard-URL ikke returnerer en 404
• En .md MIME-type, så Markdown-filer serveres korrekt

nginx-opsætning¶

Oversigt¶

nginx er en letvægts, højtydende webserver velegnet til at serve det statiske digna-dashboard.

Installation¶

brew install nginx

Start nginx¶

brew services start nginx

Bekræft installationen¶

1. Åbn din browser
2. Navigér til http://localhost:8080
3. Du bør se nginx-velkomstsiden

Konfiguration af et site til dashboardet¶

Homebrew's nginx-konfiguration inkluderer alle filer i dens servers-mappe. Opret en dedikeret konfigurationsfil til digna der:

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

Indsæt følgende, og erstat /path/to/digna/dashboard med den faktiske sti til din udpakkede 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;
    }
}

Anvend konfigurationen¶

Test konfigurationen for syntaksfejl, og genindlæs derefter nginx:

nginx -t
brew services restart nginx

Apache httpd-opsætning¶

Oversigt¶

macOS inkluderer Apache httpd, så ingen installation er påkrævet. Den er deaktiveret som standard.

Start Apache¶

sudo apachectl start

Bekræft installationen¶

1. Åbn din browser
2. Navigér til http://localhost
3. Du bør se beskeden "It works!"

Påkrævet: Aktivér mod_rewrite¶

Dashboardet kræver URL-omskrivning. Åbn Apache-konfigurationen:

sudo nano /etc/apache2/httpd.conf

Find følgende linje og fjern den indledende # for at gøre den aktiv:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Påkrævet: Tillad .htaccess-overrides¶

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

AllowOverride None

til:

AllowOverride All

Påkrævet: MIME-type for Markdown-filer¶

Stadig i httpd.conf, tilføj følgende linje, så Markdown-filer serveres korrekt:

AddType text/markdown .md

Anvend konfigurationen¶

Tjek konfigurationen for syntaksfejl, og genstart derefter Apache:

sudo apachectl configtest
sudo apachectl restart

Initial installation¶

Trin 1: Opret digna-repositoriet¶

Digna-repositoriet lagrer alle metrikker beregnet af digna. Det fungerer som den centrale database for analytiske og performance-data.

Opret repositorieschema og bruger¶

Åbn din PostgreSQL-klient (psql, pgAdmin eller lignende) og udfø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>;

Erstat følgende pladsholdere:

• <digna_repo_schema> — Dit ønskede schema-navn (fx dignarepo)
• <digna_repo_user> — Dit ønskede brugernavn (fx digna_user)
• <digna_repo_password> — Et sikkert password til denne bruger

Eksempel:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

For at køre disse fra Terminal i ét trin:

psql postgres

Indsæt derefter statements ved prompten postgres=# og skriv \q for at afslutte.

Trin 2: Pak digna-installationspakken ud¶

1. Find digna-installations-ZIP-filen leveret til dig
2. Pak den ud til din ønskede installationsplacering — for eksempel /opt/digna eller ~/digna
3. Efter udpakning bør du se følgende elementer:
4. dashboard/ — Web dashboard interface
5. digna — Hoved-eksekverbar (backend + CLI kombineret)

For at udpakke fra Terminal:

unzip digna-2026.06-macos.zip -d /opt/digna

Gør den eksekverbare fil kørbar¶

Afhængig af hvordan arkivet blev overført, overlever den eksekverbare bit måske ikke ved udpakning. Sæt den eksplicit:

cd /opt/digna
chmod +x digna

Hvis macOS blokerer applikationen¶

Filer downloadet gennem en browser eller mailklient er mærket med et quarantine-attribut. Hvis macOS rapporterer, at appen "cannot be opened because the developer cannot be verified", fjern attributten fra installationsmappen:

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

Alternativt, åbn System Settings → Privacy & Security, find det blokerede element nær bunden af siden, og klik Open Anyway.

Trin 3: Installér licensfilen¶

1. Find den license.toml-fil der er leveret til dig
2. Kopiér den ind i root af digna-installationsmappen (hvor config.toml og den eksekverbare digna ligger)

Hvorfor det er vigtigt: Licensfilen indeholder dine kundeoplysninger, licensens udløbsdato og et digitalt signatur. Ændr ikke filen — enhver ændring vil ugyldiggøre den.

Mappe-struktur efter opsætning:

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

Backend-konfiguration¶

Trin 1: Opret og rediger konfigurationsfilen¶

Filen config_template.toml leveres i din digna-installationsmappe. Du skal blot omdøbe den til config.toml.

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

Placering: /opt/digna/config.toml

Åbn config.toml i en teksteditor og konfigurer hver sektion nedenfor.

[app] Sektionen¶

Denne sektion konfigurerer digna-backend applikationsindstillinger:

[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] Sektionen¶

Denne sektion konfigurerer forbindelsen 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] Sektionen¶

Denne sektion indeholder sikkerheds- og cookie-indstillinger:

[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] Sektion¶

Denne sektion indeholder nøglen, der bruges til at kryptere følsomme værdier i repositoryet. Den er påkrævet — config check rapporterer sektionen [encryption] som FAILED, hvis nøglen mangler.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Sektionen¶

Denne sektion konfigurerer logningsadfærden:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Trin 2: Validér konfigurationen¶

Kontrollér, at config.toml er fuldstændig og korrekt opbygget, før du initialiserer repositoryet. Kør i din digna-installationsmappe:

digna config check

Hver sektion valideres for sig, så en enkelt fejl ikke skjuler tilstanden af de øvrige:

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

Ret alt, der rapporteres som FAILED, og kør kommandoen igen, før du fortsætter. Den fulde liste over muligheder findes i CLI-referencen.

Trin 3: Initialisér repositoriet¶

1. Åbn Terminal
2. Navigér til din digna-installationsmappe (hvor config.toml og den eksekverbare digna ligger)
3. Kør forbindelsestesten:

cd /opt/digna
./digna repo check

Du bør se en bekræftelse på, at forbindelsen er etableret (selve repositoriet er endnu ikke initialiseret).

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

Trin 4: Installer repositorieschemaet¶

I samme mappe, kør:

./digna repo install

Denne kommando installerer de nødvendige tabeller og schema i din PostgreSQL-database.

Trin 5: Opret en admin-bruger¶

1. Åbn et nyt Terminal-vindue
2. Navigér til din digna-installationsmappe
3. Kør følgende kommando for at oprette en admin-bruger:

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

Eksempel:

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

Dette opretter en bruger med e-mailadressen admin@example.com og fulde administratorrettigheder.

Trin 6: Start digna-serveren¶

I digna-installationsmappen, start serveren med:

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

Parametre: - --address — Server hostname/IP - --port — Serverport

Du bør se opstartsbeskeder, der bekræfter at serveren kører:

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

Dashboard-konfiguration¶

Trin 1: Deploy dashboardet til webserveren¶

digna-dashboardet læser sin egen konfiguration fra dashboard/dashboard_config.toml. Den fil følger ikke med installationen — du opretter den i dashboard/-mappen sammen med dashboardfilerne.

Dens indhold er beskrevet under Single Sign-On, som også er der, hvor filen er nødvendig: den indeholder de login-muligheder, dashboardet tilbyder, og ved multi-instance udrulninger backend-forbindelsen.

Vælg din webserver og følg de tilsvarende deployments-steps.

Deploy til nginx¶

Hvis du fulgte afsnittet nginx Setup, peger server-blokken allerede på din dashboard-mappe og der er ingen kopiering nødvendig.

1. Bekræft stien
2. Åbn $(brew --prefix)/etc/nginx/servers/digna.conf

3. Bekræft at root peger på din udpakkede dashboard-mappe

4. Sørg for at mappen er læsbar

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

5. Genindlæs nginx

   nginx -t
   brew services restart nginx
   

6. Test installationen

7. Åbn din browser
8. Navigér til http://localhost:8080 (eller din konfigurerede URL)
9. Du bør se digna-dashboardets login-side

Deploy til Apache httpd¶

1. Kopier dashboardet til document root

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

2. Tilføj rewrite-reglerne

Opret en .htaccess-fil inde i den deployerede mappe, så dashboard-routes overlever en browser-refresh:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Indsæt 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. Genstart Apache

   sudo apachectl restart
   

2. Adgang til dashboardet

3. Åbn din browser
4. Navigér til http://localhost/digna
5. Du bør se digna-dashboardets login-side

Køre digna som baggrundstjeneste¶

Hvorfor køre digna som en tjeneste?¶

At køre digna-backenden som en baggrundstjeneste sikrer, at den:

• Starter automatisk når maskinen booter
• Kører i baggrunden uden et åbent Terminal-vindue
• Genstarter automatisk, hvis den crasher
• Kan administreres via launchctl, macOS's tjenestestyring

Tjeneste-styringsfiler¶

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

Følgende shell-scripts er tilgængelige:

• install_service.sh — registrerer digna hos launchd
• uninstall_service.sh — af-registrerer tjenesten
• start_service.sh — starter den registrerede tjeneste
• stop_service.sh — stopper den kørende tjeneste

Gør scripts kørbare¶

Udpakning bevarer måske ikke den eksekverbare bit. Før første brug:

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

Installér tjenesten¶

1. Åbn Terminal

2. Navigér til bin-mappen

   cd /opt/digna/bin
   

3. Kør installationsscriptet

   sudo ./install_service.sh
   

Digna-serveren er nu registreret hos launchd med automatisk opstart aktiveret. Tjenesten starter ikke umiddelbart — se næste afsnit for at starte den.

Start og stop af tjenesten¶

For at starte tjenesten¶

1. Åbn Terminal
2. Navigér til /opt/digna/bin
3. Kør:

   sudo ./start_service.sh
   

For at stoppe tjenesten¶

1. Åbn Terminal
2. Navigér til /opt/digna/bin
3. Kør:

   sudo ./stop_service.sh
   

Verificér tjenesten¶

For at bekræfte at tjenesten er registreret og kørende:

sudo launchctl list | grep digna

En linje der begynder med et proces-ID indikerer, at tjenesten kører. Et - i den første kolonne betyder, at den er registreret men stoppet.

Flyt tjenesten til en ny mappe¶

launchd gemmer den absolutte sti til den eksekverbare fil, så flytning af installationen kræver gen-registrering af tjenesten:

1. Afinstaller den nuværende tjeneste

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

2. Flyt applikationsfilerne

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

3. Geninstalér tjenesten

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

4. Start tjenesten

   sudo ./start_service.sh
   

Afinstallér tjenesten¶

1. Stop den kørende tjeneste

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

2. Afinstallér tjenesten

   sudo ./uninstall_service.sh
   

Digna-serveren er nu af-registreret fra launchd.

Opgradering til en ny release¶

Før du opgraderer¶

Verificér alle databaseforbindelser først

Fra Release 2026.06 når digna hver kildeteknologi via ODBC. Tidligere releases gav et valg mellem en teknologispecifik driver og ODBC, valgt med kontakten Use ODBC. digna-teamet har besluttet udelukkende at bygge på ODBC, fordi én enkelt standardgrænseflade giver mere end et sæt skræddersyede drivere:

• Godkendelse — godkendelse er en del af ODBC, så en forbindelse kan bruge alt, hvad dens driver understøtter: adgangskoder, tokens og PAT'er, Kerberos og Active Directory, MFA og browserbaseret single sign-on, cloud-identiteter, klientcertifikater og TLS. Nye metoder kommer med en driveropdatering i stedet for at vente på en digna-release.
• Drivere, der vedligeholdes af databaseleverandørerne — leverandørens egen driver følger nye serverversioner og sikkerhedsrettelser, og du kan opdatere den efter din egen plan, uafhængigt af digna.
• Én måde at konfigurere alt på — hver teknologi er en liste af nøgle/værdi-egenskaber, med samme grænseflade, samme kryptering af følsomme værdier og samme fejlfinding, i stedet for forskellige felter pr. kilde.
• Finjustering og rækkevidde — driverindstillinger som timeouts, TLS-indstillinger, proxyer og fetch-størrelser er tilgængelige for alle kilder, og enhver teknologi med en kompatibel ODBC-driver kan tilsluttes, også dem digna ikke udgiver en særskilt vejledning til.

I praksis betyder det, at kontakten Use ODBC og de separate felter til vært, port, database, bruger og adgangskode ikke længere findes. Enhver forbindelse, der ikke allerede bruger ODBC, skal lægges om til ODBC — der er ingen automatisk konvertering, så planlæg det før opgraderingen:

1. Gennemgå hver databaseforbindelse, der er defineret i din installation, og notér, hvilke der endnu ikke bruger ODBC — hver enkelt skal konfigureres om.
2. Installér den tilsvarende ODBC-driver på digna-værten — forbindelser åbnes fra den server, der kører digna-backend, ikke fra browseren. Se Installér ODBC-driveren på digna-værten.
3. Hav ODBC-egenskaberne klar for hver berørt forbindelse. Teknologivejledningerne angiver et gennemprøvet sæt egenskaber pr. kilde.

Efter opgraderingen lægger du hver berørt forbindelse om til ODBC og tester den fra dashboardet — se Opret en databaseforbindelse og Test en forbindelse.

Det er obligatorisk at lave en backup af digna-repositoriet

Før du opgraderer digna, sikkerhedskopier dit repositorie (PostgreSQL) for at beskytte imod datatab. En backup sikrer, at du kan gendanne, hvis opgraderingen støder på uventede problemer.

For at lave en backup fra Terminal:

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

Opgraderingsproces¶

Trin 1: Stop digna-tjenesten¶

Hvis digna kører som en baggrundstjeneste, stop den først:

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

Hvis digna kører i forgrunden, tryk Ctrl + C i dets Terminal-vindue.

Trin 2: Sikkerhedskopiér nuværende installation¶

Omdøb mapperne i din nuværende installation i digna-installationsmappen, så den nye release kan udrulles ved siden af dem:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Trin 3: Udpak og deploy den nye version¶

1. Udpak den nye digna-installations-ZIP-fil
2. Kopiér den nye digna-eksekverbare og dashboard-mappen til din installationsmappe
3. Genskab den eksekverbare bit og, hvis nødvendigt, fjern quarantine-attributten:

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

Trin 4: Gendan dine konfigurationsfiler¶

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'

Trin 5: Genindlæs webserveren¶

Dashboardet er et sæt statiske filer, så din webserver — og browseren — kan stadig levere den tidligere version. Genindlæs eller genstart den webserver, der hoster dashboard- mappen, og genindlæs derefter siden med en hård opdatering (Cmd+Shift+R).

Trin 6: Validér konfigurationen¶

Bekræft, at den opdaterede config.toml er fuldstændig, før du rører repositoryet:

./digna config check

Hver sektion skal rapportere OK. Ret alt, der rapporteres som FAILED, og kør kommandoen igen, før du fortsætter.

Trin 7: Udskift licensfilen¶

Hver udgivelse licenseres separat. Kopiér den license.toml, som digna-teamet har leveret til denne udgivelse, til installationsmappen, så den erstatter den gamle:

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

./digna license check

Trin 8: Opgrader repositorieschemaet¶

Navigér til din digna-installationsmappe og kør:

cd /opt/digna
./digna repo upgrade

Dette opdaterer PostgreSQL-schemaet til den nyeste version samtidig med, at alle eksisterende data bevares.

Trin 9: Genstart tjenesterne¶

Hvis du kører som baggrundstjeneste:

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

Hvis du kører manuelt, genstart serveren:

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

Hvis du bruger nginx eller Apache, genstart den respektive webserver:

brew services restart nginx

sudo apachectl restart

Trin 10: Verificér opgraderingen¶

1. Åbn digna-dashboardet
2. Bekræft at interfacet indlæses korrekt
3. Tjek serverens logs for eventuelle fejl
4. Læg hver forbindelse, der endnu ikke brugte ODBC, om til ODBC, og test derefter alle forbindelser — se Test en forbindelse