Linux Installationsanleitung für digna Release 2026.11¶

Release: 2026.11

Zuletzt aktualisiert: 7. November 2026

Inhaltsverzeichnis¶

1. Einführung
2. Systemanforderungen
3. Vorbereitungen vor der Installation
4. PostgreSQL-Server Einrichtung
5. Webserver-Konfiguration
6. Erstinstallation
7. Backend-Konfiguration
8. Dashboard-Konfiguration
9. digna als systemd-Dienst betreiben
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 Data Warehouses, Data Lakes und Lakehouses. digna wurde hochskalierbar und anpassungsfähig entwickelt und adressiert 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 Möglichkeit bietet, mit der digna-Plattform zu interagieren und Datenqualitätsmetriken zu visualisieren.

Neu in Release 2026.11¶

Dieses Release ergänzt digna Data Reconciliation, digna Agentic mit dem digna MCP Server und die digna Engine, die Daten innerhalb von digna profilieren und die referenzielle Integrität zwischen unterschiedlichen Datenbanktechnologien prüfen kann. Details finden Sie in den Release Notes.

Für die Installation bringt das Release einen neuen Mechanismus für Repository-Migrationen, einen optionalen Abschnitt [duckdb] in der config.toml für die digna Engine und eine neue Lizenzdatei. Der Abschnitt zum Upgrade behandelt jeden dieser Punkte.

Suchen Sie nach Windows oder macOS?¶

Diese Anleitung behandelt Linux. Für andere Plattformen siehe die Windows Installationsanleitung oder die macOS Installationsanleitung.

Für welche Distribution ist diese Anleitung geschrieben?¶

Die Anweisungen sind für die zwei gebräuchlichsten Serverfamilien formuliert. Wo sie abweichen, werden beide Befehle angegeben:

• Debian-Familie — Debian, Ubuntu. Paketmanager: apt.
• RHEL-Familie — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Paketmanager: dnf.

Jede moderne Distribution mit systemd funktioniert; nur Paketnamen und einige Konfigurationspfade ändern sich.

Systemanforderungen¶

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

Optionen zur Datenbankinstallation¶

Wenn PostgreSQL bereits installiert ist: Sie können auf Ihrem vorhandenen PostgreSQL-Server eine neue Datenbank für digna anlegen.

Wenn PostgreSQL auf derselben Maschine wie digna installiert werden soll:

Überprüfung von Distribution und Architektur¶

Mehrere Befehle in dieser Anleitung unterscheiden sich zwischen der Debian- und der RHEL-Familie. Zur Kontrolle, welche Sie verwenden, führen Sie aus:

cat /etc/os-release
uname -m

• ID=ubuntu oder ID=debian — verwenden Sie die apt-Befehle.
• ID=rhel, rocky, almalinux oder fedora — verwenden Sie die dnf-Befehle.
• x86_64 oder aarch64 — die Architektur des Installationspakets, das Sie benötigen.

Vorbereitungen vor der Installation¶

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

1. PostgreSQL-Server – zur Speicherung berechneter Metriken und Leistungsdaten
2. Webserver – zum Hosten des digna Dashboards

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

Paketindex aktualisieren¶

Aktualisieren Sie Ihre Paketlisten, bevor Sie etwas installieren:

sudo apt update

sudo dnf check-update

PostgreSQL-Server Einrichtung¶

Falls PostgreSQL bereits vorhanden ist¶

Wenn PostgreSQL bereits lokal installiert und gestartet ist oder Sie einen verwalteten Remote-PostgreSQL-Server verwenden, können Sie zum nächsten Abschnitt springen.

PostgreSQL installieren¶

Schritt 1: Serverpaket installieren¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Schritt 2: Datenbank-Cluster initialisieren¶

Bei der Debian-Familie erstellt und startet das Paket den Cluster automatisch — springen Sie zum nächsten Schritt.

Bei der RHEL-Familie muss der Cluster explizit erstellt werden:

sudo postgresql-setup --initdb

Schritt 3: Dienst starten und aktivieren¶

