Linuxi paigaldusjuhend digna väljalase 2026.11¶

Väljalase: 2026.11

Viimati uuendatud: 7. november 2026

Sisukord¶

1. Sissejuhatus
2. Süsteeminõuded
3. Eelpaigaldus ja ettevalmistus
4. PostgreSQL serveri seadistus
5. Veebiserveri konfiguratsioon
6. Algne paigaldus
7. Backendi konfiguratsioon
8. Dashboardi konfiguratsioon
9. digna käitamine systemd teenusena
10. Uuendamine uude versiooni

Sissejuhatus¶

Mis on digna¶

digna on terviklik tehisintellektil põhinev platvorm, mis on loodud optimeerima andmete kvaliteedi haldust mitmesugustes andmekeskkondades nagu andmelaod, andmejärved ja lakehoused. Selle eesmärk on olla kõrge skaleeritavusega ja kohanduv — digna lahendab kaasaegseid andmeprobleeme automatiseerimise, reaalajas monitooringu ja anomaaliate tuvastuse kaudu.

digna koosneb kahest põhikomponendist:

• 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: Veebipõhine liides, mis majutatakse veebiserveris ja pakub kasutajasõbralikku võimalust digna platvormiga suhelda ning andmete kvaliteeti visualiseerida.

Mis on uut väljalahes 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 macOS-i?¶

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

Millistele distributsioonidele see juhend kehtib?¶

Juhised on kirjutatud kahe kõige tavalisema serveripere jaoks. Kui kahe perekonna vahel on erinevusi, on mõlemad käsud toodud:

• Debian perekond — Debian, Ubuntu. Paketihaldur: apt.
• RHEL perekond — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Paketihaldur: dnf.

Iga kaasaegne distributsioon, millel on systemd, töötab; muutuvad vaid paketinimed ja mõned konfiguratsiooniteed.

Süsteeminõuded¶

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

Andmebaasi paigaldamise valikud¶

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

Kui paigaldate PostgreSQL-i samale masinale kui digna:

Distribuutori ja arhitektuuri kontrollimine¶

Mitu käsku selles juhendis erinevad Debian ja RHEL perekondade vahel. Et kontrollida, kummal te olete, käivitage:

cat /etc/os-release
uname -m

• ID=ubuntu või ID=debian — kasutage apt käske.
• ID=rhel, rocky, almalinux või fedora — kasutage dnf käske.
• x86_64 või aarch64 — paigalduspaki jaoks vajalik arhitektuur.

Eelpaigaldus ja ettevalmistus¶

Enne digna paigaldamist veenduge, et kaks peamist eeldust on täidetud:

1. PostgreSQL server – salvestamaks väljarvutatud mõõdikuid ja jõudluse andmeid
2. Veebiserver – digna Dashboardi majutamiseks

Kui need komponendid pole veel seadistatud, järgige allolevaid sektsioone nende paigaldamiseks ja konfigureerimiseks.

Paketiloendi värskendamine¶

Uuendage oma paketiloend enne mis tahes paigaldust:

sudo apt update

sudo dnf check-update

PostgreSQL serveri seadistus¶

Kui teil on PostgreSQL juba olemas¶

Kui PostgreSQL on juba paigaldatud ja töötab teie lokaalsel masinal või kasutate hallatavat kaugrepostgreSQL teenust, võite edasi liikuda järgmisse sektsiooni.

PostgreSQL paigaldamine¶

Samm 1: Serverpaketi paigaldamine¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Samm 2: Andmebaasi klastri algatamine¶

Debian perekonnas loob ja käivitab pakett klastri automaatselt — jätkake järgmise sammuga.

RHEL perekonnas tuleb klaster luua käsitsi:

sudo postgresql-setup --initdb

Samm 3: Teenuse käivitamine ja lubamine¶

sudo systemctl enable --now postgresql

See käivitab PostgreSQLi kohe ja seab selle automaatselt käivituma taaskäivituse korral.

Samm 4: Paigalduse kontrollimine¶

psql --version
sudo systemctl status postgresql

Peaksite nägema PostgreSQL versiooni ja teenuse olekut active (running).

Samm 5: Ühendumine serveriga¶

Linuxi PostgreSQL-pakett loob süsteemikonto postgres, mis omab klastrit. Ühenduge selle kontoga:

sudo -u postgres psql

Samm 6: Pordi kinnitamine¶

Vaikimisi PostgreSQL kuulab porti 5432. Et kinnitada, millisel pordil teie server kuulab:

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

Pange väärtus kirja — seda vajate digna backendit konfigureerides.

Samm 7: Paroolipõhise autentimise lubamine digna kasutaja jaoks¶

