macOS Installation Guide for digna Release 2026.06¶

Release: 2026.06

Last Updated: September 5, 2026

Inhaltsverzeichnis¶

1. Einführung
2. Systemanforderungen
3. Vorbereitungen vor der Installation
4. PostgreSQL-Server einrichten
5. Webserver-Konfiguration
6. Erstinstallation
7. Backend-Konfiguration
8. Dashboard-Konfiguration
9. digna als Hintergrunddienst ausführen
10. Upgrade auf eine neue Version

Einführung¶

Über digna¶

digna ist eine umfassende, KI-gestützte Plattform zur Optimierung des Datenqualitätsmanagements in unterschiedlichen Datenumgebungen wie Warehouses, Lakes und Lakehouses. Entwickelt für hohe Skalierbarkeit und Anpassungsfähigkeit, adressiert digna moderne Datenherausforderungen durch Automatisierung, Echtzeit-Überwachung und Anomalieerkennung.

digna besteht aus zwei Hauptkomponenten:

• digna: Der Kern der Anwendung, zuständig für die Verarbeitung von Daten und die Durchführung von Qualitätsprüfungen. Er vereint Backend und Kommandozeilenschnittstelle in einer einzigen ausführbaren Datei und ersetzt damit die früher getrennten Programme dignabackend und dignacli.
• dignadashboard: Eine webbasierte Oberfläche, die auf einem Webserver gehostet wird und eine benutzerfreundliche Interaktion mit der digna-Plattform sowie Visualisierung der Datenqualitätskennzahlen bietet.

Neuigkeiten in Release 2026.06¶

Dieses Release integriert Data Observability-Funktionen direkt in Ihren Code und ermöglicht Entwicklern, die Datenqualität bereits an der Quelle zu überwachen. Details finden Sie in den Release-Notizen.

Suchen Sie Anleitungen für Windows oder Linux?¶

Dieses Handbuch behandelt macOS. Für andere Plattformen siehe die Windows-Installationsanleitung oder die Linux-Installationsanleitung.

Systemanforderungen¶

Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass Ihr System die folgenden Mindestanforderungen erfüllt:

Optionen zur Datenbankinstallation¶

Falls PostgreSQL bereits installiert ist: Sie können Ihrer bestehenden PostgreSQL-Instanz eine neue Datenbank für digna hinzufügen.

Falls Sie PostgreSQL auf derselben Maschine wie digna installieren:

Überprüfen Sie Ihre Architektur¶

Einige Pfade in dieser Anleitung unterscheiden zwischen Apple Silicon und Intel-Macs. Um Ihre Architektur zu prüfen, öffnen Sie das Terminal und führen Sie aus:

uname -m

• arm64 — Apple Silicon. Homebrew installiert sich nach /opt/homebrew.
• x86_64 — Intel. Homebrew installiert sich nach /usr/local.

Vorbereitungen vor der Installation¶

Bevor Sie digna installieren, stellen Sie sicher, dass drei zentralen Voraussetzungen erfüllt sind:

1. Homebrew – der Paketmanager, mit dem die untenstehenden Komponenten installiert werden
2. PostgreSQL-Server – zur Speicherung berechneter Metriken und Leistungsdaten
3. Webserver – zum Hosten des digna Dashboards

Falls diese Komponenten noch nicht eingerichtet sind, folgen Sie den nachfolgenden Abschnitten, um sie zu installieren und zu konfigurieren.

Homebrew installieren¶

Homebrew ist der Standard-Paketmanager für macOS und wird in dieser Anleitung verwendet, um PostgreSQL und nginx zu installieren.

Schritt 1: Prüfen, ob Homebrew bereits installiert ist¶

Öffnen Sie das Terminal (Cmd + Leertaste, tippen Sie Terminal, Enter) und führen Sie aus:

brew --version

Wenn eine Versionsnummer angezeigt wird, springen Sie zum Abschnitt PostgreSQL-Server einrichten.

Schritt 2: Homebrew installieren¶