sudo systemctl enable --now postgresql

Dies startet PostgreSQL sofort und konfiguriert es so, dass es beim Booten automatisch erneut startet.

Schritt 4: Installation überprüfen¶

psql --version
sudo systemctl status postgresql

Sie sollten die PostgreSQL-Version sowie einen active (running) Dienst sehen.

Schritt 5: Verbindung zum Server herstellen¶

Ein Linux-PostgreSQL-Paket legt ein Systemkonto postgres an, dem der Cluster gehört. Melden Sie sich darüber an:

sudo -u postgres psql

Schritt 6: Port bestätigen¶

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

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

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

Schritt 7: Passwortauthentifizierung für den digna-Benutzer aktivieren¶

digna verbindet sich per TCP als digna_user, was Passwortauthentifizierung erfordert statt Peer-Authentifizierung. Prüfen Sie, ob Ihre pg_hba.conf dies erlaubt.

Datei lokalisieren:

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

Öffnen Sie sie in einem Editor und bestätigen Sie, dass die lokalen TCP-Zeilen scram-sha-256 (oder md5 bei älteren Servern) statt ident verwenden:

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

Starten Sie PostgreSQL nach jeder Änderung neu:

sudo systemctl reload postgresql

Schritt 8: Wenn PostgreSQL auf einem anderen Rechner läuft¶

Um Verbindungen von einem anderen Host zu akzeptieren, setzen Sie listen_addresses in postgresql.conf und fügen Sie eine passende host-Zeile für Ihr Netzwerk in pg_hba.conf hinzu:

listen_addresses = '*'

Öffnen Sie dann die Portfreigabe in der Firewall und starten Sie den Dienst neu:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Webserver-Konfiguration¶

digna benötigt einen Webserver zum Hosten des Dashboards. Wählen Sie eine der folgenden Optionen:

• nginx — leichtgewichtig und empfohlen
• Apache httpd — weit verbreitete Alternative

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

Beide Abschnitte konfigurieren zwei Dinge, von denen das Dashboard abhängt:

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

nginx Einrichtung¶

Überblick¶

nginx ist ein leichtgewichtiger, leistungsfähiger Webserver, der sich gut zum Ausliefern des statischen digna-Dashboards eignet.

Installation¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx starten¶

sudo systemctl enable --now nginx

Installation verifizieren¶

1. Öffnen Sie Ihren Browser
2. Navigieren Sie zu http://localhost
3. Sie sollten die nginx-Willkommensseite sehen

Firewall öffnen¶

Wenn der Server von anderen Maschinen aus erreichbar ist, erlauben Sie HTTP-Verkehr:

sudo ufw allow 'Nginx Full'

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

Site für das Dashboard konfigurieren¶

nginx lädt alle Dateien in seinem conf.d-Verzeichnis in beiden Distributionen ein. Erstellen Sie dort eine eigene Konfigurationsdatei für digna:

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

Fügen Sie Folgendes ein und ersetzen Sie /opt/digna/dashboard durch den tatsächlichen Pfad zu Ihrem entpackten dashboard-Ordner:

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

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

    # Markdown-Dateien mit dem korrekten MIME-Typ ausliefern.
    types {
        text/markdown  md;
    }

    # Single-Page-Application-Fallback: unbekannte Pfade liefern index.html
    # statt eines 404, damit Dashboard-Routen beim Browser-Refresh erhalten bleiben.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Standardseite deaktivieren¶

Nur ein Server-Block darf default_server für einen Port sein. In der Debian-Familie entfernen Sie die mitgelieferte Default-Site, damit sie nicht in Konflikt gerät:

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

In der RHEL-Familie kommentieren Sie den server { ... }-Block in /etc/nginx/nginx.conf aus oder löschen ihn.

Konfiguration anwenden¶

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

sudo nginx -t
sudo systemctl reload nginx

Apache httpd Einrichtung¶

Überblick¶

Apache httpd ist in den Standard-Repositories jeder unterstützten Distribution verfügbar. Das Paket heißt apache2 in der Debian-Familie und httpd in der RHEL-Familie.

