Skoči na vsebino

Vodnik za namestitev na Windows za digna Release 2026.11

Release: 2026.11

Zadnja posodobitev: 7. novembra 2026


Vsebina

  1. Uvod
  2. Sistemske zahteve
  3. Predpriprava pred namestitvijo
  4. Namestitev PostgreSQL strežnika
  5. Konfiguracija spletnega strežnika
  6. Začetna namestitev
  7. Konfiguracija backenda
  8. Konfiguracija nadzorne plošče
  9. Poganjanje digna kot Windows storitve
  10. Nadgradnja na novo izdajo

Uvod

O digna

digna je celovita AI-podprta platforma zasnovana za optimizacijo upravljanja kakovosti podatkov v različnih podatkovnih okoljih, kot so podatkovni skladi, jezera in lakehouse rešitve. Zasnovana je za visoko skalabilnost in prilagodljivost ter rešuje sodobne podatkovne izzive s pomočjo avtomatizacije, spremljanja v realnem času in odkrivanja anomalij.

digna je sestavljena iz dveh glavnih komponent:

  • 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 uporabnikom prijazen način interakcije s platformo digna in vizualizacijo metrik 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 macOS ali Linux?

Ta vodič zajema Windows. Za druge platforme si oglejte Vodnik za namestitev na macOS ali Vodnik za namestitev na Linux.


Sistemske zahteve

Pred začetkom namestitve se prepričajte, da vaš sistem izpolnjuje naslednje minimalne zahteve:

Zahteva Specifikacija
Operacijski sistem Windows Server ali Windows 10/11
Pomnilnik (minimalna konfiguracija) 16 GB RAM
Prostor na disku 10 GB prostega prostora
Baza podatkov PostgreSQL Server 12 ali novejši
Spletni strežnik IIS, Apache Tomcat ali ekvivalent

digna Engine

Podatkovne povezave, ki kot lokacijo profiliranja uporabljajo digna Engine, se profilirajo na samem gostitelju digna. Zanje načrtujte dodaten pomnilnik in prostor na disku, glejte sekcijo [duckdb].

Možnosti namestitve baze podatkov

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

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

Priporočene specifikacije

  • Pomnilnik: 32 GB RAM (namesto 16 GB)
  • Prostor na disku: 50 GB prostega prostora (namesto 10 GB)

Te višje specifikacije omogočajo sočasno delovanje digna in PostgreSQL baze na istem strežniku.


Predpriprava pred namestitvijo

Pred namestitvijo digna se prepričajte, da sta izpolnjeni dve ključni predpogoji:

  1. PostgreSQL Server – za shranjevanje izračunanih metrik in podatkov o zmogljivosti
  2. Spletni strežnik – za gostovanje digna Dashboard

Če ti komponenti še nista nameščeni, sledite spodnjim poglavjem za namestitev in konfiguracijo.


Namestitev PostgreSQL strežnika

Če že imate PostgreSQL

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

Namestitev PostgreSQL

Sledite tem korakom za namestitev PostgreSQL na Windows:

Korak 1: Prenesite PostgreSQL

  1. Obiščite PostgreSQL Downloads page
  2. Izberite Windows
  3. Prenesite najnovejši namestitveni program

Korak 2: Zaženite namestitveni program

  1. Dvokliknite preneseno namestitveno datoteko
  2. Sledite navodilom v čarovniku za namestitev

Korak 3: Izberite imenik za namestitev

Izberite imenik, kamor bo PostgreSQL nameščen. Privzeta lokacija je običajno primerna.

Korak 4: Izberite komponente

Za standardno namestitev pustite privzete možnosti komponent.

Korak 5: Nastavite geslo PostgreSQL superuporabnika

Vnesite in potrdite geslo za PostgreSQL superuporabnika (postgres). Shranjeno geslo varno — potreben bo pozneje.

Korak 6: Konfiguracija številke vrat

Privzeta vrata PostgreSQL so 5432. Lahko uporabite privzeto ali določite drugačna vrata po potrebi.

Nasvet

