Průvodce instalací na macOS 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í 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 na pozadí
10. Upgrade na novou verzi

Úvod¶

O digna¶

digna je komplexní platforma poháněná AI navržená k optimalizaci řízení kvality dat v různých datových prostředích jako datové sklady, datová jezera a lakehouse. Je navržena pro vysokou škálovatelnost a přizpůsobivost a řeší moderní problémy s daty pomocí automatizace, monitorování 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, poskytující uživatelsky přívětivé prostředí pro práci s platformou digna a vizualizaci metrik kvality dat.

Co je nového ve verzi 2026.06¶

Tato verze přináší schopnosti datové observability 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 Windows nebo Linux?¶

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

Systémové požadavky¶

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

Možnosti instalace databáze¶

Pokud je PostgreSQL již nainstalovaný: Můžete do existujícího PostgreSQL serveru přidat novou databázi pro digna.

Pokud instalujete PostgreSQL na stejný stroj jako digna:

Kontrola architektury¶

Několik cest v tomto návodu se liší mezi Apple Silicon a Intel Macy. Pro zjištění spusťte v Terminálu:

uname -m

• arm64 — Apple Silicon. Homebrew instaluje do /opt/homebrew.
• x86_64 — Intel. Homebrew instaluje do /usr/local.

Předinstalační nastavení¶

Před instalací digna se ujistěte, že jsou splněny tři klíčové předpoklady:

1. Homebrew – správce balíčků používaný k instalaci komponent níže
2. PostgreSQL Server – pro ukládání vypočítaných metrik a výkonových dat
3. 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.

Instalace Homebrew¶

Homebrew je standardní správce balíčků pro macOS a je používán v celém tomto průvodci k instalaci PostgreSQL a nginx.

Krok 1: Zkontrolujte, zda je Homebrew již nainstalovaný¶

Otevřete Terminál (stiskněte Cmd + Space, napište Terminal, stiskněte Enter) a spusťte:

brew --version

Pokud se objeví číslo verze, přeskočte na sekci Nastavení PostgreSQL serveru.

Krok 2: Nainstalujte Homebrew¶

Pokud příkaz nebyl nalezen, nainstalujte Homebrew podle pokynů na oficiálních stránkách Homebrew. Instalátor také nainstaluje Xcode Command Line Tools, pokud již nejsou přítomny.

Krok 3: Přidejte Homebrew do PATH¶

Na Apple Silicon vypíše instalátor dva příkazy pro přidání Homebrew do vašeho shellového prostředí. Spusťte je podle pokynů a pak ověřte:

brew --prefix

To by mělo vypsat /opt/homebrew na Apple Silicon nebo /usr/local na Intel.

Nastavení PostgreSQL serveru¶

Pokud již máte PostgreSQL¶

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

Možnosti instalace¶

macOS nabízí dvě jednoduché možnosti instalace PostgreSQL. Vyberte jednu:

• Homebrew — instalace z příkazové řádky, doporučeno pro servery
• Postgres.app — grafická instalace, pohodlné pro lokální vyhodnocení

Instalace PostgreSQL přes Homebrew¶

Krok 1: Nainstalujte verzi PostgreSQL¶

brew install postgresql@16

Krok 2: Přidejte PostgreSQL do PATH¶

Verzované formule PostgreSQL jsou keg-only, což znamená, že Homebrew automaticky nelinkuje jejich příkazy do PATH. Přidejte je sami:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Krok 3: Spusťte službu PostgreSQL¶

brew services start postgresql@16

Tím se PostgreSQL spustí ihned a zároveň se nastaví, aby se spouštěl automaticky při přihlášení.

Krok 4: Ověřte instalaci¶

psql --version

Měli byste vidět verzi PostgreSQL, pokud byla instalace úspěšná.

Krok 5: Připojte se k serveru¶

psql postgres

Krok 6: Potvrďte port¶

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

psql postgres -c "SHOW port;"

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

Instalace PostgreSQL pomocí Postgres.app¶

Pokud preferujete grafickou instalaci:

