macOS 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ā fona 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 Linux?¶

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

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:

Arhitektūras noskaidrošana¶

Vairāki šī ceļveža ceļi atšķiras Apple Silicon un Intel Mac datoriem. Lai noskaidrotu, kurš ir jums, atveriet Terminal un palaidiet:

uname -m

• arm64 — Apple Silicon. Homebrew tiek instalēts direktorijā /opt/homebrew.
• x86_64 — Intel. Homebrew tiek instalēts direktorijā /usr/local.

Priekšinstalācijas sagatavošana¶

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

1. Homebrew – pakotņu pārvaldnieks, ar ko tiek instalētas tālāk minētās sastāvdaļas
2. PostgreSQL Server – aprēķināto metrikas un veiktspējas datu glabāšanai
3. 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.

Homebrew instalēšana¶

Homebrew ir standarta pakotņu pārvaldnieks operētājsistēmai macOS, un visā šajā ceļvedī tas tiek izmantots PostgreSQL un nginx instalēšanai.

1. solis: Pārbaudīt, vai Homebrew jau ir instalēts¶

Atveriet Terminal (nospiediet Cmd + Space, ierakstiet Terminal, nospiediet Enter) un palaidiet:

brew --version

Ja tiek atgriezts versijas numurs, pārejiet uz sadaļu PostgreSQL servera iestatīšana.

2. solis: Instalēt Homebrew¶

Ja komanda netika atrasta, instalējiet Homebrew, izpildot norādījumus oficiālajā Homebrew vietnē. Instalators arī instalē Xcode Command Line Tools, ja tie vēl nav pieejami.

3. solis: Pievienot Homebrew savam PATH¶

Apple Silicon datoros instalators izvada divas komandas, kas pievieno Homebrew jūsu čaulas videi. Palaidiet tās, kā norādīts, un pēc tam pārbaudiet:

brew --prefix

Tam jāizvada /opt/homebrew Apple Silicon datorā vai /usr/local Intel datorā.

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.

Instalācijas iespējas¶

macOS piedāvā divus vienkāršus PostgreSQL instalēšanas veidus. Izvēlieties vienu:

• Homebrew — instalēšana no komandrindas, ieteicama servera izvietojumiem
• Postgres.app — grafiska instalēšana, ērta lokālai izvērtēšanai

PostgreSQL instalēšana ar Homebrew¶

1. solis: Instalēt PostgreSQL formulu¶

brew install postgresql@16

2. solis: Pievienot PostgreSQL savam PATH¶

Versionētās PostgreSQL formulas ir keg-only, kas nozīmē, ka Homebrew to komandas automātiski nepiesaista jūsu PATH. Pievienojiet tās paši:

echo 'export PATH="'$(brew --prefix)'/opt/postgresql@16/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. solis: Palaist PostgreSQL servisu¶

brew services start postgresql@16

Tas nekavējoties palaiž PostgreSQL un konfigurē to automātiski startēt atkal, kad jūs piesakāties.

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

psql --version

Ja instalācija bija veiksmīga, tiks parādīta PostgreSQL versija.

5. solis: Pieslēgties serverim¶

psql postgres

6. solis: Pārbaudīt portu¶

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

psql postgres -c "SHOW port;"

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

PostgreSQL instalēšana ar Postgres.app¶

Ja dodat priekšroku grafiskai instalēšanai:

1. Lejupielādējiet Postgres.app un ievelciet to mapē Applications
2. Atveriet lietotni un noklikšķiniet Initialize, lai izveidotu jaunu serveri
3. Izpildiet lietotnes norādījumus, lai pievienotu tās komandrindas rīkus savam PATH
4. Pārbaudiet instalāciju:

psql --version

Arī Postgres.app izveido superlietotāju, kas nosaukts jūsu macOS konta vārdā.

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 — instalēts ar Homebrew, ieteicams
• Apache httpd — iekļauts macOS

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¶

brew install nginx

nginx palaišana¶

brew services start nginx

Pārbaudīt instalāciju¶

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

Vietnes konfigurēšana panelim¶

