Přeskočit obsah

Průvodce instalací pro Windows pro digna Release 2026.06

Verze: 2026.06

Poslední aktualizace: 30. srpna 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 Windows
  10. 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 dignabackend a dignacli z 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:

  1. PostgreSQL Server – pro ukládání vypočtených metrik a výkonových dat
  2. 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

  1. Navštivte PostgreSQL Downloads page
  2. Vyberte Windows
  3. Stáhněte si nejnovější instalační program

Krok 2: Spuštění instalátoru

  1. Dvakrát klikněte na stažený instalační soubor
  2. 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:

psql --version

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

  1. Otevřete Ovládací panely
  2. Stiskněte Win + R
  3. Napište control a stiskněte Enter

  4. Přejděte na Windows Features

  5. Klikněte na Programs
  6. Vyberte Turn Windows features on or off

  7. Povolte Internet Information Services

  8. Sjeďte dolů a najděte Internet Information Services (IIS)
  9. Zaškrtněte políčko pro jeho povolení
  10. Klikněte na + pro rozbalení a ověřte, že jsou vybrány tyto podkomponenty:

    • Web Management Tools
    • World Wide Web Services
  11. Klikněte OK pro použití změn

  12. Ověřte instalaci IIS

  13. Otevřete prohlížeč
  14. Přejděte na http://localhost
  15. 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:

  1. Otevřete IIS Manager (stiskněte Win + R, napište inetmgr, stiskněte Enter)
  2. Přejděte na Your Site > MIME Types
  3. Klikněte Add...
  4. Nakonfigurujte:
  5. File name extension: .md
  6. 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

  1. Stáhněte Apache Tomcat
  2. Navštivte Apache Tomcat Downloads
  3. Stáhněte Windows ZIP distribuci

  4. Rozbalte archiv

  5. Rozbalte ZIP soubor do adresáře ve vašem systému
  6. Příklad: C:\Program Files\Apache Tomcat

  7. Ověřte, že Tomcat běží

  8. Otevřete prohlížeč
  9. Přejděte na http://localhost:8080
  10. 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

  1. Najděte ZIP soubor s instalací digna, který vám byl poskytnut
  2. Rozbalte ho do požadovaného instalačního umístění
  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 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.

  1. Najděte soubor license.toml, který vám byl poskytnut
  2. Zkopírujte ho 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 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í.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
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í:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
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:

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

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

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

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:

digna repo install

Tento příkaz nainstaluje potřebné tabulky a schéma ve vaší PostgreSQL databázi.

Krok 5: Vytvoření administrátorského uživatele

  1. Otevřete nové okno Příkazového řádku
  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 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í:

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

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

  1. Otevřete IIS Manager
  2. Stiskněte Win + R, napište inetmgr, stiskněte Enter

  3. Vytvořte nový web

  4. V levém panelu klikněte pravým tlačítkem na Sites
  5. Vyberte Add Website...

  6. Konfigurujte web

  7. Site Name: Zadejte název (např. "dignaDashboard")
  8. Physical Path: Klikněte na Browse a vyberte složku dashboard
  9. Binding: Nastavte IP adresu a port (výchozí port 80 pro HTTP, 443 pro HTTPS)

  10. Spusťte web

  11. Klikněte OK pro vytvoření webu
  12. Klikněte pravým tlačítkem na nový web a vyberte Start

  13. Otestujte instalaci

  14. Otevřete prohlížeč
  15. Přejděte na http://localhost (nebo na vámi nakonfigurovanou URL)
  16. Měli byste vidět přihlašovací stránku dashboardu digna

Nasazení do Apache Tomcat

  1. Zkopírujte dashboard do Tomcatu
  2. Zkopírujte složku dashboard do adresáře webapps ve vašem Tomcatu
  3. Přejmenujte ji podle potřeby (např. na digna)
  4. Příklad: C:\Program Files\Apache Tomcat\webapps\digna

  5. Ověřte nasazení

  6. Obnovte nebo znovu načtěte stránku správy Tomcatu (http://localhost:8080)
  7. Měli byste vidět "digna" (nebo zvolené jméno) v seznamu nasazených aplikací

  8. Přístup k dashboardu

  9. Otevřete prohlížeč
  10. Přejděte na http://localhost:8080/digna
  11. 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

  1. Otevřete Příkazový řádek jako administrátor
  2. Klikněte pravým tlačítkem na Příkazový řádek
  3. Vyberte "Spustit jako správce"

  4. Přejděte do instalačního adresáře digna

    cd C:\path\to\digna
    

  5. Zaregistrujte službu

    digna windows install
    

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:

digna windows install --address 0.0.0.0 --port 8082

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

digna windows start

Pro zastavení služby

digna windows stop

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:

  1. Zastavte a odregistrujte současnou službu

    cd C:\old\path\digna
    digna windows stop
    digna windows uninstall
    

  2. Přesuňte soubory aplikace

  3. Přesuňte celý instalační adresář digna na nové místo

  4. Zaregistrujte službu znovu z nového umístění

    cd C:\new\path\digna
    digna windows install
    

Zopakujte všechny hodnoty --address, --port nebo --account, které jste použili poprvé — předchozí registrace již neexistuje.

  1. Spusťte službu
    digna windows start
    

Odinštalování služby

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

    cd C:\path\to\digna
    digna windows stop
    

  2. Odregistrujte službu

    digna windows uninstall
    

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:

  1. 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.
  2. 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.
  3. 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:

cd C:\path\to\digna\bin
stop_service.bat

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:

uninstall_service.bat

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:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old
# Rename the folder containing dignacli
ren dignacli dignacli_old
# Rename dashboard
ren dashboard dashboard_old

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

  1. Rozbalte nový ZIP soubor s instalací digna
  2. Zkopírujte nový spustitelný soubor digna a složku dashboard do 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ů

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

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ý:

digna config check

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ý:

copy /Y C:\path\to\new\license.toml license.toml

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:

digna license check

Krok 8: Upgrade schématu repozitáře

Přejděte do instalačního adresáře digna a spusťte:

digna repo upgrade

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á:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

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:

cd C:\path\to\digna
digna serve --address <address> --port <port>

Pokud používáte IIS nebo Tomcat, restartujte příslušný webový server.

Krok 10: Ověření upgradu

  1. Přistupte k dashboardu digna
  2. Ověřte, že se rozhraní načítá správně
  3. Zkontrolujte logy serveru, zda se nezobrazují chyby
  4. 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í