Linux telepítési útmutató digna Release 2026.11-hoz¶

Kiadás: 2026.11

Utoljára frissítve: 2026. november 7.

Tartalomjegyzék¶

1. Bevezetés
2. Rendszerkövetelmények
3. Telepítés előtti beállítások
4. PostgreSQL szerver beállítása
5. Webszerver konfiguráció
6. Kezdeti telepítés
7. Backend konfiguráció
8. Dashboard konfiguráció
9. digna futtatása systemd szolgáltatásként
10. Frissítés új kiadásra

Bevezetés¶

A digna-ról¶

A digna egy átfogó, mesterséges intelligencia által vezérelt platform, amely az adatminőség kezelését optimalizálja különböző adatkörnyezetekben, mint adattárházak, data lake-ek és lakehouse-ok. Nagy fokú skálázhatóságra és alkalmazkodóképességre tervezték; a digna automatizálással, valós idejű monitorozással és anomáliaészleléssel kezeli a modern adatszakmai kihívásokat.

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: Webes felület, amely egy webszerveren fut, felhasználóbarát módot nyújt a digna platform kezelésére és az adatminőségi metrikák vizualizálására.

Mi újság a 2026.11 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.

Windows vagy macOS útmutatót keres?¶

Ez az útmutató Linuxra vonatkozik. Más platformokhoz lásd a Windows telepítési útmutatót vagy a macOS telepítési útmutatót.

Melyik disztribúcióra vonatkozik az útmutató?¶

Az utasítások a két leggyakoribb szervercsaládra vannak írva. Ha a két család eltér, mindkét parancs szerepel:

• Debian család — Debian, Ubuntu. Csomagkezelő: apt.
• RHEL család — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Csomagkezelő: dnf.

Bármely modern, systemd-t használó disztribúció működni fog; csak a csomagnevek és néhány konfigurációs útvonal változik.

Rendszerkövetelmények¶

Mielőtt hozzákezdene a telepítéshez, győződjön meg róla, hogy rendszere megfelel az alábbi minimális követelményeknek:

Adatbázis telepítési lehetőségek¶

Ha PostgreSQL már telepítve van: Új adatbázist adhat hozzá a meglévő PostgreSQL szerverhez a digna tároló számára.

Ha a PostgreSQL ugyanazon a gépen fut, mint a digna:

A disztribúció és az architektúra ellenőrzése¶

Ebben az útmutatóban néhány parancs eltér a Debian és a RHEL család között. A disztribúció és az architektúra ellenőrzéséhez futtassa:

cat /etc/os-release
uname -m

• ID=ubuntu vagy ID=debian — használja az apt parancsokat.
• ID=rhel, rocky, almalinux vagy fedora — használja a dnf parancsokat.
• x86_64 vagy aarch64 — a telepítési csomaghoz szükséges architektúra.

Telepítés előtti beállítások¶

A digna telepítése előtt győződjön meg arról, 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. Webszerver – a digna Dashboard kiszolgálásához

Ha ezek a komponensek még nincsenek beállítva, kövesse az alábbi részeket az installálásukhoz és konfigurálásukhoz.

A csomagindex frissítése¶

Frissítse a csomaglistát telepítés előtt:

sudo apt update

sudo dnf check-update

PostgreSQL szerver beállítása¶

Ha már van PostgreSQL¶

Ha a PostgreSQL már telepítve és fut a helyi gépén, vagy ha kezelt, távoli PostgreSQL szolgáltatást használ, akkor lépjen tovább a következő szekcióhoz.

PostgreSQL telepítése¶

1. lépés: A szerver csomag telepítése¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

2. lépés: Az adatbázis klaszter inicializálása¶

A Debian családon a csomag automatikusan létrehozza és elindítja a klasztert — lépjen tovább a következő lépésre.

A RHEL családon a klasztert kifejezetten létre kell hozni:

sudo postgresql-setup --initdb

3. lépés: A szolgáltatás engedélyezése és indítása¶

sudo systemctl enable --now postgresql