Falls der Befehl nicht gefunden wurde, installieren Sie Homebrew, indem Sie den Anweisungen auf der offiziellen Homebrew-Seite folgen. Der Installer installiert auch die Xcode Command Line Tools, falls diese noch nicht vorhanden sind.

Schritt 3: Homebrew zu Ihrem PATH hinzufügen¶

Auf Apple Silicon gibt der Installer zwei Befehle aus, um Homebrew zur Shell-Umgebung hinzuzufügen. Führen Sie diese wie angegeben aus und prüfen Sie anschließend:

brew --prefix

Dies sollte auf Apple Silicon /opt/homebrew oder auf Intel /usr/local ausgeben.

PostgreSQL-Server einrichten¶

Falls Sie PostgreSQL bereits installiert haben¶

Wenn PostgreSQL bereits lokal läuft oder Sie eine verwaltete Remote-PostgreSQL-Instanz verwenden, können Sie zum nächsten Abschnitt springen.

Installationsoptionen¶

macOS bietet zwei unkomplizierte Wege, PostgreSQL zu installieren. Wählen Sie einen:

• Homebrew — Installation per Kommandozeile, empfohlen für Server-Deployments
• Postgres.app — grafische Installation, bequem für lokale Evaluierung

PostgreSQL mit Homebrew installieren¶

Schritt 1: Das PostgreSQL-Formula installieren¶

brew install postgresql@16

Schritt 2: PostgreSQL zu Ihrem PATH hinzufügen¶

Versionierte PostgreSQL-Formeln sind keg-only, das heißt, Homebrew verlinkt ihre Befehle nicht automatisch in Ihren PATH. Fügen Sie sie selbst hinzu:

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

Schritt 3: Den PostgreSQL-Dienst starten¶

brew services start postgresql@16

Dies startet PostgreSQL sofort und konfiguriert es so, dass es beim Einloggen automatisch wieder startet.

Schritt 4: Installation überprüfen¶

psql --version

Sie sollten die PostgreSQL-Version sehen, wenn die Installation erfolgreich war.

Schritt 5: Mit dem Server verbinden¶

psql postgres

Schritt 6: Den Port bestätigen¶

Der Standardport von PostgreSQL ist 5432. Um den Port zu bestätigen, auf dem Ihr Server lauscht:

psql postgres -c "SHOW port;"

Notieren Sie sich den Wert — Sie benötigen ihn bei der Konfiguration des digna-Backends.

PostgreSQL mit Postgres.app installieren¶

Wenn Sie eine grafische Installation bevorzugen:

1. Laden Sie Postgres.app herunter und ziehen Sie es in Ihren Applications-Ordner
2. Öffnen Sie die App und klicken Sie auf Initialize, um einen neuen Server zu erstellen
3. Folgen Sie den Anweisungen der App, um die Kommandozeilentools zu Ihrem PATH hinzuzufügen
4. Überprüfen Sie die Installation:

psql --version

Postgres.app legt ebenfalls einen Superuser mit dem Namen Ihres macOS-Benutzerkontos an.

Webserver-Konfiguration¶

digna benötigt einen Webserver, um das Dashboard zu hosten. Wählen Sie eine der folgenden Optionen:

• nginx — per Homebrew installiert, empfohlen
• Apache httpd — in macOS enthalten

Sie müssen nur einen dieser Server installieren und konfigurieren.

Beide Abschnitte konfigurieren zwei Dinge, die das Dashboard benötigt:

• Fallback für Single-Page-Applications, damit das Aktualisieren einer Dashboard-URL kein 404 zurückgibt
• Ein .md MIME-Typ, damit Markdown-Dateien korrekt ausgeliefert werden

nginx einrichten¶

Überblick¶

nginx ist ein leichtgewichtiger, leistungsfähiger Webserver, der sich gut eignet, um das statische digna-Dashboard zu servieren.

Installation¶

brew install nginx

nginx starten¶

brew services start nginx

Installation überprüfen¶

