digna Release 2026.11 Windows telepítési útmutató¶
Kiadás: 2026.11
Utoljára frissítve: 2026. november 7.
Tartalomjegyzék¶
- Bevezetés
- Rendszerkövetelmények
- Előkészítő lépések
- PostgreSQL szerver beállítása
- Webkiszolgáló konfiguráció
- Kezdeti telepítés
- Backend konfiguráció
- Dashboard konfiguráció
- digna futtatása Windows szolgáltatásként
- Frissítés új kiadásra
Bevezetés¶
A dignáról¶
digna egy átfogó, mesterséges intelligencia által vezérelt platform, amely a különböző adatkörnyezeteiben (adatraktárak, adat-tavak és lakehouse-ok) optimalizálja az adatok minőségkezelését. Nagy skálázhatóságra és alkalmazkodóképességre tervezve, digna automatizálással, valós idejű monitorozással és anomália-észleléssel kezeli a modern adathasználat kihívásait.
A digna két fő komponensből áll:
- digna: az alkalmazás magja, amely az adatok feldolgozásáért és a minőségi ellenőrzések végrehajtásáért felel. Egyetlen futtatható fájlban egyesíti a háttérrendszert és a parancssori felületet, felváltva a korábbi kiadások különálló
dignabackendésdignacliprogramjait. - dignadashboard: webalapú felület, amely webkiszolgálón fut és felhasználóbarát módon biztosít hozzáférést a digna platformhoz és az adatok minőségi metrikáinak megjelenítéséhez.
Mi újság a 2026.11-os kiadásban¶
Ez a kiadás bevezeti a digna Data Reconciliation-t, a digna Agentic-et a digna MCP Serverrel, valamint a digna Engine-t, amely a dignán belül képes adatokat profilozni, és különböző adatbázis-technológiák között is ellenőrzi a referenciális integritást. A részletekért lásd a kiadási megjegyzéseket.
A telepítés szempontjából a kiadás új migrációs mechanizmust hoz a tárolóséma kezelésére, egy opcionális [duckdb] szekciót a config.toml fájlban a digna Engine számára, valamint új licencfájlt. Mindegyikkel a frissítésről szóló szakasz foglalkozik.
macOS vagy Linux telepítést keresel?¶
Ez az útmutató Windowsra vonatkozik. Más platformokhoz lásd a macOS telepítési útmutatót vagy a Linux telepítési útmutatót.
Rendszerkövetelmények¶
Mielőtt elkezdenéd a telepítést, győződj meg róla, hogy a rendszered megfelel az alábbi minimális követelményeknek:
| Követelmény | Specifikáció |
|---|---|
| Operációs rendszer | Windows Server vagy Windows 10/11 |
| Memória (minimális telepítés) | 16 GB RAM |
| Lemezterület | 10 GB szabad tárhely |
| Adatbázis | PostgreSQL Server 12 vagy újabb |
| Webkiszolgáló | IIS, Apache Tomcat vagy egyenértékű |
digna Engine
Azokat az adatbázis-kapcsolatokat, amelyek profilozási helyként a digna Engine-t használják, magán a digna gazdagépen profilozza a rendszer. Ezekhez további memóriát és lemezterületet kell tervezni, lásd: [duckdb] szekció.
Adatbázis telepítési opciók¶
Ha a PostgreSQL már telepítve van: Új adatbázist hozhatsz létre a digna számára a meglévő PostgreSQL szerveren.
Ha ugyanarra a gépre telepíted a PostgreSQL-t, mint a digna:
Ajánlott specifikációk
- Memória: 32 GB RAM (a 16 GB helyett)
- Lemezterület: 50 GB szabad tárhely (a 10 GB helyett)
Ezek a magasabb erőforrások azt szolgálják, hogy a digna és a PostgreSQL adatbázis egyszerre fusson optimálisan.
Előkészítő lépések¶
A digna telepítése előtt győződj meg róla, hogy két kulcsfontosságú előfeltétel rendelkezésre áll:
- PostgreSQL szerver – a számított metrikák és teljesítményadatok tárolásához
- Webkiszolgáló – a digna Dashboard hosztolásához
Ha ezek a komponensek még nincsenek telepítve, kövesd az alábbi szakaszokat az installáláshoz és konfiguráláshoz.
PostgreSQL szerver beállítása¶
Ha már van PostgreSQL-ed¶
Ha a PostgreSQL már telepítve és fut a helyi gépeden, vagy ha menedzselt távoli PostgreSQL szervert használsz, átugorhatod ezt a részt és folytathatod a következő szakaszra.
PostgreSQL telepítése¶
Kövesd az alábbi lépéseket a PostgreSQL Windowsra történő telepítéséhez:
1. lépés: PostgreSQL letöltése¶
- Látogass el a PostgreSQL Downloads page oldalra
- Válaszd a Windows opciót
- Töltsd le a legfrissebb telepítőt
2. lépés: Futtasd a telepítőt¶
- Kattints duplán a letöltött telepítőfájlra
- Kövesd a telepítővarázsló utasításait
3. lépés: Telepítési könyvtár kiválasztása¶
Válaszd ki a PostgreSQL telepítési könyvtárát. Az alapértelmezett hely általában megfelelő.
4. lépés: Komponensek kiválasztása¶
Egy standard telepítéshez hagyd meg az alapértelmezett komponensbeállításokat.
5. lépés: PostgreSQL szuperfelhasználó jelszó megadása¶
Add meg és erősítsd meg a PostgreSQL szuperfelhasználó (postgres) jelszavát. Tárold ezt a jelszót biztonságosan — később szükséged lesz rá.
6. lépés: Portszám konfigurálása¶
Az alapértelmezett PostgreSQL port a 5432. Használhatod az alapértelmezettet, vagy megadhatsz más portot, ha szükséges.
Tipp
Ha a 5432-es port már használatban van, válassz alternatív portot és jegyezd fel a későbbi konfigurációhoz.
7. lépés: Locale kiválasztása¶
Válaszd ki az adatbázis locale-beállítását. Az alapértelmezett általában megfelelő a legtöbb telepítéshez.
8. lépés: Telepítés befejezése¶
Kattints a Next gombra a fennmaradó lépéseknél, majd a Finish gombra.
9. lépés: Telepítés ellenőrzése¶
Nyisd meg a Parancssort és ellenőrizd, hogy a PostgreSQL telepítve van:
A parancs kimenetében meg kell jelennie a PostgreSQL verziónak, ha a telepítés sikeres volt.
Webkiszolgáló konfiguráció¶
A digna dashboard hosztolásához webkiszolgálóra van szükség. Válassz egyet az alábbi lehetőségek közül:
Elegendő, ha egy webkiszolgálót telepítesz és konfigurálsz.
IIS beállítása¶
Áttekintés¶
Az Internet Information Services (IIS) a Microsoft webszervere weboldalak és webalkalmazások hosztolásához.
IIS engedélyezése¶
- Nyisd meg a Vezérlőpultot
- Nyomd meg a
Win + Rbillentyűket -
Írd be:
controlés nyomj Entert -
Nyisd meg a Windows szolgáltatások beállításait
- Kattints a Programok menüpontra
-
Válaszd a Windows-szolgáltatások be- vagy kikapcsolása lehetőséget
-
Engedélyezd az Internet Information Services-t
- Görgess le és keresd meg az Internet Information Services (IIS) elemet
- Jelöld be a jelölőnégyzetet
-
Kattints a + jelre az alkönyvtárak kibontásához, és győződj meg róla, hogy a következő alkomponensek ki vannak választva:
- Web Management Tools
- World Wide Web Services
-
Kattints az OK gombra a változtatások alkalmazásához
-
IIS telepítés ellenőrzése
- Nyisd meg a böngészőt
- Navigálj a
http://localhostcímre - Az IIS kezdőoldalának kell megjelennie
Kötelező: URL Rewrite modul¶
Az IIS-nek szüksége van a URL Rewrite komponensre. Töltsd le és telepítsd a hivatalos Microsoft oldalról.
Kötelező: MIME típus Markdown fájlokhoz¶
Annak érdekében, hogy az IIS helyesen szolgálja ki a Markdown fájlokat (.md):
- Nyisd meg az IIS Manager-t (nyomd meg a
Win + R, írd beinetmgr, majd Enter) - Navigálj a Siteod > MIME Types pontra
- Kattints az Add... gombra
- Állítsd be:
- File name extension:
.md - MIME type:
text/markdown
Fontos
Ennek a beállításnak hiányában a .md fájlok nem biztos, hogy megfelelően lesznek kiszolgálva.
Apache Tomcat beállítása¶
Áttekintés¶
Az Apache Tomcat egy nyílt forráskódú Java servlet konténer és webszerver.
Telepítés¶
- Töltsd le az Apache Tomcat-et
- Látogass el az Apache Tomcat Downloads oldalra
-
Töltsd le a Windows ZIP kiadást
-
Csomag kicsomagolása
- Csomagold ki a ZIP fájlt egy könyvtárba a rendszeren
-
Példa:
C:\Program Files\Apache Tomcat -
Ellenőrizd, hogy a Tomcat fut-e
- Nyisd meg a böngészőt
- Navigálj a
http://localhost:8080címre - Az Apache Tomcat kezdőoldalának kell megjelennie
Tipp
Az Apache Tomcat általában automatikusan elindul a telepítés után. Ha nem indul el, navigálj a bin mappába és futtasd a startup.bat fájlt.
Kezdeti telepítés¶
1. lépés: Hozd létre a digna adattárat (repository)¶
A digna adattára tárolja a digna által számított összes metrikát. Központi adatbázisként szolgál az analitikai és teljesítményadatokhoz.
Séma és felhasználó létrehozása az adattárhoz¶
Nyisd meg a PostgreSQL kliensedet (pgAdmin, psql vagy hasonló) és futtasd az alábbi SQL parancsokat:
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>;
Cseréld ki az alábbi helyőrzőket:
<digna_repo_schema>— a kívánt sémanév (pl.:dignarepo)<digna_repo_user>— a kívánt felhasználónév (pl.:digna_user)<digna_repo_password>— ennek a felhasználónak a biztonságos jelszava
Példa:
CREATE SCHEMA dignarepo;
CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';
GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;
Legjobb gyakorlat
Használj erős, komplex jelszavakat az adatbázis-felhasználókhoz. Kerüld az könnyen kitalálható hitelesítő adatokat.
2. lépés: Csomagold ki a digna telepítési csomagot¶
- Keresd meg a neked átadott digna telepítési ZIP fájlt
- Csomagold ki a kívánt telepítési helyre
- A kicsomagolás után a következő elemeket kell látnod:
dashboard/— webes dashboard felületdigna— fő futtatható állomány (backend + CLI kombinálva)
A konfigurációs és a licencfájl nincs benne a csomagban
Sem a config.toml, sem a dashboard/dashboard_config.toml nem része a telepítésnek — mindkettőt magadnak kell létrehoznod, a Backend konfiguráció és a Dashboard konfiguráció szakaszban leírtak szerint. A license.toml sem része a csomagnak; a digna külön biztosítja, ahogyan a 3. lépés leírja.
3. lépés: Telepítsd a licenc fájlt¶
Fontos
A licenc fájl nem része a telepítési csomagnak, és külön kerül átadásra a dignától.
- Keresd meg a számodra átadott
license.tomlfájlt - Másold be a digna telepítési gyökérkönyvtárába (ahol a
config.tomlés adignafuttatható található)
Miért fontos ez: A licenc fájl tartalmazza a vásárlói információkat, a licenc lejárati dátumát és a digitális aláírást. Ne módosítsd ezt a fájlt — bármilyen változtatás érvényteleníti a licencet.
Könyvtárstruktúra a telepítés után:
digna_installation/
├── config.toml (konfigurációs fájl)
├── license.toml (SAJÁT LICENC FÁJL - ide másold)
├── digna (fő futtatható)
└── dashboard/ (webes felület)
└── (dashboard fájlok)
Backend konfiguráció¶
1. lépés: Hozd létre és szerkeszd a konfigurációs fájlt¶
A config_template.toml fájl megtalálható a digna telepítési könyvtárában. Ezt csak át kell nevezned config.toml-ra.
Elérési út: digna_installation/config.toml
Nyisd meg a config.toml-t egy szövegszerkesztőben és állítsd be az alábbi szekciókat.
[app] szekció¶
Ez a rész a dashboard és a backend közötti, eltérő eredetű erőforrás-megosztást (CORS) állítja be:
[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true
| Paraméter | Érték | Megjegyzés |
|---|---|---|
DIGNA_APP_CORS_ALLOW_ORIGINS | Dashboard URL-ek | Azok az URL-ek, amelyekről a dashboardot kiszolgálják. Bármely más eredetből érkező böngészőkérést a rendszer elutasít |
DIGNA_APP_CORS_ALLOW_CREDENTIALS | true | Kötelező, hogy a böngésző minden kéréssel elküldje a munkamenet-sütit |
Az [app] szekció opcionális
A Release 2026.11-től mindkét kulcs, sőt a teljes [app] szekció is elhagyható. Ez a helyes beállítás, ha egy fordított proxy egyetlen eredet alatt szolgálja ki a dashboardot és a backendet: a böngésző ilyenkor nem küld eltérő eredetű kéréseket, és alapértelmezés szerint egyik sincs engedélyezve.
[repo] szekció¶
Ez a rész a PostgreSQL adatbázishoz való kapcsolódást konfigurálja:
[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
| Paraméter | Érték | Megjegyzés |
|---|---|---|
DIGNA_REPO_HOST | localhost vagy IP | A PostgreSQL szerver hosztneve/IP-je |
DIGNA_REPO_PORT | 5432 (alapértelmezett) | A PostgreSQL portja |
DIGNA_REPO_DB | postgres | Adatbázis neve |
DIGNA_REPO_SCHEMA | dignarepo | A korábban létrehozott séma |
DIGNA_REPO_USER | digna_user | A PostgreSQL-ben létrehozott felhasználó |
DIGNA_REPO_PASSWORD | A jelszavad | A séma létrehozásakor beállított jelszó |
DIGNA_REPO_SSLMODE | prefer (alapértelmezett) | Opcionális. PostgreSQL SSL mód: disable, allow, prefer, require, verify-ca vagy verify-full |
DIGNA_REPO_NUM_CONNS | 16 (alapértelmezett) | Opcionális. A digna által az adattárhoz nyitva tartott kapcsolatok száma |
[base] szekció¶
Ez a rész a biztonsági, cookie- és vizsgálati beállításokat tartalmazza:
[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
| Paraméter | Érték | Megjegyzés |
|---|---|---|
DIGNA_FERNET_KEY | A fent látható érték | A korábbi kiadások által használt titkosítás kulcsa. Szerepelnie kell; a fent látható értéket kell megtartani |
DIGNA_COOKIE_DOMAIN | localhost | Az a gazdagép, amelyen a dashboard elérhető. A "" nem állít be domaint, ami akkor helyes, ha egy proxy egyetlen eredet alatt szolgálja ki a dashboardot és a backendet |
DIGNA_COOKIE_SECURE | false (HTTP) / true (HTTPS) | Értéke mindig true kell legyen, ha a digna HTTPS-en keresztül érhető el |
DIGNA_COOKIE_HTTPONLY | true | A munkamenet-sütit elzárja a szkriptek elől |
DIGNA_TOKEN_EXPIRES_IN | 86400 (24 óra) | Munkamenet lejárata másodpercben |
DIGNA_MAX_WORKERS | CPU magok száma - 1 | Az egyszerre futtatható vizsgálatok száma |
DIGNA_FRONTEND_BASEURL | Dashboard URL | Kötelező. Az értesítő üzenetekben lévő hivatkozásokhoz használatos, ezért olyan URL-nek kell lennie, amelyet a címzettek meg tudnak nyitni |
DIGNA_SOURCE_QUERY_TIMEOUT_SEC | 3600 (alapértelmezett) | Opcionális. Ennyi másodpercig futhat egy forrásadatbázison végrehajtott egyetlen lekérdezés, mielőtt megszakad; a 0 kikapcsolja az időkorlátot |
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC | 30 (alapértelmezett) | Opcionális. Ennyi másodpercig vár a rendszer a forrásadatbázishoz való kapcsolódásra; a 0 korlátlan várakozást jelent |
[encryption] szekció¶
Ez a szekció tartalmazza azt a kulcsot, amellyel a tárolóban őrzött érzékeny értékek titkosítva vannak. Kötelező — a config check FAILED állapotúnak jelenti az [encryption] szekciót, ha a kulcs hiányzik.
| Paraméter | Érték | Megjegyzés |
|---|---|---|
DIGNA_ENCRYPTION_KEY | Base64 kódolású kulcs | Titkosítja a digna tárolóban őrzött érzékeny értékeket |
Védje a config.toml fájlt
Ez a kulcs rögzített érték, amely minden digna telepítésben azonos, és éppen ez fejti vissza a tárolóban lévő érzékeny értékeket. Korlátozza a config.toml hozzáférését arra a fiókra, amely alatt a digna fut, tartsa a fájlt verziókövetésen és megosztott meghajtókon kívül, és hagyja ki minden olyan mentésből, amelyet a tárolónál kevésbé biztonságosan őriznek.
[logging] szekció¶
Ez a rész a naplózás viselkedését állítja be:
| Paraméter | Érték | Megjegyzés |
|---|---|---|
DIGNA_LOGGING_MODE | INFO vagy DEBUG | INFO éles környezethez, DEBUG hibakereséshez. A TRACE, WARN és ERROR érték is elfogadott |
DIGNA_LOGGING_DIR | logs (alapértelmezett) | Opcionális. A rotált naplófájlok könyvtára, a munkakönyvtárhoz viszonyítva |
DIGNA_LOGGING_MAX_FILES | 30 (alapértelmezett) | Opcionális. A megőrzött rotált naplófájlok száma |
Szolgáltatásként futtatva tartsd meg a naplókönyvtárat
A Windows-szolgáltatásnak nincs konzolja, így a naplófájlok jelentik az egyetlen feljegyzést arról, mit csinál a szolgáltatás. Ne állítsd a DIGNA_LOGGING_DIR értékét üres karakterláncra, mert az kikapcsolja a naplófájlokat.
[duckdb] szekció (opcionális)¶
Újdonság a Release 2026.11-ben. Ez a szekció a digna Engine erőforrásait állítja be. A digna Engine a dignán belül profilozza az adatokat azoknál az adatbázis-kapcsolatoknál, amelyek profilozási helye digna Engine, és referenciális integritási ellenőrzéseket futtat a különböző adatbázis-kapcsolatokon lévő adatforrások között. Lásd: Profilozási hely.
A szekció opcionális. Nélküle az alábbi alapértelmezett értékek érvényesek.
[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "C:\\path\\to\\digna\\tmp"
| Paraméter | Érték | Megjegyzés |
|---|---|---|
DIGNA_DUCKDB_MEMORY_LIMIT_MB | 1024 (alapértelmezett) | Egy digna Engine-futás által használható memória MB-ban. Egyszerre legfeljebb DIGNA_MAX_WORKERS futás lehet aktív |
DIGNA_DUCKDB_TEMP_DIRECTORY | Alapértelmezés: a dignát futtató fiók ideiglenes könyvtára (%TEMP%) | Az ideiglenes fájlok könyvtára arra az esetre, ha az adatok nem férnek el a memóriában |
A digna Engine méretezése
A digna gazdagépen a digna saját memóriaigényén felül legfeljebb DIGNA_MAX_WORKERS × DIGNA_DUCKDB_MEMORY_LIMIT_MB memóriával kell számolni, az ideiglenes könyvtárban pedig annyi szabad lemezterülettel, amennyi a digna Engine-t használó adatforrások legnagyobb vizsgált napjának adatait befogadja. A DIGNA_DUCKDB_TEMP_DIRECTORY beállítást egy ekkora szabad hellyel rendelkező lemezre kell irányítani, amelyre a dignát futtató fiók írni tud:
Erre a szekcióra csak akkor van szükség, ha legalább egy adatbázis-kapcsolat a digna Engine-t használja, vagy egy referenciális integritási ellenőrzés különböző kapcsolatokon lévő adatforrásokat hasonlít össze.
2. lépés: Ellenőrizze a konfigurációt¶
A tároló inicializálása előtt ellenőrizze, hogy a config.toml teljes és helyesen felépített. A digna telepítési könyvtárában futtassa:
Minden szekció külön kerül ellenőrzésre, így egyetlen hiba nem takarja el a többi állapotát:
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
Javítson ki mindent, amit FAILED állapotúként jelent, és a folytatás előtt futtassa újra a parancsot. Az Unknown keys alatti WARNING azokat a config.toml-ban lévő kulcsokat sorolja fel, amelyeket a digna nem olvas be; ezeknek nincs hatásuk, ezért el kell távolítani őket, vagy ki kell javítani a nevüket. A beállítások teljes listája a CLI-referenciában található.
3. lépés: Inicializáld az adattárat (repository)¶
- Nyisd meg a Parancssort
- Navigálj a digna telepítési könyvtárába (ahol a
config.tomlés adignafuttatható található) - Futtasd a kapcsolat tesztet:
Új séma esetén a parancs csatlakozik, majd jelzi, hogy még nincs telepített adattár:
Ezen a ponton ez a várt eredmény: megerősíti, hogy a digna eléri a PostgreSQL-t és a sémát. Kapcsolódási vagy hitelesítési hiba esetén viszont a [repo] szekcióban vagy a PostgreSQL beállításában van a hiba.
4. lépés: Telepítsd a séma tábláit az adattárba¶
Ugyanebben a könyvtárban futtasd:
Ez a parancs létrehozza a szükséges táblákat az adattár sémájában, és a következő üzenettel zárul:
A repo upgrade telepít és frissít
A Release 2026.11-től a repo upgrade új adattárat telepít, a meglévőt pedig frissíti. A repo install továbbra is működik, ugyanennek a parancsnak a másik neveként.
5. lépés: Hozz létre egy admin felhasználót¶
- Nyiss meg egy új Parancssor ablakot
- Navigálj a digna telepítési könyvtárába
- Futtasd az alábbi parancsot egy admin felhasználó létrehozásához:
Példa:
Ez létrehoz egy teljes adminisztrátori jogosultságokkal rendelkező felhasználót.
Legjobb gyakorlat
Használj erős jelszót, amely tartalmaz nagy- és kisbetűket, számokat és speciális karaktereket.
6. lépés: Indítsd el a digna szervert¶
A digna telepítési könyvtárában indítsd el a szervert:
Paraméterek: - --address — szerver hosztneve/IP-je (alapértelmezett: 127.0.0.1) - --port — szerver portja (alapértelmezett: 8000)
Amikor a szerver elindult, kiírja a címet, amelyen figyel:
A kiszolgáló lefoglalja a terminált
A serve az előtérben fut, és addig működik, amíg le nem állítja a Ctrl+C billentyűkkel. Hagyja futni, amíg befejezi a beállítást; ha inkább rendszerindításkor indulna automatikusan, lásd: A digna futtatása Windows-szolgáltatásként.
Dashboard konfiguráció¶
1. lépés: Telepítsd a dashboardot a webkiszolgálóra¶
A digna dashboard a saját konfigurációját a dashboard/dashboard_config.toml fájlból olvassa. Ez a fájl nem része a telepítésnek — neked kell létrehoznod a dashboard/ könyvtárban, a dashboard fájljai mellett.
A tartalmát az Egyszeri bejelentkezés (SSO) oldal írja le, és ott is van rá szükség: ez tartalmazza a dashboard által kínált bejelentkezési lehetőségeket, valamint többinstanciás telepítéseknél a backend kapcsolatot.
Válaszd ki a webkiszolgálót, és kövesd az alábbi telepítési lépéseket.
Telepítés IIS-re¶
- Nyisd meg az IIS Manager-t
-
Nyomd meg a
Win + R, írd beinetmgr, majd Enter -
Hozz létre egy új webhelyet
- A bal oldali panelen jobb klikk a Sites-ra
-
Válaszd az Add Website... opciót
-
Konfiguráld a webhelyet
- Site Name: Adj nevet (például "dignaDashboard")
- Physical Path: Kattints a Tallózásra és válaszd ki a
dashboardmappádat -
Binding: Állítsd be az IP címet és portot (alapértelmezett port HTTP-hez 80, HTTPS-hez 443)
-
Indítsd el a weboldalt
- Kattints az OK gombra a webhely létrehozásához
-
Jobb klikk az új webhelyen és válaszd a Start opciót
-
Ellenőrizd a telepítést
- Nyisd meg a böngészőt
- Navigálj a
http://localhost(vagy a konfigurált URL) címre - A digna dashboard bejelentkező oldalának kell megjelennie
Telepítés Apache Tomcat-re¶
- Másold a dashboardot a Tomcat-hez
- Másold a
dashboardmappát a Tomcatwebappskönyvtárába - Szükség szerint nevezd át (pl.:
digna) -
Példa:
C:\Program Files\Apache Tomcat\webapps\digna -
Ellenőrizd a telepítést
- Frissítsd vagy töltsd újra a Tomcat kezelőfelületét (http://localhost:8080)
-
Látnod kell a "digna" (vagy a választott név) elemet a telepített alkalmazások között
-
Elérése
- Nyisd meg a böngészőt
- Navigálj a
http://localhost:8080/dignacímre - A digna dashboard bejelentkező oldalának kell megjelennie
digna futtatása Windows szolgáltatásként¶
Miért érdemes Windows szolgáltatásként futtatni?¶
A digna backend Windows szolgáltatásként való futtatása biztosítja, hogy a szolgáltatás: - Automatikusan elinduljon a szerver bootolásakor - Háttérben fusson anélkül, hogy nyitva kellene tartani egy Parancssort - Automatikusan újrainduljon, ha összeomlik - A Windows Szolgáltatások felületen keresztül menedzselhető legyen
A windows parancsok¶
A szolgáltatást maga a digna futtatható állomány kezeli, a digna windows alparancsokon keresztül. Nincs szükség batch fájlok futtatására.
| Parancs | Cél |
|---|---|
digna windows install | digna regisztrálása Windows szolgáltatásként |
digna windows start | a regisztrált szolgáltatás indítása |
digna windows stop | a futó szolgáltatás leállítása |
digna windows uninstall | a szolgáltatás regisztrációjának törlése |
Rendszergazdai jogosultság szükséges
Mind a négy parancsot rendszergazdaként megnyitott Parancssorból kell futtatni.
Minden parancs elfogadja a --name kapcsolót, amellyel egy nem alapértelmezett néven regisztrált szolgáltatást címezhetsz meg. A teljes opciólista a CLI referenciában található.
A szolgáltatás telepítése¶
- Nyisd meg a Parancssort rendszergazdaként
- Jobb klikk a Parancssorra
-
Válaszd a "Futtatás rendszergazdaként" opciót
-
Navigálj a digna telepítési könyvtáradba
-
Regisztráld a szolgáltatást
Add meg a címet és a portot, hacsak az alapértékek nem felelnek meg
Az install rögzíti a címet és a portot a szolgáltatás regisztrációjában, és a szolgáltatás pontosan a rögzített értékekhez kötődik. Az alapértékek 127.0.0.1 és 8000, amelyek csak magáról a gépről fogadnak kapcsolatot. Egy másik gépen futó dashboard ezt nem éri el, ezért add meg azt a címet, amelyen a backendnek figyelnie kell:
Ezeket az értékeket a rendszer nem a config.toml fájlból olvassa. Ha később módosítani szeretnéd őket, távolítsd el a szolgáltatást, és telepítsd újra az új értékekkel.
A szolgáltatás automatikus indítással van regisztrálva, így a Windows-zal együtt indul. Azonnal nem indul el — lásd a következő szakaszt.
Telepítési opciók¶
| Opció | Alapérték | Cél |
|---|---|---|
--name | digna | A név, amelyen a szolgáltatás regisztrálva lesz |
--display-name | digna | A services.msc-ben megjelenő név |
--description | digna data quality backend | A services.msc-ben megjelenő leírás |
--address | 127.0.0.1 | A cím, amelyhez a szolgáltatás az API-ját köti |
--port | 8000 | A port, amelyhez a szolgáltatás az API-ját köti |
--working-dir | a digna futtatható állomány könyvtára | A config.toml és a license.toml fájlt tartalmazó könyvtár, amelyet a szolgáltatás munkakönyvtárként használ |
--start-type | auto | Az auto a Windows-zal együtt indul, a manual csak kérésre indul, a disabled regisztrálja a szolgáltatást, de nem engedi elindítani |
--account | LocalSystem | A fiók, amelynek nevében a szolgáltatás fut, pl. DOMAIN\user vagy .\user |
--password | A --account fiók jelszava |
Futtatás tartományi fiókkal
A LocalSystem fióknak nincs hálózati identitása, ezért a SQL Serverrel szembeni Windows-hitelesítés és a hálózati megosztások elérése sikertelen lesz. Telepítsd a --account és a --password kapcsolóval, ha a szolgáltatásnak egy adott felhasználóként kell erőforrásokat elérnie.
A szolgáltatás indítása és leállítása¶
Szolgáltatás indítása¶
Szolgáltatás leállítása¶
Tipp
Mindig állítsd le a szolgáltatást az alkalmazás fájlok frissítése előtt.
Áthelyezés új könyvtárba a szolgáltatásnál¶
Ha át kell helyezned a digna telepítést:
-
Állítsd le és töröld a jelenlegi szolgáltatás regisztrációját
-
Mozgasd az alkalmazás fájlokat
-
Mozgasd az egész digna telepítési mappát az új helyre
-
Regisztráld újra a szolgáltatást az új helyről
Add meg újra az első alkalommal használt --address, --port vagy --account értékeket — a korábbi regisztráció már nem létezik.
- Indítsd el a szolgáltatást
A szolgáltatás eltávolítása¶
-
Állítsd le a futó szolgáltatást
-
Töröld a szolgáltatás regisztrációját
A digna szerver mostantól nincs regisztrálva Windows szolgáltatásként.
Frissítés új kiadásra¶
Ez a szakasz egy Release 2026.06 telepítés Release 2026.11-re történő frissítését írja le. Ha a telepítésed régebbi, először olvasd el a Frissítés 2026.06-nál régebbi kiadásról című részt.
Mielőtt frissítenél¶
A digna adattár biztonsági mentése kötelező
A digna frissítése előtt készíts biztonsági mentést az adattárról (PostgreSQL), hogy elkerüld az adatvesztést. A mentés biztosítja, hogy vissza tudd állítani az adatokat, ha a frissítés során váratlan probléma lép fel.
A Release 2026.11 licencfájljának igénylése
A Release 2026.11 új license.toml fájlt igényel. Kérd el a digna csapattól még a kezdés előtt, és tartsd készenlétben a 7. lépéshez.
Frissítés 2026.06-nál régebbi kiadásról¶
A Release 2026.06 három olyan változást hozott, amely akkor is érvényes, ha egy régebbi telepítést közvetlenül 2026.11-re frissítesz:
- Csak ODBC. A digna minden forrástechnológiát ODBC-n keresztül ér el. Minden olyan adatbázis-kapcsolatot, amely még nem ODBC-t használ, a frissítés után át kell állítani ODBC-re; automatikus átalakítás nincs. Előzetesen telepítsd az ODBC-illesztőprogramokat a digna gazdagépre, lásd: Az ODBC-illesztőprogram telepítése a digna gazdagépre, és készítsd elő minden kapcsolat tulajdonságait a technológiai útmutatók alapján. A Databricks Legacy csatlakozó már nem létezik; költöztesd át ezeket a kapcsolatokat a Databricks csatlakozóra.
- Egyetlen futtatható fájl. A
dignabackendés adignaclihelyét az egyetlendignafuttatható fájl veszi át, amely egyesíti a backendet és a CLI-t. - config.toml. Az
[encryption]szekció kötelező, aDIGNA_APP_HOSTés aDIGNA_APP_PORTbeállítást pedig a digna már nem olvassa be: a szerver a címét és a portját adigna serveparancstól kapja. Vesd össze a fájlodat a Backend konfiguráció résszel.
Az alábbi lépések jelzik, hol igényel egy régebbi telepítés eltérő eljárást. A 8. lépésben az adattár frissítése bármely korábbi kiadás adattárát közvetlenül 2026.11-re hozza.
Frissítési folyamat¶
1. lépés: Állítsd le a digna szolgáltatást¶
Nyiss meg egy Parancssort rendszergazdaként, és állítsd le a szolgáltatást a jelenlegi telepítésed digna futtatható fájljával:
A szolgáltatás regisztrálva marad. Az új futtatható fájl ugyanabban a könyvtárban veszi át a régi helyét, így a regisztráció továbbra is a megfelelő fájlra mutat.
Ha a digna előtérben fut, nyomd meg a Ctrl+C billentyűket a Parancssor ablakában.
Frissítés 2026.06-nál régebbi kiadásról
A 2026.06-nál régebbi kiadások batch fájlokkal regisztrálták a szolgáltatást. Állítsd le, és töröld a regisztrációját a jelenlegi telepítésed batch fájljaival, mielőtt a 2. lépésben bármit átneveznél:
Jegyezd fel, milyen fiók alatt futott a szolgáltatás, valamint milyen címen és porton szolgált ki. A 9. lépésben újra regisztrálni fogod a szolgáltatást.
2. lépés: Mentse a jelenlegi telepítést¶
A digna telepítési könyvtárában nevezd át a jelenlegi telepítés futtatható fájlját és dashboard mappáját, hogy az új kiadás melléjük telepíthető legyen:
A digna_old.exe fájlt tartsd meg, amíg nem ellenőrizted a frissítést, a dashboard_old mappát pedig addig, amíg vissza nem állítottad belőle a konfigurációs fájljaidat (lásd a 4. lépést). Utána mindkettő törölhető.
Frissítés 2026.06-nál régebbi kiadásról
A futtatható fájl helyett a dignabackend és a dignacli mappát nevezd át: ren dignabackend dignabackend_old és ren dignacli dignacli_old. A Release 2026.11 egyik mappát sem használja, és a batch fájlokat tartalmazó bin mappát sem.
3. lépés: Csomagold ki és telepítsd az új verziót¶
- Csomagold ki az új digna telepítő ZIP fájlt
- Másold az új
dignafuttatható fájlt és adashboardmappát a telepítési könyvtárba
Fontos
Sem a config.toml, sem a dashboard/dashboard_config.toml soha nem része a telepítési ZIP-nek — a digna csapat egyik fájlt sem szállítja. A meglévő konfigurációdat ezért a frissítés nem érinti, és az átnevezett *_old mappákban lévő példányok az egyetlenek, amelyekkel rendelkezel.
4. lépés: Állítsd vissza a konfigurációs fájlokat¶
A Release 2026.11 nem igényel változtatást a config.toml fájlban: a Release 2026.06-tal működő fájl továbbra is működik. Két módosítás opcionális:
- Adj hozzá egy
[duckdb]szekciót, ha az adatbázis-kapcsolatoknak a digna Engine-t kell használniuk, és annak alapértelmezett értékei nem felelnek meg a gazdagépnek. - Hagyd el az
[app]szekciót, ha egy fordított proxy egyetlen eredet alatt szolgálja ki a dashboardot és a backendet.
Beállítások, amelyeket a digna nem olvas be
Az útmutató korábbi változatai olyan beállításokat is tartalmaztak, amelyeket a digna nem olvas be. Ezeknek nincs hatásuk, és a config check a 6. lépésben az Unknown keys alatt sorolja fel őket. Távolítsd el vagy javítsd ki őket:
- A
DIGNA_SCHEDULER_MAX_DELAY,DIGNA_CLEANUP_TIME,digna_COOKIE_PATH,digna_COOKIE_SAME_SITE,digna_APP_CORS_ALLOW_METHODS,digna_APP_CORS_ALLOW_HEADERSésdigna_LOGGING_BACKUP_COUNTbeállítás nem létezik. Távolítsd el őket. - A beállítások neve megkülönbözteti a kis- és nagybetűket. A digna a
DIGNA_REPO_HOSTkulcsot olvassa be, nem adigna_REPO_HOSTkulcsot. Minden nevet nagybetűvel írj, ahogy a Backend konfiguráció részben.
Egyszeri bejelentkezés: tartsd meg az [[oidc_clients]] formát
A digna az egyszeri bejelentkezés szolgáltatóit [[oidc_clients]] bejegyzések listájaként olvassa be, mindegyiket saját DIGNA_OIDC_KEY kulccsal. Ha a szolgáltatóidat [oidc_clients.<key>] szekciókra alakítottad át, ahogy az útmutató egy korábbi változata mutatta, alakítsd vissza őket. A config check mindaddig FAILED állapotúnak jelenti az OIDC config(s) elemet, amíg ez a forma van érvényben:
[[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'
Ismételd meg a bejegyzést minden szolgáltatóhoz, és minden DIGNA_OIDC_KEY legyen azonos a dashboard_config.toml fájlban lévő key értékkel. Ez csak az egyszeri bejelentkezést használó telepítéseket érinti.
5. lépés: Töltsd újra a webkiszolgálót¶
A dashboard statikus fájlok összessége, ezért előfordulhat, hogy a webkiszolgáló — és a böngésző — még az előző verziót szolgálja ki. Töltsd újra vagy indítsd újra azt a webkiszolgálót, amely a dashboard mappát kiszolgálja, majd töltsd be újra az oldalt kényszerített frissítéssel (Ctrl+F5).
6. lépés: Ellenőrizze a konfigurációt¶
Mielőtt az adattárhoz nyúlnál, győződj meg róla, hogy a config.toml teljes:
Minden szekciónak OK állapotot kell jelentenie. Javíts ki mindent, amit FAILED állapotúként jelent, távolítsd el az Unknown keys alatt felsorolt kulcsokat, és a folytatás előtt futtasd újra a parancsot.
7. lépés: Cseréld le a licencfájlt¶
A licencfájl általában átvihető egyik kiadásról a másikra. A Release 2026.11 kivétel: két licencköteles modult vezet be, a digna Data Reconciliation-t és a digna Agentic-et, és a 2026.11 előtt kiállított licenc ezeket nem tartalmazza. Másold a digna csapat által a Release 2026.11-hez biztosított license.toml fájlt a telepítési könyvtárba, felülírva a régit:
Ne tartsd meg a korábbi licencet
A korábbi licenccel a digna ugyan elindul, de a digna Data Reconciliation és a digna MCP Server kikapcsolva marad. Minden parancs, amely ellenőrzi a licencet — user, inspection, repo — megszakad, mielőtt az adattárhoz nyúlna, ha az ellenőrzés sikertelen. Ellenőrizd az új licencet, mielőtt továbblépsz:
8. lépés: Frissítsd az adattár sémáját¶
A digna telepítési könyvtárában futtasd:
A Release 2026.11 verziózott migrációkkal kezeli az adattár sémáját. Egy korábbi kiadásról végzett első frissítés a sémát az előző rendszer utolsó verziójára hozza, ezt kiindulópontként rögzíti, majd alkalmazza a Release 2026.11 migrációit. A végén ezt írja ki:
Minden meglévő adat megmarad. Az adattár állapotát bármikor megtekintheted a digna repo check paranccsal: kilistázza a legutóbb alkalmazott migrációt és a még függőben lévőket.
A digna nem indul el elavult adattárral
A Release 2026.11-től a szerver nem hajlandó elindulni, amíg az adattár frissítésre szorul, és ezt jelzi is, például:
A szerver vagy a szolgáltatás indítása előtt futtasd a repo upgrade parancsot.
9. lépés: Indítsd újra a szolgáltatásokat¶
Ha a digna Windows-szolgáltatásként fut, indítsd el újra:
Ha 2026.06-nál régebbi kiadásról frissítettél, és az 1. lépésben törölted a szolgáltatás regisztrációját, előbb regisztráld újra a digna futtatható fájllal:
A --address és a --port kapcsolónak add meg azokat az értékeket, amelyeken a régi szolgáltatás kiszolgált, hacsak nem a 127.0.0.1 és 8000 alapértelmezett értékeket szeretnéd. Ha a régi szolgáltatás tartományi fiók alatt futott, add hozzá a --account és --password kapcsolót. A teljes opciólistát lásd: digna futtatása Windows szolgáltatásként.
Ha manuálisan futtatod, indítsd újra a szervert:
Ha IIS-t vagy Tomcatet használsz, indítsd újra a megfelelő webkiszolgálót.
10. lépés: Ellenőrizd a frissítést¶
-
Ellenőrizd az új futtatható fájl kiadását:
Az első sornak így kell szólnia:
Release: 2026.11. -
Nyisd meg a digna dashboardot, és ellenőrizd, hogy a felület helyesen töltődik-e be.
- Nézd át a telepítés
logskönyvtárában lévő fájlokat esetleges hibákért. - Teszteld az adatbázis-kapcsolatokat — lásd: Kapcsolat tesztelése. Egy 2026.06-nál régebbi kiadásról végzett frissítés után előbb állítsd át ODBC-re mindazokat a kapcsolatokat, amelyek még nem ODBC-t használtak.
Az új modulok használatának megkezdéséhez lásd: digna Data Reconciliation, AI-ügynök csatlakoztatása a digna MCP Serverhez, valamint Profilozási hely a digna Engine-hez.