Pāriet uz saturu

Windows instalācijas ceļvedis digna Release 2026.06

Izlaidums: 2026.06

Pēdējais atjauninājums: 2026. gada 30. augusts


Saturs

  1. Ievads
  2. Sistēmas prasības
  3. Priekšinstalācijas sagatavošana
  4. PostgreSQL servera iestatīšana
  5. Tīmekļa servera konfigurācija
  6. Sākotnējā instalācija
  7. Backend konfigurācija
  8. Paneļa konfigurācija
  9. digna palaide kā Windows serviss
  10. Jaunināšana uz jaunu izlaidumu

Ievads

Par digna

digna ir visaptveroša ar mākslīgo intelektu balstīta platforma, kas paredzēta datu kvalitātes pārvaldības optimizēšanai dažādās datu vidēs, piemēram, noliktavās, ezeros un lakehouse risinājumos. Izstrādāta kā mērogojama un pielāgojama sistēma, digna risina mūsdienu datu izaicinājumus, izmantojot automatizāciju, reāllaika uzraudzību un anomāliju atklāšanu.

digna sastāv no divām galvenajām komponentēm:

  • digna: lietojumprogrammas kodols, kas atbild par datu apstrādi un kvalitātes pārbaužu veikšanu. Tas apvieno aizmuguri un komandrindas saskarni vienā izpildāmajā failā un aizstāj iepriekšējo laidienu atsevišķās programmas dignabackend un dignacli.
  • dignadashboard: tīmekļa saskarne, kas izvietota uz tīmekļa servera un nodrošina lietotājam draudzīgu veidu, kā mijiedarboties ar digna platformu un vizualizēt datu kvalitātes metrikas.

Kas jauns izlaidumā 2026.06

Šajā izlaidumā datu novērošanas iespējas ir integrētas tieši jūsu kodā, ļaujot izstrādātājiem uzraudzīt datu kvalitāti pie avota. Pilnas detaļas skatiet izlaiduma piezīmēs.

Meklējat macOS vai Linux?

Šis ceļvedis attiecas uz Windows. Citu platformu instalācijas skaidrojumu skatiet macOS instalācijas ceļvedī vai Linux instalācijas ceļvedī.


Sistēmas prasības

Pirms instalācijas pārliecinieties, ka jūsu sistēma atbilst šādām minimālajām prasībām:

Prasība Specifikācija
Operētājsistēma Windows Server vai Windows 10/11
Atmiņa (minimālā konfigurācija) 16 GB RAM
Diskā nepieciešamā vieta 10 GB brīvas vietas
Datubāze PostgreSQL Server 12 vai jaunāks
Tīmekļa serveris IIS, Apache Tomcat vai ekvivalents

Datubāzes instalācijas iespējas

Ja PostgreSQL jau ir instalēts: Jūs varat pievienot jaunu datubāzi digna esošajam PostgreSQL serverim.

Ja instalējat PostgreSQL uz tā paša datora kā digna:

Ieteicamās specifikācijas

  • Atmiņa: 32 GB RAM (nevis 16 GB)
  • Diskā nepieciešamā vieta: 50 GB brīvas vietas (nevis 10 GB)

Šīs augstākās specifikācijas nodrošina pietiekamus resursus vienlaicīgai digna un PostgreSQL datubāzes darbībai.


Priekšinstalācijas sagatavošana

Pirms digna instalēšanas pārliecinieties, ka ir izpildīti divi galvenie priekšnosacījumi:

  1. PostgreSQL Server – aprēķināto metrikas un veiktspējas datu glabāšanai
  2. Tīmekļa serveris – digna paneļa izvietošanai

Ja šīs sastāvdaļas vēl nav iestatītas, izpildiet tālāk norādītās sadaļas, lai tās instalētu un konfigurētu.


PostgreSQL servera iestatīšana

Ja PostgreSQL jau ir pieejams

Ja PostgreSQL jau ir instalēts un darbojas uz jūsu lokālā datora vai ja izmantojat pārvaldītu attālo PostgreSQL serveri, varat pāriet uz nākamo sadaļu.

PostgreSQL instalēšana

Izpildiet šos soļus, lai instalētu PostgreSQL uz Windows:

1. solis: Lejupielādēt PostgreSQL

  1. Apmeklējiet PostgreSQL lejupielādes lapu
  2. Izvēlieties Windows
  3. Lejupielādējiet jaunāko instalatoru

2. solis: Palaist instalatoru

  1. Veiciet dubultklikšķi uz lejupielādētā instalatora faila
  2. Sekojiet norādījumiem instalācijas vednī

