Linux diegimo vadovas digna leidimui 2026.11¶

Leidimas: 2026.11

Paskutinį kartą atnaujinta: 2026 m. lapkričio 7 d.

Turinys¶

1. Įvadas
2. Sistemos reikalavimai
3. Prieš diegiant
4. PostgreSQL serverio nustatymas
5. Tinklapio serverio konfigūracija
6. Pradinis diegimas
7. Backend konfigūracija
8. Dashboard konfigūracija
9. digna paleidimas kaip systemd paslauga
10. Atnaujinimas į naują leidimą

Įvadas¶

Apie digna¶

digna yra visapusiška, dirbtiniu intelektu paremta platforma, skirta optimizuoti duomenų kokybės valdymą įvairiose duomenų aplinkose, tokiose kaip duomenų sandėliai, ežerai ir lakehouse sprendimai. Sukurta būti itin mastelijama ir pritaikoma, digna sprendžia šiuolaikines duomenų problemas per automatizavimą, realaus laiko stebėjimą ir anomalijų aptikimą.

digna susideda iš dviejų pagrindinių komponentų:

• digna: programos branduolys, atsakingas už duomenų apdorojimą ir kokybės patikras. Jis sujungia užkulisinę dalį ir komandinęs eilutės sąsają į vieną vykdomąjį failą ir pakeičia atskiras ankstesnių leidimų programas dignabackend ir dignacli.
• dignadashboard: web sąsaja, talpinama tinklapio serveryje, suteikianti patogią prieigą prie digna platformos ir duomenų kokybės metrikų vizualizacijos.

Kas naujo leidime 2026.11¶

Šis leidimas prideda digna Data Reconciliation, digna Agentic su digna MCP Server ir digna Engine, kuris gali profiliuoti duomenis pačioje digna ir tikrinti nuorodų vientisumą tarp skirtingų duomenų bazių technologijų. Išsamią informaciją rasite leidimo pastabose.

Diegimui leidimas atneša naują saugyklos migracijų mechanizmą, neprivalomą [duckdb] skyrių faile config.toml, skirtą digna Engine, ir naują licencijos failą. Kiekvieną iš jų aptaria atnaujinimo skyrius.

Ieškote Windows arba macOS instrukcijų?¶

Šis vadovas apima Linux. Kitiems platformoms žiūrėkite Windows diegimo vadovą arba macOS diegimo vadovą.

Kurioms distribucijoms skirtas šis vadovas?¶

Instrukcijos parašytos dviem dažniausiai naudojamoms serverinių šeimoms. Kur jos skiriasi, pateikiami abu komandų variantai:

• Debian šeima — Debian, Ubuntu. Paketų tvarkyklė: apt.
• RHEL šeima — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Paketų tvarkyklė: dnf.

Bet kuri moderni distribucija su systemd tiks; keičiasi tik paketų pavadinimai ir keli konfigūracijos keliai.

Sistemos reikalavimai¶

Prieš pradėdami diegimą, įsitikinkite, kad jūsų sistema atitinka šiuos minimalus reikalavimus:

Duomenų bazės diegimo parinktys¶

Jei PostgreSQL jau įdiegta: Galite pridėti naują duomenų bazę digna prie esamo PostgreSQL serverio.

Jei diegiate PostgreSQL tame pačiame kompiuteryje kaip digna:

Kaip patikrinti distribuciją ir architektūrą¶

Kelios šio vadovo komandos skiriasi tarp Debian ir RHEL šeimų. Norėdami patikrinti, kuriai priklausote, vykdykite:

cat /etc/os-release
uname -m

• ID=ubuntu arba ID=debian — naudokite apt komandas.
• ID=rhel, rocky, almalinux arba fedora — naudokite dnf komandas.
• x86_64 arba aarch64 — tai diegimo paketo architektūra, kurios jums reikia.

Prieš diegiant¶

Prieš diegdami digna, įsitikinkite, kad įvykdyti du pagrindiniai reikalavimai:

1. PostgreSQL serveris – saugoti apskaičiuotas metrikas ir našumo duomenis
2. Tinklapio serveris – talpinti digna Dashboard

Jei šie komponentai dar nėra sukonfigūruoti, vadovaukitės žemiau pateiktomis sekcijomis, kad juos įdiegtumėte ir sukonfigūruotumėte.

Atnaujinti paketų indeksą¶

Atnaujinkite paketų sąrašą prieš diegimą:

sudo apt update

sudo dnf check-update

PostgreSQL serverio nustatymas¶

Jei PostgreSQL jau yra¶

Jei PostgreSQL jau įdiegta ir veikia jūsų vietiniame kompiuteryje arba naudojate valdomą nuotolinį PostgreSQL serverį, galite pereiti prie kitos skilties.

PostgreSQL diegimas¶

1 žingsnis: įdiekite serverio paketą¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

2 žingsnis: inicializuokite duomenų klasterį¶

Debian šeimoje paketas sukuria ir paleidžia klasterį automatiškai — pereikite prie kito žingsnio.

RHEL šeimoje klasteris turi būti sukurtas eksplicitiai:

sudo postgresql-setup --initdb

3 žingsnis: paleiskite ir įgalinkite paslaugą¶

sudo systemctl enable --now postgresql

Tai paleidžia PostgreSQL iš karto ir sukonfigūruoja, kad jis būtų paleidžiamas automatiškai įkrovos metu.

4 žingsnis: patikrinkite įdiegimą¶

psql --version
sudo systemctl status postgresql

Turėtumėte matyti PostgreSQL versiją ir active (running) būsenos paslaugą.

5 žingsnis: prisijunkite prie serverio¶

Linux PostgreSQL paketas sukuria postgres sistemos paskyrą, kuri valdo klasterį. Prisijunkite per ją:

sudo -u postgres psql

6 žingsnis: patikrinkite prievadą¶

Numatytasis PostgreSQL prievadas yra 5432. Norėdami patikrinti, kokį prievadą serveris naudoja:

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

Užsirašykite reikšmę — jos prireiks konfigūruojant digna backend.

7 žingsnis: įgalinkite slaptažodžio autentifikavimą digna vartotojui¶

digna jungiasi prie PostgreSQL per TCP kaip digna_user, todėl reikalingas slaptažodinis autentifikavimas, o ne peer autentifikacija. Patikrinkite, ar jūsų pg_hba.conf tai leidžia.

Raskite failą:

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

Atidarykite jį redaktoriuje ir įsitikinkite, kad vietiniai TCP įrašai naudoja scram-sha-256 (arba md5 senesniuose serveriuose), o ne 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

Persikraukite PostgreSQL po bet kokio pakeitimo:

sudo systemctl reload postgresql

8 žingsnis: jei PostgreSQL veikia kitoje mašinoje¶

Norėdami priimti jungtis iš kito hosto, nustatykite listen_addresses faile postgresql.conf ir pridėkite atitinkamą host eilutę savo tinkle pg_hba.conf:

listen_addresses = '*'

Tada atverkite prievadą ugniasienėje ir paleiskite paslaugą iš naujo:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Tinklapio serverio konfigūracija¶

digna reikalauja tinklapio serverio dashboard talpinimui. Pasirinkite vieną iš šių variantų:

• nginx — lengvas ir rekomenduojamas
• Apache httpd — plačiai naudojama alternatyva

Jums reikės įdiegti ir sukonfigūruoti tik vieną iš šių serverių.

Abu skyriai konfigūruoja dvi dashboard reikalaujamas parinktis:

• Single-page-application fallback, kad perkrovus dashboard URL negrąžintų 404
• .md MIME tipą, kad Markdown failai būtų teisingai pateikiami

nginx diegimas¶

Apžvalga¶

nginx yra lengvas, aukštos veiklos tinklapio serveris, tinkamas talpinti statinį digna dashboard.

Diegimas¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx paleidimas¶

sudo systemctl enable --now nginx

Patikrinkite įdiegimą¶

1. Atidarykite naršyklę
2. Eikite į http://localhost
3. Turėtumėte matyti nginx pasveikinimo puslapį

Ugniasienės atvėrimas¶

Jei į serverį jungiamasi iš kitų mašinų, leiskite HTTP srautą:

sudo ufw allow 'Nginx Full'

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

Svetainės konfigūravimas dashboard¶

nginx įtraukia kiekvieną failą iš conf.d katalogo abiejose distribucijų šeimose. Sukurkite atskirą konfigūracijos failą digna:

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

Įklijuokite žemiau pateiktą, pakeisdami /opt/digna/dashboard tikru keliu į jūsų išarchyvuotą dashboard katalogą:

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

Išjunkite numatytąją svetainę¶

Tik vienas server blokas gali būti default_server prievadui. Debian šeimoje pašalinkite paketais įdiegtą numatytąją svetainę, kad nekiltų konfliktų:

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

