Windows Installation Guide for digna Release 2026.06¶

Release: 2026.06

Last Updated: August 30, 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.06¶

Dieses Release bringt Data-Observability-Funktionen direkt in Ihren Code, sodass Entwickler die Datenqualität an der Quelle überwachen können. Siehe die Release Notes für vollständige Details.

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

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

Schritt 4: Repository-Schema installieren¶

Führen Sie im selben Verzeichnis aus:

digna repo install

Dieser Befehl legt die notwendigen Tabellen und das Schema in Ihrer PostgreSQL-Datenbank an.

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

Bevor Sie upgraden¶

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.

Ein Backup des digna-Repositories ist obligatorisch

Erstellen Sie vor dem Upgrade ein Backup Ihres Repositories (PostgreSQL), um Datenverlust zu vermeiden. Ein Backup stellt sicher, dass Sie im Fall unerwarteter Probleme während des Upgrades wiederherstellen können.

Upgrade-Prozess¶

Schritt 1: Alten Dienst stoppen und abmelden¶

Wenn digna als Windows-Dienst ausgeführt wird, stoppen Sie ihn mit den Batch-Dateien Ihrer aktuellen Installation — die Befehle digna windows gehören zum neuen Release und sind noch nicht verfügbar:

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

Melden Sie den Dienst anschließend ab, ebenfalls mit der alten Batch-Datei. Die Registrierung verweist auf die alte ausführbare Datei und deren Skripte, die beide durch dieses Upgrade ersetzt werden, und kann daher nicht wiederverwendet werden:

uninstall_service.bat

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:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

Schritt 3: Neue Version entpacken und bereitstellen¶

1. Entpacken Sie die neue digna-Installations-ZIP-Datei
2. Kopieren Sie die neue ausführbare Datei digna und den dashboard-Ordner in Ihr Installationsverzeichnis

Schritt 4: Konfigurationsdateien wiederherstellen¶

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

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:

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

digna license check

Schritt 8: Repository-Schema upgraden¶

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

digna repo upgrade

Dies aktualisiert das PostgreSQL-Schema auf die neueste Version und erhält alle vorhandenen Daten.

Schritt 9: Dienst registrieren und starten¶

Die alte Registrierung wurde in Schritt 1 entfernt, daher wird der Dienst erneut registriert — diesmal mit der ausführbaren Datei digna, die ohne Batch-Dateien auskommt:

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 neuen Standardwerte 127.0.0.1 und 8000 möchten; sie werden in der Registrierung hinterlegt und nicht mehr aus der config.toml gelesen. 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 manuell ausführen, 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 überprüfen¶

1. Rufen Sie das digna-Dashboard auf
2. Prüfen Sie, ob die Oberfläche korrekt geladen wird
3. Überprüfen Sie die Server-Logs auf 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