Windows instalācijas ceļvedis digna Release 2026.06¶
Izlaidums: 2026.06
Pēdējais atjauninājums: 2026. gada 30. augusts
Saturs¶
- Ievads
- Sistēmas prasības
- Priekšinstalācijas sagatavošana
- PostgreSQL servera iestatīšana
- Tīmekļa servera konfigurācija
- Sākotnējā instalācija
- Backend konfigurācija
- Paneļa konfigurācija
- digna palaide kā Windows serviss
- 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
dignabackendundignacli. - 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:
- PostgreSQL Server – aprēķināto metrikas un veiktspējas datu glabāšanai
- 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¶
- Apmeklējiet PostgreSQL lejupielādes lapu
- Izvēlieties Windows
- Lejupielādējiet jaunāko instalatoru
2. solis: Palaist instalatoru¶
- Veiciet dubultklikšķi uz lejupielādētā instalatora faila
- 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:
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¶
- Atveriet Vadības paneli
- Nospiediet
Win + R -
Ierakstiet
controlun nospiediet Enter -
Pārejiet uz Windows funkcijām
- Noklikšķiniet Programs
-
Izvēlieties Turn Windows features on or off
-
Ieslēdziet Internet Information Services
- Ritiniet un atrodiet Internet Information Services (IIS)
- Atzīmējiet izvēles rūtiņu, lai to ieslēgtu
-
Noklikšķiniet uz +, lai izvērstu un pārbaudītu, vai ir atlasītas šādas apakškomponentes:
- Web Management Tools
- World Wide Web Services
-
Noklikšķiniet OK, lai piemērotu izmaiņas
-
Pārbaudīt IIS instalāciju
- Atveriet pārlūkprogrammu
- Dodieties uz
http://localhost - 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:
- Atveriet IIS Manager (nospiediet
Win + R, ierakstietinetmgr, nospiediet Enter) - Pārejiet uz Your Site > MIME Types
- Noklikšķiniet Add...
- Konfigurējiet:
- File name extension:
.md - 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¶
- Lejupielādēt Apache Tomcat
- Apmeklējiet Apache Tomcat Downloads
-
Lejupielādējiet Windows ZIP izplatījumu
-
Izpakot arhīvu
- Izpakojiet ZIP failu direktorijā uz jūsu sistēmas
-
Piemērs:
C:\Program Files\Apache Tomcat -
Pārbaudīt, vai Tomcat darbojas
- Atveriet pārlūkprogrammu
- Dodieties uz
http://localhost:8080 - 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¶
- Atrodiet jums nodoto digna instalācijas ZIP failu
- Izpakojiet to vēlamajā instalācijas vietā
- Pēc izpakošanas jums jāredz sekojošas vienības:
dashboard/— tīmekļa paneļa saskarnedigna— 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.
- Atrodiet jums nodoto
license.tomlfailu - Kopējiet to uz digna instalācijas saknes direktoriju (tur, kur atrodas
config.tomlun izpildāmaisdigna)
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.
| 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:
| 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:
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¶
- Atveriet Command Prompt
- Pārejiet uz jūsu digna instalācijas direktoriju (tur, kur atrodas
config.tomlun izpildāmaisdigna) - Palaidiet savienojuma pārbaudi:
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:
Šī komanda instalē nepieciešamās tabulas un shēmu jūsu PostgreSQL datubāzē.
5. solis: Izveidot administratora lietotāju¶
- Atveriet jaunu Command Prompt logu
- Pārejiet uz jūsu digna instalācijas direktoriju
- Palaidiet šādu komandu, lai izveidotu administratora lietotāju:
Piemērs:
Šī 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:
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¶
- Atveriet IIS Manager
-
Nospiediet
Win + R, ierakstietinetmgr, nospiediet Enter -
Izveidot jaunu vietni
- Kreisajā panelī ar peles labo pogu klikšķiniet uz Sites
-
Izvēlieties Add Website...
-
Konfigurēt vietni
- Site Name: Ievadiet nosaukumu (piem., "dignaDashboard")
- Physical Path: Noklikšķiniet Browse un izvēlieties jūsu
dashboardmapi -
Binding: Iestatiet IP adresi un portu (noklusējuma ports HTTP — 80, HTTPS — 443)
-
Startēt vietni
- Noklikšķiniet OK, lai izveidotu vietni
-
Ar peles labo pogu klikšķiniet uz jaunizveidotās vietnes un izvēlieties Start
-
Pārbaudīt instalāciju
- Atveriet pārlūkprogrammu
- Dodieties uz
http://localhost(vai jūsu konfigurēto URL) - Jums jāredz digna paneļa pieteikšanās lapa
Izvietošana uz Apache Tomcat¶
- Kopēt paneli uz Tomcat
- Nokopējiet
dashboardmapi uz jūsu Tomcatwebappsdirektoriju - Pārdēvējiet to pēc vajadzības (piem., uz
digna) -
Piemērs:
C:\Program Files\Apache Tomcat\webapps\digna -
Pārbaudīt izvietojumu
- Atsvaidziniet vai ielādējiet Tomcat pārvaldības lapu (http://localhost:8080)
-
Jums jāredz "digna" (vai jūsu izvēlētais nosaukums) sarakstā ar izvietotajām lietotnēm
-
Piekļūt panelim
- Atveriet pārlūkprogrammu
- Dodieties uz
http://localhost:8080/digna - 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¶
- Atveriet Command Prompt kā administrators
- Ar peles labo pogu klikšķiniet uz Command Prompt
-
Izvēlieties "Run as Administrator"
-
Pārejiet uz savu digna instalācijas direktoriju
-
Reģistrējiet servisu
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:
Šī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¶
Lai apturētu servisu¶
Padoms
Vienmēr apturiet servisu, pirms atjaunināt lietojumprogrammas failus.
Pārvietot servisu uz jaunu direktoriju¶
Ja nepieciešams pārvietot digna instalāciju:
-
Apturēt un atreģistrēt esošo servisu
-
Pārvietot aplikācijas failus
-
Pārvietojiet visu digna instalācijas mapi uz jauno atrašanās vietu
-
Reģistrēt servisu no jauna no jaunās atrašanās vietas
Atkārtojiet visas --address, --port vai --account vērtības, ko izmantojāt pirmajā reizē — iepriekšējā reģistrācija vairs nepastāv.
- Palaist servisu
Servisa atinstalēšana¶
-
Apturēt darbojošos servisu
-
Atreģistrēt servisu
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:
- 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.
- 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ā.
- 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:
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:
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:
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¶
- Izpakojiet jauno digna instalācijas ZIP failu
- Kopējiet jauno
dignaizpildāmo failu undashboardmapi 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¶
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:
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:
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:
8. solis: Jaunināt repozitorija shēmu¶
Pārejiet uz jūsu digna instalācijas direktoriju un palaidiet:
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:
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:
Ja izmantojat IIS vai Tomcat, restartējiet attiecīgo tīmekļa serveri.
10. solis: Pārbaudīt jaunināšanu¶
- Piekļūstiet digna panelim
- Pārbaudiet, vai saskarne ielādējas pareizi
- Pārskatiet servera žurnālus, vai nav kļūdu
- Pārceliet uz ODBC katru savienojumu, kas to vēl neizmantoja, un pēc tam pārbaudiet visus savienojumus — skatiet Savienojuma pārbaude