Windows diegimo vadovas digna Release 2026.06¶

Išleidimas: 2026.06

Paskutinį kartą atnaujinta: 2026 m. rugpjūčio 30 d.

Turinys¶

1. Įvadas
2. Sistemos reikalavimai
3. Prieš diegiant
4. PostgreSQL serverio nustatymai
5. Žiniatinklio serverio konfigūracija
6. Pradinis diegimas
7. Backend konfigūracija
8. Dashboard konfigūracija
9. digna paleidimas kaip Windows paslauga
10. Atnaujinimas į naują leidimą

Įvadas¶

Apie digna¶

digna yra visapusiška AI varoma platforma, skirta optimizuoti duomenų kokybės valdymą įvairiose duomenų aplinkose, tokiose kaip duomenų sandėliai (warehouses), lakes ir lakehouses. Sukurta būti labai skalabilia ir pritaikoma, digna sprendžia šiuolaikines duomenų problemas per automatizaciją, realaus laiko stebėjimą ir anomalijų aptikimą.

digna susideda iš dviejų pagrindinių komponentų:

• digna: programos branduolys, atsakingas už duomenų apdorojimą ir kokybės patikras. Jis sujungia užkulisinę dalį ir komandinęs eilutės sąsają į vieną vykdomąjį failą ir pakeičia atskiras ankstesnių leidimų programas dignabackend ir dignacli.
• dignadashboard: žiniatinklio sąsaja, talpinama ant web serverio, suteikianti patogią sąveiką su digna platforma ir duomenų kokybės metrikų vizualizavimą.

Kas naujo leidime 2026.06¶

Šis leidimas prideda duomenų stebėjimo (data observability) galimybes tiesiai į jūsų kodą, leidžiant programuotojams stebėti duomenų kokybę ties šaltiniu. Pilną informaciją rasite išleidimo pastabose.

Ieškote macOS ar Linux?¶

Šis vadovas skirtas Windows. Kitoms platformoms žiūrėkite macOS diegimo vadovą arba Linux diegimo vadovą.

Sistemos reikalavimai¶

Prieš pradėdami diegimą, įsitikinkite, kad jūsų sistema atitinka šiuos minimalius reikalavimus:

Duomenų bazės diegimo parinktys¶

Jei PostgreSQL jau įdiegtas: Galite pridėti naują duomenų bazę digna prie esančio PostgreSQL serverio.

Jei diegiate PostgreSQL toje pačioje mašinoje kaip digna:

Prieš diegiant¶

Prieš įdiegdami digna, įsitikinkite, kad yra du pagrindiniai reikalavimai:

1. PostgreSQL serveris – skirtas apskaičiuotų metrikų ir veikimo duomenų saugojimui
2. Žiniatinklio serveris – skirtas digna Dashboard talpinimui

Jei šie komponentai dar nėra sukonfigūruoti, vadovaukitės žemiau pateiktomis sekcijomis, kad juos įdiegtumėte ir nustatytumėte.

PostgreSQL serverio nustatymai¶

Jei PostgreSQL jau turite¶

Jei PostgreSQL jau įdiegtas ir veikia jūsų lokaliame kompiuteryje arba naudojate valdomą nuotolinį PostgreSQL serverį, galite pereiti prie kitos skilties.

PostgreSQL diegimas¶

Vadovaukitės šiomis instrukcijomis, kad įdiegtumėte PostgreSQL Windows sistemoje:

1 žingsnis: Atsisiųskite PostgreSQL¶

1. Apsilankykite PostgreSQL atsisiuntimų puslapyje
2. Pasirinkite Windows
3. Atsisiųskite naujausią diegimo programą

2 žingsnis: Paleiskite diegimo programą¶

1. Dukart spustelėkite atsisiųstą diegimo failą
2. Sekite nustatymų vedlio nurodymus

3 žingsnis: Pasirinkite diegimo katalogą¶

Pasirinkite katalogą, į kurį bus įdiegta PostgreSQL. Numatytoji vieta dažniausiai tinka.

4 žingsnis: Pasirinkite komponentus¶

Standartiniam diegimui palikite numatytus komponentus.