1. Öffnen Sie Ihren Browser
2. Rufen Sie http://localhost:8080 auf
3. Sie sollten die nginx-Willkommensseite sehen

Eine Site für das Dashboard konfigurieren¶

Die Homebrew-nginx-Konfiguration inkludiert alle Dateien im servers-Verzeichnis. Erstellen Sie dort eine dedizierte Konfigurationsdatei für digna:

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

Fügen Sie das Folgende ein und ersetzen Sie /path/to/digna/dashboard durch den tatsächlichen Pfad zu Ihrem entpackten dashboard-Ordner:

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;
    }
}

Die Konfiguration anwenden¶

Prüfen Sie die Konfiguration auf Syntaxfehler und laden Sie nginx neu:

nginx -t
brew services restart nginx

Apache httpd einrichten¶

Überblick¶

macOS enthält Apache httpd, daher ist keine Installation erforderlich. Er ist standardmäßig deaktiviert.

Apache starten¶

sudo apachectl start

Installation überprüfen¶

1. Öffnen Sie Ihren Browser
2. Rufen Sie http://localhost auf
3. Sie sollten die Meldung "It works!" sehen

Erforderlich: mod_rewrite aktivieren¶

Das Dashboard benötigt URL-Rewriting. Öffnen Sie die Apache-Konfiguration:

sudo nano /etc/apache2/httpd.conf

Finden Sie folgende Zeile und entfernen Sie das vorangestellte #, um sie zu aktivieren:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Erforderlich: .htaccess-Overrides erlauben¶

Ändern Sie in derselben Datei den <Directory "/Library/WebServer/Documents">-Block von:

AllowOverride None

zu:

AllowOverride All

Erforderlich: MIME-Typ für Markdown-Dateien¶

Fügen Sie ebenfalls in httpd.conf die folgende Zeile hinzu, damit Markdown-Dateien korrekt ausgeliefert werden:

AddType text/markdown .md

Die Konfiguration anwenden¶

Überprüfen Sie die Konfiguration auf Syntaxfehler und starten Sie Apache neu:

sudo apachectl configtest
sudo apachectl restart

Erstinstallation¶

Schritt 1: Repository für digna einrichten¶

Das digna-Repository speichert alle von digna berechneten Metriken. Es fungiert als zentrale Datenbank für Analyse- und Leistungsdaten.

Schema und Benutzer anlegen¶

Öffnen Sie Ihren PostgreSQL-Client (psql, pgAdmin oder ähnliches) und führen Sie die folgenden SQL-Befehle aus:

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>;

Ersetzen Sie die folgenden Platzhalter:

• <digna_repo_schema> — Gewünschter Schema-Name (z. B. dignarepo)
• <digna_repo_user> — Gewünschter Benutzername (z. B. digna_user)
• <digna_repo_password> — Ein sicheres Passwort für diesen Benutzer

Beispiel:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Um diese Befehle im Terminal in einem Schritt auszuführen:

psql postgres

Fügen Sie dann die Statements am postgres=# Prompt ein und geben Sie \q zum Beenden ein.

Schritt 2: Das digna-Installationspaket entpacken¶

1. Lokalisieren Sie die Ihnen bereitgestellte digna-Installations-ZIP-Datei
2. Entpacken Sie sie an Ihren gewünschten Installationsort — z. B. /opt/digna oder ~/digna
3. Nach dem Entpacken sollten Sie folgende Elemente sehen:
4. dashboard/ — Web-Dashboard-Oberfläche
5. digna — Haupt-Executable (Backend + CLI kombiniert)

Um im Terminal zu entpacken:

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

Die ausführbare Datei ausführbar machen¶

Je nachdem, wie das Archiv übertragen wurde, geht das Ausführbarkeitsbit beim Entpacken möglicherweise verloren. Setzen Sie es explizit:

cd /opt/digna
chmod +x digna

Falls macOS die Anwendung blockiert¶

