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

Kiadás: 2026.06

Utoljára frissítve: 2026. szeptember 5.

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.06 kiadásban¶

Ez a kiadás lehetővé teszi az adatmegfigyelhetőség (data observability) közvetlen beépítését a kódba, így a fejlesztők már a forrásnál figyelhetik az adatminőséget. A részletekért lásd a release notes.

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.06-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 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 = ["*"]

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

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

[base] szekció¶

Ez a rész biztonsági és cookie beállításokat tartalmaz:

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

[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_BACKUP_COUNT = 10

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

Meg kell kapnia egy megerősítést, hogy a kapcsolat létrejött (magát a repót még nem inicializáltuk).

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 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: 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 - --port — Szerver portja

Induláskor a következő üzeneteket kell látnia:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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¶

Mielőtt frissítene¶

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.

A digna repó (PostgreSQL) mentése kötelező

Frissítés 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 problémába ütközik.

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

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

Frissítési folyamat¶

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

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

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

Ha a digna képernyőn fut, nyomja meg a Ctrl + C kombinációt a terminálablakban.

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:

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo mv dashboard dashboard_old

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

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

[oidc_clients.microsoft]
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

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 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: A licencfájl cseréje¶

Minden kiadás külön licencet kap. Másolja 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:

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¶

Navigáljon a digna telepítési könyvtárába és futtassa:

cd /opt/digna
./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: 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. Nyissa meg a digna dashboardot
2. Ellenőrizze, hogy a felület helyesen töltődik-e
3. Nézze á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

sudo journalctl -u digna -n 100