digna ühendub PostgreSQL-iga TCP kaudu kasutajana digna_user, mis vajab paroolipõhist autentimist peer-auth asemel. Kontrollige, et teie pg_hba.conf lubab seda.

Leidke fail:

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

Avage see redaktoris ja kinnitage, et lokaalsed TCP-ridad kasutavad scram-sha-256 (või vanematel serveritel md5) mitte 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

Laadige PostgreSQL uuesti pärast igat muutust:

sudo systemctl reload postgresql

Samm 8: Kui PostgreSQL töötab teisel masinal¶

Et aktsepteerida ühendusi teiselt hostilt, seadistage listen_addresses failis postgresql.conf ja lisage võrgu jaoks sobiv host rida pg_hba.conf-i:

listen_addresses = '*'

Avage seejärel pordi tulemüüris ja taaskäivitage teenus:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Veebiserveri konfiguratsioon¶

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

• nginx — kerge ja soovitatav
• Apache httpd — laialt kasutatav alternatiiv

Teil on vaja installida ja konfigureerida ainult ÜKS neist serveritest.

Mõlemad sektsioonid seadistavad kaks asja, mis dashboardil vajalikud on:

• Ühe lehe rakenduse fallback, nii et dashboardi URL-i värskendamine ei tagasta 404 vea
• .md MIME-tüüp, et Markdown-failid teenitakse korrektselt

nginx seadistamine¶

Ülevaade¶

nginx on kerge ja kõrge jõudlusega veebiserver, mis sobib hästi staatilise digna dashboardi serveerimiseks.

Paigaldamine¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx käivitamine¶

sudo systemctl enable --now nginx

Paigalduse kontrollimine¶

1. Avage brauser
2. Minge http://localhost
3. Te peaksite nägema nginx tervituslehte

Tulemüüri avamine¶

Kui serverile pääseb ligi teistelt masinatelt, lubage HTTP liiklus:

sudo ufw allow 'Nginx Full'

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

Veebisaidi konfiguratsioon dashboardi jaoks¶

nginx laeb distributsioonidel faili iga faili conf.d kataloogist. Looge digna jaoks pühendatud konfiguratsioonifail sinna:

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

Kleepige järgmine, asendades /opt/digna/dashboard tegeliku teega, kuhu olete dashboard kausta lahtipakinud:

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

Vaikimisi saidi keelamine¶

Porti võib olla ainult üks default_server. Debian perekonnas eemaldage pakendatud vaikimisi konfiguratsioon, et see ei segaks:

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

RHEL perekonnas kommenteerige või kustutage server { ... } plokk failist /etc/nginx/nginx.conf.

Konfiguratsiooni rakendamine¶

Testige konfiguratsiooni süntaksi vea suhtes ja seejärel laadige nginx uuesti:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd seadistamine¶

Ülevaade¶

Apache httpd on saadaval kõikide toetatud distributsioonide vaikerepositooriumites. Paketi nimi on Debian perekonnas apache2 ja RHEL perekonnas httpd.

Paigaldamine¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache käivitamine¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Paigalduse kontrollimine¶

1. Avage brauser
2. Minge http://localhost
3. Te peaksite nägema distributsiooni vaikimisi Apache lehte

Nõutav: mod_rewrite lubamine¶

Dashboard vajab URL-ide ümberkirjutamist.

Debian perekonnas lubage moodul ja taaskäivitage:

sudo a2enmod rewrite
sudo systemctl restart apache2

RHEL perekonnas on mod_rewrite vaikimisi laetud. Kinnitage see:

httpd -M | grep rewrite

Nõutav: .htaccess üle kirjutuste lubamine¶

Avage dokumentjuure konfiguratsioonifail:

sudo nano /etc/apache2/apache2.conf

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

Leidke <Directory> plokk, mis katab teie dokumentjuure (/var/www/html mõlemas perekonnas) ja muutke:

AllowOverride None

järgmiseks:

AllowOverride All

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

Lisage samasse faili järgmine rida, et Markdown-failid teenitakse korrektselt:

AddType text/markdown .md

Konfiguratsiooni rakendamine¶

Kontrollige konfiguratsiooni süntaksi vea suhtes ja seejärel taaskäivitage Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Algne paigaldus¶

Samm 1: digna andmehoidla (repository) seadistamine¶

digna repository salvestab kõik digna poolt arvutatud mõõdikud. See toimib analüütiliste ja jõudlusandmete keskandmebaasina.

Loo repository skeem ja kasutaja¶

Avage oma PostgreSQL klient (psql, pgAdmin või sarnane) ja käivitage 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ärgmised kohatäited:

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

