Vodnik za namestitev na Windows za digna Release 2026.06¶
Release: 2026.06
Zadnja posodobitev: 30. avgusta 2026
Vsebina¶
- Uvod
- Sistemske zahteve
- Predpriprava pred namestitvijo
- Namestitev PostgreSQL strežnika
- Konfiguracija spletnega strežnika
- Začetna namestitev
- Konfiguracija backenda
- Konfiguracija nadzorne plošče
- Poganjanje digna kot Windows storitve
- 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
dignabackendindignacliiz 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.06¶
Ta izdaja vnaša zmožnosti opazovanja podatkov neposredno v vašo kodo, kar razvijalcem omogoča spremljanje kakovosti podatkov pri izvoru. Za popolne podrobnosti glejte release notes.
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 |
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:
- PostgreSQL Server – za shranjevanje izračunanih metrik in podatkov o zmogljivosti
- 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¶
- Obiščite PostgreSQL Downloads page
- Izberite Windows
- Prenesite najnovejši namestitveni program
Korak 2: Zaženite namestitveni program¶
- Dvokliknite preneseno namestitveno datoteko
- 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:
Č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¶
- Odprite Nadzorno ploščo
- Pritisnite
Win + R -
Vnesite
controlin pritisnite Enter -
Pojdite na Windows Features
- Kliknite Programs
-
Izberite Turn Windows features on or off
-
Omogočite Internet Information Services
- Pomaknite se navzdol in poiščite Internet Information Services (IIS)
- Označite polje za omogočanje
-
Kliknite na +, da razširite in preverite, da so izbrane te podkomponente:
- Web Management Tools
- World Wide Web Services
-
Kliknite OK za uporabo sprememb
-
Preverite namestitev IIS
- Odprite brskalnik
- Pojdite na
http://localhost - 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:
- Odprite IIS Manager (pritisnite
Win + R, vnesiteinetmgr, pritisnite Enter) - Pomaknite se do Your Site > MIME Types
- Kliknite Add...
- Konfigurirajte:
- File name extension:
.md - 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¶
- Prenesite Apache Tomcat
- Obiščite Apache Tomcat Downloads
-
Prenesite Windows ZIP distribucijo
-
Razpakirajte arhiv
- Razpakirajte ZIP datoteko v imenik na vašem sistemu
-
Primer:
C:\Program Files\Apache Tomcat -
Preverite, ali Tomcat teče
- Odprite brskalnik
- Pojdite na
http://localhost:8080 - 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¶
- Poiščite ZIP datoteko z namestitvijo digna, ki vam je bila posredovana
- Razpakirajte jo na želeno lokacijo za namestitev
- Po razpakiranju bi morali videti naslednje elemente:
dashboard/— Spletni vmesnik nadzorne ploščedigna— 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.
- Poiščite datoteko
license.toml, ki vam je bila posredovana - Kopirajte jo v root imenik namestitve digna (kjer se nahajata
config.tomlin izvršljiva datotekadigna)
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 nastavitve aplikacije digna backend:
[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 = ["*"]
| Parameter | Vrednost | Opombe |
|---|---|---|
digna_APP_CORS_ALLOW_ORIGINS | URL frontenda | Če je nadzorna plošča na drugem strežniku, vključite njen URL |
digna_APP_CORS_ALLOW_CREDENTIALS | true | Zahtevano za CORS s poverilnicami |
digna_APP_CORS_ALLOW_METHODS | ["*"] | Dovoli vse HTTP metode |
digna_APP_CORS_ALLOW_HEADERS | ["*"] | Dovoli vse glave |
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!"
| Parameter | Vrednost | Opombe |
|---|---|---|
digna_REPO_HOST | localhost ali IP | Ime gostitelja/IP PostgreSQL strežnika |
digna_REPO_PORT | 5432 (privzeto) | PostgreSQL vrata |
digna_REPO_DB | postgres | Ime podatkovne baze |
digna_REPO_SCHEMA | dignarepo | Shema ustvarjena prej |
digna_REPO_USER | digna_user | Uporabnik ustvarjen v nastavitvi PostgreSQL |
digna_REPO_PASSWORD | Vaše geslo | Geslo, nastavljeno med ustvarjanjem sheme |
Sekcija [base]¶
Ta sekcija vsebuje varnostne in piškotne nastavitve:
[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"
| Parameter | Vrednost | Opombe |
|---|---|---|
DIGNA_FERNET_KEY | Ključ za šifriranje | Uporablja se za šifriranje tokenov in piškotkov (privzeto priložen) |
digna_COOKIE_DOMAIN | localhost | Ujemajte z domeno frontenda |
digna_COOKIE_SECURE | false (lokalno) / true (produkcija) | Uporabite true za HTTPS povezave |
digna_COOKIE_HTTPONLY | true | Vedno omogočeno zaradi varnosti |
digna_COOKIE_SAME_SITE | lax | Preprečuje CSRF napade |
digna_TOKEN_EXPIRES_IN | 86400 (24 ur) | Potek seje v sekundah |
digna_MAX_WORKERS | Število CPU jeder - 1 | Število paralelnih nalog inšpekcij |
DIGNA_SCHEDULER_MAX_DELAY | 100 | Največja zakasnitev v sekundah, ki jo sme razporejevalnik dodati pred zagonom zapadlega opravila |
DIGNA_CLEANUP_TIME | "12:00" | Ura dneva (24-urni zapis HH:MM), ob kateri se začne dnevno čiščenje |
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.
| 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):
| Parameter | Vrednost | Opombe |
|---|---|---|
digna_LOGGING_MODE | INFO ali DEBUG | INFO za produkcijo, DEBUG za odpravljanje napak |
digna_LOGGING_BACKUP_COUNT | 10 | Število dnevnih kopij dnevnikov, ki jih obdržimo |
Korak 2: Preverjanje Konfiguracije¶
Pred inicializacijo repozitorija preverite, ali je config.toml popoln in pravilno sestavljen. V namestitvenem imeniku digna zaženite:
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
Overall: OK
Odpravite vse, kar je javljeno kot FAILED, in pred nadaljevanjem ukaz poženite znova. Celoten seznam možnosti najdete v referenci CLI.
Korak 3: Inicializirajte repozitorij¶
- Odprite Command Prompt
- Pomaknite se v imenik namestitve digna (kjer sta
config.tomlin izvršljiva datotekadigna) - Zaženite test povezave:
Videti bi morali potrditev, da je povezava vzpostavljena (samo repozitorij še ni inicializiran).
Korak 4: Namestite shemo repozitorija¶
V istem imeniku zaženite:
Ta ukaz namesti potrebne tabele in shemo v vašo PostgreSQL bazo.
Korak 5: Ustvarite administratorskega uporabnika¶
- Odprite novo okno Command Prompt
- Pomaknite se v imenik namestitve digna
- Zaženite naslednji ukaz za ustvarjanje administratorskega uporabnika:
Primer:
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:
Parametri: - --address — Ime gostitelja/IP strežnika - --port — Vrata strežnika
Videti bi morali zagonska sporočila, ki potrjujejo zagon strežnika:
INFO: Started server process [1234]
INFO: Waiting for application startup.
INFO: Application startup complete
INFO: Uvicorn running on http://localhost: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¶
- Odprite IIS Manager
-
Pritisnite
Win + R, vnesiteinetmgr, pritisnite Enter -
Ustvarite novo spletno mesto
- V levem panelu desni klik na Sites
-
Izberite Add Website...
-
Konfigurirajte spletno mesto
- Site Name: Vnesite ime (npr. "dignaDashboard")
- Physical Path: Kliknite Browse in izberite mapo
dashboard -
Binding: Nastavite IP naslov in vrata (privzeta vrata 80 za HTTP, 443 za HTTPS)
-
Zaženite spletno mesto
- Kliknite OK, da ustvarite spletno mesto
-
Desni klik na novo spletno mesto in izberite Start
-
Preizkusite namestitev
- Odprite brskalnik
- Pojdite na
http://localhost(ali na vaš konfiguriran URL) - Prikazati bi se morala prijavna stran digna nadzorne plošče
Namestitev na Apache Tomcat¶
- Kopirajte nadzorno ploščo v Tomcat
- Kopirajte mapo
dashboardv Tomcatovo mapowebapps - Po potrebi jo preimenujte (npr. v
digna) -
Primer:
C:\Program Files\Apache Tomcat\webapps\digna -
Preverite namestitev
- Osvežite ali ponovno naložite Tomcat upravljalno stran (http://localhost:8080)
-
Morali bi videti "digna" (ali izbrano ime) na seznamu nameščenih aplikacij
-
Dostop do nadzorne plošče
- Odprite brskalnik
- Pojdite na
http://localhost:8080/digna - 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¶
- Odprite Command Prompt kot administrator
- Desni klik na Command Prompt
-
Izberite "Run as Administrator"
-
Pomaknite se v imenik namestitve digna
-
Registrirajte storitev
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:
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¶
Za ustavitev storitve¶
Nasvet
Pred posodobitvijo datotek aplikacije vedno ustavite storitev.
Premik storitve v nov imenik¶
Če potrebujete premestitev namestitve digna:
-
Ustavite trenutno storitev in odstranite njeno registracijo
-
Premaknite datoteke aplikacije
-
Premaknite celotno mapo namestitve digna na novo lokacijo
-
Storitev znova registrirajte z nove lokacije
Ponovite vse vrednosti --address, --port ali --account, ki ste jih uporabili prvič — prejšnje registracije ni več.
- Zaženite storitev
Odstranitev storitve¶
-
Ustavite tekočo storitev
-
Odstranite registracijo storitve
Digna strežnik je zdaj odregistriran kot Windows storitev.
Nadgradnja na novo izdajo¶
Pred nadgradnjo¶
Najprej Preverite Vse Podatkovne Povezave
Od izdaje 2026.06 digna do vsake izvorne tehnologije dostopa prek ODBC. Prejšnje izdaje so ponujale izbiro med gonilnikom za posamezno tehnologijo in ODBC, izbrano s stikalom Use ODBC. Ekipa digna se je odločila graditi izključno na ODBC, ker en sam standardni vmesnik ponuja več kot nabor gonilnikov po meri:
- Preverjanje pristnosti — preverjanje pristnosti je del ODBC, zato lahko povezava uporabi vse, kar podpira njen gonilnik: gesla, žetone in PAT-e, Kerberos in Active Directory, MFA in enotno prijavo prek brskalnika, identitete v oblaku, odjemalčka potrdila in TLS. Nove metode pridejo s posodobitvijo gonilnika, namesto da bi čakali na izdajo digna.
- Gonilniki, ki jih vzdržujejo proizvajalci podatkovnih baz — proizvajalčev lastni gonilnik sledi novim različicam strežnika in varnostnim popravkom, vi pa ga lahko posodabljate po svojem urniku, neodvisno od digna.
- En sam način nastavljanja vsega — vsaka tehnologija je seznam lastnosti ključ/vrednost, z istim vmesnikom, istim šifriranjem občutljivih vrednosti in istim odpravljanjem težav, namesto drugačnega nabora polj za vsak vir.
- Nastavljanje in doseg — možnosti gonilnika, kot so časovne omejitve, nastavitve TLS, posredniški strežniki in velikosti prenosa, so na voljo za vsak vir, priključiti pa je mogoče vsako tehnologijo s skladnim gonilnikom ODBC, tudi takšno, za katero digna ne objavlja lastnega vodnika.
V praksi to pomeni, da stikala Use ODBC ter ločenih polj za gostitelja, vrata, bazo, uporabnika in geslo ni več. Vsako povezavo, ki še ne uporablja ODBC, je treba preklopiti na ODBC — samodejne pretvorbe ni, zato to načrtujte pred nadgradnjo:
- Preglejte vsako podatkovno povezavo, opredeljeno v vaši namestitvi, in si zapišite tiste, ki še ne uporabljajo ODBC — vsako od njih bo treba znova nastaviti.
- Na gostitelja digna namestite ustrezen gonilnik ODBC — povezave se odpirajo s strežnika, na katerem teče zaledje digna, in ne iz brskalnika. Glejte Namestitev Gonilnika ODBC na Gostitelja digna.
- Za vsako prizadeto povezavo pripravite lastnosti ODBC. Vodniki po tehnologijah za vsak vir navajajo preizkušen nabor lastnosti.
Po nadgradnji vsako prizadeto povezavo preklopite na ODBC in jo preizkusite z nadzorne plošče — glejte Ustvarjanje Podatkovne Povezave in Preizkušanje Povezave.
Povezave Databricks Legacy
Konektor Databricks Legacy je bil v tej izdaji odstranjen. Te povezave preselite na konektor Databricks.
Obvezno je ustvariti varnostno kopijo digna repozitorija
Pred nadgradnjo digna varnostno kopirajte svoj repozitorij (PostgreSQL), da se zaščitite pred izgubo podatkov. Varnostna kopija omogoča obnovitev, če pride do nepričakovanih težav med nadgradnjo.
Postopek nadgradnje¶
Korak 1: Ustavite staro storitev in odstranite njeno registracijo¶
Če digna teče kot Windows storitev, jo ustavite z batch datotekami vaše trenutne namestitve — ukazi digna windows pripadajo novi izdaji in še niso na voljo:
Nato odstranite registracijo storitve, spet s staro batch datoteko. Registracija kaže na staro izvršljivo datoteko in njene skripte, ki ju ta nadgradnja zamenja, zato je ni mogoče znova uporabiti:
Registracijo odstranite, preden karkoli preimenujete
uninstall_service.bat je v mapi bin, ki jo boste kmalu preimenovali, in je edino, kar lahko odstrani registracijo, ki jo je ustvarila. Zaženite jo, dokler je stara namestitev še na svojem mestu. Če je mapa že preimenovana, ji vrnite prvotno ime, odstranite registracijo in nato nadaljujte.
Zapišite si račun, pod katerim je tekla storitev, ter naslov in vrata, na katerih je stregla — potrebovali jih boste v koraku 9.
Korak 2: Varnostna Kopija Trenutne Namestitve¶
V namestitvenem imeniku digna preimenujte mape trenutne namestitve, da bo novo izdajo mogoče namestiti ob njih:
dignabackend in dignacli nista več v uporabi
Od izdaje 2026.06 dignabackend in dignacli nadomešča ena sama izvršljiva datoteka digna, ki združuje zaledje in CLI. Mapi dignabackend_old in dignacli_old obdržite le, dokler ne preverite nadgradnje — nato ju lahko obe izbrišete. Mapo dashboard_old obdržite, dokler iz nje ne obnovite svojih konfiguracijskih datotek (glejte korak 4). Odstrani se tudi mapa bin: njene batch datoteke so upravljale staro storitev in izdaja 2026.06 jih ne vsebuje, zato potem, ko je bila registracija storitve v koraku 1 odstranjena, le še zavajajo.
Korak 3: Razpakirajte in namestite novo verzijo¶
- Razpakirajte nov ZIP paket z namestitvijo digna
- Kopirajte novo izvršljivo datoteko
dignain mapodashboardv vaš 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¶
Izdaja 2026.06 spreminja config.toml
Tri nastavitve so nove in obvezne, dve pa nista več v uporabi. config.toml, prenešen iz prejšnje izdaje, novih nastavitev ne vsebuje in digna se ne bo zagnal, dokler manjkajo. V obstoječi config.toml dodajte naslednje:
[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"
[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Dva ključa [base] dodajte v svojo obstoječo sekcijo [base], sekcijo [encryption] pa dodajte kot novo. Nato iz [app] odstranite nastavitvi, ki nista več v uporabi, digna_APP_HOST in digna_APP_PORT — naslov in vrata strežnik zdaj dobi iz digna serve.
Kaj počne posamezna nastavitev, je opisano v razdelku Konfiguracija Zaledja.
Enotna Prijava: Oblika [oidc_clients] se je Spremenila
Izdaja 2026.06 nadomesti polje tabel z eno tabelo na ponudnika, poimenovano po ključu ponudnika. DIGNA_OIDC_KEY odpade — ključ je zdaj del glave razdelka.
Prej:
[[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'
Potem:
[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'
Razdelek ponovite za vsakega ponudnika in vsak ključ ohranite enak vrednosti key v datoteki dashboard_config.toml. digna config check javi oidc_clients kot FAILED, dokler stara oblika ostaja. 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: Preverjanje Konfiguracije¶
Preden se dotaknete repozitorija, potrdite, da je posodobljeni config.toml popoln:
Vsaka sekcija mora javiti OK. Odpravite vse, kar je javljeno kot FAILED, in pred nadaljevanjem ukaz poženite znova.
Korak 7: Zamenjajte licenčno datoteko¶
Vsaka izdaja je licencirana ločeno. Datoteko license.toml, ki vam jo je ekipa digna posredovala za to izdajo, kopirajte v imenik namestitve in z njo zamenjajte staro:
Ne obdržite prejšnje licence
Datoteka license.toml, izdana za prejšnjo izdajo, ne velja za to, in vsak ukaz, ki preverja licenco — user, inspection, repo — se prekine, še preden se dotakne repozitorija, če preverjanje ne uspe. Preden nadaljujete, jo preverite:
Korak 8: Nadgradite shemo repozitorija¶
Pomaknite se v imenik namestitve digna in zaženite:
To posodobi PostgreSQL shemo na najnovejšo različico, pri tem pa ohrani vse obstoječe podatke.
Korak 9: Registrirajte in zaženite storitev¶
Stara registracija je bila odstranjena v koraku 1, zato se storitev registrira znova — tokrat z izvršljivo datoteko digna, ki nima batch datotek:
Za --address in --port navedite vrednosti, na katerih je stregla stara storitev, razen če želite nove privzete vrednosti 127.0.0.1 in 8000; zabeležijo se v registraciji in se ne berejo več iz config.toml. Če je stara storitev tekla pod domenskim računom, dodajte --account in --password. Celoten seznam možnosti je v razdelku Poganjanje digna kot Windows storitve.
Če poganjate ročno, ponovno zaženite strežnik:
Če uporabljate IIS ali Tomcat, ponovno zaženite ustrezen spletni strežnik.
Korak 10: Preverite nadgradnjo¶
- Dostopajte do digna nadzorne plošče
- Preverite, ali se vmesnik nalaga pravilno
- Preverite strežniške zapise za morebitne napake
- Vsako povezavo, ki ODBC še ni uporabljala, preklopite na ODBC, nato preizkusite vse povezave — glejte Preizkušanje Povezave