Navodila za namestitev na macOS za digna izdajo 2026.06¶

Izdaja: 2026.06

Zadnja posodobitev: 5. september 2026

Kazalo¶

1. Uvod
2. Sistemske zahteve
3. Prednamestitvena priprava
4. Nastavitev PostgreSQL strežnika
5. Konfiguracija spletnega strežnika
6. Začetna namestitev
7. Konfiguracija backend‑a
8. Konfiguracija nadzorne plošče
9. Zagon digna kot ozadnega servisa
10. Nadgradnja na novo izdajo

Uvod¶

O digna¶

digna je celovita platforma, vodena z umetno inteligenco, namenjena optimizaciji upravljanja kakovosti podatkov v različnih podatkovnih okoljih, kot so podatkovni skladi, podatkovna jezera in lakehouse‑i. Zasnovana je za visoko skalabilnost in prilagodljivost ter rešuje sodobne izzive podatkov s pomočjo avtomatizacije, spremljanja v realnem času in odkrivanja anomalij.

digna sestavljata dve glavni komponenti:

• digna: jedro aplikacije, odgovorno za obdelavo podatkov in izvajanje preverjanj kakovosti. Združuje zaledni del in vmesnik ukazne vrstice v eno samo izvršljivo datoteko ter nadomešča ločena programa dignabackend in dignacli iz prejšnjih izdaj.
• dignadashboard: spletni vmesnik gostovan na spletnem strežniku, ki omogoča enostavno interakcijo s platformo digna in vizualizacijo meritev kakovosti podatkov.

Novosti v izdaji 2026.06¶

Ta izdaja prinaša zmogljivosti opazovanja podatkov neposredno v vašo kodo, kar razvijalcem omogoča spremljanje kakovosti podatkov pri izvoru. Za popolne podrobnosti si oglejte opombe ob izdaji.

Iščete Windows ali Linux?¶

Ta vodič pokriva macOS. Za druge platforme si oglejte Windows Installation Guide ali Linux Installation Guide.

Sistemske zahteve¶

Preden začnete z namestitvijo, se prepričajte, da vaš sistem izpolnjuje naslednje minimalne zahteve:

Možnosti namestitve baze podatkov¶

Če je PostgreSQL že nameščen: Lahko dodate novo bazo za digna v obstoječi PostgreSQL strežnik.

Če nameščate PostgreSQL na isti stroj kot digna:

Preverjanje arhitekture¶

Nekateri poti v tem vodiču se razlikujejo za Apple Silicon in Intel Mac‑e. Da preverite, katero imate, odprite Terminal in zaženite:

uname -m

• arm64 — Apple Silicon. Homebrew se namesti v /opt/homebrew.
• x86_64 — Intel. Homebrew se namesti v /usr/local.

Prednamestitvena priprava¶

Pred namestitvijo digna poskrbite, da so prisotni trije ključni predpogoji:

1. Homebrew – paketni upravljalnik, uporabljen za namestitev spodnjih komponent
2. PostgreSQL Server – za shranjevanje izračunanih metrik in podatkov o zmogljivosti
3. Spletni strežnik – za gostovanje digna Dashboarda

Če ti sestavni delci še niso nastavljeni, sledite spodnjim razdelkom za namestitev in konfiguracijo.

Namestitev Homebrew¶

Homebrew je standardni upravljalnik paketov za macOS in se v celotnem vodiču uporablja za namestitev PostgreSQL in nginx.

Korak 1: Preverite, ali je Homebrew že nameščen¶

Odprite Terminal (pritisk Cmd + Space, vnesite Terminal, pritisnite Enter) in zaženite:

brew --version

Če je prikazana številka različice, preskočite na razdelek Nastavitev PostgreSQL strežnika.

Korak 2: Namestite Homebrew¶

Če ukaz ni najden, namestite Homebrew po navodilih na uradni strani Homebrew. Namestitveni program namesti tudi Xcode Command Line Tools, če še niso prisotni.

Korak 3: Dodajte Homebrew v svojo PATH¶

Na Apple Silicon instalator izpiše dva ukaza za dodajanje Homebrew v vaše okolje lupine. Zaženite jih po navodilih, nato potrdite:

brew --prefix

To bi moralo izpisati /opt/homebrew na Apple Silicon ali /usr/local na Intel.

Nastavitev PostgreSQL strežnika¶

Če že imate PostgreSQL¶

Če je PostgreSQL že nameščen in teče na lokalnem stroju ali če uporabljate upravljan oddaljen PostgreSQL strežnik, lahko preskočite na naslednji razdelek.

Možnosti namestitve¶

macOS ponuja dva preprosta načina za namestitev PostgreSQL. Izberite eno:

• Homebrew — namestitev prek ukazne vrstice, priporočena za strežniške namestitve
• Postgres.app — grafična namestitev, priročna za lokalno evalvacijo

Namestitev PostgreSQL z Homebrew¶

Korak 1: Namestite formulo PostgreSQL¶

brew install postgresql@16

Korak 2: Dodajte PostgreSQL v svojo PATH¶

Verzionirane formule PostgreSQL so keg-only, kar pomeni, da Homebrew njihovih ukazov samodejno ne poveže v vaš PATH. Dodajte jih sami:

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

Korak 3: Zaženite storitev PostgreSQL¶

brew services start postgresql@16

To takoj zažene PostgreSQL in ga nastavi, da se ob prijavi samodejno ponovno zažene.

Korak 4: Preverite namestitev¶

psql --version

Če je namestitev uspela, boste videli različico PostgreSQL.

Korak 5: Povežite se s strežnikom¶

psql postgres

Korak 6: Potrdite vrata¶

Privzeta pristanišče PostgreSQL je 5432. Za potrditev, na katerem priključku strežnik posluša:

psql postgres -c "SHOW port;"

Zabeležite vrednost — potrebovali jo boste pri konfiguraciji digna backend‑a.

Namestitev PostgreSQL z aplikacijo Postgres.app¶

Če imate raje grafični vmesnik:

1. Prenesite Postgres.app in ga povlecite v mapo Applications
2. Odprite aplikacijo in kliknite Initialize, da ustvarite nov strežnik
3. Sledite navodilom aplikacije za dodajanje njenih orodij ukazne vrstice v vaš PATH
4. Preverite namestitev:

psql --version

Postgres.app prav tako ustvari superuporabnika z imenom vašega macOS računa.

Konfiguracija spletnega strežnika¶

digna zahteva spletni strežnik za gostovanje nadzorne plošče. Izberite eno od naslednjih možnosti:

• nginx — nameščen prek Homebrew, priporočeno
• Apache httpd — vključen v macOS

Potrebujete le namestitev in konfiguracijo enega izmed teh strežnikov.

Oba razdelka konfigurirata dve stvari, od katerih je odvisna nadzorna plošča:

• Počasen fallback za enostransko aplikacijo (SPA), tako da osvežitev URL‑ja nadzorne plošče ne povzroči 404
• MIME tip za .md, da se Markdown datoteke strežejo pravilno

Nastavitev nginx¶

Pregled¶

nginx je lahek, zmogljiv spletni strežnik, primeren za streženje statične digna nadzorne plošče.

Namestitev¶

brew install nginx

Zagon nginx¶

brew services start nginx

Preverjanje namestitve¶

1. Odprite brskalnik
2. Pojdite na http://localhost:8080
3. Videzite pozdravno stran nginx

Konfiguracija mesta za nadzorno ploščo¶

Homebrew‑ova konfiguracija nginx vključi vse datoteke v imeniku servers. Ustvarite namensko konfiguracijsko datoteko za digna tam:

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

Prilepite naslednje in zamenjajte /path/to/digna/dashboard z dejansko potjo do razširjene mape dashboard:

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

Uveljavitev konfiguracije¶

Preverite konfiguracijo za sintaktične napake, nato ponovno naložite nginx:

nginx -t
brew services restart nginx

Nastavitev Apache httpd¶

Pregled¶

macOS vključuje Apache httpd, zato namestitev ni potrebna. Privzeto je onemogočen.

Zagon Apache¶

sudo apachectl start

Preverjanje namestitve¶

1. Odprite brskalnik
2. Pojdite na http://localhost
3. Videli boste sporočilo "It works!"

