Keri sisuni

Windowsi paigaldusjuhend digna väljalaske 2026.11 jaoks

Väljalase: 2026.11

Viimati uuendatud: 7. november 2026


Sisu

  1. Sissejuhatus
  2. Süsteeminõuded
  3. Enne paigaldust tehtavad toimingud
  4. PostgreSQL serveri seadistus
  5. Veebiserveri konfiguratsioon
  6. Esmane paigaldus
  7. Backendi konfiguratsioon
  8. Juhtpaneeli konfiguratsioon
  9. digna käitamine Windowsi teenusena
  10. Uuendamine uuele versioonile

Sissejuhatus

Teave digna kohta

digna on kõikehõlmav AI-käitusel põhinev platvorm, mis on loodud andmekvaliteedi haldamise optimeerimiseks erinevates andmekeskkondades nagu andmelaod, andmejärved ja lakehoused. Suure skaleeritavuse ja kohandatavusega digna tegeleb kaasaegsete andmeprobleemidega automatiseerimise, reaalajas monitooringu ja anomaaliate tuvastuse kaudu.

digna koosneb kahest põhilisest komponendist:

  • digna: rakenduse tuum, mis vastutab andmete töötlemise ja kvaliteedikontrollide läbiviimise eest. See ühendab taustasüsteemi ja käsurealiidese üheks käivitatavaks failiks ning asendab varasemate väljalasete eraldi programmid dignabackend ja dignacli.
  • dignadashboard: veebipõhine liides, mis majutatakse veebiserveris ja pakub kasutajasõbralikku viisi digna platvormiga suhtlemiseks ning andmekvaliteedi mõõdikute visualiseerimiseks.

Mis on uut väljalaskes 2026.11

See väljalase toob kaasa uued moodulid digna Data Reconciliation ja digna Agentic (koos serveriga digna MCP Server) ning komponendi digna Engine, mis suudab andmeid profileerida digna sees ja kontrollida viidete terviklikkust eri andmebaasitehnoloogiate vahel. Täielikud andmed leiate väljalaske märkmetest.

Paigalduse jaoks toob väljalase uue hoidla migratsioonimehhanismi, komponendi digna Engine jaoks valikulise sektsiooni [duckdb] failis config.toml ning uue litsentsifaili. Neid kõiki käsitleb uuendamise jaotis.

Otsite macOS-i või Linuxi?

See juhend käsitleb Windowsi. Muude platvormide jaoks vaadake macOS-i paigaldusjuhendit või Linuxi paigaldusjuhendit.


Süsteeminõuded

Enne paigalduse alustamist veenduge, et teie süsteem vastab järgmistele miinimumnõuetele:

Nõue Spetsifikatsioon
Operatsioonisüsteem Windows Server või Windows 10/11
Mälu (minimaalne paigaldus) 16 GB RAM
Kettaruumi 10 GB vaba salvestusruumi
Andmebaas PostgreSQL Server 12 või uuem
Veebiserver IIS, Apache Tomcat või ekvivalent

digna Engine

Andmebaasiühendusi, mille profileerimise asukoht on digna Engine, profileeritakse digna hostis endas. Planeerige nende jaoks lisamälu ja -kettaruumi, vt [duckdb] sektsioon.

Andmebaasi paigaldusvalikud

Kui PostgreSQL on juba paigaldatud: Võite oma olemasolevale PostgreSQL-serverile lisada uue andmebaasi digna jaoks.

Kui paigaldate PostgreSQL-i samasse masinasse, kus töötab digna:

Soovitatavad spetsifikatsioonid

  • Mälu: 32 GB RAM (16 GB asemel)
  • Kettaruumi: 50 GB vaba salvestusruumi (10 GB asemel)

Need kõrgemad spetsifikatsioonid võimaldavad dignal ja PostgreSQL-il samaaegselt tõhusalt töötada.


Enne paigaldust tehtavad toimingud

Enne digna paigaldamist veenduge, et kaks peamist eeltingimust on täidetud:

  1. PostgreSQL Server – arvutatud mõõdikute ja jõudlusandmete salvestamiseks
  2. Veebiserver – digna juhtpaneeli majutamiseks

Kui need komponendid pole veel seadistatud, järgige allolevaid lõike nende paigaldamiseks ja konfiguratsiooniks.


PostgreSQL serveri seadistus

Kui teil on PostgreSQL juba olemas

Kui PostgreSQL on juba paigaldatud ja töötab teie lokaalses masinas või kasutate hallatavat kaug-PostgreSQL-serverit, võite liikuda otse järgmisse jaotisse: veebiserveri konfiguratsioon.

PostgreSQL-i paigaldamine

Järgige neid samme PostgreSQL-i paigaldamiseks Windowsi:

Samm 1: Laadige alla PostgreSQL

  1. Minge lehele PostgreSQL Downloads page
  2. Valige Windows
  3. Laadige alla viimane installeerija