5 žingsnis: Nustatykite PostgreSQL supervartotojo slaptažodį¶

Įveskite ir patvirtinkite slaptažodį PostgreSQL supervartotojui (postgres). Saugiai išsaugokite šį slaptažodį — jo prireiks vėliau.

6 žingsnis: Konfigūruokite prievadą¶

Numatytasis PostgreSQL prievadas yra 5432. Galite naudoti numatytąjį arba nurodyti kitą prievadą, jei reikia.

7 žingsnis: Pasirinkite lokalę¶

Pasirinkite duomenų bazės lokalę. Numatytoji dažniausiai tinka daugumai diegimų.

8 žingsnis: Uždarykite diegimą¶

Spustelėkite Next per likusius žingsnius, tada spustelėkite Finish.

9 žingsnis: Patikrinkite diegimą¶

Atidarykite Command Prompt ir patikrinkite, ar PostgreSQL įdiegtas:

psql --version

Jei diegimas buvo sėkmingas, matysite PostgreSQL versiją.

Žiniatinklio serverio konfigūracija¶

digna reikalauja žiniatinklio serverio dashboard talpinimui. Pasirinkite vieną iš šių parinkčių:

• Internet Information Services (IIS)
• Apache Tomcat

Reikia įdiegti ir sukonfigūruoti vieną iš šių serverių.

IIS nustatymas¶

Apžvalga¶

Internet Information Services (IIS) yra Microsoft žiniatinklio serveris, skirtas svetainių ir web programėlių talpinimui.

IIS įjungimas¶

1. Atidarykite Valdymo skydą
2. Paspauskite Win + R

3. Įveskite control ir paspauskite Enter

4. Eikite į Windows funkcijas

5. Spustelėkite Programs

6. Pasirinkite Turn Windows features on or off

7. Įgalinkite Internet Information Services

8. Slinkite žemyn ir raskite Internet Information Services (IIS)
9. Pažymėkite varnelę, kad jį įjungtumėte

10. Spustelėkite +, kad išplėstumėte ir patikrinkite, ar pasirinkti šie potekomponentai:

    • Web Management Tools
    • World Wide Web Services

11. Spustelėkite OK, kad pritaikytumėte pakeitimus

12. Patikrinkite IIS diegimą

13. Atidarykite naršyklę
14. Nueikite į http://localhost
15. Turėtumėte matyti IIS pasveikinimo puslapį

Privaloma: URL Rewrite modulis¶

IIS reikalauja URL Rewrite komponento. Atsisiųskite ir įdiekite jį iš oficialaus Microsoft puslapio.

Privaloma: MIME tipas Markdown failams¶

Kad Markdown failai (.md) būtų teisingai aptarnauti IIS:

1. Atidarykite IIS Manager (paspauskite Win + R, įveskite inetmgr, paspauskite Enter)
2. Eikite į Your Site > MIME Types
3. Spustelėkite Add...
4. Konfigūruokite:
5. File name extension: .md
6. MIME type: text/markdown

Apache Tomcat nustatymas¶

Apžvalga¶

Apache Tomcat yra atviro kodo Java servlet konteineris ir žiniatinklio serveris.

Diegimas¶

1. Atsisiųskite Apache Tomcat
2. Apsilankykite Apache Tomcat Downloads

3. Atsisiųskite Windows ZIP distribuciją

4. Išskleiskite archyvą

5. Išskleiskite ZIP failą į katalogą savo sistemoje

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

7. Patikrinkite, ar Tomcat veikia

8. Atidarykite naršyklę
9. Nueikite į http://localhost:8080
10. Turėtumėte matyti Apache Tomcat pasveikinimo puslapį

Pradinis diegimas¶

1 žingsnis: Sukurkite digna repozitoriją¶

digna repozitorija saugo visas digna apskaičiuotas metrikas. Ji veikia kaip centrinė analizės ir veikimo duomenų duomenų saugykla.

Sukurkite schemą ir vartotoją repozitorijai¶

Atidarykite savo PostgreSQL klientą (pgAdmin, psql ar panašiai) ir vykdykite šias SQL komandas:

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

