Windows-Installationsanleitung für digna Release 2026.11¶

Release: 2026.11

Zuletzt aktualisiert: 7. November 2026

Table of Contents¶

1. Einführung
2. Systemanforderungen
3. Vorbereitung vor der Installation
4. PostgreSQL-Server Einrichtung
5. Webserver-Konfiguration
6. Erstinstallation
7. Backend-Konfiguration
8. Dashboard-Konfiguration
9. Ausführen von digna als Windows-Dienst
10. Upgrade auf eine neue Version

Einführung¶

Über digna¶

digna ist eine umfassende, KI-gestützte Plattform zur Optimierung des Datenqualitätsmanagements in verschiedenen Datenumgebungen wie Data Warehouses, Data 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 Benutzeroberfläche, die auf einem Webserver gehostet wird und eine benutzerfreundliche Möglichkeit bietet, mit der digna-Plattform zu interagieren und Metriken zur Datenqualität 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 macOS oder Linux?¶

Dieses Handbuch behandelt Windows. Für andere Plattformen siehe die macOS 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¶

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

Wenn PostgreSQL auf demselben Rechner wie digna installiert werden soll:

Vorbereitung vor der Installation¶

Bevor Sie digna installieren, stellen Sie sicher, dass zwei wichtige 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.

PostgreSQL-Server Einrichtung¶

Wenn PostgreSQL bereits vorhanden ist¶

Wenn PostgreSQL bereits lokal installiert und ausgeführt wird oder wenn Sie einen verwalteten entfernten PostgreSQL-Server verwenden, können Sie zum nächsten Abschnitt springen.

Installation von PostgreSQL¶

Führen Sie die folgenden Schritte aus, um PostgreSQL unter Windows zu installieren:

Schritt 1: PostgreSQL herunterladen¶

1. Besuchen Sie die PostgreSQL Downloads Seite
2. Wählen Sie Windows
3. Laden Sie das neueste Installationsprogramm herunter

Schritt 2: Das Installationsprogramm ausführen¶

1. Doppelklicken Sie auf die heruntergeladene Installationsdatei
2. Folgen Sie den Anweisungen im Setup-Assistenten

Schritt 3: Installationsverzeichnis wählen¶

Wählen Sie das Verzeichnis, in dem PostgreSQL installiert werden soll. Der Standardpfad ist in der Regel passend.

Schritt 4: Komponenten auswählen¶

Für eine Standardinstallation belassen Sie die voreingestellten Komponenten.

Schritt 5: Passwort für PostgreSQL Superuser festlegen¶

Geben Sie ein Passwort für den PostgreSQL-Superuser (postgres) ein und bestätigen Sie es. Speichern Sie dieses Passwort sicher — Sie benötigen es später.

Schritt 6: Portnummer konfigurieren¶

Der Standardport von PostgreSQL ist 5432. Sie können den Standard verwenden oder bei Bedarf einen anderen Port angeben.

Schritt 7: Gebietsschema wählen¶

Wählen Sie das Gebietsschema (Locale) für Ihre Datenbank. Der Standard ist in den meisten Fällen geeignet.

Schritt 8: Installation abschließen¶

Klicken Sie sich durch die verbleibenden Schritte mit Next (Weiter) und klicken Sie abschließend auf Finish (Fertigstellen).

Schritt 9: Installation überprüfen¶

Öffnen Sie die Eingabeaufforderung und überprüfen Sie, ob PostgreSQL installiert wurde:

psql --version

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

Webserver-Konfiguration¶

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

• Internet Information Services (IIS)
• Apache Tomcat

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

IIS Einrichtung¶

Überblick¶

Internet Information Services (IIS) ist der Webserver von Microsoft zum Hosten von Websites und Webanwendungen.

IIS aktivieren¶

1. Systemsteuerung öffnen
2. Drücken Sie Win + R

3. Geben Sie control ein und drücken Sie Enter

4. Zu Windows-Funktionen navigieren

5. Klicken Sie auf Programme

6. Wählen Sie Windows-Funktionen ein- oder ausschalten

7. Internet Information Services aktivieren

8. Scrollen Sie nach unten und finden Sie Internet Information Services (IIS)
9. Aktivieren Sie das Kontrollkästchen

10. Klicken Sie auf das +, um sicherzustellen, dass folgende Unterkomponenten ausgewählt sind:

    • Webverwaltungstools
    • World Wide Web-Dienste

11. Klicken Sie auf OK, um die Änderungen anzuwenden

12. IIS-Installation überprüfen

13. Öffnen Sie Ihren Browser
14. Navigieren Sie zu http://localhost
15. Sie sollten die IIS-Willkommensseite sehen