Samm 2: Käivitage installeerija

  1. Topeltklõpsake alla laaditud installeerijafailil
  2. Järgige seadistusviisardi juhiseid

Samm 3: Valige paigalduse kataloog

Valige kataloog, kuhu PostgreSQL paigaldatakse. Vaikekoht on tavaliselt sobiv.

Samm 4: Valige komponendid

Tavalise paigalduse jaoks jätke vaikimisi valitud komponendid.

Samm 5: Määrake PostgreSQL-i superkasutaja parool

Sisestage ja kinnitage parool PostgreSQL-i superkasutajale (postgres). Salvestage see parool turvaliselt — teil on seda hiljem vaja.

Samm 6: Konfigureerige pordinumber

Vaikeport PostgreSQL-ile on 5432. Võite kasutada vaikimisi või määrata vajadusel teise pordi.

Vihje

Kui port 5432 on juba kasutusel, valige alternatiivne port ja märkige see hilisemaks konfiguratsiooniks üles.

Samm 7: Valige lokaliseerimine

Valige andmebaasi lokaliseerimine. Vaikeväärtus sobib tavaliselt enamiku paigalduste jaoks.

Samm 8: Lõpetage paigaldus

Klõpsake ülejäänud sammudes Next, seejärel Finish.

Samm 9: Kontrollige paigaldust

Avage käsuviip ja kontrollige, kas PostgreSQL on paigaldatud:

psql --version

Kui paigaldus õnnestus, kuvatakse PostgreSQL-i versioon.


Veebiserveri konfiguratsioon

digna vajab veebiserverit juhtpaneeli majutamiseks. Valige üks järgmistest võimalustest:

Vajate ainult ühe neist serveritest paigaldamist ja konfiguratsiooni.

IIS-i seadistus

Ülevaade

Internet Information Services (IIS) on Microsofti veebiserver veebisaitide ja veebirakenduste majutamiseks.

IIS-i lubamine

  1. Avage juhtpaneel
  2. Vajutage Win + R
  3. Tippige control ja vajutage Enter

  4. Minge Windowsi funktsioonide juurde

  5. Klõpsake Programs
  6. Valige Turn Windows features on or off

  7. Luba Internet Information Services

  8. Kerige alla ja leidke Internet Information Services (IIS)
  9. Märkige ruut selle lubamiseks
  10. Klõpsake +, et laiendada ja veenduda, et järgmised alamkomponendid on valitud:

    • Web Management Tools
    • World Wide Web Services
  11. Klõpsake OK, et muudatused rakendada

  12. Kontrollige IIS-i paigaldust

  13. Avage brauser
  14. Minge aadressile http://localhost
  15. Te peaksite nägema IIS-i tervituse lehte

Nõutav: URL Rewrite moodul

IIS nõuab URL Rewrite komponenti. Laadige see alla ja paigaldage sellelt official Microsoft page.

Nõutav: MIME-tüüp Markdown-failide jaoks

Et tagada Markdown-failide (.md) korrektne teenindamine IIS-is:

  1. Avage IIS Manager (vajutage Win + R, tippige inetmgr, vajutage Enter)
  2. Minge Your Site > MIME Types
  3. Klõpsake Add...
  4. Konfigureerige:
  5. File name extension: .md
  6. MIME type: text/markdown

Tähtis

Ilma selle säteta ei pruugi .md faile õigesti teenindada.


Apache Tomcati seadistus

Ülevaade

Apache Tomcat on avatud lähtekoodiga Java servlet-konteiner ja veebiserver.

Paigaldamine

  1. Laadige alla Apache Tomcat
  2. Minge lehele Apache Tomcat Downloads
  3. Laadige alla Windowsi ZIP-versioon

  4. Pakkige arhiiv lahti

  5. Pakkige ZIP-fail lahti sobivasse kataloogi
  6. Näide: C:\Program Files\Apache Tomcat

  7. Kontrollige, et Tomcat töötab

  8. Avage brauser
  9. Minge aadressile http://localhost:8080
  10. Te peaksite nägema Apache Tomcati tervituslehte

Vihje

Apache Tomcat peaks enamasti käivituma automaatselt pärast paigaldust. Kui see ei käivitu, minge bin kausta ja käivitage startup.bat.


Esmane paigaldus

Samm 1: Looge digna andmehoidla skeem

digna andmehoidla salvestab kõik digna poolt arvutatud mõõdikud. See toimib analüütilise ja jõudlusandmete keskse andmebaasina.

Looge skeem ja kasutaja

Avage oma PostgreSQL klient (pgAdmin, psql või sarnane) ja täitke järgmised SQL-käsud:

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

Asendage järgmised kohatäitjad:

  • <digna_repo_schema> — Teie soovitud skeemi nimi (näiteks dignarepo)
  • <digna_repo_user> — Teie soovitud kasutajanimi (näiteks digna_user)
  • <digna_repo_password> — Turvaline parool selle kasutaja jaoks

