Linux instalācijas ceļvedis digna Release 2026.11¶

Izlaidums: 2026.11

Pēdējais atjauninājums: 2026. gada 7. novembris

Saturs¶

1. Ievads
2. Sistēmas prasības
3. Priekšinstalācijas sagatavošana
4. PostgreSQL servera iestatīšana
5. Tīmekļa servera konfigurācija
6. Sākotnējā instalācija
7. Backend konfigurācija
8. Paneļa konfigurācija
9. digna palaide kā systemd serviss
10. Jaunināšana uz jaunu izlaidumu

Ievads¶

Par digna¶

digna ir visaptveroša ar mākslīgo intelektu balstīta platforma, kas paredzēta datu kvalitātes pārvaldības optimizēšanai dažādās datu vidēs, piemēram, noliktavās, ezeros un lakehouse risinājumos. Izstrādāta kā mērogojama un pielāgojama sistēma, digna risina mūsdienu datu izaicinājumus, izmantojot automatizāciju, reāllaika uzraudzību un anomāliju atklāšanu.

digna sastāv no divām galvenajām komponentēm:

• digna: lietojumprogrammas kodols, kas atbild par datu apstrādi un kvalitātes pārbaužu veikšanu. Tas apvieno backend un komandrindas saskarni vienā izpildāmajā failā un aizstāj iepriekšējo laidienu atsevišķās programmas dignabackend un dignacli.
• dignadashboard: tīmekļa saskarne, kas izvietota uz tīmekļa servera un nodrošina lietotājam draudzīgu veidu, kā mijiedarboties ar digna platformu un vizualizēt datu kvalitātes metrikas.

Kas jauns izlaidumā 2026.11¶

Šis izlaidums pievieno digna Data Reconciliation, digna Agentic ar digna MCP Server un digna Engine, kas var profilēt datus pašā digna un pārbaudīt referenciālo integritāti starp dažādām datubāzu tehnoloģijām. Pilnas detaļas skatiet izlaiduma piezīmēs.

Instalācijai šis izlaidums ievieš jaunu repozitorija migrāciju mehānismu, neobligātu [duckdb] sadaļu failā config.toml digna Engine vajadzībām un jaunu licences failu. Katrs no tiem ir aprakstīts jaunināšanas sadaļā.

Meklējat Windows vai macOS?¶

Šis ceļvedis attiecas uz Linux. Citu platformu instalācijas skaidrojumu skatiet Windows instalācijas ceļvedī vai macOS instalācijas ceļvedī.

Kuras distribūcijas aptver šis ceļvedis?¶

Norādījumi ir sagatavoti divām izplatītākajām serveru saimēm. Kur tās atšķiras, ir dotas abas komandas:

• Debian saime — Debian, Ubuntu. Pakotņu pārvaldnieks: apt.
• RHEL saime — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Pakotņu pārvaldnieks: dnf.

Darbosies jebkura mūsdienīga distribūcija ar systemd; mainās tikai pakotņu nosaukumi un daži konfigurācijas ceļi.

Sistēmas prasības¶

Pirms instalācijas pārliecinieties, ka jūsu sistēma atbilst šādām minimālajām prasībām:

Datubāzes instalācijas iespējas¶

Ja PostgreSQL jau ir instalēts: Jūs varat pievienot jaunu datubāzi digna esošajam PostgreSQL serverim.

Ja instalējat PostgreSQL uz tā paša datora kā digna:

Distribūcijas un arhitektūras noskaidrošana¶

Vairākas šī ceļveža komandas atšķiras Debian un RHEL saimei. Lai noskaidrotu, kuru izmantojat, palaidiet:

cat /etc/os-release
uname -m

• ID=ubuntu vai ID=debian — izmantojiet apt komandas.
• ID=rhel, rocky, almalinux vai fedora — izmantojiet dnf komandas.
• x86_64 vai aarch64 — jums nepieciešamās instalācijas pakotnes arhitektūra.

Priekšinstalācijas sagatavošana¶

Pirms digna instalēšanas pārliecinieties, ka ir izpildīti divi galvenie priekšnosacījumi:

1. PostgreSQL Server – aprēķināto metrikas un veiktspējas datu glabāšanai
2. Tīmekļa serveris – digna paneļa izvietošanai

Ja šīs sastāvdaļas vēl nav iestatītas, izpildiet tālāk norādītās sadaļas, lai tās instalētu un konfigurētu.

