Windows-asennusopas digna Release 2026.11:lle¶

Julkaisu: 2026.11

Viimeksi päivitetty: 7. marraskuuta 2026

Sisällysluettelo¶

1. Johdanto
2. Järjestelmävaatimukset
3. Ennen asennusta
4. PostgreSQL-palvelimen asennus
5. Verkkopalvelimen määritys
6. Alustava asennus
7. Backendin konfigurointi
8. Dashboardin konfigurointi
9. dignan ajaminen Windows-palveluna
10. Päivitys uuteen julkaisuun

Johdanto¶

Tietoa dignasta¶

digna on kattava tekoälypohjainen alusta, joka on suunniteltu optimoimaan datalaadun hallintaa erilaisissa dataympäristöissä, kuten tietovarastoissa, data-lakeissa ja lakehouse-ratkaisuissa. Skaalautuvuutensa ja mukautuvuutensa ansiosta digna vastaa nykyajan datahaasteisiin automaation, reaaliaikaisen valvonnan ja poikkeamien havaitsemisen avulla.

digna koostuu kahdesta pääkomponentista:

• digna: sovelluksen ydin, joka vastaa tietojen käsittelystä ja laatutarkistusten suorittamisesta. Se yhdistää taustajärjestelmän ja komentorivikäyttöliittymän yhteen suoritettavaan tiedostoon ja korvaa aiempien julkaisujen erilliset ohjelmat dignabackend ja dignacli.
• dignadashboard: Verkkopohjainen käyttöliittymä, joka isännöidään verkkopalvelimella ja tarjoaa käyttäjäystävällisen tavan käyttää digna-alustaa ja visualisoida datalaatumittareita.

Mitä uutta julkaisussa 2026.11¶

Tämä julkaisu tuo mukanaan digna Data Reconciliationin, digna Agenticin ja digna MCP Serverin sekä digna Enginen, joka voi profiloida dataa dignan sisällä ja tarkistaa viite-eheyden eri tietokantateknologioiden välillä. Katso täydet tiedot release notes.

Asennuksen kannalta julkaisu tuo uuden repositorion migraatiomekanismin, valinnaisen [duckdb]-osion config.toml-tiedostoon digna Engineä varten sekä uuden lisenssitiedoston. Päivitysosio käsittelee jokaisen niistä.

Etsitkö macOS- tai Linux-opasta?¶

Tämä opas kattaa Windowsin. Muihin alustoihin liittyen katso macOS Installation Guide tai Linux Installation Guide.

Järjestelmävaatimukset¶

Ennen asennuksen aloittamista varmista, että järjestelmäsi täyttää seuraavat vähimmäisvaatimukset:

Tietokannan asennusvaihtoehdot¶

Jos PostgreSQL on jo asennettu: Voit lisätä uuden tietokannan dignaa varten olemassa olevaan PostgreSQL-palvelimeesi.

Jos asennat PostgreSQLin samalle koneelle kuin digna:

Ennen asennusta¶

Ennen dignan asentamista varmista, että kaksi keskeistä edellytystä ovat paikallaan:

1. PostgreSQL-palvelin – laskettujen mittareiden ja suorituskykytietojen tallentamista varten
2. Verkkopalvelin – digna Dashboardin isännöintiä varten

Jos näitä komponentteja ei ole vielä asennettu, seuraa alla olevia osioita niiden asentamiseksi ja konfiguroimiseksi.

PostgreSQL-palvelimen asetukset¶

Jos sinulla on jo PostgreSQL¶

Jos PostgreSQL on jo asennettu ja käynnissä paikallisesti tai käytät hallittua etä-PostgreSQL-palvelinta, voit siirtyä suoraan seuraavaan osioon.

PostgreSQLin asentaminen¶

Noudata näitä ohjeita PostgreSQLin asentamiseksi Windowsille:

Vaihe 1: Lataa PostgreSQL¶

