macOS-i paigaldusjuhend digna väljalase 2026.11¶

Väljalase: 2026.11

Viimati uuendatud: 7. november 2026

Sisukord¶

1. Sissejuhatus
2. Süsteeminõuded
3. Eelpaigalduse seadistus
4. PostgreSQL serveri seadistus
5. Veebiserveri konfiguratsioon
6. Esialgne paigaldus
7. Backend'i konfiguratsioon
8. Armatuurlaua konfiguratsioon
9. digna käitamine taustateenusena
10. Uuendamine uuele versioonile

Sissejuhatus¶

digna kohta¶

digna on põhjalik AI-põhine platvorm, mis on loodud andmekvaliteedi haldamise optimeerimiseks erinevates andmekeskkondades, nagu andmelaod, andmejärved ja lakehoused. See on üles ehitatud skaleeritavaks ja kohanemisvõimeliseks, pakkudes automatiseerimist, reaalajas jälgimist ja anomaaliate tuvastamist kaasaegsete andmeväljakutsete lahendamiseks.

digna koosneb kahest peamisest komponendist:

• digna: rakenduse tuum, mis vastutab andmete töötlemise ja kvaliteedikontrollide läbiviimise eest. See ühendab taustasüsteemi ja käsurealiidese üheks käivitatavaks failiks ning asendab varasemate väljalasete eraldi programmid dignabackend ja dignacli.
• dignadashboard: veebi-liides, mida majutab veebiserver ja mis pakub kasutajasõbralikku viisi digna platvormiga suhtlemiseks ning andmekvaliteedi mõõdikute visualiseerimiseks.

Mis on uut versioonis 2026.11¶

See väljalase toob kaasa uued moodulid digna Data Reconciliation ja digna Agentic (koos serveriga digna MCP Server) ning komponendi digna Engine, mis suudab andmeid profileerida digna sees ja kontrollida viidete terviklikkust eri andmebaasitehnoloogiate vahel. Täielikud andmed leiate väljalaske märkmetest.

Paigalduse jaoks toob väljalase uue hoidla migratsioonimehhanismi, komponendi digna Engine jaoks valikulise sektsiooni [duckdb] failis config.toml ning uue litsentsifaili. Neid kõiki käsitleb uuendamise jaotis.

Otsite Windowsi või Linuxi?¶

See juhend käsitleb macOS-i. Muude platvormide jaoks vaadake Windowsi paigaldusjuhendit või Linuxi paigaldusjuhendit.

Süsteeminõuded¶

Enne paigaldusega alustamist veenduge, et teie süsteem vastab järgmistele miinimumnõuetele:

Andmebaasi paigaldusvalikud¶

Kui PostgreSQL on juba paigaldatud: Võite lisada uue andmebaasi digna jaoks olemasolevale PostgreSQL serverile.

Kui paigaldate PostgreSQL sama masinasse, kus jookseb digna:

Arhitektuuri kontrollimine¶

Selles juhendis erinevad mõned käsud Apple Silicon ja Intel masinate vahel. Oma masina arhitektuuri kontrollimiseks avage Terminal ja käivitage:

uname -m

• arm64 — Apple Silicon. Homebrew paigaldatakse kataloogi /opt/homebrew.
• x86_64 — Intel. Homebrew paigaldatakse kataloogi /usr/local.

Eelpaigalduse seadistus¶

Enne digna paigaldamist veenduge, et kolm peamist sõltuvust on olemas:

1. Homebrew – pakettide haldur, mida kasutatakse allolevate komponentide paigaldamiseks
2. PostgreSQL Server – arvutatud mõõdikute ja jõudlusandmete talletamiseks
3. Veebiserver – digna armatuurlaua majutamiseks

Kui need komponendid pole veel paigaldatud, järgige alljärgnevaid jaotisi nende paigaldamiseks ja konfigureerimiseks.

Homebrew paigaldamine¶

Homebrew on macOS-i standardne pakettide haldur ja seda kasutatakse kogu juhendis PostgreSQL-i ja nginx-i paigaldamiseks.

Samm 1: Kontrollige, kas Homebrew on juba paigaldatud¶