Installation¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache starten¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Installation verifizieren¶

1. Öffnen Sie Ihren Browser
2. Navigieren Sie zu http://localhost
3. Sie sollten die standardmäßige Apache-Seite Ihrer Distribution sehen

Erforderlich: mod_rewrite aktivieren¶

Das Dashboard benötigt URL-Rewriting.

In der Debian-Familie aktivieren Sie das Modul und starten neu:

sudo a2enmod rewrite
sudo systemctl restart apache2

In der RHEL-Familie ist mod_rewrite standardmäßig geladen. Prüfen Sie es:

httpd -M | grep rewrite

Erforderlich: .htaccess-Overrides erlauben¶

Öffnen Sie die Konfigurationsdatei für Ihre Document-Root:

sudo nano /etc/apache2/apache2.conf

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

Finden Sie den <Directory>-Block, der Ihre Document-Root abdeckt (/var/www/html bei beiden Familien) und ändern Sie:

AllowOverride None

zu:

AllowOverride All

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

Fügen Sie in derselben Datei die folgende Zeile hinzu, damit Markdown-Dateien korrekt ausgeliefert werden:

AddType text/markdown .md

Konfiguration anwenden¶

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

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

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 für das Repository anlegen¶

Öffnen Sie Ihren PostgreSQL-Client (psql, pgAdmin oder ähnliches) und führen Sie die folgenden SQL-Anweisungen 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 aus der Shell in einem Schritt auszuführen:

sudo -u postgres psql

Dann fügen Sie die Statements an der Eingabeaufforderung postgres=# ein und tippen \q, um zu beenden.

Schritt 2: 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
3. Nach dem Entpacken sollten folgende Elemente vorhanden sein:
4. dashboard/ — Web-Dashboard-Oberfläche
5. digna — Haupt-Executable (Backend + CLI kombiniert)

Um aus der Shell zu entpacken:

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

Executable ausführbar machen¶

Je nach Übertragungsmethode bleibt das Ausführungsbit eventuell nicht erhalten. Setzen Sie es explizit:

cd /opt/digna
sudo chmod +x digna

Service-Account anlegen¶

Es wird empfohlen, das Backend als dedizierten, unprivilegierten Benutzer im Produktivbetrieb auszuführen:

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

Schritt 3: 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 Kundeninformationen, Ablaufdatum der Lizenz und die digitale Signatur. Ändern Sie diese Datei nicht — jegliche Modifikation 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 Dienstverwaltung)
└── dashboard/          (Web-Oberfläche)
    └── (Dashboard-Dateien)

Backend-Konfiguration¶

Schritt 1: Konfigurationsdatei anlegen und bearbeiten¶

Die Datei config_template.toml ist in Ihrem digna-Installationsverzeichnis vorhanden. Benennen Sie sie einfach in config.toml um.

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

Pfad: /opt/digna/config.toml

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

[app] Abschnitt¶

Dieser Abschnitt konfiguriert Cross-Origin Resource Sharing (CORS) zwischen Dashboard und Backend:

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

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

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

[base] Abschnitt¶

Dieser Abschnitt enthält Sicherheits-, Cookie- und Inspektionseinstellungen:

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

[encryption] 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_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[duckdb] Abschnitt (optional)¶

Neu in Release 2026.11. Dieser Abschnitt legt die Ressourcen der digna Engine fest, die für Datenbankverbindungen mit dem Profiling-Ort digna Engine Daten innerhalb von digna profiliert und Prüfungen der referenziellen Integrität zwischen Datenquellen auf unterschiedlichen Datenbankverbindungen ausführt. Siehe Profiling-Ort.

Der Abschnitt ist optional. Ohne ihn gelten die unten genannten Standardwerte.

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

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

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

Overall: OK

Beheben Sie alles, was als FAILED gemeldet wird, und führen Sie den Befehl erneut aus, bevor Sie fortfahren. Eine WARNING unter Unknown keys listet Schlüssel in der config.toml auf, die digna nicht liest; sie haben keine Wirkung, entfernen Sie sie also oder korrigieren Sie ihre Schreibweise. Die vollständige Liste der Optionen finden Sie in der CLI-Referenz.