Pakeiskite šiuos vietos rezervavimo simbolius:

• <digna_repo_schema> — pageidaujamas schemos pavadinimas (pvz., dignarepo)
• <digna_repo_user> — pageidaujamas vartotojo vardas (pvz., digna_user)
• <digna_repo_password> — saugus slaptažodis šiam vartotojui

Pavyzdys:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

2 žingsnis: Ištraukite digna diegimo paketą¶

1. Raskite jums pateiktą digna diegimo ZIP failą
2. Išskleiskite jį į pageidaujamą diegimo vietą
3. Po išskleidimo turėtumėte matyti šiuos elementus:
4. dashboard/ — web dashboard sąsaja
5. digna — pagrindinis vykdomasis failas (backend + CLI kartu)

3 žingsnis: Įdiekite licencijos failą¶

1. Raskite jums suteiktą license.toml failą
2. Nukopijuokite jį į pagrindinį digna diegimo katalogą (ten, kur yra config.toml ir digna vykdomasis failas)

Kodėl tai svarbu: Licencijos faile yra jūsų klientų informacija, licencijos galiojimo data ir skaitmeninis parašas. Nekeiskite šio failo — bet kokie pakeitimai jį sukels nebegaliojantį.

Katalogų struktūra po nustatymo:

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

Backend konfigūracija¶

1 žingsnis: Sukurkite ir redaguokite konfigūracijos failą¶

config_template.toml failas pateiktas jūsų digna diegimo kataloge. Jums tereikia jį pervardyti į config.toml.

Vieta: digna_installation/config.toml

Atidarykite config.toml tekstų redaktoriumi ir sukonfigūruokite kiekvieną sekciją žemiau.

[app] skiltis¶

Ši skiltis konfigūruoja digna backend programos nustatymus:

[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] skiltis¶

Ši skiltis konfigūruoja prisijungimą prie PostgreSQL duomenų bazės:

[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] skiltis¶

Ši skiltis turi saugumo ir slapukų nustatymus:

[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] skyrius¶

Šiame skyriuje yra raktas, kuriuo šifruojamos saugykloje laikomos jautrios reikšmės. Jis yra būtinas — config check praneša skyrių [encryption] kaip FAILED, jei rakto trūksta.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] skiltis¶

Ši skiltis konfigūruoja žurnalo (logging) elgseną:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

2 žingsnis: Patikrinkite konfigūraciją¶

Prieš inicijuodami saugyklą patikrinkite, ar config.toml yra išsamus ir tinkamai sudarytas. Savo digna diegimo kataloge paleiskite:

digna config check

Kiekvienas skyrius tikrinamas atskirai, todėl viena klaida neuždengia kitų būsenos:

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

Pataisykite viską, kas pranešama kaip FAILED, ir prieš tęsdami paleiskite komandą dar kartą. Visas parinkčių sąrašas pateiktas CLI žinyne.

3 žingsnis: Inicializuokite repozitoriją¶

1. Atidarykite Command Prompt
2. Nueikite į savo digna diegimo katalogą (ten, kur config.toml ir digna vykdomasis failas)
3. Paleiskite ryšio testą:

digna repo check

Turėtumėte matyti patvirtinimą, kad ryšys užmegztas (repozitorija pati dar neinicijuota).

4 žingsnis: Įdiekite repozitorijos schemą¶

Toje pačioje direktorijoje paleiskite:

digna repo install

Ši komanda įdiegia reikiamas lenteles ir schemą jūsų PostgreSQL duomenų bazėje.

5 žingsnis: Sukurkite administratoriaus vartotoją¶

1. Atidarykite naują Command Prompt langą
2. Nueikite į digna diegimo katalogą
3. Paleiskite šią komandą, kad sukurtumėte administratorių:

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

Pavyzdys:

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

Tai sukurs vartotoją su pilnomis administravimo teisėmis.

6 žingsnis: Paleiskite digna serverį¶

Digno diegimo kataloge paleiskite serverį:

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

Parametrai: - --address — serverio hostname/IP - --port — serverio prievadas

Turėtumėte matyti paleidimo pranešimus, patvirtinančius, kad serveris veikia:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