Per Browser oder Mail-Client heruntergeladene Dateien werden mit einem Quarantäne-Attribut versehen. Wenn macOS meldet, dass die App "cannot be opened because the developer cannot be verified", entfernen Sie das Attribut aus dem Installationsverzeichnis:

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

Alternativ öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit, suchen das blockierte Element unten auf der Seite und klicken auf Dennoch öffnen / Open Anyway.

Schritt 3: Die Lizenzdatei installieren¶

1. Lokalisieren Sie die Ihnen bereitgestellte license.toml
2. Kopieren Sie sie in das Root-Installationsverzeichnis von digna (dort, wo config.toml und die digna-Executable liegen)

Warum das wichtig ist: Die Lizenzdatei enthält Ihre Kundendaten, das Ablaufdatum der Lizenz und die digitale Signatur. Ändern Sie diese Datei nicht — jede Änderung macht sie ungültig.

Verzeichnisstruktur nach der Einrichtung:

/opt/digna/
├── config.toml         (Konfigurationsdatei)
├── license.toml        (IHRE LIZENZDATEI - hierher kopieren)
├── digna               (Haupt-Executable)
├── bin/                (Skripte zur Service-Verwaltung)
└── dashboard/          (Weboberfläche)
    └── (Dashboard-Dateien)

Backend-Konfiguration¶

Schritt 1: Konfigurationsdatei anlegen und bearbeiten¶

Die Datei config_template.toml liegt in Ihrem digna-Installationsverzeichnis. Sie müssen sie lediglich in config.toml umbenennen.

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

Pfad: /opt/digna/config.toml

Öffnen Sie config.toml in einem Texteditor und konfigurieren Sie die nachstehenden Abschnitte.

[app] Abschnitt¶

Dieser Abschnitt konfiguriert die Einstellungen der digna-Backend-Anwendung:

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

Dieser Abschnitt konfiguriert die Verbindung zur PostgreSQL-Datenbank:

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

Dieser Abschnitt enthält Sicherheits- und Cookie-Einstellungen:

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

Dieser Abschnitt enthält den Schlüssel, mit dem sensible Werte im Repository verschlüsselt werden. Er ist erforderlich — config check meldet den Abschnitt [encryption] als FAILED, wenn der Schlüssel fehlt.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Abschnitt¶

Dieser Abschnitt konfiguriert das Logging-Verhalten:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Schritt 2: Konfiguration prüfen¶

Prüfen Sie vor der Initialisierung des Repositories, ob config.toml vollständig und korrekt aufgebaut ist. Führen Sie in Ihrem digna-Installationsverzeichnis aus:

digna config check

Jeder Abschnitt wird einzeln geprüft, sodass ein einzelner Fehler den Zustand der übrigen nicht verdeckt:

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

Beheben Sie alles, was als FAILED gemeldet wird, und führen Sie den Befehl erneut aus, bevor Sie fortfahren. Die vollständige Liste der Optionen finden Sie in der CLI-Referenz.

Schritt 3: Das Repository initialisieren¶

1. Öffnen Sie das Terminal
2. Wechseln Sie in Ihr digna-Installationsverzeichnis (dort, wo config.toml und die digna-Executable liegen)
3. Führen Sie den Verbindungstest aus:

cd /opt/digna
./digna repo check

Sie sollten eine Bestätigung sehen, dass die Verbindung hergestellt wurde (das Repository selbst wurde noch nicht initialisiert).

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

Schritt 4: Das Repository-Schema installieren¶

Führen Sie im selben Verzeichnis aus:

./digna repo install

Dieser Befehl legt die benötigten Tabellen und das Schema in Ihrer PostgreSQL-Datenbank an.

Schritt 5: Einen Admin-Benutzer anlegen¶

1. Öffnen Sie ein neues Terminalfenster
2. Wechseln Sie in Ihr digna-Installationsverzeichnis
3. Führen Sie folgenden Befehl aus, um einen Admin-Benutzer zu erstellen:

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

Beispiel:

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