Schritt 3: Repository initialisieren¶

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

cd /opt/digna
./digna repo check

Bei einem neuen Schema stellt der Befehl die Verbindung her und meldet dann, dass noch kein Repository installiert ist:

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

An dieser Stelle ist das das erwartete Ergebnis: Es bestätigt, dass digna PostgreSQL und das Schema erreicht. Ein Verbindungs- oder Authentifizierungsfehler weist dagegen auf den Abschnitt [repo] oder auf die PostgreSQL-Einrichtung hin.

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

Schritt 4: Repository-Schema installieren¶

Führen Sie im selben Verzeichnis aus:

./digna repo upgrade

Dieser Befehl legt die benötigten Tabellen im Repository-Schema an und endet mit:

✅ Repo schema 'dignarepo' is up to date.

Schritt 5: 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 anzulegen:

./digna user add <email> <password> "<display_name>" --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: digna-Server starten¶

Starten Sie im digna-Installationsverzeichnis den Server mit:

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

Parameter: - --address — Server-Hostname/IP (Standard 127.0.0.1) - --port — Server-Port (Standard 8000)

Sobald der Server läuft, gibt er die Adresse aus, auf der er lauscht:

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

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

Dashboard-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 Deployment-Schritten.

Deployment mit nginx¶

Falls Sie dem Abschnitt nginx Setup gefolgt sind, verweist der Server-Block bereits auf Ihren dashboard-Ordner und es ist kein Kopieren erforderlich.

1. Pfad bestätigen
2. Öffnen Sie /etc/nginx/conf.d/digna.conf

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

4. Stellen Sie sicher, dass der Ordner lesbar ist

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

5. nginx neu laden

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Installation testen

7. Öffnen Sie Ihren Browser
8. Navigieren Sie zu http://localhost (oder Ihrer konfigurierten URL)
9. Sie sollten die Login-Seite des digna-Dashboards sehen

Deployment mit Apache httpd¶

1. Dashboard in das Document Root kopieren

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

2. Rewrite-Regeln hinzufügen

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

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

Fügen Sie Folgendes ein:

RewriteEngine On
RewriteBase /digna/

# Bestehende Dateien und Verzeichnisse unverändert ausliefern.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Alles andere fällt auf den Single-Page-Application-Einstiegspunkt zurück.
RewriteRule ^ index.html [L]

1. Apache neu starten

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Auf das Dashboard zugreifen

3. Öffnen Sie Ihren Browser
4. Navigieren Sie zu http://localhost/digna
5. Sie sollten die Login-Seite des digna-Dashboards sehen

Schritt 2: SELinux (nur RHEL-Familie)¶

Unter RHEL, Rocky, AlmaLinux und Fedora ist SELinux standardmäßig im Enforcing-Modus aktiv und blockiert den Webserver eventuell beim Lesen von Dateien außerhalb der erwarteten Pfade. Prüfen Sie den Status:

getenforce

Ergibt die Abfrage Enforcing und Sie bedienen das Dashboard aus /opt/digna/dashboard, labeln Sie das Verzeichnis so, dass der Webserver darauf zugreifen darf:

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

digna als systemd-Dienst betreiben¶

Warum digna als Dienst betreiben?¶

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

• beim Hochfahren des Rechners automatisch startet
• im Hintergrund läuft, ohne ein offenes Terminalfenster
• bei Absturz automatisch neugestartet wird
• über systemctl verwaltet werden kann, dem Standard-Service-Manager unter Linux

Service-Management-Dateien¶

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

Folgende Shell-Skripte sind verfügbar:

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

Skripte ausführbar machen¶

Beim Entpacken kann das Ausführungsbit verloren gehen. Vor der ersten Nutzung:

cd /opt/digna/bin
sudo 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 nun bei systemd mit aktivierter automatischer Startoption registriert. Der Dienst startet nicht automatisch sofort — siehe den nächsten Abschnitt zum Starten.