Dashboard konfigūracija¶

1 žingsnis: Patalpinkite dashboard į žiniatinklio serverį¶

digna dashboard savo konfigūraciją skaito iš dashboard/dashboard_config.toml. Šis failas diegimo pakete nepateikiamas — jį sukuriate dashboard/ kataloge šalia dashboard failų.

Jo turinys aprašytas skyriuje Vienkartinis prisijungimas (SSO), kur šis failas ir reikalingas: jame nurodomos dashboard siūlomos prisijungimo parinktys, o daugiainstanciniams diegimams — ir ryšys su backend.

Pasirinkite žiniatinklio serverį ir atlikite atitinkamus diegimo veiksmus.

Diegimas į IIS¶

1. Atidarykite IIS Manager

2. Paspauskite Win + R, įveskite inetmgr, paspauskite Enter

3. Sukurkite naują svetainę

4. Kairėje panelėje dešiniuoju pelės mygtuku spustelėkite Sites

5. Pasirinkite Add Website...

6. Sukonfigūruokite svetainę

7. Site Name: Įveskite pavadinimą (pvz., "dignaDashboard")
8. Physical Path: Spustelėkite Browse ir pasirinkite savo dashboard katalogą

9. Binding: Nustatykite IP adresą ir prievadą (numatytas prievadas HTTP — 80, HTTPS — 443)

10. Paleiskite svetainę

11. Spustelėkite OK, kad sukurtumėte svetainę

12. Dešiniuoju pelės mygtuku spustelėkite naują svetainę ir pasirinkite Start

13. Patikrinkite diegimą

14. Atidarykite naršyklę
15. Nueikite į http://localhost (arba jūsų sukonfigūruotą URL)
16. Turėtumėte matyti digna dashboard prisijungimo puslapį

Diegimas į Apache Tomcat¶

1. Kopijuokite dashboard į Tomcat
2. Nukopijuokite dashboard katalogą į savo Tomcat webapps katalogą
3. Pervardykite, jei reikia (pvz., į digna)

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

5. Patikrinkite diegimą