RHEL šeimoje komentarais arba ištrynimu ištrinkite server { ... } bloką faile /etc/nginx/nginx.conf.

Pritaikykite konfigūraciją¶

Patikrinkite konfigūraciją sintaksės klaidų atžvilgiu, tada perkraukite nginx:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd diegimas¶

Apžvalga¶

Apache httpd yra prieinamas numatytųjų saugyklų kiekvienoje palaikomoje distribucijoje. Paketo pavadinimas Debian šeimoje yra apache2, o RHEL šeimoje — httpd.

Diegimas¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache paleidimas¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Patikrinkite įdiegimą¶

1. Atidarykite naršyklę
2. Eikite į http://localhost
3. Turėtumėte matyti distribucijos numatytą Apache puslapį

Būtina: įjungti mod_rewrite¶

Dashboard reikalauja URL perrašymo.

Debian šeimoje įgalinkite modulį ir perkraukite:

sudo a2enmod rewrite
sudo systemctl restart apache2

RHEL šeimoje mod_rewrite yra įkeltas pagal nutylėjimą. Patikrinkite:

httpd -M | grep rewrite

Būtina: leisti .htaccess perrašymus¶

Atidarykite dokumentų šaknies konfigūracijos failą:

sudo nano /etc/apache2/apache2.conf

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

Raskite <Directory> bloką, apimantį jūsų dokumentų šaknį (/var/www/html abiejose šeimose) ir pakeiskite:

AllowOverride None

į:

AllowOverride All

Būtina: MIME tipas Markdown failams¶

Toje pačioje byloje pridėkite šią eilutę, kad Markdown failai būtų pateikiami teisingai:

AddType text/markdown .md

Pritaikykite konfigūraciją¶

Patikrinkite konfigūraciją sintaksės klaidų atžvilgiu, tada perkraukite Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Pradinis diegimas¶

1 žingsnis: sukurkite digna saugyklą¶

digna saugykla saugo visus digna apskaičiuotus rodiklius. Ji veikia kaip centrinė analitinių ir našumo duomenų duomenų bazė.

Sukurkite saugyklos schemą ir vartotoją¶

Atidarykite PostgreSQL klientą (psql, pgAdmin ar panašiai) ir vykdykite šias SQL komandas:

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

Pakeiskite šiuos vietos laikiklius:

• <digna_repo_schema> — pageidaujamas schemos pavadinimas (pvz., dignarepo)
• <digna_repo_user> — pageidaujamas vartotojo vardas (pvz., digna_user)
• <digna_repo_password> — saugus slaptažodis šiam vartotojui

Pavyzdys:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Norėdami vykdyti tai iš shell vienu žingsniu:

sudo -u postgres psql

Tada įklijuokite sakinius prie postgres=# prompto ir įveskite \q, kad išeitumėte.

2 žingsnis: išarchyvuokite digna diegimo paketą¶

1. Suraskite jums pateiktą digna diegimo ZIP failą
2. Išarchyvuokite jį į pageidaujamą diegimo vietą — pavyzdžiui /opt/digna
3. Po išarchyvavimo turėtumėte pamatyti šiuos elementus:
4. dashboard/ — web dashboard sąsaja
5. digna — pagrindinis vykdomasis failas (backend + CLI kartu)

Išarchyvavimui iš shell:

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

Paverskite vykdomąjį failą paleidžiamu¶

Priklausomai nuo to, kaip archyvas buvo perkeltas, vykdomasis bitas gali nebūti išsaugotas. Nustatykite jį aiškiai:

cd /opt/digna
sudo chmod +x digna

Sukurkite paslaugos paskyrą¶

Rekomenduojama backend paleisti kaip dedikuotą neprivilegijuotą vartotoją gamybos aplinkoje:

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

3 žingsnis: įdiekite licencijos failą¶

1. Suraskite jums pateiktą license.toml failą
2. Nukopijuokite jį į pagrindinį digna diegimo katalogą (ten, kur yra config.toml ir vykdomasis failas digna)

Kodėl tai svarbu: Licencijos failas talpina jūsų kliento informaciją, licencijos galiojimo datą ir skaitmeninį parašą. Nekeiskite šio failo — bet koks pakeitimas jį invaliduoja.

Katalogo struktūra po nustatymo:

/opt/digna/
├── config.toml         (konfigūracijos failas)
├── license.toml        (JŪSŲ LICENCIJOS FAILAS - nukopijuokite čia)
├── digna               (pagrindinis vykdomasis failas)
├── bin/                (paslaugos valdymo skriptai)
└── dashboard/          (web sąsaja)
    └── (dashboard failai)

Backend konfigūracija¶

1 žingsnis: sukurkite ir redaguokite konfigūracijos failą¶

config_template.toml failas pateiktas jūsų digna diegimo kataloge. Jums tereikia pervardyti jį į config.toml.

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

Vieta: /opt/digna/config.toml

Atidarykite config.toml teksto redaktoriuje ir sukonfigūruokite kiekvieną žemiau pateiktą skyrių.

[app] skyrius¶

Šis skyrius konfigūruoja kryžminės kilmės išteklių bendrinimą (CORS) tarp dashboard ir backend:

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

[repo] skyrius¶

Šis skyrius konfigūruoja jungtį prie PostgreSQL duomenų bazės:

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

Šiame skyriuje yra saugumo, slapukų ir inspekcijų nustatymai:

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

Šiame skyriuje yra raktas, kuriuo šifruojamos saugykloje laikomos jautrios reikšmės. Jis yra būtinas — config check praneša skyrių [encryption] kaip FAILED, jei rakto trūksta.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] skyrius¶

Šis skyrius konfigūruoja žurnalo elgseną:

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

[duckdb] skyrius (neprivalomas)¶

Naujiena nuo Release 2026.11. Šis skyrius nustato digna Engine išteklius. digna Engine profiliuoja duomenis pačioje digna tiems duomenų bazės ryšiams, kurių profiliavimo vieta yra digna Engine, ir vykdo nuorodų vientisumo patikras tarp duomenų šaltinių, esančių skirtinguose duomenų bazės ryšiuose. Žr. Profiliavimo vieta.

Skyrius yra neprivalomas. Be jo taikomos toliau nurodytos numatytosios reikšmės.

