Navodila za namestitev na Linux za digna izdajo 2026.11¶

Izdaja: 2026.11

Zadnja posodobitev: 7. november 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 storitve systemd
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 podatkovna skladišča, 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 backend 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.11¶

Ta izdaja dodaja digna Data Reconciliation, digna Agentic z digna MCP Server in digna Engine, ki lahko profilira podatke znotraj digna in preverja referenčno integriteto med različnimi tehnologijami podatkovnih baz. Za popolne podrobnosti si oglejte opombe ob izdaji.

Pri namestitvi izdaja prinaša nov mehanizem migracij repozitorija, izbirno sekcijo [duckdb] v config.toml za digna Engine in novo licenčno datoteko. Vse to pokriva razdelek o nadgradnji.

Iščete Windows ali macOS?¶

Ta vodič pokriva Linux. Za druge platforme si oglejte navodila za namestitev na Windows ali navodila za namestitev na macOS.

Katere distribucije pokriva ta vodič?¶

Navodila so napisana za dve najpogostejši družini strežniških distribucij. Kjer se razlikujeta, sta navedena oba ukaza:

• Družina Debian — Debian, Ubuntu. Upravljalnik paketov: apt.
• Družina RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Upravljalnik paketov: dnf.

Deluje vsaka sodobna distribucija s systemd; spremenijo se le imena paketov in nekatere konfiguracijske poti.

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: V obstoječi PostgreSQL strežnik lahko dodate novo bazo podatkov za digna.

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

Preverjanje distribucije in arhitekture¶

Nekateri ukazi v tem vodiču se razlikujejo med družinama Debian in RHEL. Da preverite, katero uporabljate, zaženite:

cat /etc/os-release
uname -m

• ID=ubuntu ali ID=debian — uporabite ukaze apt.
• ID=rhel, rocky, almalinux ali fedora — uporabite ukaze dnf.
• x86_64 ali aarch64 — arhitektura namestitvenega paketa, ki ga potrebujete.

Prednamestitvena priprava¶

Pred namestitvijo digna poskrbite, da sta izpolnjena dva ključna predpogoja:

1. PostgreSQL Server – za shranjevanje izračunanih metrik in podatkov o zmogljivosti
2. Spletni strežnik – za gostovanje nadzorne plošče digna

Če ti komponenti še nista nastavljeni, sledite spodnjim razdelkom za namestitev in konfiguracijo.

Osvežitev indeksa paketov¶

Pred kakršno koli namestitvijo posodobite sezname paketov:

sudo apt update

sudo dnf check-update

Nastavitev PostgreSQL strežnika¶

Če že imate PostgreSQL¶

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

Namestitev PostgreSQL¶

Korak 1: Namestite strežniški paket¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Korak 2: Inicializirajte gručo baze podatkov¶

Pri družini Debian paket gručo ustvari in zažene samodejno — preskočite na naslednji korak.

Pri družini RHEL je treba gručo ustvariti izrecno:

sudo postgresql-setup --initdb

Korak 3: Zaženite in omogočite storitev¶

sudo systemctl enable --now postgresql

To takoj zažene PostgreSQL in ga nastavi, da se ob zagonu sistema znova samodejno zažene.

Korak 4: Preverite namestitev¶

psql --version
sudo systemctl status postgresql

Videti bi morali različico PostgreSQL in storitev v stanju active (running).

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

Paket PostgreSQL za Linux ustvari sistemski račun postgres, ki je lastnik gruče. Povežite se prek njega:

sudo -u postgres psql

Korak 6: Potrdite vrata¶

Privzeta vrata PostgreSQL so 5432. Za potrditev, na katerih vratih posluša vaš strežnik:

sudo -u postgres psql -c "SHOW port;"

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

Korak 7: Omogočite preverjanje z geslom za uporabnika digna¶

digna se s PostgreSQL povezuje prek TCP kot digna_user, kar zahteva preverjanje z geslom namesto peer authentication. Preverite, ali to vaša datoteka pg_hba.conf dovoljuje.

Poiščite datoteko:

sudo -u postgres psql -c "SHOW hba_file;"

Odprite jo v urejevalniku in potrdite, da lokalne vrstice TCP uporabljajo scram-sha-256 (ali md5 na starejših strežnikih) namesto ident:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Po vsaki spremembi ponovno naložite PostgreSQL:

sudo systemctl reload postgresql

Korak 8: Če PostgreSQL teče na drugem stroju¶

Za sprejemanje povezav z drugega gostitelja nastavite listen_addresses v postgresql.conf in v pg_hba.conf dodajte ustrezno vrstico host za vaše omrežje:

listen_addresses = '*'

Nato odprite vrata v požarnem zidu in znova zaženite storitev:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Konfiguracija spletnega strežnika¶

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

• nginx — lahek in priporočen
• Apache httpd — široko razširjena alternativa

Namestiti in konfigurirati morate le enega od teh strežnikov.

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

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

Nastavitev nginx¶

Pregled¶

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

Namestitev¶

sudo apt install -y nginx

sudo dnf install -y nginx

Zagon nginx¶

sudo systemctl enable --now nginx

Preverjanje namestitve¶

1. Odprite brskalnik
2. Pojdite na http://localhost
3. Videti bi morali pozdravno stran nginx

Odpiranje požarnega zidu¶

Če do strežnika dostopajo drugi stroji, dovolite promet HTTP:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Konfiguracija mesta za nadzorno ploščo¶

nginx v obeh družinah distribucij vključi vse datoteke v svojem imeniku conf.d. Tam ustvarite namensko konfiguracijsko datoteko za digna:

sudo nano /etc/nginx/conf.d/digna.conf

Prilepite naslednje in zamenjajte /opt/digna/dashboard z dejansko potjo do razpakirane mape dashboard:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/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;
    }
}

Onemogočite privzeto mesto¶

Za posamezna vrata je lahko default_server le en strežniški blok. Pri družini Debian odstranite privzeto mesto iz paketa, da ne pride do konflikta:

sudo rm /etc/nginx/sites-enabled/default

Pri družini RHEL zakomentirajte ali izbrišite blok server { ... } v datoteki /etc/nginx/nginx.conf.

Uveljavitev konfiguracije¶

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

sudo nginx -t
sudo systemctl reload nginx

Nastavitev Apache httpd¶

Pregled¶

Apache httpd je na voljo v privzetih repozitorijih vseh podprtih distribucij. Paket se v družini Debian imenuje apache2, v družini RHEL pa httpd.

Namestitev¶

sudo apt install -y apache2

sudo dnf install -y httpd

Zagon Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Preverjanje namestitve¶

1. Odprite brskalnik
2. Pojdite na http://localhost
3. Videti bi morali privzeto stran Apache vaše distribucije

Obvezno: omogočite mod_rewrite¶

Nadzorna plošča zahteva prepisovanje URL‑jev.

Pri družini Debian omogočite modul in znova zaženite strežnik:

sudo a2enmod rewrite
sudo systemctl restart apache2

Pri družini RHEL je mod_rewrite naložen privzeto. Potrdite to:

httpd -M | grep rewrite

Obvezno: dovolite preglasitve .htaccess¶

Odprite konfiguracijsko datoteko za svoj korenski imenik dokumentov:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Poiščite blok <Directory>, ki pokriva vaš korenski imenik dokumentov (/var/www/html v obeh družinah), in spremenite:

AllowOverride None

v:

AllowOverride All

Obvezno: MIME tip za Markdown datoteke¶

V isto datoteko dodajte naslednjo vrstico, da se Markdown datoteke strežejo pravilno:

AddType text/markdown .md

Uveljavitev konfiguracije¶

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

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Začetna namestitev¶

Korak 1: Nastavite repozitorij digna¶

Repozitorij digna hrani vse metrike, ki jih izračuna digna. Deluje kot osrednja baza podatkov za analitične podatke in podatke o zmogljivosti.

Ustvarite shemo repozitorija in uporabnika¶

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

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 lupine v enem koraku:

sudo -u postgres psql

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

Korak 2: Razpakirajte namestitveni paket digna¶

1. Poiščite ZIP datoteko namestitvenega paketa digna, ki vam je bila posredovana
2. Razpakirajte jo na želeno lokacijo namestitve — na primer /opt/digna
3. Po razpakiranju bi morali videti naslednje elemente:
4. dashboard/ — spletni vmesnik nadzorne plošče
5. digna — glavna izvršljiva datoteka (backend + CLI skupaj)