Dies legt einen Benutzer mit der E-Mail-Adresse admin@example.com und vollen administrativen Rechten an.

Schritt 6: Den digna-Server starten¶

Starten Sie im digna-Installationsverzeichnis den Server mit:

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

Parameter: - --address — Server-Hostname/IP - --port — Server-Port

Sie sollten Startmeldungen sehen, die bestätigen, dass der Server läuft:

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

Dashboard-Konfiguration¶

Schritt 1: Dashboard auf dem Webserver bereitstellen¶

Das digna-Dashboard liest seine eigene Konfiguration aus dashboard/dashboard_config.toml. Diese Datei wird nicht mit der Installation ausgeliefert — Sie legen sie im dashboard/-Verzeichnis neben den Dashboard-Dateien an.

Ihr Inhalt ist unter Single Sign-on beschrieben, wo die Datei auch benötigt wird: Sie enthält die Anmeldeoptionen, die das Dashboard anbietet, und bei Multi-Instance-Deployments die Backend-Verbindung.

Wählen Sie Ihren Webserver und folgen Sie den entsprechenden Bereitstellungsschritten.

Bereitstellung auf nginx¶

Wenn Sie der Anleitung im Abschnitt nginx Setup gefolgt sind, zeigt der Server-Block bereits auf Ihren dashboard-Ordner und es ist kein Kopieren erforderlich.

1. Pfad bestätigen
2. Öffnen Sie $(brew --prefix)/etc/nginx/servers/digna.conf

3. Vergewissern Sie sich, dass root auf Ihren entpackten dashboard-Ordner zeigt

4. Sicherstellen, dass der Ordner lesbar ist

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

5. nginx neu laden

   nginx -t
   brew services restart nginx
   

6. Installation testen

7. Öffnen Sie Ihren Browser
8. Rufen Sie http://localhost:8080 (oder Ihre konfigurierte URL) auf
9. Sie sollten die Anmeldeseite des digna-Dashboards sehen

Bereitstellung auf Apache httpd¶

1. Dashboard in das Document Root kopieren

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

2. Rewrite-Regeln hinzufügen

Erstellen Sie eine .htaccess-Datei im bereitgestellten Ordner, damit Dashboard-Routen beim Browser-Refresh erhalten bleiben:

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

Fügen Sie Folgendes ein:

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. Apache neu starten

   sudo apachectl restart
   

2. Dashboard aufrufen

3. Öffnen Sie Ihren Browser
4. Rufen Sie http://localhost/digna auf
5. Sie sollten die Anmeldeseite des digna-Dashboards sehen

digna als Hintergrunddienst ausführen¶

Warum digna als Dienst ausführen?¶

Das Ausführen des digna-Backends als Hintergrunddienst stellt sicher, dass es:

• Beim Systemstart automatisch gestartet wird
• Im Hintergrund läuft, ohne ein offenes Terminalfenster zu benötigen
• Bei Abstürzen automatisch neu startet
• Über launchctl, den Dienstemanager von macOS, verwaltet werden kann

Dateien zur Dienstverwaltung¶

Alle benötigten Dateien befinden sich im digna-Installationsverzeichnis unter: bin/

Die folgenden Shell-Skripte sind vorhanden:

• install_service.sh — registriert digna bei launchd
• uninstall_service.sh — entfernt die Registrierung
• start_service.sh — startet den registrierten Dienst
• stop_service.sh — stoppt den laufenden Dienst

Ausführbarkeitsrechte für die Skripte setzen¶

Beim Entpacken kann das Ausführbarkeitsbit verloren gehen. Vor der ersten Verwendung:

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

Dienst installieren¶

1. Terminal öffnen

2. Ins bin-Verzeichnis wechseln

   cd /opt/digna/bin
   

3. Installationsskript ausführen

   sudo ./install_service.sh
   

Der digna-Server ist jetzt bei launchd mit automatischem Start registriert. Der Dienst startet nicht sofort — siehe den nächsten Abschnitt, um ihn zu starten.

