Průvodce instalací na macOS pro digna Release 2026.11¶

Release: 2026.11

Poslední aktualizace: 7. listopadu 2026

Obsah¶

1. Úvod
2. Systémové požadavky
3. Předinstalační nastavení
4. Nastavení PostgreSQL serveru
5. Konfigurace webového serveru
6. Počáteční instalace
7. Konfigurace backendu
8. Konfigurace dashboardu
9. Spuštění digna jako služby na pozadí
10. Upgrade na novou verzi

Úvod¶

O digna¶

digna je komplexní platforma poháněná AI navržená k optimalizaci řízení kvality dat v různých datových prostředích jako datové sklady, datová jezera a lakehouse. Je navržena pro vysokou škálovatelnost a přizpůsobivost a řeší moderní problémy s daty pomocí automatizace, monitorování v reálném čase a detekce anomálií.

digna se skládá ze dvou hlavních komponent:

• digna: jádro aplikace, které zpracovává data a provádí kontroly kvality. Spojuje backend a rozhraní příkazového řádku do jediného spustitelného souboru a nahrazuje tak samostatné programy dignabackend a dignacli z předchozích verzí.
• dignadashboard: Webové rozhraní hostované na webovém serveru, poskytující uživatelsky přívětivé prostředí pro práci s platformou digna a vizualizaci metrik kvality dat.

Co je nového ve verzi 2026.11¶

Toto vydání přináší digna Data Reconciliation, digna Agentic s digna MCP Server a digna Engine, který umí profilovat data přímo v digna a kontrolovat referenční integritu mezi různými databázovými technologiemi. Kompletní podrobnosti naleznete v poznámkách k vydání.

Pro instalaci toto vydání přináší nový mechanismus migrací repozitáře, volitelnou sekci [duckdb] v souboru config.toml pro digna Engine a nový licenční soubor. Všem se věnuje sekce o upgradu.

Hledáte Windows nebo Linux?¶

Tento průvodce pokrývá macOS. Pro jiné platformy viz Windows Installation Guide nebo Linux Installation Guide.

Systémové požadavky¶

Než začnete s instalací, ověřte, že váš systém splňuje následující minimální požadavky:

Možnosti instalace databáze¶

Pokud je PostgreSQL již nainstalovaný: Můžete do existujícího PostgreSQL serveru přidat novou databázi pro digna.

Pokud instalujete PostgreSQL na stejný stroj jako digna:

Kontrola architektury¶

Několik cest v tomto návodu se liší mezi Apple Silicon a Intel Macy. Pro zjištění spusťte v Terminálu:

uname -m

• arm64 — Apple Silicon. Homebrew instaluje do /opt/homebrew.
• x86_64 — Intel. Homebrew instaluje do /usr/local.

Předinstalační nastavení¶

Před instalací digna se ujistěte, že jsou splněny tři klíčové předpoklady:

1. Homebrew – správce balíčků používaný k instalaci komponent níže
2. PostgreSQL Server – pro ukládání vypočítaných metrik a výkonových dat
3. Webový server – pro hostování digna Dashboardu

Pokud tyto komponenty ještě nejsou nastaveny, postupujte podle níže uvedených sekcí pro jejich instalaci a konfiguraci.

Instalace Homebrew¶

Homebrew je standardní správce balíčků pro macOS a je používán v celém tomto průvodci k instalaci PostgreSQL a nginx.

Krok 1: Zkontrolujte, zda je Homebrew již nainstalovaný¶

Otevřete Terminál (stiskněte Cmd + Space, napište Terminal, stiskněte Enter) a spusťte:

brew --version

Pokud se objeví číslo verze, přeskočte na sekci Nastavení PostgreSQL serveru.

Krok 2: Nainstalujte Homebrew¶

Pokud příkaz nebyl nalezen, nainstalujte Homebrew podle pokynů na oficiálních stránkách Homebrew. Instalátor také nainstaluje Xcode Command Line Tools, pokud již nejsou přítomny.

Krok 3: Přidejte Homebrew do PATH¶

Na Apple Silicon vypíše instalátor dva příkazy pro přidání Homebrew do vašeho shellového prostředí. Spusťte je podle pokynů a pak ověřte:

brew --prefix

To by mělo vypsat /opt/homebrew na Apple Silicon nebo /usr/local na Intel.