1. Siirry PostgreSQL Downloads -sivulle
2. Valitse Windows
3. Lataa uusin asennusohjelma

Vaihe 2: Suorita asennusohjelma¶

1. Kaksoisnapsauta ladattua asennustiedostoa
2. Seuraa asennusohjelman ohjeita

Vaihe 3: Valitse asennushakemisto¶

Valitse hakemisto, johon PostgreSQL asennetaan. Oletussijainti on yleensä sopiva.

Vaihe 4: Valitse komponentit¶

Pidä oletusarvoiset komponenttiasetukset valittuina tavallista asennusta varten.

Vaihe 5: Aseta PostgreSQL-superkäyttäjän salasana¶

Anna ja vahvista salasana PostgreSQLin superkäyttäjälle (postgres). Tallenna tämä salasana turvallisesti — tarvitset sitä myöhemmin.

Vaihe 6: Määritä porttinumero¶

Oletusportti PostgreSQLille on 5432. Voit käyttää oletusta tai määrittää toisen portin tarvittaessa.

Vaihe 7: Valitse paikallisasetukset (Locale)¶

Valitse tietokannan paikallisasetukset. Oletusasetukset sopivat yleensä useimpiin asennuksiin.

Vaihe 8: Viimeistele asennus¶

Klikkaa Seuraava läpi jäljellä olevien vaiheiden ja lopuksi Valmis.

Vaihe 9: Vahvista asennus¶

Avaa komentokehote ja varmista, että PostgreSQL on asennettu:

psql --version

Näet PostgreSQL-version, jos asennus onnistui.

Verkkopalvelimen määritys¶

digna tarvitsee verkkopalvelimen dashboardin isännöintiin. Valitse yksi seuraavista vaihtoehdoista:

• Internet Information Services (IIS)
• Apache Tomcat

Tarvitset vain yhden näistä palvelimista asennettavaksi ja konfiguroitavaksi.

IIS:n käyttöönotto¶

Yleiskatsaus¶

Internet Information Services (IIS) on Microsoftin verkkopalvelin verkkosivustojen ja web-sovellusten isännöintiin.

IIS:n ottaminen käyttöön¶

1. Avaa Ohjauspaneeli
2. Paina Win + R

3. Kirjoita control ja paina Enter

4. Siirry Windowsin ominaisuuksiin

5. Klikkaa Ohjelmat

6. Valitse Ota Windowsin ominaisuuksia käyttöön tai poista niitä käytöstä

7. Ota Internet Information Services käyttöön

8. Selaa alas ja etsi Internet Information Services (IIS)
9. Valitse valintaruutu ottaaksesi sen käyttöön

10. Klikkaa + laajentaaksesi ja varmista, että nämä alikomponentit ovat valittuna:

    • Web Management Tools
    • World Wide Web Services

11. Klikkaa OK hyväksyäksesi muutokset

12. Vahvista IIS-asennus

13. Avaa selain
14. Siirry osoitteeseen http://localhost
15. Näet IIS:n tervetulosivun

Pakollinen: URL Rewrite -moduuli¶

IIS tarvitsee URL Rewrite -komponentin. Lataa ja asenna se viralliselta Microsoftin sivulta.

Pakollinen: MIME-tyyppi Markdown-tiedostoille¶

Varmistaaksesi, että Markdown-tiedostot (.md) palvelimella toimitetaan oikein:

1. Avaa IIS Manager (paina Win + R, kirjoita inetmgr, paina Enter)
2. Siirry Sivustosi > MIME Types
3. Klikkaa Add...
4. Määritä:
5. File name extension: .md
6. MIME type: text/markdown

Apache Tomcatin asennus¶

Yleiskatsaus¶

Apache Tomcat on avoimen lähdekoodin Java-servlet-kontti ja verkkopalvelin.

Asennus¶

1. Lataa Apache Tomcat
2. Siirry kohtaan Apache Tomcat Downloads

