Windows-asennusopas digna Release 2026.06:lle¶

Julkaisu: 2026.06

Viimeksi päivitetty: 30. elokuuta 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.06¶

Tässä julkaisussa datan havaittavuusominaisuudet tuodaan suoraan koodiin, jolloin kehittäjät voivat valvoa datan laatua lähteellä. Katso täydelliset tiedot release notes.

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ämä osio määrittelee digna-backend-sovelluksen asetukset:

[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 = ["*"]

[repo] -osio¶

Tässä osiossa määritellään yhteys 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!"

[base] -osio¶

Tämä osio sisältää suojaus- ja evästeasetuksia:

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

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

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

Overall: OK

Korjaa kaikki, mikä raportoidaan tilassa FAILED, ja suorita komento uudelleen ennen jatkamista. 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

Sinun pitäisi nähdä vahvistus siitä, että yhteys on muodostettu (repoa ei ole vielä asennettu).

Vaihe 4: Asenna repositorion skeema¶

Samassa hakemistossa suorita:

digna repo install

Tämä komento asentaa tarvittavat taulut ja skeeman PostgreSQL-tietokantaasi.

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 - --port — Palvelimen portti

Näet käynnistysviestit, jotka vahvistavat palvelimen käynnistyksen:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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¶

Ennen päivitystä¶

Tarkista ensin kaikki tietokantayhteydet

Julkaisusta 2026.06 alkaen digna tavoittaa jokaisen lähdeteknologian ODBC:n kautta. Aiemmat julkaisut tarjosivat valinnan teknologiakohtaisen ajurin ja ODBC:n välillä kytkimellä Use ODBC. digna-tiimi päätti rakentaa pelkästään ODBC:n varaan, koska yksi standardoitu rajapinta antaa enemmän kuin joukko räätälöityjä ajureita:

• Todennus — todennus on osa ODBC:tä, joten yhteys voi käyttää kaikkea, mitä sen ajuri tukee: salasanoja, tokeneita ja PAT-tunnisteita, Kerberosta ja Active Directorya, monivaiheista tunnistautumista ja selainpohjaista kertakirjautumista, pilvi-identiteettejä, asiakasvarmenteita ja TLS:ää. Uudet menetelmät tulevat ajuripäivityksen mukana sen sijaan, että odotettaisiin digna-julkaisua.
• Tietokantatoimittajien ylläpitämät ajurit — toimittajan oma ajuri seuraa uusia palvelinversioita ja tietoturvakorjauksia, ja voit päivittää sen omassa aikataulussasi dignasta riippumatta.
• Yksi tapa määrittää kaikki — jokainen teknologia on avain–arvo-ominaisuuksien luettelo, samalla käyttöliittymällä, samalla arkaluontoisten arvojen salauksella ja samalla vianmäärityksellä, eikä eri kenttäjoukolla lähdettä kohden.
• Hienosäätö ja kattavuus — ajuritason valinnat kuten aikakatkaisut, TLS-asetukset, välityspalvelimet ja hakukoot ovat käytettävissä jokaiselle lähteelle, ja mikä tahansa teknologia, jolla on standardin mukainen ODBC-ajuri, voidaan liittää — myös sellaiset, joille digna ei julkaise omaa opasta.

Käytännössä tämä tarkoittaa, ettei kytkintä Use ODBC eikä erillisiä isäntä-, portti-, tietokanta-, käyttäjä- ja salasanakenttiä ole enää olemassa. Jokainen yhteys, joka ei jo käytä ODBC:tä, on muutettava ODBC:ksi — automaattista muunnosta ei ole, joten suunnittele tämä ennen päivitystä:

1. Käy läpi jokainen asennuksessasi määritelty tietokantayhteys ja merkitse muistiin ne, jotka eivät vielä käytä ODBC:tä — jokainen niistä on määritettävä uudelleen.
2. Asenna vastaava ODBC-ajuri digna-isäntään — yhteydet avataan palvelimelta, jolla digna-taustajärjestelmä toimii, ei selaimesta. Katso ODBC-ajurin asentaminen digna-isäntään.
3. Pidä ODBC-ominaisuudet valmiina jokaiselle koskevalle yhteydelle. Teknologiaoppaat luettelevat lähdekohtaisen, koetellun ominaisuusjoukon.

Muuta päivityksen jälkeen jokainen koskeva yhteys ODBC:ksi ja testaa se hallintapaneelista — katso Tietokantayhteyden luominen ja Yhteyden testaaminen.

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.

Päivitysprosessi¶

Vaihe 1: Pysäytä vanha palvelu ja poista sen rekisteröinti¶

Jos digna on käynnissä Windows-palveluna, pysäytä se nykyisen asennuksesi bat-tiedostoilla — digna windows -komennot kuuluvat uuteen julkaisuun eivätkä ole vielä käytettävissä:

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

Poista sen jälkeen palvelun rekisteröinti, jälleen vanhalla bat-tiedostolla. Rekisteröinti osoittaa vanhaan suoritustiedostoon ja sen skripteihin, jotka molemmat tämä päivitys korvaa, joten sitä ei voi käyttää uudelleen:

uninstall_service.bat

Vaihe 2: Varmuuskopioi nykyinen asennus¶

Nimeä digna-asennushakemistossa nykyisen asennuksen kansiot uudelleen, jotta uusi julkaisu voidaan ottaa käyttöön niiden rinnalle:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

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

[base]
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

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

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

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ä päivitetty config.toml on täydellinen ennen kuin kosket arkistoon:

digna config check

Jokaisen osion on raportoitava OK. Korjaa kaikki, mikä raportoidaan tilassa FAILED, ja suorita komento uudelleen ennen jatkamista.

Vaihe 7: Vaihda lisenssitiedosto¶

Jokainen julkaisu lisensoidaan erikseen. Kopioi digna-tiimin tätä julkaisua 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¶

Siirry digna-asennushakemistoon ja suorita:

digna repo upgrade

Tämä päivittää PostgreSQL-skeeman uusimpaan versioon säilyttäen kaikki nykyiset tiedot.

Vaihe 9: Rekisteröi ja käynnistä palvelu¶

Vanha rekisteröinti poistettiin vaiheessa 1, joten palvelu rekisteröidään uudelleen — tällä kertaa digna-suoritustiedostolla, jossa ei ole bat-tiedostoja:

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 uusia oletusarvoja 127.0.0.1 ja 8000; ne tallennetaan rekisteröintiin eikä niitä enää lueta tiedostosta config.toml. 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. Avaa digna-dashboard
2. Varmista, että käyttöliittymä latautuu oikein
3. Tarkista palvelinlokit mahdollisten virheiden varalta
4. Muuta jokainen yhteys, joka ei vielä käyttänyt ODBC:tä, ODBC:ksi ja testaa sitten kaikki yhteydet — katso Yhteyden testaaminen