Kihagyás

digna Release 2026.06 Windows telepítési útmutató

Kiadás: 2026.06

Utoljára frissítve: 2026. augusztus 30.


Tartalomjegyzék

  1. Bevezetés
  2. Rendszerkövetelmények
  3. Előkészítő lépések
  4. PostgreSQL szerver beállítása
  5. Webkiszolgáló konfiguráció
  6. Kezdeti telepítés
  7. Backend konfiguráció
  8. Dashboard konfiguráció
  9. digna futtatása Windows szolgáltatásként
  10. 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 és dignacli programjait.
  • 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:

  1. PostgreSQL szerver – a számított metrikák és teljesítményadatok tárolásához
  2. 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

  1. Látogass el a PostgreSQL Downloads page oldalra
  2. Válaszd a Windows opciót
  3. Töltsd le a legfrissebb telepítőt

2. lépés: Futtasd a telepítőt

  1. Kattints duplán a letöltött telepítőfájlra
  2. 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:

psql --version

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

  1. Nyisd meg a Vezérlőpultot
  2. Nyomd meg a Win + R billentyűket
  3. Írd be: control és nyomj Entert

  4. Nyisd meg a Windows szolgáltatások beállításait

  5. Kattints a Programok menüpontra
  6. Válaszd a Windows-szolgáltatások be- vagy kikapcsolása lehetőséget

  7. Engedélyezd az Internet Information Services-t

  8. Görgess le és keresd meg az Internet Information Services (IIS) elemet
  9. Jelöld be a jelölőnégyzetet
  10. 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
  11. Kattints az OK gombra a változtatások alkalmazásához

  12. IIS telepítés ellenőrzése

  13. Nyisd meg a böngészőt
  14. Navigálj a http://localhost címre
  15. 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):

  1. Nyisd meg az IIS Manager-t (nyomd meg a Win + R, írd be inetmgr, majd Enter)
  2. Navigálj a Siteod > MIME Types pontra
  3. Kattints az Add... gombra
  4. Állítsd be:
  5. File name extension: .md
  6. 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

  1. Töltsd le az Apache Tomcat-et
  2. Látogass el az Apache Tomcat Downloads oldalra
  3. Töltsd le a Windows ZIP kiadást

  4. Csomag kicsomagolása

  5. Csomagold ki a ZIP fájlt egy könyvtárba a rendszeren
  6. Példa: C:\Program Files\Apache Tomcat

  7. Ellenőrizd, hogy a Tomcat fut-e

  8. Nyisd meg a böngészőt
  9. Navigálj a http://localhost:8080 címre
  10. 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

  1. Keresd meg a neked átadott digna telepítési ZIP fájlt
  2. Csomagold ki a kívánt telepítési helyre
  3. A kicsomagolás után a következő elemeket kell látnod:
  4. dashboard/ — webes dashboard felület
  5. digna — 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.

  1. Keresd meg a számodra átadott license.toml fájlt
  2. Másold be a digna telepítési gyökérkönyvtárába (ahol a config.toml és a digna futtatható 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.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
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:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
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:

digna config check

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)

  1. Nyisd meg a Parancssort
  2. Navigálj a digna telepítési könyvtárába (ahol a config.toml és a digna futtatható található)
  3. Futtasd a kapcsolat tesztet:
digna repo check

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:

digna repo install

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

  1. Nyiss meg egy új Parancssor ablakot
  2. Navigálj a digna telepítési könyvtárába
  3. Futtasd az alábbi parancsot egy admin felhasználó létrehozásához:
digna user add <email> <password> "<display_name>" --admin

Példa:

digna user add admin@example.com "AdminPassword123!" "Admin User" --admin

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:

digna serve --address <host> --port <port>

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

  1. Nyisd meg az IIS Manager-t
  2. Nyomd meg a Win + R, írd be inetmgr, majd Enter

  3. Hozz létre egy új webhelyet

  4. A bal oldali panelen jobb klikk a Sites-ra
  5. Válaszd az Add Website... opciót

  6. Konfiguráld a webhelyet

  7. Site Name: Adj nevet (például "dignaDashboard")
  8. Physical Path: Kattints a Tallózásra és válaszd ki a dashboard mappádat
  9. Binding: Állítsd be az IP címet és portot (alapértelmezett port HTTP-hez 80, HTTPS-hez 443)

  10. Indítsd el a weboldalt

  11. Kattints az OK gombra a webhely létrehozásához
  12. Jobb klikk az új webhelyen és válaszd a Start opciót

  13. Ellenőrizd a telepítést

  14. Nyisd meg a böngészőt
  15. Navigálj a http://localhost (vagy a konfigurált URL) címre
  16. A digna dashboard bejelentkező oldalának kell megjelennie

Telepítés Apache Tomcat-re

  1. Másold a dashboardot a Tomcat-hez
  2. Másold a dashboard mappát a Tomcat webapps könyvtárába
  3. Szükség szerint nevezd át (pl.: digna)
  4. Példa: C:\Program Files\Apache Tomcat\webapps\digna

  5. Ellenőrizd a telepítést

  6. Frissítsd vagy töltsd újra a Tomcat kezelőfelületét (http://localhost:8080)
  7. Látnod kell a "digna" (vagy a választott név) elemet a telepített alkalmazások között

  8. Elérése

  9. Nyisd meg a böngészőt
  10. Navigálj a http://localhost:8080/digna címre
  11. 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

  1. Nyisd meg a Parancssort rendszergazdaként
  2. Jobb klikk a Parancssorra
  3. Válaszd a "Futtatás rendszergazdaként" opciót

  4. Navigálj a digna telepítési könyvtáradba

    cd C:\path\to\digna
    

  5. Regisztráld a szolgáltatást

    digna windows install
    

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:

digna windows install --address 0.0.0.0 --port 8082

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

digna windows start

Szolgáltatás leállítása

digna windows stop

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:

  1. Állítsd le és töröld a jelenlegi szolgáltatás regisztrációját

    cd C:\old\path\digna
    digna windows stop
    digna windows uninstall
    

  2. Mozgasd az alkalmazás fájlokat

  3. Mozgasd az egész digna telepítési mappát az új helyre

  4. Regisztráld újra a szolgáltatást az új helyről

    cd C:\new\path\digna
    digna windows install
    

Add meg újra az első alkalommal használt --address, --port vagy --account értékeket — a korábbi regisztráció már nem létezik.

  1. Indítsd el a szolgáltatást
    digna windows start
    

A szolgáltatás eltávolítása

  1. Állítsd le a futó szolgáltatást

    cd C:\path\to\digna
    digna windows stop
    

  2. Töröld a szolgáltatás regisztrációját

    digna windows uninstall
    

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:

  1. 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.
  2. 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.
  3. 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:

cd C:\path\to\digna\bin
stop_service.bat

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:

uninstall_service.bat

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:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old
# Rename the folder containing dignacli
ren dignacli dignacli_old
# Rename dashboard
ren dashboard dashboard_old

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

  1. Csomagold ki az új digna telepítési ZIP fájlt
  2. Másold át az új digna futtathatót és a dashboard mappá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

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

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:

digna config check

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:

copy /Y C:\path\to\new\license.toml license.toml

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:

digna license check

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:

digna repo upgrade

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:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

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:

cd C:\path\to\digna
digna serve --address <address> --port <port>

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

  1. Nyisd meg a digna dashboardot
  2. Ellenőrizd, hogy a felület betöltődik-e rendesen
  3. Nézd át a szerver naplóit hibák után kutatva
  4. Á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