Skoči na vsebino

Vodnik za namestitev na Windows za digna Release 2026.06

Release: 2026.06

Zadnja posodobitev: 30. avgusta 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.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:

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

[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_BACKUP_COUNT = 10
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:

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

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

  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

Videti bi morali potrditev, da je povezava vzpostavljena (samo repozitorij še ni inicializiran).

Korak 4: Namestite shemo repozitorija

V istem imeniku zaženite:

digna repo install

Ta ukaz namesti potrebne tabele in shemo v vašo PostgreSQL bazo.

Korak 5: Ustvarite administratorskega uporabnika

  1. Odprite novo okno Command Prompt
  2. Pomaknite se v imenik namestitve digna
  3. Zaženite naslednji ukaz za ustvarjanje administratorskega uporabnika:
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 - --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

  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

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:

  1. 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.
  2. 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.
  3. 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:

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

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:

uninstall_service.bat

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:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old
# Rename the folder containing dignacli
ren dignacli dignacli_old
# Rename dashboard
ren dashboard dashboard_old

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

  1. Razpakirajte nov ZIP paket z namestitvijo digna
  2. Kopirajte novo izvršljivo datoteko digna in mapo dashboard v 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

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

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:

digna config check

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:

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

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:

digna license check

Korak 8: Nadgradite shemo repozitorija

Pomaknite se v imenik namestitve digna in zaženite:

digna repo upgrade

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:

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

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

Če uporabljate IIS ali Tomcat, ponovno zaženite ustrezen spletni strežnik.

Korak 10: Preverite nadgradnjo

  1. Dostopajte do digna nadzorne plošče
  2. Preverite, ali se vmesnik nalaga pravilno
  3. Preverite strežniške zapise za morebitne napake
  4. Vsako povezavo, ki ODBC še ni uporabljala, preklopite na ODBC, nato preizkusite vse povezave — glejte Preizkušanje Povezave