6. Atnaujinkite arba perkraukite Tomcat valdymo puslapį (http://localhost:8080)

7. Turėtumėte matyti „digna“ (ar jūsų pasirinktą pavadinimą) tarp išdėstytų aplikacijų

8. Prieiga prie dashboard

9. Atidarykite naršyklę
10. Nueikite į http://localhost:8080/digna
11. Turėtumėte matyti digna dashboard prisijungimo puslapį

digna paleidimas kaip Windows paslauga¶

Kodėl naudoti Windows paslaugą?¶

digna backend paleidus kaip Windows paslaugą užtikrinama, kad jis: - Paleidžiamas automatiškai serveriui įsijungus - Veikia fone be atidaryto Command Prompt lango - Automatiškai paleidžiamas iš naujo, jei sugestų - Gali būti valdomas per Windows Services

windows komandos¶

Paslaugą valdo pats digna vykdomasis failas, naudodamas digna windows subkomandas. Jokių batch failų vykdyti nereikia.

Kiekviena komanda priima --name, kad būtų galima kreiptis į paslaugą, užregistruotą ne numatytuoju pavadinimu. Visas parinkčių sąrašas pateiktas CLI žinyne.

Paslaugos įdiegimas¶

1. Atidarykite Command Prompt kaip administratorius
2. Dešiniuoju pelės mygtuku spustelėkite Command Prompt

3. Pasirinkite "Run as Administrator"

4. Nueikite į savo digna diegimo katalogą

   cd C:\path\to\digna
   

5. Užregistruokite paslaugą

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Paslauga užregistruojama su automatiniu paleidimu, todėl ji bus paleidžiama kartu su Windows. Iš karto ji nepaleidžiama — žr. kitą skyrių.

Diegimo parinktys¶

Paslaugos paleidimas ir sustabdymas¶

Paslauga paleidimui¶

digna windows start

Paslauga sustabdymui¶

digna windows stop

Perkėlimas paslaugos į naują katalogą¶

Jei reikia perkelti digna diegimą:

1. Sustabdykite ir išregistruokite esamą paslaugą

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

2. Perkelkite aplikacijos failus

3. Perkelkite visą digna diegimo aplanką į naują vietą

4. Vėl užregistruokite paslaugą iš naujos vietos

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

Pakartokite visas --address, --port ar --account reikšmes, kurias naudojote pirmą kartą — ankstesnės registracijos nebėra.

1. Paleiskite paslaugą

   digna windows start
   

Paslaugos pašalinimas¶

1. Sustabdykite veikiančią paslaugą

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

2. Išregistruokite paslaugą

   digna windows uninstall
   

Digna serveris dabar atregistruotas kaip Windows paslauga.

Atnaujinimas į naują leidimą¶

Prieš atnaujinimą¶

Pirmiausia patikrinkite visus duomenų bazės ryšius

Nuo leidimo 2026.06 digna kiekvieną šaltinio technologiją pasiekia per ODBC. Ankstesni leidimai siūlė pasirinkimą tarp konkrečiai technologijai skirtos tvarkyklės ir ODBC, pažymimą jungikliu Use ODBC. digna komanda nusprendė remtis vien ODBC, nes viena standartinė sąsaja duoda daugiau nei pagal užsakymą sukurtų tvarkyklių rinkinys:

• Tapatybės nustatymas — tapatybės nustatymas yra ODBC dalis, todėl ryšys gali naudoti viską, ką palaiko jo tvarkyklė: slaptažodžius, prieigos raktus ir PAT, Kerberos ir Active Directory, MFA ir naršyklės vienkartinį prisijungimą, debesijos tapatybes, kliento sertifikatus ir TLS. Nauji metodai atkeliauja su tvarkyklės atnaujinimu, o ne laukiant digna leidimo.
• Tvarkyklės, kurias prižiūri duomenų bazių gamintojai — gamintojo tvarkyklė seka naujas serverio versijas ir saugumo pataisas, o jūs galite ją atnaujinti savo tempu, nepriklausomai nuo digna.
• Vienas būdas viską sukonfigūruoti — kiekviena technologija yra raktų ir reikšmių savybių sąrašas su ta pačia sąsaja, tuo pačiu jautrių reikšmių šifravimu ir ta pačia trikčių diagnostika, o ne skirtingais laukų rinkiniais kiekvienam šaltiniui.
• Derinimas ir aprėptis — tvarkyklės parinktys, tokios kaip skirtieji laikai, TLS nuostatos, tarpiniai serveriai ir nuskaitymo dydžiai, prieinamos kiekvienam šaltiniui, o prijungti galima bet kurią technologiją su atitinkama ODBC tvarkykle, taip pat ir tas, kurioms digna neskelbia atskiro vadovo.

Praktikoje tai reiškia, kad jungiklio Use ODBC bei atskirų pagrindinio kompiuterio, prievado, duomenų bazės, naudotojo ir slaptažodžio laukų nebeliko. Kiekvieną ryšį, kuris dar nenaudoja ODBC, reikia perkelti į ODBC — automatinio konvertavimo nėra, todėl suplanuokite tai prieš naujinimą:

1. Peržiūrėkite kiekvieną jūsų diegime apibrėžtą duomenų bazės ryšį ir pasižymėkite tuos, kurie dar nenaudoja ODBC — kiekvieną jų reikės sukonfigūruoti iš naujo.
2. Įdiekite atitinkamą ODBC tvarkyklę digna pagrindiniame kompiuteryje — ryšiai atveriami iš serverio, kuriame veikia digna užkulisinė dalis, o ne iš naršyklės. Žiūrėkite ODBC tvarkyklės diegimas digna pagrindiniame kompiuteryje.
3. Turėkite paruoštas ODBC savybes kiekvienam susijusiam ryšiui. Technologijų vadovai kiekvienam šaltiniui pateikia išbandytą savybių rinkinį.

Po naujinimo kiekvieną susijusį ryšį perkelkite į ODBC ir išbandykite jį iš skydelio — žiūrėkite Duomenų bazės ryšio kūrimas ir Ryšio tikrinimas.

Būtina sukurti digna repozitorijos atsarginę kopiją

Prieš atnaujinant digna, atsargiai atsarginę kopiją savo repozitorijos (PostgreSQL), kad apsisaugotumėte nuo duomenų praradimo. Atsarginė kopija leis atkurti duomenis, jei atnaujinimo metu kils nenumatytų problemų.

Atnaujinimo procesas¶

1 žingsnis: Sustabdykite ir išregistruokite senąją paslaugą¶

Jei digna veikia kaip Windows paslauga, sustabdykite ją dabartinio diegimo batch failais — digna windows komandos priklauso naujajam leidimui ir dar nėra prieinamos:

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

Tada išregistruokite paslaugą, vėl naudodami senąjį batch failą. Registracija nurodo į senąjį vykdomąjį failą ir jo skriptus, kuriuos abu šis atnaujinimas pakeičia, todėl jos panaudoti pakartotinai negalima:

uninstall_service.bat

2 žingsnis: Sukurkite dabartinio diegimo atsarginę kopiją¶

Savo digna diegimo kataloge pervadinkite dabartinio diegimo aplankus, kad naują leidimą būtų galima įdiegti šalia jų:

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

3 žingsnis: Išskleiskite ir naudokite naują versiją¶

1. Išskleiskite naują digna diegimo ZIP failą
2. Nukopijuokite naują digna vykdomąjį failą ir dashboard katalogą į savo diegimo katalogą

4 žingsnis: Atkurkite konfigūracijos failus¶

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'

5 žingsnis: Perkraukite žiniatinklio serverį¶

Dashboard yra statinių failų rinkinys, todėl jūsų žiniatinklio serveris — ir naršyklė — gali vis dar pateikti ankstesnę versiją. Perkraukite arba iš naujo paleiskite žiniatinklio serverį, kuriame talpinamas dashboard aplankas, tada iš naujo įkelkite puslapį priverstiniu atnaujinimu (Ctrl+F5).

6 žingsnis: Patikrinkite konfigūraciją¶

Prieš liesdami saugyklą įsitikinkite, kad atnaujintas config.toml yra išsamus:

digna config check

Kiekvienas skyrius turi pranešti OK. Pataisykite viską, kas pranešama kaip FAILED, ir prieš tęsdami paleiskite komandą dar kartą.

7 žingsnis: Pakeiskite licencijos failą¶

Kiekvienai laidai licencija išduodama atskirai. Nukopijuokite license.toml, kurį digna komanda pateikė šiai laidai, į diegimo katalogą, pakeisdami senąjį:

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

digna license check

8 žingsnis: Atnaujinkite repozitorijos schemą¶

Nueikite į savo digna diegimo katalogą ir paleiskite:

digna repo upgrade

Tai atnaujins PostgreSQL schemą į naujausią versiją, išsaugant visus esamus duomenis.

9 žingsnis: Užregistruokite ir paleiskite paslaugą¶

Senoji registracija buvo pašalinta 1 žingsnyje, todėl paslauga registruojama iš naujo — šį kartą naudojant digna vykdomąjį failą, kuris neturi batch failų:

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

Parinktims --address ir --port nurodykite reikšmes, kuriomis veikė senoji paslauga, nebent norite naujų numatytųjų reikšmių 127.0.0.1 ir 8000; jos įrašomos į registraciją ir nebėra skaitomos iš config.toml. Jei senoji paslauga veikė domeno paskyra, pridėkite --account ir --password. Visą parinkčių sąrašą rasite skyriuje digna paleidimas kaip Windows paslauga.

Jei paleidžiate rankiniu būdu, paleiskite serverį iš naujo:

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

Jei naudojate IIS arba Tomcat, perkraukite atitinkamą žiniatinklio serverį.

10 žingsnis: Patikrinkite atnaujinimą¶

1. Atidarykite digna dashboard
2. Patikrinkite, ar sąsaja pakraunama teisingai
3. Peržiūrėkite serverio žurnalus dėl galimų klaidų
4. Kiekvieną ryšį, kuris dar nenaudojo ODBC, perkelkite į ODBC, tada išbandykite visus ryšius — žiūrėkite Ryšio tikrinimas