Pakotņu indeksa atsvaidzināšana¶

Pirms jebko instalējat, atjauniniet pakotņu sarakstus:

sudo apt update

sudo dnf check-update

PostgreSQL servera iestatīšana¶

Ja PostgreSQL jau ir pieejams¶

Ja PostgreSQL jau ir instalēts un darbojas uz jūsu lokālā datora vai ja izmantojat pārvaldītu attālo PostgreSQL serveri, varat pāriet uz nākamo sadaļu.

PostgreSQL instalēšana¶

1. solis: Instalēt servera pakotni¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

2. solis: Inicializēt datubāzes klasteri¶

Debian saimē pakotne izveido un palaiž klasteri automātiski — pārejiet uz nākamo soli.

RHEL saimē klasteris jāizveido skaidri:

sudo postgresql-setup --initdb

3. solis: Palaist un iespējot servisu¶

sudo systemctl enable --now postgresql

Tas nekavējoties palaiž PostgreSQL un konfigurē to automātiski startēt atkal sistēmas sāknēšanas laikā.

4. solis: Pārbaudīt instalāciju¶

psql --version
sudo systemctl status postgresql

Jums jāredz PostgreSQL versija un serviss stāvoklī active (running).

5. solis: Pieslēgties serverim¶

Linux PostgreSQL pakotne izveido sistēmas kontu postgres, kam pieder klasteris. Pieslēdzieties caur to:

sudo -u postgres psql

6. solis: Pārbaudīt portu¶

Noklusējuma PostgreSQL ports ir 5432. Lai pārbaudītu, kurā portā jūsu serveris klausās:

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

Pierakstiet šo vērtību — tā būs nepieciešama, konfigurējot digna backend.

7. solis: Iespējot paroles autentifikāciju digna lietotājam¶

digna pieslēdzas PostgreSQL caur TCP kā digna_user, kam nepieciešama paroles autentifikācija, nevis peer autentifikācija. Pārbaudiet, vai jūsu pg_hba.conf to atļauj.

Atrodiet failu:

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

Atveriet to redaktorā un pārliecinieties, ka lokālajās TCP rindās tiek izmantots scram-sha-256 (vai md5 vecākos serveros), nevis 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

Pēc jebkuras izmaiņas pārlādējiet PostgreSQL:

sudo systemctl reload postgresql

8. solis: Ja PostgreSQL darbojas citā datorā¶

Lai pieņemtu savienojumus no cita resursdatora, iestatiet listen_addresses failā postgresql.conf un pievienojiet atbilstošu host rindu savam tīklam failā pg_hba.conf:

listen_addresses = '*'

Pēc tam atveriet portu ugunsmūrī un restartējiet servisu:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Tīmekļa servera konfigurācija¶

digna prasa tīmekļa serveri paneļa izvietošanai. Izvēlieties vienu no šīm iespējām:

• nginx — viegls un ieteicams
• Apache httpd — plaši izmantota alternatīva

Nepieciešams instalēt un konfigurēt tikai vienu no šiem serveriem.

Abās sadaļās tiek konfigurētas divas lietas, no kurām panelis ir atkarīgs:

• Vienas lapas lietotnes (SPA) rezerves maršruts, lai paneļa URL atsvaidzināšana neatgrieztu 404
• .md MIME tips, lai Markdown faili tiktu servēti pareizi

nginx iestatīšana¶

Pārskats¶

nginx ir viegls, augstas veiktspējas tīmekļa serveris, kas labi piemērots statiskā digna paneļa servēšanai.

Instalēšana¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx palaišana¶

sudo systemctl enable --now nginx

Pārbaudīt instalāciju¶

1. Atveriet pārlūkprogrammu
2. Dodieties uz http://localhost
3. Jums jāredz nginx sveiciena lapa

Ugunsmūra atvēršana¶

Ja serverim piekļūst no citiem datoriem, atļaujiet HTTP datplūsmu:

sudo ufw allow 'Nginx Full'

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

Vietnes konfigurēšana panelim¶

Abās distribūciju saimēs nginx iekļauj katru failu no savas conf.d direktorijas. Izveidojiet tur atsevišķu konfigurācijas failu digna vajadzībām:

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

Ielīmējiet tālāk norādīto, aizstājot /opt/digna/dashboard ar faktisko ceļu līdz izpakotajai dashboard mapei:

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

