macOS-i paigaldusjuhend digna väljalase 2026.06¶

Väljalase: 2026.06

Viimati uuendatud: 5. september 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.06¶

See versioon toob andmevaatlevuse funktsioonid otse teie koodi, võimaldades arendajatel jälgida andmekvaliteeti allikal. Täpsemate muudatuste ja detailide jaoks vaadake väljalasete märkmeid.

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.06-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 digna backend'i rakenduse sätted:

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

[base] jaotis¶

See jaotis sisaldab turva- ja küpsise seadeid:

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

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

Overall: OK

Parandage kõik, millest teatatakse FAILED, ja käivitage käsk enne jätkamist uuesti. 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

Peate nägema kinnitust, et ühendus on loodud (andmehoidla ise pole veel inicialiseeritud).

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

Samm 4: Paigaldage andmehoidla skeem¶

Samas kataloogis käivitage:

./digna repo install

See käsk paigaldab vajalikud tabelid ja skeemi teie PostgreSQL andmebaasi.

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 - --port — serveri port

Te peaksite nägema käivitussõnumeid, mis kinnitavad serveri tööd:

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

Enne uuendamist¶

Kontrollige esmalt kõiki andmebreaühendusi

Alates väljalaskest 2026.06 jõuab digna iga lähtetehnoloogiani ODBC kaudu. Varasemad väljalasked pakkusid valikut tehnoloogiapõhise draiveri ja ODBC vahel, mille valis lüliti Use ODBC. digna meeskond otsustas toetuda ainult ODBC-le, sest üks standardne liides annab rohkem kui hulk eritellimusel draivereid:

• Autentimine — autentimine on osa ODBC-st, seega saab ühendus kasutada kõike, mida tema draiver toetab: paroole, lubasid ja PAT-e, Kerberost ja Active Directoryt, MFA-d ja brauseripõhist ühekordset sisselogimist, pilveidentiteete, kliendisertifikaate ja TLS-i. Uued meetodid saabuvad koos draiveri uuendusega, mitte digna väljalaset oodates.
• Andmebaasitootjate hooldatavad draiverid — tootja enda draiver järgib uusi serveriversioone ja turvaparandusi ning te saate seda uuendada oma ajakava järgi, dignast sõltumatult.
• Üks viis kõike seadistada — iga tehnoloogia on võti-väärtus omaduste loend, sama liidese, sama tundlike väärtuste krüpteerimise ja sama tõrkeotsinguga, mitte erineva väljade komplektiga iga allika kohta.
• Häälestus ja ulatus — draiveri valikud nagu ajalõpud, TLS-i seaded, puhverserverid ja lugemismahud on saadaval iga allika jaoks ning ühendada saab iga tehnoloogia, millel on nõuetekohane ODBC draiver, sealhulgas need, mille kohta digna eraldi juhendit ei avalda.

Praktikas tähendab see, et lülitit Use ODBC ning eraldi hosti, pordi, andmebaasi, kasutaja ja parooli välju enam ei ole. Iga ühendus, mis veel ODBC-d ei kasuta, tuleb viia üle ODBC-le — automaatset teisendust ei ole, seega planeerige see enne uuendamist:

1. Vaadake läbi iga teie paigalduses määratud andmebaasiühendus ja märkige üles need, mis veel ODBC-d ei kasuta — igaüks neist tuleb uuesti seadistada.
2. Paigaldage vastav ODBC draiver digna hostile — ühendused avatakse serverist, kus töötab digna taustasüsteem, mitte brauserist. Vaadake ODBC draiveri paigaldamine digna hostile.
3. Hoidke ODBC omadused iga puudutatud ühenduse jaoks valmis. Tehnoloogiajuhendid loetlevad iga allika kohta läbi proovitud omaduste komplekti.

Pärast uuendamist viige iga puudutatud ühendus üle ODBC-le ja testige seda ttöölaualt — vaadake Andmebaasiühenduse loomine ja Ühenduse testimine.

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

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 kaustad ümber, et uut väljalaset saaks nende kõrvale paigaldada:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

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

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, et uuendatud config.toml on täielik, enne kui hoidlat puudutate:

./digna config check

Iga sektsioon peab teatama OK. Parandage kõik, millest teatatakse FAILED, ja käivitage käsk enne jätkamist uuesti.

Samm 7: Asendage litsentsifail¶

Iga väljalase litsentsitakse eraldi. Kopeerige digna meeskonna poolt selle väljalaske 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¶

Navigeerige digna paigalduskataloogi ja käivitage:

cd /opt/digna
./digna repo upgrade

See uuendab PostgreSQL skeemi uusimale versioonile, säilitades kogu olemasoleva andmestiku.

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. Avage digna armatuurlaud
2. Veenduge, et liides laeb korrektselt
3. Kontrollige serveri logisid võimalike vigade osas
4. Viige üle ODBC-le iga ühendus, mis seda veel ei kasutanud, ja testige seejärel kõiki ühendusi — vaadake Ühenduse testimine