macOS Telepítési útmutató a 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. Előtelepítési beállítások
4. PostgreSQL szerver beállítása
5. Webszerver konfiguráció
6. Első telepítés
7. Backend konfiguráció
8. Dashboard konfiguráció
9. digna futtatása háttérszolgáltatásként
10. Frissítés új kiadásra

Bevezetés¶

A dignáról¶

digna egy átfogó, MI-vezérelt platform, amely az adatok minőségének kezelését optimalizálja különböző adatkörnyezetekben, mint adattárházak, adat-tavak és lakehouse-ok. Nagymértékben skálázható és alkalmazkodó, digna automatizálással, valós idejű figyeléssel és anomáliaészleléssel kezeli a modern adathasználati 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: webalapú felület egy webszerveren, amely felhasználóbarát módon teszi lehetővé a digna platform használatát és az adathigiéniai mutatók megjelenítését.

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

Windowsot vagy Linuxot keres?¶

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

Rendszerkövetelmények¶

Mielőtt megkezdené a telepítést, győződjön meg arról, hogy a 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: Hozzáadhat egy új adatbázist digna számára a meglévő PostgreSQL szerveréhez.

Ha PostgreSQL-t a dignával ugyanarra a gépre telepíti:

Az architektúra ellenőrzése¶

Több útvonal a leírásban különbözik Apple Silicon és Intel Mac-ek között. Hogy megtudja, melyik van, nyissa meg a Terminalt és futtassa:

uname -m

• arm64 — Apple Silicon. A Homebrew az /opt/homebrew-be települ.
• x86_64 — Intel. A Homebrew a /usr/local-ba települ.

Előtelepítési beállítások¶

A digna telepítése előtt győződjön meg róla, hogy három kulcsfontosságú előfeltétel rendelkezésre áll:

1. Homebrew – a csomagkezelő, amellyel a lenti komponenseket telepítjük
2. PostgreSQL Server – a számított metrikák és teljesítményadatok tárolásához
3. Webszerver – a digna Dashboard hosztolásához

Ha ezek a komponensek még nincsenek beállítva, kövesse az alábbi részeket a telepítésükhöz és konfigurációjukhoz.

Homebrew telepítése¶

A Homebrew a standard csomagkezelő macOS-hez, és ezt használjuk a PostgreSQL és az nginx telepítéséhez.

1. lépés: Ellenőrizze, hogy a Homebrew már telepítve van-e¶

Nyissa meg a Terminalt (nyomja meg a Cmd + Space-t, írja be: Terminal, nyomjon Entert) és futtassa:

brew --version

Ha verziószám jelenik meg, ugorjon a PostgreSQL szerver beállítása részre.

2. lépés: Telepítse a Homebrew-t¶

Ha a fenti parancs nem található, telepítse a Homebrew-t a hivatalos Homebrew oldal utasításai szerint. Az telepítő telepíti az Xcode Command Line Toolst is, ha még nincsenek jelen.

3. lépés: Adja hozzá a Homebrew-t a PATH-hoz¶

Apple Silicon esetén a telepítő két parancsot ír ki, amelyeket futtatni kell a Homebrew shell környezetbe illesztéséhez. Futtassa azokat, majd ellenőrizze:

brew --prefix

Ennek /opt/homebrew-t kell kiírnia Apple Siliconon vagy /usr/local-t Intel esetén.

PostgreSQL szerver beállítása¶

Ha már van PostgreSQL¶

Ha PostgreSQL már telepítve és fut a helyi gépén, vagy felügyelt távoli PostgreSQL szervert használ, ugorjon a következő részhez.

Telepítési lehetőségek¶

macOS-en két egyszerű módon telepíthető PostgreSQL. Válasszon egyet:

• Homebrew — parancssoros telepítés, ajánlott szerver telepítésekhez
• Postgres.app — grafikus telepítés, kényelmes helyi értékeléshez

PostgreSQL telepítése Homebrew-vel¶

1. lépés: Telepítse a PostgreSQL formulát¶

brew install postgresql@16

2. lépés: Adja hozzá a PostgreSQL-t a PATH-hoz¶

A verziózott PostgreSQL formulák keg-only jellegűek, ami azt jelenti, hogy a Homebrew nem linkeli automatikusan a parancsokat a PATH-ba. Adja hozzá kézzel:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. lépés: Indítsa el a PostgreSQL szolgáltatást¶

brew services start postgresql@16

Ez azonnal elindítja a PostgreSQL-t és beállítja, hogy bejelentkezéskor automatikusan újrainduljon.

4. lépés: Ellenőrizze a telepítést¶

psql --version

Ha sikeres a telepítés, meg kell jelennie a PostgreSQL verziónak.

5. lépés: Csatlakozás a szerverhez¶

psql postgres

6. lépés: Ellenőrizze a portot¶

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

psql postgres -c "SHOW port;"

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

PostgreSQL telepítése Postgres.app-pal¶

Ha grafikus telepítést preferál:

1. Töltse le a Postgres.app-ot és húzza az Applications mappába
2. Nyissa meg az alkalmazást és kattintson az Initialize gombra egy új szerver létrehozásához
3. Kövesse az alkalmazás utasításait a parancssori eszközök PATH-hoz adásához
4. Ellenőrizze a telepítést:

psql --version

A Postgres.app is létrehoz egy, a macOS fióknevéről elnevezett szuperfelhasználót.

Webszerver konfiguráció¶

A dignának szüksége van egy webszerverre a dashboard hosztolásához. Válasszon az alábbiak közül:

• nginx — Homebrew-vel telepítve, ajánlott
• Apache httpd — macOS része

Csak egyiket kell telepítenie és konfigurálnia.

Mindkét rész a dashboard számára szükséges két beállítást konfigurálja:

• Single-page-application fallback (egylapos alkalmazás visszadobás), hogy egy dashboard URL frissítésekor ne kapjon 404-et
• .md MIME típus beállítása, hogy a Markdown fájlok helyesen 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¶

brew install nginx

nginx indítása¶

brew services start nginx

Ellenőrizze a telepítést¶

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

Site konfigurálása a Dashboardhoz¶

A Homebrew nginx konfigurációja minden fájlt beolvas a servers könyvtárból. Hozzon létre egy dedikált konfigurációs fájlt a digna számára:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Illessze be a következőt, kicserélve a /path/to/digna/dashboard-ot az Ön kicsomagolt dashboard mappájának valódi elérési útjára:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/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;
    }
}

Alkalmazza a konfigurációt¶

Tesztelje a konfigurációt szintaktikai hibákra, majd töltse újra az nginx-et:

nginx -t
brew services restart nginx

Apache httpd beállítása¶

Áttekintés¶

A macOS tartalmazza az Apache httpd-t, így telepítés nem szükséges. Alapértelmezetten le van tiltva.

Apache indítása¶

sudo apachectl start

Ellenőrizze a telepítést¶

1. Nyissa meg a böngészőt
2. Navigáljon a http://localhost címre
3. A "It works!" üzenetet kell látnia

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

A dashboard URL átírást igényel. Nyissa meg az Apache konfigurációt:

sudo nano /etc/apache2/httpd.conf

Keresse meg a következő sort és távolítsa el előle a kezdő #-t, hogy kicsomagolja:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

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

Ugyanabban a fájlban keresse meg a <Directory "/Library/WebServer/Documents"> blokkot és változtassa meg:

AllowOverride None

erre:

AllowOverride All

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

Még az httpd.conf-ban adja hozzá a következő sort, hogy a Markdown fájlok helyesen legyenek kiszolgálva:

AddType text/markdown .md

Alkalmazza a konfigurációt¶

Ellenőrizze a konfigurációt szintaktikai hibákra, majd indítsa újra az Apache-ot:

sudo apachectl configtest
sudo apachectl restart

Első telepítés¶

1. lépés: Hozza létre a digna repository-t¶

A digna repository tárol minden, a digna által kiszámított metrikát. Ez működik, mint a központi adatbázis az analitikai és teljesítményadatok számára.

Repository sémája és felhasználó létrehozása¶

Nyissa meg a PostgreSQL kliensét (psql, pgAdmin vagy hasonló) és futtassa a következő 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 az alábbi helykitöltőket:

• <digna_repo_schema> — A kívánt séma neve (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 futtatásához a Terminalból egyetlen lépésben:

psql postgres

Majd illessze be a fenti utasításokat a postgres=# promptnál, és írja be a kilépéshez: \q.

2. lépés: Csomagolja ki a digna telepítési csomagot¶

1. Keresse meg a digna telepítő ZIP fájlját, amelyet kapott
2. Csomagolja ki a kívánt telepítési helyre — például /opt/digna vagy ~/digna
3. A kicsomagolás után a következő elemeket kell látnia:
4. dashboard/ — Web dashboard felület
5. digna — Fő futtatható állomány (backend + CLI egyben)

A Terminalból történő kicsomagoláshoz:

unzip digna-2026.11-macos.zip -d /opt/digna

Tegye futtathatóvá a binárist¶

Attól függően, hogyan került át a csomag, a futtathatósági bit lehet, hogy nem maradt meg. Állítsa be egyértelműen:

cd /opt/digna
chmod +x digna

Ha macOS blokkolja az alkalmazást¶

A böngészőn vagy levelezőn keresztül letöltött fájlok karantén attribútummal vannak jelölve. Ha macOS azt írja, hogy az alkalmazás "nem nyitható meg, mert a fejlesztőt nem lehet ellenőrizni", távolítsa el az attribútumot a telepítési könyvtárról:

xattr -dr com.apple.quarantine /opt/digna

Alternatívaként nyissa meg a System Settings → Privacy & Security menüt, keresse meg a blokkolt elemet az oldal alján, és kattintson az Open Anyway gombra.

3. lépés: Telepítse a licencfájlt¶

1. Keresse meg az Önnek biztosított license.toml fájlt
2. Másolja 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 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 azt.

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: Hozza létre és szerkessze a konfigurációs fájlt¶

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
mv config_template.toml config.toml

Hely: /opt/digna/config.toml

Nyissa meg a config.toml fájlt egy szövegszerkesztőben és konfigurálja az alábbi részeket.

[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ó csatlakozá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

[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 konfigurálja:

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

mkdir -p /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: Inicializálja a repository-t¶

1. Nyissa meg a Terminalt
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 csatlakozás 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.

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. lépés: Telepítse a repository sémát¶

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: Hozzon létre egy admin felhasználót¶

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

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

6. lépés: Indítsa el a digna szervert¶

A digna telepítési könyvtárban 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

Dashboard konfiguráció¶

1. lépés: Telepítse a dashboardot 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 megfelelő telepítési lépéseket.

Telepítés nginx-re¶

Ha követte a nginx beállítás részt, a szerver blokk 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: $(brew --prefix)/etc/nginx/servers/digna.conf

3. Győződjön meg róla, hogy a root a kicsomagolt dashboard mappára mutat

4. Biztosítsa a mappa olvashatóságát

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

5. Töltse újra az nginx-et

   nginx -t
   brew services restart nginx
   

6. Tesztelje a telepítést

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

Telepítés Apache httpd-re¶

1. Másolja a Dashboardot a Document Root-ba

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/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 útvonalak túléljék az oldalfrissítést:

sudo nano /Library/WebServer/Documents/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. Indítsa újra az Apache-ot

   sudo apachectl restart
   

2. Nyissa meg a dashboardot

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

digna futtatása háttérszolgáltatásként¶

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

A digna backend háttérszolgáltatásként történő futtatása biztosítja, hogy:

• Automatikusan elinduljon a gép bootolásakor
• A háttérben fusson, anélkül, hogy nyitva kellene tartani egy Terminal ablakot
• Automatikusan újrainduljon, ha összeomlik
• launchctl-lel, macOS szolgáltatáskezelővel menedzselhető legyen

Szolgáltatás-kezelő fájlok¶

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

Az elérhető shell scriptek:

• install_service.sh — digna regisztrálása a launchd-hez
• 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

Tegye futtathatóvá a scripteket¶

A kicsomagoláskor az executable bit eltűnhet. Az első használat előtt:

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

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

1. Nyissa meg a Terminalt

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 launchd-ben automatikus indítással. A szolgáltatás nem indul el automatikusan a telepítéskor — lásd a következő szakaszt az indításhoz.

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

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

1. Nyissa meg a Terminalt
2. Navigáljon a /opt/digna/bin könyvtárba
3. Futtassa:

   sudo ./start_service.sh
   

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

1. Nyissa meg a Terminalt
2. Navigáljon a /opt/digna/bin könyvtárba
3. Futtassa:

   sudo ./stop_service.sh
   

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

A szolgáltatás regisztráltságának és futásának ellenőrzéséhez:

sudo launchctl list | grep digna

Egy sor, ami folyamatazonosítóval kezdődik, azt jelenti, hogy a szolgáltatás fut. Ha az első oszlopban - szerepel, az azt jelenti, hogy regisztrálva van, de leállt.

A szolgáltatás áthelyezése új könyvtárba¶

A launchd eltárolja a futtatható abszolút elérési útját, így az áthelyezés újra-regisztrálást igényel:

1. Távolítsa el a jelenlegi szolgáltatást

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

2. Mozgassa az alkalmazás fájlokat

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

3. Telepítse újra a szolgáltatást

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

4. Indítsa el a szolgáltatást

   sudo ./start_service.sh
   

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

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

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

2. Távolítsa el a szolgáltatást

   sudo ./uninstall_service.sh
   

A digna szerver most eltávolításra került a launchd regisztráció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 a Terminálbó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: Állítsa le a digna szolgáltatást¶

Ha a digna háttérszolgá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ál-ablaká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
mv digna digna_old
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: Csomagolja ki és telepítse az új verziót¶

1. Csomagolja ki az új digna telepítő ZIP fájlt
2. Másolja az új digna futtathatót és a dashboard mappát a telepítési könyvtárába
3. Állítsa vissza a futtathatósági bitet és szükség esetén távolítsa el a karantén attribútumot:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

4. lépés: Állítsa vissza a konfigurációs fájlokat¶

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: Töltse újra a webszervert¶

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 (Cmd+Shift+R).

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: Cserélje le a licencfájlt¶

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:

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

./digna license check

8. lépés: Frissítse a repository sémát¶

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: Indítsa újra a szolgáltatásokat¶

Ha háttérszolgáltatásként fut:

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

Ha manuálisan futtatja, indítsa újra a szervert:

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

Ha nginx-et vagy Apache-ot használ, indítsa újra a megfelelő webszervert:

brew services restart nginx

sudo apachectl restart

10. lépés: Ellenőrizze a frissítést¶

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 kimenetét és a logs könyvtárban lévő fájlokat esetleges hibákért.
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.