digna Release 2026.06 Windows telepítési útmutató¶
Kiadás: 2026.06
Utoljára frissítve: 2026. augusztus 30.
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.06-os kiadásban¶
Ez a kiadás az adatmegfigyelhetőségi képességeket közvetlenül a kódban hozza el, lehetővé téve a fejlesztők számára az adatok minőségének forrásnál történő monitorozását. A teljes részletekért lásd a release notes-t.
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ű |
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 digna backend alkalmazás beállításait tartalmazza:
[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 = ["*"]
| Paraméter | Érték | Megjegyzés |
|---|---|---|
digna_APP_CORS_ALLOW_ORIGINS | Frontend URL | Ha a dashboard másik szerveren fut, add meg annak URL-jét |
digna_APP_CORS_ALLOW_CREDENTIALS | true | Szükséges CORS-hoz hitelesítő adatokkal |
digna_APP_CORS_ALLOW_METHODS | ["*"] | Minden HTTP metódus engedélyezése |
digna_APP_CORS_ALLOW_HEADERS | ["*"] | Minden fejléc engedélyezése |
[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!"
| 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ó |
[base] szekció¶
Ez a rész a biztonsági és cookie beállításokat tartalmazza:
[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"
| Paraméter | Érték | Megjegyzés |
|---|---|---|
DIGNA_FERNET_KEY | Titkosítási kulcs | Tokenek és sütik titkosításához (alapértelmezett megadható) |
digna_COOKIE_DOMAIN | localhost | Illeszkedjen a frontend domainhez |
digna_COOKIE_SECURE | false (lokális) / true (éles) | Éles környezetben HTTPS esetén állítsd true-ra |
digna_COOKIE_HTTPONLY | true | Biztonsági okokból mindig engedélyezett |
digna_COOKIE_SAME_SITE | lax | CSRF elleni védelem |
digna_TOKEN_EXPIRES_IN | 86400 (24 óra) | Munkamenet lejárata másodpercben |
digna_MAX_WORKERS | CPU magok száma - 1 | Párhuzamos ellenőrzési feladatok száma |
DIGNA_SCHEDULER_MAX_DELAY | 100 | Maximális késleltetés másodpercben, amelyet az ütemező hozzáadhat egy esedékes feladat indítása előtt |
DIGNA_CLEANUP_TIME | "12:00" | Napszak (24 órás HH:MM formátum), amikor a napi takarítás indul |
[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 |
digna_LOGGING_BACKUP_COUNT | 10 | A megtartott napi naplómentések száma |
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
Overall: OK
Javítson ki mindent, amit FAILED állapotúként jelent, és a folytatás előtt futtassa újra a parancsot. 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:
Meg kell jelennie egy megerősítésnek, hogy a kapcsolat létrejött (magát az adattárat még nem inicializáltuk).
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 és sémát a PostgreSQL adatbázisban.
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 - --port — szerver portja
Induláskor a következő típusú üzeneteket kell látnod:
INFO: Started server process [1234]
INFO: Waiting for application startup.
INFO: Application startup complete
INFO: Uvicorn running on http://localhost:8082
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¶
Mielőtt frissítenél¶
Először ellenőrizze az összes adatbázis-kapcsolatot
A 2026.06 kiadástól a digna minden forrástechnológiát ODBC-n keresztül ér el. A korábbi kiadások választást kínáltak a technológiánkénti illesztőprogram és az ODBC között, a Use ODBC kapcsolóval. A digna csapata úgy döntött, hogy kizárólag az ODBC-re épít, mert egyetlen szabványos felület többet ad, mint egy sor testreszabott illesztőprogram:
- Hitelesítés — a hitelesítés az ODBC része, így egy kapcsolat mindent használhat, amit az illesztőprogramja támogat: jelszavakat, tokeneket és PAT-okat, Kerberost és Active Directoryt, MFA-t és böngészőalapú egyszeri bejelentkezést, felhőidentitásokat, ügyféltanúsítványokat és TLS-t. Az új módszerek az illesztőprogram frissítésével érkeznek, nem pedig egy digna kiadásra várva.
- Az adatbázis-gyártók által karbantartott illesztőprogramok — a gyártó saját illesztőprogramja követi az új kiszolgálóverziókat és a biztonsági javításokat, és Ön a saját ütemezése szerint frissítheti, a dignától függetlenül.
- Egyetlen mód mindent beállítani — minden technológia kulcs-érték tulajdonságok listája, ugyanazzal a felülettel, az érzékeny értékek ugyanolyan titkosításával és ugyanazzal a hibakereséssel, ahelyett hogy forrásonként más mezőkészlet lenne.
- Hangolás és lefedettség — az illesztőprogram-szintű beállítások, mint az időtúllépések, a TLS-beállítások, a proxyk és a lekérési méretek minden forráshoz elérhetők, és bármely technológia csatlakoztatható, amelyhez szabványos ODBC-illesztőprogram létezik, azok is, amelyekhez a digna nem ad ki külön útmutatót.
A gyakorlatban ez azt jelenti, hogy a Use ODBC kapcsoló, valamint a külön gazdagép-, port-, adatbázis-, felhasználó- és jelszómezők már nem léteznek. Minden olyan kapcsolatot, amely még nem ODBC-t használ, át kell állítani ODBC-re — automatikus átalakítás nincs, ezért tervezze ezt a frissítés előtt:
- Tekintse át a telepítésében meghatározott valamennyi adatbázis-kapcsolatot, és jegyezze fel azokat, amelyek még nem ODBC-t használnak — mindegyiket újra kell konfigurálni.
- Telepítse a megfelelő ODBC-illesztőprogramot a digna gazdagépre — a kapcsolatokat az a kiszolgáló nyitja meg, amelyen a digna háttérrendszer fut, nem a böngésző. Lásd: Az ODBC-illesztőprogram telepítése a digna gazdagépre.
- Készítse elő az ODBC-tulajdonságokat minden érintett kapcsolathoz. A technológiai útmutatók forrásonként egy bevált tulajdonságkészletet sorolnak fel.
A frissítés után állítsa át ODBC-re minden érintett kapcsolatot, és tesztelje az irányítópultról — lásd: Adatbázis-kapcsolat létrehozása és Kapcsolat tesztelése.
Databricks Legacy kapcsolatok
A Databricks Legacy csatlakozót ebben a kiadásban eltávolítottuk. Költöztesse át ezeket a kapcsolatokat a Databricks csatlakozóra.
A digna adattár biztonsági mentése kötelező
A frissítés előtt készíts biztonsági mentést az adattárról (PostgreSQL), hogy védve legyél az adatvesztés ellen. A mentés biztosítja, hogy vissza tudod állítani az állapotot, ha a frissítés közben váratlan problémák merülnének fel.
Frissítési folyamat¶
1. lépés: Állítsd le a régi szolgáltatást, és töröld a regisztrációját¶
Ha a digna Windows szolgáltatásként fut, állítsd le a jelenlegi telepítésed batch fájljaival — a digna windows parancsok az új kiadáshoz tartoznak, és még nem érhetők el:
Ezután töröld a szolgáltatás regisztrációját, szintén a régi batch fájllal. A regisztráció a régi futtatható állományra és annak scriptjeire mutat, amelyeket ez a frissítés lecserél, ezért nem használható újra:
Töröld a regisztrációt, mielőtt bármit átneveznél
Az uninstall_service.bat abban a bin mappában található, amelyet mindjárt átnevezel, és csak ez tudja eltávolítani az általa létrehozott regisztrációt. Futtasd, amíg a régi telepítés még a helyén van. Ha a mappát már átnevezted, nevezd vissza, töröld a regisztrációt, majd folytasd.
Jegyezd fel, milyen fiókkal futott a szolgáltatás, valamint azt a címet és portot, amelyen kiszolgált — a 9. lépésben szükséged lesz rájuk.
2. lépés: Mentse a jelenlegi telepítést¶
A digna telepítési könyvtárában nevezze át a jelenlegi telepítés mappáit, hogy az új kiadás melléjük telepíthető legyen:
a dignabackend és a dignacli már nem használatos
A 2026.06 kiadástól a dignabackend és a dignacli helyét az egyetlen digna futtatható fájl veszi át, amely egyesíti a háttérrendszert és a CLI-t. A dignabackend_old és a dignacli_old mappát csak addig tartsa meg, amíg a frissítést ellenőrizte — utána mindkettőt törölheti. A dashboard_old mappát tartsa meg, amíg vissza nem állította belőle a konfigurációs fájljait (lásd a 4. lépést). A bin mappa is megszűnik: a benne lévő batch fájlok a régi szolgáltatást vezérelték, és a 2026.06 kiadás már nem tartalmazza őket, így miután az 1. lépésben törölted a szolgáltatás regisztrációját, már csak félrevezetnének.
3. lépés: Csomagold ki és telepítsd az új verziót¶
- Csomagold ki az új digna telepítési ZIP fájlt
- Másold át az új
dignafuttathatót és adashboardmappát a telepítési könyvtáradba
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 2026.06 kiadás módosítja a config.toml fájlt
Három beállítás új és kötelező, kettő pedig már nem használatos. A korábbi kiadásból átvett config.toml nem tartalmazza az új beállításokat, és a digna nem indul el, amíg hiányoznak. Egészítse ki a meglévő config.toml fájlját a következőkkel:
[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"
[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Adja hozzá a két [base] kulcsot a meglévő [base] szekcióhoz, és vegye fel az [encryption] szekciót újként. Ezután távolítsa el az [app] szekcióból a két már nem használt beállítást, a digna_APP_HOST és digna_APP_PORT kulcsot — a kiszolgáló a címét és a portját mostantól a digna serve parancstól kapja.
Az egyes beállítások jelentését lásd: Háttérrendszer konfigurálása.
Egyszeri bejelentkezés: az [oidc_clients] formátuma megváltozott
A 2026.06 kiadás a táblatömböt szolgáltatónként egy-egy táblára cseréli, amelyet a szolgáltató kulcsáról neveznek el. A DIGNA_OIDC_KEY megszűnik — a kulcs mostantól a szakaszfejléc része.
Előtte:
[[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'
Utána:
[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'
Ismételje meg a szakaszt minden szolgáltatóhoz, és tartsa minden kulcsot azonosnak a dashboard_config.toml fájlban lévő key értékkel. A digna config check FAILED állapotúnak jelenti az oidc_clients szakaszt mindaddig, amíg a régi forma megmarad. 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 hozzányúlna a tárolóhoz, győződjön meg róla, hogy a frissített config.toml teljes:
Minden szekciónak OK állapotot kell jelentenie. Javítson ki mindent, amit FAILED állapotúként jelent, és a folytatás előtt futtassa újra a parancsot.
7. lépés: Cseréld le a licencfájlt¶
Minden kiadás külön licencet kap. Másold a digna csapat által ehhez a kiadáshoz 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
Egy korábbi kiadáshoz kiállított license.toml nem érvényes erre a kiadásra, és 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 a licencet, mielőtt továbblépsz:
8. lépés: Frissítsd az adattár sémáját¶
Navigálj a digna telepítési könyvtárába és futtasd:
Ez frissíti a PostgreSQL sémát a legújabb verzióra, miközben megőrzi a meglévő adatokat.
9. lépés: Regisztráld és indítsd el a szolgáltatást¶
A régi regisztrációt az 1. lépésben törölted, ezért a szolgáltatást újra regisztrálni kell — ezúttal a digna futtatható állománnyal, amelyhez nem tartoznak batch fájlok:
A --address és a --port kapcsolónak add meg azokat az értékeket, amelyeken a régi szolgáltatás kiszolgált, hacsak nem az új alapértékeket (127.0.0.1 és 8000) szeretnéd; ezeket a regisztráció rögzíti, és a rendszer már nem a config.toml fájlból olvassa. Add hozzá a --account és a --password kapcsolót, ha a régi szolgáltatás tartományi fiókkal futott. A teljes opciólistát lásd: digna futtatása Windows szolgáltatásként.
Ha kézzel futtattad korábban, indítsd újra a szervert:
Ha IIS-t vagy Tomcat-et használsz, indítsd újra a megfelelő webkiszolgálót.
10. lépés: Ellenőrizd a frissítést¶
- Nyisd meg a digna dashboardot
- Ellenőrizd, hogy a felület betöltődik-e rendesen
- Nézd át a szerver naplóit hibák után kutatva
- Állítsa át ODBC-re mindazokat a kapcsolatokat, amelyek még nem használták, majd tesztelje az összes kapcsolatot — lásd: Kapcsolat tesztelése