Linux instalācijas ceļvedis digna Release 2026.06¶

Izlaidums: 2026.06

Pēdējais atjauninājums: 2026. gada 5. septembris

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.06¶

Šajā izlaidumā datu novērošanas iespējas ir integrētas tieši jūsu kodā, ļaujot izstrādātājiem uzraudzīt datu kvalitāti pie avota. Pilnas detaļas skatiet izlaiduma piezīmēs.

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.06-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ē digna backend lietojumprogrammas iestatījumus:

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

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

[base] sadaļa¶

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

[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] 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_BACKUP_COUNT = 10

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

Overall: OK

Izlabojiet visu, kas ziņots kā FAILED, un pirms turpināšanas palaidiet komandu vēlreiz. 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

Jums jāsaņem apstiprinājums, ka savienojums ir izveidots (repozitorijs pats par sevi vēl nav inicializēts).

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

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

Tajā pašā direktorijā palaidiet:

./digna repo install

Šī komanda instalē nepieciešamās tabulas un shēmu jūsu PostgreSQL datubāzē.

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 - --port — servera ports

Jums jāredz startēšanas ziņas, kas apstiprina, ka serveris darbojas:

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

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¶

Pirms jaunināšanas¶

Vispirms pārbaudiet visus datubāžu savienojumus

Sākot ar laidienu 2026.06, digna katru avota tehnoloģiju sasniedz caur ODBC. Iepriekšējie laidieni piedāvāja izvēli starp katrai tehnoloģijai pašu draiveri un ODBC, ko izvēlējās ar slēdzi Use ODBC. digna komanda nolēma balstīties tikai uz ODBC, jo viena standarta saskarne sniedz vairāk nekā pēc pasūtījuma veidotu draiveru kopums:

• Autentifikācija — autentifikācija ir daļa no ODBC, tāpēc savienojums var izmantot visu, ko atbalsta tā draiveris: paroles, pilnvaras un PAT, Kerberos un Active Directory, MFA un pārlūkprogrammas vienoto pieteikšanos, mākoņa identitātes, klienta sertifikātus un TLS. Jaunas metodes nāk līdzi draivera atjauninājumam, nevis gaidot digna laidienu.
• Draiveri, ko uztur datubāžu ražotāji — ražotāja draiveris seko jaunām servera versijām un drošības labojumiem, un jūs varat to atjaunināt pēc sava grafika, neatkarīgi no digna.
• Viens veids, kā konfigurēt visu — katra tehnoloģija ir atslēgu un vērtību īpašību saraksts ar to pašu saskarni, to pašu sensitīvo vērtību šifrēšanu un to pašu problēmu novēršanu, nevis atšķirīgu lauku kopu katram avotam.
• Pielāgošana un aptvērums — draivera opcijas, piemēram, noildzes, TLS iestatījumi, starpniekserveri un ielādes izmēri, ir pieejamas katram avotam, un pievienot var jebkuru tehnoloģiju ar atbilstošu ODBC draiveri, arī tādu, kurai digna nepublicē atsevišķu rokasgrāmatu.

Praksē tas nozīmē, ka slēdzis Use ODBC un atsevišķie resursdatora, porta, datubāzes, lietotāja un paroles lauki vairs nepastāv. Katrs savienojums, kas vēl neizmanto ODBC, ir jāpārceļ uz ODBC — automātiskas konvertēšanas nav, tāpēc ieplānojiet to pirms jaunināšanas:

1. Pārskatiet katru jūsu instalācijā definēto datubāzes savienojumu un atzīmējiet tos, kas vēl neizmanto ODBC — katrs no tiem būs jākonfigurē no jauna.
2. Instalējiet atbilstošo ODBC draiveri digna resursdatorā — savienojumi tiek atvērti no servera, kurā darbojas digna backend, nevis no pārlūkprogrammas. Skatiet ODBC draivera instalēšana digna resursdatorā.
3. Sagatavojiet ODBC īpašības katram skartajam savienojumam. Tehnoloģiju rokasgrāmatas katram avotam norāda pārbaudītu īpašību kopu.

Pēc jaunināšanas katru skarto savienojumu pārceliet uz ODBC un pārbaudiet to no paneļa — skatiet Datubāzes savienojuma izveide un Savienojuma pārbaude.

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

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 mapes, lai jauno laidienu varētu izvietot tiem līdzās:

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

sudo mv dashboard dashboard_old

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

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

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 atjauninātais config.toml ir pilnīgs:

./digna config check

Katrai sadaļai jāziņo OK. Izlabojiet visu, kas ziņots kā FAILED, un pirms turpināšanas palaidiet komandu vēlreiz.

7. solis: Aizstāt licences failu¶

Katram laidienam ir atsevišķa licence. Nokopējiet license.toml, ko digna komanda nodrošināja šim laidienam, 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¶

Pārejiet uz jūsu digna instalācijas direktoriju un palaidiet:

cd /opt/digna
./digna repo upgrade

Tas atjauninās PostgreSQL shēmu uz jaunāko versiju, saglabājot visus esošos datus.

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. Piekļūstiet digna panelim
2. Pārbaudiet, vai saskarne ielādējas pareizi
3. Pārskatiet servera žurnālus, vai nav kļūdu
4. Pārceliet uz ODBC katru savienojumu, kas vēl neizmantoja ODBC, un pēc tam pārbaudiet visus savienojumus — skatiet Savienojuma pārbaude:

sudo journalctl -u digna -n 100