Avage Terminal (vajutage Cmd + Space, tippige Terminal, vajutage Enter) ja käivitage:

brew --version

Kui tagastatakse versiooninumber, jätkake järgmisse jaotisesse PostgreSQL serveri seadistus.

Samm 2: Paigaldage Homebrew¶

Kui käsk ei leidnud Homebrew'd, paigaldage see, järgides ametliku Homebrew saidi juhiseid. Installer paigaldab ka Xcode Command Line Tools, kui need puuduvad.

Samm 3: Lisage Homebrew PATH-i¶

Apple Siliconil kuvab installer kaks käsku, et lisada Homebrew teie shelli keskkonda. Käivitage need vastavalt juhistele ja kinnitage seejärel:

brew --prefix

See peaks Apple Siliconil kuvama /opt/homebrew või Inteli puhul /usr/local.

PostgreSQL serveri seadistus¶

Kui teil on PostgreSQL juba olemas¶

Kui PostgreSQL on juba teie lokaalses masinas paigaldatud ja töötav või kasutate hallatud kaug-PostgreSQL serverit, võite edasi minna järgmisse sektsiooni Veebiserveri konfiguratsioon.

Paigaldusvalikud¶

macOS pakub kahte lihtsat viisi PostgreSQL paigaldamiseks. Valige üks:

• Homebrew — käsurea paigaldus, soovitatav serveri juurutusteks
• Postgres.app — graafiline paigaldus, mugav kohaliku hindamise jaoks

PostgreSQL paigaldamine Homebrew abil¶

Samm 1: Paigaldage PostgreSQL formula¶

brew install postgresql@16

Samm 2: Lisage PostgreSQL PATH-i¶

Versioneeritud PostgreSQL formulad on keg-only, mis tähendab, et Homebrew ei lingi nende käske PATH-i automaatselt. Lisage need ise:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Samm 3: Käivitage PostgreSQL teenus¶

brew services start postgresql@16

See käivitab PostgreSQL kohe ja konfigureerib selle automaatselt käivituma uuesti sisselogimisel.

Samm 4: Kontrollige paigaldust¶

psql --version

Kui paigaldus õnnestus, kuvatakse PostgreSQL versioon.

Samm 5: Ühenduge serveriga¶

psql postgres

Samm 6: Kinnitage port¶

Vaikimisi PostgreSQL kuulab porti 5432. Kinnitamiseks:

psql postgres -c "SHOW port;"

Märkige väärtus üles — vajate seda digna backend'i seadistamisel.

PostgreSQL paigaldamine Postgres.app abil¶

Kui eelistate graafilist installi:

1. Laadige alla Postgres.app ja lohistage see kausta Applications
2. Avage rakendus ja klõpsake Initialize, et luua uus server
3. Järgige rakenduse juhiseid, et lisada selle käsurea tööriistad PATH-i
4. Kontrollige paigaldust:

psql --version

Postgres.app loob samuti superkasutaja, milleks on teie macOS konto nimi.

Veebiserveri konfiguratsioon¶

digna vajab armatuurlaua majutamiseks veebiserverit. Valige üks järgmistest:

• nginx — paigaldatakse Homebrew kaudu, soovitatav
• Apache httpd — kaasas macOS-iga

Te peate paigaldama ja konfigureerima ainult ühe neist serveritest.

Mõlemad jaotised seadistavad kahte asja, millest armatuurlaud sõltub:

• Ühe-leheküljeline rakenduse fallback, et lehekülje värskendamine ei tagastaks 404 viga
• .md MIME-tüüp, et Markdown-failid servedaksid korrektselt

nginx seadistus¶

Ülevaade¶

nginx on kerge ja kõrge jõudlusega veebiserver, sobib hästi digna staatilise armatuurlaua teenindamiseks.

Paigaldus¶

brew install nginx

nginx käivitamine¶

brew services start nginx

Paigalduse kontroll¶

1. Avage brauser
2. Minge aadressile http://localhost:8080
3. Peaksite nägema nginx tervituslehte

Saidi konfigureerimine armatuurlaua jaoks¶

