Przewodnik instalacji digna Release 2026.11 dla macOS¶

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 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.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 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.11-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 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 = "/opt/digna/tmp"

mkdir -p /opt/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 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

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.

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

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¶

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

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.

Aby utworzyć kopię zapasową z Terminala:

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

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¶

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 pliku wykonywalnego i folderu dashboardu bieżącej instalacji, aby nowe wydanie mogło zostać wdrożone obok nich:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Zachowaj digna_old 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
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

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

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:

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

./digna license check

Krok 8: Zaktualizuj schemat repozytorium¶

W katalogu instalacyjnym digna uruchom:

cd /opt/digna
./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 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. 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ź dane wyjściowe serwera oraz pliki w katalogu logs 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.