Če so vrata 5432 že v uporabi, izberite alternativna vrata in si jih zabeležite za kasnejšo konfiguracijo.

Korak 7: Izberite jezikovno nastavitev (locale)

Izberite locale za vašo bazo podatkov. Privzeta nastavitev je običajno primerna za večino namestitev.

Korak 8: Dokončajte namestitev

Kliknite Next skozi preostale korake, nato kliknite Finish.

Korak 9: Preverite namestitev

Odprite Command Prompt in preverite, ali je PostgreSQL nameščen:

psql --version

Če je namestitev uspešna, boste videli prikaz različice PostgreSQL.


Konfiguracija spletnega strežnika

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

Potrebno je namestiti in konfigurirati le enega izmed teh strežnikov.

Nastavitev IIS

Pregled

Internet Information Services (IIS) je Microsoftov spletni strežnik za gostovanje spletnih mest in spletnih aplikacij.

Omogočanje IIS

  1. Odprite Nadzorno ploščo
  2. Pritisnite Win + R
  3. Vnesite control in pritisnite Enter

  4. Pojdite na Windows Features

  5. Kliknite Programs
  6. Izberite Turn Windows features on or off

  7. Omogočite Internet Information Services

  8. Pomaknite se navzdol in poiščite Internet Information Services (IIS)
  9. Označite polje za omogočanje
  10. Kliknite na +, da razširite in preverite, da so izbrane te podkomponente:

    • Web Management Tools
    • World Wide Web Services
  11. Kliknite OK za uporabo sprememb

  12. Preverite namestitev IIS

  13. Odprite brskalnik
  14. Pojdite na http://localhost
  15. Morali bi videti IIS Welcome stran

Obvezno: URL Rewrite modul

IIS zahteva komponento URL Rewrite. Prenesite in namestite jo s uradne Microsoft strani.

Obvezno: MIME tip za Markdown datoteke

Da se Markdown datoteke (.md) pravilno servirajo prek IIS:

  1. Odprite IIS Manager (pritisnite Win + R, vnesite inetmgr, pritisnite Enter)
  2. Pomaknite se do Your Site > MIME Types
  3. Kliknite Add...
  4. Konfigurirajte:
  5. File name extension: .md
  6. MIME type: text/markdown

Pomembno

Brez te nastavitve se datoteke .md morda ne bodo pravilno servirale.


Nastavitev Apache Tomcat

Pregled

Apache Tomcat je odprtokodni Java servlet container in spletni strežnik.

Namestitev

  1. Prenesite Apache Tomcat
  2. Obiščite Apache Tomcat Downloads
  3. Prenesite Windows ZIP distribucijo

  4. Razpakirajte arhiv

  5. Razpakirajte ZIP datoteko v imenik na vašem sistemu
  6. Primer: C:\Program Files\Apache Tomcat

  7. Preverite, ali Tomcat teče

  8. Odprite brskalnik
  9. Pojdite na http://localhost:8080
  10. Videti bi morali Apache Tomcat welcome stran

Nasvet

Apache Tomcat se običajno samodejno zažene po namestitvi. Če se ne zažene, pojdite v mapo bin in zaženite startup.bat.


Začetna namestitev

Korak 1: Nastavite digna repozitorij

Digna repozitorij shranjuje vse metrike, ki jih izračuna digna. Deluje kot centralna baza za analitične in podatke o zmogljivosti.

Ustvarite shemo repozitorija in uporabnika