Homebrew nginx-i konfiguratsioon sisaldab kõiki faile oma servers kataloogis. Looge digna jaoks eraldi konfiguratsioonifail sinna:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

Kleebi allolev konfiguratsioon, asendades /path/to/digna/dashboard tegeliku teega, kuhu olete lahtipakitud dashboard kausta pannud:

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Konfiguratsiooni rakendamine¶

Testige süntaksivigu ja laadige nginx uuesti:

nginx -t
brew services restart nginx

Apache httpd seadistus¶

Ülevaade¶

macOS sisaldab Apache httpd-d, seega paigaldust pole vaja. See on vaikimisi keelatud.

Apache käivitamine¶

sudo apachectl start

Paigalduse kontroll¶

1. Avage brauser
2. Minge aadressile http://localhost
3. Peaksite nägema teadet "It works!"

Nõutav: mod_rewrite lubamine¶

Armatuurlaud vajab URL-ide ümberkirjutamist. Avage Apache konfiguratsioon:

sudo nano /etc/apache2/httpd.conf

Leidke järgmine rida ja eemaldage juhtiv #, et see lahti kommenteerida:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Nõutav: .htaccess üle kirjutuste lubamine¶

Samas failis otsige <Directory "/Library/WebServer/Documents"> plokki ja muutke:

AllowOverride None

selleks:

AllowOverride All

Nõutav: MIME-tüüp Markdown-failide jaoks¶

Endiselt failis httpd.conf lisage järgmine rida, et Markdown-failid servedaksid õigesti:

AddType text/markdown .md

Konfiguratsiooni rakendamine¶

Kontrollige konfiguratsiooni süntaksivigu, seejärel taaskäivitage Apache:

sudo apachectl configtest
sudo apachectl restart

Esialgne paigaldus¶

Samm 1: Loo digna andmehoidla skeem ja kasutaja¶

digna andmehoidla (repository) salvestab kõik digna poolt arvutatud mõõdikud. See toimib keskse andmebaasina analüütilistele ja jõudlusandmetele.

Loo skeem ja kasutaja¶

Avage oma PostgreSQL klient (psql, pgAdmin või muu) ja täitke järgmised SQL käsud:

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

Asendage järgnevad kohatäited:

• <digna_repo_schema> — soovitud skeemi nimi (nt dignarepo)
• <digna_repo_user> — soovitud kasutajanimi (nt digna_user)
• <digna_repo_password> — selle kasutaja turvaline parool

Näide:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Terminalis ühe sammuna käivitamiseks:

psql postgres

Seejärel kleepige käsud postgres=# prompti ja väljumiseks tippige \q.

Samm 2: Pakkige digna paigalduspakett lahti¶

1. Leidke teile antud digna paigaldus ZIP-fail
2. Pakkige see oma soovitud asukohta — näiteks /opt/digna või ~/digna
3. Pärast lahtipakkimist peaksite nägema järgmisi üksusi:
4. dashboard/ — veebi armatuurlaua liides
5. digna — peamine käivitatav fail (backend + CLI kombineeritud)

Terminalist lahtipakkimiseks:

unzip digna-2026.11-macos.zip -d /opt/digna

Muutke käivitatav fail käivitatavaks¶

Sõltuvalt sellest, kuidas arhiiv edastati, ei pruugi käivitusbit säilida. Määrake see käsitsi:

cd /opt/digna
chmod +x digna

Kui macOS blokeerib rakenduse¶

Lehitsejad või meiliprogrammid märgistavad alla laetud failid karantiinitunnusega. Kui macOS teatab, et rakendust "ei saa avada, sest arendajat ei saa kinnitada", eemaldage karantiin atribuut installikataloogist:

xattr -dr com.apple.quarantine /opt/digna

Või avage System Settings → Privacy & Security, leidke blokeeritud element lehe allosas ja klõpsake Open Anyway.

Samm 3: Paigaldage litsentsifail¶

1. Leidke teile antud license.toml fail
2. Kopeerige see digna paigalduskataloogi (kus asuvad config.toml ja digna käivitatav fail)

