Przewodnik instalacji digna Release 2026.11 dla Windows¶

Wydanie: 2026.11

Ostatnia aktualizacja: 7 listopada 2026

Spis treści¶

1. Wprowadzenie
2. Wymagania systemowe
3. Przygotowanie przed instalacją
4. Konfiguracja serwera PostgreSQL
5. Konfiguracja serwera WWW
6. Instalacja początkowa
7. Konfiguracja backendu
8. Konfiguracja dashboardu
9. Uruchamianie digna jako usługi Windows
10. Aktualizacja do nowego wydania

Wprowadzenie¶

O digna¶

digna to kompleksowa platforma napędzana sztuczną inteligencją, zaprojektowana do optymalizacji zarządzania jakością danych w różnych środowiskach danych, takich jak hurtownie, data lake i lakehouse. Zbudowana z myślą o dużej skalowalności i elastyczności, digna rozwiązuje współczesne wyzwania związane z danymi dzięki automatyzacji, monitorowaniu w czasie rzeczywistym i wykrywaniu anomalii.

digna składa się z dwóch głównych komponentów:

• digna: rdzeń aplikacji, odpowiedzialny za przetwarzanie danych i wykonywanie kontroli jakości. Łączy backend i interfejs wiersza poleceń w jednym pliku wykonywalnym, zastępując osobne programy dignabackend i dignacli z wcześniejszych wydań.
• dignadashboard: interfejs webowy hostowany na serwerze WWW, zapewniający przyjazny sposób interakcji z platformą digna oraz wizualizację wskaźników jakości danych.

Co nowego w wydaniu 2026.11¶

To wydanie wprowadza digna Data Reconciliation, digna Agentic z digna MCP Server oraz digna Engine, który potrafi profilować dane wewnątrz digna i sprawdzać integralność referencyjną między różnymi technologiami baz danych. Pełne szczegóły znajdziesz w notatkach o wydaniu.

Z punktu widzenia instalacji wydanie wprowadza nowy mechanizm migracji repozytorium, opcjonalną sekcję [duckdb] w config.toml dla digna Engine oraz nowy plik licencji. Każdy z tych elementów omawia sekcja o aktualizacji.

Szukasz macOS lub Linux?¶

Ten przewodnik dotyczy Windows. Dla innych platform zobacz Przewodnik instalacji dla macOS lub Przewodnik instalacji dla Linux.

Wymagania systemowe¶

Zanim rozpoczniesz instalację, upewnij się, że system spełnia następujące minimalne wymagania:

Opcje instalacji bazy danych¶

Jeśli PostgreSQL jest już zainstalowany: Możesz dodać nową bazę danych dla digna do istniejącego serwera PostgreSQL.

Jeśli instalujesz PostgreSQL na tej samej maszynie co digna:

Przygotowanie przed instalacją¶

Przed instalacją digna upewnij się, że są spełnione dwa kluczowe warunki wstępne:

1. Serwer PostgreSQL – do przechowywania wyliczonych metryk i danych wydajnościowych
2. Serwer WWW – do hostowania Dashboardu digna

Jeśli te komponenty nie są jeszcze skonfigurowane, postępuj zgodnie z poniższymi sekcjami, aby je zainstalować i skonfigurować.

Konfiguracja serwera PostgreSQL¶

Jeśli masz już PostgreSQL¶

Jeśli PostgreSQL jest już zainstalowany i działa lokalnie lub jeśli używasz zarządzanego zdalnego serwera PostgreSQL, możesz przejść do następnej sekcji.

Instalacja PostgreSQL¶

Wykonaj poniższe kroki, aby zainstalować PostgreSQL na Windows:

Krok 1: Pobierz PostgreSQL¶

1. Odwiedź stronę PostgreSQL Downloads
2. Wybierz Windows
3. Pobierz najnowszy instalator

Krok 2: Uruchom instalator¶

1. Kliknij dwukrotnie pobrany plik instalatora
2. Postępuj zgodnie z instrukcjami kreatora instalacji

Krok 3: Wybierz katalog instalacji¶

Wybierz katalog, w którym PostgreSQL zostanie zainstalowany. Domyślna lokalizacja zazwyczaj jest odpowiednia.

Krok 4: Wybierz składniki¶

Dla standardowej instalacji pozostaw domyślne opcje składników.

Krok 5: Ustaw hasło superużytkownika PostgreSQL¶