Za razpakiranje iz lupine:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Omogočite zagon izvršljive datoteke¶

Glede na način prenosa arhiva se bit za izvajanje ob razpakiranju morda ne ohrani. Nastavite ga izrecno:

cd /opt/digna
sudo chmod +x digna

Ustvarite storitveni račun¶

Za produkcijske namestitve je priporočljivo, da backend teče pod namenskim uporabnikom brez posebnih pravic:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Korak 3: Namestite licenčno datoteko¶

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

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

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. Preimenovati jo morate le v config.toml.

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

Lokacija: /opt/digna/config.toml

Odprite config.toml v urejevalniku besedil in konfigurirajte vsako od spodnjih sekcij.

Sekcija [app]¶

Ta sekcija konfigurira deljenje virov med izvori (CORS) med nadzorno ploščo in backendom:

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

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!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

Sekcija [base]¶

Ta sekcija vsebuje nastavitve varnosti, piškotkov in pregledov:

[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

Sekcija [encryption]¶

Ta sekcija vsebuje ključ, s katerim se šifrirajo občutljive vrednosti, shranjene 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 beleženje:

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

Sekcija [duckdb] (izbirno)¶

Novo v izdaji 2026.11. Ta sekcija določa vire za digna Engine, ki profilira podatke znotraj digna za podatkovne povezave, katerih lokacija profiliranja je digna Engine, in izvaja preverjanja referenčne integritete med viri podatkov na različnih podatkovnih povezavah. Glejte Lokacija profiliranja.

Sekcija je izbirna. Brez nje veljajo spodnje privzete vrednosti.

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

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

Korak 2: Preverite konfiguracijo¶

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
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Odpravite vse, kar je javljeno kot FAILED, in pred nadaljevanjem ukaz zaženite znova. WARNING pod Unknown keys navaja ključe v config.toml, ki jih digna ne bere; nimajo nobenega učinka, zato jih odstranite ali popravite njihov zapis. 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

Na novi shemi se ukaz poveže in nato javi, da repozitorij še ni nameščen:

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

Na tej točki je to pričakovani rezultat: potrjuje, da digna doseže PostgreSQL in shemo. Napaka pri povezavi ali preverjanju pristnosti pa kaže na sekcijo [repo] ali na nastavitev PostgreSQL.

sudo ln -s /opt/digna/digna /usr/local/bin/digna

Korak 4: Namestite shemo repozitorija¶

V istem imeniku zaženite:

./digna repo upgrade

Ta ukaz namesti potrebne tabele v shemo repozitorija in se konča z:

✅ Repo schema 'dignarepo' is up to date.

Korak 5: Ustvarite skrbniškega uporabnika¶

Skrbniški uporabnik se ustvari neposredno v shemi repozitorija, zato strežniku še ni treba teči. V imeniku namestitve digna zaženite:

./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 strežnik digna¶

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

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

Parametri: - --address — ime gostitelja/IP strežnika (privzeto 127.0.0.1) - --port — vrata strežnika (privzeto 8000)

Ko strežnik teče, izpiše naslov, na katerem posluša:

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

Konfiguracija nadzorne plošče¶

Korak 1: Razmestite nadzorno ploščo 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 namestitvah povezavo na backend.

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

Razmestitev na nginx¶

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

1. Potrdite pot
2. Odprite /etc/nginx/conf.d/digna.conf

3. Preverite, ali root kaže na vašo razpakirano mapo dashboard

4. Poskrbite, da je mapa berljiva

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

5. Ponovno naložite nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Preizkusite namestitev

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

Razmestitev na Apache httpd¶

1. Kopirajte nadzorno ploščo v korenski imenik dokumentov

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Dodajte pravila za prepisovanje

V razmeščeni mapi ustvarite datoteko .htaccess, da poti nadzorne plošče preživijo osvežitev brskalnika:

sudo nano /var/www/html/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. Znova zaženite Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Dostopite do nadzorne plošče

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

Korak 2: SELinux (samo družina RHEL)¶

V sistemih RHEL, Rocky, AlmaLinux in Fedora je SELinux privzeto v načinu enforcing in spletnemu strežniku prepreči branje datotek zunaj pričakovanih lokacij. Preverite, ali je aktiven:

getenforce

Če je rezultat Enforcing in nadzorno ploščo strežete iz /opt/digna/dashboard, imenik označite tako, da ga spletni strežnik sme brati:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

Zagon digna kot storitve systemd¶

Zakaj zagnati digna kot storitev?¶

Zagon backend‑a digna kot storitve systemd zagotavlja, da se:

• samodejno zažene ob zagonu stroja
• izvaja v ozadju brez odprtega okna terminala
• samodejno znova zažene v primeru zrušitve
• upravlja prek systemctl, standardnega upravitelja storitev v sistemu Linux

Datoteke za upravljanje storitve¶

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

Na voljo so naslednji skripti lupine:

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

Naredite skripte izvršljive¶

Razpakiranje morda ne ohrani bita za izvajanje. Pred prvo uporabo:

cd /opt/digna/bin
sudo 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
   

Strežnik digna je zdaj registriran pri systemd z omogočenim samodejnim zagonom. Storitev se ne zažene takoj — kako jo zaženete, prikazuje naslednji razdelek.

Zagon in ustavitev storitve¶

Za zagon storitve¶

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

   sudo ./start_service.sh
   

Za ustavitev storitve¶

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

   sudo ./stop_service.sh
   

Upravljanje storitve s systemctl¶

Ko je storitev registrirana, jo lahko iz katerega koli imenika upravljate tudi s standardnimi ukazi systemd:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Preverjanje storitve¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled pomeni, da se storitev zažene ob zagonu sistema; active pomeni, da trenutno teče.

Pregledovanje dnevnikov storitve¶

systemd zajame vse, kar backend izpiše v konzolo. Za branje:

sudo journalctl -u digna -n 100

Za sprotno spremljanje dnevnika med ponavljanjem težave:

sudo journalctl -u digna -f

Premik storitve v nov imenik¶

Datoteka enote hrani absolutno pot do izvršljive datoteke, zato premestitev namestitve zahteva ponovno registracijo storitve:

1. Odstranite trenutno storitev

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

2. Premaknite datoteke aplikacije

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

3. Znova namestite storitev

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

4. Zaženite storitev

   sudo ./start_service.sh
   

Odstranitev storitve¶

1. Ustavite delujočo storitev

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

2. Odstranite storitev

   sudo ./uninstall_service.sh
   

Strežnik digna zdaj ni več registriran pri systemd.

Nadgradnja na novo izdajo¶

Ta razdelek nadgradi namestitev izdaje 2026.06 na izdajo 2026.11. Če je vaša namestitev starejša, najprej preberite Nadgradnja z izdaje pred 2026.06.

Pred nadgradnjo¶

Varnostna kopija repozitorija digna je obvezna

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

Za ustvarjanje varnostne kopije iz lupine:

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

Pridobitev licenčne datoteke za izdajo 2026.11

Izdaja 2026.11 potrebuje novo datoteko license.toml. Pred začetkom jo zahtevajte od ekipe digna in jo imejte pripravljeno za korak 7.

Nadgradnja z izdaje pred 2026.06¶

Izdaja 2026.06 je prinesla tri spremembe, ki še vedno veljajo, kadar starejšo namestitev nadgradite neposredno na 2026.11:

• Samo ODBC. digna do vsake izvorne tehnologije dostopa prek ODBC. Vsako podatkovno povezavo, ki še ne uporablja ODBC, je treba po nadgradnji preklopiti na ODBC; samodejne pretvorbe ni. Gonilnike ODBC na gostitelja digna namestite vnaprej, glejte Namestitev gonilnika ODBC na gostitelja digna, lastnosti vsake povezave pa imejte pripravljene iz vodnikov po tehnologijah. Konektor Databricks Legacy ne obstaja več; te povezave preselite na konektor Databricks.
• Ena izvršljiva datoteka. dignabackend in dignacli nadomešča ena sama izvršljiva datoteka digna, ki združuje backend in CLI.
• config.toml. Sekcija [encryption] je obvezna, DIGNA_APP_HOST in DIGNA_APP_PORT pa se ne bereta več: naslov in vrata strežnik dobi iz digna serve. Svojo datoteko primerjajte z razdelkom Konfiguracija backend‑a.

Spodnji koraki opozarjajo, kje starejša namestitev potrebuje kaj drugačnega. Nadgradnja repozitorija v koraku 8 repozitorij katere koli prejšnje izdaje pripelje neposredno na 2026.11.

Postopek nadgradnje¶

Korak 1: Ustavite storitev digna¶

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

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

Če digna teče v ospredju, v njegovem oknu terminala pritisnite Ctrl+C.

Korak 2: Varnostno kopirajte trenutno namestitev¶

V namestitvenem imeniku digna preimenujte izvršljivo datoteko in mapo nadzorne plošče trenutne namestitve, da bo novo izdajo mogoče namestiti ob njih:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

digna_old obdržite, dokler ne preverite nadgradnje, dashboard_old pa, dokler iz nje ne obnovite svojih konfiguracijskih datotek (glejte korak 4). Nato lahko oboje izbrišete.

Korak 3: Razpakirajte in razmestite novo različico¶

1. Razpakirajte novo ZIP datoteko namestitve digna
2. Novo izvršljivo datoteko digna in mapo dashboard kopirajte v svoj namestitveni imenik
3. Obnovite bit za izvajanje in lastništvo storitvenega računa:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Korak 4: Obnovite konfiguracijske datoteke¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Izdaja 2026.11 ne zahteva nobene spremembe datoteke config.toml: datoteka, ki deluje z izdajo 2026.06, deluje še naprej. Dve spremembi sta izbirni:

• Dodajte sekcijo [duckdb], če naj podatkovne povezave uporabljajo digna Engine in njegove privzete vrednosti ne ustrezajo vašemu gostitelju.
• Sekcijo [app] izpustite, če obratni posrednik streže nadzorno ploščo in backend pod enim izvorom.

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

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 (Ctrl+F5).

Korak 6: Preverite konfiguracijo¶

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

./digna config check

Vsaka sekcija mora javiti OK. Odpravite vse, kar je javljeno kot FAILED, odstranite ključe, navedene pod Unknown keys, in pred nadaljevanjem ukaz zaženite znova.

Korak 7: Zamenjajte licenčno datoteko¶

Licenčna datoteka se običajno prenese iz ene izdaje v naslednjo. Izdaja 2026.11 je izjema: dodaja dva licencirana modula, digna Data Reconciliation in digna Agentic, licenca, izdana pred 2026.11, pa ju ne vsebuje. Datoteko license.toml, ki vam jo je ekipa digna posredovala za izdajo 2026.11, kopirajte v imenik namestitve in z njo zamenjajte staro:

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

./digna license check

Korak 8: Nadgradite shemo repozitorija¶

V imeniku namestitve digna zaženite:

cd /opt/digna
./digna repo upgrade

Izdaja 2026.11 shemo repozitorija upravlja z verzioniranimi migracijami. Prva nadgradnja s prejšnje izdaje shemo pripelje na zadnjo različico prejšnjega sistema, to zabeleži kot izhodišče in nato uporabi migracije izdaje 2026.11. Konča se z:

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

Vsi obstoječi podatki se ohranijo. Stanje repozitorija lahko kadar koli preverite z ukazom ./digna repo check: navede zadnjo uporabljeno migracijo in morebitne čakajoče.

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

Korak 9: Znova zaženite storitve¶

Če digna teče kot storitev systemd:

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

Če digna poganjate ročno, znova zaženite strežnik:

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

Če uporabljate nginx ali Apache, ponovno naložite ustrezni spletni strežnik:

sudo systemctl reload nginx

sudo systemctl restart apache2

V družini RHEL znova uveljavite oznake SELinux, če je bil imenik dashboard zamenjan:

sudo restorecon -Rv /opt/digna/dashboard

Korak 10: Preverite nadgradnjo¶

1. Preverite izdajo nove izvršljive datoteke:

   ./digna version
   

   Prva vrstica se mora glasiti Release: 2026.11.

2. Odprite nadzorno ploščo digna in preverite, ali se vmesnik pravilno naloži.

3. V dnevnikih strežnika preverite, ali so se pojavile napake:

   sudo journalctl -u digna -n 100
   

4. Preizkusite svoje podatkovne povezave — glejte Preizkušanje povezave. Po nadgradnji z izdaje pred 2026.06 najprej vsako povezavo, ki še ni uporabljala ODBC, preklopite na ODBC.

Za začetek dela z novimi moduli glejte digna Data Reconciliation, Povezava agenta AI za digna MCP Server in Lokacija profiliranja za digna Engine.