Miks see tähtis on: Litsentsifail sisaldab teie kliendiandmeid, litsentsi aegumiskuupäeva ja digiallkirja. Ärge muutke seda faili — mis tahes muudatused kehtetuks muudavad selle.

Kataloogistruktuur pärast seadistust:

/opt/digna/
├── config.toml         (konfiguratsioonifail)
├── license.toml        (TEIE LITSENTSIFAIL - kopeerige siia)
├── digna               (peamine käivitatav fail)
├── bin/                (teenuse haldusskriptid)
└── dashboard/          (veebi liides)
    └── (dashboard failid)

Backend'i konfiguratsioon¶

Samm 1: Loo ja redigeeri konfiguratsioonifaili¶

config_template.toml fail on kaasas teie digna paigalduskataloogis. Vajalik on see ümber nimetada config.toml-iks.

cd /opt/digna
mv config_template.toml config.toml

Asukoht: /opt/digna/config.toml

Avage config.toml tekstiredaktoris ja konfigureerige iga alljärgnevas jaotises kirjeldatud sätet.

[app] jaotis¶

See jaotis seadistab armatuurlaua ja backendi vahelist päritoluülest ressursijagamist (CORS):

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

[repo] jaotis¶

See jaotis seadistab ühenduse PostgreSQL andmebaasiga:

[repo]
DIGNA_REPO_HOST = "localhost"
DIGNA_REPO_PORT = 5432
DIGNA_REPO_DB = "postgres"
DIGNA_REPO_SCHEMA = "dignarepo"
DIGNA_REPO_USER = "digna_user"
DIGNA_REPO_PASSWORD = "YourSecurePassword123!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

[base] jaotis¶

See jaotis sisaldab turbe-, küpsise- ja inspekteerimisseadeid:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

[encryption] sektsioon¶

See sektsioon sisaldab võtit, millega krüpteeritakse hoidlas talletatud tundlikud väärtused. See on kohustuslik — config check teatab sektsioonist [encryption] FAILED, kui võti puudub.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] jaotis¶

See jaotis seadistab logimise käitumise:

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

[duckdb] jaotis (valikuline)¶

Uus väljalaskes Release 2026.11. See jaotis määrab ressursid komponendile digna Engine, mis profileerib andmeid digna sees nende andmebaasiühenduste puhul, mille profileerimise asukoht on digna Engine, ning käitab viidete terviklikkuse kontrolle eri andmebaasiühendustel asuvate andmeallikate vahel. Vaadake Profileerimise asukoht.

Jaotis on valikuline. Ilma selleta kehtivad allolevad vaikeväärtused.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

Samm 2: Kontrollige konfiguratsiooni¶

Enne hoidla lähtestamist kontrollige, kas config.toml on täielik ja korrektselt üles ehitatud. Käivitage oma digna paigalduskataloogis:

digna config check

Iga sektsiooni kontrollitakse eraldi, nii et üks viga ei varja teiste olekut:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Parandage kõik, millest teatatakse FAILED, ja käivitage käsk enne jätkamist uuesti. Hoiatus WARNING rea Unknown keys all loetleb failis config.toml võtmed, mida digna ei loe; neil pole mingit mõju, seega eemaldage need või parandage nende kirjapilt. Täielik valikute loend on CLI viites.

Samm 3: Inicialiseerige andmehoidla ühendus¶

1. Avage Terminal
2. Navigeerige digna paigalduskataloogi (kus asuvad config.toml ja digna käivitatav fail)
3. Käivitage ühenduse test:

cd /opt/digna
./digna repo check

Uue skeemi puhul loob käsk ühenduse ja teatab seejärel, et hoidlat pole veel paigaldatud:

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

Selles etapis on see oodatud tulemus: see kinnitab, et digna jõuab PostgreSQL-i ja skeemini. Ühenduse- või autentimisviga viitab seevastu sektsioonile [repo] või PostgreSQL-i seadistusele.

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

Samm 4: Paigaldage andmehoidla skeem¶

Samas kataloogis käivitage:

./digna repo upgrade

See käsk paigaldab hoidla skeemi vajalikud tabelid ja lõpetab teatega:

✅ Repo schema 'dignarepo' is up to date.

