Průvodce instalací na Linuxu pro digna Release 2026.06¶

Release: 2026.06

Poslední aktualizace: 5. září 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.06¶

Toto vydání přináší schopnosti datové observability přímo do vašeho kódu, což umožňuje vývojářům monitorovat kvalitu dat u zdroje. Kompletní podrobnosti naleznete v poznámkách k vydání.

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.06-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 nastavení aplikace digna backend:

[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 = ["*"]

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!"

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

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"

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_BACKUP_COUNT = 10

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

Měli byste vidět potvrzení, že připojení bylo navázáno (samo repozitář ještě nebyl inicializován).

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 install

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

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 - --port — port serveru

Měli byste vidět spouštěcí 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

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

Před aktualizací¶

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í.

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

Před aktualizací 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 aktualizace 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

Postup aktualizace¶

Krok 1: Zastavte službu digna¶

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

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

Pokud běží v popředí, stiskněte v jeho terminálovém okně Ctrl + C.

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:

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo mv dashboard dashboard_old

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

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[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'

[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'

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 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: Nahraďte licenční soubor¶

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

Přejděte do instalační složky digna a spusťte:

cd /opt/digna
./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: Restartujte služby¶

Pokud běží jako systemd služba:

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

Pokud běžíte ručně, znovu spusťte 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. Přistupte k digna dashboardu
2. Ověřte, že se rozhraní načítá správně
3. Zkontrolujte logy serveru pro případné 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í

sudo journalctl -u digna -n 100