Navodila za namestitev na macOS za digna izdajo 2026.11¶

Izdaja: 2026.11

Zadnja posodobitev: 7. november 2026

Kazalo¶

1. Uvod
2. Sistemske zahteve
3. Prednamestitvena priprava
4. Nastavitev PostgreSQL strežnika
5. Konfiguracija spletnega strežnika
6. Začetna namestitev
7. Konfiguracija backend‑a
8. Konfiguracija nadzorne plošče
9. Zagon digna kot ozadnega servisa
10. Nadgradnja na novo izdajo

Uvod¶

O digna¶

digna je celovita platforma, vodena z umetno inteligenco, namenjena optimizaciji upravljanja kakovosti podatkov v različnih podatkovnih okoljih, kot so podatkovni skladi, podatkovna jezera in lakehouse‑i. Zasnovana je za visoko skalabilnost in prilagodljivost ter rešuje sodobne izzive podatkov s pomočjo avtomatizacije, spremljanja v realnem času in odkrivanja anomalij.

digna sestavljata dve glavni komponenti:

• digna: jedro aplikacije, odgovorno za obdelavo podatkov in izvajanje preverjanj kakovosti. Združuje zaledni del in vmesnik ukazne vrstice v eno samo izvršljivo datoteko ter nadomešča ločena programa dignabackend in dignacli iz prejšnjih izdaj.
• dignadashboard: spletni vmesnik gostovan na spletnem strežniku, ki omogoča enostavno interakcijo s platformo digna in vizualizacijo meritev kakovosti podatkov.

Novosti v izdaji 2026.11¶

Ta izdaja dodaja digna Data Reconciliation, digna Agentic z digna MCP Server in digna Engine, ki lahko profilira podatke znotraj digna in preverja referenčno integriteto med različnimi tehnologijami podatkovnih baz. Za popolne podrobnosti si oglejte opombe ob izdaji.

Pri namestitvi izdaja prinaša nov mehanizem migracij repozitorija, izbirno sekcijo [duckdb] v config.toml za digna Engine in novo licenčno datoteko. Vse to pokriva razdelek o nadgradnji.

Iščete Windows ali Linux?¶

Ta vodič pokriva macOS. Za druge platforme si oglejte Windows Installation Guide ali Linux Installation Guide.

Sistemske zahteve¶

Preden začnete z namestitvijo, se prepričajte, da vaš sistem izpolnjuje naslednje minimalne zahteve:

Možnosti namestitve baze podatkov¶

Če je PostgreSQL že nameščen: Lahko dodate novo bazo za digna v obstoječi PostgreSQL strežnik.

Če nameščate PostgreSQL na isti stroj kot digna:

Preverjanje arhitekture¶

Nekateri poti v tem vodiču se razlikujejo za Apple Silicon in Intel Mac‑e. Da preverite, katero imate, odprite Terminal in zaženite:

uname -m

• arm64 — Apple Silicon. Homebrew se namesti v /opt/homebrew.
• x86_64 — Intel. Homebrew se namesti v /usr/local.

Prednamestitvena priprava¶

Pred namestitvijo digna poskrbite, da so prisotni trije ključni predpogoji:

1. Homebrew – paketni upravljalnik, uporabljen za namestitev spodnjih komponent
2. PostgreSQL Server – za shranjevanje izračunanih metrik in podatkov o zmogljivosti
3. Spletni strežnik – za gostovanje digna Dashboarda

Če ti sestavni delci še niso nastavljeni, sledite spodnjim razdelkom za namestitev in konfiguracijo.

Namestitev Homebrew¶

Homebrew je standardni upravljalnik paketov za macOS in se v celotnem vodiču uporablja za namestitev PostgreSQL in nginx.

Korak 1: Preverite, ali je Homebrew že nameščen¶

Odprite Terminal (pritisk Cmd + Space, vnesite Terminal, pritisnite Enter) in zaženite:

brew --version

Če je prikazana številka različice, preskočite na razdelek Nastavitev PostgreSQL strežnika.

Korak 2: Namestite Homebrew¶

Če ukaz ni najden, namestite Homebrew po navodilih na uradni strani Homebrew. Namestitveni program namesti tudi Xcode Command Line Tools, če še niso prisotni.

Korak 3: Dodajte Homebrew v svojo PATH¶

Na Apple Silicon instalator izpiše dva ukaza za dodajanje Homebrew v vaše okolje lupine. Zaženite jih po navodilih, nato potrdite:

brew --prefix

To bi moralo izpisati /opt/homebrew na Apple Silicon ali /usr/local na Intel.

Nastavitev PostgreSQL strežnika¶

Če že imate PostgreSQL¶

Če je PostgreSQL že nameščen in teče na lokalnem stroju ali če uporabljate upravljan oddaljen PostgreSQL strežnik, lahko preskočite na naslednji razdelek.

Možnosti namestitve¶

macOS ponuja dva preprosta načina za namestitev PostgreSQL. Izberite eno:

• Homebrew — namestitev prek ukazne vrstice, priporočena za strežniške namestitve
• Postgres.app — grafična namestitev, priročna za lokalno evalvacijo

Namestitev PostgreSQL z Homebrew¶

Korak 1: Namestite formulo PostgreSQL¶

brew install postgresql@16

Korak 2: Dodajte PostgreSQL v svojo PATH¶

Verzionirane formule PostgreSQL so keg-only, kar pomeni, da Homebrew njihovih ukazov samodejno ne poveže v vaš PATH. Dodajte jih sami:

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

Korak 3: Zaženite storitev PostgreSQL¶

brew services start postgresql@16

To takoj zažene PostgreSQL in ga nastavi, da se ob prijavi samodejno ponovno zažene.

Korak 4: Preverite namestitev¶

psql --version

Če je namestitev uspela, boste videli različico PostgreSQL.

Korak 5: Povežite se s strežnikom¶

psql postgres

Korak 6: Potrdite vrata¶

Privzeta pristanišče PostgreSQL je 5432. Za potrditev, na katerem priključku strežnik posluša:

psql postgres -c "SHOW port;"

Zabeležite vrednost — potrebovali jo boste pri konfiguraciji digna backend‑a.

Namestitev PostgreSQL z aplikacijo Postgres.app¶

Če imate raje grafični vmesnik:

1. Prenesite Postgres.app in ga povlecite v mapo Applications
2. Odprite aplikacijo in kliknite Initialize, da ustvarite nov strežnik
3. Sledite navodilom aplikacije za dodajanje njenih orodij ukazne vrstice v vaš PATH
4. Preverite namestitev:

psql --version

Postgres.app prav tako ustvari superuporabnika z imenom vašega macOS računa.

Konfiguracija spletnega strežnika¶

digna zahteva spletni strežnik za gostovanje nadzorne plošče. Izberite eno od naslednjih možnosti:

• nginx — nameščen prek Homebrew, priporočeno
• Apache httpd — vključen v macOS

Potrebujete le namestitev in konfiguracijo enega izmed teh strežnikov.

Oba razdelka konfigurirata dve stvari, od katerih je odvisna nadzorna plošča:

• Počasen fallback za enostransko aplikacijo (SPA), tako da osvežitev URL‑ja nadzorne plošče ne povzroči 404
• MIME tip za .md, da se Markdown datoteke strežejo pravilno

Nastavitev nginx¶

Pregled¶

nginx je lahek, zmogljiv spletni strežnik, primeren za streženje statične digna nadzorne plošče.

Namestitev¶

brew install nginx

Zagon nginx¶

brew services start nginx

Preverjanje namestitve¶

1. Odprite brskalnik
2. Pojdite na http://localhost:8080
3. Videzite pozdravno stran nginx

