Průvodce instalací pro Windows pro digna Release 2026.11¶
Verze: 2026.11
Poslední aktualizace: 7. listopadu 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.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 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 |
digna Engine
Databázová připojení, která jako místo profilování používají digna Engine, se profilují přímo na hostiteli digna. Naplánujte pro ně dodatečnou paměť a místo na disku, viz sekce [duckdb].
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 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
| Parametr | Hodnota | Poznámky |
|---|---|---|
DIGNA_APP_CORS_ALLOW_ORIGINS | URL dashboardu | URL, ze kterých je dashboard servírován. Požadavky prohlížeče z jakéhokoli jiného původu jsou odmítnuty |
DIGNA_APP_CORS_ALLOW_CREDENTIALS | true | Povinné, aby prohlížeč s každým požadavkem odesílal cookie relace |
Sekce [app] je volitelná
Od Release 2026.11 lze oba klíče i celou sekci [app] vynechat. To je správné nastavení, když reverzní proxy servíruje dashboard i backend pod jedním původem: prohlížeč pak neposílá žádné požadavky mezi různými původy a ve výchozím stavu není žádný takový požadavek povolen.
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
| 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 |
DIGNA_REPO_SSLMODE | prefer (výchozí) | Volitelné. Režim SSL pro PostgreSQL: disable, allow, prefer, require, verify-ca nebo verify-full |
DIGNA_REPO_NUM_CONNS | 16 (výchozí) | Volitelné. Počet připojení, která digna udržuje otevřená k repozitáři |
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
| Parametr | Hodnota | Poznámky |
|---|---|---|
DIGNA_FERNET_KEY | Hodnota uvedená výše | Klíč šifrování, které používaly dřívější verze. Musí být uveden; ponechte uvedenou hodnotu |
DIGNA_COOKIE_DOMAIN | localhost | Hostitel, pod kterým je dashboard dostupný. "" nenastavuje žádnou doménu, což je správné za proxy, která servíruje dashboard i backend pod jedním původem |
DIGNA_COOKIE_SECURE | false (HTTP) / true (HTTPS) | Musí být true, kdykoli je digna servírována přes HTTPS |
DIGNA_COOKIE_HTTPONLY | true | Chrání cookie relace před přístupem skriptů |
DIGNA_TOKEN_EXPIRES_IN | 86400 (24 hodin) | Vypršení relace v sekundách |
DIGNA_MAX_WORKERS | Počet jader CPU - 1 | Počet inspekcí, které mohou běžet současně |
DIGNA_FRONTEND_BASEURL | URL dashboardu | Povinné. Používá se pro odkazy ve zprávách s upozorněními, proto musí jít o URL, kterou příjemci dokážou otevřít |
DIGNA_SOURCE_QUERY_TIMEOUT_SEC | 3600 (výchozí) | Volitelné. Počet sekund, po které smí běžet jeden dotaz na zdrojovou databázi, než je přerušen; 0 časový limit vypíná |
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC | 30 (výchozí) | Volitelné. Počet sekund čekání na připojení ke zdrojové databázi; 0 čeká neomezeně dlouho |
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í. Přijímány jsou také TRACE, WARN a ERROR |
DIGNA_LOGGING_DIR | logs (výchozí) | Volitelné. Adresář pro rotované soubory logů, relativně k pracovnímu adresáři |
DIGNA_LOGGING_MAX_FILES | 30 (výchozí) | Volitelné. Počet rotovaných souborů logů, které se uchovávají |
Při běhu jako služba ponechte adresář logů
Služba Windows nemá konzoli, takže soubory logů jsou jediným záznamem o tom, co služba dělá. Nenastavujte DIGNA_LOGGING_DIR na prázdný řetězec, který soubory logů vypíná.
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 = "C:\\path\\to\\digna\\tmp"
| Parametr | Hodnota | Poznámky |
|---|---|---|
DIGNA_DUCKDB_MEMORY_LIMIT_MB | 1024 (výchozí) | Paměť v MB, kterou smí použít jeden běh digna Engine. Současně může být aktivních až DIGNA_MAX_WORKERS běhů |
DIGNA_DUCKDB_TEMP_DIRECTORY | Výchozí: dočasný adresář účtu, pod kterým digna běží (%TEMP%) | Adresář pro dočasné soubory, když se data nevejdou do paměti |
Dimenzování digna Engine
Počítejte na hostiteli digna s až DIGNA_MAX_WORKERS × DIGNA_DUCKDB_MEMORY_LIMIT_MB paměti navíc k tomu, co spotřebuje samotná digna, a s dostatkem volného místa na disku v dočasném adresáři, aby se do něj vešlo největší inspektované datum zdrojů dat, které používají digna Engine. Nasměrujte DIGNA_DUCKDB_TEMP_DIRECTORY na disk s takovým místem, do kterého smí zapisovat účet, pod kterým digna běží:
Tuto sekci potřebujete jen tehdy, když alespoň jedno databázové připojení používá digna Engine nebo když kontrola referenční integrity porovnává zdroje dat na různých připojeních.
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
- 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: 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í:
Na novém schématu se příkaz připojí a poté oznámí, že repozitář zatím není nainstalován:
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.
Krok 4: Instalace schématu repozitáře¶
Ve stejném adresáři spusťte:
Tento příkaz nainstaluje potřebné tabulky do schématu repozitáře a skončí hlášením:
repo upgrade instaluje i upgraduje
Od Release 2026.11 příkaz repo upgrade nainstaluje nový repozitář a upgraduje stávající. repo install dál funguje jako jiný název téhož příkazu.
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 (výchozí 127.0.0.1) - --port — Port serveru (výchozí 8000)
Jakmile server běží, vypíše adresu, na které naslouchá:
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í¶
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.
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.
dignabackendadignaclijsou nahrazeny jediným spustitelným souboremdigna, který spojuje backend a CLI. - config.toml. Sekce
[encryption]je povinná aDIGNA_APP_HOSTaDIGNA_APP_PORTse již nenačítají: server si adresu a port bere zdigna 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.
Proces upgradu¶
Krok 1: Zastavte službu digna¶
Otevřete Příkazový řádek jako správce a zastavte službu pomocí spustitelného souboru digna vaší stávající instalace:
Služba zůstane zaregistrovaná. Nový spustitelný soubor nahradí ten starý ve stejném adresáři, takže registrace bude dál odkazovat na správný soubor.
Pokud digna běží v popředí, stiskněte v jejím okně Příkazového řádku Ctrl+C.
Upgrade z verze starší než 2026.06
Verze starší než 2026.06 registrovaly službu pomocí batch souborů. Zastavte a odregistrujte ji pomocí batch souborů vaší stávající instalace, a to dříve, než v kroku 2 cokoli přejmenujete:
Poznamenejte si účet, pod kterým služba běžela, a adresu a port, na kterých poskytovala služby. Službu znovu zaregistrujete v kroku 9.
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í:
Soubor digna_old.exe 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.
Upgrade z verze starší než 2026.06
Místo spustitelného souboru přejmenujte složky dignabackend a dignacli: ren dignabackend dignabackend_old a ren dignacli dignacli_old. Release 2026.11 nepoužívá žádnou z těchto složek ani složku bin s batch soubory.
Krok 3: Rozbalte a nasaďte novou verzi¶
- Rozbalte nový ZIP soubor s instalací digna
- Zkopírujte nový spustitelný soubor
dignaa složkudashboarddo 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: Obnovte konfigurační soubory¶
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.
Nastavení, která digna nečte
Dřívější verze tohoto průvodce uváděly některá nastavení, která digna nečte. Nemají žádný účinek a config check je v kroku 6 vypisuje v části Unknown keys. Odstraňte je nebo je opravte:
DIGNA_SCHEDULER_MAX_DELAY,DIGNA_CLEANUP_TIME,digna_COOKIE_PATH,digna_COOKIE_SAME_SITE,digna_APP_CORS_ALLOW_METHODS,digna_APP_CORS_ALLOW_HEADERSadigna_LOGGING_BACKUP_COUNTneexistují. Odstraňte je.- V názvech nastavení se rozlišují velká a malá písmena. digna čte
DIGNA_REPO_HOST, nikolidigna_REPO_HOST. Pište všechny názvy velkými písmeny, jako v části Konfigurace backendu.
Jednotné přihlášení: ponechte [[oidc_clients]]
digna čte poskytovatele jednotného přihlášení jako seznam položek [[oidc_clients]], z nichž každá má vlastní DIGNA_OIDC_KEY. Pokud jste své poskytovatele změnili na sekce [oidc_clients.<key>], jak uváděla dřívější verze tohoto průvodce, vraťte je zpět. config check hlásí OIDC config(s) jako FAILED, dokud je tato podoba použita:
[[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'
Položku zopakujte pro každého poskytovatele a každý DIGNA_OIDC_KEY udržujte shodný s key v souboru dashboard_config.toml. Týká se to pouze instalací, které používají jednotné přihlášení.
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 (Ctrl+F5).
Krok 6: Ověřte konfiguraci¶
Než sáhnete na repozitář, ověřte, že je config.toml úplný:
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ý:
Nenechávejte si předchozí licenci
S předchozí licencí se digna sice spustí, ale digna Data Reconciliation a digna MCP Server zůstanou vypnuté. 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 novou licenci:
Krok 8: Upgradujte schéma repozitáře¶
V instalačním adresáři digna spusťte:
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:
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í.
digna se nespustí na zastaralém repozitáři
Od Release 2026.11 server odmítne start, dokud repozitář potřebuje upgrade, a oznámí to, například:
Spusťte repo upgrade dříve, než spustíte server nebo službu.
Krok 9: Restartujte služby¶
Pokud digna běží jako služba Windows, znovu ji spusťte:
Pokud jste upgradovali z verze starší než 2026.06 a v kroku 1 jste službu odregistrovali, nejprve ji znovu zaregistrujte pomocí spustitelného souboru digna:
Pro --address a --port zadejte hodnoty, na kterých poskytovala služby stará služba, pokud nechcete výchozí hodnoty 127.0.0.1 a 8000. 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 digna spouštíte ručně, restartujte server:
Pokud používáte IIS nebo Tomcat, restartujte příslušný webový server.
Krok 10: Ověřte upgrade¶
-
Ověřte vydání nového spustitelného souboru:
První řádek musí znít
Release: 2026.11. -
Otevřete dashboard digna a ověřte, že se rozhraní načítá správně.
- Zkontrolujte soubory v adresáři
logsinstalace, zda neobsahují chyby. - 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.