Erforderlich: URL Rewrite Modul¶

IIS benötigt die URL Rewrite-Komponente. Laden Sie sie von der offiziellen Microsoft-Seite herunter und installieren Sie sie.

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

Damit Markdown-Dateien (.md) korrekt von IIS ausgeliefert werden, gehen Sie wie folgt vor:

1. Öffnen Sie den IIS-Manager (drücken Sie Win + R, geben Sie inetmgr ein und drücken Sie Enter)
2. Navigieren Sie zu Ihre Website > MIME-Typen
3. Klicken Sie auf Hinzufügen...
4. Konfigurieren Sie:
5. Dateinamenerweiterung: .md
6. MIME-Typ: text/markdown

Apache Tomcat Einrichtung¶

Überblick¶

Apache Tomcat ist ein Open-Source Java-Servlet-Container und Webserver.

Installation¶

1. Apache Tomcat herunterladen
2. Besuchen Sie Apache Tomcat Downloads

3. Laden Sie die Windows ZIP-Distribution herunter

4. Archiv entpacken

5. Entpacken Sie die ZIP-Datei in ein Verzeichnis auf Ihrem System

6. Beispiel: C:\Program Files\Apache Tomcat

7. Tomcat prüfen

8. Öffnen Sie Ihren Browser
9. Navigieren Sie zu http://localhost:8080
10. Sie sollten die Apache Tomcat Willkommensseite sehen

Erstinstallation¶

Schritt 1: Das digna-Repository einrichten¶

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

Schema und Benutzer für das Repository erstellen¶

Öffnen Sie Ihren PostgreSQL-Client (pgAdmin, psql oder ähnlich) 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> — Ihr gewünschter Schema-Name (z. B. dignarepo)
• <digna_repo_user> — Ihr 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;

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

Schritt 3: Lizenzdatei installieren¶

1. Lokalisieren Sie die Ihnen bereitgestellte license.toml
2. Kopieren Sie sie in das Stammverzeichnis der digna-Installation (dort, wo config.toml und die ausführbare Datei digna liegen)

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

Verzeichnisstruktur nach der Einrichtung:

digna_installation/
├── config.toml         (Konfigurationsdatei)
├── license.toml        (IHRE LIZENZDATEI - hier einfügen)
├── digna               (Hauptausführbare Datei)
└── dashboard/          (Weboberfläche)
    └── (Dashboard-Dateien)

Backend-Konfiguration¶

Schritt 1: Konfigurationsdatei erstellen und bearbeiten¶

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

Ort: digna_installation/config.toml

Öffnen Sie config.toml in einem Texteditor und konfigurieren Sie die untenstehenden 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