Konfiguracija mesta za nadzorno ploščo¶

Homebrew‑ova konfiguracija nginx vključi vse datoteke v imeniku servers. Ustvarite namensko konfiguracijsko datoteko za digna tam:

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

Prilepite naslednje in zamenjajte /path/to/digna/dashboard z dejansko potjo do razširjene mape dashboard:

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

Uveljavitev konfiguracije¶

Preverite konfiguracijo za sintaktične napake, nato ponovno naložite nginx:

nginx -t
brew services restart nginx

Nastavitev Apache httpd¶

Pregled¶

macOS vključuje Apache httpd, zato namestitev ni potrebna. Privzeto je onemogočen.

Zagon Apache¶

sudo apachectl start

Preverjanje namestitve¶

1. Odprite brskalnik
2. Pojdite na http://localhost
3. Videli boste sporočilo "It works!"

Obvezno: omogočite mod_rewrite¶

Nadzorna plošča zahteva prepisovanje URL‑jev. Odprite Apache konfiguracijo:

sudo nano /etc/apache2/httpd.conf

Poiščite naslednjo vrstico in odstranite vodilni #, da jo odkomentirate:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Obvezno: dovolite .htaccess preglasitve¶

V isti datoteki poiščite blok <Directory "/Library/WebServer/Documents"> in spremenite:

AllowOverride None

v:

AllowOverride All

Obvezno: MIME tip za Markdown datoteke¶

Še v httpd.conf dodajte naslednjo vrstico, da se Markdown datoteke strežejo pravilno:

AddType text/markdown .md

Uveljavitev konfiguracije¶

Preverite konfiguracijo za sintaktične napake, nato ponovno zaženite Apache:

sudo apachectl configtest
sudo apachectl restart

Začetna namestitev¶

Korak 1: Nastavite digna repozitorij¶

Repozitorij digna hrani vse meritve, izračunane z digna. Deluje kot centralna baza za analitične in zmogljivostne podatke.

Ustvarite shemo repozitorija in uporabnika¶

Odprite svoj PostgreSQL odjemalec (psql, pgAdmin ali podoben) in izvedite naslednje SQL ukaze:

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

Zamenjajte naslednje nadomestne vrednosti:

• <digna_repo_schema> — želeno ime sheme (npr. dignarepo)
• <digna_repo_user> — želeno uporabniško ime (npr. digna_user)
• <digna_repo_password> — varno geslo za tega uporabnika

Primer:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Za izvedbo teh ukazov iz Terminala v enem koraku:

psql postgres

Nato prilepite izjave na poziv postgres=# in vtipkajte \q, da zapustite.

Korak 2: Razširite namestitveni paket digna¶

1. Poiščite ZIP datoteko namestitvenega paketa digna, ki vam je bila posredovana
2. Razširite jo na želeno lokacijo namestitve — na primer /opt/digna ali ~/digna
3. Po razširitvi bi morali videti naslednje elemente:
4. dashboard/ — spletni vmesnik nadzorne plošče
5. digna — glavni izvršljivi program (backend + CLI skupaj)

Za razširitev iz Terminala:

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

Dovolite zagon izvršljive datoteke¶

Glede na način prenosa se izvršljiva bit morda ne ohrani. Nastavite ga izrecno:

cd /opt/digna
chmod +x digna

Če macOS blokira aplikacijo¶

Datoteke, prenesene prek brskalnika ali pošiljatelja, imajo lahko priponko karantene. Če macOS poroča, da aplikacije "ni mogoče odpreti, ker razvijalca ni mogoče preveriti", odstranite atribut iz namestitvenega imenika:

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

Alternativno odprite System Settings → Privacy & Security, poiščite blokirano postavko blizu dna strani in kliknite Open Anyway.

Korak 3: Namestite licenčno datoteko¶

1. Poiščite license.toml datoteko, ki vam je bila posredovana
2. Kopirajte jo v korenski imenik namestitve digna (kjer se nahajata config.toml in izvršljiva datoteka digna)