3. Lataa Windows ZIP-distribuutio

4. Pura arkisto

5. Pura ZIP-tiedosto haluamaasi hakemistoon

6. Esimerkki: C:\Program Files\Apache Tomcat

7. Vahvista, että Tomcat on käynnissä

8. Avaa selain
9. Siirry osoitteeseen http://localhost:8080
10. Näet Apache Tomcatin tervetulosivun

Alustava asennus¶

Vaihe 1: Aseta digna-repositorio¶

digna-repositorio tallentaa kaikki dignan laskemat mittarit. Se toimii keskeisenä tietokantana analytiikka- ja suorituskykytiedoille.

Luo repositorion skeema ja käyttäjä¶

Avaa PostgreSQL-asiakasohjelmaasi (pgAdmin, psql tai vastaava) ja suorita seuraavat SQL-komennot:

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

Korvaa seuraavat paikkamerkit:

• <digna_repo_schema> — haluamasi skeeman nimi (esim. dignarepo)
• <digna_repo_user> — haluamasi käyttäjänimi (esim. digna_user)
• <digna_repo_password> — turvallinen salasana tälle käyttäjälle

Esimerkki:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Vaihe 2: Pura digna-asennuspaketti¶

1. Etsi sinulle toimitettu digna-asennus ZIP-tiedosto
2. Pura se haluamaasi asennushakemistoon
3. Purkamisen jälkeen näet seuraavat kohteet:
4. dashboard/ — Web-dashboardin käyttöliittymä
5. digna — Pääsuoritettava tiedosto (backend + CLI yhdistettynä)

Vaihe 3: Asenna lisenssitiedosto¶

1. Etsi sinulle toimitettu license.toml-tiedosto
2. Kopioi se dignan asennuksen juurihakemistoon (kohtaan, jossa config.toml ja suoritettava digna sijaitsevat)

Miksi tämä on tärkeää: Lisenssitiedosto sisältää asiakastietosi, lisenssin vanhenemispäivän ja digitaalisen allekirjoituksen. Älä muuta tätä tiedostoa — muutokset mitätöivät sen.

Hakemistorakenne asennuksen jälkeen:

digna_installation/
├── config.toml         (konfiguraatiotiedosto)
├── license.toml        (SINUN LISENSSITIEDOSTOSI - kopioi tänne)
├── digna               (pääsuoritettava tiedosto)
└── dashboard/          (web-käyttöliittymä)
    └── (dashboard-tiedostot)

Backendin konfigurointi¶

Vaihe 1: Luo ja muokkaa konfiguraatiotiedostoa¶

config_template.toml-tiedosto sisältyy digna-asennushakemistoon. Sinun tarvitsee vain nimetä se config.toml:ksi.

Sijainti: digna_installation/config.toml

Avaa config.toml tekstieditorissa ja konfiguroi alla olevat osiot.

[app] -osio¶

Tässä osiossa määritetään dashboardin ja backendin välinen cross-origin resource sharing (CORS):

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

[repo] -osio¶

Tämä osio määrittää yhteyden PostgreSQL-tietokantaan:

