Przewodnik instalacji digna Release 2026.06 dla macOS¶

Wydanie: 2026.06

Ostatnia aktualizacja: 5 września 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 w tle
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 Windows lub Linux?¶

Ten przewodnik dotyczy macOS. Dla innych platform zobacz Przewodnik instalacji dla Windows 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:

Sprawdzanie architektury¶

Kilka ścieżek w tym przewodniku różni się między komputerami Mac z Apple Silicon i z procesorem Intel. Aby sprawdzić, który masz, otwórz Terminal i uruchom:

uname -m

• arm64 — Apple Silicon. Homebrew instaluje się w /opt/homebrew.
• x86_64 — Intel. Homebrew instaluje się w /usr/local.

Przygotowanie przed instalacją¶

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

1. Homebrew – menedżer pakietów używany do instalacji poniższych komponentów
2. Serwer PostgreSQL – do przechowywania wyliczonych metryk i danych wydajnościowych
3. 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ć.

Instalacja Homebrew¶

Homebrew to standardowy menedżer pakietów dla macOS, używany w całym przewodniku do instalacji PostgreSQL i nginx.

Krok 1: Sprawdź, czy Homebrew jest już zainstalowany¶

Otwórz Terminal (naciśnij Cmd + Space, wpisz Terminal i naciśnij Enter) i uruchom:

brew --version

Jeśli zostanie zwrócony numer wersji, przejdź do sekcji Konfiguracja serwera PostgreSQL.

Krok 2: Zainstaluj Homebrew¶

Jeśli polecenie nie zostało znalezione, zainstaluj Homebrew zgodnie z instrukcjami na oficjalnej stronie Homebrew. Instalator instaluje również Xcode Command Line Tools, jeśli nie są jeszcze obecne.

Krok 3: Dodaj Homebrew do zmiennej PATH¶

Na komputerach z Apple Silicon instalator wypisuje dwa polecenia, które dodają Homebrew do środowiska powłoki. Uruchom je zgodnie z instrukcją, a następnie sprawdź:

brew --prefix

Powinno zostać wypisane /opt/homebrew na Apple Silicon lub /usr/local na komputerach z procesorem Intel.

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.

Opcje instalacji¶

macOS oferuje dwa proste sposoby instalacji PostgreSQL. Wybierz jeden:

• Homebrew — instalacja z wiersza poleceń, zalecana dla wdrożeń serwerowych
• Postgres.app — instalacja graficzna, wygodna do lokalnej oceny

Instalacja PostgreSQL za pomocą Homebrew¶

Krok 1: Zainstaluj formułę PostgreSQL¶

brew install postgresql@16

Krok 2: Dodaj PostgreSQL do zmiennej PATH¶

Wersjonowane formuły PostgreSQL są typu keg-only, co oznacza, że Homebrew nie dołącza automatycznie ich poleceń do zmiennej PATH. Dodaj je samodzielnie:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Krok 3: Uruchom usługę PostgreSQL¶

brew services start postgresql@16

To polecenie natychmiast uruchamia PostgreSQL i konfiguruje go tak, aby automatycznie uruchamiał się ponownie po zalogowaniu.

Krok 4: Zweryfikuj instalację¶

psql --version

Jeśli instalacja się powiodła, powinieneś zobaczyć wersję PostgreSQL.

Krok 5: Połącz się z serwerem¶

psql postgres

Krok 6: Potwierdź port¶

Domyślny port PostgreSQL to 5432. Aby potwierdzić port, na którym nasłuchuje Twój serwer:

psql postgres -c "SHOW port;"

Zanotuj tę wartość — będzie potrzebna podczas konfigurowania backendu digna.

Instalacja PostgreSQL za pomocą Postgres.app¶

Jeśli wolisz instalację graficzną:

1. Pobierz Postgres.app i przeciągnij aplikację do folderu Applications
2. Otwórz aplikację i kliknij Initialize, aby utworzyć nowy serwer
3. Postępuj zgodnie z instrukcjami aplikacji, aby dodać jej narzędzia wiersza poleceń do zmiennej PATH
4. Zweryfikuj instalację:

psql --version

Postgres.app również tworzy superużytkownika o nazwie Twojego konta macOS.

Konfiguracja serwera WWW¶

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

• nginx — instalowany przez Homebrew, zalecany
• Apache httpd — dołączony do macOS

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

Obie sekcje konfigurują dwie rzeczy, od których zależy dashboard:

• Mechanizm awaryjny dla aplikacji jednostronicowej (SPA), aby odświeżenie adresu URL dashboardu nie zwracało błędu 404
• Typ MIME dla .md, aby pliki Markdown były serwowane poprawnie

Konfiguracja nginx¶

