Průvodce instalací pro Windows pro digna Release 2026.06¶
Verze: 2026.06
Poslední aktualizace: 30. srpna 2026
Obsah¶
- Úvod
- Systémové požadavky
- Předinstalační nastavení
- Nastavení PostgreSQL serveru
- Konfigurace webového serveru
- Počáteční instalace
- Konfigurace backendu
- Konfigurace dashboardu
- Spuštění digna jako služby Windows
- Upgrade na nové vydání
Úvod¶
O digna¶
digna je komplexní platforma řízená umělou inteligencí navržená pro optimalizaci správy kvality dat napříč různými datovými prostředími, jako jsou datové sklady, datová jezera a lakehousy. Je navržena tak, aby byla vysoce škálovatelná a přizpůsobitelná, a řeší moderní datové výzvy pomocí automatizace, monitoringu 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
dignabackendadignacliz předchozích verzí. - dignadashboard: Webové rozhraní hostované na webovém serveru, které poskytuje uživatelsky přívětivý způsob interakce s platformou digna a vizualizace metrik kvality dat.
Co je nového ve vydání 2026.06¶
Toto vydání přináší možnosti pozorovatelnosti dat přímo do vašeho kódu, což umožňuje vývojářům sledovat kvalitu dat u zdroje. Kompletní podrobnosti najdete v release notes.
Hledáte macOS nebo Linux?¶
Tento průvodce pokrývá Windows. Pro jiné platformy viz macOS Installation Guide nebo Linux Installation Guide.
Systémové požadavky¶
Než začnete instalaci, ujistěte se, že váš systém splňuje následující minimální požadavky:
| Požadavek | Specifikace |
|---|---|
| Operační systém | Windows Server nebo Windows 10/11 |
| Paměť (minimální konfigurace) | 16 GB RAM |
| Volné místo na disku | 10 GB dostupného úložiště |
| Databáze | PostgreSQL Server 12 nebo vyšší |
| Webový server | IIS, Apache Tomcat nebo ekvivalent |
Možnosti instalace databáze¶
Pokud je PostgreSQL již nainstalován: Můžete do stávajícího PostgreSQL serveru přidat novou databázi pro digna.
Pokud instalujete PostgreSQL na stejný stroj jako digna:
Doporučené specifikace
- Paměť: 32 GB RAM (namísto 16 GB)
- Volné místo na disku: 50 GB dostupného úložiště (namísto 10 GB)
Tyto vyšší specifikace umožní současný provoz digna a PostgreSQL databáze.
Předinstalační nastavení¶
Než nainstalujete digna, ujistěte se, že máte připraveny dvě klíčové předpoklady:
- PostgreSQL Server – pro ukládání vypočtených metrik a výkonových dat
- Webový server – pro hostování digna Dashboardu
Pokud tyto komponenty nejsou nastaveny, následujte níže uvedené sekce pro jejich instalaci a konfiguraci.
Nastavení PostgreSQL serveru¶
Pokud už máte PostgreSQL¶
Pokud je PostgreSQL nainstalovaný a spuštěný na vašem lokálním stroji nebo pokud používáte spravovaný vzdálený PostgreSQL server, můžete přeskočit do následující sekce.
Instalace PostgreSQL¶
Postupujte podle těchto kroků pro instalaci PostgreSQL na Windows:
Krok 1: Stažení PostgreSQL¶
- Navštivte PostgreSQL Downloads page
- Vyberte Windows
- Stáhněte si nejnovější instalační program
Krok 2: Spuštění instalátoru¶
- Dvakrát klikněte na stažený instalační soubor
- Postupujte podle pokynů v průvodci instalací
Krok 3: Volba instalačního adresáře¶
Zvolte adresář, kam bude PostgreSQL nainstalován. Výchozí umístění je obvykle vhodné.
Krok 4: Výběr komponent¶
Pro standardní instalaci ponechte výchozí volby komponent.
Krok 5: Nastavení hesla superuživatele PostgreSQL¶
Zadejte a potvrďte heslo pro superuživatele PostgreSQL (postgres). Uložte toto heslo bezpečně — budete ho později potřebovat.
Krok 6: Konfigurace portu¶
Výchozí port PostgreSQL je 5432. Můžete použít výchozí nebo specifikovat jiný port podle potřeby.
Tip
Pokud je port 5432 již obsazen, zvolte alternativní port a poznamenejte si ho pro pozdější konfiguraci.
Krok 7: Volba locale¶
Vyberte locale pro vaši databázi. Výchozí nastavení je obvykle vhodné pro většinu instalací.
Krok 8: Dokončení instalace¶
Klikněte na Next v posledních krocích, poté klikněte na Finish.
Krok 9: Ověření instalace¶
Otevřete Příkazový řádek a ověřte, že je PostgreSQL nainstalován:
Měli byste vidět verzi PostgreSQL, pokud byla instalace úspěšná.
Konfigurace webového serveru¶
digna vyžaduje webový server pro hostování dashboardu. Zvolte jednu z následujících možností:
Stačí nainstalovat a nakonfigurovat jeden z těchto serverů.
Nastavení IIS¶
Přehled¶
Internet Information Services (IIS) je Microsoftův webový server pro hostování webových stránek a webových aplikací.
Povolení IIS¶
- Otevřete Ovládací panely
- Stiskněte
Win + R -
Napište
controla stiskněte Enter -
Přejděte na Windows Features
- Klikněte na Programs
-
Vyberte Turn Windows features on or off
-
Povolte Internet Information Services
- Sjeďte dolů a najděte Internet Information Services (IIS)
- Zaškrtněte políčko pro jeho povolení
-
Klikněte na + pro rozbalení a ověřte, že jsou vybrány tyto podkomponenty:
- Web Management Tools
- World Wide Web Services
-
Klikněte OK pro použití změn
-
Ověřte instalaci IIS
- Otevřete prohlížeč
- Přejděte na
http://localhost - Měli byste vidět uvítací stránku IIS
Požadováno: URL Rewrite Module¶
IIS vyžaduje komponentu URL Rewrite. Stáhněte a nainstalujte ji z oficiální Microsoft stránky.
Požadováno: MIME typ pro Markdown soubory¶
Aby byly Markdown soubory (.md) správně servírovány IIS:
- Otevřete IIS Manager (stiskněte
Win + R, napišteinetmgr, stiskněte Enter) - Přejděte na Your Site > MIME Types
- Klikněte Add...
- Nakonfigurujte:
- File name extension:
.md - MIME type:
text/markdown
Důležité
Bez tohoto nastavení nemusí být soubory .md správně servírovány.
Nastavení Apache Tomcat¶
Přehled¶
Apache Tomcat je open-source kontejner pro Java servlet a webový server.
Instalace¶
- Stáhněte Apache Tomcat
- Navštivte Apache Tomcat Downloads
-
Stáhněte Windows ZIP distribuci
-
Rozbalte archiv
- Rozbalte ZIP soubor do adresáře ve vašem systému
-
Příklad:
C:\Program Files\Apache Tomcat -
Ověřte, že Tomcat běží
- Otevřete prohlížeč
- Přejděte na
http://localhost:8080 - Měli byste vidět uvítací stránku Apache Tomcat
Tip
Apache Tomcat se obvykle po instalaci spustí automaticky. Pokud ne, přejděte do složky bin a spusťte startup.bat.
Počáteční instalace¶
Krok 1: Nastavení repozitáře digna¶
Repozitář digna ukládá všechny metriky vypočtené dignou. Funguje jako centrální databáze pro analytická a výkonová data.
Vytvoření schématu repozitáře a uživatele¶
Otevřete svůj PostgreSQL klient (pgAdmin, psql 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>— Název schématu podle vašeho výběru (např.dignarepo)<digna_repo_user>— Uživatelské jméno podle vašeho výběru (např.digna_user)<digna_repo_password>— Silné 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;
Doporučené postupy
Používejte silná, komplexní hesla pro databázové uživatele. Vyhněte se snadno uhodnutelným přihlašovacím údajům.
Krok 2: Rozbalení instalačního balíčku digna¶
- Najděte ZIP soubor s instalací digna, který vám byl poskytnut
- Rozbalte ho do požadovaného instalačního umístění
- Po rozbalení byste měli vidět následující položky:
dashboard/— Webové rozhraní dashboardudigna— Hlavní spustitelný soubor (backend + CLI dohromady)
Konfigurační a licenční soubory nejsou součástí balíčku
Soubory config.toml ani dashboard/dashboard_config.toml nejsou součástí instalace — oba si vytvoříte sami, v částech Konfigurace backendu a Konfigurace dashboardu. Ani license.toml není součástí balíčku; digna jej dodává samostatně, jak popisuje krok 3.
Krok 3: Instalace licenčního souboru¶
Důležité
Licenční soubor není součástí instalačního balíčku a bude vám dodán samostatně společností digna.
- Najděte soubor
license.toml, který vám byl poskytnut - Zkopírujte ho do kořenového instalačního adresáře digna (tam, kde jsou
config.tomla spustitelný soubordigna)
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 ho zneplatní.
Struktura adresářů po nastavení:
digna_installation/
├── config.toml (configuration file)
├── license.toml (YOUR LICENSE FILE - copy here)
├── digna (main executable)
└── dashboard/ (web interface)
└── (dashboard files)
Konfigurace backendu¶
Krok 1: Vytvoření a úprava konfiguračního souboru¶
Soubor config_template.toml je součástí instalačního adresáře digna. Stačí jej přejmenovat na config.toml.
Umístění: digna_installation/config.toml
Otevřete config.toml v textovém editoru a nakonfigurujte jednotlivé sekce níže.
Sekce [app]¶
Tato sekce konfiguruje nastavení aplikačního backendu 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 = ["*"]
| Parametr | Hodnota | Poznámky |
|---|---|---|
digna_APP_CORS_ALLOW_ORIGINS | URL frontend | Pokud je dashboard na jiném serveru, přidejte jeho URL |
digna_APP_CORS_ALLOW_CREDENTIALS | true | Požadováno pro CORS s credentials |
digna_APP_CORS_ALLOW_METHODS | ["*"] | Povolit všechny HTTP metody |
digna_APP_CORS_ALLOW_HEADERS | ["*"] | Povolit všechny hlavičky |
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!"
| Parametr | Hodnota | Poznámky |
|---|---|---|
digna_REPO_HOST | localhost nebo IP | Hostname/IP PostgreSQL serveru |
digna_REPO_PORT | 5432 (výchozí) | Port PostgreSQL |
digna_REPO_DB | postgres | Název databáze |
digna_REPO_SCHEMA | dignarepo | Dříve vytvořené schéma |
digna_REPO_USER | digna_user | Uživatel vytvořený v PostgreSQL |
digna_REPO_PASSWORD | Vaše heslo | Heslo nastavené při vytváření uživatele |
Sekce [base]¶
Tato sekce obsahuje bezpečnostní a cookie nastavení:
[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"
| Parametr | Hodnota | Poznámky |
|---|---|---|
DIGNA_FERNET_KEY | Šifrovací klíč | Používá se pro šifrování tokenů a cookie (výchozí je poskytnut) |
digna_COOKIE_DOMAIN | localhost | Musí odpovídat doméně frontendu |
digna_COOKIE_SECURE | false (lokálně) / true (produkce) | Pro HTTPS použijte true |
digna_COOKIE_HTTPONLY | true | Vždy povoleno z bezpečnostních důvodů |
digna_COOKIE_SAME_SITE | lax | Zabraňuje CSRF útokům |
digna_TOKEN_EXPIRES_IN | 86400 (24 hodin) | Vypršení relace v sekundách |
digna_MAX_WORKERS | Počet jader CPU - 1 | Počet paralelních inspekčních úloh |
DIGNA_SCHEDULER_MAX_DELAY | 100 | Maximální zpoždění v sekundách, které může plánovač přidat před spuštěním splatné úlohy |
DIGNA_CLEANUP_TIME | "12:00" | Denní čas (24hodinový formát HH:MM), kdy začíná denní úklid |
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í.
| Parametr | Hodnota | Poznámky |
|---|---|---|
DIGNA_ENCRYPTION_KEY | Klíč kódovaný v Base64 | Šifruje citlivé hodnoty uložené v repozitáři digna |
Chraňte soubor config.toml
Tento klíč je pevná hodnota, shodná ve všech instalacích digna, a právě on dešifruje citlivé hodnoty ve vašem repozitáři. Omezte přístup k config.toml na účet, pod kterým digna běží, držte soubor mimo správu verzí a sdílené disky a vynechte jej z každé zálohy uchovávané méně bezpečně než samotný repozitář.
Sekce [logging]¶
Tato sekce konfiguruje chování logování:
| Parametr | Hodnota | Poznámky |
|---|---|---|
digna_LOGGING_MODE | INFO nebo DEBUG | INFO pro produkci, DEBUG pro ladění |
digna_LOGGING_BACKUP_COUNT | 10 | Počet denních záloh logů, které se uchovávají |
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:
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
Overall: OK
Opravte vše, co je hlášeno jako FAILED, a před pokračováním příkaz spusťte znovu. Úplný seznam voleb najdete v referenci CLI.
Krok 3: Inicializace repozitáře¶
- Otevřete Příkazový řádek
- Přejděte do instalačního adresáře digna (tam, kde jsou
config.tomla spustitelný soubordigna) - Spusťte test připojení:
Měli byste obdržet potvrzení, že připojení bylo navázáno (repozitář samotný zatím nebyl inicializován).
Krok 4: Instalace schématu repozitáře¶
Ve stejném adresáři spusťte:
Tento příkaz nainstaluje potřebné tabulky a schéma ve vaší PostgreSQL databázi.
Krok 5: Vytvoření administrátorského uživatele¶
- Otevřete nové okno Příkazového řádku
- Přejděte do instalačního adresáře digna
- Spusťte následující příkaz pro vytvoření admin uživatele:
Příklad:
Tím vytvoříte uživatele s plnými administrátorskými právy.
Doporučené postupy
Používejte silné heslo kombinující velká a malá písmena, číslice a speciální znaky.
Krok 6: Spuštění serveru digna¶
V instalačním adresáři digna spusťte server pomocí:
Parametry: - --address — Hostname/IP serveru - --port — Port serveru
Měli byste vidět úvodní zprávy potvrzující, že server běží:
INFO: Started server process [1234]
INFO: Waiting for application startup.
INFO: Application startup complete
INFO: Uvicorn running on http://localhost:8082
Server drží terminál
serve běží na popředí a pokračuje, dokud jej nezastavíte pomocí Ctrl+C. Nechte jej běžet, než dokončíte nastavení; pokud jej chcete místo toho spouštět automaticky při startu, viz Spuštění digna jako služby Windows.
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.
Zvolte svůj webový server a postupujte podle odpovídajících kroků nasazení.
Nasazení do IIS¶
- Otevřete IIS Manager
-
Stiskněte
Win + R, napišteinetmgr, stiskněte Enter -
Vytvořte nový web
- V levém panelu klikněte pravým tlačítkem na Sites
-
Vyberte Add Website...
-
Konfigurujte web
- Site Name: Zadejte název (např. "dignaDashboard")
- Physical Path: Klikněte na Browse a vyberte složku
dashboard -
Binding: Nastavte IP adresu a port (výchozí port 80 pro HTTP, 443 pro HTTPS)
-
Spusťte web
- Klikněte OK pro vytvoření webu
-
Klikněte pravým tlačítkem na nový web a vyberte Start
-
Otestujte instalaci
- Otevřete prohlížeč
- Přejděte na
http://localhost(nebo na vámi nakonfigurovanou URL) - Měli byste vidět přihlašovací stránku dashboardu digna
Nasazení do Apache Tomcat¶
- Zkopírujte dashboard do Tomcatu
- Zkopírujte složku
dashboarddo adresářewebappsve vašem Tomcatu - Přejmenujte ji podle potřeby (např. na
digna) -
Příklad:
C:\Program Files\Apache Tomcat\webapps\digna -
Ověřte nasazení
- Obnovte nebo znovu načtěte stránku správy Tomcatu (http://localhost:8080)
-
Měli byste vidět "digna" (nebo zvolené jméno) v seznamu nasazených aplikací
-
Přístup k dashboardu
- Otevřete prohlížeč
- Přejděte na
http://localhost:8080/digna - Měli byste vidět přihlašovací stránku dashboardu digna
Spuštění digna jako služby Windows¶
Proč používat službu Windows?¶
Spuštění backendu digna jako služby Windows zajistí, že: - se automaticky spustí při startu serveru - poběží na pozadí bez otevřeného okna Příkazového řádku - se automaticky restartuje v případě selhání - lze ji spravovat přes správu služeb Windows
Příkazy windows¶
Službu spravuje přímo spustitelný soubor digna prostřednictvím podpříkazů digna windows. Nespouštějí se žádné batch soubory.
| Příkaz | Účel |
|---|---|
digna windows install | Registruje digna jako službu Windows |
digna windows start | Spustí registrovanou službu |
digna windows stop | Zastaví běžící službu |
digna windows uninstall | Odregistruje službu |
Vyžadováno oprávnění správce
Všechny čtyři příkazy musí být spuštěny z Příkazového řádku otevřeného jako správce.
Každý příkaz přijímá --name pro práci se službou registrovanou pod jiným než výchozím názvem. Úplný seznam voleb je v referenční příručce CLI.
Instalace služby¶
- Otevřete Příkazový řádek jako administrátor
- Klikněte pravým tlačítkem na Příkazový řádek
-
Vyberte "Spustit jako správce"
-
Přejděte do instalačního adresáře digna
-
Zaregistrujte službu
Zadejte adresu a port, pokud vám nevyhovují výchozí hodnoty
install zaznamená adresu a port do registrace služby a služba se naváže přesně na to, co bylo zaznamenáno. Výchozí hodnoty jsou 127.0.0.1 a 8000, které přijímají připojení pouze z tohoto počítače. Dashboard na jiném hostiteli se k nim nepřipojí, proto zadejte adresu, na které má backend naslouchat:
Tyto hodnoty se nenačítají z config.toml. Chcete-li je později změnit, službu odinstalujte a nainstalujte znovu s novými hodnotami.
Služba je registrována s automatickým spuštěním, takže se spustí spolu s Windows. Okamžitě se však nespustí — viz následující sekci.
Volby instalace¶
| Volba | Výchozí hodnota | Účel |
|---|---|---|
--name | digna | Název, pod kterým se služba registruje |
--display-name | digna | Název zobrazený v services.msc |
--description | digna data quality backend | Popis zobrazený v services.msc |
--address | 127.0.0.1 | Adresa, na kterou služba naváže své API |
--port | 8000 | Port, na který služba naváže své API |
--working-dir | adresář spustitelného souboru digna | Adresář obsahující config.toml a license.toml, který služba použije jako svůj pracovní adresář |
--start-type | auto | auto se spouští s Windows, manual se spouští jen na vyžádání, disabled službu zaregistruje, ale odmítne ji spustit |
--account | LocalSystem | Účet, pod kterým služba běží, např. DOMAIN\user nebo .\user |
--password | Heslo účtu --account |
Spuštění pod doménovým účtem
LocalSystem nemá žádnou síťovou identitu, takže ověřování Windows vůči SQL Serveru i jakýkoli přístup ke sdílené síťové složce selže. Pokud služba potřebuje přistupovat k prostředkům jako konkrétní uživatel, nainstalujte ji s --account a --password.
Spuštění a zastavení služby¶
Pro spuštění služby¶
Pro zastavení služby¶
Tip
Před aktualizací souborů aplikace vždy službu zastavte.
Přesunutí služby do nového adresáře¶
Pokud je potřeba přesunout instalaci digna:
-
Zastavte a odregistrujte současnou službu
-
Přesuňte soubory aplikace
-
Přesuňte celý instalační adresář digna na nové místo
-
Zaregistrujte službu znovu z nového umístění
Zopakujte všechny hodnoty --address, --port nebo --account, které jste použili poprvé — předchozí registrace již neexistuje.
- Spusťte službu
Odinštalování služby¶
-
Zastavte běžící službu
-
Odregistrujte službu
Server digna je nyní odregistrován jako služba Windows.
Upgrade na nové vydání¶
Před upgradem¶
Nejprve ověřte všechna databázová připojení
Od verze 2026.06 přistupuje digna ke každé zdrojové technologii přes ODBC. Dřívější verze nabízely volbu mezi ovladačem specifickým pro danou technologii a ODBC, vybíranou přepínačem Use ODBC. Tým digna se rozhodl stavět výhradně na ODBC, protože jediné standardní rozhraní přináší více než sada ovladačů šitých na míru:
- Ověřování — ověřování je součástí ODBC, takže připojení může použít vše, co jeho ovladač podporuje: hesla, tokeny a PAT, Kerberos a Active Directory, MFA a jednotné přihlášení přes prohlížeč, cloudové identity, klientské certifikáty a TLS. Nové metody přicházejí s aktualizací ovladače, místo čekání na vydání digna.
- Ovladače udržované výrobci databází — vlastní ovladač výrobce sleduje nové verze serveru i bezpečnostní opravy a můžete jej aktualizovat podle svého harmonogramu, nezávisle na digna.
- Jediný způsob konfigurace všeho — každá technologie je seznam vlastností klíč/hodnota se stejným rozhraním, stejným šifrováním citlivých hodnot a stejným řešením potíží, místo odlišné sady polí pro každý zdroj.
- Ladění a dosah — volby ovladače jako časové limity, nastavení TLS, proxy a velikosti načítání jsou dostupné pro každý zdroj a připojit lze jakoukoli technologii s odpovídajícím ovladačem ODBC, včetně těch, pro které digna nevydává samostatnou příručku.
V praxi to znamená, že přepínač Use ODBC ani samostatná pole hostitele, portu, databáze, uživatele a hesla už neexistují. Každé připojení, které ODBC dosud nepoužívá, musí být převedeno na ODBC — automatický převod neexistuje, naplánujte si to tedy před upgradem:
- Projděte každé databázové připojení definované ve vaší instalaci a poznamenejte si ta, která ODBC dosud nepoužívají — každé z nich bude třeba nakonfigurovat znovu.
- Nainstalujte odpovídající ovladač ODBC na hostitele digna — připojení se otevírají ze serveru, na kterém běží backend digna, nikoli z prohlížeče. Viz Instalace ovladače ODBC na hostitele digna.
- Mějte připravené vlastnosti ODBC pro každé dotčené připojení. Příručky k jednotlivým technologiím uvádějí pro každý zdroj ověřenou sadu vlastností.
Po upgradu převeďte každé dotčené připojení na ODBC a otestujte je z dashboardu — viz Vytvoření databázového připojení a Testování připojení.
Připojení Databricks Legacy
Konektor Databricks Legacy byl v této verzi odstraněn. Převeďte tato připojení na konektor Databricks.
Vytvoření zálohy repozitáře digna je povinné
Před upgradem digna zálohujte svůj repozitář (PostgreSQL), abyste se ochránili před ztrátou dat. Záloha zaručí, že v případě neočekávaných problémů s upgradem můžete obnovit data.
Proces upgradu¶
Krok 1: Zastavte a odregistrujte starou službu¶
Pokud běží digna jako služba Windows, zastavte ji pomocí batch souborů vaší stávající instalace — příkazy digna windows patří k nové verzi a zatím nejsou k dispozici:
Poté službu odregistrujte, opět pomocí starého batch souboru. Registrace odkazuje na starý spustitelný soubor a jeho skripty, které tento upgrade oba nahrazuje, takže ji nelze znovu použít:
Odregistrujte službu dříve, než cokoli přejmenujete
uninstall_service.bat se nachází ve složce bin, kterou se chystáte přejmenovat, a je to jediná věc, která může odstranit registraci, kterou vytvořil. Spusťte jej, dokud je stará instalace ještě na svém místě. Pokud již byla složka přejmenována, přejmenujte ji zpět, službu odregistrujte a poté pokračujte.
Poznamenejte si účet, pod kterým služba běžela, a adresu a port, na kterých poskytovala služby — budete je potřebovat v kroku 9.
Krok 2: Zálohujte stávající instalaci¶
V instalačním adresáři digna přejmenujte složky stávající instalace, aby vedle nich bylo možné nasadit novou verzi:
dignabackend a dignacli se již nepoužívají
Od verze 2026.06 jsou dignabackend a dignacli nahrazeny jediným spustitelným souborem digna, který spojuje backend a CLI. Složky dignabackend_old a dignacli_old si ponechte jen do doby, než upgrade ověříte — poté je můžete obě smazat. Složku dashboard_old si ponechte, dokud z ní neobnovíte své konfigurační soubory (viz krok 4). Odstraňuje se také složka bin: její batch soubory ovládaly starou službu a verze 2026.06 je nedodává, takže jakmile je služba v kroku 1 odregistrována, jsou jen zavádějící.
Krok 3: Rozbalte a nasadte novou verzi¶
- Rozbalte nový ZIP soubor s instalací digna
- Zkopírujte nový spustitelný soubor
dignaa složkudashboarddo vašeho instalačního adresáře
Důležité
Soubory config.toml ani dashboard/dashboard_config.toml nejsou nikdy součástí instalačního ZIP — tým digna žádný z nich nedodává. Vaše stávající konfigurace proto zůstane upgradem nedotčena a kopie v přejmenovaných složkách *_old jsou jediné, které máte.
Krok 4: Obnovení konfiguračních souborů¶
Verze 2026.06 mění soubor config.toml
Tři nastavení jsou nová a povinná, dvě se již nepoužívají. config.toml převzatý z dřívější verze nová nastavení neobsahuje a digna se nespustí, dokud budou chybět. Do stávajícího config.toml doplňte následující:
[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"
[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Přidejte dva klíče [base] do své stávající sekce [base] a přidejte [encryption] jako novou sekci. Poté odstraňte z [app] dvě nastavení, která se již nepoužívají, digna_APP_HOST a digna_APP_PORT — adresu a port si server nyní bere z digna serve.
Význam jednotlivých nastavení je popsán v části Konfigurace backendu.
Jednotné přihlášení: formát [oidc_clients] se změnil
Verze 2026.06 nahrazuje pole tabulek jednou tabulkou pro každého poskytovatele, pojmenovanou podle klíče poskytovatele. DIGNA_OIDC_KEY mizí — klíč je nyní součástí záhlaví sekce.
Před:
[[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'
Po:
[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'
Sekci zopakujte pro každého poskytovatele a každý klíč udržujte shodný s key v souboru dashboard_config.toml. digna config check hlásí oidc_clients jako FAILED, dokud stará podoba zůstává. Týká se to pouze instalací, které používají jednotné přihlášení.
Krok 5: Opětovné načtení webového serveru¶
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 (Ctrl+F5).
Krok 6: Ověřte konfiguraci¶
Než sáhnete na repozitář, ověřte, že je aktualizovaný config.toml úplný:
Každá sekce musí hlásit OK. Opravte vše, co je hlášeno jako FAILED, a před pokračováním příkaz spusťte znovu.
Krok 7: Nahrazení licenčního souboru¶
Každé vydání je licencováno samostatně. Zkopírujte soubor license.toml, který vám pro toto vydání poskytl tým digna, do instalačního adresáře a nahraďte jím ten starý:
Nenechávejte si předchozí licenci
Soubor license.toml vydaný pro dřívější vydání toto vydání nepokrývá a každý příkaz, který licenci kontroluje — user, inspection, repo — se při neúspěšné kontrole ukončí dříve, než se repozitáře dotkne. Než budete pokračovat, ověřte ji:
Krok 8: Upgrade schématu repozitáře¶
Přejděte do instalačního adresáře digna a spusťte:
Tím se aktualizuje PostgreSQL schéma na nejnovější verzi při zachování všech existujících dat.
Krok 9: Registrace a spuštění služby¶
Stará registrace byla odstraněna v kroku 1, proto se služba registruje znovu — tentokrát pomocí spustitelného souboru digna, který batch soubory nemá:
Pro --address a --port zadejte hodnoty, na kterých poskytovala služby stará služba, pokud nechcete nové výchozí hodnoty 127.0.0.1 a 8000; zaznamenávají se do registrace a již se nenačítají z config.toml. Pokud stará služba běžela pod doménovým účtem, přidejte --account a --password. Úplný seznam voleb najdete v části Spuštění digna jako služby Windows.
Pokud běží ručně, restartujte server:
Pokud používáte IIS nebo Tomcat, restartujte příslušný webový server.
Krok 10: Ověření upgradu¶
- Přistupte k dashboardu digna
- Ověřte, že se rozhraní načítá správně
- Zkontrolujte logy serveru, zda se nezobrazují chyby
- Převeďte na ODBC každé připojení, které jej dosud nepoužívalo, a poté otestujte všechna připojení — viz Testování připojení