Dienst starten und stoppen¶

Dienst starten¶

1. Terminal öffnen
2. Ins Verzeichnis /opt/digna/bin wechseln
3. Ausführen:

   sudo ./start_service.sh
   

Dienst stoppen¶

1. Terminal öffnen
2. Ins Verzeichnis /opt/digna/bin wechseln
3. Ausführen:

   sudo ./stop_service.sh
   

Dienst verifizieren¶

Um zu bestätigen, dass der Dienst registriert und läuft:

sudo launchctl list | grep digna

Eine Zeile, die mit einer Prozess-ID beginnt, zeigt an, dass der Dienst läuft. Ein - in der ersten Spalte bedeutet, dass er registriert, aber gestoppt ist.

Dienst in ein neues Verzeichnis verschieben¶

launchd speichert den absoluten Pfad zur ausführbaren Datei, daher erfordert ein Verschieben der Installation eine Neu-Registrierung des Dienstes:

1. Aktuellen Dienst deinstallieren

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

2. Anwendungsdateien verschieben

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

3. Dienst neu installieren

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

4. Dienst starten

   sudo ./start_service.sh
   

Dienst deinstallieren¶

1. Laufenden Dienst stoppen

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

2. Dienst deinstallieren

   sudo ./uninstall_service.sh
   

Der digna-Server ist nun bei launchd abgemeldet.

Upgrade auf eine neue Version¶

Vor dem Upgrade¶

Prüfen Sie zuerst alle Datenbankverbindungen

Ab Release 2026.06 erreicht digna jede Quelltechnologie über ODBC. Frühere Releases boten die Wahl zwischen einem technologiespezifischen Treiber und ODBC, ausgewählt über den Schalter Use ODBC. Das digna-Team hat sich entschieden, allein auf ODBC zu setzen, weil eine einzige, standardisierte Schnittstelle mehr bietet als eine Reihe maßgeschneiderter Treiber:

• Authentifizierung — die Authentifizierung ist Teil von ODBC, sodass eine Verbindung alles nutzen kann, was ihr Treiber unterstützt: Passwörter, Tokens und PATs, Kerberos und Active Directory, MFA und browserbasiertes Single Sign-on, Cloud-Identitäten, Client-Zertifikate und TLS. Neue Verfahren kommen mit einem Treiber-Update, statt auf ein digna-Release zu warten.
• Von den Datenbankherstellern gepflegte Treiber — der herstellereigene Treiber folgt neuen Serverversionen und Sicherheitsupdates, und Sie können ihn unabhängig von digna nach Ihrem eigenen Zeitplan aktualisieren.
• Eine einheitliche Konfiguration — jede Technologie ist eine Liste von Schlüssel-Wert-Paaren, mit derselben Oberfläche, derselben Verschlüsselung sensibler Werte und derselben Fehlersuche, statt unterschiedlicher Felder je Quelle.
• Feinabstimmung und Reichweite — Treiberoptionen wie Timeouts, TLS-Einstellungen, Proxys und Fetch-Größen stehen für jede Quelle zur Verfügung, und jede Technologie mit einem konformen ODBC-Treiber lässt sich anbinden, auch solche, für die digna keine eigene Anleitung veröffentlicht.

In der Praxis bedeutet das: Den Schalter Use ODBC und die separaten Felder für Host, Port, Datenbank, Benutzer und Passwort gibt es nicht mehr. Jede Verbindung, die nicht bereits ODBC verwendet, muss auf ODBC umgestellt werden — eine automatische Umwandlung gibt es nicht, planen Sie dies also vor dem Upgrade ein:

1. Sehen Sie jede in Ihrer Installation definierte Datenbankverbindung durch und notieren Sie die, die noch kein ODBC verwenden — jede davon muss neu konfiguriert werden.
2. Installieren Sie den passenden ODBC-Treiber auf dem digna-Host — Verbindungen werden von dem Server geöffnet, auf dem das digna-Backend läuft, nicht vom Browser aus. Siehe ODBC-Treiber auf dem digna-Host installieren.
3. Halten Sie die ODBC-Eigenschaften für jede betroffene Verbindung bereit. Die Technologie-Anleitungen führen je Quelle einen erprobten Satz von Eigenschaften auf.