Samm 5: Loo administraatori kasutaja¶

1. Avage uus Terminali aken
2. Navigeerige digna paigalduskataloogi
3. Käivitage järgmine käsk administraatori lisamiseks:

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

Näide:

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

See loob kasutaja e-posti aadressiga admin@example.com ja täielike administraatoriõigustega.

Samm 6: Käivitage digna server¶

Digna paigalduskataloogis käivitage serveriga:

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

Parameetrid: - --address — serveri host/ IP (vaikimisi 127.0.0.1) - --port — serveri port (vaikimisi 8000)

Kui server töötab, kuvab see aadressi, millel ta kuulab:

Server running on http://127.0.0.1:8082

Armatuurlaua konfiguratsioon¶

Samm 1: Paigaldage armatuurlaud veebiserverisse¶

digna armatuurlaud loeb oma konfiguratsiooni failist dashboard/dashboard_config.toml. See fail ei ole paigaldusega kaasas — loote selle kataloogi dashboard/ armatuurlaua failide kõrvale.

Selle sisu on kirjeldatud jaotises Ühekordne sisselogimine (SSO), kus faili ka vaja läheb: see sisaldab armatuurlaua pakutavaid sisselogimisvalikuid ning mitme instantsiga juurutuste puhul ühendust backendiga.

Valige veebiserver ja järgige vastavat juurutusprotseduuri.

Juurutamine nginx-i¶

Kui järgisite jaotist nginx seadistus, osutab serverblokk juba teie dashboard kaustale ja täiendavat kopeerimist ei ole vaja.

1. Kinnitage tee
2. Avage $(brew --prefix)/etc/nginx/servers/digna.conf

3. Veenduge, et root osutab õigesse lahtipakitud dashboard kausta

4. Veenduge, et kaust oleks loetav

   chmod -R a+rX /opt/digna/dashboard
   

5. Laadige nginx uuesti

   nginx -t
   brew services restart nginx
   

6. Testige paigaldust

7. Avage brauser
8. Minge aadressile http://localhost:8080 (või teie konfigureeritud URL)
9. Peaksite nägema digna armatuurlaua sisselogimislehte

Juurutamine Apache httpd-sse¶

1. Kopeerige armatuurlaud dokumentide juurkataloogi

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Lisa ümberkirjutusreeglid

Looge .htaccess fail juurutatud kausta, et armatuurlaua marsruudid säiliksid lehe värskendamisel:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Kleepige järgmine sisu:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Taaskäivitage Apache

   sudo apachectl restart
   

2. Ligipääs armatuurlaudadele

3. Avage brauser
4. Minge aadressile http://localhost/digna
5. Peaksite nägema digna armatuurlaua sisselogimislehte

digna käitamine taustateenusena¶

Miks käivitada digna teenusena?¶

digna backend'i käitamine taustateenusena tagab:

• Automaatse käivituse masina käivitamisel
• Töötamise taustal ilma avatud Terminali aknata
• Teenuse automaatse taaskäivituse krahhi korral
• Halduse läbi launchctl-i — macOS-i teenusehalduri

Teenuse haldusfailid¶

Kõik vajalikud failid asuvad digna paigalduskataloogis kaustas: bin/

Järgnevad shell-skriptid on saadaval:

• install_service.sh — registreerib digna launchd-ga
• uninstall_service.sh — tühistab teenuse registreerimise
• start_service.sh — käivitab registreeritud teenuse
• stop_service.sh — peatab jooksva teenuse

Skriptide käivitatavaks tegemine¶

Lahtipakkimine ei pruugi säilitada käivitusbitte. Enne esmast kasutust:

cd /opt/digna/bin
chmod +x *.sh

Teenuse paigaldamine¶

1. Avage Terminal

2. Minge bin kausta

   cd /opt/digna/bin
   

3. Käivitage paigaldusskript

   sudo ./install_service.sh
   

digna server on nüüd registreeritud launchd-sse koos automaatselt käivitamise seadega. Teenus ei pruugi kohe alata — vaadake järgmist jaotist, kuidas seda käivitada.

Teenuse käivitamine ja peatamine¶