Dienst starten und stoppen¶

Dienst starten¶

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

   sudo ./start_service.sh
   

Dienst stoppen¶

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

   sudo ./stop_service.sh
   

Verwaltung des Dienstes mit systemctl¶

Nach der Registrierung kann der Dienst auch mit den Standard-systemd-Befehlen aus jedem Verzeichnis gesteuert werden:

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

Dienst verifizieren¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled bedeutet, dass der Dienst beim Booten startet; active bedeutet, dass er derzeit läuft.

Service-Logs anzeigen¶

systemd erfasst alles, was das Backend auf die Konsole schreibt. Zum Lesen:

sudo journalctl -u digna -n 100

Um das Log live zu verfolgen, während Sie ein Problem reproduzieren:

sudo journalctl -u digna -f

Installation an einen neuen Pfad verschieben¶

Die Unit-Datei speichert den absoluten Pfad zur Executable, daher erfordert eine Verlagerung 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 von systemd abgemeldet.

Upgrade auf eine neue Version¶

Dieser Abschnitt beschreibt das Upgrade einer Installation von Release 2026.06 auf Release 2026.11. Ist Ihre Installation älter, lesen Sie zuerst Upgrade von einem Release vor 2026.06.

Bevor Sie ein Upgrade durchführen¶

Ein Backup des digna-Repositorys ist verpflichtend

Erstellen Sie vor einem Upgrade von digna ein Backup Ihres Repositorys (PostgreSQL), um Datenverlust zu vermeiden. Ein Backup stellt sicher, dass Sie im Falle unerwarteter Probleme bei einem Upgrade wiederherstellen können.

Um ein Backup aus der Shell zu erstellen:

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

Lizenzdatei für Release 2026.11 anfordern

Release 2026.11 benötigt eine neue license.toml. Fordern Sie sie vor dem Start beim digna-Team an und halten Sie sie für Schritt 7 bereit.

Upgrade von einem Release vor 2026.06¶

Release 2026.06 brachte drei Änderungen, die weiterhin gelten, wenn Sie eine ältere Installation direkt auf 2026.11 aktualisieren:

• Nur ODBC. digna erreicht jede Quelltechnologie über ODBC. Jede Datenbankverbindung, die noch kein ODBC verwendet, muss nach dem Upgrade auf ODBC umgestellt werden; eine automatische Umwandlung gibt es nicht. Installieren Sie die ODBC-Treiber vorab auf dem digna-Host, siehe ODBC-Treiber auf dem digna-Host installieren, und halten Sie die Eigenschaften jeder Verbindung aus den Technologie-Anleitungen bereit. Den Databricks-Legacy-Connector gibt es nicht mehr; stellen Sie diese Verbindungen auf den Databricks-Connector um.
• Eine ausführbare Datei. dignabackend und dignacli werden durch die einzelne ausführbare Datei digna ersetzt, die Backend und CLI vereint.
• config.toml. Der Abschnitt [encryption] ist erforderlich, und DIGNA_APP_HOST und DIGNA_APP_PORT werden nicht mehr gelesen: Adresse und Port bezieht der Server von digna serve. Vergleichen Sie Ihre Datei mit der Backend-Konfiguration.

Die folgenden Schritte weisen darauf hin, wo eine ältere Installation etwas anderes benötigt. Das Repository-Upgrade in Schritt 8 bringt ein Repository jedes früheren Releases direkt auf 2026.11.

Upgrade-Ablauf¶

Schritt 1: digna-Dienst stoppen¶

Wenn digna als systemd-Dienst läuft, stoppen Sie ihn zuerst:

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

Falls 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 ausführbare Datei und den Dashboard-Ordner Ihrer aktuellen Installation um, damit das neue Release daneben bereitgestellt werden kann:

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

Behalten Sie digna_old, bis Sie das Upgrade überprüft haben, und dashboard_old, bis Sie Ihre Konfigurationsdateien daraus wiederhergestellt haben (siehe Schritt 4). Danach können Sie beide löschen.