1. Stáhněte Postgres.app a přetáhněte jej do složky Applications
2. Otevřete aplikaci a klikněte na Initialize pro vytvoření nového serveru
3. Postupujte podle pokynů aplikace pro přidání jejích příkazových nástrojů do PATH
4. Ověřte instalaci:

psql --version

Postgres.app také vytvoří superuživatele pojmenovaného podle vašeho macOS účtu.

Konfigurace webového serveru¶

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

• nginx — instalovaný přes Homebrew, doporučeno
• Apache httpd — součást macOS

Stačí nainstalovat a konfigurovat jeden z těchto serverů.

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

• Fallback pro single-page aplikaci, aby obnovení URL dashboardu v prohlížeči nevracelo 404
• MIME typ pro .md, aby byly Markdown soubory servírovány správně

Nastavení nginx¶

Přehled¶

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

Instalace¶

brew install nginx

Spuštění nginx¶

brew services start nginx

Ověření instalace¶

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

Konfigurace webu pro dashboard¶

Konfigurace Homebrew nginx zahrnuje všechny soubory ve složce servers. Vytvořte věnovaný konfigurační soubor pro digna tam:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Vložte následující, nahraďte /path/to/digna/dashboard skutečnou cestou k rozbalené složce dashboard:

server {
    listen       8080;
    server_name  localhost;

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

Aplikujte konfiguraci¶

Otestujte syntaxi konfigurace, pak reloadujte nginx:

nginx -t
brew services restart nginx

Nastavení Apache httpd¶

Přehled¶

macOS obsahuje Apache httpd, takže instalace není nutná. Ve výchozím stavu je vypnutý.

Spuštění Apache¶

sudo apachectl start

Ověření instalace¶

1. Otevřete prohlížeč
2. Přejděte na http://localhost
3. Měli byste vidět hlášku "It works!"

Povinné: povolit mod_rewrite¶

Dashboard vyžaduje přepisování URL. Otevřete Apache konfiguraci:

sudo nano /etc/apache2/httpd.conf

Najděte následující řádek a odstraňte počáteční #, aby byl odkomentován:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Povinné: povolit .htaccess Overrides¶

Ve stejném souboru najděte blok <Directory "/Library/WebServer/Documents"> a změňte:

AllowOverride None

na:

AllowOverride All

Povinné: MIME typ pro Markdown soubory¶

Stále v httpd.conf přidejte následující řádek, aby byly Markdown soubory servírovány správně:

AddType text/markdown .md

Aplikujte konfiguraci¶

Zkontrolujte konfiguraci na syntaktické chyby a restartujte Apache:

sudo apachectl configtest
sudo apachectl restart

Počáteční instalace¶

Krok 1: Nastavte repozitář digna¶

Repozitář digna uchovává všechny metriky vypočtené digna. Slouží 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 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> — Vámi zvolené jméno schématu (např. dignarepo)
• <digna_repo_user> — Vámi zvolené 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í z Terminálu v jednom kroku:

psql postgres

Poté vložte příkazy na promptu postgres=# a zadejte \q pro ukončení.

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

1. Najděte ZIP soubor instalačního balíku digna, který jste obdrželi
2. Rozbalte jej do vámi zvoleného instalačního umístění — například /opt/digna nebo ~/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 v jednom)

Pro rozbalení z Terminálu:

unzip digna-2026.06-macos.zip -d /opt/digna

Nastavte spustitelné oprávnění¶

V závislosti na způsobu přenosu může spustitelný bit po rozbalení chybět. Nastavte jej explicitně:

cd /opt/digna
chmod +x digna

Pokud macOS blokuje aplikaci¶

Soubory stažené přes prohlížeč nebo e-mailový klient jsou označeny karanténním atributem. Pokud macOS ohlásí, že aplikaci "nelze otevřít, protože vývojáře nelze ověřit", odstraňte atribut z instalační složky:

xattr -dr com.apple.quarantine /opt/digna