Teenuse käivitamiseks¶

1. Avage Terminal
2. Navigeerige /opt/digna/bin
3. Käivitage:

   sudo ./start_service.sh
   

Teenuse peatamiseks¶

1. Avage Terminal
2. Navigeerige /opt/digna/bin
3. Käivitage:

   sudo ./stop_service.sh
   

Teenuse kontrollimine¶

Kontrollimaks, et teenus on registreeritud ja töötab:

sudo launchctl list | grep digna

Rida, mis algab protsessi ID-ga, tähendab, et teenus töötab. Kui esimeses veerus on -, siis on teenus registreeritud, kuid peatatud.

Teenuse liigutamine uude kataloogi¶

launchd salvestab käivitatava faili absoluutse tee, seega paigaldise ümberpaigutamine nõuab teenuse uuesti registreerimist:

1. Eemaldage praegune teenus

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Liigutage rakenduse failid

   sudo mv /old/path/digna /new/path/digna
   

3. Paigaldage teenus uuesti

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Käivitage teenus

   sudo ./start_service.sh
   

Teenuse desinstallimine¶

1. Peatage jooksva teenus

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Desinstallige teenus

   sudo ./uninstall_service.sh
   

digna server on nüüd launchd-st eemaldatud.

Uuendamine uuele versioonile¶

See jaotis uuendab Release 2026.06 paigalduse versioonile Release 2026.11. Kui teie paigaldus on vanem, lugege kõigepealt jaotist Uuendamine väljalaskest, mis on vanem kui 2026.06.

Enne uuendamist¶

digna andmehoidla varundamine on kohustuslik

Enne digna uuendamist varundage oma repository (PostgreSQL), et kaitsta andmete kaotsimineku eest. Varukoopia võimaldab taastada olukorra, kui uuenduse käigus tekib ootamatuid probleeme.

Varukoopia loomiseks Terminalis:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Release 2026.11 litsentsifaili taotlemine

Release 2026.11 vajab uut faili license.toml. Taotlege see digna meeskonnalt enne alustamist ja hoidke see sammu 7 jaoks valmis.

Uuendamine väljalaskest, mis on vanem kui 2026.06¶

Release 2026.06 tõi kolm muudatust, mis kehtivad endiselt, kui uuendate vanema paigalduse otse versioonile 2026.11:

• Ainult ODBC. digna jõuab iga lähtetehnoloogiani ODBC kaudu. Iga andmebaasiühendus, mis veel ODBC-d ei kasuta, tuleb pärast uuendamist ODBC-le üle viia; automaatset teisendust ei ole. Paigaldage ODBC draiverid digna hostile eelnevalt, vt ODBC draiveri paigaldamine digna hostile, ning hoidke iga ühenduse omadused tehnoloogiajuhenditest valmis. Databricks Legacy konnektorit enam ei ole; viige need ühendused üle Databricks konnektorile.
• Üks käivitatav fail. dignabackend ja dignacli on asendatud üheainsa käivitatava failiga digna, mis ühendab backendi ja CLI.
• config.toml. Sektsioon [encryption] on kohustuslik ning DIGNA_APP_HOST ja DIGNA_APP_PORT enam ei loeta: server võtab oma aadressi ja pordi käsult digna serve. Võrrelge oma faili jaotisega Backendi konfiguratsioon.

Allolevad sammud toovad välja, kus vanem paigaldus vajab midagi muud. Sammu 8 hoidla uuendus viib mis tahes varasema väljalaske hoidla otse versioonile 2026.11.

Uuenduse protsess¶

Samm 1: Peatage digna teenus¶

Kui digna töötab taustateenusena, peatage see esmalt:

cd /opt/digna/bin
sudo ./stop_service.sh

Kui digna töötab esiplaanil, vajutage selle Terminali aknas Ctrl+C.

Samm 2: Varundage praegune paigaldus¶

Nimetage oma digna paigalduskataloogis praeguse paigalduse käivitatav fail ja kaust dashboard ümber, et uut väljalaset saaks nende kõrvale paigaldada:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Hoidke digna_old alles, kuni olete uuenduse kontrollinud, ja dashboard_old, kuni olete sellest oma konfiguratsioonifailid taastanud (vt samm 4). Seejärel võite mõlemad kustutada.