Wprowadź i potwierdź hasło dla superużytkownika PostgreSQL (postgres). Zapisz to hasło w bezpiecznym miejscu — będzie potrzebne później.

Krok 6: Skonfiguruj numer portu¶

Domyślny port PostgreSQL to 5432. Możesz użyć domyślnego lub określić inny port w razie potrzeby.

Krok 7: Wybierz lokalizację (locale)¶

Wybierz locale dla bazy danych. Domyślna wartość zazwyczaj jest odpowiednia dla większości instalacji.

Krok 8: Zakończ instalację¶

Kliknij Dalej przez kolejne kroki, a następnie kliknij Zakończ.

Krok 9: Zweryfikuj instalację¶

Otwórz Wiersz poleceń i sprawdź, czy PostgreSQL został zainstalowany:

psql --version

Powinieneś zobaczyć wersję PostgreSQL, jeśli instalacja zakończyła się sukcesem.

Konfiguracja serwera WWW¶

digna wymaga serwera WWW do hostowania dashboardu. Wybierz jedną z poniższych opcji:

• Internet Information Services (IIS)
• Apache Tomcat

Wystarczy zainstalować i skonfigurować jeden z tych serwerów.

Konfiguracja IIS¶

Przegląd¶

Internet Information Services (IIS) to serwer WWW firmy Microsoft do hostowania stron i aplikacji webowych.

Włączanie IIS¶

1. Otwórz Panel sterowania
2. Naciśnij Win + R

3. Wpisz control i naciśnij Enter

4. Przejdź do funkcji systemu Windows

5. Kliknij Programy

6. Wybierz Włącz lub wyłącz funkcje systemu Windows

7. Włącz Internet Information Services

8. Przewiń w dół i znajdź Internet Information Services (IIS)
9. Zaznacz pole, aby go włączyć

10. Kliknij przycisk +, aby rozwinąć i upewnić się, że wybrane są podskładniki:

    • Web Management Tools
    • World Wide Web Services

11. Kliknij OK, aby zastosować zmiany

12. Zweryfikuj instalację IIS

13. Otwórz przeglądarkę
14. Przejdź do http://localhost
15. Powinieneś zobaczyć stronę powitalną IIS

Wymagane: moduł URL Rewrite¶

IIS wymaga komponentu URL Rewrite. Pobierz i zainstaluj go ze strony Microsoft.

Wymagane: typ MIME dla plików Markdown¶

Aby pliki Markdown (.md) były poprawnie serwowane przez IIS:

1. Otwórz IIS Manager (naciśnij Win + R, wpisz inetmgr, naciśnij Enter)
2. Przejdź do Twoja witryna > MIME Types
3. Kliknij Add...
4. Skonfiguruj:
5. File name extension: .md
6. MIME type: text/markdown

Konfiguracja Apache Tomcat¶

Przegląd¶

Apache Tomcat to otwartoźródłowy kontener serwletów Java i serwer WWW.

Instalacja¶

1. Pobierz Apache Tomcat
2. Odwiedź Apache Tomcat Downloads

3. Pobierz dystrybucję ZIP dla Windows

4. Rozpakuj archiwum

5. Rozpakuj plik ZIP do katalogu na systemie

6. Przykład: C:\Program Files\Apache Tomcat

7. Zweryfikuj, że Tomcat działa

8. Otwórz przeglądarkę
9. Przejdź do http://localhost:8080
10. Powinieneś zobaczyć stronę powitalną Apache Tomcat

Instalacja początkowa¶

Krok 1: Skonfiguruj repozytorium digna¶

Repozytorium digna przechowuje wszystkie metryki wyliczane przez digna. Działa jako centralna baza danych dla danych analitycznych i wydajnościowych.

Utwórz schemat repozytorium i użytkownika¶

Otwórz klienta PostgreSQL (pgAdmin, psql lub podobny) i wykonaj poniższe polecenia SQL:

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

Zastąp następujące zmienne:

• <digna_repo_schema> — Wybrana nazwa schematu (np. dignarepo)
• <digna_repo_user> — Wybrana nazwa użytkownika (np. digna_user)
• <digna_repo_password> — Bezpieczne hasło dla tego użytkownika

Przykład:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Krok 2: Rozpakuj pakiet instalacyjny digna¶