Homebrew nginx konfigurācija iekļauj katru failu no savas servers direktorijas. Izveidojiet tur atsevišķu konfigurācijas failu digna vajadzībām:

nano $(brew --prefix)/etc/nginx/servers/digna.conf

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

server {
    listen       8080;
    server_name  localhost;

    root   /path/to/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;
    }
}

Piemērot konfigurāciju¶

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

nginx -t
brew services restart nginx

Apache httpd iestatīšana¶

Pārskats¶

macOS ietver Apache httpd, tāpēc instalēšana nav nepieciešama. Pēc noklusējuma tas ir atspējots.

Apache palaišana¶

sudo apachectl start

Pārbaudīt instalāciju¶

1. Atveriet pārlūkprogrammu
2. Dodieties uz http://localhost
3. Jums jāredz ziņojums "It works!"

Obligāti: iespējot mod_rewrite¶

Panelim nepieciešama URL pārrakstīšana. Atveriet Apache konfigurāciju:

sudo nano /etc/apache2/httpd.conf

Atrodiet šo rindu un noņemiet sākumā esošo #, lai to atkomentētu:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

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

Tajā pašā failā atrodiet bloku <Directory "/Library/WebServer/Documents"> un nomainiet:

AllowOverride None

uz:

AllowOverride All

Obligāti: MIME tips Markdown failiem¶

Joprojām failā httpd.conf 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 apachectl restart

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 Terminal vienā solī:

psql postgres

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 vai ~/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 Terminal:

unzip digna-2026.11-macos.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
chmod +x digna

Ja macOS bloķē lietojumprogrammu¶

Faili, kas lejupielādēti ar pārlūkprogrammu vai e-pasta klientu, tiek marķēti ar karantīnas atribūtu. Ja macOS ziņo, ka lietotni "cannot be opened because the developer cannot be verified", noņemiet atribūtu no instalācijas direktorijas:

xattr -dr com.apple.quarantine /opt/digna

Vai arī atveriet System Settings → Privacy & Security, atrodiet bloķēto vienumu lapas apakšā un noklikšķiniet Open Anyway.

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

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

mkdir -p /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 Terminal
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.

echo 'export PATH="/opt/digna:$PATH"' >> ~/.zshrc
source ~/.zshrc

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

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 $(brew --prefix)/etc/nginx/servers/digna.conf

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

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

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

5. Pārlādējiet nginx

   nginx -t
   brew services restart nginx
   

6. Pārbaudiet instalāciju

7. Atveriet pārlūkprogrammu
8. Dodieties uz http://localhost:8080 (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 /Library/WebServer/Documents/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 /Library/WebServer/Documents/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 apachectl restart
   

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

digna palaide kā fona serviss¶

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

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

• Automātiski startējas, kad dators tiek sāknēts
• Darbojas fonā bez atvērta Terminal loga
• Automātiski restartējas, ja notiek avārija
• To var pārvaldīt ar launchctl, macOS 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ā launchd
• 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
chmod +x *.sh

Servisa instalēšana¶

1. Atveriet Terminal

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ā launchd 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 Terminal
2. Pārejiet uz /opt/digna/bin
3. Palaidiet:

   sudo ./start_service.sh
   

Lai apturētu servisu¶

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

   sudo ./stop_service.sh
   

Servisa pārbaude¶

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

sudo launchctl list | grep digna

Rinda, kas sākas ar procesa ID, norāda, ka serviss darbojas. - pirmajā kolonnā nozīmē, ka tas ir reģistrēts, bet apturēts.

Pārvietot servisu uz jaunu direktoriju¶

launchd 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ā launchd.

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

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ā fona serviss, vispirms to apturiet:

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

Ja digna darbojas priekšplānā, tā Terminal 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
mv digna digna_old
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, ja nepieciešams, noņemiet karantīnas atribūtu:

chmod +x /opt/digna/digna
xattr -dr com.apple.quarantine /opt/digna

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

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 (Cmd+Shift+R).

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:

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ā fona 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, restartējiet attiecīgo tīmekļa serveri:

brew services restart nginx

sudo apachectl restart

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 izvadi un failus direktorijā logs, vai nav kļūdu.
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.