macOS-installationsguide för digna Release 2026.06¶
Release: 2026.06
Senast uppdaterad: 5 september 2026
Innehållsförteckning¶
- Introduktion
- Systemkrav
- Förberedelser före installation
- Förbered PostgreSQL-servern
- Webbserverkonfiguration
- Initial installation
- Backend-konfiguration
- Dashboard-konfiguration
- Köra digna som bakgrundstjänst
- Uppgradera till en ny release
Introduktion¶
Om digna¶
digna är en omfattande AI-driven plattform utformad för att optimera datakvalitetshantering i olika data-miljöer såsom datalager, datasjöar och lakehouses. Byggd för hög skalbarhet och anpassningsförmåga, digna hanterar moderna datautmaningar genom automatisering, realtidsövervakning och avvikelsedetektion.
digna består av två huvudkomponenter:
- digna: applikationens kärna, ansvarig för att bearbeta data och utföra kvalitetskontroller. Den förenar backend och kommandoradsgränssnittet i en enda körbar fil och ersätter därmed de separata programmen
dignabackendochdignaclifrån tidigare releaser. - dignadashboard: Ett webbaserat gränssnitt som körs på en webbserver och ger ett användarvänligt sätt att interagera med digna-plattformen och visualisera datakvalitetsmått.
Nytt i Release 2026.06¶
Den här releasen för in data-observability-möjligheter direkt i din kod, vilket gör det möjligt för utvecklare att övervaka datakvalitet vid källan. Se release notes för fullständiga detaljer.
Letar du efter Windows eller Linux?¶
Denna guide täcker macOS. För andra plattformar, se Windows Installation Guide eller Linux Installation Guide.
Systemkrav¶
Innan du påbörjar installationen, se till att ditt system uppfyller följande minimikrav:
| Krav | Specifikation |
|---|---|
| Operativsystem | macOS 13 (Ventura) eller senare |
| Arkitektur | Apple Silicon (arm64) eller Intel (x86_64) |
| Minne (minimalkonfiguration) | 16 GB RAM |
| Diskutrymme | 10 GB tillgängligt lagringsutrymme |
| Databas | PostgreSQL Server 12 eller senare |
| Webbserver | nginx, Apache httpd eller motsvarande |
| Kommandoradsverktyg | Xcode Command Line Tools (krävs av Homebrew) |
Alternativ för databasinstallation¶
Om PostgreSQL redan är installerat: Du kan lägga till en ny databas för digna i din befintliga PostgreSQL-server.
Om du installerar PostgreSQL på samma maskin som digna:
Rekommenderade specifikationer
- Minne: 32 GB RAM (istället för 16 GB)
- Diskutrymme: 50 GB tillgängligt lagringsutrymme (istället för 10 GB)
Dessa högre specifikationer rymmer både digna och PostgreSQL-databasen som körs samtidigt.
Kontrollera din arkitektur¶
Flera sökvägar i denna guide skiljer sig mellan Apple Silicon och Intel-Mac. För att kontrollera vilken arkitektur du har, öppna Terminal och kör:
arm64— Apple Silicon. Homebrew installeras till/opt/homebrew.x86_64— Intel. Homebrew installeras till/usr/local.
Tips
Istället för att hårdkoda någon av sökvägarna använder denna guide $(brew --prefix), vilket expanderar till rätt plats på båda arkitekturer. Du kan kopiera kommandona rakt av.
Förberedelser före installation¶
Innan du installerar digna, säkerställ att tre nyckelförutsättningar är på plats:
- Homebrew – paketchefen som används för att installera komponenterna nedan
- PostgreSQL Server – för att lagra beräknade mått och prestandadata
- Webbserver – för att hosta digna Dashboard
Om dessa komponenter inte redan är uppsatta, följ avsnitten nedan för att installera och konfigurera dem.
Installera Homebrew¶
Homebrew är standardpakethanteraren för macOS och används i hela denna guide för att installera PostgreSQL och nginx.
Steg 1: Kontrollera om Homebrew redan är installerat¶
Öppna Terminal (tryck Cmd + Space, skriv Terminal, tryck Enter) och kör:
Om ett versionsnummer returneras, hoppa till avsnittet Förbered PostgreSQL-servern.
Steg 2: Installera Homebrew¶
Om kommandot inte hittades, installera Homebrew genom att följa instruktionerna på officiella Homebrew-sajten. Installationsprogrammet installerar även Xcode Command Line Tools om de inte redan finns.
Steg 3: Lägg till Homebrew i din PATH¶
På Apple Silicon skriver installatören ut två kommandon för att lägga till Homebrew i din shell-miljö. Kör dem enligt instruktionerna och bekräfta sedan:
Detta bör skriva ut /opt/homebrew på Apple Silicon eller /usr/local på Intel.
Förbered PostgreSQL-servern¶
Om du redan har PostgreSQL¶
Om PostgreSQL redan är installerat och körs lokalt eller om du använder en hanterad fjärr-PostgreSQL-server kan du hoppa till nästa avsnitt.
Installationsalternativ¶
macOS erbjuder två enkla sätt att installera PostgreSQL. Välj ett:
- Homebrew — kommandoradsinstallation, rekommenderas för serverdistributioner
- Postgres.app — grafisk installation, bekvämt för lokal utvärdering
Installera PostgreSQL med Homebrew¶
Steg 1: Installera PostgreSQL-formeln¶
Steg 2: Lägg till PostgreSQL i din PATH¶
Versionerade PostgreSQL-formler är keg-only, vilket innebär att Homebrew inte länkar deras kommandon till din PATH automatiskt. Lägg till dem själv:
Notera
Detta förutsätter standard-shellet zsh som används av macOS. Om du använder bash, lägg till samma rad i ~/.bash_profile istället.
Steg 3: Starta PostgreSQL-tjänsten¶
Detta startar PostgreSQL omedelbart och konfigurerar det för att starta automatiskt när du loggar in.
Steg 4: Verifiera installationen¶
Du bör se PostgreSQL-versionen om installationen lyckades.
Steg 5: Anslut till servern¶
Varning — macOS skiljer sig från Windows här
Windows-installationsprogrammet uppmanar dig att skapa en postgres-superuser och lösenord. Homebrew gör inte det. Istället skapas en superuser med namnet efter ditt macOS-konto, utan lösenord, åtkomlig endast från den lokala maskinen.
Detta innebär att det inte finns någon postgres-roll på en färsk Homebrew-installation. Använd ditt eget kontonamn när du behöver en superuser, och skapa en uttrycklig digna-användare enligt beskrivningen i Initial installation.
Steg 6: Bekräfta porten¶
Standardporten för PostgreSQL är 5432. För att bekräfta vilken port din server lyssnar på:
Notera värdet — du kommer att behöva det när du konfigurerar digna-backend.
Installera PostgreSQL med Postgres.app¶
Om du föredrar en grafisk installation:
- Ladda ner Postgres.app och dra den till din Applications-mapp
- Öppna appen och klicka Initialize för att skapa en ny server
- Följ appens instruktioner för att lägga till dess kommandoradsverktyg i din PATH
- Verifiera installationen:
Postgres.app skapar också en superuser med namnet efter ditt macOS-konto.
Webbserverkonfiguration¶
digna kräver en webbserver för att hosta dashboarden. Välj ett av följande alternativ:
- nginx — installerat via Homebrew, rekommenderas
- Apache httpd — inkluderat i macOS
Du behöver bara installera och konfigurera en av dessa servrar.
Båda avsnitten konfigurerar två saker som dashboarden är beroende av:
- Fallback för single-page application, så att uppdatering av en dashboard-URL inte ger 404
- En
.mdMIME-typ, så att Markdown-filer serveras korrekt
nginx-inställning¶
Översikt¶
nginx är en lättviktig, högpresterande webbserver väl lämpad för att servera den statiska digna-dashboarden.
Installation¶
Starta nginx¶
Verifiera installationen¶
- Öppna din webbläsare
- Navigera till
http://localhost:8080 - Du bör se nginx välkomstsida
Notera — standardport är 8080, inte 80
Homebrew konfigurerar nginx att lyssna på port 8080 så att det kan köras utan administratörsbehörighet. På macOS krävs root för att binda till port 80 eller någon annan port under 1024.
För att servera dashboarden på port 80, ändra listen 8080; till listen 80; i konfigurationen nedan och starta nginx med sudo brew services start nginx istället.
Konfigurera en site för dashboarden¶
Homebrews nginx-konfiguration inkluderar alla filer i dess servers-katalog. Skapa en dedikerad konfigurationsfil för digna där:
Klistra in följande och ersätt /path/to/digna/dashboard med den faktiska sökvägen till din extraherade dashboard-mapp:
server {
listen 8080;
server_name localhost;
root /path/to/digna/dashboard;
index index.html;
# Servera Markdown-filer med korrekt MIME-typ.
types {
text/markdown md;
}
# Fallback för single-page-application: okända sökvägar returnerar index.html
# istället för en 404, så dashboard-rutter överlever en webbläsaruppdatering.
location / {
try_files $uri $uri/ /index.html;
}
}
Varning
Utan try_files-direktivet kommer omladdning av någon dashboard-sida utöver rot-URL:en att ge en 404. Detta är nginx-ekvivalenten till URL Rewrite-modulen som krävs av IIS på Windows.
Tillämpa konfigurationen¶
Testa syntaxen i konfigurationen och ladda om nginx:
Apache httpd-inställning¶
Översikt¶
macOS inkluderar Apache httpd, så ingen installation krävs. Den är som standard inaktiverad.
Starta Apache¶
Verifiera installationen¶
- Öppna din webbläsare
- Navigera till
http://localhost - Du bör se meddelandet "It works!"
Obligatoriskt: Aktivera mod_rewrite¶
Dashboarden kräver URL-omskrivning. Öppna Apache-konfigurationen:
Hitta följande rad och ta bort inledande # för att avkommentera den:
Obligatoriskt: Tillåt .htaccess-överriding¶
I samma fil, lokalisera <Directory "/Library/WebServer/Documents">-blocket och ändra:
till:
Obligatoriskt: MIME-typ för Markdown-filer¶
Fortfarande i httpd.conf, lägg till följande rad så att Markdown-filer serveras korrekt:
Varning
Utan denna inställning kan .md-filer inte serveras korrekt.
Tillämpa konfigurationen¶
Kontrollera konfigurationen för syntaxfel och starta om Apache:
Initial installation¶
Steg 1: Skapa digna-repositoriet¶
digna-repositoriet lagrar alla mått som beräknas av digna. Det fungerar som den centrala databasen för analytiska och prestandadata.
Skapa repository-schema och användare¶
Öppna din PostgreSQL-klient (psql, pgAdmin eller liknande) och kör följande SQL-kommandon:
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>;
Ersätt följande platshållare:
<digna_repo_schema>— Ditt önskade schemanamn (t.ex.dignarepo)<digna_repo_user>— Ditt önskade användarnamn (t.ex.digna_user)<digna_repo_password>— Ett säkert lösenord för denna användare
Exempel:
CREATE SCHEMA dignarepo;
CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';
GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;
För att köra dessa från Terminal i ett steg:
Klistra sedan in kommandona vid postgres=# prompten och skriv \q för att avsluta.
Bästa praxis
Använd starka, komplexa lösenord för databas-användare. Undvik lättgissade uppgifter.
Steg 2: Extrahera digna-installationspaketet¶
- Lokalisera digna-installationsfilen (ZIP) som tillhandahållits
- Extrahera den till önskad installationsplats — till exempel
/opt/dignaeller~/digna - Efter extraktion bör du se följande objekt:
dashboard/— Webbgränssnittetdigna— Huvudkörbar fil (backend + CLI kombinerat)
Konfigurations- och licensfilerna ingår inte i paketet
Varken config.toml eller dashboard/dashboard_config.toml medföljer installationen — du skapar båda själv, i Backendkonfiguration och Dashboardkonfiguration. Inte heller license.toml medföljer; digna levererar den separat, enligt beskrivningen i steg 3.
För att extrahera från Terminal:
Gör den körbara filen körbar¶
Beroende på hur arkivet överfördes kan exekveringsbiten ha försvunnit vid extraktion. Sätt den explicit:
Om macOS blockerar applikationen¶
Filer som laddats ner via webbläsare eller e-postklienter taggas med ett karantänattribut. Om macOS rapporterar att appen "cannot be opened because the developer cannot be verified", ta bort attributet från installationskatalogen:
Alternativt, öppna System Settings → Privacy & Security, hitta det blockerade objektet nära botten av sidan och klicka Open Anyway.
Notera
Detta steg behövs endast om macOS faktiskt blockerar den körbara filen. Paket som överförts över SSH eller från interna filresurser är vanligtvis inte karantänmärka.
Steg 3: Installera licensfilen¶
Varning
Licensfilen ingår inte i installationspaketet och kommer att tillhandahållas separat av digna.
- Lokalisera
license.toml-filen som tillhandahållits - Kopiera den till rotkatalogen för digna-installationen (där
config.tomloch den körbaradignafinns)
Varför detta är viktigt: Licensfilen innehåller din kundinformation, licensens utgångsdatum och digital signatur. Ändra inte denna fil — alla ändringar gör den ogiltig.
Katalogstruktur efter installation:
/opt/digna/
├── config.toml (konfigurationsfil)
├── license.toml (DIN LICENSFIL - kopiera hit)
├── digna (huvudkörbar fil)
├── bin/ (skript för tjänstehantering)
└── dashboard/ (webbgränssnitt)
└── (dashboard-filer)
Backend-konfiguration¶
Steg 1: Skapa och redigera konfigurationsfilen¶
Filen config_template.toml medföljer din digna-installation. Du behöver bara byta namn till config.toml.
Plats: /opt/digna/config.toml
Öppna config.toml i en textredigerare och konfigurera varje avsnitt nedan.
[app] Avsnittet¶
Detta avsnitt konfigurerar digna-backendens applikationsinställningar:
[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 | Värde | Anteckningar |
|---|---|---|
digna_APP_CORS_ALLOW_ORIGINS | Frontend-URL | Om dashboarden ligger på annan server, inkludera dess URL |
digna_APP_CORS_ALLOW_CREDENTIALS | true | Krävs för CORS med referenser |
digna_APP_CORS_ALLOW_METHODS | ["*"] | Tillåt alla HTTP-metoder |
digna_APP_CORS_ALLOW_HEADERS | ["*"] | Tillåt alla headers |
Notera
Om du serverar dashboarden från Homebrews nginx på dess standardport, är origin som ska tillåtas http://localhost:8080.
[repo] Avsnittet¶
Detta avsnitt konfigurerar anslutningen till 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 | Värde | Anteckningar |
|---|---|---|
digna_REPO_HOST | localhost eller IP | PostgreSQL-serverns värdnamn/IP |
digna_REPO_PORT | 5432 (standard) | PostgreSQL-port |
digna_REPO_DB | postgres | Databasnamn |
digna_REPO_SCHEMA | dignarepo | Schema som skapades tidigare |
digna_REPO_USER | digna_user | Användare skapad i PostgreSQL-uppsättningen |
digna_REPO_PASSWORD | Ditt lösenord | Lösenord satt vid schema-skapandet |
[base] Avsnittet¶
Detta avsnitt innehåller säkerhets- och cookie-inställningar:
[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 | Värde | Anteckningar |
|---|---|---|
DIGNA_FERNET_KEY | Krypteringsnyckel | Används för att kryptera tokens och cookies (standard medföljer) |
digna_COOKIE_DOMAIN | localhost | Matcha din frontend-domän |
digna_COOKIE_SECURE | false (lokalt) / true (produktion) | Använd true för HTTPS-anslutningar |
digna_COOKIE_HTTPONLY | true | Alltid aktiverat för säkerhet |
digna_COOKIE_SAME_SITE | lax | Förhindrar CSRF-attacker |
digna_TOKEN_EXPIRES_IN | 86400 (24 timmar) | Sessionsutgång i sekunder |
digna_MAX_WORKERS | Antal CPU-kärnor - 1 | Antal parallella inspektionsjobb |
DIGNA_SCHEDULER_MAX_DELAY | 100 | Maximal fördröjning, i sekunder, som schemaläggaren får lägga till innan ett förfallet jobb startar |
DIGNA_CLEANUP_TIME | "12:00" | Tidpunkt (24-timmarsformat HH:MM) då den dagliga rensningen startar |
Tips
För att hitta antalet CPU-kärnor på din Mac, kör sysctl -n hw.ncpu.
[encryption] Sektionen¶
Denna sektion innehåller nyckeln som används för att kryptera känsliga värden i repositoryt. Den är obligatorisk — config check rapporterar sektionen [encryption] som FAILED om nyckeln saknas.
| Parameter | Värde | Noter |
|---|---|---|
DIGNA_ENCRYPTION_KEY | Base64-kodad nyckel | Krypterar känsliga värden som lagras i digna-repositoryt |
Skydda config.toml
Den här nyckeln är ett fast värde, identiskt i alla digna-installationer, och det är den som dekrypterar de känsliga värdena i ditt repository. Begränsa config.toml till det konto som kör digna, håll filen utanför versionshantering och delade enheter, och undanta den från varje säkerhetskopia som förvaras mindre säkert än repositoryt självt.
[logging] Avsnittet¶
Detta avsnitt konfigurerar logghantering:
| Parameter | Värde | Anteckningar |
|---|---|---|
digna_LOGGING_MODE | INFO eller DEBUG | INFO för produktion, DEBUG för felsökning |
digna_LOGGING_BACKUP_COUNT | 10 | Antal dagliga loggbackup som ska behållas |
Steg 2: Validera konfigurationen¶
Kontrollera att config.toml är fullständig och korrekt uppbyggd innan du initierar repositoryt. Kör i din digna-installationskatalog:
Varje sektion valideras för sig, så att ett enskilt fel inte döljer tillståndet hos de övriga:
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
Åtgärda allt som rapporteras som FAILED och kör kommandot igen innan du fortsätter. Den fullständiga listan över alternativ finns i CLI-referensen.
Steg 3: Initiera repositoriet¶
- Öppna Terminal
- Navigera till din digna-installationskatalog (där
config.tomlochdigna-körbara finns) - Kör anslutningstestet:
Du bör se en bekräftelse på att anslutningen är etablerad (själva repositoriet har ännu inte initialiserats).
Notera
På macOS finns inte kommandon i den aktuella katalogen på din PATH, så den körbara anropas som ./digna istället för digna. För att använda kortformen överallt, lägg till installationskatalogen i din PATH:
Steg 4: Installera repository-schemat¶
I samma katalog, kör:
Detta kommando installerar nödvändiga tabeller och schema i din PostgreSQL-databas.
Steg 5: Skapa en administratörsanvändare¶
- Öppna ett nytt Terminalfönster
- Navigera till din digna-installationskatalog
- Kör följande kommando för att skapa en admin-användare:
Exempel:
Detta skapar en användare med e-postadressen admin@example.com och fullständiga administratörsrättigheter.
Tips
Omge lösenordet med enkla citattecken. zsh behandlar tecken som !, $ och * särskilt, och ett oavgränsat lösenord som innehåller dem skickas inte som avsett.
Bästa praxis
Använd ett starkt lösenord med en blandning av versaler, gemener, siffror och specialtecken.
Steg 6: Starta digna-servern¶
I digna-installationskatalogen, starta servern med:
Parametrar: - --address — Serverns värdnamn/IP - --port — Serverns port
Du bör se startmeddelanden som bekräftar att servern körs:
INFO: Started server process [1234]
INFO: Waiting for application startup.
INFO: Application startup complete
INFO: Uvicorn running on http://localhost:8082
Tips
Första gången du startar servern kan macOS fråga om du vill tillåta att applikationen accepterar inkommande nätverksanslutningar. Klicka Allow, annars kommer inte dashboarden att kunna nå backend.
Servern upptar terminalen
serve körs i förgrunden och fortsätter tills du stoppar den med Ctrl+C. Låt den vara igång medan du slutför installationen; för att i stället starta den automatiskt vid uppstart, se Köra digna som bakgrundstjänst.
Dashboard-konfiguration¶
Steg 1: Distribuera dashboarden till webbservern¶
digna-dashboarden läser sin egen konfiguration från dashboard/dashboard_config.toml. Den filen medföljer inte installationen — du skapar den i katalogen dashboard/ bredvid dashboardfilerna.
Dess innehåll beskrivs under Enkel inloggning (SSO), som också är där filen behövs: den innehåller de inloggningsalternativ som dashboarden erbjuder och, vid uppsättningar med flera instanser, backend-anslutningen.
Välj din webbserver och följ motsvarande distribution steg.
Distribuera till nginx¶
Om du följde avsnittet nginx-inställning, pekar serverblocket redan mot din dashboard-mapp och ingen kopiering krävs.
- Bekräfta sökvägen
- Öppna
$(brew --prefix)/etc/nginx/servers/digna.conf -
Verifiera att
rootpekar på din extraheradedashboard-mapp -
Se till att mappen är läsbar
-
Ladda om nginx
-
Testa installationen
- Öppna din webbläsare
- Navigera till
http://localhost:8080(eller din konfigurerade URL) - Du bör se digna dashboard-inloggningssidan
Distribuera till Apache httpd¶
-
Kopiera dashboarden till dokumentroten
-
Lägg till omskrivningsregler
Skapa en .htaccess-fil inne i den deployade mappen så att dashboard-rutter överlever en webbläsaruppdatering:
Klistra in följande:
RewriteEngine On
RewriteBase /digna/
# Servera befintliga filer och kataloger som de är.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]
# Allt annat faller tillbaka till single-page-application-entrén.
RewriteRule ^ index.html [L]
-
Starta om Apache
-
Nå dashboarden
- Öppna din webbläsare
- Navigera till
http://localhost/digna - Du bör se digna dashboard-inloggningssidan
Köra digna som bakgrundstjänst¶
Varför köra digna som tjänst?¶
Att köra digna-backenden som en bakgrundstjänst säkerställer att den:
- Startar automatiskt när maskinen bootar
- Körs i bakgrunden utan öppet Terminal-fönster
- Startas om automatiskt om den kraschar
- Kan hanteras via
launchctl, macOS servicehanterare
Filer för tjänstehantering¶
Alla nödvändiga filer finns i digna-installationskatalogen under: bin/
Följande shell-skript finns:
install_service.sh— registrerar digna med launchduninstall_service.sh— avregistrerar tjänstenstart_service.sh— startar den registrerade tjänstenstop_service.sh— stoppar den körande tjänsten
Administratör krävs
Alla skript måste köras med sudo, eftersom registrering av en tjänst som startar vid boot skriver till /Library/LaunchDaemons.
Gör skripten körbara¶
Extraktion kanske inte bevarar exekveringsbiten. Innan första användning:
Installera tjänsten¶
-
Öppna Terminal
-
Navigera till bin-mappen
-
Kör installationsskriptet
Digna-servern är nu registrerad i launchd med automatisk uppstart aktiverad. Tjänsten startar inte omedelbart — se nästa avsnitt för att starta den.
Starta och stoppa tjänsten¶
För att starta tjänsten¶
- Öppna Terminal
- Navigera till
/opt/digna/bin - Kör:
För att stoppa tjänsten¶
- Öppna Terminal
- Navigera till
/opt/digna/bin - Kör:
Tips
Stoppa alltid tjänsten innan du uppdaterar applikationsfiler.
Verifiera tjänsten¶
För att bekräfta att tjänsten är registrerad och körs:
En rad som börjar med ett process-ID indikerar att tjänsten körs. Ett - i första kolumnen betyder att den är registrerad men stoppad.
Flytta tjänsten till en ny katalog¶
launchd lagrar den absoluta sökvägen till den körbara filen, så att flytta installationen kräver omregistrering av tjänsten:
-
Avinstallera nuvarande tjänst
-
Flytta applikationsfilerna
-
Installera tjänsten på nytt
-
Starta tjänsten
Avinstallera tjänsten¶
-
Stoppa den körande tjänsten
-
Avinstallera tjänsten
Digna-servern är nu avregistrerad från launchd.
Uppgradera till en ny release¶
Innan du uppgraderar¶
Verifiera alla databasanslutningar först
Från Release 2026.06 når digna varje källteknologi via ODBC. Tidigare releaser erbjöd ett val mellan en teknikspecifik drivrutin och ODBC, via omkopplaren Use ODBC. digna-teamet har valt att bygga enbart på ODBC, eftersom ett enda standardiserat gränssnitt ger mer än en uppsättning skräddarsydda drivrutiner:
- Autentisering — autentisering är en del av ODBC, så en anslutning kan använda allt som dess drivrutin stöder: lösenord, tokens och PAT:ar, Kerberos och Active Directory, MFA och webbläsarbaserad enkel inloggning, molnidentiteter, klientcertifikat och TLS. Nya metoder kommer med en uppdatering av drivrutinen i stället för att vänta på en digna-release.
- Drivrutiner som underhålls av databasleverantörerna — leverantörens egen drivrutin följer nya serverversioner och säkerhetsfixar, och du kan uppdatera den enligt ditt eget schema, oberoende av digna.
- Ett enda sätt att konfigurera allt — varje teknik är en lista med nyckel/värde-egenskaper, med samma gränssnitt, samma kryptering av känsliga värden och samma felsökning, i stället för olika fält per källa.
- Finjustering och räckvidd — drivrutinsalternativ som timeouts, TLS-inställningar, proxyservrar och hämtningsstorlekar är tillgängliga för varje källa, och varje teknik med en kompatibel ODBC-drivrutin kan anslutas, även sådana som digna inte publicerar någon egen guide för.
I praktiken innebär detta att omkopplaren Use ODBC och de separata fälten för värd, port, databas, användare och lösenord inte längre finns. Varje anslutning som inte redan använder ODBC måste läggas om till ODBC — det finns ingen automatisk konvertering, så planera för detta före uppgraderingen:
- Gå igenom varje databasanslutning som är definierad i din installation och notera vilka som ännu inte använder ODBC — var och en av dem måste konfigureras om.
- Installera motsvarande ODBC-drivrutin på digna-värden — anslutningar öppnas från den server som kör digna-backend, inte från webbläsaren. Se Installera ODBC-drivrutinen på digna-värden.
- Ha ODBC-egenskaperna redo för varje berörd anslutning. Teknikguiderna listar en beprövad uppsättning egenskaper per källa.
Efter uppgraderingen lägger du om varje berörd anslutning till ODBC och testar den från dashboarden — se Skapa en databasanslutning och Testa en anslutning.
Databricks Legacy-anslutningar
Databricks Legacy-anslutaren har tagits bort i denna release. Migrera dessa anslutningar till Databricks-anslutaren.
Att skapa en backup av digna-repositoriet är obligatoriskt
Innan du uppgraderar digna, säkerhetskopiera ditt repository (PostgreSQL) för att skydda mot dataförlust. En backup säkerställer att du kan återställa om uppgraderingen stöter på oväntade problem.
För att skapa en backup från Terminal:
Uppgraderingsprocess¶
Steg 1: Stoppa digna-tjänsten¶
Om digna körs som bakgrundstjänst, stoppa den först:
Om digna körs i förgrunden, tryck Ctrl + C i dess Terminal-fönster.
Steg 2: Säkerhetskopiera nuvarande installation¶
Byt namn på mapparna i din nuvarande installation i digna-installationskatalogen, så att den nya releasen kan distribueras vid sidan av dem:
dignabackend och dignacli används inte längre
Från Release 2026.06 ersätts dignabackend och dignacli av den enda körbara filen digna, som förenar backend och CLI. Behåll dignabackend_old och dignacli_old bara tills du har verifierat uppgraderingen — därefter kan du ta bort båda mapparna. Behåll dashboard_old tills du har återställt dina konfigurationsfiler från den (se steg 4).
Steg 3: Extrahera och distribuera ny version¶
- Extrahera den nya digna-installations-ZIP-filen
- Kopiera den nya
digna-körbara ochdashboard-mappen till din installationskatalog - Återställ exekveringsbiten och, om nödvändigt, ta bort karantänattributet:
Varning
Varken config.toml eller dashboard/dashboard_config.toml ingår någonsin i installations-ZIP:en — digna-teamet levererar aldrig någon av filerna. Din befintliga konfiguration påverkas därför inte av uppgraderingen, och kopiorna i de omdöpta *_old-mapparna är de enda du har.
Steg 4: Återställ dina konfigurationsfiler¶
Release 2026.06 ändrar config.toml
Tre inställningar är nya och obligatoriska, och två används inte längre. En config.toml som har följt med från en tidigare release saknar de nya inställningarna, och digna startar inte så länge de saknas. Lägg till följande i din befintliga config.toml:
[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"
[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Lägg till de två [base]-nycklarna i din befintliga [base]-sektion och lägg till [encryption] som ny sektion. Ta sedan bort de två inställningar som inte längre används, digna_APP_HOST och digna_APP_PORT, från [app] — servern hämtar nu adress och port från digna serve.
Vad varje inställning gör beskrivs i Backend-konfiguration.
Enkel inloggning: formatet för [oidc_clients] har ändrats
Release 2026.06 ersätter arrayen av tabeller med en tabell per leverantör, namngiven efter leverantörsnyckeln. DIGNA_OIDC_KEY är borta — nyckeln ingår nu i sektionsrubriken.
Före:
[[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'
Efter:
[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'
Upprepa sektionen för varje leverantör och håll varje nyckel identisk med key i dashboard_config.toml. digna config check rapporterar oidc_clients som FAILED så länge den gamla formen finns kvar. Endast installationer som använder enkel inloggning berörs.
Steg 5: Ladda om webbservern¶
Dashboarden är en uppsättning statiska filer, så din webbserver — och webbläsaren — kan fortfarande leverera den tidigare versionen. Ladda om eller starta om den webbserver som är värd för mappen dashboard och ladda sedan om sidan med en hård uppdatering (Cmd+Shift+R).
Steg 6: Validera konfigurationen¶
Kontrollera att den uppdaterade config.toml är fullständig innan du rör repositoryt:
Varje sektion måste rapportera OK. Åtgärda allt som rapporteras som FAILED och kör kommandot igen innan du fortsätter.
Steg 7: Ersätt licensfilen¶
Varje release licensieras separat. Kopiera den license.toml som digna-teamet tillhandahållit för denna release till installationskatalogen och ersätt den gamla:
Behåll inte den tidigare licensen
En license.toml som utfärdats för en tidigare release täcker inte den här, och varje kommando som kontrollerar licensen — user, inspection, repo — avbryts innan det rör repositoryt när kontrollen misslyckas. Verifiera den innan du går vidare:
Steg 8: Uppgradera repository-schemat¶
Navigera till din digna-installationskatalog och kör:
Detta uppdaterar PostgreSQL-schemat till senaste versionen samtidigt som all befintlig data bevaras.
Steg 9: Starta om tjänsterna¶
Om du kör som bakgrundstjänst:
Om du kör manuellt, starta servern igen:
Om du använder nginx eller Apache, starta om respektive webbserver:
Steg 10: Verifiera uppgraderingen¶
- Gå till digna-dashboarden
- Verifiera att gränssnittet laddar korrekt
- Kontrollera serverloggarna efter eventuella fel
- Lägg om varje anslutning som ännu inte använde ODBC till ODBC och testa sedan alla anslutningar — se Testa en anslutning