Ez azonnal elindítja a PostgreSQL-t és beállítja, hogy a rendszerinduláskor automatikusan elinduljon.

4. lépés: A telepítés ellenőrzése¶

psql --version
sudo systemctl status postgresql

Meg kell látnia a PostgreSQL verziót és azt, hogy a szolgáltatás active (running) státuszú.

5. lépés: Kapcsolódás a szerverhez¶

A Linux PostgreSQL csomag létrehoz egy postgres rendszerfiókot, amely a klaszter tulajdonosa. Ezen keresztül csatlakozzon:

sudo -u postgres psql

6. lépés: A port ellenőrzése¶

A PostgreSQL alapértelmezett portja 5432. A szerver által használt port ellenőrzéséhez:

sudo -u postgres psql -c "SHOW port;"

Jegyezze fel az értéket — szüksége lesz rá a digna backend konfigurálásakor.

7. lépés: Jelszavas hitelesítés engedélyezése a digna felhasználó számára¶

A digna TCP-n keresztül digna_user felhasználóként csatlakozik, ami jelszavas hitelesítést igényel a peer/ident helyett. Ellenőrizze, hogy a pg_hba.conf engedélyezi-e ezt.

A fájl helyének lekérdezése:

sudo -u postgres psql -c "SHOW hba_file;"

Nyissa meg egy szerkesztővel, és győződjön meg róla, hogy a helyi TCP sorok scram-sha-256-et (vagy régebbi szervereken md5-öt) használnak ident helyett:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Bármilyen változtatás után töltse újra a PostgreSQL-t:

sudo systemctl reload postgresql

8. lépés: Ha a PostgreSQL egy másik gépen fut¶

Ha másik hostról szeretne csatlakozni, állítsa be a listen_addresses értékét a postgresql.conf-ban és adjon hozzá egy megfelelő host sort a hálózathoz a pg_hba.conf-ban:

listen_addresses = '*'

Ezután nyissa meg a portot a tűzfalon és indítsa újra a szolgáltatást:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Webszerver konfiguráció¶

A digna igényel egy webszervert a dashboard kiszolgálásához. Válasszon az alábbi lehetőségek közül:

• nginx — könnyű és ajánlott
• Apache httpd — széles körben elterjedt alternatíva

Csak egy szervert kell telepítenie és konfigurálnia.

Mindkét szekció két dolgot állít be, amelyekre a dashboardnak szüksége van:

• Single-page application visszaesés (fallback), hogy ha frissíti a dashboard URL-t, ne 404-et kapjon
• .md MIME típus, hogy a Markdown fájlok megfelelően legyenek kiszolgálva

nginx beállítása¶

Áttekintés¶

Az nginx egy könnyű, nagy teljesítményű webszerver, amely jól alkalmas a statikus digna dashboard kiszolgálására.

Telepítés¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx indítása¶

sudo systemctl enable --now nginx

A telepítés ellenőrzése¶

1. Nyissa meg a böngészőt
2. Navigáljon a http://localhost címre
3. Látnia kell az nginx üdvözlőoldalát

A tűzfal megnyitása¶

Ha a szerver más gépek felől is elérhető, engedélyezze a HTTP forgalmat:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Webhely konfigurálása a dashboardhoz¶

Az nginx betölti a conf.d könyvtárban található összes fájlt mindkét disztribúció esetén. Hozzon létre egy dedikált konfigurációs fájlt a digna számára ott:

sudo nano /etc/nginx/conf.d/digna.conf

Illessze be a következőt, cserélje ki a /opt/digna/dashboard-ot a tényleges, kicsomagolt dashboard mappa elérési útjára:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Az alapértelmezett oldal letiltása¶

Csak egy server block lehet default_server egy porton. A Debian családon távolítsa el a csomagolt alapértelmezettet, hogy ne ütközzön:

sudo rm /etc/nginx/sites-enabled/default

A RHEL családon kommentelje ki vagy törölje a server { ... } blokkot a /etc/nginx/nginx.conf fájlban.

