Kihagyás

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:

  • dignabackend: Az alkalmazás magja, amely a adatok feldolgozásáért és a minőségellenőrzések elvégzéséért felel.
  • 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:

Követelmény Specifikáció
Operációs rendszer Ubuntu 22.04 LTS vagy újabb, Debian 12 vagy újabb, RHEL 9 / Rocky 9 / AlmaLinux 9 vagy újabb
Architektúra x86_64 (amd64) vagy arm64
Init rendszer systemd
Memória (minimális telepítés) 16 GB RAM
Lemezterület 10 GB szabad tárhely
Adatbázis PostgreSQL Server 12 vagy újabb
Webszerver nginx, Apache httpd vagy egyenértékű

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:

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 nagyobb erőforrások lehetővé teszik, hogy a digna és a PostgreSQL egyszerre fusson a gépen.

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

Megjegyzés

Az útmutatóban egy párban az első parancs a Debian családra, a második a RHEL családra vonatkozik. Futtassa csak azt, amelyik a rendszeréhez illik.


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

Tipp

A disztribúciós csomagok lemaradhatnak a legfrissebb PostgreSQL kiadásoktól. Ha egy konkrét, újabb verzióra van szüksége, használja a hivatalos PostgreSQL apt vagy yum tárolót.

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

Megjegyzés — Linux itt eltér a Windowstól

A Windows telepítő a beállítás során jelszót kér a postgres szuperfelhasználóhoz. A Linux csomagok nem így működnek. Helyi kapcsolatok hitelesítése általában peer authentication: az operációs rendszer postgres felhasználója jelszó nélkül csatlakozhat a postgres adatbázisfelhasználóként.

Ezért használja a fenti sudo -u postgres parancsot. A digna backend TCP-n keresztül, felhasználónévvel és jelszóval csatlakozik, ezért az Kezdeti telepítés szakaszban létrehozunk egy explicit digna felhasználót.

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

Fontos

Ha digna a következőt jelenti: FATAL: Ident authentication failed for user "digna_user", akkor ez a beállítás az oka.

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;
    }
}

Fontos

A try_files direktíva nélkül a dashboard bármely oldalának újratöltése a gyökér URL kivételével 404-et ad vissza. Ez az nginx egyenértéke annak az URL Rewrite modulnak, amely Windows alatt az IIS-hez szükséges.

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

Fontos

Ennek a beállításnak a hiányában a .md fájlok nem biztos, hogy megfelelően szolgálódnak ki.

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.

Legjobb gyakorlat

Használjon erős, összetett jelszavakat az adatbázis-felhasználókhoz. Kerülje a könnyen kitalálható hitelesítő adatokat.


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)
  6. config.toml — Konfigurációs fájl
  7. license.toml — Licence fájl (helyezze be ide a kapott fájlt)

A kicsomagoláshoz shellből:

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

Megjegyzés

Ha az unzip nincs telepítve, telepítse: sudo apt install -y unzip vagy sudo dnf install -y unzip.

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

Megjegyzés

A RHEL családon az egyenértékű shell útvonala /sbin/nologin.

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

Fontos

A licence fájl nem része a telepítési csomagnak; külön kerül Önnek átadásra a digna-tól.

  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_HOST = "localhost"
digna_APP_PORT = 8082
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_HOST localhost vagy IP cím A hoszt név vagy IP, ahol a dignabackend fut
digna_APP_PORT 8082 (alapértelmezett) A REST API végpontok portja
digna_APP_CORS_ALLOW_ORIGINS Frontend URL Ha a dashboard más szerveren van, adja hozzá annak URL-jét
digna_APP_CORS_ALLOW_CREDENTIALS true Szükséges CORS esetén hitelesítéssel
digna_APP_CORS_ALLOW_METHODS ["*"] Minden HTTP metódus engedélyezése
digna_APP_CORS_ALLOW_HEADERS ["*"] Minden fejléc engedélyezése

Megjegyzés

Ha a dashboard-ot nginx vagy Apache szolgálja ki az alapértelmezett HTTP porton, az engedélyezendő origin http://localhost — vagy a szerver publikus URL-je, ha a dashboard más gépekről is elérhető.

