Průvodce instalací na Linuxu 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í příprava
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 systemd služby
10. Aktualizace 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 postavena tak, aby byla vysoce škálovatelná a přizpůsobitelná, a řeší moderní datové výzvy prostřednictvím automatizace, monitoringu v reálném čase a detekce anomálií.

digna se skládá ze dvou hlavních částí:

• 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é rozhraní pro práci s platformou digna a vizualizaci 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 Windows nebo macOS?¶

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

Pro které distribuce je tento průvodce určen?¶

Instrukce jsou psány pro dva nejběžnější rodiny serverových distribucí. Kde se liší, jsou uvedeny oba příkazy:

• Rodina Debian — Debian, Ubuntu. Správce balíčků: apt.
• Rodina RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Správce balíčků: dnf.

Jakákoli moderní distribuce s systemd bude fungovat; mění se pouze názvy balíčků a několik konfiguračních cest.

Systémové požadavky¶

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

Možnosti instalace databáze¶

Pokud je PostgreSQL již nainstalováno: Do stávajícího PostgreSQL serveru můžete přidat novou databázi pro digna.

Pokud instalujete PostgreSQL na stejném stroji jako digna:

Kontrola distribuce a architektury¶

Některé příkazy v tomto průvodci se liší mezi rodinami Debian a RHEL. Pro kontrolu spusťte:

cat /etc/os-release
uname -m

• ID=ubuntu nebo ID=debian — použijte příkazy apt.
• ID=rhel, rocky, almalinux nebo fedora — použijte příkazy dnf.
• x86_64 nebo aarch64 — architektura instalačního balíčku, který potřebujete.

Předinstalační příprava¶

Před instalací digna se ujistěte, že jsou splněny 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 ještě nejsou nastaveny, postupujte podle níže uvedených sekcí pro jejich instalaci a konfiguraci.

Aktualizace indexu balíčků¶

Aktualizujte seznamy balíčků před instalací:

sudo apt update

sudo dnf check-update

Nastavení PostgreSQL serveru¶

Pokud PostgreSQL již máte¶

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

Instalace PostgreSQL¶

Krok 1: Nainstalujte balíček serveru¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Krok 2: Inicializujte databázový cluster¶

U rodiny Debian balíček vytvoří a spustí cluster automaticky — pokračujte dalším krokem.

U rodiny RHEL je třeba cluster vytvořit explicitně:

sudo postgresql-setup --initdb

Krok 3: Spusťte a povolte službu¶

sudo systemctl enable --now postgresql

Tím spustíte PostgreSQL okamžitě a nakonfigurujete automatické spuštění při startu systému.

Krok 4: Ověřte instalaci¶

psql --version
sudo systemctl status postgresql

Měli byste vidět verzi PostgreSQL a službu s označením active (running).

Krok 5: Připojte se na server¶

Balíček PostgreSQL na Linuxu vytvoří systémový účet postgres, který vlastní cluster. Připojte se přes něj:

sudo -u postgres psql

Krok 6: Potvrďte port¶

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

sudo -u postgres psql -c "SHOW port;"

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

Krok 7: Povolení autentizace heslem pro uživatele digna¶

digna se k PostgreSQL připojuje přes TCP jako digna_user, což vyžaduje autentizaci heslem místo peer autentizace. Zkontrolujte, že váš pg_hba.conf to umožňuje.

Najděte soubor:

sudo -u postgres psql -c "SHOW hba_file;"

Otevřete ho v editoru a potvrďte, že řádky pro lokální TCP používají scram-sha-256 (nebo md5 na starších serverech) místo ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Po jakékoliv změně PostgreSQL znovu načtěte:

sudo systemctl reload postgresql

Krok 8: Pokud PostgreSQL běží na jiném stroji¶

Aby server akceptoval připojení z jiného hostitele, nastavte listen_addresses v postgresql.conf a přidejte odpovídající host řádek pro vaši síť v pg_hba.conf:

listen_addresses = '*'

Pak otevřete port ve firewallu a restartujte službu:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Konfigurace webového serveru¶

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

• nginx — lehký a doporučený
• Apache httpd — široce rozšířená alternativa