Atspējot noklusējuma vietni¶

Tikai viens server bloks drīkst būt default_server konkrētam portam. Debian saimē noņemiet pakotnes noklusējuma vietni, lai tā neradītu konfliktu:

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

RHEL saimē aizkomentējiet vai izdzēsiet bloku server { ... } failā /etc/nginx/nginx.conf.

Piemērot konfigurāciju¶

Pārbaudiet, vai konfigurācijā nav sintakses kļūdu, un pēc tam pārlādējiet nginx:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd iestatīšana¶

Pārskats¶

Apache httpd ir pieejams katras atbalstītās distribūcijas noklusējuma repozitorijos. Debian saimē pakotne saucas apache2, bet RHEL saimē — httpd.

Instalēšana¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache palaišana¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Pārbaudīt instalāciju¶

1. Atveriet pārlūkprogrammu
2. Dodieties uz http://localhost
3. Jums jāredz distribūcijas noklusējuma Apache lapa

Obligāti: iespējot mod_rewrite¶

Panelim nepieciešama URL pārrakstīšana.

Debian saimē iespējojiet moduli un restartējiet:

sudo a2enmod rewrite
sudo systemctl restart apache2

RHEL saimē mod_rewrite tiek ielādēts pēc noklusējuma. Pārliecinieties par to:

httpd -M | grep rewrite

Obligāti: atļaut .htaccess pārrakstīšanu¶

Atveriet savas dokumentu saknes konfigurācijas failu:

sudo nano /etc/apache2/apache2.conf

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

Atrodiet bloku <Directory>, kas aptver jūsu dokumentu sakni (abās saimēs /var/www/html), un nomainiet:

AllowOverride None

uz:

AllowOverride All

Obligāti: MIME tips Markdown failiem¶

Tajā pašā failā pievienojiet šādu rindu, lai Markdown faili tiktu servēti pareizi:

AddType text/markdown .md

Piemērot konfigurāciju¶

Pārbaudiet, vai konfigurācijā nav sintakses kļūdu, un pēc tam restartējiet Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Sākotnējā instalācija¶

1. solis: Iestatīt digna repozitoriju¶

digna repozitorijs glabā visas ar digna aprēķinātās metrikas. Tas darbojas kā centrālā datubāze analītiskajiem un veiktspējas datiem.

Izveidot repozitorija shēmu un lietotāju¶

Atveriet savu PostgreSQL klientu (psql, pgAdmin vai līdzīgu) un izpildiet šādas 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>;

Aizvietojiet šādus aizstājējvārdus:

• <digna_repo_schema> — Vēlamais shēmas nosaukums (piem., dignarepo)
• <digna_repo_user> — Vēlamais lietotājvārds (piem., digna_user)
• <digna_repo_password> — Droša parole šim lietotājam

Piemērs:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Lai tās palaistu no čaulas vienā solī:

sudo -u postgres psql

Pēc tam ielīmējiet priekšrakstus uzvednē postgres=# un ierakstiet \q, lai izietu.

2. solis: Izpakot digna instalācijas pakotni¶

1. Atrodiet jums nodoto digna instalācijas ZIP failu
2. Izpakojiet to vēlamajā instalācijas vietā — piemēram, /opt/digna
3. Pēc izpakošanas jums jāredz sekojošas vienības:
4. dashboard/ — tīmekļa paneļa saskarne
5. digna — galvenais izpildāmais fails (backend + CLI apvienots)

Lai izpakotu no čaulas:

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

Padarīt failu izpildāmu¶

Atkarībā no tā, kā arhīvs tika pārsūtīts, izpildes bits izpakošanas laikā var netikt saglabāts. Iestatiet to skaidri:

cd /opt/digna
sudo chmod +x digna

Izveidot servisa kontu¶

Produkcijas izvietojumiem ieteicams darbināt backend ar atsevišķu lietotāju bez privilēģijām:

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

3. solis: Instalēt licences failu¶

1. Atrodiet jums nodoto license.toml failu
2. Kopējiet to uz digna instalācijas saknes direktoriju (tur, kur atrodas config.toml un izpildāmais digna)

Kāpēc tas ir svarīgi: Licences fails satur jūsu klienta informāciju, licences derīguma termiņu un digitālo parakstu. Nemainiet šo failu — jebkuras izmaiņas to inaktivizēs.