Samm 3: Pakige lahti ja juurutage uus versioon¶

1. Pakkige lahti uus digna paigaldus ZIP-fail
2. Kopeerige uus digna käivitatav fail ja dashboard kaust oma paigalduskataloogi
3. Taastage käivitusbit ja vajadusel eemaldage karantiini atribuut:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

Samm 4: Taastage konfiguratsioonifailid¶

cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 ei vaja muudatusi failis config.toml: fail, mis töötab Release 2026.06-ga, töötab edasi. Kaks muudatust on valikulised:

• Lisage [duckdb] sektsioon, kui andmebaasiühendused peavad kasutama komponenti digna Engine ja selle vaikeväärtused teie hostile ei sobi.
• Jätke sektsioon [app] ära, kui pöördpuhverserver serveerib armatuurlaua ja backendi ühe päritolu all.

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

Samm 5: Laadige veebiserver uuesti¶

Armatuurlaud koosneb staatilistest failidest, seega võivad teie veebiserver — ja brauser — ikka veel serveerida eelmist versiooni. Laadige uuesti või taaskäivitage veebiserver, mis majutab kausta dashboard, ning seejärel laadige leht sundvärskendusega uuesti (Cmd+Shift+R).

Samm 6: Kontrollige konfiguratsiooni¶

Veenduge enne hoidla puudutamist, et config.toml on täielik:

./digna config check

Iga sektsioon peab teatama OK. Parandage kõik, millest teatatakse FAILED, eemaldage rea Unknown keys all loetletud võtmed ja käivitage käsk enne jätkamist uuesti.

Samm 7: Asendage litsentsifail¶

Litsentsifail kandub tavaliselt ühest väljalaskest järgmisse üle. Release 2026.11 on erand: see lisab kaks litsentsitavat moodulit, digna Data Reconciliation ja digna Agentic, ning enne 2026.11 väljastatud litsents neid ei sisalda. Kopeerige digna meeskonna poolt Release 2026.11 jaoks antud license.toml paigalduskataloogi, asendades vana faili:

cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Samm 8: Uuendage andmehoidla skeemi¶

Käivitage oma digna paigalduskataloogis:

cd /opt/digna
./digna repo upgrade

Release 2026.11 haldab hoidla skeemi versioonitud migratsioonidega. Esimene uuendus varasemast väljalaskest viib skeemi eelmise versioonimisskeemi viimasele versioonile, salvestab selle lähtepunktina ja rakendab seejärel Release 2026.11 migratsioonid. See lõpetab teatega:

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

Kõik olemasolevad andmed säilivad. Hoidla oleku nägemiseks igal ajal käivitage ./digna repo check: see loetleb viimase rakendatud migratsiooni ja kõik ootel migratsioonid.

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

Samm 9: Taaskäivitage teenused¶

Kui jooksed taustateenusena:

cd /opt/digna/bin
sudo ./start_service.sh

Kui jooksesid manuaalselt, käivitage server uuesti:

cd /opt/digna
./digna serve --address <address> --port <port>

Kui kasutate nginx-i või Apache-t, taaskäivitage vastav veebiserver:

brew services restart nginx

sudo apachectl restart

Samm 10: Kinnitage uuendus¶

1. Kontrollige uue käivitatava faili väljalaset:

   ./digna version
   

   Esimene rida peab olema Release: 2026.11.

2. Avage digna armatuurlaud ja veenduge, et liides laadib korrektselt.

3. Kontrollige serveri väljundit ja kataloogi logs faile vigade suhtes.
4. Testige oma andmebaasiühendusi — vaadake Ühenduse testimine. Pärast uuendamist väljalaskest, mis on vanem kui 2026.06, viige esmalt ODBC-le üle iga ühendus, mis seda veel ei kasutanud.

Uute moodulitega alustamiseks vaadake digna Data Reconciliation, digna MCP Serveri kohta AI-agendi ühendamine ja digna Engine'i kohta Profileerimise asukoht.