[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

[base] -osio¶

Tämä osio sisältää suojaus-, eväste- ja tarkastusasetukset:

[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

[encryption] -osio¶

Tämä osio sisältää avaimen, jolla arkiston arkaluontoiset arvot salataan. Se on pakollinen — config check raportoi osion [encryption] tilassa FAILED, jos avain puuttuu.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] -osio¶

Tämä osio määrittää lokituksen käyttäytymisen:

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

[duckdb] -osio (valinnainen)¶

Uutta Release 2026.11:ssä. Tämä osio määrittää digna Enginen resurssit. digna Engine profiloi dataa dignan sisällä niille tietokantayhteyksille, joiden profilointisijainti on digna Engine, ja suorittaa viite-eheystarkistuksia eri tietokantayhteyksien tietolähteiden välillä. Katso Profilointisijainti.

Osio on valinnainen. Ilman sitä käytetään alla olevia oletusarvoja.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "C:\\path\\to\\digna\\tmp"

mkdir C:\path\to\digna\tmp

Vaihe 2: Tarkista konfiguraatio¶

Varmista ennen arkiston alustusta, että config.toml on täydellinen ja oikein muodostettu. Suorita digna-asennushakemistossasi:

digna config check

Jokainen osio tarkistetaan erikseen, joten yksittäinen virhe ei peitä muiden tilaa:

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

Korjaa kaikki, mikä raportoidaan tilassa FAILED, ja suorita komento uudelleen ennen jatkamista. Kohdan Unknown keys alla oleva WARNING luettelee config.toml-tiedoston avaimet, joita digna ei lue; niillä ei ole vaikutusta, joten poista ne tai korjaa niiden kirjoitusasu. Täydellinen luettelo valinnoista on CLI-viitteessä.

Vaihe 3: Alusta repositorio-yhteys¶

1. Avaa komentokehote
2. Siirry digna-asennuskansioon (kohtaan, jossa config.toml ja suoritettava digna sijaitsevat)
3. Suorita yhteystesti:

digna repo check

Uudessa skeemassa komento muodostaa yhteyden ja ilmoittaa sitten, ettei repositoriota ole vielä asennettu:

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

Tässä vaiheessa tämä on odotettu tulos: se vahvistaa, että digna tavoittaa PostgreSQL:n ja skeeman. Yhteys- tai todennusvirhe sen sijaan viittaa [repo]-osioon tai PostgreSQL-asetuksiin.

Vaihe 4: Asenna repositorion skeema¶

Samassa hakemistossa suorita:

digna repo upgrade

Tämä komento asentaa tarvittavat taulut repositorion skeemaan ja päättyy ilmoitukseen:

✅ Repo schema 'dignarepo' is up to date.

Vaihe 5: Luo ylläpitäjäkäyttäjä¶

1. Avaa uusi komentokehoteikkuna
2. Siirry digna-asennushakemistoon
3. Suorita seuraava komento luodaksesi ylläpitäjäkäyttäjän:

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

Esimerkki:

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

Tämä luo käyttäjän, jolla on täydet järjestelmänvalvojan oikeudet.

Vaihe 6: Käynnistä digna-palvelin¶

digna-asennushakemistossa käynnistä palvelin komennolla:

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

Parametrit: - --address — Palvelimen isäntä tai IP (oletus 127.0.0.1) - --port — Palvelimen portti (oletus 8000)

Kun palvelin on käynnissä, se tulostaa osoitteen, jota se kuuntelee:

Server running on http://127.0.0.1:8082

Dashboardin konfigurointi¶

Vaihe 1: Ota dashboard käyttöön verkkopalvelimella¶

digna-dashboard lukee oman konfiguraationsa tiedostosta dashboard/dashboard_config.toml. Tätä tiedostoa ei toimiteta asennuksen mukana — luot sen dashboard/-hakemistoon dashboardin tiedostojen rinnalle.

Sen sisältö on kuvattu kohdassa Yhden kirjautumisen (SSO) yleiskatsaus, jossa tiedostoa myös tarvitaan: se sisältää dashboardin tarjoamat kirjautumisvaihtoehdot ja monen instanssin käyttöönotoissa backend-yhteyden.

Valitse verkkopalvelimesi ja seuraa vastaavia käyttöönotto-ohjeita.

Käyttöönotto IIS:ssä¶

1. Avaa IIS Manager

2. Paina Win + R, kirjoita inetmgr, paina Enter

3. Luo uusi verkkosivusto

4. Vasemmassa paneelissa napsauta hiiren oikealla Sites

5. Valitse Add Website...

6. Määritä verkkosivusto

7. Site Name: Anna nimi (esim. "dignaDashboard")
8. Physical Path: Selaa ja valitse dashboard-kansiosi

9. Binding: Aseta IP-osoite ja portti (oletus 80 HTTP:lle, 443 HTTPS:lle)

10. Käynnistä sivusto

11. Klikkaa OK luodaksesi sivuston

12. Napsauta hiiren oikealla uutta sivustoa ja valitse Start

13. Testaa asennus

14. Avaa selain
15. Siirry http://localhost (tai määrittämääsi URL:iin)
16. Näet digna-dashboardin kirjautumissivun

Käyttöönotto Apache Tomcatissa¶

1. Kopioi dashboard Tomcatiin
2. Kopioi dashboard-kansio Tomcatin webapps-hakemistoon
3. Nimeä se tarvittaessa uudelleen (esim. digna)

4. Esimerkki: C:\Program Files\Apache Tomcat\webapps\digna

5. Vahvista käyttöönotto

6. Päivitä tai lataa Tomcatin hallintasivu uudelleen (http://localhost:8080)

7. Näet listauksen asennetuista sovelluksista, josta pitäisi löytyä "digna" (tai valitsemasi nimi)

8. Pääsy dashboardiin

9. Avaa selain
10. Siirry osoitteeseen http://localhost:8080/digna
11. Näet digna-dashboardin kirjautumissivun

dignan ajaminen Windows-palveluna¶

Miksi käyttää Windows-palvelua?¶

digna-backendin ajaminen Windows-palveluna varmistaa, että se: - Käynnistyy automaattisesti palvelimen käynnistyessä - Ajaa taustalla ilman avattua komentokehoteikkunaa - Käynnistyy uudelleen automaattisesti kaatumistapauksissa - On hallittavissa Windowsin Palvelut-työkalulla

windows-komennot¶

Palvelua hallitaan itse digna-suoritustiedostolla, digna windows -alikomentojen avulla. Suoritettavia bat-tiedostoja ei ole.

Jokainen komento hyväksyy valitsimen --name, jolla voidaan viitata muulla kuin oletusnimellä rekisteröityyn palveluun. Täydellinen valitsinluettelo on CLI-referenssissä.

Palvelun asentaminen¶

1. Avaa komentokehote järjestelmänvalvojana
2. Napsauta komentokehote oikealla painikkeella

3. Valitse "Run as Administrator"

4. Siirry digna-asennushakemistoosi

   cd C:\path\to\digna
   

5. Rekisteröi palvelu

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Palvelu rekisteröidään automaattisella käynnistyksellä, joten se käynnistyy Windowsin mukana. Se ei käynnisty välittömästi — katso seuraava osio.

Asennuksen valitsimet¶

Palvelun käynnistäminen ja pysäyttäminen¶

Palvelun käynnistäminen¶

digna windows start

Palvelun pysäyttäminen¶

digna windows stop

Palvelun siirtäminen uuteen hakemistoon¶

Jos sinun on siirrettävä digna-asennus:

1. Pysäytä nykyinen palvelu ja poista sen rekisteröinti

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

2. Siirrä sovellustiedostot

3. Siirrä koko digna-asennushakemisto uuteen sijaintiin

4. Rekisteröi palvelu uudelleen uudesta sijainnista

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

Toista kaikki valitsimien --address, --port ja --account arvot, joita käytit ensimmäisellä kerralla — aiempi rekisteröinti on poistettu.

1. Käynnistä palvelu

   digna windows start
   

Palvelun poistaminen¶

1. Pysäytä käynnissä oleva palvelu

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

2. Poista palvelun rekisteröinti

   digna windows uninstall
   

digna-palvelin on nyt poistettu Windows-palveluna rekisteristä.

Päivitys uuteen julkaisuun¶

Tämä osio päivittää Release 2026.06 -asennuksen versioon Release 2026.11. Jos asennuksesi on vanhempi, lue ensin Päivitys julkaisua 2026.06 vanhemmasta versiosta.

Ennen päivitystä¶

digna-repositorion varmuuskopiointi on pakollista

Ennen dignan päivittämistä tee varmuuskopio repositoriostasi (PostgreSQL) suojautuaksesi datan menetykseltä. Varmuuskopio mahdollistaa toipumisen, jos päivityksessä ilmenee odottamattomia ongelmia.

Lisenssitiedoston pyytäminen Release 2026.11:tä varten

Release 2026.11 vaatii uuden license.toml-tiedoston. Pyydä se digna-tiimiltä ennen aloittamista ja pidä se valmiina vaihetta 7 varten.

Päivitys julkaisua 2026.06 vanhemmasta versiosta¶

Release 2026.06 toi kolme muutosta, jotka ovat yhä voimassa, kun päivität vanhemman asennuksen suoraan versioon 2026.11:

• Vain ODBC. digna tavoittaa jokaisen lähdeteknologian ODBC:n kautta. Jokainen tietokantayhteys, joka ei vielä käytä ODBC:tä, on muutettava ODBC:ksi päivityksen jälkeen; automaattista muunnosta ei ole. Asenna ODBC-ajurit digna-isäntään etukäteen, katso ODBC-ajurin asentaminen digna-isäntään, ja pidä kunkin yhteyden ominaisuudet valmiina teknologiaoppaista. Databricks Legacy -liitintä ei enää ole; siirrä nämä yhteydet Databricks-liittimeen.
• Yksi suoritettava tiedosto. dignabackend ja dignacli on korvattu yhdellä suoritettavalla tiedostolla digna, joka yhdistää backendin ja CLI:n.
• config.toml. [encryption]-osio on pakollinen, eikä DIGNA_APP_HOST- ja DIGNA_APP_PORT-asetuksia enää lueta: palvelin saa osoitteensa ja porttinsa komennolta digna serve. Vertaa tiedostoasi kohtaan Backendin määritys.

Alla olevat vaiheet kertovat, missä vanhempi asennus vaatii jotain muuta. Vaiheen 8 repositorion päivitys tuo minkä tahansa aiemman julkaisun repositorion suoraan versioon 2026.11.

Päivitysprosessi¶

Vaihe 1: Pysäytä digna-palvelu¶

Avaa komentokehote järjestelmänvalvojana ja pysäytä palvelu nykyisen asennuksesi digna-suoritustiedostolla:

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

Palvelu pysyy rekisteröitynä. Uusi suoritustiedosto korvaa vanhan samassa hakemistossa, joten rekisteröinti osoittaa edelleen oikeaan tiedostoon.

Jos digna on käynnissä etualalla, paina Ctrl+C sen komentokehoteikkunassa.

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

Vaihe 2: Varmuuskopioi nykyinen asennus¶

Nimeä digna-asennushakemistossa nykyisen asennuksen suoritettava tiedosto ja dashboard-kansio uudelleen, jotta uusi julkaisu voidaan ottaa käyttöön niiden rinnalle:

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

Säilytä digna_old.exe, kunnes olet varmistanut päivityksen, ja dashboard_old, kunnes olet palauttanut siitä konfiguraatiotiedostosi (katso vaihe 4). Sen jälkeen voit poistaa molemmat.

Vaihe 3: Pura ja ota käyttöön uusi versio¶

1. Pura uusi digna-asennus ZIP-tiedosto
2. Kopioi uusi digna-suoritettava ja dashboard-kansio asennushakemistoosi

Vaihe 4: Palauta konfiguraatiotiedostosi¶

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

Release 2026.11 ei vaadi muutoksia config.toml-tiedostoon: tiedosto, joka toimii Release 2026.06:n kanssa, toimii edelleen. Kaksi muutosta on valinnaisia:

• Lisää [duckdb]-osio, jos tietokantayhteyksien on määrä käyttää digna Engineä eivätkä sen oletusarvot sovi isännällesi.
• Jätä [app]-osio pois, jos käänteinen välityspalvelin tarjoaa dashboardin ja backendin saman originin alla.

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

Vaihe 5: Lataa web-palvelin uudelleen¶

Dashboard koostuu staattisista tiedostoista, joten web-palvelimesi — ja selain — saattaa yhä tarjoilla edellistä versiota. Lataa uudelleen tai käynnistä uudelleen se web-palvelin, joka isännöi dashboard-kansiota, ja lataa sitten sivu uudelleen pakotetulla päivityksellä (Ctrl+F5).

Vaihe 6: Tarkista konfiguraatio¶

Varmista, että config.toml on täydellinen ennen kuin kosket arkistoon:

digna config check

Jokaisen osion on raportoitava OK. Korjaa kaikki, mikä raportoidaan tilassa FAILED, poista kohdan Unknown keys alla luetellut avaimet ja suorita komento uudelleen ennen jatkamista.

Vaihe 7: Vaihda lisenssitiedosto¶

Lisenssitiedosto siirtyy yleensä julkaisusta seuraavaan. Release 2026.11 on poikkeus: se lisää kaksi lisensoitua moduulia, digna Data Reconciliationin ja digna Agenticin, eikä ennen versiota 2026.11 myönnetty lisenssi sisällä niitä. Kopioi digna-tiimin Release 2026.11:tä varten toimittama license.toml asennushakemistoon vanhan tiedoston tilalle:

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

digna license check

Vaihe 8: Päivitä repositorion skeema¶

Suorita dignan asennushakemistossa:

digna repo upgrade

Release 2026.11 hallitsee repositorion skeemaa versioitujen migraatioiden avulla. Ensimmäinen päivitys aiemmasta julkaisusta tuo skeeman edellisen järjestelmän viimeiseen versioon, kirjaa sen lähtökohdakseen ja soveltaa sitten Release 2026.11:n migraatiot. Se päättyy ilmoituksiin:

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

Kaikki olemassa olevat tiedot säilyvät. Näet repositorion tilan milloin tahansa komennolla digna repo check: se luettelee viimeisimmän sovelletun migraation ja mahdolliset odottavat migraatiot.

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

Vaihe 9: Käynnistä palvelut uudelleen¶

Jos digna toimii Windows-palveluna, käynnistä se uudelleen:

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

Jos päivitit julkaisua 2026.06 vanhemmasta versiosta ja poistit palvelun rekisteröinnin vaiheessa 1, rekisteröi se ensin uudelleen digna-suoritustiedostolla:

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

Anna valitsimille --address ja --port arvot, joissa vanha palvelu palveli, ellet halua oletusarvoja 127.0.0.1 ja 8000. Lisää --account ja --password, jos vanha palvelu suoritettiin toimialuetilillä. Katso täydellinen valitsinluettelo kohdasta dignan ajaminen Windows-palveluna.

Jos ajat palvelinta manuaalisesti, käynnistä se uudelleen:

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

Jos käytät IIS:ää tai Tomcatia, käynnistä vastaava verkkopalvelin uudelleen.

Vaihe 10: Vahvista päivitys¶

1. Vahvista uuden suoritettavan tiedoston julkaisu:

   digna version
   

   Ensimmäisen rivin on oltava Release: 2026.11.

2. Avaa digna-dashboard ja varmista, että käyttöliittymä latautuu oikein.

3. Tarkista asennuksen logs-hakemiston tiedostot virheiden varalta.
4. Testaa tietokantayhteytesi — katso Yhteyden testaaminen. Jos päivitit julkaisua 2026.06 vanhemmasta versiosta, muuta ensin jokainen yhteys, joka ei vielä käyttänyt ODBC:tä, ODBC:ksi.

Uusien moduulien käytön aloittamiseen katso digna Data Reconciliation, AI-agentin yhdistäminen digna MCP Serveriä varten ja Profilointisijainti digna Engineä varten.