Instalovat a konfigurovat potřebujete jen jeden z těchto serverů.

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

• Fallback pro single-page aplikaci, aby obnovení stránky dashboardu nevracelo 404
• MIME typ .md, aby se Markdown soubory správně servírovaly

Nastavení nginx¶

Přehled¶

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

Instalace¶

sudo apt install -y nginx

sudo dnf install -y nginx

Spuštění nginx¶

sudo systemctl enable --now nginx

Ověření instalace¶

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

Otevření firewallu¶

Pokud bude server přístupný z jiných strojů, povolte HTTP provoz:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Konfigurace webu pro dashboard¶

nginx načítá všechny soubory v adresáři conf.d u obou rodin distribucí. Vytvořte tam dedikovaný konfigurační soubor pro digna:

sudo nano /etc/nginx/conf.d/digna.conf

Vložte následující a nahraďte /opt/digna/dashboard reálnou cestou k rozbalené složce dashboard:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/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;
    }
}

Deaktivace výchozího webu¶

Pouze jeden serverový blok může být default_server pro port. U rodiny Debian odstraňte balíčkovaný výchozí site, aby nedošlo ke konfliktu:

sudo rm /etc/nginx/sites-enabled/default

U rodiny RHEL zakomentujte nebo smažte blok server { ... } uvnitř /etc/nginx/nginx.conf.

Aplikujte konfiguraci¶

Ověřte konfiguraci na syntaktické chyby a pak nginx znovu načtěte:

sudo nginx -t
sudo systemctl reload nginx

Nastavení Apache httpd¶

Přehled¶

Apache httpd je k dispozici v základních repozitářích všech podporovaných distribucí. Balíček se jmenuje apache2 u rodiny Debian a httpd u rodiny RHEL.

Instalace¶

sudo apt install -y apache2

sudo dnf install -y httpd

Spuštění Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Ověření instalace¶

1. Otevřete prohlížeč
2. Přejděte na http://localhost
3. Měli byste vidět výchozí stránku Apache distribuce

Požadováno: povolit mod_rewrite¶

Dashboard vyžaduje přepis URL.

U rodiny Debian modul povolte a restartujte:

sudo a2enmod rewrite
sudo systemctl restart apache2

U rodiny RHEL je mod_rewrite načteno ve výchozím nastavení. Potvrďte to:

httpd -M | grep rewrite

Požadováno: povolení .htaccess přepisů¶

Otevřete konfigurační soubor pro váš dokumentový kořen:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Najděte <Directory> blok pokrývající váš dokumentový kořen (/var/www/html u obou rodin) a změňte:

AllowOverride None

na:

AllowOverride All

Požadováno: MIME typ pro Markdown soubory¶

Do stejného souboru přidejte následující řádek, aby se Markdown soubory správně servírovaly:

AddType text/markdown .md

Aplikujte konfiguraci¶

Zkontrolujte konfiguraci na syntaktické chyby a pak Apache restartujte:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Počáteční instalace¶

Krok 1: Nastavte repozitář digna¶

Repozitář digna ukládá všechny metriky vypočítané dignou. Působí 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 proveď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> — požadovaný název schématu (např. dignarepo)
• <digna_repo_user> — požadované 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í těchto příkazů z shellu v jednom kroku:

sudo -u postgres psql

Pak vložte příkazy na výzvu postgres=# a pro ukončení napište \q.

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

1. Najděte ZIP soubor s instalací digna, který vám byl poskytnut
2. Rozbalte ho do požadované instalační složky — například /opt/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 dohromady)

Pro rozbalení ze shellu:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Umožněte spuštění souboru¶

V závislosti na způsobu přenosu archivu se mohla ztratit příznak spustitelnosti. Nastavte ho explicitně:

cd /opt/digna
sudo chmod +x digna

Vytvořte servisní účet¶

Pro provoz backendu je doporučeno použít dedikovaného neprivilegovaného uživatele pro produkční nasazení:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Krok 3: Nainstalujte licenční soubor¶

1. Najděte license.toml soubor, který vám byl poskytnut
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ákoliv úprava jej zneplatní.

