Windows Installation Guide for digna Release 2026.06¶

Wydanie: 2026.06

Ostatnia aktualizacja: 30 sierpnia 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.06¶

To wydanie wprowadza możliwości obserwowalności danych bezpośrednio w kodzie, umożliwiając deweloperom monitorowanie jakości danych u źródła. Zobacz notatki o wydaniu po pełne szczegóły.

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 ustawienia aplikacji backend digna:

[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 = ["*"]

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!"

Sekcja [base]¶

Ta sekcja zawiera ustawienia bezpieczeństwa i ciasteczek:

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

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_BACKUP_COUNT = 10

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

Overall: OK

Popraw wszystko, co zostało zgłoszone jako FAILED, i uruchom polecenie ponownie przed kontynuowaniem. 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

Powinieneś zobaczyć potwierdzenie, że połączenie zostało nawiązane (repozytorium samo w sobie nie zostało jeszcze zainicjowane).

Krok 4: Zainstaluj schemat repozytorium¶

W tym samym katalogu uruchom:

digna repo install

To polecenie instaluje niezbędne tabele i schemat w Twojej bazie PostgreSQL.

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 - --port — port serwera

Powinieneś zobaczyć komunikaty startowe potwierdzające uruchomienie serwera:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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¶

Przed aktualizacją¶

Najpierw zweryfikuj wszystkie połączenia z bazami danych

Od wydania 2026.06 digna łączy się z każdą technologią źródłową przez ODBC. Wcześniejsze wydania dawały wybór między sterownikiem właściwym dla danej technologii a ODBC, wskazywany przełącznikiem Use ODBC. Zespół digna zdecydował się oprzeć wyłącznie na ODBC, ponieważ jeden standardowy interfejs daje więcej niż zestaw sterowników pisanych na miarę:

• Uwierzytelnianie — uwierzytelnianie jest częścią ODBC, więc połączenie może korzystać ze wszystkiego, co obsługuje jego sterownik: haseł, tokenów i PAT-ów, Kerberosa i Active Directory, MFA i logowania jednokrotnego przez przeglądarkę, tożsamości chmurowych, certyfikatów klienta i TLS. Nowe metody pojawiają się wraz z aktualizacją sterownika, a nie po oczekiwaniu na wydanie digna.
• Sterowniki utrzymywane przez dostawców baz danych — sterownik producenta nadąża za nowymi wersjami serwera i poprawkami bezpieczeństwa, a Ty możesz aktualizować go we własnym tempie, niezależnie od digna.
• Jeden sposób konfigurowania wszystkiego — każda technologia to lista właściwości klucz–wartość, z tym samym interfejsem, tym samym szyfrowaniem wartości wrażliwych i tą samą diagnostyką, zamiast innego zestawu pól dla każdego źródła.
• Strojenie i zasięg — opcje sterownika, takie jak limity czasu, ustawienia TLS, serwery proxy i rozmiary pobierania, są dostępne dla każdego źródła, a podłączyć można każdą technologię ze zgodnym sterownikiem ODBC, również taką, dla której digna nie publikuje osobnego przewodnika.

W praktyce oznacza to, że przełącznik Use ODBC oraz osobne pola hosta, portu, bazy danych, użytkownika i hasła już nie istnieją. Każde połączenie, które nie korzysta jeszcze z ODBC, musi zostać przestawione na ODBC — nie ma automatycznej konwersji, więc zaplanuj to przed aktualizacją:

1. Przejrzyj każde połączenie z bazą danych zdefiniowane w Twojej instalacji i wypisz te, które nie używają jeszcze ODBC — każde z nich trzeba skonfigurować od nowa.
2. Zainstaluj odpowiedni sterownik ODBC na hoście digna — połączenia otwierane są z serwera, na którym działa backend digna, a nie z przeglądarki. Zobacz Instalacja sterownika ODBC na hoście digna.
3. Przygotuj właściwości ODBC dla każdego objętego zmianą połączenia. Przewodniki technologiczne podają dla każdego źródła sprawdzony zestaw właściwości.

Po aktualizacji przestaw każde objęte zmianą połączenie na ODBC i przetestuj je z poziomu pulpitu — zobacz Tworzenie połączenia z bazą danych oraz Testowanie połączenia.

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.

Proces aktualizacji¶

Krok 1: Zatrzymaj i wyrejestruj starą usługę¶

Jeśli digna działa jako usługa Windows, zatrzymaj ją za pomocą plików wsadowych bieżącej instalacji — polecenia digna windows należą do nowego wydania i nie są jeszcze dostępne:

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

Następnie wyrejestruj usługę, ponownie za pomocą starego pliku wsadowego. Rejestracja wskazuje na stary plik wykonywalny i jego skrypty, które ta aktualizacja zastępuje, więc nie można jej użyć ponownie:

uninstall_service.bat

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

W katalogu instalacyjnym digna zmień nazwy folderów bieżącej instalacji, aby nowe wydanie mogło zostać wdrożone obok nich:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

Krok 3: Rozpakuj i wdroż 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

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

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 zaktualizowany 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, i uruchom polecenie ponownie przed kontynuowaniem.

Krok 7: Wymień plik licencji¶

Każde wydanie jest licencjonowane osobno. Skopiuj plik license.toml dostarczony przez zespół digna dla tego wydania 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¶

Przejdź do katalogu instalacyjnego digna i uruchom:

digna repo upgrade

To zaktualizuje schemat PostgreSQL do najnowszej wersji, zachowując wszystkie istniejące dane.

Krok 9: Zarejestruj i uruchom usługę¶

Stara rejestracja została usunięta w kroku 1, więc usługę rejestruje się ponownie — tym razem za pomocą pliku wykonywalnego digna, bez plików wsadowych:

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ć nowych wartości domyślnych 127.0.0.1 i 8000; są one zapisywane w rejestracji i nie są już odczytywane z config.toml. 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. Uzyskaj dostęp do dashboardu digna
2. Sprawdź, czy interfejs ładuje się poprawnie
3. Sprawdź logi serwera pod kątem ewentualnych błędów
4. Przestaw na ODBC każde połączenie, które jeszcze z niego nie korzystało, a następnie przetestuj wszystkie połączenia — zobacz Testowanie połączenia