[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 PostgreSQL szerver hoszt/IP
digna_REPO_PORT 5432 (alapértelmezett) PostgreSQL port
digna_REPO_DB postgres Adatbázis neve
digna_REPO_SCHEMA dignarepo Korábban létrehozott séma
digna_REPO_USER digna_user PostgreSQL-ben létrehozott felhasználó
digna_REPO_PASSWORD Az Ön jelszava A sémalétrehozáskor beállított jelszó

Legjobb gyakorlat

A config.toml jelszót tartalmaz tiszta szövegként. Korlátozza a fájl jogosultságait, hogy csak a szolgáltatási fiók olvashassa:

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 = "your-fernet-key"
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
Paraméter Érték Megjegyzés
digna_FERNET_KEY Titkosítási kulcs Tokenek és cookie-k titkosításához (alapértelmezett van)
digna_COOKIE_DOMAIN localhost Egyezzen a frontend domainnel
digna_COOKIE_SECURE false (helyi) / true (éles) Használjon true-t HTTPS esetén
digna_COOKIE_HTTPONLY true Biztonsági okokból mindig engedélyezett
digna_COOKIE_SAME_SITE lax CSRF támadások 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

Tipp

Az elérhető CPU magok számának meghatározásához futtassa: nproc.

[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 hibaelhárításhoz
digna_LOGGING_BACKUP_COUNT 10 Megőrzendő napi naplómentések száma

2. 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).

Megjegyzés

Linuxon az aktuális könyvtár nincs a PATH-on, ezért az futtatható ./digna formában hívandó, nem csak digna. Ha mindenhol rövidebb formát szeretne használni, hozzon létre egy szimbolikus linket:

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

3. 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.

4. 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

Tipp

Ha a dashboard egy másik gépről éri el a backendet, engedélyezze az API portot a tűzfalon:

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

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 <username> "<full_name>" <password> --su

Példa:

./digna user add admin "Admin User" 'AdminPassword123!' --su

Ez létrehoz egy admin felhasználót teljes adminisztratív jogosultságokkal.

Tipp

Tegye egyes idézőjelek közé a jelszót. A bash és zsh speciális karakterként kezel néhány szimbólumot (!, $, *), és ha nincsenek idézőjelek, a jelszó nem lesz megfelelően továbbítva.

Legjobb gyakorlat

Használjon erős jelszót, amely nagy- és kisbetűket, számokat és speciális karaktereket is tartalmaz.


Dashboard konfiguráció

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

A digna dashboardnak saját, külön config.toml fájlja van a dashboard/ könyvtárban. Ez a konfiguráció már biztosítva van és kezdeti telepítés során általában nem kell módosítani. Csak akkor kell változtatni, ha a backend kapcsolódást testre szeretné szabni.

Ha módosítani kell a dashboard konfigurációját (pl. multi-instance telepítéseknél), kövesse a dashboard dokumentációját.

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

Megjegyzés

Ha a semanage nem található, telepítse: sudo dnf install -y policycoreutils-python-utils.

Fontos

Egy frissen konfigurált RHEL szerveren a 403 Forbidden hibát a dashboard esetében szinte mindig SELinux címkézési probléma okozza, nem fájljogosultsági hiba. Ellenőrizze az eseményeket: sudo ausearch -m avc -ts recent.


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

Root jogosultság szükséges

Minden scriptet sudo-val kell futtatni, mert a rendszerindításkor induló szolgáltatás regisztrálása egységfájlt ír a /etc/systemd/system-be.

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
    

Tipp

Mindig állítsa le a szolgáltatást a frissítés előtt az alkalmazásfájlok módosítása előtt.

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

Tipp

Ez a leggyorsabb mód annak diagnosztizálására, ha a szolgáltatás elindul és azonnal leáll. Itt jelentődik a repókapcsolat hiba vagy a hiányzó license.toml.

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

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: A jelenlegi backend telepítés mentése

A digna telepítési könyvtárban:

cd /opt/digna
sudo mv digna digna_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

Fontos

A config.toml fájl soha nincs benne a telepítési ZIP-ben. A meglévő konfigurációja biztonságban marad.

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

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

5. 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.

6. 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

7. 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:
sudo journalctl -u digna -n 100