Alternativně otevřete System Settings → Privacy & Security, najděte zablokovanou položku u spodní části stránky a klikněte Open Anyway.

Krok 3: Nainstalujte licenční soubor¶

1. Najděte soubor license.toml, který jste obdrželi
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ákoli úprava jej zneplatní.

Struktura adresářů po nastavení:

/opt/digna/
├── config.toml         (konfigurační soubor)
├── license.toml        (VÁŠ LICENČNÍ SOUBOR - 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 dodán ve vaší instalační složce digna. Stačí jej přejmenovat na config.toml.

cd /opt/digna
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í 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 = ["*"]

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

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ího adresáře digna (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 je připojení navázáno (samo repozitář ještě nebyl inicializován).

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

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í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 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 zprávy o spuštění potvrzující běh serveru:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

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 svůj webový server a postupujte podle odpovídajících kroků.

Nasazení na nginx¶

Pokud jste postupovali podle sekce nginx Setup, server block již směřuje na vaši složku dashboard a žádné kopírování není potřeba.

1. Potvrďte cestu
2. Otevřete $(brew --prefix)/etc/nginx/servers/digna.conf

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

4. Ujistěte se, že složka je čitelná

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

5. Reload nginx

   nginx -t
   brew services restart nginx
   

6. Ověřte instalaci

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

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Přidejte Rewrite pravidla

Vytvořte soubor .htaccess ve deployed složce, aby se při obnovení v prohlížeči nezobrazovala 404:

sudo nano /Library/WebServer/Documents/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 apachectl restart
   

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

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

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

Spuštění backendu digna jako služby na pozadí zajistí, že:

• Se automaticky spustí při startu stroje
• Běží na pozadí bez otevřeného okna Terminálu
• Automaticky se restartuje při pádu
• Lze jej spravovat přes launchctl, správce služeb macOS

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

• install_service.sh — zaregistruje digna v launchd
• 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 rozbalení se spustitelný bit nemusí zachovat. Před prvním použitím:

cd /opt/digna/bin
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 v launchd s povoleným automatickým spuštěním. Služba se tímto nezapne okamžitě — viz další sekci pro její spuštění.

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

Chcete-li službu spustit¶

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

   sudo ./start_service.sh
   

Chcete-li službu zastavit¶

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

   sudo ./stop_service.sh
   

Ověření služby¶

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

sudo launchctl list | grep digna

Řádek začínající PIDem značí, že služba běží. - v prvním sloupci znamená, že je zaregistrovaná, ale zastavená.

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

launchd ukládá absolutní cestu ke spustitelnému souboru, takže při přesunu instalace je nutné službu znovu zaregistrovat:

1. Odinstalujte aktuální 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
   

Odinstalování 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 launchd.

Upgrade na novou verzi¶

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

Vytvoření zálohy repozitáře digna je POVINNÉ

Před upgradem digna zálohujte svůj repozitář (PostgreSQL), abyste se chránili proti ztrátě dat. Záloha vám umožní obnovit data v případě nečekaných problémů během upgradu.

Pro vytvoření zálohy z Terminálu:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Postup upgradu¶

Krok 1: Zastavte službu digna¶

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

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

Pokud běží v popředí, stiskněte v jeho Terminálu 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
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Krok 3: Rozbalte a nasazení nové verze¶

1. Rozbalte nový instalační ZIP soubor digna
2. Zkopírujte nový digna spustitelný soubor a složku dashboard do instalačního adresáře
3. Obnovte spustitelný bit a v případě potřeby odstraňte karanténní atribut:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Krok 4: Obnovte konfigurační soubory¶

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 (Cmd+Shift+R).

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

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

./digna license check

Krok 8: Upgradujte schéma repozitáře¶

Přejděte do instalačního adresáře 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 služba na pozadí:

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

Pokud běžíte ručně, restartujte server:

cd /opt/digna
./digna serve --address <address> --port <port>

Pokud používáte nginx nebo Apache, restartujte příslušný webový server:

brew services restart nginx

sudo apachectl restart

Krok 10: Ověřte upgrade¶

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