3. solis: Izvēlēties instalācijas direktoriju

Izvēlieties mapi, kur PostgreSQL tiks instalēts. Parasti noklusējuma atrašanās vieta ir piemērota.

4. solis: Izvēlēties komponentes

Standarta uzstādīšanai atstājiet noklusējuma komponentes atlasītas.

5. solis: Iestatīt PostgreSQL superlietotāja paroli

Ievadiet un apstipriniet paroli PostgreSQL superlietotājam (postgres). Saglabājiet šo paroli drošā vietā — tā būs nepieciešama vēlāk.

6. solis: Konfigurēt porta numuru

Noklusējuma PostgreSQL ports ir 5432. Varat izmantot noklusējumu vai norādīt citu portu pēc vajadzības.

Padoms

Ja ports 5432 jau ir aizņemts, izvēlieties citu portu un atcerieties to turpmākajai konfigurācijai.

7. solis: Izvēlēties lokalizāciju

Izvēlieties datubāzes lokalizāciju. Parasti noklusējums ir piemērots lielākajai daļai instalāciju.

8. solis: Pabeigt instalāciju

Noklikšķiniet Next cauri atlikušajiem soļiem, pēc tam noklikšķiniet Finish.

9. solis: Pārbaudīt instalāciju

Atveriet Command Prompt un pārbaudiet, vai PostgreSQL ir instalēts:

psql --version

Ja instalācija bija veiksmīga, tiks parādīta PostgreSQL versija.


Tīmekļa servera konfigurācija

digna prasa tīmekļa serveri paneļa izvietošanai. Izvēlieties vienu no šīm iespējām:

Nepieciešams instalēt un konfigurēt tikai vienu no šiem serveriem.

IIS iestatīšana

Pārskats

Internet Information Services (IIS) ir Microsoft tīmekļa serveris vietņu un tīmekļa lietotņu mitināšanai.

IIS ieslēgšana

  1. Atveriet Vadības paneli
  2. Nospiediet Win + R
  3. Ierakstiet control un nospiediet Enter

  4. Pārejiet uz Windows funkcijām

  5. Noklikšķiniet Programs
  6. Izvēlieties Turn Windows features on or off

  7. Ieslēdziet Internet Information Services

  8. Ritiniet un atrodiet Internet Information Services (IIS)
  9. Atzīmējiet izvēles rūtiņu, lai to ieslēgtu
  10. Noklikšķiniet uz +, lai izvērstu un pārbaudītu, vai ir atlasītas šādas apakškomponentes:

    • Web Management Tools
    • World Wide Web Services
  11. Noklikšķiniet OK, lai piemērotu izmaiņas

  12. Pārbaudīt IIS instalāciju

  13. Atveriet pārlūkprogrammu
  14. Dodieties uz http://localhost
  15. Jums jāredz IIS sveiciena lapa

Obligāti: URL Rewrite modulis

IIS prasa URL Rewrite komponenti. Lejupielādējiet un instalējiet to no oficiālās Microsoft lapas.

Obligāti: MIME tips Markdown failiem

Lai nodrošinātu, ka Markdown faili (.md) tiek pareizi servēti ar IIS:

  1. Atveriet IIS Manager (nospiediet Win + R, ierakstiet inetmgr, nospiediet Enter)
  2. Pārejiet uz Your Site > MIME Types
  3. Noklikšķiniet Add...
  4. Konfigurējiet:
  5. File name extension: .md
  6. MIME type: text/markdown

Svarīgi

Bez šī iestatījuma .md faili var netikt pareizi servēti.


Apache Tomcat iestatīšana

Pārskats

Apache Tomcat ir atvērtā koda Java servleta konteiners un tīmekļa serveris.

Instalēšana

  1. Lejupielādēt Apache Tomcat
  2. Apmeklējiet Apache Tomcat Downloads
  3. Lejupielādējiet Windows ZIP izplatījumu

  4. Izpakot arhīvu

  5. Izpakojiet ZIP failu direktorijā uz jūsu sistēmas
  6. Piemērs: C:\Program Files\Apache Tomcat

  7. Pārbaudīt, vai Tomcat darbojas

  8. Atveriet pārlūkprogrammu
  9. Dodieties uz http://localhost:8080
  10. Jums jāredz Apache Tomcat sveiciena lapa

Padoms

Apache Tomcat parasti sāk darboties automātiski pēc instalācijas. Ja tas nenotiek, atveriet bin mapi un palaidiet startup.bat.