Nastavení PostgreSQL serveru¶

Pokud již máte PostgreSQL¶

Pokud je PostgreSQL již nainstalovaný a běžící na lokálním stroji nebo používáte spravovaný vzdálený PostgreSQL server, můžete přejít na další sekci.

Možnosti instalace¶

macOS nabízí dvě jednoduché možnosti instalace PostgreSQL. Vyberte jednu:

• Homebrew — instalace z příkazové řádky, doporučeno pro servery
• Postgres.app — grafická instalace, pohodlné pro lokální vyhodnocení

Instalace PostgreSQL přes Homebrew¶

Krok 1: Nainstalujte verzi PostgreSQL¶

brew install postgresql@16

Krok 2: Přidejte PostgreSQL do PATH¶

Verzované formule PostgreSQL jsou keg-only, což znamená, že Homebrew automaticky nelinkuje jejich příkazy do PATH. Přidejte je sami:

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

Krok 3: Spusťte službu PostgreSQL¶

brew services start postgresql@16

Tím se PostgreSQL spustí ihned a zároveň se nastaví, aby se spouštěl automaticky při přihlášení.

Krok 4: Ověřte instalaci¶

psql --version

Měli byste vidět verzi PostgreSQL, pokud byla instalace úspěšná.

Krok 5: Připojte se k serveru¶

psql postgres

Krok 6: Potvrďte port¶

Výchozí port PostgreSQL je 5432. Pro potvrzení, na jakém portu server naslouchá:

psql postgres -c "SHOW port;"

Zapamatujte si hodnotu — budete ji potřebovat při konfiguraci digna backendu.

Instalace PostgreSQL pomocí Postgres.app¶

Pokud preferujete grafickou instalaci:

1. Stáhněte Postgres.app a přetáhněte jej do složky Applications
2. Otevřete aplikaci a klikněte na Initialize pro vytvoření nového serveru
3. Postupujte podle pokynů aplikace pro přidání jejích příkazových nástrojů do PATH
4. Ověřte instalaci:

psql --version

Postgres.app také vytvoří superuživatele pojmenovaného podle vašeho macOS účtu.

Konfigurace webového serveru¶

digna vyžaduje webový server pro hostování dashboardu. Vyberte jednu z následujících možností:

• nginx — instalovaný přes Homebrew, doporučeno
• Apache httpd — součást macOS

Stačí nainstalovat a konfigurovat jeden z těchto serverů.

Obě sekce nastavují dvě věci, na kterých dashboard závisí:

• Fallback pro single-page aplikaci, aby obnovení URL dashboardu v prohlížeči nevracelo 404
• MIME typ pro .md, aby byly Markdown soubory servírovány správně

Nastavení nginx¶

Přehled¶

nginx je lehký, výkonný webový server vhodný pro servírování statického digna dashboardu.

Instalace¶

brew install nginx

Spuštění nginx¶

brew services start nginx

Ověření instalace¶

1. Otevřete prohlížeč
2. Přejděte na http://localhost:8080
3. Měli byste vidět uvítací stránku nginx

Konfigurace webu pro dashboard¶

Konfigurace Homebrew nginx zahrnuje všechny soubory ve složce servers. Vytvořte věnovaný konfigurační soubor pro digna tam:

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

Vložte následující, nahraďte /path/to/digna/dashboard skutečnou cestou k rozbalené složce 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;
    }
}

Aplikujte konfiguraci¶

Otestujte syntaxi konfigurace, pak reloadujte nginx:

nginx -t
brew services restart nginx

Nastavení Apache httpd¶

Přehled¶

macOS obsahuje Apache httpd, takže instalace není nutná. Ve výchozím stavu je vypnutý.

Spuštění Apache¶

sudo apachectl start

Ověření instalace¶

1. Otevřete prohlížeč
2. Přejděte na http://localhost
3. Měli byste vidět hlášku "It works!"

Povinné: povolit mod_rewrite¶

Dashboard vyžaduje přepisování URL. Otevřete Apache konfiguraci:

sudo nano /etc/apache2/httpd.conf

Najděte následující řádek a odstraňte počáteční #, aby byl odkomentován:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Povinné: povolit .htaccess Overrides¶

Ve stejném souboru najděte blok <Directory "/Library/WebServer/Documents"> a změňte:

AllowOverride None

na:

AllowOverride All