Obvezno: omogočite mod_rewrite¶

Nadzorna plošča zahteva prepisovanje URL‑jev. Odprite Apache konfiguracijo:

sudo nano /etc/apache2/httpd.conf

Poiščite naslednjo vrstico in odstranite vodilni #, da jo odkomentirate:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Obvezno: dovolite .htaccess preglasitve¶

V isti datoteki poiščite blok <Directory "/Library/WebServer/Documents"> in spremenite:

AllowOverride None

v:

AllowOverride All

Obvezno: MIME tip za Markdown datoteke¶

Še v httpd.conf dodajte naslednjo vrstico, da se Markdown datoteke strežejo pravilno:

AddType text/markdown .md

Uveljavitev konfiguracije¶

Preverite konfiguracijo za sintaktične napake, nato ponovno zaženite Apache:

sudo apachectl configtest
sudo apachectl restart

Začetna namestitev¶

Korak 1: Nastavite digna repozitorij¶

Repozitorij digna hrani vse meritve, izračunane z digna. Deluje kot centralna baza za analitične in zmogljivostne podatke.

Ustvarite shemo repozitorija in uporabnika¶

Odprite svoj PostgreSQL odjemalec (psql, pgAdmin ali podoben) in izvedite naslednje SQL ukaze:

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

Zamenjajte naslednje nadomestne vrednosti:

• <digna_repo_schema> — želeno ime sheme (npr. dignarepo)
• <digna_repo_user> — želeno uporabniško ime (npr. digna_user)
• <digna_repo_password> — varno geslo za tega uporabnika

Primer:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Za izvedbo teh ukazov iz Terminala v enem koraku:

psql postgres

Nato prilepite izjave na poziv postgres=# in vtipkajte \q, da zapustite.

Korak 2: Razširite namestitveni paket digna¶

1. Poiščite ZIP datoteko namestitvenega paketa digna, ki vam je bila posredovana
2. Razširite jo na želeno lokacijo namestitve — na primer /opt/digna ali ~/digna
3. Po razširitvi bi morali videti naslednje elemente:
4. dashboard/ — spletni vmesnik nadzorne plošče
5. digna — glavni izvršljivi program (backend + CLI skupaj)

Za razširitev iz Terminala:

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

Dovolite zagon izvršljive datoteke¶

Glede na način prenosa se izvršljiva bit morda ne ohrani. Nastavite ga izrecno:

cd /opt/digna
chmod +x digna

Če macOS blokira aplikacijo¶

Datoteke, prenesene prek brskalnika ali pošiljatelja, imajo lahko priponko karantene. Če macOS poroča, da aplikacije "ni mogoče odpreti, ker razvijalca ni mogoče preveriti", odstranite atribut iz namestitvenega imenika:

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

Alternativno odprite System Settings → Privacy & Security, poiščite blokirano postavko blizu dna strani in kliknite Open Anyway.

Korak 3: Namestite licenčno datoteko¶

1. Poiščite license.toml datoteko, ki vam je bila posredovana
2. Kopirajte jo v korenski imenik namestitve digna (kjer se nahajata config.toml in izvršljiva datoteka digna)

Zakaj je to pomembno: Licenčna datoteka vsebuje informacije o stranki, datum poteka licence in digitalni podpis. Ne spreminjajte te datoteke — vsaka sprememba jo bo razveljavila.

Struktura imenika po nastavitvi:

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

Konfiguracija backend‑a¶

Korak 1: Ustvarite in uredite konfiguracijsko datoteko¶

V namestitvenem imeniku digna je priložena datoteka config_template.toml. Preimenujete jo v config.toml.

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

Lokacija: /opt/digna/config.toml

Odprite config.toml v urejevalniku besedil in konfigurirajte vsak spodnji odsek.

Sekcija [app]¶

Ta sekcija konfigurira nastavitve digna backend aplikacije:

[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 = ["*"]

Sekcija [repo]¶

Ta sekcija konfigurira povezavo s PostgreSQL bazo podatkov:

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

Sekcija [base]¶

Ta sekcija vsebuje varnostne nastavitve in nastavitve piškotkov:

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

Sekcija [encryption]¶

Ta sekcija vsebuje ključ, s katerim so šifrirane občutljive vrednosti v repozitoriju. Je obvezna — config check sekcijo [encryption] javi kot FAILED, če ključ manjka.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Sekcija [logging]¶

Ta sekcija konfigurira vedenje beleženja:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Korak 2: Preverjanje Konfiguracije¶

Pred inicializacijo repozitorija preverite, ali je config.toml popoln in pravilno sestavljen. V namestitvenem imeniku digna zaženite:

digna config check

Vsaka sekcija se preveri posebej, tako da posamezna napaka ne prikrije stanja ostalih:

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

Odpravite vse, kar je javljeno kot FAILED, in pred nadaljevanjem ukaz poženite znova. Celoten seznam možnosti najdete v referenci CLI.

Korak 3: Inicializirajte repozitorij¶

1. Odprite Terminal
2. Pojdite v imenik namestitve digna (kjer sta config.toml in izvršljiva datoteka digna)
3. Zaženite test povezave:

cd /opt/digna
./digna repo check

Videli boste potrditev, da je povezava vzpostavljena (sam repozitorij še ni inicializiran).

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

Korak 4: Namestite shemo repozitorija¶

V istem imeniku zaženite:

./digna repo install

Ta ukaz namesti potrebne tabele in shemo v vašo PostgreSQL bazo podatkov.

Korak 5: Ustvarite skrbniškega uporabnika¶

1. Odprite novo okno Terminala
2. Pojdite v imenik namestitve digna
3. Zaženite naslednji ukaz za ustvarjanje skrbniškega uporabnika:

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

Primer:

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

S tem se ustvari uporabnik z e-poštnim naslovom admin@example.com in polnimi skrbniškimi pravicami.

Korak 6: Zaženite digna strežnik¶

V imeniku namestitve digna zaženite strežnik z:

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

Parametri: - --address — ime gostitelja/IP strežnika - --port — pristanišče strežnika

Videli boste začetna sporočila, ki potrjujejo zagon strežnika:

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

Konfiguracija nadzorne plošče¶

Korak 1: Razmestitev nadzorne plošče na spletni strežnik¶

Nadzorna plošča digna prebere svojo konfiguracijo iz datoteke dashboard/dashboard_config.toml. Ta datoteka ni priložena namestitvi — ustvarite jo v imeniku dashboard/ poleg datotek nadzorne plošče.

Njena vsebina je opisana v razdelku Enotna prijava (SSO), kjer je datoteka tudi potrebna: vsebuje možnosti prijave, ki jih ponuja nadzorna plošča, in pri večinstančnih nameščanjih povezavo na backend.

Izberite spletni strežnik in sledite ustreznim korakom za namestitev.

Razmestitev na nginx¶

Če ste sledili razdelku nginx Setup, strežniški blok že kaže na vašo mapo dashboard in kopiranje ni potrebno.

1. Potrdite pot
2. Odprite $(brew --prefix)/etc/nginx/servers/digna.conf

3. Preverite, da root kaže na vašo razširjeno mapo dashboard

4. Poskrbite, da je mapa berljiva

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

5. Ponovno naložite nginx

   nginx -t
   brew services restart nginx
   

6. Preizkus namestitve

7. Odprite brskalnik
8. Pojdite na http://localhost:8080 (ali vaš konfigurirani URL)
9. Videti bi morali prijavno stran digna nadzorne plošče

Razmestitev na Apache httpd¶

1. Kopirajte nadzorno ploščo v Document Root

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

2. Dodajte pravila za prepisovanje

Ustvarite .htaccess datoteko v razmestjeni mapi, da poti nadzorne plošče preživijo osvežitev brskalnika:

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

Prilepite naslednje:

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. Ponovno zaženite Apache

   sudo apachectl restart
   

2. Dostop do nadzorne plošče

3. Odprite brskalnik
4. Pojdite na http://localhost/digna
5. Videli bi morali prijavno stran digna nadzorne plošče

Zagon digna kot ozadnega servisa¶

Zakaj zagnati digna kot storitev?¶

Zagon digna backend‑a kot ozadnega servisa zagotavlja, da se:

• začne samodejno ob zagonu sistema
• teče v ozadju brez odprtega Terminal okna
• samodejno ponovno zažene v primeru zrušitve
• upravlja preko launchctl, upravitelja storitev macOS

Datoteke za upravljanje storitve¶

Vse potrebne datoteke so v imeniku namestitve digna v: bin/

Na voljo so naslednji shell skripti:

• install_service.sh — registrira digna pri launchd
• uninstall_service.sh — odstrani registracijo storitve
• start_service.sh — zažene registrirano storitev
• stop_service.sh — ustavi tekočo storitev

Naredite skripte izvršljive¶

Pri razširitvi morda izvršljiv bit ni ohranjen. Pred prvo uporabo:

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

Namestitev storitve¶

1. Odprite Terminal

2. Pojdite v mapo bin

   cd /opt/digna/bin
   

3. Zaženite namestitveni skript

   sudo ./install_service.sh
   

digna strežnik je zdaj registriran pri launchd z omogočenim samodejnim zagonom. Storitve se ne zažene neposredno — naslednji razdelek prikazuje, kako jo zagnati.

Zagon in ustavitev storitve¶

Za zagon storitve¶

1. Odprite Terminal
2. Pojdite v /opt/digna/bin
3. Zaženite:

   sudo ./start_service.sh
   

Zaustavitev storitve¶

1. Odprite Terminal
2. Pojdite v /opt/digna/bin
3. Zaženite:

   sudo ./stop_service.sh
   

Preverjanje storitve¶

Za potrditev, da je storitev registrirana in teče:

sudo launchctl list | grep digna

Vrstica, ki se začne s procesnim ID‑jem, pomeni, da storitev teče. - v prvem stolpcu pomeni, da je registrirana, a ustavljena.

Premik storitve v nov imenik¶

launchd shrani absolutno pot do izvršljive datoteke, zato premestitev namestitve zahteva ponovno registracijo storitve:

1. Odstranite obstoječo storitev

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

2. Premaknite aplikacijske datoteke

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

3. Ponovno namestite storitev

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

4. Zaženite storitev

   sudo ./start_service.sh
   

Odstranitev storitve¶

1. Ustavite tekočo storitev

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

2. Odstranite storitev

   sudo ./uninstall_service.sh
   

digna strežnik je sedaj odregistriran pri launchd.

Nadgradnja na novo izdajo¶

Pred nadgradnjo¶

Najprej Preverite Vse Podatkovne Povezave

Od izdaje 2026.06 digna do vsake izvorne tehnologije dostopa prek ODBC. Prejšnje izdaje so ponujale izbiro med gonilnikom za posamezno tehnologijo in ODBC, izbrano s stikalom Use ODBC. Ekipa digna se je odločila graditi izključno na ODBC, ker en sam standardni vmesnik ponuja več kot nabor gonilnikov po meri:

• Preverjanje pristnosti — preverjanje pristnosti je del ODBC, zato lahko povezava uporabi vse, kar podpira njen gonilnik: gesla, žetone in PAT-e, Kerberos in Active Directory, MFA in enotno prijavo prek brskalnika, identitete v oblaku, odjemalčka potrdila in TLS. Nove metode pridejo s posodobitvijo gonilnika, namesto da bi čakali na izdajo digna.
• Gonilniki, ki jih vzdržujejo proizvajalci podatkovnih baz — proizvajalčev lastni gonilnik sledi novim različicam strežnika in varnostnim popravkom, vi pa ga lahko posodabljate po svojem urniku, neodvisno od digna.
• En sam način nastavljanja vsega — vsaka tehnologija je seznam lastnosti ključ/vrednost, z istim vmesnikom, istim šifriranjem občutljivih vrednosti in istim odpravljanjem težav, namesto drugačnega nabora polj za vsak vir.
• Nastavljanje in doseg — možnosti gonilnika, kot so časovne omejitve, nastavitve TLS, posredniški strežniki in velikosti prenosa, so na voljo za vsak vir, priključiti pa je mogoče vsako tehnologijo s skladnim gonilnikom ODBC, tudi takšno, za katero digna ne objavlja lastnega vodnika.

V praksi to pomeni, da stikala Use ODBC ter ločenih polj za gostitelja, vrata, bazo, uporabnika in geslo ni več. Vsako povezavo, ki še ne uporablja ODBC, je treba preklopiti na ODBC — samodejne pretvorbe ni, zato to načrtujte pred nadgradnjo:

1. Preglejte vsako podatkovno povezavo, opredeljeno v vaši namestitvi, in si zapišite tiste, ki še ne uporabljajo ODBC — vsako od njih bo treba znova nastaviti.
2. Na gostitelja digna namestite ustrezen gonilnik ODBC — povezave se odpirajo s strežnika, na katerem teče zaledje digna, in ne iz brskalnika. Glejte Namestitev Gonilnika ODBC na Gostitelja digna.
3. Za vsako prizadeto povezavo pripravite lastnosti ODBC. Vodniki po tehnologijah za vsak vir navajajo preizkušen nabor lastnosti.

Po nadgradnji vsako prizadeto povezavo preklopite na ODBC in jo preizkusite z nadzorne plošče — glejte Ustvarjanje Podatkovne Povezave in Preizkušanje Povezave.

Obvezno ustvarite varnostno kopijo digna repozitorija

Pred nadgradnjo digna varnostno kopirajte vaš repozitorij (PostgreSQL), da se zaščitite pred izgubo podatkov. Varnostna kopija omogoča obnovitev, če pride pri nadgradnji do nepričakovanih težav.

Za ustvarjanje varnostne kopije iz Terminala:

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

Postopek nadgradnje¶

Korak 1: Ustavite digna storitev¶

Če digna teče kot ozadna storitev, jo najprej ustavite:

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

Če digna teče v ospredju, pritisnite Ctrl + C v Terminal oknu, kjer teče.

Korak 2: Varnostna Kopija Trenutne Namestitve¶

V namestitvenem imeniku digna preimenujte mape trenutne namestitve, da bo novo izdajo mogoče namestiti ob njih:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Korak 3: Razširite in razmestite novo različico¶

1. Razširite nov namestitveni ZIP paket digna
2. Kopirajte nov izvršljiv digna in mapo dashboard v imenik namestitve
3. Obnovite izvršljivi bit in po potrebi odstranite atribut karantene:

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

Korak 4: Obnovite konfiguracijske datoteke¶

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'

Korak 5: Ponovno naložite spletni strežnik¶

Nadzorna plošča je nabor statičnih datotek, zato vaš spletni strežnik — in brskalnik — morda še vedno streže prejšnjo različico. Ponovno naložite ali znova zaženite spletni strežnik, ki gosti mapo dashboard, nato pa stran osvežite s trdim osveževanjem (Cmd+Shift+R).

Korak 6: Preverjanje Konfiguracije¶

Preden se dotaknete repozitorija, potrdite, da je posodobljeni config.toml popoln:

./digna config check

Vsaka sekcija mora javiti OK. Odpravite vse, kar je javljeno kot FAILED, in pred nadaljevanjem ukaz poženite znova.

Korak 7: Zamenjajte licenčno datoteko¶

Vsaka izdaja je licencirana ločeno. Datoteko license.toml, ki vam jo je ekipa digna posredovala za to izdajo, kopirajte v imenik namestitve in z njo zamenjajte staro:

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

./digna license check

Korak 8: Nadgradite shemo repozitorija¶

Pojdite v imenik namestitve digna in zaženite:

cd /opt/digna
./digna repo upgrade

To posodobi PostgreSQL shemo na najnovejšo različico ob ohranitvi vseh obstoječih podatkov.

Korak 9: Ponovni zagon storitev¶

Če tečete kot ozadna storitev:

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

Če tečete ročno, ponovno zaženite strežnik:

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

Če uporabljate nginx ali Apache, ponovno zaženite ustrezen spletni strežnik:

brew services restart nginx

sudo apachectl restart

Korak 10: Preverite nadgradnjo¶

1. Dostopajte do digna nadzorne plošče
2. Preverite, ali se vmesnik naloži pravilno
3. Preverite dnevniške datoteke strežnika za morebitne napake
4. Vsako povezavo, ki ODBC še ni uporabljala, preklopite na ODBC, nato preizkusite vse povezave — glejte Preizkušanje Povezave