[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 = "C:\\path\\to\\digna\\tmp"

mkdir C:\path\to\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 testen¶

1. Öffnen Sie die Eingabeaufforderung
2. Navigieren Sie in Ihr digna-Installationsverzeichnis (dort, wo config.toml und die ausführbare Datei digna liegen)
3. Führen Sie den Verbindungstest aus:

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.

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: Einen Admin-Benutzer anlegen¶

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

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

Beispiel:

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

Dies erstellt einen Benutzer mit vollständigen Administratorrechten.

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

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 IIS¶

1. IIS-Manager öffnen

2. Drücken Sie Win + R, geben Sie inetmgr ein und drücken Sie Enter

3. Neue Website erstellen

4. Klicken Sie im linken Bereich mit der rechten Maustaste auf Sites

5. Wählen Sie Website hinzufügen...

6. Website konfigurieren

7. Site-Name: Geben Sie einen Namen ein (z. B. "dignaDashboard")
8. Physischer Pfad: Klicken Sie auf Durchsuchen und wählen Sie Ihren dashboard-Ordner

9. Bindung: Legen Sie IP-Adresse und Port fest (Standardport 80 für HTTP, 443 für HTTPS)

10. Website starten

11. Klicken Sie auf OK, um die Site zu erstellen

12. Klicken Sie mit der rechten Maustaste auf die neue Site und wählen Sie Starten

13. Installation testen

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

Bereitstellung auf Apache Tomcat¶

1. Dashboard nach Tomcat kopieren
2. Kopieren Sie den dashboard-Ordner in Ihr Tomcat-webapps-Verzeichnis
3. Benennen Sie ihn bei Bedarf um (z. B. in digna)

4. Beispiel: C:\Program Files\Apache Tomcat\webapps\digna

5. Bereitstellung überprüfen

6. Aktualisieren oder laden Sie die Tomcat-Verwaltungsseite neu (http://localhost:8080)

7. Sie sollten "digna" (oder Ihren gewählten Namen) in der Liste der bereitgestellten Anwendungen sehen

8. Dashboard aufrufen

9. Öffnen Sie Ihren Browser
10. Navigieren Sie zu http://localhost:8080/digna
11. Sie sollten die Login-Seite des digna-Dashboards sehen

Ausführen von digna als Windows-Dienst¶

Warum einen Windows-Dienst verwenden?¶

Das Ausführen des digna-Backends als Windows-Dienst stellt sicher, dass es: - Beim Systemstart automatisch gestartet wird - Im Hintergrund ohne offenes Eingabeaufforderungsfenster läuft - Bei Absturz automatisch neu gestartet werden kann - Über die Windows-Diensteverwaltung gesteuert werden kann

Die windows-Befehle¶

Der Dienst wird von der ausführbaren Datei digna selbst verwaltet, über die Unterbefehle digna windows. Es gibt keine Batch-Dateien auszuführen.

Jeder Befehl akzeptiert --name, um einen Dienst anzusprechen, der unter einem vom Standard abweichenden Namen registriert ist. Die vollständige Liste der Optionen finden Sie in der CLI-Referenz.

Dienst installieren¶

1. Eingabeaufforderung als Administrator öffnen
2. Rechtsklicken Sie auf die Eingabeaufforderung

3. Wählen Sie "Als Administrator ausführen"

4. Zu Ihrem digna-Installationsverzeichnis wechseln

   cd C:\path\to\digna
   

5. Dienst registrieren

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Der Dienst wird mit automatischer Startart registriert und startet daher mit Windows. Er startet nicht sofort — siehe nächsten Abschnitt.

Installationsoptionen¶

Dienst starten und stoppen¶

Dienst starten¶

digna windows start

Dienst stoppen¶

digna windows stop

Dienst in ein neues Verzeichnis verschieben¶

Wenn Sie die digna-Installation verschieben müssen:

1. Aktuellen Dienst stoppen und abmelden

   cd C:\old\path\digna
   digna windows stop
   digna windows uninstall
   

2. Anwendungsdateien verschieben

3. Verschieben Sie den gesamten digna-Installationsordner an den neuen Speicherort

4. Dienst vom neuen Speicherort aus erneut registrieren

   cd C:\new\path\digna
   digna windows install
   

Wiederholen Sie alle Werte für --address, --port oder --account, die Sie beim ersten Mal verwendet haben — die vorherige Registrierung ist entfernt.

1. Dienst starten

   digna windows start
   

Dienst deinstallieren¶

1. Laufenden Dienst stoppen

   cd C:\path\to\digna
   digna windows stop
   

2. Dienst abmelden

   digna windows uninstall
   

Der digna-Server ist nun als Windows-Dienst 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.

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¶

Öffnen Sie eine Eingabeaufforderung als Administrator und stoppen Sie den Dienst mit der digna-Executable Ihrer aktuellen Installation:

cd C:\path\to\digna
digna windows stop

Der Dienst bleibt registriert. Die neue ausführbare Datei tritt im selben Verzeichnis an die Stelle der alten, sodass die Registrierung weiterhin auf die richtige Datei zeigt.

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

cd C:\path\to\digna\bin
stop_service.bat
uninstall_service.bat

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 C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

Behalten Sie digna_old.exe, 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

Schritt 4: Konfigurationsdateien wiederherstellen¶

copy 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:

copy /Y C:\path\to\new\license.toml license.toml

digna license check

Schritt 8: Repository-Schema upgraden¶

Führen Sie in Ihrem digna-Installationsverzeichnis aus:

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 Windows-Dienst läuft, starten Sie ihn erneut:

cd C:\path\to\digna
digna windows start

Wenn Sie von einem Release vor 2026.06 aktualisiert und den Dienst in Schritt 1 abgemeldet haben, registrieren Sie ihn zuerst erneut mit der digna-Executable:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

Geben Sie für --address und --port die Werte an, auf denen der alte Dienst erreichbar war, sofern Sie nicht die Standardwerte 127.0.0.1 und 8000 möchten. Ergänzen Sie --account und --password, wenn der alte Dienst unter einem Domänenkonto lief. Die vollständige Liste der Optionen finden Sie unter Ausführen von digna als Windows-Dienst.

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

cd C:\path\to\digna
digna serve --address <address> --port <port>

Wenn Sie IIS oder Tomcat verwenden, starten Sie den jeweiligen Webserver neu.

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. Prüfen Sie die Dateien im Verzeichnis logs der Installation auf Fehler.
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.