Schritt 3: Neue Version entpacken und bereitstellen¶

1. Entpacken Sie die neue digna-Installations-ZIP-Datei
2. Kopieren Sie die neue digna-Executable und den dashboard-Ordner in Ihr Installationsverzeichnis
3. Stellen Sie das Executable-Bit und den Besitz durch das Service-Konto wieder her:

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

Schritt 4: Konfigurationsdateien wiederherstellen¶

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

Release 2026.11 erfordert keine Änderung an der config.toml: Eine Datei, die mit Release 2026.06 funktioniert, funktioniert weiterhin. Zwei Änderungen sind optional:

• Ergänzen Sie einen Abschnitt [duckdb], wenn Datenbankverbindungen die digna Engine verwenden sollen und deren Standardwerte nicht zu Ihrem Host passen.
• Lassen Sie den Abschnitt [app] weg, wenn ein Reverse Proxy Dashboard und Backend unter einer Origin ausliefert.

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

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 (Ctrl+F5).

Schritt 6: Konfiguration prüfen¶

Stellen Sie sicher, dass die 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, entfernen Sie die unter Unknown keys aufgeführten Schlüssel und führen Sie den Befehl erneut aus, bevor Sie fortfahren.

Schritt 7: Lizenzdatei ersetzen¶

Eine Lizenzdatei gilt normalerweise von einem Release zum nächsten weiter. Release 2026.11 ist eine Ausnahme: Es fügt zwei lizenzierte Module hinzu, digna Data Reconciliation und digna Agentic, und eine vor 2026.11 ausgestellte Lizenz enthält sie nicht. Kopieren Sie die license.toml, die das digna-Team für Release 2026.11 bereitgestellt hat, in das Installationsverzeichnis und ersetzen Sie damit die alte:

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

./digna license check

Schritt 8: Repository-Schema upgraden¶

Führen Sie in Ihrem digna-Installationsverzeichnis aus:

cd /opt/digna
./digna repo upgrade

Release 2026.11 verwaltet das Repository-Schema mit versionierten Migrationen. Das erste Upgrade von einem früheren Release bringt das Schema auf die letzte Version des bisherigen Verfahrens, hält diesen Stand als Ausgangspunkt fest und wendet dann die Migrationen von Release 2026.11 an. Es endet mit:

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

Alle vorhandenen Daten bleiben erhalten. Um den Zustand des Repositorys jederzeit zu sehen, führen Sie ./digna repo check aus: Der Befehl listet die zuletzt angewendete Migration und alle noch ausstehenden auf.

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

Schritt 9: Dienste neu starten¶

Wenn digna als systemd-Dienst läuft:

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

Wenn Sie es manuell betreiben, starten Sie den Server neu:

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

Wenn Sie nginx oder Apache verwenden, laden Sie den jeweiligen Webserver neu:

sudo systemctl reload nginx

sudo systemctl restart apache2

Auf der RHEL-Familie wenden Sie die SELinux-Labels erneut an, falls das dashboard-Verzeichnis ersetzt wurde:

sudo restorecon -Rv /opt/digna/dashboard

Schritt 10: Upgrade verifizieren¶

1. Prüfen Sie das Release der neuen ausführbaren Datei:

   ./digna version
   

   Die erste Zeile muss Release: 2026.11 lauten.

2. Rufen Sie das digna-Dashboard auf und prüfen Sie, ob die Oberfläche korrekt geladen wird.

3. Überprüfen Sie die Server-Logs auf Fehler:

   sudo journalctl -u digna -n 100
   

4. Testen Sie Ihre Datenbankverbindungen — siehe Verbindung testen. Nach einem Upgrade von einem Release vor 2026.06 stellen Sie zuvor jede Verbindung, die noch kein ODBC verwendet hat, auf ODBC um.

Für den Einstieg in die neuen Module siehe digna Data Reconciliation, KI-Agenten verbinden für den digna MCP Server und Profiling-Ort für die digna Engine.