macOS Telepítési útmutató a 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. 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.06-os kiadásban¶

Ez a kiadás az adathatékonysági (observability) képességeket közvetlenül a kódba hozza, lehetővé téve a fejlesztők számára, hogy az adatok forrásánál figyeljék az adatmimőséget. Részletekért lásd a release notes-t.

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.06-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 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ó 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!"

[base] szekció¶

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

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

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

Vissza kell kapnia egy megerősítést, hogy a csatlakozás sikeres (magát a repository-t még nem inicializálta).

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 install

Ez a parancs telepíti a szükséges táblákat és sémát a PostgreSQL adatbázisba.

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

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¶

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 repository biztonsági mentése kötelező

A frissítés előtt készítsen biztonsági mentést a repository-ról (PostgreSQL), hogy védje az adatvesztéstől. A mentés biztosítja a visszaállítást, ha a frissítés közben váratlan problémák merülnek fel.

A biztonsági mentés készítése a Terminalbó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: Á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 terminálablakában a Ctrl + C-t.

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
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

[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: 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 hozzányúlna a tárolóhoz, győződjön meg róla, hogy a frissített config.toml teljes:

./digna config check

Minden szekciónak OK állapotot kell jelentenie. Javítson ki mindent, amit FAILED állapotúként jelent, és a folytatás előtt futtassa újra a parancsot.

7. lépés: Cserélje le a licencfájlt¶

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:

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

./digna license check

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

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: 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. 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 esetleges hibákért
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