A konfiguráció alkalmazása¶

Ellenőrizze a konfigurációt szintaktikai hibák után, majd töltse újra az nginx-et:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd beállítása¶

Áttekintés¶

Az Apache httpd megtalálható a támogatott disztribúciók alapértelmezett tárolóiban. A csomag neve a Debian családon apache2, a RHEL családon pedig httpd.

Telepítés¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache indítása¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

A telepítés ellenőrzése¶

1. Nyissa meg a böngészőt
2. Navigáljon a http://localhost címre
3. Látnia kell a disztribúció alapértelmezett Apache oldalát

Kötelező: mod_rewrite engedélyezése¶

A dashboard URL átírást igényel.

A Debian családon engedélyezze a modult és indítsa újra:

sudo a2enmod rewrite
sudo systemctl restart apache2

A RHEL családon a mod_rewrite alapból betöltődik. Ellenőrizze:

httpd -M | grep rewrite

Kötelező: .htaccess felülírások engedélyezése¶

Nyissa meg a dokumentumgyökér konfigurációs fájlját:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Keresse meg azt a <Directory> blokkot, amely a dokumentumgyökért lefedi (/var/www/html mindkét családon), és módosítsa:

AllowOverride None

erre:

AllowOverride All

Kötelező: MIME típus a Markdown fájlokhoz¶

Ugyanebben a fájlban adja hozzá az alábbi sort, hogy a Markdown fájlok helyesen legyenek kiszolgálva:

AddType text/markdown .md

A konfiguráció alkalmazása¶

Ellenőrizze a szintaxist, majd indítsa újra az Apache-ot:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Kezdeti telepítés¶

1. lépés: A digna tároló beállítása¶

A digna tároló (repository) tárolja a digna által számított összes metrikát. Központi adatbázisként szolgál az analitikai és teljesítményadatok számára.

Sémalétrehozás és felhasználó létrehozása a repóhoz¶

Nyissa meg a PostgreSQL kliensét (psql, pgAdmin vagy hasonló), és futtassa 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élje ki a következő helykitöltő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> — Biztonságos jelszó ehhez a felhasználóhoz

Példa:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

A parancsok egy lépésben történő futtatásához a shellből:

sudo -u postgres psql

Majd illessze be a kéréseket a postgres=# promptnál, és írja be a \q parancsot a kilépéshez.

2. lépés: A digna telepítési csomag kicsomagolása¶

1. Keresse meg a Önnek biztosított digna ZIP fájlt
2. Csomagolja ki a kívánt telepítési helyre — például /opt/digna
3. A kicsomagolás után a következő elemeket kell látnia:
4. dashboard/ — Webes dashboard felület
5. digna — Fő futtatható állomány (backend + CLI kombinálva)

A kicsomagoláshoz shellből:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Tegye futtathatóvá a binárist¶

A fájl átvitele során a futtathatóság elveszhet. Állítsa be expliciten:

cd /opt/digna
sudo chmod +x digna

Szolgáltatási fiók létrehozása¶

Ajánlott a backend futtatása dedikált, korlátozott jogosultságú felhasználóként:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

3. lépés: A licence fájl telepítése¶

1. Keresse meg a kapott license.toml fájlt
2. Másolja be a digna telepítési könyvtár gyökerébe (ahol a config.toml és a digna futtatható fájl található)

Miért fontos ez: A license fájl tartalmazza az ügyféladatokat, a licenc lejárati dátumát és a digitális aláírást. Ne módosítsa ezt a fájlt — bármilyen változtatás érvényteleníti a licencet.

Könyvtárstruktúra a beállítás után:

/opt/digna/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
├── bin/                (service management scripts)
└── dashboard/          (web interface)
    └── (dashboard files)

Backend konfiguráció¶

1. lépés: A konfigurációs fájl létrehozása és szerkesztése¶

A config_template.toml fájl megtalálható a digna telepítési könyvtárban. Csak át kell neveznie config.toml-ra.