Zakaj je to pomembno: Licenčna datoteka vsebuje informacije o stranki, datum poteka licence in digitalni podpis. Ne spreminjajte te datoteke — vsaka sprememba jo bo razveljavila.

Struktura imenika po nastavitvi:

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

Konfiguracija backend‑a¶

Korak 1: Ustvarite in uredite konfiguracijsko datoteko¶

V namestitvenem imeniku digna je priložena datoteka config_template.toml. Preimenujete jo v config.toml.

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

Lokacija: /opt/digna/config.toml

Odprite config.toml v urejevalniku besedil in konfigurirajte vsak spodnji odsek.

Sekcija [app]¶

Ta sekcija konfigurira deljenje virov med izvori (CORS) med nadzorno ploščo in backendom:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

Sekcija [repo]¶

Ta sekcija konfigurira povezavo s PostgreSQL bazo podatkov:

[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

Sekcija [base]¶

Ta sekcija vsebuje nastavitve varnosti, piškotkov in pregledov:

[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

Sekcija [encryption]¶

Ta sekcija vsebuje ključ, s katerim so šifrirane občutljive vrednosti v repozitoriju. Je obvezna — config check sekcijo [encryption] javi kot FAILED, če ključ manjka.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Sekcija [logging]¶

Ta sekcija konfigurira vedenje beleženja:

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

Sekcija [duckdb] (izbirno)¶

Novo v izdaji 2026.11. Ta sekcija določa vire za digna Engine, ki profilira podatke znotraj digna za podatkovne povezave, katerih lokacija profiliranja je digna Engine, in izvaja preverjanja referenčne integritete med viri podatkov na različnih podatkovnih povezavah. Glejte Lokacija profiliranja.

Sekcija je izbirna. Brez nje veljajo spodnje privzete vrednosti.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

Korak 2: Preverjanje Konfiguracije¶

Pred inicializacijo repozitorija preverite, ali je config.toml popoln in pravilno sestavljen. V namestitvenem imeniku digna zaženite:

./digna config check

Vsaka sekcija se preveri posebej, tako da posamezna napaka ne prikrije stanja ostalih:

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

Odpravite vse, kar je javljeno kot FAILED, in pred nadaljevanjem ukaz zaženite znova. WARNING pod Unknown keys navaja ključe v config.toml, ki jih digna ne bere; nimajo nobenega učinka, zato jih odstranite ali popravite njihov zapis. Celoten seznam možnosti najdete v referenci CLI.

Korak 3: Inicializirajte repozitorij¶

1. Odprite Terminal
2. Pojdite v imenik namestitve digna (kjer sta config.toml in izvršljiva datoteka digna)
3. Zaženite test povezave:

cd /opt/digna
./digna repo check

Na novi shemi se ukaz poveže in nato javi, da repozitorij še ni nameščen:

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

Na tej točki je to pričakovani rezultat: potrjuje, da digna doseže PostgreSQL in shemo. Napaka pri povezavi ali preverjanju pristnosti pa kaže na sekcijo [repo] ali na nastavitev PostgreSQL.

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

Korak 4: Namestite shemo repozitorija¶

V istem imeniku zaženite:

./digna repo upgrade

Ta ukaz namesti potrebne tabele v shemo repozitorija in se konča z:

✅ Repo schema 'dignarepo' is up to date.

Korak 5: Ustvarite skrbniškega uporabnika¶

Skrbniški uporabnik se ustvari neposredno v shemi repozitorija, zato strežniku še ni treba teči. V imeniku namestitve digna zaženite:

./digna user add <email> <password> "<display_name>" --admin

Primer:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

S tem se ustvari uporabnik z e-poštnim naslovom admin@example.com in polnimi skrbniškimi pravicami.

Korak 6: Zaženite digna strežnik¶

V imeniku namestitve digna zaženite strežnik z:

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

Parametri: - --address — ime gostitelja/IP strežnika (privzeto 127.0.0.1) - --port — vrata strežnika (privzeto 8000)

Ko strežnik teče, izpiše naslov, na katerem posluša:

Server running on http://127.0.0.1:8082

Konfiguracija nadzorne plošče¶

Korak 1: Razmestitev nadzorne plošče na spletni strežnik¶

Nadzorna plošča digna prebere svojo konfiguracijo iz datoteke dashboard/dashboard_config.toml. Ta datoteka ni priložena namestitvi — ustvarite jo v imeniku dashboard/ poleg datotek nadzorne plošče.

Njena vsebina je opisana v razdelku Enotna prijava (SSO), kjer je datoteka tudi potrebna: vsebuje možnosti prijave, ki jih ponuja nadzorna plošča, in pri večinstančnih nameščanjih povezavo na backend.

Izberite spletni strežnik in sledite ustreznim korakom za namestitev.

Razmestitev na nginx¶

Če ste sledili razdelku nginx Setup, strežniški blok že kaže na vašo mapo dashboard in kopiranje ni potrebno.

1. Potrdite pot
2. Odprite $(brew --prefix)/etc/nginx/servers/digna.conf

3. Preverite, da root kaže na vašo razširjeno mapo dashboard

4. Poskrbite, da je mapa berljiva

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

5. Ponovno naložite nginx

   nginx -t
   brew services restart nginx
   

6. Preizkus namestitve

7. Odprite brskalnik
8. Pojdite na http://localhost:8080 (ali vaš konfigurirani URL)
9. Videti bi morali prijavno stran digna nadzorne plošče

Razmestitev na Apache httpd¶

1. Kopirajte nadzorno ploščo v Document Root

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Dodajte pravila za prepisovanje

Ustvarite .htaccess datoteko v razmestjeni mapi, da poti nadzorne plošče preživijo osvežitev brskalnika:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Prilepite naslednje:

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. Ponovno zaženite Apache

   sudo apachectl restart
   

2. Dostop do nadzorne plošče

3. Odprite brskalnik
4. Pojdite na http://localhost/digna
5. Videli bi morali prijavno stran digna nadzorne plošče

Zagon digna kot ozadnega servisa¶

Zakaj zagnati digna kot storitev?¶

Zagon digna backend‑a kot ozadnega servisa zagotavlja, da se:

• začne samodejno ob zagonu sistema
• teče v ozadju brez odprtega Terminal okna
• samodejno ponovno zažene v primeru zrušitve
• upravlja preko launchctl, upravitelja storitev macOS

Datoteke za upravljanje storitve¶

Vse potrebne datoteke so v imeniku namestitve digna v: bin/

Na voljo so naslednji shell skripti:

• install_service.sh — registrira digna pri launchd
• uninstall_service.sh — odstrani registracijo storitve
• start_service.sh — zažene registrirano storitev
• stop_service.sh — ustavi tekočo storitev

Naredite skripte izvršljive¶

Pri razširitvi morda izvršljiv bit ni ohranjen. Pred prvo uporabo:

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

Namestitev storitve¶

1. Odprite Terminal

2. Pojdite v mapo bin

   cd /opt/digna/bin
   

3. Zaženite namestitveni skript

   sudo ./install_service.sh
   

digna strežnik je zdaj registriran pri launchd z omogočenim samodejnim zagonom. Storitve se ne zažene neposredno — naslednji razdelek prikazuje, kako jo zagnati.

Zagon in ustavitev storitve¶

Za zagon storitve¶

1. Odprite Terminal
2. Pojdite v /opt/digna/bin
3. Zaženite:

   sudo ./start_service.sh
   

Zaustavitev storitve¶

1. Odprite Terminal
2. Pojdite v /opt/digna/bin
3. Zaženite:

   sudo ./stop_service.sh
   

Preverjanje storitve¶

Za potrditev, da je storitev registrirana in teče:

sudo launchctl list | grep digna

Vrstica, ki se začne s procesnim ID‑jem, pomeni, da storitev teče. - v prvem stolpcu pomeni, da je registrirana, a ustavljena.

Premik storitve v nov imenik¶

launchd shrani absolutno pot do izvršljive datoteke, zato premestitev namestitve zahteva ponovno registracijo storitve:

1. Odstranite obstoječo storitev

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

2. Premaknite aplikacijske datoteke

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

3. Ponovno namestite storitev

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

4. Zaženite storitev

   sudo ./start_service.sh
   

Odstranitev storitve¶

1. Ustavite tekočo storitev

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

2. Odstranite storitev

   sudo ./uninstall_service.sh
   

digna strežnik je sedaj odregistriran pri launchd.

Nadgradnja na novo izdajo¶

Ta razdelek nadgradi namestitev izdaje 2026.06 na izdajo 2026.11. Če je vaša namestitev starejša, najprej preberite Nadgradnja z izdaje pred 2026.06.

Pred nadgradnjo¶

Varnostna kopija repozitorija digna je obvezna

Pred nadgradnjo digna varnostno kopirajte svoj repozitorij (PostgreSQL), da se zaščitite pred izgubo podatkov. Varnostna kopija omogoča obnovitev, če pri nadgradnji pride do nepričakovanih težav.

Za ustvarjanje varnostne kopije iz aplikacije Terminal:

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

Pridobitev licenčne datoteke za izdajo 2026.11

Izdaja 2026.11 potrebuje novo datoteko license.toml. Pred začetkom jo zahtevajte od ekipe digna in jo imejte pripravljeno za korak 7.

Nadgradnja z izdaje pred 2026.06¶

Izdaja 2026.06 je prinesla tri spremembe, ki še vedno veljajo, kadar starejšo namestitev nadgradite neposredno na 2026.11:

• Samo ODBC. digna do vsake izvorne tehnologije dostopa prek ODBC. Vsako podatkovno povezavo, ki še ne uporablja ODBC, je treba po nadgradnji preklopiti na ODBC; samodejne pretvorbe ni. Gonilnike ODBC na gostitelja digna namestite vnaprej, glejte Namestitev gonilnika ODBC na gostitelja digna, lastnosti vsake povezave pa imejte pripravljene iz vodnikov po tehnologijah. Konektor Databricks Legacy ne obstaja več; te povezave preselite na konektor Databricks.
• Ena izvršljiva datoteka. dignabackend in dignacli nadomešča ena sama izvršljiva datoteka digna, ki združuje backend in CLI.
• config.toml. Sekcija [encryption] je obvezna, DIGNA_APP_HOST in DIGNA_APP_PORT pa se ne bereta več: naslov in vrata strežnik dobi iz digna serve. Svojo datoteko primerjajte z razdelkom Konfiguracija backend‑a.

Spodnji koraki opozarjajo, kje starejša namestitev potrebuje kaj drugačnega. Nadgradnja repozitorija v koraku 8 repozitorij katere koli prejšnje izdaje pripelje neposredno na 2026.11.

Postopek nadgradnje¶

Korak 1: Ustavite storitev digna¶

Če digna teče kot storitev v ozadju, jo najprej ustavite:

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

Če digna teče v ospredju, v njegovem oknu Terminal pritisnite Ctrl+C.

Korak 2: Varnostno kopirajte trenutno namestitev¶

V namestitvenem imeniku digna preimenujte izvršljivo datoteko in mapo nadzorne plošče trenutne namestitve, da bo novo izdajo mogoče namestiti ob njih:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

digna_old obdržite, dokler ne preverite nadgradnje, dashboard_old pa, dokler iz nje ne obnovite svojih konfiguracijskih datotek (glejte korak 4). Nato lahko oboje izbrišete.

Korak 3: Razpakirajte in razmestite novo različico¶

1. Razpakirajte novo ZIP datoteko namestitve digna
2. Novo izvršljivo datoteko digna in mapo dashboard kopirajte v svoj namestitveni imenik
3. Obnovite bit za izvajanje in po potrebi odstranite atribut karantene:

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

Korak 4: Obnovite konfiguracijske datoteke¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Izdaja 2026.11 ne zahteva nobene spremembe datoteke config.toml: datoteka, ki deluje z izdajo 2026.06, deluje še naprej. Dve spremembi sta izbirni:

• Dodajte sekcijo [duckdb], če naj podatkovne povezave uporabljajo digna Engine in njegove privzete vrednosti ne ustrezajo vašemu gostitelju.
• Sekcijo [app] izpustite, če obratni posrednik streže nadzorno ploščo in backend pod enim izvorom.

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

Korak 5: Ponovno naložite spletni strežnik¶

Nadzorna plošča je nabor statičnih datotek, zato vaš spletni strežnik — in brskalnik — morda še vedno streže prejšnjo različico. Ponovno naložite ali znova zaženite spletni strežnik, ki gosti mapo dashboard, nato pa stran osvežite s trdim osveževanjem (Cmd+Shift+R).

Korak 6: Preverite konfiguracijo¶

Preden se dotaknete repozitorija, potrdite, da je config.toml popoln:

./digna config check

Vsaka sekcija mora javiti OK. Odpravite vse, kar je javljeno kot FAILED, odstranite ključe, navedene pod Unknown keys, in pred nadaljevanjem ukaz zaženite znova.

Korak 7: Zamenjajte licenčno datoteko¶

Licenčna datoteka se običajno prenese iz ene izdaje v naslednjo. Izdaja 2026.11 je izjema: dodaja dva licencirana modula, digna Data Reconciliation in digna Agentic, licenca, izdana pred 2026.11, pa ju ne vsebuje. Datoteko license.toml, ki vam jo je ekipa digna posredovala za izdajo 2026.11, kopirajte v imenik namestitve in z njo zamenjajte staro:

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

./digna license check

Korak 8: Nadgradite shemo repozitorija¶

V imeniku namestitve digna zaženite:

cd /opt/digna
./digna repo upgrade

Izdaja 2026.11 shemo repozitorija upravlja z verzioniranimi migracijami. Prva nadgradnja s prejšnje izdaje shemo pripelje na zadnjo različico prejšnjega sistema, to zabeleži kot izhodišče in nato uporabi migracije izdaje 2026.11. Konča se z:

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

Vsi obstoječi podatki se ohranijo. Stanje repozitorija lahko kadar koli preverite z ukazom ./digna repo check: navede zadnjo uporabljeno migracijo in morebitne čakajoče.

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

Korak 9: Znova zaženite storitve¶

Če digna teče kot storitev v ozadju:

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

Če digna poganjate ročno, znova zaženite strežnik:

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

Če uporabljate nginx ali Apache, znova zaženite ustrezni spletni strežnik:

brew services restart nginx

sudo apachectl restart

Korak 10: Preverite nadgradnjo¶

1. Preverite izdajo nove izvršljive datoteke:

   ./digna version
   

   Prva vrstica se mora glasiti Release: 2026.11.

2. Odprite nadzorno ploščo digna in preverite, ali se vmesnik pravilno naloži.

3. V izpisu strežnika in v datotekah v imeniku logs preverite, ali so se pojavile napake.
4. Preizkusite svoje podatkovne povezave — glejte Preizkušanje povezave. Po nadgradnji z izdaje pred 2026.06 najprej vsako povezavo, ki še ni uporabljala ODBC, preklopite na ODBC.

Za začetek dela z novimi moduli glejte digna Data Reconciliation, Povezava agenta AI za digna MCP Server in Lokacija profiliranja za digna Engine.