Odprite svoj PostgreSQL klient (pgAdmin, psql 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 nadomestke:

  • <digna_repo_schema> — Ime sheme po vaši želji (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;

Najboljša praksa

Uporabljajte močna, kompleksna gesla za uporabnike baze podatkov. Izogibajte se lahko ugotovljivim poverilnicam.


Korak 2: Razpakirajte namestitveni paket digna

  1. Poiščite ZIP datoteko z namestitvijo digna, ki vam je bila posredovana
  2. Razpakirajte jo na želeno lokacijo za namestitev
  3. Po razpakiranju bi morali videti naslednje elemente:
  4. dashboard/ — Spletni vmesnik nadzorne plošče
  5. digna — Glavna izvršljiva datoteka (backend + CLI skupaj)

Konfiguracijskih in licenčnih datotek ni v paketu

Niti config.toml niti dashboard/dashboard_config.toml nista priložena namestitvi — obe ustvarite sami, v razdelkih Konfiguracija backenda in Konfiguracija nadzorne plošče. Tudi license.toml ni priložena; digna jo posreduje ločeno, kot opisuje Korak 3.

Korak 3: Namestite licenčno datoteko

Pomembno

Licenčna datoteka ni vključena v namestitveni paket in vam bo posredovana ločeno s strani digna.

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

Zakaj je to pomembno: Licenčna datoteka vsebuje vaše podatke o stranki, datum poteka licence in digitalni podpis. Ne spreminjajte te datoteke — sprememba bo veljavnost licenčne datoteke razveljavila.

Struktura imenikov po nastavitvi:

digna_installation/
├── config.toml         (konfiguracijska datoteka)
├── license.toml        (VAŠA LICENČNA DATOTEKA - kopirajte sem)
├── digna               (glavna izvršljiva datoteka)
└── dashboard/          (spletni vmesnik)
    └── (datoteke nadzorne plošče)

Konfiguracija backenda

Korak 1: Ustvarite in uredite konfiguracijsko datoteko

Datoteka config_template.toml je priložena v vaši namestitveni mapi digna. Potrebno jo je le preimenovati v config.toml.

Lokacija: digna_installation/config.toml

Odprite config.toml v besedilnem urejevalniku in konfigurirajte spodnje razdelke.

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
Parameter Vrednost Opombe
DIGNA_APP_CORS_ALLOW_ORIGINS URL-ji nadzorne plošče URL-ji, s katerih se streže nadzorna plošča. Zahteve brskalnika s katerega koli drugega izvora so zavrnjene
DIGNA_APP_CORS_ALLOW_CREDENTIALS true Obvezno, da brskalnik z vsako zahtevo pošlje sejni piškotek

Sekcija [app] je izbirna

Od izdaje 2026.11 lahko oba ključa in celotno sekcijo [app] izpustite. To je prava nastavitev, kadar obratni posrednik (reverse proxy) streže nadzorno ploščo in backend pod enim izvorom: brskalnik takrat ne pošilja zahtev med izvori, privzeto pa nobena ni dovoljena.

Sekcija [repo]

Ta sekcija konfigurira povezavo na PostgreSQL bazo:

[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
Parameter Vrednost Opombe
DIGNA_REPO_HOST localhost ali IP Ime gostitelja/IP PostgreSQL strežnika
DIGNA_REPO_PORT 5432 (privzeto) Vrata PostgreSQL
DIGNA_REPO_DB postgres Ime baze podatkov
DIGNA_REPO_SCHEMA dignarepo Prej ustvarjena shema
DIGNA_REPO_USER digna_user Uporabnik, ustvarjen pri nastavitvi PostgreSQL
DIGNA_REPO_PASSWORD Vaše geslo Geslo, nastavljeno ob ustvarjanju sheme
DIGNA_REPO_SSLMODE prefer (privzeto) Izbirno. Način SSL za PostgreSQL: disable, allow, prefer, require, verify-ca ali verify-full
DIGNA_REPO_NUM_CONNS 16 (privzeto) Izbirno. Število povezav, ki jih digna ohranja odprte do repozitorija

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
Parameter Vrednost Opombe
DIGNA_FERNET_KEY Zgoraj prikazana vrednost Ključ šifriranja, ki so ga uporabljale prejšnje izdaje. Biti mora prisoten; ohranite prikazano vrednost
DIGNA_COOKIE_DOMAIN localhost Gostitelj, prek katerega je dosegljiva nadzorna plošča. "" ne nastavi domene, kar je pravilno za posrednikom, ki nadzorno ploščo in backend streže pod enim izvorom
DIGNA_COOKIE_SECURE false (HTTP) / true (HTTPS) Mora biti true, kadar koli se digna streže prek HTTPS
DIGNA_COOKIE_HTTPONLY true Sejni piškotek ohranja nedosegljiv za skripte
DIGNA_TOKEN_EXPIRES_IN 86400 (24 ur) Čas poteka seje v sekundah
DIGNA_MAX_WORKERS Število jeder CPU - 1 Število pregledov, ki se lahko izvajajo hkrati
DIGNA_FRONTEND_BASEURL URL nadzorne plošče Obvezno. Uporablja se za povezave v sporočilih obvestil, zato mora biti URL, ki ga prejemniki lahko odprejo
DIGNA_SOURCE_QUERY_TIMEOUT_SEC 3600 (privzeto) Izbirno. Število sekund, kolikor sme posamezna poizvedba v izvorni bazi podatkov teči, preden se prekine; 0 onemogoči časovno omejitev
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC 30 (privzeto) Izbirno. Število sekund čakanja na povezavo z izvorno bazo podatkov; 0 čaka neomejeno dolgo

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='
Parameter Vrednost Opombe
DIGNA_ENCRYPTION_KEY Ključ, kodiran v Base64 Šifrira občutljive vrednosti, shranjene v repozitoriju digna

Zaščitite config.toml

Ta ključ je fiksna vrednost, enaka v vseh namestitvah digna, in prav on dešifrira občutljive vrednosti v vašem repozitoriju. Dostop do config.toml omejite na račun, pod katerim teče digna, datoteko hranite zunaj sistema za nadzor različic in deljenih diskov ter jo izključite iz vsake varnostne kopije, ki je shranjena manj varno kot repozitorij sam.

Sekcija [logging]

Ta sekcija konfigurira vedenje beleženja (logging):

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30
Parameter Vrednost Opombe
DIGNA_LOGGING_MODE INFO ali DEBUG INFO za produkcijo, DEBUG za odpravljanje težav. Sprejeti so tudi TRACE, WARN in ERROR
DIGNA_LOGGING_DIR logs (privzeto) Izbirno. Imenik za rotirajoče dnevniške datoteke, relativno glede na delovni imenik
DIGNA_LOGGING_MAX_FILES 30 (privzeto) Izbirno. Število rotiranih dnevniških datotek, ki se hranijo

Pri zagonu kot storitev ohranite imenik dnevnikov

Storitev Windows nima konzole, zato so dnevniške datoteke edini zapis o tem, kaj storitev počne. DIGNA_LOGGING_DIR ne nastavite na prazen niz, saj to izklopi dnevniške datoteke.

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 = "C:\\path\\to\\digna\\tmp"
Parameter Vrednost Opombe
DIGNA_DUCKDB_MEMORY_LIMIT_MB 1024 (privzeto) Pomnilnik v MB, ki ga sme porabiti en zagon digna Engine. Hkrati je lahko aktivnih do DIGNA_MAX_WORKERS zagonov
DIGNA_DUCKDB_TEMP_DIRECTORY Privzeto: začasni imenik računa, pod katerim teče digna (%TEMP%) Imenik za začasne datoteke, kadar podatki ne gredo v pomnilnik

Dimenzioniranje digna Engine

Načrtujte do DIGNA_MAX_WORKERS × DIGNA_DUCKDB_MEMORY_LIMIT_MB pomnilnika na gostitelju digna, poleg tega, kar porabi digna sama, ter dovolj prostega prostora na disku v začasnem imeniku za največji pregledani datum virov podatkov, ki uporabljajo digna Engine. DIGNA_DUCKDB_TEMP_DIRECTORY usmerite na disk s tem prostorom, v katerega lahko piše račun, pod katerim teče digna:

mkdir C:\path\to\digna\tmp

To sekcijo potrebujete le, če vsaj ena podatkovna povezava uporablja digna Engine ali če preverjanje referenčne integritete primerja vire podatkov na različnih povezavah.


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 Command Prompt
  2. Pomaknite se v imenik namestitve digna (kjer sta config.toml in izvršljiva datoteka digna)
  3. Zaženite test povezave:
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.

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.

repo upgrade namešča in nadgrajuje

Od izdaje 2026.11 repo upgrade namesti nov repozitorij in nadgradi obstoječega. repo install še vedno deluje kot drugo ime za isti ukaz.

Korak 5: Ustvarite administratorskega 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 ustvarite uporabnika s polnimi administracijskimi pravicami.

Najboljša praksa

Uporabite močno geslo z mešanico velikih in malih črk, številk in posebnih znakov.


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

Strežnik zaseda terminal

serve teče v ospredju in deluje, dokler ga ne ustavite s Ctrl+C. Pustite ga teči, dokler ne dokončate namestitve; če naj se namesto tega samodejno zaganja ob zagonu sistema, glejte Zagon digna kot Storitve Windows.

Konfiguracija nadzorne plošče

Korak 1: Namestite nadzorno ploščo 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 mapi 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 namestitvah povezavo na backend.

Izberite spletni strežnik in sledite ustreznim korakom namestitve.

Namestitev na IIS

  1. Odprite IIS Manager
  2. Pritisnite Win + R, vnesite inetmgr, pritisnite Enter

  3. Ustvarite novo spletno mesto

  4. V levem panelu desni klik na Sites
  5. Izberite Add Website...

  6. Konfigurirajte spletno mesto

  7. Site Name: Vnesite ime (npr. "dignaDashboard")
  8. Physical Path: Kliknite Browse in izberite mapo dashboard
  9. Binding: Nastavite IP naslov in vrata (privzeta vrata 80 za HTTP, 443 za HTTPS)

  10. Zaženite spletno mesto

  11. Kliknite OK, da ustvarite spletno mesto
  12. Desni klik na novo spletno mesto in izberite Start

  13. Preizkusite namestitev

  14. Odprite brskalnik
  15. Pojdite na http://localhost (ali na vaš konfiguriran URL)
  16. Prikazati bi se morala prijavna stran digna nadzorne plošče

Namestitev na Apache Tomcat

  1. Kopirajte nadzorno ploščo v Tomcat
  2. Kopirajte mapo dashboard v Tomcatovo mapo webapps
  3. Po potrebi jo preimenujte (npr. v digna)
  4. Primer: C:\Program Files\Apache Tomcat\webapps\digna

  5. Preverite namestitev

  6. Osvežite ali ponovno naložite Tomcat upravljalno stran (http://localhost:8080)
  7. Morali bi videti "digna" (ali izbrano ime) na seznamu nameščenih aplikacij

  8. Dostop do nadzorne plošče

  9. Odprite brskalnik
  10. Pojdite na http://localhost:8080/digna
  11. Prikazati bi se morala prijavna stran digna nadzorne plošče

Poganjanje digna kot Windows storitve

Zakaj uporabljati Windows storitev?

Poganjanje digna backenda kot Windows storitve zagotavlja: - Samodejni zagon ob zagonu strežnika - Delovanje v ozadju brez odprtega Command Prompt - Samodejno ponovni zagon v primeru izpada - Upravljanje preko Windows Services

Ukazi windows

Storitev upravlja sama izvršljiva datoteka digna, s podukazi digna windows. Batch datotek za zagon ni.

Ukaz Namen
digna windows install Registrira digna kot Windows storitev
digna windows start Zažene registrirano storitev
digna windows stop Ustavi delujočo storitev
digna windows uninstall Odstrani registracijo storitve

Potrebne so administratorske pravice

Vse štiri ukaze je treba zagnati iz Command Prompt, odprtega kot administrator.

Vsak ukaz sprejme --name, s katerim naslovite storitev, registrirano pod imenom, ki ni privzeto. Celoten seznam možnosti je v referenci CLI.

Namestitev storitve

  1. Odprite Command Prompt kot administrator
  2. Desni klik na Command Prompt
  3. Izberite "Run as Administrator"

  4. Pomaknite se v imenik namestitve digna

    cd C:\path\to\digna
    

  5. Registrirajte storitev

    digna windows install
    

Navedite naslov in vrata, razen če vam ustrezajo privzete vrednosti

install zabeleži naslov in vrata v registraciji storitve, storitev pa se veže natanko na zabeleženo. Privzeti vrednosti sta 127.0.0.1 in 8000, ki sprejemata povezave samo z istega računalnika. Nadzorna plošča na drugem gostitelju tja ne more dostopati, zato navedite naslov, na katerem naj backend posluša:

digna windows install --address 0.0.0.0 --port 8082

Te vrednosti se ne preberejo iz config.toml. Če jih želite pozneje spremeniti, storitev odstranite in jo znova namestite z novimi vrednostmi.

Storitev je registrirana s samodejnim zagonom, zato se bo zagnala skupaj z Windows. Takoj se ne zažene — glejte naslednji razdelek.

Možnosti namestitve

Možnost Privzeto Namen
--name digna Ime, pod katerim naj se registrira storitev
--display-name digna Ime, prikazano v services.msc
--description digna data quality backend Opis, prikazan v services.msc
--address 127.0.0.1 Naslov, na katerega storitev veže svoj API
--port 8000 Vrata, na katera storitev veže svoj API
--working-dir imenik izvršljive datoteke digna Imenik z datotekama config.toml in license.toml, ki ga storitev uporabi kot svoj delovni imenik
--start-type auto auto se zažene skupaj z Windows, manual se zažene samo na zahtevo, disabled registrira storitev, vendar je ne dovoli zagnati
--account LocalSystem Račun, pod katerim teče, npr. DOMAIN\user ali .\user
--password Geslo računa --account

Izvajanje pod domenskim računom

LocalSystem nima omrežne identitete, zato preverjanje pristnosti Windows proti SQL Server in vsak dostop do omrežne mape ne bosta uspela. Kadar mora storitev dostopati do virov kot določen uporabnik, jo namestite z --account in --password.

Zagon in ustavitev storitve

Za zagon storitve

digna windows start

Za ustavitev storitve

digna windows stop

Nasvet

Pred posodobitvijo datotek aplikacije vedno ustavite storitev.

Premik storitve v nov imenik

Če potrebujete premestitev namestitve digna:

  1. Ustavite trenutno storitev in odstranite njeno registracijo

    cd C:\old\path\digna
    digna windows stop
    digna windows uninstall
    

  2. Premaknite datoteke aplikacije

  3. Premaknite celotno mapo namestitve digna na novo lokacijo

  4. Storitev znova registrirajte z nove lokacije

    cd C:\new\path\digna
    digna windows install
    

Ponovite vse vrednosti --address, --port ali --account, ki ste jih uporabili prvič — prejšnje registracije ni več.

  1. Zaženite storitev
    digna windows start
    

Odstranitev storitve

  1. Ustavite tekočo storitev

    cd C:\path\to\digna
    digna windows stop
    

  2. Odstranite registracijo storitve

    digna windows uninstall
    

Digna strežnik je zdaj odregistriran kot Windows storitev.


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.

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

Odprite Command Prompt kot skrbnik in storitev ustavite z izvršljivo datoteko digna svoje trenutne namestitve:

cd C:\path\to\digna
digna windows stop

Storitev ostane registrirana. Nova izvršljiva datoteka zavzame mesto stare v istem imeniku, zato registracija še naprej kaže na pravo datoteko.

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

Nadgradnja z izdaje pred 2026.06

Izdaje pred 2026.06 so storitev registrirale s paketnimi datotekami. Ustavite jo in odstranite njeno registracijo s paketnimi datotekami svoje trenutne namestitve, preden v koraku 2 karkoli preimenujete:

cd C:\path\to\digna\bin
stop_service.bat
uninstall_service.bat

Zapišite si račun, pod katerim je storitev tekla, ter naslov in vrata, na katerih je stregla. Storitev boste znova registrirali v koraku 9.

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 C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

digna_old.exe 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.

Nadgradnja z izdaje pred 2026.06

Namesto izvršljive datoteke preimenujte mapi dignabackend in dignacli: ren dignabackend dignabackend_old in ren dignacli dignacli_old. Izdaja 2026.11 ne uporablja nobene od teh map niti mape bin s paketnimi datotekami.

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

Pomembno

Niti config.toml niti dashboard/dashboard_config.toml nista nikoli vključena v namestitveni ZIP — ekipa digna nobene od teh datotek nikoli ne dostavi. Nadgradnja vaše obstoječe konfiguracije zato ne spremeni, kopije v preimenovanih mapah *_old pa so edine, ki jih imate.

Korak 4: Obnovite konfiguracijske datoteke

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

Nastavitve, ki jih digna ne bere

Prejšnje različice tega vodiča so prikazovale nekatere nastavitve, ki jih digna ne bere. Nimajo nobenega učinka, config check pa jih v koraku 6 navede pod Unknown keys. Odstranite ali popravite jih:

  • DIGNA_SCHEDULER_MAX_DELAY, DIGNA_CLEANUP_TIME, digna_COOKIE_PATH, digna_COOKIE_SAME_SITE, digna_APP_CORS_ALLOW_METHODS, digna_APP_CORS_ALLOW_HEADERS in digna_LOGGING_BACKUP_COUNT ne obstajajo. Odstranite jih.
  • Imena nastavitev razlikujejo med velikimi in malimi črkami. digna bere DIGNA_REPO_HOST, ne digna_REPO_HOST. Vsa imena zapišite z velikimi črkami, kot v razdelku Konfiguracija backend‑a.

Enotna prijava: ohranite [[oidc_clients]]

digna ponudnike enotne prijave bere kot seznam vnosov [[oidc_clients]], vsakega s svojim DIGNA_OIDC_KEY. Če ste svoje ponudnike spremenili v sekcije [oidc_clients.<key>], kot je prikazovala prejšnja različica tega vodiča, jih spremenite nazaj. config check javi OIDC config(s) kot FAILED, dokler je v uporabi ta oblika:

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

Vnos ponovite za vsakega ponudnika in vsak DIGNA_OIDC_KEY ohranite enak vrednosti key v datoteki dashboard_config.toml. Prizadete so le namestitve, ki uporabljajo enotno prijavo.

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 (Ctrl+F5).

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:

copy /Y C:\path\to\new\license.toml license.toml

Ne obdržite prejšnje licence

S prejšnjo licenco se digna še vedno zažene, vendar digna Data Reconciliation in digna MCP Server ostaneta izklopljena. Vsak ukaz, ki preverja licenco — user, inspection, repo — se prekine, še preden se dotakne repozitorija, če preverjanje ne uspe. Preden nadaljujete, preverite novo licenco:

digna license check

Korak 8: Nadgradite shemo repozitorija

V imeniku namestitve digna zaženite:

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.

digna se ne zažene na zastarelem repozitoriju

Od izdaje 2026.11 se strežnik ne zažene, dokler repozitorij potrebuje nadgradnjo, in to tudi sporoči, na primer:

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

Pred zagonom strežnika ali storitve zaženite repo upgrade.

Korak 9: Znova zaženite storitve

Če digna teče kot storitev Windows, jo znova zaženite:

cd C:\path\to\digna
digna windows start

Če ste nadgradili z izdaje pred 2026.06 in v koraku 1 odstranili registracijo storitve, jo najprej znova registrirajte z izvršljivo datoteko digna:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

Za --address in --port navedite vrednosti, na katerih je stregla stara storitev, razen če želite privzeti vrednosti 127.0.0.1 in 8000. Dodajte --account in --password, če je stara storitev tekla pod domenskim računom. Celoten seznam možnosti najdete v razdelku Zagon digna kot storitve Windows.

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

cd C:\path\to\digna
digna serve --address <address> --port <port>

Če uporabljate IIS ali Tomcat, znova zaženite ustrezni spletni strežnik.

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 datotekah v imeniku logs namestitve 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.