Przegląd¶

nginx to lekki, wydajny serwer WWW, dobrze nadający się do serwowania statycznego dashboardu digna.

Instalacja¶

brew install nginx

Uruchamianie nginx¶

brew services start nginx

Zweryfikuj instalację¶

1. Otwórz przeglądarkę
2. Przejdź do http://localhost:8080
3. Powinieneś zobaczyć stronę powitalną nginx

Konfigurowanie witryny dla dashboardu¶

Konfiguracja nginx z Homebrew dołącza każdy plik ze swojego katalogu servers. Utwórz tam dedykowany plik konfiguracyjny dla digna:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Wklej poniższą treść, zastępując /path/to/digna/dashboard rzeczywistą ścieżką do rozpakowanego folderu dashboard:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Zastosuj konfigurację¶

Sprawdź konfigurację pod kątem błędów składni, a następnie przeładuj nginx:

nginx -t
brew services restart nginx

Konfiguracja Apache httpd¶

Przegląd¶

macOS zawiera Apache httpd, więc instalacja nie jest potrzebna. Domyślnie jest on wyłączony.

Uruchamianie Apache¶

sudo apachectl start

Zweryfikuj instalację¶

1. Otwórz przeglądarkę
2. Przejdź do http://localhost
3. Powinieneś zobaczyć komunikat "It works!"

Wymagane: włącz mod_rewrite¶

Dashboard wymaga przepisywania adresów URL. Otwórz konfigurację Apache:

sudo nano /etc/apache2/httpd.conf

Znajdź następujący wiersz i usuń początkowy znak #, aby go odkomentować:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Wymagane: zezwól na nadpisywanie przez .htaccess¶

W tym samym pliku znajdź blok <Directory "/Library/WebServer/Documents"> i zmień:

AllowOverride None

na:

AllowOverride All

Wymagane: typ MIME dla plików Markdown¶

Nadal w httpd.conf dodaj następujący wiersz, aby pliki Markdown były serwowane poprawnie:

AddType text/markdown .md

Zastosuj konfigurację¶

Sprawdź konfigurację pod kątem błędów składni, a następnie zrestartuj Apache:

sudo apachectl configtest
sudo apachectl restart

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 (psql, pgAdmin 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;

Aby wykonać je z Terminala w jednym kroku:

psql postgres

Następnie wklej polecenia w wierszu zachęty postgres=# i wpisz \q, aby zakończyć.

Krok 2: Rozpakuj pakiet instalacyjny digna¶

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

Aby rozpakować archiwum z Terminala:

unzip digna-2026.06-macos.zip -d /opt/digna

Nadaj plikowi wykonywalnemu prawo do uruchamiania¶

W zależności od sposobu przesłania archiwum bit wykonywalności może nie zachować się po rozpakowaniu. Ustaw go jawnie:

cd /opt/digna
chmod +x digna

Jeśli macOS blokuje aplikację¶

Pliki pobrane przez przeglądarkę lub klienta poczty są oznaczane atrybutem kwarantanny. Jeśli macOS zgłasza, że aplikacji "nie można otworzyć, ponieważ nie można zweryfikować dewelopera", usuń ten atrybut z katalogu instalacyjnego:

xattr -dr com.apple.quarantine /opt/digna

Możesz też otworzyć Ustawienia systemowe → Prywatność i ochrona, znaleźć zablokowany element u dołu strony i kliknąć Otwórz mimo to.

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:

/opt/digna/
├── config.toml         (plik konfiguracyjny)
├── license.toml        (TWÓJ PLIK LICENCYJNY - skopiuj tutaj)
├── digna               (główny plik wykonywalny)
├── bin/                (skrypty zarządzania usługą)
└── 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 zmienić jego nazwę na config.toml.

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

Lokalizacja: /opt/digna/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 Terminal
2. Przejdź do katalogu instalacji digna (tam, gdzie znajdują się config.toml i plik wykonywalny digna)
3. Uruchom test połączenia:

cd /opt/digna
./digna repo check

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

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

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¶

Użytkownik administratora jest tworzony bezpośrednio w schemacie repozytorium, więc serwer nie musi jeszcze działać. W katalogu instalacji digna uruchom:

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

Przykład:

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

To tworzy użytkownika o adresie e-mail admin@example.com 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 nginx¶

Jeśli wykonano kroki z sekcji Konfiguracja nginx, blok server wskazuje już na folder dashboard i kopiowanie nie jest potrzebne.

1. Potwierdź ścieżkę
2. Otwórz $(brew --prefix)/etc/nginx/servers/digna.conf

3. Sprawdź, czy root wskazuje na rozpakowany folder dashboard

4. Upewnij się, że folder jest czytelny

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

5. Przeładuj nginx

   nginx -t
   brew services restart nginx
   

6. Przetestuj instalację

7. Otwórz przeglądarkę
8. Przejdź do http://localhost:8080 (lub skonfigurowanego adresu URL)
9. Powinieneś zobaczyć stronę logowania dashboardu digna

Wdrażanie w Apache httpd¶

1. Skopiuj dashboard do katalogu głównego dokumentów

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Dodaj reguły przepisywania

Utwórz plik .htaccess we wdrożonym folderze, aby trasy dashboardu działały po odświeżeniu przeglądarki:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Wklej poniższą treść:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Zrestartuj Apache

   sudo apachectl restart
   

2. Otwórz dashboard

3. Otwórz przeglądarkę
4. Przejdź do http://localhost/digna
5. Powinieneś zobaczyć stronę logowania dashboardu digna

Uruchamianie digna jako usługi w tle¶

Dlaczego uruchamiać digna jako usługę?¶

Uruchomienie backendu digna jako usługi w tle zapewnia, że:

• Uruchamia się automatycznie podczas startu maszyny
• Działa w tle bez otwartego okna Terminala
• Automatycznie się restartuje w razie awarii
• Można nim zarządzać za pomocą launchctl, menedżera usług systemu macOS

Pliki zarządzania usługą¶

Wszystkie niezbędne pliki znajdują się w katalogu instalacji digna w: bin/

Dostępne skrypty powłoki:

• install_service.sh — rejestruje digna w launchd
• uninstall_service.sh — usuwa rejestrację usługi
• start_service.sh — uruchamia zarejestrowaną usługę
• stop_service.sh — zatrzymuje działającą usługę

Nadawanie skryptom prawa do uruchamiania¶

Rozpakowanie może nie zachować bitu wykonywalności. Przed pierwszym użyciem wykonaj:

cd /opt/digna/bin
chmod +x *.sh

Instalacja usługi¶

1. Otwórz Terminal

2. Przejdź do folderu bin

   cd /opt/digna/bin
   

3. Uruchom skrypt instalacyjny

   sudo ./install_service.sh
   

Serwer digna jest teraz zarejestrowany w launchd z włączonym automatycznym uruchamianiem. Usługa nie uruchamia się od razu — zobacz następną sekcję, aby ją uruchomić.

Uruchamianie i zatrzymywanie usługi¶

Aby uruchomić usługę¶

1. Otwórz Terminal
2. Przejdź do /opt/digna/bin
3. Uruchom:

   sudo ./start_service.sh
   

Aby zatrzymać usługę¶

1. Otwórz Terminal
2. Przejdź do /opt/digna/bin
3. Uruchom:

   sudo ./stop_service.sh
   

Weryfikacja usługi¶

Aby potwierdzić, że usługa jest zarejestrowana i działa:

sudo launchctl list | grep digna

Wiersz zaczynający się od identyfikatora procesu oznacza, że usługa działa. Znak - w pierwszej kolumnie oznacza, że usługa jest zarejestrowana, ale zatrzymana.

Przenoszenie usługi do nowego katalogu¶

launchd przechowuje bezwzględną ścieżkę do pliku wykonywalnego, więc przeniesienie instalacji wymaga ponownej rejestracji usługi:

1. Odinstaluj aktualną usługę

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Przenieś pliki aplikacji

   sudo mv /old/path/digna /new/path/digna
   

3. Zainstaluj usługę ponownie

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Uruchom usługę

   sudo ./start_service.sh
   

Odinstalowywanie usługi¶

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

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

2. Odinstaluj usługę

   sudo ./uninstall_service.sh
   

Serwer digna jest teraz wyrejestrowany z launchd.

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.

Aby utworzyć kopię zapasową z Terminala:

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

Proces aktualizacji¶

Krok 1: Zatrzymaj usługę digna¶

Jeśli digna działa jako usługa w tle, najpierw ją zatrzymaj:

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

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

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:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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
3. Przywróć bit wykonywalności i w razie potrzeby usuń atrybut kwarantanny:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Krok 4: Przywróć pliki konfiguracyjne¶

cp 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 (Cmd+Shift+R).

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:

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

./digna license check

Krok 8: Zaktualizuj schemat repozytorium¶

Przejdź do katalogu instalacyjnego digna i uruchom:

cd /opt/digna
./digna repo upgrade

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

Krok 9: Uruchom ponownie usługi¶

Jeśli digna działa jako usługa w tle:

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

Jeśli uruchamiasz ręcznie, zrestartuj serwer:

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

Jeśli korzystasz z nginx lub Apache, zrestartuj odpowiedni serwer WWW:

brew services restart nginx

sudo apachectl restart

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