Struktura adresářů po nastavení:

/opt/digna/
├── config.toml         (konfigurační soubor)
├── license.toml        (VAŠE LICENCE - 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 součástí vaší instalační složky digna. Stačí jej přejmenovat na config.toml.

cd /opt/digna
sudo 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

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

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"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /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í složky digna (tam, 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.

sudo ln -s /opt/digna/digna /usr/local/bin/digna

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í složky 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

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

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 webový server a postupujte podle příslušných kroků nasazení.

Nasazení na nginx¶

Pokud jste postupovali podle sekce nginx Setup, serverový blok již ukazuje na složku dashboard a není třeba nic kopírovat.

1. Potvrďte cestu
2. Otevřete /etc/nginx/conf.d/digna.conf

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

4. Zajistěte, aby složka byla čitelná

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

5. Načtěte znovu nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Ověřte instalaci

7. Otevřete prohlížeč
8. Přejděte na http://localhost (nebo 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 dokumentového kořene

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Přidejte pravidla pro přepis

Vytvořte soubor .htaccess v nasazené složce, aby trasy dashboardu přežily obnovení stránky prohlížečem:

sudo nano /var/www/html/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 systemctl restart apache2
   

   sudo systemctl restart httpd
   

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

Krok 2: SELinux (pouze rodina RHEL)¶

Na RHEL, Rocky, AlmaLinux a Fedora je SELinux ve výchozím nastavení v režimu enforcing a zablokuje webový server v čtení souborů mimo očekávané lokace. Zkontrolujte, zda je aktivní:

getenforce

Pokud je výsledek Enforcing a servírujete dashboard z /opt/digna/dashboard, označte adresář tak, aby webový server k němu mohl číst:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

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

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

Provoz digna backendu jako systemd služby zajistí, že:

• se automaticky spustí při startu stroje
• poběží na pozadí bez otevřeného terminálu
• se automaticky restartuje v případě pádu
• je možné jej spravovat přes systemctl, standardní správce služeb na Linuxu

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 dostupné:

• install_service.sh — zaregistruje digna u systemd
• 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 extrakci se mohl ztratit příznak spustitelnosti. Před prvním použitím:

cd /opt/digna/bin
sudo 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 u systemd s povoleným automatickým spuštěním. Služba se sama nespustí okamžitě — viz další sekce pro její spuštění.

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

Pro spuštění služby¶

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

   sudo ./start_service.sh
   

Pro zastavení služby¶

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

   sudo ./stop_service.sh
   

Správa služby pomocí systemctl¶

Po registraci lze službu také ovládat standardními příkazy systemd z libovolného adresáře:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Ověření služby¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled znamená, že se služba spouští při startu; active znamená, že právě běží.

Zobrazení logů služby¶

systemd zachycuje všechno, co backend vypisuje na konzoli. Pro čtení:

sudo journalctl -u digna -n 100

Pro sledování logu živě během reprodukce problému:

sudo journalctl -u digna -f

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

Jednotkový soubor ukládá absolutní cestu ke spustitelnému souboru, takže přesunutí instalace vyžaduje opětovnou registraci služby:

1. Odinstalujte stávající 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
   

Odinstalace 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 systemd.

Aktualizace 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 aktualizací¶

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 ze shellu:

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

Krok 1: Zastavte službu digna¶

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

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

Pokud digna běží v popředí, stiskněte v jejím terminálovém okně 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
sudo mv digna digna_old
sudo 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 vlastníka servisního účtu:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Krok 4: Obnovte konfigurační soubory¶

sudo 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 (Ctrl+F5).

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

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

./digna license check

Krok 8: Aktualizujte 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 systemd služba:

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, znovu načtěte příslušný webový server:

sudo systemctl reload nginx

sudo systemctl restart apache2

U rodiny RHEL znovu aplikujte SELinux označení, pokud byla složka dashboard nahrazena:

sudo restorecon -Rv /opt/digna/dashboard

Krok 10: Ověřte aktualizaci¶

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 logy serveru, zda neobsahují chyby:

   sudo journalctl -u digna -n 100
   

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.