Sākotnējā instalācija

1. solis: Iestatīt digna repozitoriju

digna repozitorijs glabā visas ar digna aprēķinātās metrikas. Tas darbojas kā centrālā datubāze analītiskajiem un veiktspējas datiem.

Izveidot repozitorija shēmu un lietotāju

Atveriet savu PostgreSQL klientu (pgAdmin, psql vai līdzīgu) un izpildiet šādas 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>;

Aizvietojiet šādus aizstājējvārdus:

  • <digna_repo_schema> — Vēlamais shēmas nosaukums (piem., dignarepo)
  • <digna_repo_user> — Vēlamais lietotājvārds (piem., digna_user)
  • <digna_repo_password> — Droša parole šim lietotājam

Piemērs:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Laba prakse

Lietojiet stipras, sarežģītas paroles datubāzes lietotājiem. Izvairieties no viegli uzminamiem akreditācijas datiem.


2. solis: Izpakot digna instalācijas pakotni

  1. Atrodiet jums nodoto digna instalācijas ZIP failu
  2. Izpakojiet to vēlamajā instalācijas vietā
  3. Pēc izpakošanas jums jāredz sekojošas vienības:
  4. dashboard/ — tīmekļa paneļa saskarne
  5. digna — galvenais izpildāmais fails (backend + CLI apvienots)

Konfigurācijas un licences faili pakotnē nav iekļauti

Ne config.toml, ne dashboard/dashboard_config.toml instalācijā nav iekļauts — abus jūs izveidojat paši sadaļās Backend konfigurācija un Paneļa konfigurācija. Arī license.toml nav iekļauts; digna to nodrošina atsevišķi, kā aprakstīts 3. solī.

3. solis: Instalēt licences failu

Svarīgi

Licences fails nav iekļauts instalācijas paketē un tiks nodrošināts atsevišķi no digna.

  1. Atrodiet jums nodoto license.toml failu
  2. Kopējiet to uz digna instalācijas saknes direktoriju (tur, kur atrodas config.toml un izpildāmais digna)

Kāpēc tas ir svarīgi: Licences fails satur jūsu klienta informāciju, licences derīguma termiņu un digitālo parakstu. Nemainiet šo failu — jebkuras izmaiņas to inaktivizēs.

Direktorijas struktūra pēc iestatīšanas:

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

Backend konfigurācija

1. solis: Izveidot un rediģēt konfigurācijas failu

config_template.toml fails ir iekļauts jūsu digna instalācijas direktorijā. Pietiek to pārdēvēt par config.toml.

Atrašanās vieta: digna_installation/config.toml

Atveriet config.toml teksta redaktorā un konfigurējiet katru sadaļu zemāk.

[app] sadaļa

Šī sadaļa konfigurē digna backend lietojumprogrammas iestatījumus:

[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 = ["*"]
Parametrs Vērtība Piezīmes
digna_APP_CORS_ALLOW_ORIGINS Frontenda URL Ja panelis atrodas citā serverī, iekļaujiet tā URL
digna_APP_CORS_ALLOW_CREDENTIALS true Nepieciešams CORS ar akreditācijas datiem
digna_APP_CORS_ALLOW_METHODS ["*"] Atļaut visus HTTP metodus
digna_APP_CORS_ALLOW_HEADERS ["*"] Atļaut visus header laukus

[repo] sadaļa

Šī sadaļa konfigurē savienojumu ar PostgreSQL datubāzi:

[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!"
Parametrs Vērtība Piezīmes
digna_REPO_HOST localhost vai IP PostgreSQL servera hostname/IP
digna_REPO_PORT 5432 (noklusējums) PostgreSQL ports
digna_REPO_DB postgres Datubāzes nosaukums
digna_REPO_SCHEMA dignarepo Iepriekš izveidotā shēma
digna_REPO_USER digna_user Lietotājs izveidots PostgreSQL iestatīšanā
digna_REPO_PASSWORD Jūsu parole Parole, iestatīta shēmas izveidē

[base] sadaļa

Šī sadaļa satur drošības un sīkfailu iestatījumus:

[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"
Parametrs Vērtība Piezīmes
DIGNA_FERNET_KEY Šifrēšanas atslēga Izmanto, lai šifrētu tokenus un sīkfailus (noklusējums iekļauts)
digna_COOKIE_DOMAIN localhost Atbilst jūsu frontenda domēnam
digna_COOKIE_SECURE false (lokāli) / true (produkcijā) Lietojiet true HTTPS savienojumiem
digna_COOKIE_HTTPONLY true Vienmēr iespējots drošībai
digna_COOKIE_SAME_SITE lax Novērš CSRF uzbrukumus
digna_TOKEN_EXPIRES_IN 86400 (24 stundas) Sesijas derīguma laiks sekundēs
digna_MAX_WORKERS Skaitlis: CPU kodolu skaits - 1 Paralēlo inspekciju uzdevumu skaits
DIGNA_SCHEDULER_MAX_DELAY 100 Maksimālā aizture sekundēs, ko plānotājs drīkst pievienot pirms termiņā esoša darba sākšanas
DIGNA_CLEANUP_TIME "12:00" Diennakts laiks (24 stundu formāts HH:MM), kad sākas ikdienas tīrīšana

[encryption] sadaļa

Šajā sadaļā ir atslēga, ar kuru tiek šifrētas repozitorijā glabātās sensitīvās vērtības. Tā ir obligāta — config check ziņo par sadaļu [encryption] kā FAILED, ja atslēgas trūkst.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='
Parametrs Vērtība Piezīmes
DIGNA_ENCRYPTION_KEY Base64 kodēta atslēga Šifrē sensitīvās vērtības, kas glabājas digna repozitorijā

Aizsargājiet config.toml

Šī atslēga ir fiksēta vērtība, kas ir vienāda visās digna instalācijās, un tieši tā atkodē jūsu repozitorija sensitīvās vērtības. Ierobežojiet piekļuvi config.toml līdz kontam, ar kuru darbojas digna, glabājiet failu ārpus versiju kontroles un koplietojamiem diskiem un izslēdziet to no jebkuras dublējuma kopijas, kas tiek glabāta mazāk droši nekā pats repozitorijs.

[logging] sadaļa

Šī sadaļa konfigurē žurnālu (logu) uzvedību:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10
Parametrs Vērtība Piezīmes
digna_LOGGING_MODE INFO vai DEBUG INFO produkcijai, DEBUG problēmu novēršanai
digna_LOGGING_BACKUP_COUNT 10 Cik dienu žurnālu dublējumu saglabāt

2. solis: Parbaudiet konfigurāciju

Pirms repozitorija inicializēšanas pārbaudiet, vai config.toml ir pilnīgs un pareizi veidots. Savā digna instalācijas direktorijā palaidiet:

digna config check

Katra sadaļa tiek pārbaudīta atsevišķi, tāpēc viena kļūda neaizsedz pārējo stāvokli:

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

Izlabojiet visu, kas ziņots kā FAILED, un pirms turpināšanas palaidiet komandu vēlreiz. Pilns opciju saraksts ir CLI atsaucē.

3. solis: Inicializēt repozitoriju

  1. Atveriet Command Prompt
  2. Pārejiet uz jūsu digna instalācijas direktoriju (tur, kur atrodas config.toml un izpildāmais digna)
  3. Palaidiet savienojuma pārbaudi:
digna repo check

Jums jāsaņem apstiprinājums, ka savienojums ir izveidots (repozitārijs pats par sevi vēl nav inicializēts).

4. solis: Instalēt repozitorija shēmu

Tajā pašā direktorijā palaidiet:

digna repo install

Šī komanda instalē nepieciešamās tabulas un shēmu jūsu PostgreSQL datubāzē.

5. solis: Izveidot administratora lietotāju

  1. Atveriet jaunu Command Prompt logu
  2. Pārejiet uz jūsu digna instalācijas direktoriju
  3. Palaidiet šādu komandu, lai izveidotu administratora lietotāju:
digna user add <email> <password> "<display_name>" --admin

Piemērs:

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

Šī komanda izveido lietotāju ar pilnām administratīvām tiesībām.

Laba prakse

Izmantojiet stipru paroli ar lielajiem un maziem burtiem, cipariem un speciālajām zīmēm.


6. solis: Palaist digna serveri

Digna instalācijas direktorijā palaidiet serveri ar:

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

Parametri: - --address — servera hostname/IP - --port — servera ports

Jums jāredz startēšanas ziņas, kas apstiprina, ka serveris darbojas:

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

Serveris aizņem termināli

serve darbojas priekšplānā un turpina, līdz to apturat ar Ctrl+C. Atstājiet to darbojamies, kamēr pabeidzat iestatīšanu; lai to automātiski palaistu sistēmas startēšanas laikā, skatiet digna palaišana kā Windows pakalpojuma.

Paneļa konfigurācija

1. solis: Izvietot paneli uz tīmekļa servera

digna panelis savu konfigurāciju nolasa no faila dashboard/dashboard_config.toml. Šis fails instalācijā nav iekļauts — jūs to izveidojat dashboard/ direktorijā līdzās paneļa failiem.

Tā saturs ir aprakstīts sadaļā Vienotā pieteikšanās (SSO), kur šis fails arī ir nepieciešams: tajā ir panelī piedāvātās pieteikšanās iespējas un, daudzinstanču izvietošanai, backend savienojums.

Izvēlieties jūsu tīmekļa serveri un izpildiet atbilstošos izvietošanas soļus.

Izvietošana uz IIS

  1. Atveriet IIS Manager
  2. Nospiediet Win + R, ierakstiet inetmgr, nospiediet Enter

  3. Izveidot jaunu vietni

  4. Kreisajā panelī ar peles labo pogu klikšķiniet uz Sites
  5. Izvēlieties Add Website...

  6. Konfigurēt vietni

  7. Site Name: Ievadiet nosaukumu (piem., "dignaDashboard")
  8. Physical Path: Noklikšķiniet Browse un izvēlieties jūsu dashboard mapi
  9. Binding: Iestatiet IP adresi un portu (noklusējuma ports HTTP — 80, HTTPS — 443)

  10. Startēt vietni

  11. Noklikšķiniet OK, lai izveidotu vietni
  12. Ar peles labo pogu klikšķiniet uz jaunizveidotās vietnes un izvēlieties Start

  13. Pārbaudīt instalāciju

  14. Atveriet pārlūkprogrammu
  15. Dodieties uz http://localhost (vai jūsu konfigurēto URL)
  16. Jums jāredz digna paneļa pieteikšanās lapa

Izvietošana uz Apache Tomcat

  1. Kopēt paneli uz Tomcat
  2. Nokopējiet dashboard mapi uz jūsu Tomcat webapps direktoriju
  3. Pārdēvējiet to pēc vajadzības (piem., uz digna)
  4. Piemērs: C:\Program Files\Apache Tomcat\webapps\digna

  5. Pārbaudīt izvietojumu

  6. Atsvaidziniet vai ielādējiet Tomcat pārvaldības lapu (http://localhost:8080)
  7. Jums jāredz "digna" (vai jūsu izvēlētais nosaukums) sarakstā ar izvietotajām lietotnēm

  8. Piekļūt panelim

  9. Atveriet pārlūkprogrammu
  10. Dodieties uz http://localhost:8080/digna
  11. Jums jāredz digna paneļa pieteikšanās lapa

digna palaide kā Windows serviss

Kāpēc izmantot Windows servisu?

digna backend darbināšana kā Windows serviss nodrošina, ka tas: - Automātiski startējas sistēmas boot laikā - Darbojas fonā bez atvērtas Command Prompt loga - Automātiski restartējas, ja notiek avārija - To var pārvaldīt caur Windows Services rīku

Komandas windows

Servisu pārvalda pats izpildāmais fails digna, izmantojot apakškomandas digna windows. Nekādi batch faili nav jāpalaiž.

Komanda Mērķis
digna windows install Reģistrē digna kā Windows servisu
digna windows start Palaiž reģistrēto servisu
digna windows stop Aptur darbojošos servisu
digna windows uninstall Atreģistrē servisu

Nepieciešamas administratīvās tiesības

Visas četras komandas jāpalaiž no Command Prompt, kas atvērts kā administrators.

Katra komanda pieņem --name, lai vērstos pie servisa, kas reģistrēts ar nenoklusējuma nosaukumu. Pilns opciju saraksts ir CLI rokasgrāmatā.

Servisa instalēšana

  1. Atveriet Command Prompt kā administrators
  2. Ar peles labo pogu klikšķiniet uz Command Prompt
  3. Izvēlieties "Run as Administrator"

  4. Pārejiet uz savu digna instalācijas direktoriju

    cd C:\path\to\digna
    

  5. Reģistrējiet servisu

    digna windows install
    

Norādiet adresi un portu, ja vien noklusējuma vērtības jums neder

install ieraksta adresi un portu servisa reģistrācijā, un serviss piesaistās tieši ierakstītajām vērtībām. Noklusējuma vērtības ir 127.0.0.1 un 8000, kas pieņem savienojumus tikai no pašas mašīnas. Panelis citā resursdatorā tām nevar piekļūt, tāpēc norādiet adresi, kurā backend jāklausās:

digna windows install --address 0.0.0.0 --port 8082

Šīs vērtības netiek nolasītas no config.toml. Lai tās vēlāk mainītu, atinstalējiet servisu un instalējiet to vēlreiz ar jaunajām vērtībām.

Serviss tiek reģistrēts ar automātisku startēšanu, tāpēc tas startēsies kopā ar Windows. Tas netiek palaists uzreiz — skatiet nākamo sadaļu.

Instalēšanas opcijas

Opcija Noklusējums Mērķis
--name digna Nosaukums, ar kādu reģistrēt servisu
--display-name digna Nosaukums, kas tiek rādīts services.msc
--description digna data quality backend Apraksts, kas tiek rādīts services.msc
--address 127.0.0.1 Adrese, kurai serviss piesaista savu API
--port 8000 Ports, kuram serviss piesaista savu API
--working-dir izpildāmā faila digna direktorija Direktorija, kurā atrodas config.toml un license.toml un kuru serviss izmanto kā darba direktoriju
--start-type auto auto startējas kopā ar Windows, manual startējas tikai pēc pieprasījuma, disabled reģistrē servisu, taču atsakās to startēt
--account LocalSystem Konts, ar kuru darbināt servisu, piem., DOMAIN\user vai .\user
--password --account parole

Darbināšana ar domēna kontu

LocalSystem nav tīkla identitātes, tāpēc Windows autentifikācija pret SQL Server un jebkāda piekļuve tīkla koplietojumam neizdosies. Instalējiet ar --account un --password, ja servisam resursiem jāpiekļūst kā konkrētam lietotājam.

Servisa palaišana un apturēšana

Lai palaistu servisu

digna windows start

Lai apturētu servisu

digna windows stop

Padoms

Vienmēr apturiet servisu, pirms atjaunināt lietojumprogrammas failus.

Pārvietot servisu uz jaunu direktoriju

Ja nepieciešams pārvietot digna instalāciju:

  1. Apturēt un atreģistrēt esošo servisu

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

  2. Pārvietot aplikācijas failus

  3. Pārvietojiet visu digna instalācijas mapi uz jauno atrašanās vietu

  4. Reģistrēt servisu no jauna no jaunās atrašanās vietas

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

Atkārtojiet visas --address, --port vai --account vērtības, ko izmantojāt pirmajā reizē — iepriekšējā reģistrācija vairs nepastāv.

  1. Palaist servisu
    digna windows start
    

Servisa atinstalēšana

  1. Apturēt darbojošos servisu

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

  2. Atreģistrēt servisu

    digna windows uninstall
    

digna serveris tagad vairs nav reģistrēts kā Windows serviss.


Jaunināšana uz jaunu izlaidumu

Pirms jaunināšanas

Vispirms pārbaudiet visus datubāžu savienojumus

Sākot ar laidienu 2026.06, digna katru avota tehnoloģiju sasniedz caur ODBC. Iepriekšējie laidieni piedāvāja izvēli starp katrai tehnoloģijai pašu draiveri un ODBC, ko izvēlējās ar slēdzi Use ODBC. digna komanda nolēma balstīties tikai uz ODBC, jo viena standarta saskarne sniedz vairāk nekā pēc pasūtījuma veidotu draiveru kopums:

  • Autentifikācija — autentifikācija ir daļa no ODBC, tāpēc savienojums var izmantot visu, ko atbalsta tā draiveris: paroles, pilnvaras un PAT, Kerberos un Active Directory, MFA un pārlūkprogrammas vienoto pieteikšanos, mākoņa identitātes, klienta sertifikātus un TLS. Jaunas metodes nāk līdzi draivera atjauninājumam, nevis gaidot digna laidienu.
  • Draiveri, ko uztur datubāžu ražotāji — ražotāja draiveris seko jaunām servera versijām un drošības labojumiem, un jūs varat to atjaunināt pēc sava grafika, neatkarīgi no digna.
  • Viens veids, kā konfigurēt visu — katra tehnoloģija ir atslēgu un vērtību īpašību saraksts ar to pašu saskarni, to pašu sensitīvo vērtību šifrēšanu un to pašu problēmu novēršanu, nevis atšķirīgu lauku kopu katram avotam.
  • Pielāgošana un aptvērums — draivera opcijas, piemēram, noildzes, TLS iestatījumi, starpniekserveri un ielādes izmēri, ir pieejamas katram avotam, un pievienot var jebkuru tehnoloģiju ar atbilstošu ODBC draiveri, arī tādu, kurai digna nepublicē atsevišķu rokasgrāmatu.

Praksē tas nozīmē, ka slēdzis Use ODBC un atsevišķie resursdatora, porta, datubāzes, lietotāja un paroles lauki vairs nepastāv. Katrs savienojums, kas vēl neizmanto ODBC, ir jāpārceļ uz ODBC — automātiskas konvertēšanas nav, tāpēc ieplānojiet to pirms jaunināšanas:

  1. Pārskatiet katru jūsu instalācijā definēto datubāzes savienojumu un atzīmējiet tos, kas vēl neizmanto ODBC — katrs no tiem būs jākonfigurē no jauna.
  2. Instalējiet atbilstošo ODBC draiveri digna resursdatorā — savienojumi tiek atvērti no servera, kurā darbojas digna aizmugure, nevis no pārlūkprogrammas. Skatiet ODBC draivera instalēšana digna resursdatorā.
  3. Sagatavojiet ODBC īpašības katram skartajam savienojumam. Tehnoloģiju rokasgrāmatas katram avotam norāda pārbaudītu īpašību kopu.

Pēc jaunināšanas katru skarto savienojumu pārceliet uz ODBC un pārbaudiet to no informatīvajā paneļa — skatiet Datubāzes savienojuma izveide un Savienojuma pārbaude.

Databricks Legacy savienojumi

Databricks Legacy savienotājs šajā laidienā ir noņemts. Pārceliet šos savienojumus uz Databricks savienotāju.

Repozitārija (PostgreSQL) rezerves kopijas izveide ir obligāta

Pirms digna jaunināšanas veiciet rezerves kopiju sava repozitorija (PostgreSQL), lai izvairītos no datu zuduma. Rezerves kopija nodrošina atjaunošanas iespēju, ja jaunināšanas laikā rodas neparedzētas problēmas.

Jaunināšanas process

1. solis: Apturēt un atreģistrēt veco servisu

Ja digna darbojas kā Windows serviss, apturiet to ar pašreizējās instalācijas batch failiem — komandas digna windows pieder jaunajam laidienam un vēl nav pieejamas:

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

Pēc tam atreģistrējiet servisu, atkal ar veco batch failu. Reģistrācija norāda uz veco izpildāmo failu un tā skriptiem, un šī jaunināšana aizstāj abus, tāpēc to nevar izmantot atkārtoti:

uninstall_service.bat

Atreģistrējiet, pirms kaut ko pārdēvējat

uninstall_service.bat atrodas bin mapē, kuru jūs tūlīt pārdēvēsiet, un tas ir vienīgais, kas var noņemt tā izveidoto reģistrāciju. Palaidiet to, kamēr vecā instalācija vēl ir savā vietā. Ja mape jau ir pārdēvēta, pārdēvējiet to atpakaļ, atreģistrējiet servisu un tad turpiniet.

Pierakstiet kontu, ar kuru serviss darbojās, kā arī adresi un portu, kurā tas apkalpoja — tie jums būs vajadzīgi 9. solī.

2. solis: Izveidojiet pašreizējās instalācijas dublējumu

Savā digna instalācijas direktorijā pārdēvējiet pašreizējās instalācijas mapes, lai jauno laidienu varētu izvietot tiem līdzās:

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

dignabackend un dignacli vairs netiek izmantoti

Sākot ar laidienu 2026.06, dignabackend un dignacli aizstāj viens izpildāmais fails digna, kas apvieno aizmuguri un CLI. Saglabājiet dignabackend_old un dignacli_old tikai līdz brīdim, kad esat pārbaudījis jauninājumu — pēc tam varat izdzēst abas mapes. Saglabājiet dashboard_old, līdz esat no tās atjaunojis savus konfigurācijas failus (skatiet 4. soli). Arī mape bin vairs nav vajadzīga: tās batch faili vadīja veco servisu, un 2026.06 tos vairs nepiegādā, tāpēc pēc servisa atreģistrēšanas 1. solī tie var tikai maldināt.

3. solis: Izpakot un izvietot jauno versiju

  1. Izpakojiet jauno digna instalācijas ZIP failu
  2. Kopējiet jauno digna izpildāmo failu un dashboard mapi uz jūsu instalācijas direktoriju

Svarīgi

Ne config.toml, ne dashboard/dashboard_config.toml nekad netiek iekļauts instalācijas ZIP — digna komanda nekad nepiegādā nevienu no šiem failiem. Tāpēc jaunināšana jūsu esošo konfigurāciju neskar, un kopijas pārdēvētajās *_old mapēs ir vienīgās, kas jums ir.

4. solis: Atjaunot jūsu konfigurācijas failus

copy dashboard_old\dashboard_config.toml dashboard\dashboard_config.toml

Laidiens 2026.06 maina config.toml

Trīs iestatījumi ir jauni un obligāti, bet divi vairs netiek izmantoti. No iepriekšējā laidiena pārņemtā config.toml nesatur jaunos iestatījumus, un digna nestartēs, kamēr to trūks. Pievienojiet savam esošajam config.toml šādu:

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Pievienojiet divas [base] atslēgas savai esošajai [base] sadaļai un pievienojiet [encryption] kā jaunu sadaļu. Pēc tam noņemiet no [app] divus iestatījumus, kas vairs netiek izmantoti, digna_APP_HOST un digna_APP_PORT — adresi un portu serveris tagad iegūst no digna serve.

Ko dara katrs iestatījums, apraksīts sadaļā Aizmugures konfigurācija.

Vienotā pieteikšanās: [oidc_clients] formāts ir mainījies

Laidiens 2026.06 aizstāj tabulu masīvu ar vienu tabulu katram nodrošinātājam, nosauktu pēc nodrošinātāja atslēgas. DIGNA_OIDC_KEY vairs nav — atslēga tagad ir sadaļas virsraksta daļa.

Pirms:

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

Pēc:

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

Atkārtojiet sadaļu katram nodrošinātājam un saglabājiet katru atslēgu tādu pašu kā key failā dashboard_config.toml. digna config check ziņo par oidc_clients kā FAILED, kamēr saglabājas vecā forma. Tas skar tikai instalācijas, kas izmanto vienoto pieteikšanos.

5. solis: Pārlādēt tīmekļa serveri

Panelis ir statisku failu kopums, tāpēc jūsu tīmekļa serveris — un pārlūkprogramma — joprojām var pasniegt iepriekšējo versiju. Pārlādējiet vai restartējiet tīmekļa serveri, kurā mitināta mape dashboard, un pēc tam pārlādējiet lapu ar pilnu atsvaidzināšanu (Ctrl+F5).

6. solis: Pārbaudiet konfigurāciju

Pirms pieskarties repozitorijam pārliecinieties, ka atjauninātais config.toml ir pilnīgs:

digna config check

Katrai sadaļai jāziņo OK. Izlabojiet visu, kas ziņots kā FAILED, un pirms turpināšanas palaidiet komandu vēlreiz.

7. solis: Aizstāt licences failu

Katram laidienam ir atsevišķa licence. Nokopējiet license.toml, ko digna komanda nodrošināja šim laidienam, instalācijas direktorijā, aizstājot veco:

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

Nepaturiet iepriekšējo licenci

Agrākam laidienam izsniegts license.toml neattiecas uz šo laidienu, un katra komanda, kas pārbauda licenci — user, inspection, repo —, tiek pārtraukta pirms pieskaršanās repozitorijam, ja pārbaude neizdodas. Pārbaudiet licenci, pirms turpināt:

digna license check

8. solis: Jaunināt repozitorija shēmu

Pārejiet uz jūsu digna instalācijas direktoriju un palaidiet:

digna repo upgrade

Tas atjauninās PostgreSQL shēmu uz jaunāko versiju, saglabājot visu esošo datu integritāti.

9. solis: Reģistrēt un palaist servisu

Vecā reģistrācija tika noņemta 1. solī, tāpēc serviss tiek reģistrēts no jauna — šoreiz ar izpildāmo failu digna, kuram batch failu nav:

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

Norādiet --address un --port tās vērtības, kurās apkalpoja vecais serviss, ja vien nevēlaties jaunās noklusējuma vērtības 127.0.0.1 un 8000; tās tiek ierakstītas reģistrācijā un vairs netiek nolasītas no config.toml. Pievienojiet --account un --password, ja vecais serviss darbojās ar domēna kontu. Pilnu opciju sarakstu skatiet sadaļā digna palaide kā Windows serviss.

Ja darbināt manuāli, restartējiet serveri:

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

Ja izmantojat IIS vai Tomcat, restartējiet attiecīgo tīmekļa serveri.

10. solis: Pārbaudīt jaunināšanu

  1. Piekļūstiet digna panelim
  2. Pārbaudiet, vai saskarne ielādējas pareizi
  3. Pārskatiet servera žurnālus, vai nav kļūdu
  4. Pārceliet uz ODBC katru savienojumu, kas to vēl neizmantoja, un pēc tam pārbaudiet visus savienojumus — skatiet Savienojuma pārbaude