Linuxi paigaldusjuhend digna väljalase 2026.06¶

Väljalase: 2026.06

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

See versioon toob andmevaatlikkuse (data observability) võimalused otse teie koodi, võimaldades arendajatel jälgida andmete kvaliteeti juba allikal. Täielikud andmed leiate väljalaseteatmikust.

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.06-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 digna backendi rakenduse seadeid:

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

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

[base] sektsioon¶

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

See sektsioon seadistab logimise käitumist:

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

Te peaksite nägema kinnitust, et ühendus on loodud (repository ise ei ole veel initsialiseeritud).

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

Samm 4: Repository skeemi paigaldamine¶

Selles kataloogis käivitage:

./digna repo install

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

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

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¶

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

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

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo mv dashboard dashboard_old

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

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

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, 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:

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

./digna license check

Samm 8: Hoidla skeemi uuendamine¶

Minge digna paigalduskataloogi ja käivitage:

cd /opt/digna
./digna repo upgrade

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

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. Avage digna dashboard
2. Kinnitage, et liides laadib korrektselt
3. Kontrollige serverilogi vigade osas:
4. Viige üle ODBC-le iga ühendus, mis seda veel ei kasutanud, ja testige seejärel kõiki ühendusi — vaadake Ühenduse testimine

sudo journalctl -u digna -n 100