Näide:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Parim praktika

Kasutage andmebaasi kasutajate jaoks tugevaid, keerukaid paroole. Vältige lihtsalt äraarvatavaid tunnuseid.


Samm 2: Pakkige digna paigalduspakett lahti

  1. Leidke teile antud digna paigaldamise ZIP-fail
  2. Pakkige see soovitud paigalduskataloogi
  3. Pärast lahtipakkimist peaksite nägema järgmisi üksusi:
  4. dashboard/ — Veebijuhtpaneeli liides
  5. digna — Peamine täitmisfail (backend + CLI kombineeritud)

Konfiguratsiooni- ja litsentsifailid ei ole paketis

Paigaldusega ei kaasne ei config.toml ega dashboard/dashboard_config.toml — mõlemad loote ise, jaotistes Taustasüsteemi konfigureerimine ja Juhtpaneeli konfiguratsioon. Ka license.toml ei ole kaasas; digna tarnib selle eraldi, nagu kirjeldab samm 3.

Samm 3: Paigaldage litsentsifail

Tähtis

Litsentsifail EI OLE paigalduspaketis ja see antakse teile eraldi digna poolt.

  1. Leidke teile antud license.toml fail
  2. Kopeerige see digna paigalduskausta juurkausta (kuhu on paigaldatud config.toml ja digna täitmisfail)

Miks see oluline on: Litsentsifail sisaldab teie kliendiandmeid, litsentsi aegumiskuupäeva ja digitaalset allkirja. Ärge muutke seda faili — kõik muudatused annuleerivad selle.

Kataloogistruktuur pärast seadistust:

digna_installation/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
└── dashboard/          (web interface)
    └── (dashboard files)

Backendi konfiguratsioon

Samm 1: Looge ja redigeerige konfiguratsioonifaili

Kaustas on teile antud config_template.toml fail. Te peate selle ümber nimetama config.toml-ks.

Asukoht: digna_installation/config.toml

Avage config.toml tekstiredaktoris ja kohandage allpool toodud sektsioone.

[app] sektsioon

See sektsioon seadistab juhtpaneeli ja backendi vahelist päritoluülest ressursijagamist (CORS):

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true
Parameeter Väärtus Märkused
DIGNA_APP_CORS_ALLOW_ORIGINS Juhtpaneeli URL-id URL-id, millelt juhtpaneel serveeritakse. Brauseri päringud mis tahes muult päritolult lükatakse tagasi
DIGNA_APP_CORS_ALLOW_CREDENTIALS true Nõutav, et brauser saadaks igas päringus kaasa sessiooniküpsise

Sektsioon [app] on valikuline

Alates Release 2026.11-st võib mõlemad võtmed ja kogu sektsiooni [app] ära jätta. See on õige seadistus, kui pöördpuhverserver (reverse proxy) serveerib juhtpaneeli ja backendi ühe päritolu all: brauser ei tee siis päritoluüleseid päringuid ja vaikimisi pole ühtki lubatud.

[repo] sektsioon

See sektsioon konfigureerib ühenduse PostgreSQL andmebaasiga:

[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
Parameeter Väärtus Märkused
DIGNA_REPO_HOST localhost või IP PostgreSQL serveri hostinimi/IP
DIGNA_REPO_PORT 5432 (vaikimisi) PostgreSQL port
DIGNA_REPO_DB postgres Andmebaasi nimi
DIGNA_REPO_SCHEMA dignarepo Varem loodud skeem
DIGNA_REPO_USER digna_user PostgreSQL seadistuses loodud kasutaja
DIGNA_REPO_PASSWORD Teie parool Parool, mis määrati skeemi loomisel
DIGNA_REPO_SSLMODE prefer (vaikimisi) Valikuline. PostgreSQL-i SSL-režiim: disable, allow, prefer, require, verify-ca või verify-full
DIGNA_REPO_NUM_CONNS 16 (vaikimisi) Valikuline. Ühenduste arv, mida digna hoidlaga avatuna hoiab

[base] sektsioon

See sektsioon sisaldab turbe-, küpsise- ja inspekteerimisseadeid:

[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
Parameeter Väärtus Märkused
DIGNA_FERNET_KEY Ülal näidatud väärtus Varasemate väljalasete kasutatud krüpteerimise võti. See peab olemas olema; jätke näidatud väärtus
DIGNA_COOKIE_DOMAIN localhost Host, mille all juhtpaneel on kättesaadav. "" ei määra domeeni, mis on õige puhverserveri taga, mis serveerib juhtpaneeli ja backendi ühe päritolu all
DIGNA_COOKIE_SECURE false (HTTP) / true (HTTPS) Peab olema true alati, kui digna serveeritakse üle HTTPS-i
DIGNA_COOKIE_HTTPONLY true Hoiab sessiooniküpsise skriptidele kättesaamatuna
DIGNA_TOKEN_EXPIRES_IN 86400 (24 tundi) Sessiooni aegumisaeg sekundites
DIGNA_MAX_WORKERS CPU tuumade arv - 1 Samaaegselt töötada võivate inspekteerimiste arv
DIGNA_FRONTEND_BASEURL Juhtpaneeli URL Kohustuslik. Kasutatakse teavitussõnumite linkides, seega peab see olema URL, mida adressaadid saavad avada
DIGNA_SOURCE_QUERY_TIMEOUT_SEC 3600 (vaikimisi) Valikuline. Sekundid, mille jooksul võib üks päring lähteandmebaasi vastu töötada, enne kui see katkestatakse; 0 lülitab ajalõpu välja
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC 30 (vaikimisi) Valikuline. Sekundid, mille jooksul oodatakse ühendust lähteandmebaasiga; 0 ootab piiramatult

[encryption] sektsioon

See sektsioon sisaldab võtit, millega krüpteeritakse hoidlas talletatud tundlikud väärtused. See on kohustuslik — config check teatab sektsioonist [encryption] FAILED, kui võti puudub.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Parameeter Väärtus Märkused
DIGNA_ENCRYPTION_KEY Base64-kodeeritud võti Krüpteerib digna hoidlas talletatud tundlikud väärtused

Kaitske faili config.toml

See võti on fikseeritud väärtus, mis on kõigis digna paigaldustes ühesugune, ja just see dekrüpteerib teie hoidla tundlikud väärtused. Piirake config.toml juurdepääs kontoga, mille all digna töötab, hoidke fail versioonihaldusest ja jagatud ketastest eemal ning jätke see välja igast varukoopiast, mida hoitakse vähem turvaliselt kui hoidlat ennast.

[logging] sektsioon

See sektsioon konfigureerib logimise käitumist:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30
Parameeter Väärtus Märkused
DIGNA_LOGGING_MODE INFO või DEBUG INFO tootmisse, DEBUG tõrkeotsingu jaoks. Aktsepteeritakse ka TRACE, WARN ja ERROR
DIGNA_LOGGING_DIR logs (vaikimisi) Valikuline. Roteeruvate logifailide kataloog, suhteline töökataloogi suhtes
DIGNA_LOGGING_MAX_FILES 30 (vaikimisi) Valikuline. Säilitatavate roteeritud logifailide arv

Teenusena käitamisel säilitage logikataloog

Windowsi teenusel ei ole konsooli, seega on logifailid ainus ülestähendus sellest, mida teenus teeb. Ärge seadke DIGNA_LOGGING_DIR väärtuseks tühja stringi, sest see lülitab logifailid välja.

[duckdb] sektsioon (valikuline)

Uus väljalaskes Release 2026.11. See sektsioon määrab ressursid komponendile digna Engine, mis profileerib andmeid digna sees nende andmebaasiühenduste puhul, mille profileerimise asukoht on digna Engine, ning käitab viidete terviklikkuse kontrolle eri andmebaasiühendustel asuvate andmeallikate vahel. Vaadake Profileerimise asukoht.

Sektsioon on valikuline. Ilma selleta kehtivad allolevad vaikeväärtused.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "C:\\path\\to\\digna\\tmp"
Parameeter Väärtus Märkused
DIGNA_DUCKDB_MEMORY_LIMIT_MB 1024 (vaikimisi) Mälu MB-des, mida üks digna Engine'i käivitus võib kasutada. Korraga võib aktiivne olla kuni DIGNA_MAX_WORKERS käivitust
DIGNA_DUCKDB_TEMP_DIRECTORY Vaikimisi: digna käitava konto ajutine kataloog (%TEMP%) Ajutiste failide kataloog, kui andmed mällu ei mahu

digna Engine'i ressursside planeerimine

Planeerige digna hostis lisaks digna enda kasutatavale mälule kuni DIGNA_MAX_WORKERS × DIGNA_DUCKDB_MEMORY_LIMIT_MB mälu ning ajutises kataloogis piisavalt vaba kettaruumi, et sinna mahuksid digna Engine'i kasutavate andmeallikate suurima inspekteeritava kuupäeva andmed. Suunake DIGNA_DUCKDB_TEMP_DIRECTORY sellise ruumiga kettale, kuhu digna käitaval kontol on kirjutusõigus:

mkdir C:\path\to\digna\tmp

Seda sektsiooni on vaja ainult siis, kui vähemalt üks andmebaasiühendus kasutab digna Engine'it või kui viidete terviklikkuse kontroll võrdleb eri ühendustel asuvaid andmeallikaid.


Samm 2: Kontrollige konfiguratsiooni

Enne hoidla lähtestamist kontrollige, kas config.toml on täielik ja korrektselt üles ehitatud. Käivitage oma digna paigalduskataloogis:

digna config check

Iga sektsiooni kontrollitakse eraldi, nii et üks viga ei varja teiste olekut:

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

Parandage kõik, millest teatatakse FAILED, ja käivitage käsk enne jätkamist uuesti. Hoiatus WARNING rea Unknown keys all loetleb failis config.toml võtmed, mida digna ei loe; neil pole mingit mõju, seega eemaldage need või parandage nende kirjapilt. Täielik valikute loend on CLI viites.

Samm 3: Initsialiseeri andmehoidla ühendus

  1. Avage käsuviip
  2. Minge oma digna paigalduskausta (kus asuvad config.toml ja digna täitmisfail)
  3. Käivitage ühenduse test:
digna repo check

Uue skeemi puhul loob käsk ühenduse ja teatab seejärel, et hoidlat pole veel paigaldatud:

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

Selles etapis on see oodatud tulemus: see kinnitab, et digna jõuab PostgreSQL-i ja skeemini. Ühenduse- või autentimisviga viitab seevastu sektsioonile [repo] või PostgreSQL-i seadistusele.

Samm 4: Paigaldage andmehoidla skeem

Selles samas kataloogis käivitage:

digna repo upgrade

See käsk paigaldab hoidla skeemi vajalikud tabelid ja lõpetab teatega:

✅ Repo schema 'dignarepo' is up to date.

repo upgrade paigaldab ja uuendab

Alates Release 2026.11-st paigaldab repo upgrade uue hoidla ja uuendab olemasoleva. repo install töötab endiselt sama käsu teise nimena.

Samm 5: Looge administraatorkasutaja

  1. Avage uus käsuviip
  2. Minge oma digna paigalduskausta
  3. Käivitage järgmine käsk administraatori kasutaja loomiseks:
digna user add <email> <password> "<display_name>" --admin

Näide:

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

See loob kasutaja täisadministratiivsete õigustega.

Parim praktika

Kasutage tugevat parooli, mis sisaldab suur- ja väiketähti, numbreid ja erimärke.


Samm 6: Käivitage digna server

Digna paigalduskaustas käivitage server:

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

Parameetrid: - --address — serveri hostinimi/IP (vaikimisi 127.0.0.1) - --port — serveri port (vaikimisi 8000)

Kui server töötab, kuvab see aadressi, millel ta kuulab:

Server running on http://127.0.0.1:8082

Server hoiab terminali hõivatuna

serve töötab esiplaanil ja jätkab, kuni peatate selle klahvidega Ctrl+C. Jätke see tööle, kuni seadistuse lõpetate; automaatseks käivitamiseks alglaadimisel vaadake digna käitamine Windowsi teenusena.

Juhtpaneeli konfiguratsioon

Samm 1: Paigutage juhtpaneel veebiserverisse

digna juhtpaneel loeb oma konfiguratsiooni failist dashboard/dashboard_config.toml. See fail ei ole paigaldusega kaasas — loote selle kataloogi dashboard/ juhtpaneeli failide kõrvale.

Selle sisu on kirjeldatud jaotises Ühekordne sisselogimine (SSO), kus faili ka vaja läheb: see sisaldab juhtpaneeli pakutavaid sisselogimisvalikuid ning mitme instantsi juurutuste puhul ühendust backendiga.

Valige veebiserver ja järgige vastavaid juurutusjuhiseid.

Paigutamine IIS-i

  1. Avage IIS Manager
  2. Vajutage Win + R, tippige inetmgr, vajutage Enter

  3. Looge uus veebisait

  4. Vasakul paneelil paremklõpsake Sites
  5. Valige Add Website...

  6. Konfigureerige veebisait

  7. Site Name: Sisestage nimi (nt "dignaDashboard")
  8. Physical Path: Klõpsake Browse ja valige dashboard kaust
  9. Binding: Määrake IP-aadress ja port (vaikeport HTTP jaoks on 80, HTTPS jaoks 443)

  10. Käivitage veebisait

  11. Klõpsake OK, et saiti luua
  12. Paremklõpsake uuel saidil ja valige Start

  13. Testige paigaldust

  14. Avage brauser
  15. Minge aadressile http://localhost (või teie konfigureeritud URL)
  16. Te peaksite nägema digna juhtpaneeli sisselogimislehte

Paigutamine Apache Tomcati

  1. Kopeerige juhtpaneel Tomcati
  2. Kopeerige dashboard kaust Tomcati webapps kataloogi
  3. Nimetage see vajadusel ümber (nt digna)
  4. Näide: C:\Program Files\Apache Tomcat\webapps\digna

  5. Kontrollige juurutust

  6. Värskendage või laadige uuesti Tomcati halduslehte (http://localhost:8080)
  7. Te peaksite nägema loendis "digna" (või valitud nime)

  8. Juurdepääs juhtpaneelile

  9. Avage brauser
  10. Minge aadressile http://localhost:8080/digna
  11. Te peaksite nägema digna juhtpaneeli sisselogimislehte

digna käitamine Windowsi teenusena

Miks kasutada Windowsi teenust?

digna backendi käitamine Windowsi teenusena tagab: - Teenuse automaatse käivitumise serveri buutimisel - Taustal töötamise ilma avatud käsuviibata - Automaatse taaskäivituse jooksmisel - Halduse võimaluse Windows Services kaudu

Käsud windows

Teenust haldab käivitatav fail digna ise, alamkäskude digna windows kaudu. Käivitatavaid batch-faile ei ole.

Käsk Otstarve
digna windows install Registreerib digna Windowsi teenusena
digna windows start Käivitab registreeritud teenuse
digna windows stop Peatab töötava teenuse
digna windows uninstall Eemaldab teenuse registreeringu

Nõutud administraatoriõigused

Kõik neli käsku tuleb käivitada administraatorina avatud käsuviibas.

Iga käsk aktsepteerib valikut --name, et pöörduda teenuse poole, mis on registreeritud vaikimisi nimest erineva nime all. Valikute täielik loend on CLI teatmikus.

Teenuse paigaldamine

  1. Avage käsuviip administraatorina
  2. Paremklõpsake Command Prompt
  3. Valige "Run as Administrator"

  4. Minge oma digna paigalduskausta

    cd C:\path\to\digna
    

  5. Registreerige teenus

    digna windows install
    

Määrake aadress ja port, kui vaikeväärtused teile ei sobi

install salvestab aadressi ja pordi teenuse registreeringusse ning teenus seotakse täpselt salvestatud väärtustega. Vaikeväärtused on 127.0.0.1 ja 8000, mis võtavad ühendusi vastu ainult masinalt endalt. Teises hostis asuv juhtpaneel sinna ei ulatu, seega andke aadress, mida backend peab kuulama:

digna windows install --address 0.0.0.0 --port 8082

Neid väärtusi ei loeta failist config.toml. Nende hilisemaks muutmiseks eemaldage teenus ja paigaldage see uute väärtustega uuesti.

Teenus registreeritakse automaatse käivitusega, seega käivitub see koos Windowsiga. Kohe see ei käivitu — vaadake järgmist jaotist.

Paigaldusvalikud

Valik Vaikeväärtus Otstarve
--name digna Nimi, mille all teenus registreeritakse
--display-name digna Nimi, mida kuvatakse services.msc-s
--description digna data quality backend Kirjeldus, mida kuvatakse services.msc-s
--address 127.0.0.1 Aadress, millega teenus oma API seob
--port 8000 Port, millega teenus oma API seob
--working-dir käivitatava faili digna kataloog Kataloog, milles asuvad config.toml ja license.toml ning mille teenus teeb oma töökataloogiks
--start-type auto auto käivitub koos Windowsiga, manual käivitub ainult nõudmisel, disabled registreerib teenuse, kuid keeldub seda käivitamast
--account LocalSystem Konto, mille all teenus töötab, nt DOMAIN\user või .\user
--password Konto --account parool

Käitamine domeenikonto all

Kontol LocalSystem puudub võrguidentiteet, seega ebaõnnestuvad Windowsi autentimine SQL Serveris ja igasugune juurdepääs võrgukaustale. Kui teenus peab ressurssidele juurde pääsema kindla kasutajana, paigaldage see valikutega --account ja --password.

Teenuse käivitamine ja peatamine

Teenuse käivitamiseks

digna windows start

Teenuse peatamiseks

digna windows stop

Vihje

Enne rakenduse failide uuendamist peatage teenus alati.

Teenuse liigutamine uude kataloogi

Kui peate digna paigalduskausta teisaldama:

  1. Peatage praegune teenus ja eemaldage selle registreering

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

  2. Liigutage rakenduse failid

  3. Liigutage kogu digna paigalduskaust uude asukohta

  4. Registreerige teenus uuest asukohast uuesti

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

Korrake kõiki --address, --port või --account väärtusi, mida esimesel korral kasutasite — eelmine registreering on kadunud.

  1. Käivitage teenus
    digna windows start
    

Teenuse eemaldamine

  1. Peatage jooksvalt olev teenus

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

  2. Eemaldage teenuse registreering

    digna windows uninstall
    

Digna server on nüüd registrist eemaldatud.


Uuendamine uuele versioonile

See jaotis uuendab Release 2026.06 paigalduse versioonile Release 2026.11. Kui teie paigaldus on vanem, lugege kõigepealt jaotist Uuendamine väljalaskest, mis on vanem kui 2026.06.

Enne uuendamist

digna andmehoidla varundamine on kohustuslik

Enne digna uuendamist varundage oma andmehoidla (PostgreSQL), et kaitsta andmete kaotsimineku eest. Varukoopia tagab taastumise juhuks, kui uuendamisel tekib ootamatuid probleeme.

Release 2026.11 litsentsifaili taotlemine

Release 2026.11 vajab uut faili license.toml. Taotlege see digna meeskonnalt enne alustamist ja hoidke see sammu 7 jaoks valmis.

Uuendamine väljalaskest, mis on vanem kui 2026.06

Release 2026.06 tõi kolm muudatust, mis kehtivad endiselt, kui uuendate vanema paigalduse otse versioonile 2026.11:

  • Ainult ODBC. digna jõuab iga lähtetehnoloogiani ODBC kaudu. Iga andmebaasiühendus, mis veel ODBC-d ei kasuta, tuleb pärast uuendamist ODBC-le üle viia; automaatset teisendust ei ole. Paigaldage ODBC draiverid digna hostile eelnevalt, vt ODBC draiveri paigaldamine digna hostile, ning hoidke iga ühenduse omadused tehnoloogiajuhenditest valmis. Databricks Legacy konnektorit enam ei ole; viige need ühendused üle Databricks konnektorile.
  • Üks käivitatav fail. dignabackend ja dignacli on asendatud üheainsa käivitatava failiga digna, mis ühendab backendi ja CLI.
  • config.toml. Sektsioon [encryption] on kohustuslik ning DIGNA_APP_HOST ja DIGNA_APP_PORT enam ei loeta: server võtab oma aadressi ja pordi käsult digna serve. Võrrelge oma faili jaotisega Backendi konfiguratsioon.

Allolevad sammud toovad välja, kus vanem paigaldus vajab midagi muud. Sammu 8 hoidla uuendus viib mis tahes varasema väljalaske hoidla otse versioonile 2026.11.

Uuendusprotsess

Samm 1: Peatage digna teenus

Avage käsuviip administraatorina ja peatage teenus praeguse paigalduse käivitatava failiga digna:

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

Teenus jääb registreerituks. Uus käivitatav fail asub samas kataloogis vana asemel, seega osutab registreering jätkuvalt õigele failile.

Kui digna töötab esiplaanil, vajutage selle käsuviiba aknas Ctrl+C.

Uuendamine väljalaskest, mis on vanem kui 2026.06

Vanemad väljalasked kui 2026.06 registreerisid teenuse batch-failidega. Peatage teenus ja eemaldage selle registreering praeguse paigalduse batch-failidega, enne kui sammus 2 midagi ümber nimetate:

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

Pange kirja konto, mille all teenus töötas, ning aadress ja port, millel see teenindas. Sammus 9 registreerite teenuse uuesti.

Samm 2: Varundage praegune paigaldus

Nimetage oma digna paigalduskataloogis praeguse paigalduse käivitatav fail ja kaust dashboard ümber, et uut väljalaset saaks nende kõrvale paigaldada:

cd C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

Hoidke digna_old.exe alles, kuni olete uuenduse kontrollinud, ja dashboard_old, kuni olete sellest oma konfiguratsioonifailid taastanud (vt samm 4). Seejärel võite mõlemad kustutada.

Uuendamine väljalaskest, mis on vanem kui 2026.06

Nimetage käivitatava faili asemel ümber kaustad dignabackend ja dignacli: ren dignabackend dignabackend_old ja ren dignacli dignacli_old. Release 2026.11 ei kasuta kumbagi kausta ega ka batch-failide kausta bin.

Samm 3: Pakkige ja paigutage uus versioon

  1. Pakkige uus digna paigaldus ZIP-fail lahti
  2. Kopeerige uus digna täitmisfail ja dashboard kaust oma paigalduskausta

Tähtis

Paigaldus-ZIP ei sisalda kunagi ei faili config.toml ega dashboard/dashboard_config.toml — digna meeskond ei tarni kumbagi faili. Seetõttu ei puuduta uuendus teie olemasolevat konfiguratsiooni ning ümbernimetatud *_old kaustades olevad koopiad on ainsad, mis teil on.

Samm 4: Taastage oma konfiguratsioonifailid

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

Release 2026.11 ei vaja muudatusi failis config.toml: fail, mis töötab Release 2026.06-ga, töötab edasi. Kaks muudatust on valikulised:

  • Lisage [duckdb] sektsioon, kui andmebaasiühendused peavad kasutama komponenti digna Engine ja selle vaikeväärtused teie hostile ei sobi.
  • Jätke sektsioon [app] ära, kui pöördpuhverserver serveerib juhtpaneeli ja backendi ühe päritolu all.

Sätted, mida digna ei loe

Selle juhendi varasemad versioonid näitasid mõningaid sätteid, mida digna ei loe. Neil pole mingit mõju ja config check loetleb need sammus 6 rea Unknown keys all. Eemaldage või parandage need:

  • DIGNA_SCHEDULER_MAX_DELAY, DIGNA_CLEANUP_TIME, digna_COOKIE_PATH, digna_COOKIE_SAME_SITE, digna_APP_CORS_ALLOW_METHODS, digna_APP_CORS_ALLOW_HEADERS ja digna_LOGGING_BACKUP_COUNT ei ole olemas. Eemaldage need.
  • Sätete nimed on tõstutundlikud. digna loeb DIGNA_REPO_HOST, mitte digna_REPO_HOST. Kirjutage iga nimi suurtähtedega, nagu jaotises Backendi konfiguratsioon.

Ühekordne sisselogimine: säilitage [[oidc_clients]]

digna loeb ühekordse sisselogimise pakkujaid [[oidc_clients]] kirjete loendina, millest igaühel on oma DIGNA_OIDC_KEY. Kui muutsite oma pakkujad [oidc_clients.<key>] sektsioonideks, nagu selle juhendi varasem versioon näitas, muutke need tagasi. config check teatab OIDC config(s) olekuks FAILED, kuni see vorm on kasutusel:

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

Korrake kirjet iga pakkuja jaoks ja hoidke iga DIGNA_OIDC_KEY samana kui key failis dashboard_config.toml. See puudutab ainult paigaldusi, mis kasutavad ühekordset sisselogimist.

Samm 5: Laadige veebiserver uuesti

Juhtpaneel koosneb staatilistest failidest, seega võivad teie veebiserver — ja brauser — ikka veel serveerida eelmist versiooni. Laadige uuesti või taaskäivitage veebiserver, mis majutab kausta dashboard, ning seejärel laadige leht sundvärskendusega uuesti (Ctrl+F5).

Samm 6: Kontrollige konfiguratsiooni

Veenduge enne hoidla puudutamist, et config.toml on täielik:

digna config check

Iga sektsioon peab teatama OK. Parandage kõik, millest teatatakse FAILED, eemaldage rea Unknown keys all loetletud võtmed ja käivitage käsk enne jätkamist uuesti.

Samm 7: Asendage litsentsifail

Litsentsifail kandub tavaliselt ühest väljalaskest järgmisse üle. Release 2026.11 on erand: see lisab kaks litsentsitavat moodulit, digna Data Reconciliation ja digna Agentic, ning enne 2026.11 väljastatud litsents neid ei sisalda. Kopeerige digna meeskonna poolt Release 2026.11 jaoks antud license.toml paigalduskataloogi, asendades vana faili:

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

Ärge jätke alles eelmist litsentsi

Eelmise litsentsiga digna küll käivitub, kuid digna Data Reconciliation ja digna MCP Server jäävad välja lülitatuks. Iga käsk, mis litsentsi kontrollib — user, inspection, repo — katkeb enne hoidla puudutamist, kui kontroll ebaõnnestub. Kontrollige uut litsentsi enne jätkamist:

digna license check

Samm 8: Uuendage andmehoidla skeemi

Käivitage oma digna paigalduskataloogis:

digna repo upgrade

Release 2026.11 haldab hoidla skeemi versioonitud migratsioonidega. Esimene uuendus varasemast väljalaskest viib skeemi eelmise versioonimisskeemi viimasele versioonile, salvestab selle lähtepunktina ja rakendab seejärel Release 2026.11 migratsioonid. See lõpetab teatega:

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

Kõik olemasolevad andmed säilivad. Hoidla oleku nägemiseks igal ajal käivitage digna repo check: see loetleb viimase rakendatud migratsiooni ja kõik ootel migratsioonid.

digna ei käivitu aegunud hoidlaga

Alates Release 2026.11-st keeldub server käivitumast, kuni hoidla vajab uuendamist, ja teatab sellest, näiteks:

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

Käivitage repo upgrade enne serveri või teenuse käivitamist.

Samm 9: Teenuste taaskäivitamine

Kui digna töötab Windowsi teenusena, käivitage see uuesti:

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

Kui uuendasite väljalaskest, mis on vanem kui 2026.06, ja eemaldasite sammus 1 teenuse registreeringu, registreerige see esmalt uuesti käivitatava failiga digna:

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

Andke valikutele --address ja --port väärtused, millel vana teenus teenindas, kui te ei soovi vaikeväärtusi 127.0.0.1 ja 8000. Lisage --account ja --password, kui vana teenus töötas domeenikonto all. Valikute täieliku loendi leiate jaotisest digna käitamine Windowsi teenusena.

Kui käivitate käsitsi, taaskäivitage server:

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

Kui kasutate IIS-i või Tomcati, taaskäivitage vastav veebiserver.

Samm 10: Kinnitage uuendus

  1. Kontrollige uue käivitatava faili väljalaset:

    digna version
    

    Esimene rida peab olema Release: 2026.11.

  2. Avage digna juhtpaneel ja veenduge, et liides laadib korrektselt.

  3. Kontrollige paigalduse kataloogi logs faile vigade suhtes.
  4. Testige oma andmebaasiühendusi — vaadake Ühenduse testimine. Pärast uuendamist väljalaskest, mis on vanem kui 2026.06, viige esmalt ODBC-le üle iga ühendus, mis seda veel ei kasutanud.

Uute moodulitega alustamiseks vaadake digna Data Reconciliation, digna MCP Serveri kohta AI-agendi ühendamine ja digna Engine'i kohta Profileerimise asukoht.