Näide:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Shellist ühe sammuna käivitamiseks:

sudo -u postgres psql

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

Samm 2: digna paigalduspaki lahtipakkimine¶

1. Leidke teile antud digna paigaldus ZIP-fail
2. Pakkige see soovitud paigalduskataloogi — näiteks /opt/digna
3. Pärast lahtipakkimist peaksite nägema järgmisi elemente:
4. dashboard/ — Veebidashboardi liides
5. digna — Põhikäivitatav fail (backend + CLI koos)

Lahtipakkimiseks shellis:

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

Muutke käivitatav fail käivitatavaks¶

Sõltuvalt sellest, kuidas arhiiv üle viidi, ei pruugi käivitatav õigus säilida. Seadke see ekspilti:

cd /opt/digna
sudo chmod +x digna

Looge teenusekonto¶

Soovitatav on käivitada backend spetsiaalse piiratud õigustega kasutajana tootmiskeskkonnas:

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

Samm 3: Litsentsifaili paigaldamine¶

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

Miks see oluline on: Litsentsifail sisaldab teie kliendiinfot, litsentsi aegumist ja digitaalallkirja. Ärge muutke seda faili — iga muudatus muudab selle kehtetuks.

Kaustastruktuur pärast seadistust:

/opt/digna/
├── config.toml         (konfiguratsioonifail)
├── license.toml        (TEIE LITSENTSI FAIL - kopeerige siia)
├── digna               (põhikäivitatav fail)
├── bin/                (teenusehaldusskriptid)
└── dashboard/          (veebiliides)
    └── (dashboard failid)

Backendi konfiguratsioon¶

Samm 1: Loo ja muuda konfiguratsioonifaili¶

Paigalduskaustas on olemas config_template.toml fail. Lihtsalt ümbernimetamine config.toml-iks piisab.

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

Asukoht: /opt/digna/config.toml

Avage config.toml tekstiredaktoris ja seadistage alljärgnevad sektsioonid.

[app] sektsioon¶

See sektsioon seadistab dashboardi ja backendi vahelist päritoluülest ressursijagamist (CORS):

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

[repo] sektsioon¶

See sektsioon 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

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

[base] sektsioon¶

See sektsioon 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] sektsioon¶

See sektsioon seadistab logimise käitumist:

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

[duckdb] sektsioon (valikuline)¶

Uus väljalaskes Release 2026.11. See sektsioon 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.

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