Direktorijas struktūra pēc iestatīšanas:

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

Backend konfigurācija¶

1. solis: Izveidot un rediģēt konfigurācijas failu¶

config_template.toml fails ir iekļauts jūsu digna instalācijas direktorijā. Pietiek to pārdēvēt par config.toml.

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

Atrašanās vieta: /opt/digna/config.toml

Atveriet config.toml teksta redaktorā un konfigurējiet katru sadaļu zemāk.

[app] sadaļa¶

Šī sadaļa konfigurē starpizcelsmju resursu koplietošanu (CORS) starp paneli un backend:

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

[repo] sadaļa¶

Šī sadaļa konfigurē savienojumu ar PostgreSQL datubāzi:

[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] sadaļa¶

Šī sadaļa satur drošības, sīkfailu un inspekciju iestatījumus:

[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] sadaļa¶

Šajā sadaļā ir atslēga, ar kuru tiek šifrētas repozitorijā glabātās sensitīvās vērtības. Tā ir obligāta — config check ziņo par sadaļu [encryption] kā FAILED, ja atslēgas trūkst.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] sadaļa¶

Šī sadaļa konfigurē žurnālu (logu) uzvedību:

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

[duckdb] sadaļa (neobligāta)¶

Jaunums Release 2026.11. Šī sadaļa nosaka digna Engine resursus. digna Engine profilē datus pašā digna tiem datubāzes savienojumiem, kuru profilēšanas vieta ir digna Engine, un veic referenciālās integritātes pārbaudes starp datu avotiem dažādos datubāzes savienojumos. Skatiet Profilēšanas vieta.

Sadaļa nav obligāta. Bez tās tiek lietotas tālāk norādītās noklusējuma vērtības.