Stellen Sie nach dem Upgrade jede betroffene Verbindung auf ODBC um und testen Sie sie im Dashboard — siehe Datenbankverbindung anlegen und Verbindung testen.

Das Erstellen eines Backups des digna-Repositorys ist verpflichtend

Bevor Sie digna aktualisieren, sichern Sie unbedingt Ihr Repository (PostgreSQL), um Datenverlust vorzubeugen. Ein Backup ermöglicht die Wiederherstellung, falls das Upgrade unerwartete Probleme verursacht.

Um ein Backup im Terminal zu erstellen:

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

Upgrade-Prozess¶

Schritt 1: den digna-Dienst stoppen¶

Wenn digna als Hintergrunddienst läuft, stoppen Sie ihn zuerst:

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

Wenn digna im Vordergrund läuft, drücken Sie in dessen Terminalfenster Ctrl + C.

Schritt 2: Aktuelle Installation sichern¶

Benennen Sie in Ihrem digna-Installationsverzeichnis die Ordner Ihrer aktuellen Installation um, damit das neue Release daneben bereitgestellt werden kann:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Schritt 3: Neue Version entpacken und bereitstellen¶

1. Entpacken Sie das neue digna-Installations-ZIP-Archiv
2. Kopieren Sie die neue digna-Executable und den dashboard-Ordner in Ihr Installationsverzeichnis
3. Stellen Sie das Ausführbarkeitsbit wieder her und löschen Sie ggf. das Quarantäne-Attribut:

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

Schritt 4: Ihre Konfigurationsdateien wiederherstellen¶

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'

Schritt 5: Webserver neu laden¶

Das Dashboard besteht aus statischen Dateien, daher liefern Ihr Webserver — und der Browser — möglicherweise noch die vorherige Version aus. Laden Sie den Webserver, der den dashboard-Ordner bereitstellt, neu oder starten Sie ihn neu, und laden Sie die Seite anschließend mit einem Hard Refresh neu (Cmd+Shift+R).

Schritt 6: Konfiguration prüfen¶

Stellen Sie sicher, dass die aktualisierte config.toml vollständig ist, bevor Sie das Repository anfassen:

./digna config check

Jeder Abschnitt muss OK melden. Beheben Sie alles, was als FAILED gemeldet wird, und führen Sie den Befehl erneut aus, bevor Sie fortfahren.

Schritt 7: Lizenzdatei ersetzen¶

Jedes Release wird separat lizenziert. Kopieren Sie die license.toml, die das digna-Team für dieses Release bereitgestellt hat, in das Installationsverzeichnis und ersetzen Sie damit die alte:

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

./digna license check

Schritt 8: Repository-Schema aktualisieren¶

Wechseln Sie in Ihr digna-Installationsverzeichnis und führen Sie aus:

cd /opt/digna
./digna repo upgrade

Dies aktualisiert das PostgreSQL-Schema auf die neueste Version und bewahrt dabei alle vorhandenen Daten.

Schritt 9: Dienste neu starten¶

Falls der Dienst als Hintergrunddienst läuft:

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

Falls Sie manuell starten, starten Sie den Server neu:

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

Wenn Sie nginx oder Apache nutzen, starten Sie den jeweiligen Webserver neu:

brew services restart nginx

sudo apachectl restart

Schritt 10: Upgrade verifizieren¶

1. Rufen Sie das digna-Dashboard auf
2. Vergewissern Sie sich, dass die Oberfläche korrekt geladen wird
3. Prüfen Sie die Server-Logs auf etwaige Fehler
4. Stellen Sie jede Verbindung, die noch kein ODBC verwendet hat, auf ODBC um und testen Sie anschließend alle Verbindungen — siehe Verbindung testen