[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

2 žingsnis: Patikrinkite konfigūraciją¶

Prieš inicijuodami saugyklą patikrinkite, ar config.toml yra išsamus ir tinkamai sudarytas. Savo digna diegimo kataloge paleiskite:

digna config check

Kiekvienas skyrius tikrinamas atskirai, todėl viena klaida neuždengia kitų būsenos:

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

Pataisykite viską, kas pranešama kaip FAILED, ir prieš tęsdami paleiskite komandą dar kartą. Įspėjimas WARNING ties Unknown keys išvardija config.toml raktus, kurių digna neskaito; jie neturi jokio poveikio, todėl juos pašalinkite arba pataisykite jų rašybą. Visas parinkčių sąrašas pateiktas CLI žinyne.

3 žingsnis: inicializuokite saugyklą¶

1. Atidarykite terminalą
2. Eikite į digna diegimo katalogą (ten, kur yra config.toml ir vykdomasis failas digna)
3. Patikrinkite ryšį:

cd /opt/digna
./digna repo check

Naujoje schemoje komanda prisijungia ir tada praneša, kad saugykla dar neįdiegta:

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

Šiame etape tai yra laukiamas rezultatas: jis patvirtina, kad digna pasiekia PostgreSQL ir schemą. Prisijungimo ar autentifikavimo klaida, priešingai, rodo į [repo] skyrių arba PostgreSQL sąranką.

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

4 žingsnis: įdiekite saugyklos schemą¶

Toje pačioje direktorijoje paleiskite:

./digna repo upgrade

Ši komanda įdiegia reikalingas lenteles saugyklos schemoje ir baigiasi pranešimu:

✅ Repo schema 'dignarepo' is up to date.

5 žingsnis: sukurkite administratoriaus paskyrą¶

1. Atidarykite naują terminalo langą
2. Eikite į digna diegimo katalogą
3. Vykdykite šią komandą, kad sukurtumėte administratoriaus paskyrą:

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

Pavyzdys:

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

Taip sukuriamas naudotojas su el. pašto adresu admin@example.com ir visomis administratoriaus teisėmis.

6 žingsnis: paleiskite digna serverį¶

digna diegimo kataloge paleiskite serverį:

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

Parametrai: - --address — serverio host vardas/IP (numatytasis 127.0.0.1) - --port — serverio prievadas (numatytasis 8000)

Kai serveris pasileidžia, jis išveda adresą, kuriuo klausosi:

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

Dashboard konfigūracija¶

1 žingsnis: patalpinkite dashboard tinklapio serveryje¶

digna dashboard savo konfigūraciją skaito iš dashboard/dashboard_config.toml. Šis failas diegimo pakete nepateikiamas — jį sukuriate dashboard/ kataloge šalia dashboard failų.

Jo turinys aprašytas skyriuje Vienkartinis prisijungimas (SSO), kur šis failas ir reikalingas: jame nurodomos dashboard siūlomos prisijungimo parinktys, o daugiainstanciniams diegimams — ir ryšys su backend.

Pasirinkite tinklapio serverį ir vykdykite atitinkamus diegimo veiksmus.

Diegimas su nginx¶

Jei vykdėte nginx diegimą, serverio blokas jau nurodo į jūsų dashboard katalogą ir kopijuoti nieko nereikia.

1. Patvirtinkite kelią
2. Atidarykite /etc/nginx/conf.d/digna.conf

3. Patikrinkite, ar root nurodo į jūsų išarchyvuotą dashboard katalogą

4. Užtikrinkite, kad katalogas būtų skaitomas

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

5. Perkraukite nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Patikrinkite diegimą

7. Atidarykite naršyklę
8. Eikite į http://localhost (arba jūsų konfigūruotą URL)
9. Turėtumėte matyti digna dashboard prisijungimo puslapį

Diegimas su Apache httpd¶

1. Kopijuokite dashboard į dokumentų šaknį

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

2. Pridėkite perrašymo taisykles

Sukurkite .htaccess failą įdiegtoje direktorijoje, kad dashboard maršrutai išliktų po puslapio perkrovimo:

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

Įklijuokite žemiau pateiktą:

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. Perkraukite Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Prisijunkite prie dashboard

3. Atidarykite naršyklę
4. Eikite į http://localhost/digna
5. Turėtumėte matyti digna dashboard prisijungimo puslapį

2 žingsnis: SELinux (tik RHEL šeimai)¶

RHEL, Rocky, AlmaLinux ir Fedora pagal nutylėjimą paleidžia SELinux ir jis gali užblokuoti tinklapio serverį skaitant failus iš neįprastų vietų. Patikrinkite, ar jis aktyvus:

getenforce

Jei rezultatas yra Enforcing ir jūs tiekiate dashboard iš /opt/digna/dashboard, pažymėkite katalogą tinkamu kontekstu, kad tinklapio serveris galėtų jį perskaityti:

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

digna paleidimas kaip systemd paslauga¶

Kodėl paleisti digna kaip paslaugą?¶

digna backend paleidimas kaip systemd paslauga užtikrina, kad jis:

• Automatiškai paleidžiamas kompiuteriui įsijungus
• Veikia fone be atviro terminalo lango
• Automatiškai persikrauna, jei sugesti
• Gali būti valdoma per systemctl, standartinį Linux paslaugų valdytoją

Paslaugos valdymo failai¶

Visi reikalingi failai yra digna diegimo kataloge po: bin/

Galimi šie shell skriptai:

• install_service.sh — registruoja digna su systemd
• uninstall_service.sh — pašalina registraciją
• start_service.sh — paleidžia registruotą paslaugą
• stop_service.sh — sustabdo veikiančią paslaugą

Paverskite skriptus vykdomais¶

Išarchyvavimas gali neišsaugoti vykdomojo bito. Prieš pirmą naudojimą:

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

Paslaugos įdiegimas¶

1. Atidarykite terminalą

2. Eikite į bin katalogą

   cd /opt/digna/bin
   

3. Vykdykite diegimo skriptą

   sudo ./install_service.sh
   

digna serveris dabar registruotas systemd su automatiniu paleidimu. Paslauga nėra paleidžiama iš karto — žr. kitą skyrių, kaip ją paleisti.

Paslaugos paleidimas ir sustabdymas¶

Paslaugos paleidimas¶

1. Atidarykite terminalą
2. Eikite į /opt/digna/bin
3. Vykdykite:

   sudo ./start_service.sh
   

Paslaugos stabdymas¶

1. Atidarykite terminalą
2. Eikite į /opt/digna/bin
3. Vykdykite:

   sudo ./stop_service.sh
   

Paslaugos valdymas su systemctl¶

Užregistravus, paslauga gali būti valdoma standartinėmis systemd komandomis iš bet kurio katalogo:

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

Patikrinkite paslaugą¶

Norėdami patvirtinti, kad paslauga užregistruota ir veikia:

systemctl is-enabled digna
systemctl is-active digna

enabled reiškia, kad paslauga paleidžiama įkrovos metu; active reiškia, kad ji dabar veikia.

Peržiūrėkite paslaugos žurnalus¶

systemd perima visą tai, ką backend rašo į konsolę. Skaityti žurnalą:

sudo journalctl -u digna -n 100

Norėdami sekti žurnalą gyvai atkuriant problemą:

sudo journalctl -u digna -f

Perkelti paslaugą į naują katalogą¶

Unit failas saugo absoliutų kelią iki vykdomojo failo, todėl perkėlus diegimą reikia iš naujo registruoti paslaugą:

1. Pašalinkite esamą paslaugą

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

2. Perkelkite programos failus

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

3. Iš naujo įdiekite paslaugą

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

4. Paleiskite paslaugą

   sudo ./start_service.sh
   

Pašalinti paslaugą¶

1. Sustabdykite veikiančią paslaugą

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

2. Pašalinkite paslaugą

   sudo ./uninstall_service.sh
   

digna serveris dabar neberegistruotas systemd.

Atnaujinimas į naują leidimą¶

Šiame skyriuje aprašoma, kaip atnaujinti Release 2026.06 diegimą į Release 2026.11. Jei jūsų diegimas senesnis, pirmiausia perskaitykite Atnaujinimas iš senesnio nei 2026.06 leidimo.

Prieš atnaujinant¶

Digna saugyklos atsarginė kopija yra privaloma

Prieš atnaujinant digna, sukurkite atsarginę savo saugyklos (PostgreSQL) kopiją, kad apsisaugotumėte nuo duomenų praradimo. Atsarginė kopija leis atstatyti, jei atnaujinimas susidurs su netikėtomis problemomis.

Atsarginę kopiją sukurti iš shell:

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

Release 2026.11 licencijos failo užsakymas

Release 2026.11 reikia naujo license.toml. Prieš pradėdami paprašykite jo digna komandos ir turėkite jį paruoštą 7 žingsniui.

Atnaujinimas iš senesnio nei 2026.06 leidimo¶

Release 2026.06 atnešė tris pakeitimus, kurie vis dar galioja, kai senesnį diegimą atnaujinate tiesiai į 2026.11:

• Tik ODBC. digna kiekvieną šaltinio technologiją pasiekia per ODBC. Kiekvieną duomenų bazės ryšį, kuris dar nenaudoja ODBC, po atnaujinimo reikia perkelti į ODBC; automatinio konvertavimo nėra. Iš anksto įdiekite ODBC tvarkykles digna pagrindiniame kompiuteryje, žr. ODBC tvarkyklės diegimas digna pagrindiniame kompiuteryje, ir turėkite paruoštas kiekvieno ryšio savybes iš technologijų vadovų. Databricks Legacy jungties nebėra; perkelkite tuos ryšius į Databricks jungtį.
• Vienas vykdomasis failas. dignabackend ir dignacli pakeisti vienu vykdomuoju failu digna, kuris sujungia backend ir CLI.
• config.toml. [encryption] skyrius yra privalomas, o DIGNA_APP_HOST ir DIGNA_APP_PORT nebeskaitomi: adresą ir prievadą serveris gauna iš digna serve. Palyginkite savo failą su skyriumi Backend konfigūracija.

Toliau pateiktuose žingsniuose nurodyta, kur senesniam diegimui reikia ko nors kito. Saugyklos atnaujinimas 8 žingsnyje bet kurio ankstesnio leidimo saugyklą perkelia tiesiai į 2026.11.

Atnaujinimo procesas¶

1 žingsnis: sustabdykite digna paslaugą¶

Jei digna veikia kaip systemd paslauga, pirmiausia ją sustabdykite:

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

Jei digna veikia pirmame plane, paspauskite Ctrl+C to terminalo lange.

2 žingsnis: Sukurkite dabartinio diegimo atsarginę kopiją¶

Savo digna diegimo kataloge pervadinkite dabartinio diegimo vykdomąjį failą ir dashboard aplanką, kad naują leidimą būtų galima įdiegti šalia jų:

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

digna_old laikykite, kol patikrinsite atnaujinimą, o dashboard_old – kol iš jo atkursite savo konfigūracijos failus (žr. 4 žingsnį). Po to abu galite ištrinti.

3 žingsnis: išarchyvuokite ir įdiekite naują versiją¶

1. Išarchyvuokite naują digna diegimo ZIP failą
2. Nukopijuokite naują digna vykdomąjį failą ir dashboard katalogą į diegimo katalogą
3. Atstatykite vykdomąjį bitą ir paslaugos paskyros nuosavybę:

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

4 žingsnis: atstatykite konfigūracijos failus¶

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

Release 2026.11 nereikia keisti config.toml: failas, veikiantis su Release 2026.06, veikia ir toliau. Du pakeitimai yra neprivalomi:

• Pridėkite [duckdb] skyrių, jei duomenų bazės ryšiai turi naudoti digna Engine, o jo numatytosios reikšmės netinka jūsų pagrindiniam kompiuteriui.
• Praleiskite [app] skyrių, jei atvirkštinis tarpinis serveris dashboard ir backend pateikia su ta pačia kilme.

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

5 žingsnis: perkraukite tinklapio serverį¶

Dashboard yra statinių failų rinkinys, todėl jūsų tinklapio serveris — ir naršyklė — gali vis dar pateikti ankstesnę versiją. Perkraukite arba iš naujo paleiskite tinklapio serverį, kuriame talpinamas dashboard aplankas, tada iš naujo įkelkite puslapį priverstiniu atnaujinimu (Ctrl+F5).

6 žingsnis: Patikrinkite konfigūraciją¶

Prieš liesdami saugyklą įsitikinkite, kad config.toml yra išsamus:

./digna config check

Kiekvienas skyrius turi pranešti OK. Pataisykite viską, kas pranešama kaip FAILED, pašalinkite raktus, išvardytus ties Unknown keys, ir prieš tęsdami paleiskite komandą dar kartą.

7 žingsnis: pakeiskite licencijos failą¶

Licencijos failas paprastai pereina iš vieno leidimo į kitą. Release 2026.11 yra išimtis: jis prideda du licencijuojamus modulius, digna Data Reconciliation ir digna Agentic, o licencijoje, išduotoje iki 2026.11, jų nėra. Nukopijuokite license.toml, kurį digna komanda pateikė Release 2026.11, į diegimo katalogą, pakeisdami senąjį:

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

./digna license check

8 žingsnis: atnaujinkite saugyklos schemą¶

Savo digna diegimo kataloge paleiskite:

cd /opt/digna
./digna repo upgrade

Release 2026.11 saugyklos schemą valdo versijuotomis migracijomis. Pirmasis atnaujinimas iš ankstesnio leidimo perkelia schemą į paskutinę ankstesnės versijavimo schemos versiją, užfiksuoja ją kaip pradinį tašką ir tada pritaiko Release 2026.11 migracijas. Jis baigiasi pranešimu:

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

Visi esami duomenys išsaugomi. Norėdami bet kada pamatyti saugyklos būseną, paleiskite ./digna repo check: komanda išvardija paskutinę pritaikytą migraciją ir visas laukiančias.

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

9 žingsnis: paleiskite paslaugas iš naujo¶

Jei naudojate systemd paslaugą:

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

Jei paleidžiate rankiniu būdu, paleiskite serverį iš naujo:

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

Jei naudojate nginx arba Apache, perkraukite atitinkamą tinklapio serverį:

sudo systemctl reload nginx

sudo systemctl restart apache2

RHEL šeimoje, jei pakeitėte dashboard katalogą, iš naujo pritaikykite SELinux žymėjimą:

sudo restorecon -Rv /opt/digna/dashboard

10 žingsnis: patikrinkite atnaujinimą¶

1. Patikrinkite naujojo vykdomojo failo leidimą:

   ./digna version
   

   Pirmoji eilutė turi būti Release: 2026.11.

2. Atidarykite digna dashboard ir patikrinkite, ar sąsaja įkeliama teisingai.

3. Patikrinkite serverio žurnalus, ar nėra klaidų:

   sudo journalctl -u digna -n 100
   

4. Išbandykite savo duomenų bazės ryšius — žr. Ryšio tikrinimas. Po atnaujinimo iš senesnio nei 2026.06 leidimo pirmiausia perkelkite į ODBC kiekvieną ryšį, kuris dar nenaudojo ODBC.

Norėdami pradėti dirbti su naujais moduliais, žr. digna Data Reconciliation, AI agento prijungimas – apie digna MCP Server, ir Profiliavimo vieta – apie digna Engine.