cd /opt/digna
sudo mv config_template.toml config.toml

Elérési út: /opt/digna/config.toml

Nyissa meg a config.toml-t egy szövegszerkesztővel, és állítson be minden alábbi szekciót.

[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

[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

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

[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

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

[logging] szekció¶

Ez a rész a naplózás viselkedését állítja be:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[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 = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

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
 - 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: A repó inicializálása¶

1. Nyisson meg egy terminált
2. Navigáljon a digna telepítési könyvtárába (ahol a config.toml és a digna futtatható található)
3. Futtassa a kapcsolat tesztet:

cd /opt/digna
./digna repo check

Új séma esetén a parancs csatlakozik, majd jelzi, hogy még nincs telepített repó:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

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.

sudo ln -s /opt/digna/digna /usr/local/bin/digna

4. lépés: A repó séma telepítése¶

Ugyanabban a könyvtárban futtassa:

./digna repo upgrade

Ez a parancs létrehozza a szükséges táblákat a repó sémájában, és a következő üzenettel zárul:

✅ Repo schema 'dignarepo' is up to date.

5. lépés: Admin felhasználó létrehozása¶

1. Nyisson meg egy új terminált
2. Navigáljon a digna telepítési könyvtárába
3. Futtassa a következő parancsot 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

Ezzel létrejön egy felhasználó admin@example.com e-mail-címmel és teljes rendszergazdai jogosultságokkal.

6. lépés: A digna szerver indítása¶

A digna telepítési könyvtárában indítsa el a szervert:

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

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:

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

Dashboard konfiguráció¶

1. lépés: A dashboard telepítése a webszerverre¶

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 — Önnek kell létrehoznia 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öbb példányos telepítéseknél a backend kapcsolatot.

Válassza ki a webszervert, és kövesse a hozzá tartozó telepítési lépéseket.

Telepítés nginx-re¶

Ha követte az nginx beállítást, a server block már a dashboard mappájára mutat, így másolás nem szükséges.

1. Ellenőrizze az elérési utat
2. Nyissa meg a /etc/nginx/conf.d/digna.conf fájlt

3. Ellenőrizze, hogy a root a kicsomagolt dashboard mappára mutat-e

4. Biztosítsa, hogy a mappa olvasható legyen

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

5. Töltse újra az nginx-et

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Telepítés tesztelése

7. Nyissa meg a böngészőt
8. Navigáljon a http://localhost (vagy a konfigurált URL) címre
9. Látnia kell a digna dashboard bejelentkezési oldalát

Telepítés Apache httpd-re¶

1. Másolja a dashboardot a dokumentumgyökérbe

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Adja hozzá az átírási szabályokat

Hozzon létre egy .htaccess fájlt a telepített mappában, hogy a dashboard útvonalai frissítéskor ne törjenek el:

sudo nano /var/www/html/digna/.htaccess

Illessze be a következőt:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Apache újraindítása

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Dashboard elérése

3. Nyissa meg a böngészőt
4. Navigáljon a http://localhost/digna címre
5. Látnia kell a digna dashboard bejelentkezési oldalát

2. lépés: SELinux (csak RHEL család)¶

RHEL, Rocky, AlmaLinux és Fedora rendszereken az SELinux alapértelmezetten enforcing módban fut, és blokkolhatja a webszervert, ha a fájlok nem a várt helyen vannak. Ellenőrizze, hogy aktív-e:

getenforce

Ha a kimenet Enforcing, és a dashboard az /opt/digna/dashboard alatt van kiszolgálva, címkézze fel a könyvtárat, hogy a webszerver olvasni tudja:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

digna futtatása systemd szolgáltatásként¶

Miért futtassuk a digna-t szolgáltatásként?¶

A digna backend systemd szolgáltatásként futtatva biztosítja, hogy:

• Automatikusan elindul a gép indításakor
• Háttérben fusson, terminál nélkül
• Automatikusan újrainduljon, ha összeomlik
• A systemctl segítségével kezelhető legyen, az ipari szabvány Linux szolgáltatáskezelő

Szolgáltatáskezelő fájlok¶

Minden szükséges fájl a digna telepítési könyvtárában található: bin/

A következő shell scriptek állnak rendelkezésre:

• install_service.sh — digna regisztrálása systemd-ben
• uninstall_service.sh — a szolgáltatás eltávolítása
• start_service.sh — a regisztrált szolgáltatás indítása
• stop_service.sh — a futó szolgáltatás leállítása

A scriptek futtathatóvá tétele¶

A kicsomagolás során a futtatható bit eltűnhet. Első használat előtt:

cd /opt/digna/bin
sudo chmod +x *.sh

A szolgáltatás telepítése¶

1. Nyisson meg egy terminált

2. Navigáljon a bin mappába

   cd /opt/digna/bin
   

3. Futtassa a telepítő scriptet

   sudo ./install_service.sh
   

A digna szerver most regisztrálva van a systemd-ben automatikus indítással. A szolgáltatás nem indul el automatikusan azonnal — a következő szakaszban találja az indítást.

A szolgáltatás indítása és leállítása¶

A szolgáltatás indításához¶

1. Nyisson egy terminált
2. Navigáljon a /opt/digna/bin könyvtárba
3. Futtassa:

   sudo ./start_service.sh
   

A szolgáltatás leállításához¶

1. Nyisson egy terminált
2. Navigáljon a /opt/digna/bin könyvtárba
3. Futtassa:

   sudo ./stop_service.sh
   

A szolgáltatás kezelése systemctl-lel¶

Regisztrálás után a szolgáltatás a standard systemd parancsokkal is vezérelhető bármely könyvtárból:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

A szolgáltatás ellenőrzése¶

Annak megerősítéséhez, hogy a szolgáltatás regisztrálva és fut:

systemctl is-enabled digna
systemctl is-active digna

Az enabled azt jelenti, hogy a szolgáltatás indul a rendszerinduláskor; az active azt jelenti, hogy éppen fut.

A szolgáltatás naplóinak megtekintése¶

A systemd rögzíti mindazt, amit a backend a konzolra ír. A naplók olvasása:

sudo journalctl -u digna -n 100

Élőben követéshez, például hib reprodukálása közben:

sudo journalctl -u digna -f

Az alkalmazás áthelyezése másik könyvtárba¶

Az egységfájl abszolút elérési utat tárol a futtathatóhoz, ezért az áthelyezés újra-regisztrálást igényel:

1. A jelenlegi szolgáltatás eltávolítása

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Az alkalmazás fájljainak áthelyezése

   sudo mv /old/path/digna /new/path/digna
   

3. A szolgáltatás újratelepítése

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. A szolgáltatás indítása

   sudo ./start_service.sh
   

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

1. A futó szolgáltatás leállítása

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

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

   sudo ./uninstall_service.sh
   

A digna szerver most eltávolításra került a systemd regisztrációjából.

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ése régebbi, először olvassa el a Frissítés 2026.06-nál régebbi kiadásról című részt.

Mielőtt frissítene¶

A digna repó biztonsági mentése kötelező

A digna frissítése előtt készítsen biztonsági mentést a repóról (PostgreSQL), hogy elkerülje az adatvesztést. A mentés biztosítja, hogy vissza tudja állítani az adatokat, ha a frissítés során váratlan probléma lép fel.

Mentés készítése shellből:

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

A Release 2026.11 licencfájljának igénylése

A Release 2026.11 új license.toml fájlt igényel. Kérje el a digna csapattól még a kezdés előtt, és tartsa 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ít:

• 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ítse az ODBC-illesztőprogramokat a digna gazdagépre, lásd: Az ODBC-illesztőprogram telepítése a digna gazdagépre, és készítse elő minden kapcsolat tulajdonságait a technológiai útmutatók alapján. A Databricks Legacy csatlakozó már nem létezik; költöztesse át ezeket a kapcsolatokat a Databricks csatlakozóra.
• Egyetlen futtatható fájl. A dignabackend és a dignacli helyét az egyetlen digna futtatható fájl veszi át, amely egyesíti a backendet és a CLI-t.
• config.toml. Az [encryption] szekció kötelező, a DIGNA_APP_HOST és a DIGNA_APP_PORT beállítást pedig a digna már nem olvassa be: a szerver a címét és a portját a digna serve parancstól kapja. Vesse össze a fájlját 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 a repó frissítése bármely korábbi kiadás repóját közvetlenül 2026.11-re hozza.

Frissítési folyamat¶

1. lépés: A digna szolgáltatás leállítása¶

Ha a digna systemd szolgáltatásként fut, először állítsa le:

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

Ha a digna előtérben fut, nyomja meg a Ctrl+C billentyűket a terminálablakában.

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 futtatható fájlját és dashboard mappáját, hogy az új kiadás melléjük telepíthető legyen:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

A digna_old fájlt tartsa meg, amíg nem ellenőrizte a frissítést, a dashboard_old mappát pedig addig, amíg vissza nem állította belőle a konfigurációs fájljait (lásd a 4. lépést). Utána mindkettő törölhető.

3. lépés: Az új verzió kicsomagolása és telepítése¶

1. Csomagolja ki az új digna ZIP fájlt
2. Másolja az új digna futtathatót és a dashboard mappát a telepítési könyvtárba
3. Állítsa vissza a futtathatóságot és a szolgáltatási fiók tulajdonjogát:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

4. lépés: Konfigurációs fájlok visszaállítása¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

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:

• Adjon 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.
• Hagyja el az [app] szekciót, ha egy fordított proxy egyetlen eredet alatt szolgálja ki a dashboardot és a backendet.

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

5. lépés: A webszerver újratöltése¶

A dashboard statikus fájlok összessége, ezért előfordulhat, hogy a webszerver — és a böngésző — még az előző verziót szolgálja ki. Töltse újra vagy indítsa újra azt a webszervert, amely a dashboard mappát kiszolgálja, majd töltse be újra az oldalt kényszerített frissítéssel (Ctrl+F5).

6. lépés: Ellenőrizze a konfigurációt¶

Mielőtt a repóhoz nyúlna, győződjön meg róla, hogy a config.toml teljes:

./digna config check

Minden szekciónak OK állapotot kell jelentenie. Javítson ki mindent, amit FAILED állapotúként jelent, távolítsa el az Unknown keys alatt felsorolt kulcsokat, és a folytatás előtt futtassa újra a parancsot.

7. lépés: A licencfájl cseréje¶

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

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

./digna license check

8. lépés: A repó sémájának frissítése¶

A digna telepítési könyvtárában futtassa:

cd /opt/digna
./digna repo upgrade

A Release 2026.11 verziózott migrációkkal kezeli a repó 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:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Minden meglévő adat megmarad. A repó állapotát bármikor megtekintheti a ./digna repo check paranccsal: kilistázza a legutóbb alkalmazott migrációt és a még függőben lévőket.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

9. lépés: Szolgáltatások újraindítása¶

Ha systemd szolgáltatásként fut:

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

Ha kézzel futtatja, indítsa újra a szervert:

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

Ha nginx-et vagy Apache-ot használ, töltse újra a megfelelő webszervert:

sudo systemctl reload nginx

sudo systemctl restart apache2

A RHEL családon alkalmazza újra az SELinux címkézést, ha a dashboard könyvtárat kicserélték:

sudo restorecon -Rv /opt/digna/dashboard

10. lépés: A frissítés ellenőrzése¶

1. Ellenőrizze az új futtatható fájl kiadását:

   ./digna version
   

   Az első sornak így kell szólnia: Release: 2026.11.

2. Nyissa meg a digna dashboardot, és ellenőrizze, hogy a felület helyesen töltődik-e be.

3. Nézze át a szerver naplóit hibák után kutatva:

   sudo journalctl -u digna -n 100
   

4. Tesztelje 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ítsa á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.