[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

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: Repository initsialiseerimine¶

1. Avage terminal
2. Minge 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.

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

Samm 4: Repository skeemi paigaldamine¶

Selles 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: Admin-kasutaja loomine¶

1. Avage uus terminaliaken
2. Minge digna paigalduskataloogi
3. Käivitage järgmine käsk admin-kasutaja loomiseks:

./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: digna serveri käivitamine¶

digna paigalduskataloogis käivitage server:

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

Parameetrid: - --address — Serveri hostinimi/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

sudo ufw allow 8082/tcp

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

Dashboardi konfiguratsioon¶

Samm 1: Dashboardi juurutamine veebiserverisse¶

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

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

Valige veebiserver ja järgige vastavaid juurutussamme.

Juurutamine nginx-i peale¶

Kui järgite nginx seadistamise juhiseid, osutab serveriblokk juba teie dashboard kaustale ja kopeerimist ei ole vaja.

1. Kinnitage tee
2. Avage /etc/nginx/conf.d/digna.conf

3. Kontrollige, et root osutab teie lahtipakitud dashboard kaustale

4. Veenduge, et kaust on loetav

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

5. Laadige nginx uuesti

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Testige paigaldust

7. Avage brauser
8. Minge http://localhost (või teie seadistatud URL)
9. Teile peaks avanema digna dashboardi sisselogimisleht

Juurutamine Apache httpd peale¶

1. Kopeerige dashboard dokumentjuurde

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

2. Lisage ümberkirjutusreeglid

Looge .htaccess fail paigaldatud kausta nii, et dashboardi teekonnad säiliksid brauseri värskendamisel:

sudo nano /var/www/html/digna/.htaccess

Kleepige järgmine:

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 systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Avage dashboard

3. Avage brauser
4. Minge http://localhost/digna
5. Te peaksite nägema digna dashboardi sisselogimislehte

Samm 2: SELinux (ainult RHEL perekond)¶

RHEL, Rocky, AlmaLinux ja Fedora kasutavad vaikimisi SELinux-i, mis võib takistada veebiserveril lugemast faile väljaspool tema eeldatavaid asukohti. Kontrollige, kas see on aktiivne:

getenforce

Kui vastuseks on Enforcing ja te teenite dashboardi kataloogist /opt/digna/dashboard, märgistage kataloog nii, et veebiserver saaks seda lugeda:

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

digna käitamine systemd teenusena¶

Miks käivitada digna teenusena?¶

digna backendi käitamine systemd teenusena tagab, et see:

• Käivitub automaatselt masina käivitamisel
• Töötab taustal ilma avatuna terminaliaknata
• Taaskäivitub automaatselt, kui see kukub kokku
• Seda saab hallata standardse Linuxi teenusehalduriga systemctl

Teenusehalduse failid¶

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

Järgnevad shell-skriptid on olemas:

• install_service.sh — registreerib digna systemd-ga
• uninstall_service.sh — tühistab registreeritud teenuse
• start_service.sh — käivitab registreeritud teenuse
• stop_service.sh — peatab töötava teenuse

Tee skriptid käivitatavaks¶

Arhiivi lahtipakkimine ei pruugi säilitada käivitusõigust. Enne esimest kasutust:

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

Teenuse paigaldamine¶

1. Avage terminal

2. Minge bin kataloogi

   cd /opt/digna/bin
   

3. Käivitage paigaldusskript

   sudo ./install_service.sh
   

digna server on nüüd registreeritud systemd-ga ja automaatne käivitamine on lubatud. Teenus ei pruugi käivituda koheselt — järgige järgmisi samme selle käivitamiseks.

Teenuse käivitamine ja peatamine¶

Teenuse käivitamiseks¶

1. Avage terminal
2. Minge /opt/digna/bin
3. Käivitage:

   sudo ./start_service.sh
   

Teenuse peatamiseks¶

1. Avage terminal
2. Minge /opt/digna/bin
3. Käivitage:

   sudo ./stop_service.sh
   

Teenuse haldamine systemctl abil¶

Pärast registreerimist saab teenust hallata ka standardsete systemd käskudega igast kataloogist:

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

Teenuse kontrollimine¶

Teenuse registreerimise ja töötamise kinnitamiseks:

systemctl is-enabled digna
systemctl is-active digna

enabled tähendab, et teenus käivitub boot-il; active tähendab, et see töötab praegu.

Teenuselogide vaatamine¶

systemd salvestab kõik, mida backend kirjutab konsoolile. Lugemiseks:

sudo journalctl -u digna -n 100

Reaalajas jälgimiseks ja probleemi reprodutseerimiseks:

sudo journalctl -u digna -f

Teenuse liigutamine uude kataloogi¶

Üksuse fail sisaldab täispikka teed käivitatavale failile, seega installatsiooni liigutamine nõuab teenuse uuesti registreerimist:

1. Desinstallige 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 eemaldamine¶

1. Peatage töötav teenus

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

2. Desinstallige teenus

   sudo ./uninstall_service.sh
   

digna server on nüüd süsteemist unregisteritud.

Uuendamine uude versiooni¶

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 repository varundamine on kohustuslik

Enne digna uuendamist varundage oma repository (PostgreSQL), et kaitsta andmete kadumise eest. Varukoopia võimaldab taastada, kui uuendamine peaks kokku jooksma või esinevad ootamatud probleemid.

Varunduse loomiseks shellist:

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.

Uuendamise protsess¶

Samm 1: Peatage digna teenus¶

Kui digna töötab systemd teenusena, peatage see esmalt:

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

Kui digna töötab esiplaanil, vajutage terminaliaknas 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
sudo mv digna digna_old
sudo 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: Uue versiooni lahtipakkimine ja juurutamine¶

1. Pakkige lahti uus digna paigaldus ZIP-fail
2. Kopeerige uus digna käivitatav fail ja dashboard kaust oma paigalduskataloogi
3. Taastage käivitusõigused ja teenuse konto omandiõigus:

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

Samm 4: Taastage oma konfiguratsioonifailid¶

sudo 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 dashboardi 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¶

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

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:

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

./digna license check

Samm 8: Hoidla skeemi uuendamine¶

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: Teenuste taaskäivitamine¶

Kui teenus on systemd kaudu:

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

Kui käivitate käsitsi, käivitage server uuesti:

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

Kui kasutate nginx-i või Apache-t, laadige vastav veebiserver uuesti:

sudo systemctl reload nginx

sudo systemctl restart apache2

RHEL perekonnas rakendage SELinux sildistamine uuesti, kui dashboard kataloog on asendatud:

sudo restorecon -Rv /opt/digna/dashboard

Samm 10: Uuenduse kontrollimine¶

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

   ./digna version
   

   Esimene rida peab olema Release: 2026.11.

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

3. Kontrollige serverilogisid vigade suhtes:

   sudo journalctl -u digna -n 100
   

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.