[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. solis: Pārbaudiet konfigurāciju¶

Pirms repozitorija inicializēšanas pārbaudiet, vai config.toml ir pilnīgs un pareizi veidots. Savā digna instalācijas direktorijā palaidiet:

./digna config check

Katra sadaļa tiek pārbaudīta atsevišķi, tāpēc viena kļūda neaizsedz pārējo stāvokli:

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

Izlabojiet visu, kas ziņots kā FAILED, un pirms turpināšanas palaidiet komandu vēlreiz. WARNING sadaļā Unknown keys uzskaita atslēgas failā config.toml, kuras digna nenolasa; tām nav nekādas ietekmes, tāpēc noņemiet tās vai izlabojiet to rakstību. Pilns opciju saraksts ir CLI atsaucē.

3. solis: Inicializēt repozitoriju¶

1. Atveriet termināli
2. Pārejiet uz jūsu digna instalācijas direktoriju (tur, kur atrodas config.toml un izpildāmais digna)
3. Palaidiet savienojuma pārbaudi:

cd /opt/digna
./digna repo check

Jaunā shēmā komanda izveido savienojumu un pēc tam ziņo, ka repozitorijs vēl nav instalēts:

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

Šajā brīdī tas ir sagaidāmais rezultāts: tas apstiprina, ka digna sasniedz PostgreSQL un shēmu. Savukārt savienojuma vai autentifikācijas kļūda norāda uz [repo] sadaļu vai PostgreSQL iestatīšanu.

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

4. solis: Instalēt repozitorija shēmu¶

Tajā pašā direktorijā palaidiet:

./digna repo upgrade

Šī komanda instalē nepieciešamās tabulas repozitorija shēmā un beidzas ar:

✅ Repo schema 'dignarepo' is up to date.

5. solis: Izveidot administratora lietotāju¶

Administratora lietotājs tiek izveidots tieši repozitorija shēmā, tāpēc serverim vēl nav jādarbojas. digna instalācijas direktorijā palaidiet:

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

Piemērs:

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

Šī komanda izveido lietotāju ar e-pasta adresi admin@example.com un pilnām administratīvām tiesībām.

6. solis: Palaist digna serveri¶

digna instalācijas direktorijā palaidiet serveri ar:

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

Parametri: - --address — servera hostname/IP (noklusējums 127.0.0.1) - --port — servera ports (noklusējums 8000)

Kad serveris ir palaists, tas izvada adresi, kurā tas klausās:

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

Paneļa konfigurācija¶

1. solis: Izvietot paneli uz tīmekļa servera¶

digna panelis savu konfigurāciju nolasa no faila dashboard/dashboard_config.toml. Šis fails instalācijā nav iekļauts — jūs to izveidojat dashboard/ direktorijā līdzās paneļa failiem.

Tā saturs ir aprakstīts sadaļā Vienotā pieteikšanās (SSO), kur šis fails arī ir nepieciešams: tajā ir panelī piedāvātās pieteikšanās iespējas un, daudzinstanču izvietošanai, backend savienojums.

Izvēlieties jūsu tīmekļa serveri un izpildiet atbilstošos izvietošanas soļus.

Izvietošana uz nginx¶

Ja izpildījāt sadaļu nginx iestatīšana, server bloks jau norāda uz jūsu dashboard mapi, un nekas nav jākopē.

1. Pārbaudiet ceļu
2. Atveriet /etc/nginx/conf.d/digna.conf

3. Pārliecinieties, ka root norāda uz jūsu izpakoto dashboard mapi

4. Nodrošiniet, ka mape ir nolasāma

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

5. Pārlādējiet nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Pārbaudiet instalāciju

7. Atveriet pārlūkprogrammu
8. Dodieties uz http://localhost (vai jūsu konfigurēto URL)
9. Jums jāredz digna paneļa pieteikšanās lapa

Izvietošana uz Apache httpd¶

1. Kopējiet paneli uz dokumentu sakni

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

2. Pievienojiet pārrakstīšanas noteikumus

Izvietotajā mapē izveidojiet failu .htaccess, lai paneļa maršruti saglabātos pēc pārlūkprogrammas atsvaidzināšanas:

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

Ielīmējiet tālāk norādīto:

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. Restartējiet Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Piekļūstiet panelim

3. Atveriet pārlūkprogrammu
4. Dodieties uz http://localhost/digna
5. Jums jāredz digna paneļa pieteikšanās lapa

2. solis: SELinux (tikai RHEL saime)¶

RHEL, Rocky, AlmaLinux un Fedora sistēmās SELinux pēc noklusējuma darbojas režīmā enforcing un bloķē tīmekļa servera piekļuvi failiem ārpus tam paredzētajām vietām. Pārbaudiet, vai tas ir aktīvs:

getenforce

Ja rezultāts ir Enforcing un jūs servējat paneli no /opt/digna/dashboard, marķējiet direktoriju, lai tīmekļa serveris to drīkstētu nolasīt:

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

digna palaide kā systemd serviss¶

Kāpēc darbināt digna kā servisu?¶

digna backend darbināšana kā systemd serviss nodrošina, ka tas:

• Automātiski startējas, kad dators tiek sāknēts
• Darbojas fonā bez atvērta termināļa loga
• Automātiski restartējas, ja notiek avārija
• To var pārvaldīt ar systemctl, standarta Linux servisu pārvaldnieku

Servisa pārvaldības faili¶

Visi nepieciešamie faili atrodas digna instalācijas direktorijā zem: bin/

Pieejami šādi čaulas skripti:

• install_service.sh — reģistrē digna sistēmā systemd
• uninstall_service.sh — atreģistrē servisu
• start_service.sh — palaiž reģistrēto servisu
• stop_service.sh — aptur darbojošos servisu

Skriptu padarīšana izpildāmus¶

Izpakošana var nesaglabāt izpildes bitu. Pirms pirmās lietošanas:

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

Servisa instalēšana¶

1. Atveriet termināli

2. Pārejiet uz bin mapi

   cd /opt/digna/bin
   

3. Palaidiet instalācijas skriptu

   sudo ./install_service.sh
   

digna serveris tagad ir reģistrēts sistēmā systemd ar automātisku startēšanu. Serviss netiek palaists uzreiz — skatiet nākamo sadaļu, lai to palaistu.

Servisa palaišana un apturēšana¶

Lai palaistu servisu¶

1. Atveriet termināli
2. Pārejiet uz /opt/digna/bin
3. Palaidiet:

   sudo ./start_service.sh
   

Lai apturētu servisu¶

1. Atveriet termināli
2. Pārejiet uz /opt/digna/bin
3. Palaidiet:

   sudo ./stop_service.sh
   

Servisa pārvaldība ar systemctl¶

Pēc reģistrēšanas servisu var vadīt arī ar standarta systemd komandām no jebkuras direktorijas:

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

Servisa pārbaude¶

Lai pārliecinātos, ka serviss ir reģistrēts un darbojas:

systemctl is-enabled digna
systemctl is-active digna

enabled nozīmē, ka serviss startējas sāknēšanas laikā; active nozīmē, ka tas darbojas pašlaik.

Servisa žurnālu skatīšana¶

systemd uztver visu, ko backend izvada konsolē. Lai to izlasītu:

sudo journalctl -u digna -n 100

Lai sekotu žurnālam reāllaikā, atkārtojot problēmu:

sudo journalctl -u digna -f

Pārvietot servisu uz jaunu direktoriju¶

Unit fails glabā absolūto ceļu līdz izpildāmajam failam, tāpēc instalācijas pārvietošanai serviss ir jāreģistrē no jauna:

1. Atinstalēt esošo servisu

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

2. Pārvietot aplikācijas failus

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

3. Pārinstalēt servisu

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

4. Palaist servisu

   sudo ./start_service.sh
   

Servisa atinstalēšana¶

1. Apturēt darbojošos servisu

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

2. Atinstalēt servisu

   sudo ./uninstall_service.sh
   

digna serveris tagad vairs nav reģistrēts sistēmā systemd.

Jaunināšana uz jaunu izlaidumu¶

Šajā sadaļā aprakstīta Release 2026.06 instalācijas jaunināšana uz Release 2026.11. Ja jūsu instalācija ir vecāka, vispirms izlasiet Jaunināšana no laidiena, kas vecāks par 2026.06.

Pirms jaunināšanas¶

digna repozitorija rezerves kopijas izveide ir obligāta

Pirms digna jaunināšanas veiciet rezerves kopiju sava repozitorija (PostgreSQL), lai izvairītos no datu zuduma. Rezerves kopija nodrošina atjaunošanas iespēju, ja jaunināšanas laikā rodas neparedzētas problēmas.

Lai izveidotu rezerves kopiju no čaulas:

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

Licences faila pieprasīšana Release 2026.11

Release 2026.11 nepieciešams jauns license.toml. Pieprasiet to digna komandai pirms darba sākšanas un sagatavojiet to 7. solim.

Jaunināšana no laidiena, kas vecāks par 2026.06¶

Release 2026.06 ieviesa trīs izmaiņas, kas joprojām ir spēkā, ja vecāku instalāciju jaunina tieši uz 2026.11:

• Tikai ODBC. digna katru avota tehnoloģiju sasniedz caur ODBC. Katrs datubāzes savienojums, kas vēl neizmanto ODBC, pēc jaunināšanas jāpārceļ uz ODBC; automātiskas konvertēšanas nav. Iepriekš instalējiet ODBC draiverus digna resursdatorā, skatiet ODBC draivera instalēšana digna resursdatorā, un sagatavojiet katra savienojuma īpašības no tehnoloģiju rokasgrāmatām. Databricks Legacy savienotājs vairs nepastāv; pārceliet šos savienojumus uz Databricks savienotāju.
• Viens izpildāmais fails. dignabackend un dignacli aizstāj viens izpildāmais fails digna, kas apvieno backend un CLI.
• config.toml. Sadaļa [encryption] ir obligāta, un DIGNA_APP_HOST un DIGNA_APP_PORT vairs netiek nolasīti: adresi un portu serveris iegūst no digna serve. Salīdziniet savu failu ar sadaļu Backend konfigurācija.

Tālāk aprakstītajos soļos ir norādīts, kur vecākai instalācijai jārīkojas citādi. Repozitorija jaunināšana 8. solī jebkura agrāka laidiena repozitoriju jaunina tieši uz 2026.11.

Jaunināšanas process¶

1. solis: Apturēt digna servisu¶

Ja digna darbojas kā systemd serviss, vispirms to apturiet:

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

Ja digna darbojas priekšplānā, tā termināļa logā nospiediet Ctrl+C.

2. solis: Izveidojiet pašreizējās instalācijas dublējumu¶

Savā digna instalācijas direktorijā pārdēvējiet pašreizējās instalācijas izpildāmo failu un paneļa mapi, lai jauno laidienu varētu izvietot tiem līdzās:

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

Saglabājiet digna_old, līdz esat pārbaudījis jaunināšanu, un dashboard_old, līdz esat no tās atjaunojis savus konfigurācijas failus (skatiet 4. soli). Pēc tam abus varat izdzēst.

3. solis: Izpakot un izvietot jauno versiju¶

1. Izpakojiet jauno digna instalācijas ZIP failu
2. Kopējiet jauno digna izpildāmo failu un dashboard mapi uz jūsu instalācijas direktoriju
3. Atjaunojiet izpildes bitu un servisa konta īpašumtiesības:

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

4. solis: Atjaunot jūsu konfigurācijas failus¶

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

Release 2026.11 neprasa izmaiņas failā config.toml: fails, kas darbojas ar Release 2026.06, turpina darboties. Divas izmaiņas nav obligātas:

• Pievienojiet [duckdb] sadaļu, ja datubāzes savienojumiem jāizmanto digna Engine un tās noklusējuma vērtības neder jūsu resursdatoram.
• Izlaidiet [app] sadaļu, ja apgrieztais starpniekserveris pasniedz paneli un backend ar vienu izcelsmi.

[[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. solis: Pārlādēt tīmekļa serveri¶

Panelis ir statisku failu kopums, tāpēc jūsu tīmekļa serveris — un pārlūkprogramma — joprojām var pasniegt iepriekšējo versiju. Pārlādējiet vai restartējiet tīmekļa serveri, kurā mitināta mape dashboard, un pēc tam pārlādējiet lapu ar pilnu atsvaidzināšanu (Ctrl+F5).

6. solis: Pārbaudiet konfigurāciju¶

Pirms pieskarties repozitorijam, pārliecinieties, ka config.toml ir pilnīgs:

./digna config check

Katrai sadaļai jāziņo OK. Izlabojiet visu, kas ziņots kā FAILED, noņemiet atslēgas, kas uzskaitītas sadaļā Unknown keys, un pirms turpināšanas palaidiet komandu vēlreiz.

7. solis: Aizstāt licences failu¶

Licences fails parasti tiek pārnests no viena laidiena uz nākamo. Release 2026.11 ir izņēmums: tas pievieno divus licencējamus moduļus, digna Data Reconciliation un digna Agentic, un licence, kas izsniegta pirms 2026.11, tos nesatur. Nokopējiet license.toml, ko digna komanda nodrošināja Release 2026.11, instalācijas direktorijā, aizstājot veco:

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

./digna license check

8. solis: Jaunināt repozitorija shēmu¶

Savā digna instalācijas direktorijā palaidiet:

cd /opt/digna
./digna repo upgrade

Release 2026.11 pārvalda repozitorija shēmu ar versionētām migrācijām. Pirmā jaunināšana no agrāka laidiena atjaunina shēmu līdz iepriekšējā versiju mehānisma pēdējai versijai, reģistrē to kā sākumpunktu un pēc tam piemēro Release 2026.11 migrācijas. Tā beidzas ar:

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

Visi esošie dati tiek saglabāti. Lai jebkurā brīdī redzētu repozitorija stāvokli, palaidiet ./digna repo check: tā parāda pēdējo piemēroto migrāciju un visas vēl nepiemērotās migrācijas.

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

9. solis: Restartēt servisus¶

Ja darbināt kā systemd servisu:

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

Ja darbināt manuāli, restartējiet serveri:

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

Ja izmantojat nginx vai Apache, pārlādējiet attiecīgo tīmekļa serveri:

sudo systemctl reload nginx

sudo systemctl restart apache2

RHEL saimē, ja direktorija dashboard tika aizstāta, atkārtoti piemērojiet SELinux marķējumu:

sudo restorecon -Rv /opt/digna/dashboard

10. solis: Pārbaudīt jaunināšanu¶

1. Pārbaudiet jaunā izpildāmā faila laidienu:

   ./digna version
   

   Pirmajai rindai jābūt Release: 2026.11.

2. Piekļūstiet digna panelim un pārbaudiet, vai saskarne ielādējas pareizi.

3. Pārskatiet servera žurnālus, vai nav kļūdu:

   sudo journalctl -u digna -n 100
   

4. Pārbaudiet savus datubāzes savienojumus — skatiet Savienojuma pārbaude. Pēc jaunināšanas no laidiena, kas vecāks par 2026.06, vispirms pārceliet uz ODBC katru savienojumu, kas vēl neizmantoja ODBC.

Lai sāktu darbu ar jaunajiem moduļiem, skatiet digna Data Reconciliation, AI aģenta pievienošana par digna MCP Server un Profilēšanas vieta par digna Engine.