1. Znajdź plik ZIP instalacji digna dostarczony Ci
2. Rozpakuj go do wybranej lokalizacji instalacyjnej
3. Po rozpakowaniu powinieneś zobaczyć następujące elementy:
4. dashboard/ — interfejs webowy
5. digna — główny plik wykonywalny (backend + CLI w jednym)

Krok 3: Zainstaluj plik licencji¶

1. Znajdź plik license.toml dostarczony Ci
2. Skopiuj go do katalogu głównego instalacji digna (tam, gdzie znajdują się config.toml i plik wykonywalny digna)

Dlaczego to ważne: Plik licencji zawiera informacje o kliencie, datę wygaśnięcia licencji i podpis cyfrowy. Nie modyfikuj tego pliku — jakiekolwiek zmiany unieważnią licencję.

Struktura katalogów po konfiguracji:

digna_installation/
├── config.toml         (plik konfiguracyjny)
├── license.toml        (TWÓJ PLIK LICENCYJNY - skopiuj tutaj)
├── digna               (główny plik wykonywalny)
└── dashboard/          (interfejs webowy)
    └── (pliki dashboardu)

Konfiguracja backendu¶

Krok 1: Utwórz i edytuj plik konfiguracyjny¶

Plik config_template.toml jest dostarczony w katalogu instalacyjnym digna. Wystarczy go zmienić nazwę na config.toml.

Lokalizacja: digna_installation/config.toml

Otwórz config.toml w edytorze tekstu i skonfiguruj każdą z poniższych sekcji.

Sekcja [app]¶

Ta sekcja konfiguruje mechanizm CORS (cross-origin resource sharing) między dashboardem a backendem:

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

Sekcja [repo]¶

Ta sekcja konfiguruje połączenie z bazą danych PostgreSQL:

[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

Sekcja [base]¶

Ta sekcja zawiera ustawienia bezpieczeństwa, ciasteczek i inspekcji:

[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

Sekcja [encryption]¶

Ta sekcja zawiera klucz służący do szyfrowania wrażliwych wartości przechowywanych w repozytorium. Jest wymagana — config check zgłasza sekcję [encryption] jako FAILED, jeśli klucza brakuje.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Sekcja [logging]¶

Ta sekcja konfiguruje zachowanie logowania:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

Sekcja [duckdb] (opcjonalna)¶

Nowość w wydaniu 2026.11. Ta sekcja określa zasoby digna Engine, który profiluje dane wewnątrz digna dla połączeń z bazami danych, których lokalizacja profilowania to Silnik digna, oraz wykonuje kontrole integralności referencyjnej między źródłami danych w różnych połączeniach z bazami danych. Zobacz Lokalizacja profilowania.

Sekcja jest opcjonalna. Bez niej obowiązują poniższe wartości domyślne.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "C:\\path\\to\\digna\\tmp"

mkdir C:\path\to\digna\tmp

Krok 2: Sprawdź konfigurację¶

Przed zainicjowaniem repozytorium sprawdź, czy config.toml jest kompletny i poprawnie zbudowany. W katalogu instalacyjnym digna uruchom:

digna config check

Każda sekcja jest sprawdzana osobno, więc pojedynczy błąd nie zasłania stanu pozostałych:

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

Popraw wszystko, co zostało zgłoszone jako FAILED, i uruchom polecenie ponownie przed kontynuowaniem. Ostrzeżenie (WARNING) w pozycji Unknown keys wymienia klucze w config.toml, których digna nie odczytuje; nie mają one żadnego efektu, więc usuń je lub popraw ich pisownię. Pełną listę opcji znajdziesz w dokumentacji CLI.

Krok 3: Zainicjuj repozytorium¶

1. Otwórz Wiersz poleceń
2. Przejdź do katalogu instalacji digna (tam, gdzie znajdują się config.toml i plik wykonywalny digna)
3. Uruchom test połączenia:

digna repo check

W nowym schemacie polecenie łączy się, a następnie zgłasza, że repozytorium nie jest jeszcze zainstalowane:

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

Na tym etapie jest to oczekiwany wynik: potwierdza, że digna dociera do PostgreSQL i do schematu. Błąd połączenia lub uwierzytelniania wskazuje natomiast na sekcję [repo] lub na konfigurację PostgreSQL.

Krok 4: Zainstaluj schemat repozytorium¶

W tym samym katalogu uruchom:

digna repo upgrade

To polecenie instaluje niezbędne tabele w schemacie repozytorium i kończy się komunikatem:

✅ Repo schema 'dignarepo' is up to date.

Krok 5: Utwórz użytkownika administratora¶

1. Otwórz nowe okno Wiersza poleceń
2. Przejdź do katalogu instalacji digna
3. Uruchom poniższe polecenie, aby utworzyć użytkownika admin:

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

Przykład:

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

To tworzy użytkownika z pełnymi uprawnieniami administracyjnymi.

Krok 6: Uruchom serwer digna¶

W katalogu instalacyjnym digna uruchom serwer poleceniem:

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

Parametry: - --address — nazwa hosta/IP serwera (domyślnie 127.0.0.1) - --port — port serwera (domyślnie 8000)

Po uruchomieniu serwer wypisuje adres, na którym nasłuchuje:

Server running on http://127.0.0.1:8082

Konfiguracja dashboardu¶

Krok 1: Wdróż dashboard na serwerze WWW¶

Dashboard digna odczytuje własną konfigurację z pliku dashboard/dashboard_config.toml. Ten plik nie jest dostarczany z instalacją — tworzysz go w katalogu dashboard/, obok plików dashboardu.

Jego zawartość opisano w sekcji Logowanie jednokrotne (SSO), bo właśnie tam ten plik jest potrzebny: zawiera opcje logowania oferowane przez dashboard oraz, w przypadku wdrożeń wieloinstancyjnych, połączenie z backendem.

Wybierz serwer WWW i postępuj zgodnie z odpowiednimi krokami wdrożeniowymi.

Wdrażanie w IIS¶

1. Otwórz IIS Manager

2. Naciśnij Win + R, wpisz inetmgr, naciśnij Enter

3. Utwórz nową witrynę

4. W lewym panelu kliknij prawym przyciskiem myszy Sites

5. Wybierz Add Website...

6. Skonfiguruj witrynę

7. Site Name: Wpisz nazwę (np. "dignaDashboard")
8. Physical Path: Kliknij Przeglądaj i wybierz folder dashboard

9. Binding: Ustaw adres IP i port (domyślny port 80 dla HTTP, 443 dla HTTPS)

10. Uruchom witrynę

11. Kliknij OK, aby utworzyć witrynę

12. Kliknij prawym przyciskiem myszy nową witrynę i wybierz Start

13. Przetestuj instalację

14. Otwórz przeglądarkę
15. Przejdź do http://localhost (lub skonfigurowanego URL)
16. Powinieneś zobaczyć stronę logowania dashboardu digna

Wdrażanie w Apache Tomcat¶

1. Skopiuj dashboard do Tomcat
2. Skopiuj folder dashboard do katalogu webapps Tomcata
3. Zmień nazwę, jeśli potrzeba (np. na digna)

4. Przykład: C:\Program Files\Apache Tomcat\webapps\digna

5. Zweryfikuj wdrożenie

6. Odśwież lub przeładuj stronę zarządzania Tomcatem (http://localhost:8080)

7. Powinieneś zobaczyć "digna" (lub wybraną nazwę) na liście wdrożonych aplikacji

8. Dostęp do dashboardu

9. Otwórz przeglądarkę
10. Przejdź do http://localhost:8080/digna
11. Powinieneś zobaczyć stronę logowania dashboardu digna

Uruchamianie digna jako usługi Windows¶

Dlaczego używać usługi Windows?¶

Uruchomienie backendu digna jako usługi Windows zapewnia, że: - Uruchamia się automatycznie podczas startu serwera - Działa w tle bez otwartego okna Wiersza poleceń - Automatycznie się restartuje w razie awarii - Może być zarządzana za pomocą narzędzia Usługi systemu Windows

Polecenia windows¶

Usługą zarządza sam plik wykonywalny digna, za pomocą podpoleceń digna windows. Nie ma żadnych plików wsadowych do uruchamiania.

Każde polecenie przyjmuje --name, aby wskazać usługę zarejestrowaną pod nazwą inną niż domyślna. Pełna lista opcji znajduje się w dokumentacji CLI.

Instalacja usługi¶

1. Otwórz Wiersz poleceń jako Administrator
2. Kliknij prawym przyciskiem myszy Wiersz poleceń

3. Wybierz "Uruchom jako administrator"

4. Przejdź do katalogu instalacyjnego digna

   cd C:\path\to\digna
   

5. Zarejestruj usługę

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Usługa jest rejestrowana z automatycznym uruchamianiem, więc będzie startować razem z systemem Windows. Nie uruchamia się od razu — zobacz następną sekcję.

Opcje instalacji¶

Uruchamianie i zatrzymywanie usługi¶

Aby uruchomić usługę¶

digna windows start

Aby zatrzymać usługę¶

digna windows stop

Przenoszenie usługi do nowego katalogu¶

Jeśli musisz przenieść instalację digna:

1. Zatrzymaj i wyrejestruj aktualną usługę

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

2. Przenieś pliki aplikacji

3. Przenieś cały folder instalacji digna do nowej lokalizacji

4. Zarejestruj usługę ponownie z nowej lokalizacji

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

Powtórz wszystkie wartości --address, --port lub --account użyte za pierwszym razem — poprzednia rejestracja już nie istnieje.

1. Uruchom usługę

   digna windows start
   

Odinstalowywanie usługi¶

1. Zatrzymaj działającą usługę

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

2. Wyrejestruj usługę

   digna windows uninstall
   

Serwer digna jest teraz wyrejestrowany jako usługa Windows.

Aktualizacja do nowego wydania¶

Ta sekcja opisuje aktualizację instalacji wydania 2026.06 do wydania 2026.11. Jeśli Twoja instalacja jest starsza, najpierw przeczytaj Aktualizacja z wydania wcześniejszego niż 2026.06.

Przed aktualizacją¶

Utworzenie kopii zapasowej repozytorium digna jest obowiązkowe

Przed aktualizacją digna wykonaj kopię zapasową repozytorium (PostgreSQL), aby zabezpieczyć się przed utratą danych. Kopia zapasowa pozwoli przywrócić stan w razie napotkania problemów podczas aktualizacji.

Zamów plik licencji dla wydania 2026.11

Wydanie 2026.11 wymaga nowego pliku license.toml. Poproś o niego zespół digna przed rozpoczęciem i przygotuj go na krok 7.

Aktualizacja z wydania wcześniejszego niż 2026.06¶

Wydanie 2026.06 wprowadziło trzy zmiany, które nadal obowiązują, gdy aktualizujesz starszą instalację bezpośrednio do wydania 2026.11:

• Tylko ODBC. digna łączy się z każdą technologią źródłową przez ODBC. Każde połączenie z bazą danych, które nie korzysta jeszcze z ODBC, trzeba po aktualizacji przestawić na ODBC; nie ma automatycznej konwersji. Wcześniej zainstaluj sterowniki ODBC na hoście digna, zobacz Instalacja sterownika ODBC na hoście digna, i przygotuj właściwości każdego połączenia na podstawie przewodników technologicznych. Łącznik Databricks Legacy już nie istnieje; przenieś te połączenia na łącznik Databricks.
• Jeden plik wykonywalny. dignabackend i dignacli zostały zastąpione pojedynczym plikiem wykonywalnym digna, który łączy backend i CLI.
• config.toml. Sekcja [encryption] jest wymagana, a DIGNA_APP_HOST i DIGNA_APP_PORT nie są już odczytywane: adres i port serwer pobiera z digna serve. Porównaj swój plik z Konfiguracją backendu.

Poniższe kroki wskazują, w których miejscach starsza instalacja wymaga innego postępowania. Aktualizacja repozytorium w kroku 8 przenosi repozytorium z dowolnego wcześniejszego wydania bezpośrednio do wydania 2026.11.

Proces aktualizacji¶

Krok 1: Zatrzymaj usługę digna¶

Otwórz Wiersz poleceń jako administrator i zatrzymaj usługę za pomocą pliku wykonywalnego digna bieżącej instalacji:

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

Usługa pozostaje zarejestrowana. Nowy plik wykonywalny zajmuje miejsce starego w tym samym katalogu, więc rejestracja nadal wskazuje właściwy plik.

Jeśli digna działa na pierwszym planie, naciśnij Ctrl+C w jej oknie Wiersza poleceń.

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

Krok 2: Wykonaj kopię bieżącej instalacji¶

W katalogu instalacyjnym digna zmień nazwy pliku wykonywalnego i folderu dashboardu bieżącej instalacji, aby nowe wydanie mogło zostać wdrożone obok nich:

cd C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

Zachowaj digna_old.exe do czasu zweryfikowania aktualizacji, a dashboard_old, dopóki nie odtworzysz z niego swoich plików konfiguracyjnych (patrz krok 4). Potem możesz usunąć oba.

Krok 3: Rozpakuj i wdróż nową wersję¶

1. Rozpakuj nowy plik ZIP instalacji digna
2. Skopiuj nowy plik wykonywalny digna oraz folder dashboard do katalogu instalacyjnego

Krok 4: Przywróć pliki konfiguracyjne¶

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

Wydanie 2026.11 nie wymaga żadnych zmian w config.toml: plik, który działa z wydaniem 2026.06, działa nadal. Dwie zmiany są opcjonalne:

• Dodaj sekcję [duckdb], jeśli połączenia z bazami danych mają korzystać z digna Engine, a jego wartości domyślne nie pasują do Twojego hosta.
• Pomiń sekcję [app], jeśli reverse proxy serwuje dashboard i backend pod jednym originem.

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

Krok 5: Przeładuj serwer WWW¶

Dashboard to zestaw plików statycznych, więc serwer WWW — i przeglądarka — mogą nadal serwować poprzednią wersję. Przeładuj lub zrestartuj serwer WWW, który udostępnia folder dashboard, a następnie przeładuj stronę z wymuszonym odświeżeniem (Ctrl+F5).

Krok 6: Sprawdź konfigurację¶

Upewnij się, że config.toml jest kompletny, zanim dotkniesz repozytorium:

digna config check

Każda sekcja musi zgłosić OK. Popraw wszystko, co zostało zgłoszone jako FAILED, usuń klucze wymienione w pozycji Unknown keys i uruchom polecenie ponownie przed kontynuowaniem.

Krok 7: Wymień plik licencji¶

Plik licencji zwykle przechodzi bez zmian z jednego wydania do następnego. Wydanie 2026.11 jest wyjątkiem: dodaje dwa licencjonowane moduły, digna Data Reconciliation i digna Agentic, a licencja wystawiona przed wydaniem 2026.11 ich nie zawiera. Skopiuj plik license.toml dostarczony przez zespół digna dla wydania 2026.11 do katalogu instalacyjnego, zastępując stary:

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

digna license check

Krok 8: Zaktualizuj schemat repozytorium¶

W katalogu instalacyjnym digna uruchom:

digna repo upgrade

Wydanie 2026.11 zarządza schematem repozytorium za pomocą wersjonowanych migracji. Pierwsza aktualizacja z wcześniejszego wydania doprowadza schemat do ostatniej wersji poprzedniego mechanizmu, zapisuje ją jako punkt wyjścia, a następnie stosuje migracje wydania 2026.11. Kończy się komunikatem:

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

Wszystkie istniejące dane zostają zachowane. Aby w dowolnym momencie sprawdzić stan repozytorium, uruchom digna repo check: polecenie pokazuje ostatnią zastosowaną migrację oraz migracje oczekujące.

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

Krok 9: Uruchom ponownie usługi¶

Jeśli digna działa jako usługa Windows, uruchom ją ponownie:

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

Jeśli aktualizujesz z wydania wcześniejszego niż 2026.06 i w kroku 1 wyrejestrowałeś usługę, najpierw zarejestruj ją ponownie za pomocą pliku wykonywalnego digna:

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

Podaj w --address i --port wartości, na których nasłuchiwała stara usługa, chyba że chcesz użyć wartości domyślnych 127.0.0.1 i 8000. Dodaj --account i --password, jeśli stara usługa działała na koncie domenowym. Pełną listę opcji znajdziesz w sekcji Uruchamianie digna jako usługi Windows.

Jeśli uruchamiasz ręcznie, zrestartuj serwer:

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

Jeśli korzystasz z IIS lub Tomcata, zrestartuj odpowiedni serwer WWW.

Krok 10: Zweryfikuj aktualizację¶

1. Potwierdź wydanie nowego pliku wykonywalnego:

   digna version
   

   Pierwszy wiersz musi brzmieć Release: 2026.11.

2. Otwórz dashboard digna i sprawdź, czy interfejs ładuje się poprawnie.

3. Sprawdź pliki w katalogu logs instalacji pod kątem błędów.
4. Przetestuj połączenia z bazami danych — zobacz Testowanie połączenia. Po aktualizacji z wydania wcześniejszego niż 2026.06 najpierw przestaw na ODBC każde połączenie, które jeszcze z niego nie korzystało.

Aby zacząć pracę z nowymi modułami, zobacz digna Data Reconciliation, Podłączanie agenta AI w przypadku digna MCP Server oraz Lokalizacja profilowania w przypadku digna Engine.