Povinné: MIME typ pro Markdown soubory¶

Stále v httpd.conf přidejte následující řádek, aby byly Markdown soubory servírovány správně:

AddType text/markdown .md

Aplikujte konfiguraci¶

Zkontrolujte konfiguraci na syntaktické chyby a restartujte Apache:

sudo apachectl configtest
sudo apachectl restart

Počáteční instalace¶

Krok 1: Nastavte repozitář digna¶

Repozitář digna uchovává všechny metriky vypočtené digna. Slouží jako centrální databáze pro analytická a výkonová data.

Vytvoření schématu a uživatele repozitáře¶

Otevřete svůj PostgreSQL klient (psql, pgAdmin nebo podobně) a spusťte následující SQL příkazy:

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

Nahraďte následující zástupné hodnoty:

• <digna_repo_schema> — Vámi zvolené jméno schématu (např. dignarepo)
• <digna_repo_user> — Vámi zvolené uživatelské jméno (např. digna_user)
• <digna_repo_password> — Bezpečné heslo pro tohoto uživatele

Příklad:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Pro spuštění z Terminálu v jednom kroku:

psql postgres

Poté vložte příkazy na promptu postgres=# a zadejte \q pro ukončení.

Krok 2: Rozbalte instalační balík digna¶

1. Najděte ZIP soubor instalačního balíku digna, který jste obdrželi
2. Rozbalte jej do vámi zvoleného instalačního umístění — například /opt/digna nebo ~/digna
3. Po rozbalení byste měli vidět následující položky:
4. dashboard/ — webové rozhraní dashboardu
5. digna — hlavní spustitelný soubor (backend + CLI v jednom)

Pro rozbalení z Terminálu:

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

Nastavte spustitelné oprávnění¶

V závislosti na způsobu přenosu může spustitelný bit po rozbalení chybět. Nastavte jej explicitně:

cd /opt/digna
chmod +x digna

Pokud macOS blokuje aplikaci¶

Soubory stažené přes prohlížeč nebo e-mailový klient jsou označeny karanténním atributem. Pokud macOS ohlásí, že aplikaci "nelze otevřít, protože vývojáře nelze ověřit", odstraňte atribut z instalační složky:

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

Alternativně otevřete System Settings → Privacy & Security, najděte zablokovanou položku u spodní části stránky a klikněte Open Anyway.

Krok 3: Nainstalujte licenční soubor¶

1. Najděte soubor license.toml, který jste obdrželi
2. Zkopírujte jej do kořenového instalačního adresáře digna (tam, kde jsou config.toml a spustitelný soubor digna)

Proč je to důležité: Licenční soubor obsahuje informace o zákazníkovi, datum vypršení licence a digitální podpis. Neměňte tento soubor — jakákoli úprava jej zneplatní.

Struktura adresářů po nastavení:

/opt/digna/
├── config.toml         (konfigurační soubor)
├── license.toml        (VÁŠ LICENČNÍ SOUBOR - zkopírujte sem)
├── digna               (hlavní spustitelný soubor)
├── bin/                (skripty pro správu služby)
└── dashboard/          (webové rozhraní)
    └── (soubory dashboardu)

Konfigurace backendu¶

Krok 1: Vytvořte a upravte konfigurační soubor¶

Soubor config_template.toml je dodán ve vaší instalační složce digna. Stačí jej přejmenovat na config.toml.

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

Umístění: /opt/digna/config.toml

Otevřete config.toml v textovém editoru a nakonfigurujte každou sekci níže.

Sekce [app]¶

Tato sekce konfiguruje sdílení prostředků mezi různými původy (CORS) mezi dashboardem a backendem:

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

Sekce [repo]¶

Tato sekce konfiguruje připojení k PostgreSQL databázi:

[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

Sekce [base]¶

Tato sekce obsahuje nastavení zabezpečení, cookie a inspekcí:

[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

Sekce [encryption]¶

Tato sekce obsahuje klíč, kterým se šifrují citlivé hodnoty uložené v repozitáři. Je povinná — config check hlásí sekci [encryption] jako FAILED, pokud klíč chybí.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Sekce [logging]¶

Tato sekce konfiguruje chování logování:

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

Sekce [duckdb] (volitelná)¶

Novinka v Release 2026.11. Tato sekce nastavuje prostředky pro digna Engine, který profiluje data přímo v digna u databázových připojení, jejichž místem profilování je digna Engine, a spouští kontroly referenční integrity mezi zdroji dat na různých databázových připojeních. Viz Místo profilování.

Sekce je volitelná. Bez ní platí níže uvedené výchozí hodnoty.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

Krok 2: Ověřte konfiguraci¶

Před inicializací repozitáře ověřte, že je config.toml úplný a správně sestavený. V instalačním adresáři digna spusťte:

./digna config check

Každá sekce se ověřuje samostatně, takže jediná chyba nezakryje stav ostatních:

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

Opravte vše, co je hlášeno jako FAILED, a před pokračováním příkaz spusťte znovu. WARNING v části Unknown keys uvádí klíče v config.toml, které digna nečte; nemají žádný účinek, proto je odstraňte nebo opravte jejich zápis. Úplný seznam voleb najdete v referenci CLI.

Krok 3: Inicializujte repozitář¶

1. Otevřete Terminál
2. Přejděte do instalačního adresáře digna (kde jsou config.toml a spustitelný soubor digna)
3. Spusťte test připojení:

cd /opt/digna
./digna repo check

Na novém schématu se příkaz připojí a poté oznámí, že repozitář zatím není nainstalován:

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

V tuto chvíli je to očekávaný výsledek: potvrzuje, že se digna dostane k PostgreSQL i ke schématu. Chyba připojení nebo ověření naopak ukazuje na sekci [repo] nebo na nastavení PostgreSQL.

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

Krok 4: Nainstalujte schéma repozitáře¶

Ve stejném adresáři spusťte:

./digna repo upgrade

Tento příkaz nainstaluje potřebné tabulky do schématu repozitáře a skončí hlášením:

✅ Repo schema 'dignarepo' is up to date.

Krok 5: Vytvořte administrátorského uživatele¶

1. Otevřete nové okno Terminálu
2. Přejděte do instalačního adresáře digna
3. Spusťte následující příkaz pro vytvoření admin uživatele:

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

Příklad:

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

Tím se vytvoří uživatel s e-mailovou adresou admin@example.com a plnými administrátorskými oprávněními.

Krok 6: Spusťte digna server¶

V instalačním adresáři digna spusťte server:

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

Parametry: - --address — hostname/IP serveru (výchozí 127.0.0.1) - --port — port serveru (výchozí 8000)

Jakmile server běží, vypíše adresu, na které naslouchá:

Server running on http://127.0.0.1:8082

Konfigurace dashboardu¶

Krok 1: Nasazení dashboardu na webový server¶

Dashboard digna načítá svou vlastní konfiguraci ze souboru dashboard/dashboard_config.toml. Tento soubor není součástí instalace — vytvoříte jej ve složce dashboard/ vedle souborů dashboardu.

Jeho obsah je popsán v části Jednotné přihlášení (SSO), kde je soubor také potřeba: obsahuje možnosti přihlášení, které dashboard nabízí, a u nasazení s více instancemi také připojení k backendu.

Vyberte svůj webový server a postupujte podle odpovídajících kroků.

Nasazení na nginx¶

Pokud jste postupovali podle sekce nginx Setup, server block již směřuje na vaši složku dashboard a žádné kopírování není potřeba.

1. Potvrďte cestu
2. Otevřete $(brew --prefix)/etc/nginx/servers/digna.conf

3. Ověřte, že root ukazuje na rozbalenou složku dashboard

4. Ujistěte se, že složka je čitelná

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

5. Reload nginx

   nginx -t
   brew services restart nginx
   

6. Ověřte instalaci

7. Otevřete prohlížeč
8. Přejděte na http://localhost:8080 (nebo na vaši nakonfigurovanou URL)
9. Měli byste vidět přihlašovací stránku digna dashboardu

Nasazení na Apache httpd¶

1. Zkopírujte dashboard do document root

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

2. Přidejte Rewrite pravidla

Vytvořte soubor .htaccess ve deployed složce, aby se při obnovení v prohlížeči nezobrazovala 404:

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

Vložte následující:

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. Restartujte Apache

   sudo apachectl restart
   

2. Přístup k dashboardu

3. Otevřete prohlížeč
4. Přejděte na http://localhost/digna
5. Měli byste vidět přihlašovací stránku digna dashboardu

Spuštění digna jako služby na pozadí¶

Proč spouštět digna jako službu?¶

Spuštění backendu digna jako služby na pozadí zajistí, že:

• Se automaticky spustí při startu stroje
• Běží na pozadí bez otevřeného okna Terminálu
• Automaticky se restartuje při pádu
• Lze jej spravovat přes launchctl, správce služeb macOS

Soubory pro správu služby¶

Všechny potřebné soubory jsou umístěny v instalačním adresáři digna pod: bin/

Následující shell skripty jsou k dispozici:

• install_service.sh — zaregistruje digna v launchd
• uninstall_service.sh — odregistruje službu
• start_service.sh — spustí registrovanou službu
• stop_service.sh — zastaví běžící službu

Nastavení spustitelnosti skriptů¶

Při rozbalení se spustitelný bit nemusí zachovat. Před prvním použitím:

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

Instalace služby¶

1. Otevřete Terminál

2. Přejděte do složky bin

   cd /opt/digna/bin
   

3. Spusťte instalační skript

   sudo ./install_service.sh
   

Digna server je nyní zaregistrován v launchd s povoleným automatickým spuštěním. Služba se tímto nezapne okamžitě — viz další sekci pro její spuštění.

Spuštění a zastavení služby¶

Chcete-li službu spustit¶

1. Otevřete Terminál
2. Přejděte do /opt/digna/bin
3. Spusťte:

   sudo ./start_service.sh
   

Chcete-li službu zastavit¶

1. Otevřete Terminál
2. Přejděte do /opt/digna/bin
3. Spusťte:

   sudo ./stop_service.sh
   

Ověření služby¶

Pro potvrzení, že je služba zaregistrovaná a běží:

sudo launchctl list | grep digna

Řádek začínající PIDem značí, že služba běží. - v prvním sloupci znamená, že je zaregistrovaná, ale zastavená.

Přesunutí služby do nového adresáře¶

launchd ukládá absolutní cestu ke spustitelnému souboru, takže při přesunu instalace je nutné službu znovu zaregistrovat:

1. Odinstalujte aktuální službu

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

2. Přesuňte soubory aplikace

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

3. Znovu nainstalujte službu

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

4. Spusťte službu

   sudo ./start_service.sh
   

Odinstalování služby¶

1. Zastavte běžící službu

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

2. Odinstalujte službu

   sudo ./uninstall_service.sh
   

Digna server je nyní odregistrován z launchd.

Upgrade na novou verzi¶

Tato sekce popisuje upgrade instalace Release 2026.06 na Release 2026.11. Pokud je vaše instalace starší, přečtěte si nejprve Upgrade z verze starší než 2026.06.

Před upgradem¶

Vytvoření zálohy repozitáře digna je povinné

Před upgradem digna zálohujte svůj repozitář (PostgreSQL), abyste se ochránili proti ztrátě dat. Záloha vám umožní obnovit data, pokud by během upgradu nastaly neočekávané problémy.

Pro vytvoření zálohy z Terminálu:

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

Vyžádání licenčního souboru pro Release 2026.11

Release 2026.11 vyžaduje nový soubor license.toml. Vyžádejte si jej od týmu digna ještě před zahájením a mějte jej připravený pro krok 7.

Upgrade z verze starší než 2026.06¶

Release 2026.06 přinesl tři změny, které platí i tehdy, když starší instalaci upgradujete přímo na 2026.11:

• Pouze ODBC. digna přistupuje ke každé zdrojové technologii přes ODBC. Každé databázové připojení, které ODBC dosud nepoužívá, musí být po upgradu převedeno na ODBC; automatický převod neexistuje. Předem nainstalujte ovladače ODBC na hostitele digna, viz Instalace ovladače ODBC na hostitele digna, a mějte připravené vlastnosti každého připojení z příruček k jednotlivým technologiím. Konektor Databricks Legacy už neexistuje; převeďte tato připojení na konektor Databricks.
• Jeden spustitelný soubor. dignabackend a dignacli jsou nahrazeny jediným spustitelným souborem digna, který spojuje backend a CLI.
• config.toml. Sekce [encryption] je povinná a DIGNA_APP_HOST a DIGNA_APP_PORT se již nenačítají: server si adresu a port bere z digna serve. Porovnejte svůj soubor s částí Konfigurace backendu.

Následující kroky upozorňují na místa, kde starší instalace vyžaduje jiný postup. Upgrade repozitáře v kroku 8 převede repozitář jakékoli dřívější verze přímo na 2026.11.

Postup upgradu¶

Krok 1: Zastavte službu digna¶

Pokud digna běží jako služba na pozadí, nejprve ji zastavte:

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

Pokud digna běží v popředí, stiskněte v jejím okně Terminálu Ctrl+C.

Krok 2: Zálohujte stávající instalaci¶

V instalačním adresáři digna přejmenujte spustitelný soubor a složku dashboardu stávající instalace, aby vedle nich bylo možné nasadit nové vydání:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Soubor digna_old si ponechte, dokud upgrade neověříte, a složku dashboard_old, dokud z ní neobnovíte své konfigurační soubory (viz krok 4). Poté můžete obojí smazat.

Krok 3: Rozbalte a nasaďte novou verzi¶

1. Rozbalte nový ZIP soubor s instalací digna
2. Zkopírujte nový spustitelný soubor digna a složku dashboard do instalačního adresáře
3. Obnovte příznak spustitelnosti a v případě potřeby odstraňte atribut karantény:

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

Krok 4: Obnovte konfigurační soubory¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 nevyžaduje žádnou změnu v config.toml: soubor, který funguje s Release 2026.06, funguje i nadále. Dvě změny jsou volitelné:

• Přidejte sekci [duckdb], pokud mají databázová připojení používat digna Engine a jeho výchozí hodnoty vašemu hostiteli nevyhovují.
• Vynechte sekci [app], pokud reverzní proxy servíruje dashboard i backend pod jedním původem.

[[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: Znovu načtěte webový server¶

Dashboard je sada statických souborů, takže váš webový server — i prohlížeč — může stále servírovat předchozí verzi. Znovu načtěte nebo restartujte webový server, který hostuje složku dashboard, a poté stránku znovu načtěte s vynuceným obnovením (Cmd+Shift+R).

Krok 6: Ověřte konfiguraci¶

Než sáhnete na repozitář, ověřte, že je config.toml úplný:

./digna config check

Každá sekce musí hlásit OK. Opravte vše, co je hlášeno jako FAILED, odstraňte klíče uvedené v části Unknown keys a před pokračováním příkaz spusťte znovu.

Krok 7: Nahraďte licenční soubor¶

Licenční soubor se obvykle přenáší z jednoho vydání do dalšího. Release 2026.11 je výjimkou: přidává dva licencované moduly, digna Data Reconciliation a digna Agentic, a licence vydaná před 2026.11 je neobsahuje. Zkopírujte soubor license.toml, který vám tým digna poskytl pro Release 2026.11, do instalačního adresáře a nahraďte jím ten starý:

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

./digna license check

Krok 8: Upgradujte schéma repozitáře¶

V instalačním adresáři digna spusťte:

cd /opt/digna
./digna repo upgrade

Release 2026.11 spravuje schéma repozitáře pomocí verzovaných migrací. První upgrade z dřívější verze převede schéma na poslední verzi předchozího mechanismu, zaznamená ji jako svůj výchozí bod a poté použije migrace Release 2026.11. Skončí hlášením:

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

Všechna existující data zůstanou zachována. Stav repozitáře můžete kdykoli zjistit příkazem ./digna repo check: vypíše poslední použitou migraci a všechny čekající.

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

Krok 9: Restartujte služby¶

Pokud digna běží jako služba na pozadí:

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

Pokud digna spouštíte ručně, restartujte server:

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

Pokud používáte nginx nebo Apache, restartujte příslušný webový server:

brew services restart nginx

sudo apachectl restart

Krok 10: Ověřte upgrade¶

1. Ověřte vydání nového spustitelného souboru:

   ./digna version
   

   První řádek musí znít Release: 2026.11.

2. Otevřete dashboard digna a ověřte, že se rozhraní načítá správně.

3. Zkontrolujte výstup serveru a soubory v adresáři logs, zda neobsahují chyby.
4. Otestujte databázová připojení — viz Testování připojení. Po upgradu z verze starší než 2026.06 nejprve převeďte na ODBC každé připojení, které ODBC dosud nepoužívalo.

Jak začít s novými moduly, popisují stránky digna Data Reconciliation, Připojení AI agenta pro digna MCP Server a Místo profilování pro digna Engine.