macOS 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 foninė paslauga
10. Atsinaujinimas į naują leidimą

Įvadas¶

Apie digna¶

digna yra išsami, dirbtiniu intelektu paremta platforma, skirta optimizuoti duomenų kokybės valdymą įvairiose duomenų aplinkose — sandėliuose, ežeruose ir lakehouse tipo sistemose. Sukurta skalabilumui ir pritaikomumui, 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: internetinė sąsaja, talpinama tinklapio serveryje, leidžianti vartotojams patogiai sąveikauti su digna platforma ir vizualizuoti duomenų kokybės metrikas.

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 Linux diegimo instrukcijų?¶

Šis vadovas skirtas macOS. Kitiems platformoms žr. Windows diegimo vadovą arba Linux diegimo vadovą.

Sistemos reikalavimai¶

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

Duomenų bazės diegimo parinktys¶

Jei PostgreSQL jau įdiegtas: Galite pridėti naują duomenų bazę digna savo esamam PostgreSQL serveriui.

Jei diegiate PostgreSQL tame pačiame kompiuteryje kaip digna:

Kaip patikrinti savo architektūrą¶

Kai kurie keliai šiame vadove skiriasi Apple Silicon ir Intel Mac kompiuteriams. Norėdami sužinoti, kurį turite, atidarykite Terminal ir vykdykite:

uname -m

• arm64 — Apple Silicon. Homebrew įdiegiamas į /opt/homebrew.
• x86_64 — Intel. Homebrew įdiegiamas į /usr/local.

Prieš diegiant¶

Prieš įdiegdami digna, įsitikinkite, kad yra trys svarbios prielaidos:

1. Homebrew – paketų tvarkyklė, naudojama toliau pateiktiems komponentams įdiegti
2. PostgreSQL Server – skaičiuotoms metrikoms ir našumo duomenims saugoti
3. Tinklapio serveris – digna Dashboard talpinimui

Jei šių komponentų dar nėra, vykdykite žemiau pateiktas instrukcijas juos įdiegti ir sukonfigūruoti.

Homebrew diegimas¶

Homebrew yra standartinė paketų tvarkyklė macOS ir naudojama šiame vadove PostgreSQL bei nginx diegimui.

1 žingsnis: patikrinkite, ar Homebrew jau įdiegtas¶

Atidarykite Terminal (paspauskite Cmd + Space, įrašykite Terminal, paspauskite Enter) ir vykdykite:

brew --version

Jei grąžinamas versijos numeris, pereikite prie skyriaus PostgreSQL serverio nustatymas.

2 žingsnis: Homebrew įdiegimas¶

Jei komanda nebuvo rasta, įdiekite Homebrew pagal nurodymus oficialiame Homebrew puslapyje. Diegimo programa taip pat įdiegia Xcode Command Line Tools, jei jų dar nėra.

3 žingsnis: pridėti Homebrew į PATH¶

Apple Silicon įdiegimo programa išspausdina dvi komandas Homebrew pridėjimui prie jūsų shell aplinkos. Vykdykite jas pagal instrukcijas, tada patikrinkite:

brew --prefix

Tai turėtų išvesti /opt/homebrew Apple Silicon arba /usr/local Intel atveju.

PostgreSQL serverio nustatymas¶

Jei PostgreSQL jau yra¶

Jei PostgreSQL jau įdiegtas ir veikia jūsų vietiniame kompiuteryje arba naudojate valdomą nuotolinį PostgreSQL serverį, galite pereiti prie kito skyriaus Tinklapio serverio konfigūracija.

Diegimo parinktys¶

macOS siūlo dvi paprastas PostgreSQL diegimo galimybes. Pasirinkite vieną:

• Homebrew — diegimas per komandų eilutę, rekomenduojama serverio diegimams
• Postgres.app — grafiškas diegimas, patogu vietiniam vertinimui

PostgreSQL diegimas per Homebrew¶

1 žingsnis: įdiekite PostgreSQL formulę¶

brew install postgresql@16

2 žingsnis: pridėkite PostgreSQL į PATH¶

Sukonfigūruotos versijuotos PostgreSQL formulės yra keg-only, todėl Homebrew automatiškai neįtraukia jų komandų į jūsų PATH. Pridėkite jas patys:

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

3 žingsnis: paleiskite PostgreSQL paslaugą¶

brew services start postgresql@16

Tai paleidžia PostgreSQL iš karto ir sukonfigūruoja automatinį paleidimą prisijungiant.

4 žingsnis: patikrinkite diegimą¶

psql --version

Turėtumėte matyti PostgreSQL versiją, jei diegimas buvo sėkmingas.

5 žingsnis: prisijunkite prie serverio¶

psql postgres

6 žingsnis: patvirtinkite prievadą¶

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

psql postgres -c "SHOW port;"

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

PostgreSQL diegimas su Postgres.app¶

Jei pageidaujate grafiško sprendimo:

1. Atsisiųskite Postgres.app ir vilkite į Applications katalogą
2. Atidarykite aplikaciją ir spustelėkite Initialize, kad sukurtumėte naują serverį
3. Sekite programos nurodymus, kaip pridėti jos komandų eilutės įrankius į PATH
4. Patikrinkite diegimą:

psql --version

Postgres.app taip pat sukuria supervartotoją, pavadintą pagal jūsų macOS paskyros vardą.

Tinklapio serverio konfigūracija¶

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

• nginx — įdiegiamas per Homebrew, rekomenduojama
• Apache httpd — įtrauktas į macOS

Jums reikia įdiegti ir sukonfigūruoti vieną iš šių serverių.

Abi parinktys sukonfigūruoja du dalykus, kurių reikalauja dashboard:

• Vienos puslapio programos fallback, kad atnaujinus puslapį dashboard URL negrąžintų 404 klaidos
• .md MIME tipą, kad Markdown failai būtų teisingai tiekiami

nginx nustatymas¶

Apžvalga¶

nginx yra lengvas, didelio našumo tinklapio serveris, tinkamas statiniam digna dashboard aptarnavimui.

Diegimas¶

brew install nginx

nginx paleidimas¶

brew services start nginx

Patikrinkite diegimą¶

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

Svetainės konfigūravimas dashboardui¶

Homebrew nginx konfigūracija įtraukia visus failus iš savo servers katalogo. Sukurkite atskirą konfigūracijos failą digna čia:

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

Įklijuokite žemiau pateiktą bloką, pakeisdami /path/to/digna/dashboard tikru keliu iki išarchyvuoto dashboard katalogo:

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

Konfigūracijos taikymas¶

Patikrinkite sintaksę ir perkraukite nginx:

nginx -t
brew services restart nginx

Apache httpd nustatymas¶

Apžvalga¶

macOS komplekte yra Apache httpd, todėl diegti jo nereikia. Jis pagal numatytuosius nustatymus išjungtas.

Apache paleidimas¶

sudo apachectl start

Patikrinkite diegimą¶

1. Atidarykite naršyklę
2. Nueikite į http://localhost
3. Turėtumėte pamatyti pranešimą "It works!"

Privaloma: įjungti mod_rewrite¶

Dashboard reikalauja URL perrašymo. Atidarykite Apache konfigūraciją:

sudo nano /etc/apache2/httpd.conf

Suraskite šią eilutę ir pašalinkite pradinį #, kad ją atkomentuotumėte:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Privaloma: leisti .htaccess perrašymus¶

Tame pačiame faile suraskite bloką <Directory "/Library/WebServer/Documents"> ir pakeiskite:

AllowOverride None

į:

AllowOverride All

Privaloma: MIME tipas Markdown failams¶

Vis dar faile httpd.conf pridėkite šią eilutę, kad Markdown failai būtų tiekiami teisingai:

AddType text/markdown .md

Konfigūracijos taikymas¶

Patikrinkite konfigūraciją sintaksės klaidoms, tada perkraukite Apache:

sudo apachectl configtest
sudo apachectl restart

Pradinis diegimas¶

1 žingsnis: sukurkite digna repozitoriją¶

digna repozitorija saugo visas digna apskaičiuotas metrikas. Ji veikia kaip centrinė analitinių ir našumo duomenų duomenų bazė.

Sukurkite repozitorijos schemą ir vartotoją¶

Atidarykite savo PostgreSQL klientą (psql, pgAdmin ar panašų) 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 per Terminalą vienu žingsniu:

psql postgres

Tada įklijuokite šias komandas prie postgres=# eilutės 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į į norimą diegimo vietą — pavyzdžiui /opt/digna arba ~/digna
3. Po išarchyvavimo turėtumėte matyti šiuos elementus:
4. dashboard/ — žiniatinklio dashboard sąsaja
5. digna — pagrindinis vykdomasis failas (backend + CLI kartu)

Norint išarchyvuoti per Terminalą:

unzip digna-2026.11-macos.zip -d /opt/digna

Padarykite vykdomąjį failą vykdomu¶

Priklausomai nuo to, kaip archyvas buvo perduotas, vykdomasis bitas gali būti prarastas. Nustatykite jį aiškiai:

cd /opt/digna
chmod +x digna

Jei macOS blokuoja programą¶

Failai, atsisiųsti per naršyklę ar paštą, gali turėti karantino atributą. Jei macOS praneša, kad programa "cannot be opened because the developer cannot be verified", pašalinkite atributą iš diegimo katalogo:

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

Alternatyviai atidarykite System Settings → Privacy & Security, raskite užblokuotą elementą puslapio apačioje ir spustelėkite Open Anyway.

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 digna failas)

Kodėl tai svarbu: Licencijos faile yra jūsų kliento informacija, licencijos galiojimo data ir skaitmeninis parašas. Nekoreguokite šio failo — bet kokie pakeitimai jį sugadins.

Katalogo struktūra po nustatymo:

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

Backend konfigūracija¶

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

Jūsų digna diegimo kataloge yra pateiktas config_template.toml failas. Jį tik pervardykite į config.toml.

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

Vieta: /opt/digna/config.toml

Atidarykite config.toml tekstų redaktoriumi ir konfigūruokite kiekvieną skyrių žemiau.

[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 ryšį su PostgreSQL duomenų baze:

[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] 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 (logging) 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"

mkdir -p /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 repozitoriją¶

1. Atidarykite Terminal
2. Nueikite į digna diegimo katalogą (ten, kur yra config.toml ir vykdomasis digna)
3. Paleiskite ryšio patikrinimą:

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

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

4 žingsnis: įdiekite repozitorijos schemą¶

Tas pačioje direktorijoje vykdykite:

./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 vartotoją¶

1. Atidarykite naują Terminal langą
2. Nueikite į digna diegimo katalogą
3. Vykdykite komandą administratoriaus vartotojui sukurti:

./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 hostname/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

Dashboard konfigūracija¶

1 žingsnis: patalpinkite dashboard į tinklapio serverį¶

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 savo tinklapio serverį ir vykdykite atitinkamus diegimo veiksmus.

Diegimas į nginx¶

Jei sekėte nginx nustatymo skyrių, server blokas jau rodo jūsų dashboard katalogą ir kopijuoti failų nereikia.

1. Patikrinkite kelią
2. Atidarykite $(brew --prefix)/etc/nginx/servers/digna.conf

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

4. Užtikrinkite, kad katalogas skaitomas

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

5. Perkraukite nginx

   nginx -t
   brew services restart nginx
   

6. Patikrinkite diegimą

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

Diegimas į Apache httpd¶

1. Kopijuokite dashboard į dokumentų šaknį

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Pridėkite perrašymo taisykles

Sukurkite .htaccess failą įdiegtoje aplanke, kad dashboard maršrutai išliktų persikrovus puslapį:

sudo nano /Library/WebServer/Documents/digna/.htaccess

Įklijuokite:

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

2. Prieiga prie dashboard

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

digna paleidimas kaip foninė paslauga¶

Kodėl verta paleisti digna kaip paslaugą?¶

digna backend paleidus kaip foninę paslaugą užtikrina, kad jis:

• Automatiškai paleidžiamas sistemos įkrovos metu
• Veikia fone be atidaryto Terminal lango
• Automatiškai perkraunamas avarijos atveju
• Valdomas per launchctl, macOS paslaugų tvarkytuvą

Paslaugos valdymo failai¶

Visi reikalingi failai yra digna diegimo kataloge po: bin/

Prieinami šie shell skriptai:

• install_service.sh — registruoja digna su launchd
• uninstall_service.sh — atregistruoja paslaugą
• start_service.sh — paleidžia užregistruotą paslaugą
• stop_service.sh — sustabdo veikiančią paslaugą

Padarykite skriptus vykdomais¶

Išarchyvavus vykdomasis bitas gali nebūti išsaugotas. Prieš pirmą naudojimą:

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

Paslaugos įdiegimas¶

1. Atidarykite Terminal

2. Nueikite į bin katalogą

   cd /opt/digna/bin
   

3. Paleiskite įdiegimo skriptą

   sudo ./install_service.sh
   

digna serveris dabar užregistruotas su launchd su automatinio paleidimo būsena. Paslauga nebus paleista iš karto — žr. kitą skyrių, jei norite ją paleisti.

Paslaugos paleidimas ir stabdymas¶

Paslaugos paleidimas¶

1. Atidarykite Terminal
2. Nueikite į /opt/digna/bin
3. Vykdykite:

   sudo ./start_service.sh
   

Paslaugos stabdymas¶

1. Atidarykite Terminal
2. Nueikite į /opt/digna/bin
3. Vykdykite:

   sudo ./stop_service.sh
   

Paslaugos patikra¶

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

sudo launchctl list | grep digna

Eilutė, prasidedanti proceso ID, reiškia, kad paslauga veikia. - pirmame stulpelyje reiškia, kad paslauga užregistruota, bet sustabdyta.

Perkėlimas į naują katalogą¶

launchd saugo absoliutų kelią iki vykdomojo failo, todėl perkėlimas reikalauja pakartotinio registravimo:

1. Atregistruokite dabartinę paslaugą

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

2. Perkelkite programos failus

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

3. Įdiekite paslaugą iš naujos vietos

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

4. Paleiskite paslaugą

   sudo ./start_service.sh
   

Paslaugos pašalinimas¶

1. Sustabdykite veikiančią paslaugą

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

2. Pašalinkite paslaugą

   sudo ./uninstall_service.sh
   

digna serveris dabar atregistruotas iš launchd.

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š atnaujinimą¶

Privaloma sukurti digna repozitorijos atsarginę kopiją

Prieš atnaujinant digna, sukurkite savo repozitorijos (PostgreSQL) atsarginę kopiją, kad apsaugotumėte duomenis nuo praradimo. Atsarginė kopija leis atstatyti sistemą, jei atnaujinimo metu kiltų nenumatytų problemų.

Atsarginę kopiją galite sukurti per Terminalą:

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

1 žingsnis: sustabdykite digna paslaugą¶

Jei digna veikia kaip foninė paslauga, pirmiausia ją sustabdykite:

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

Jei digna paleistas priešakyje (foreground), paspauskite Ctrl+C to Terminal lango.

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
mv digna digna_old
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 išdėstykite 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, jei reikia, pašalinkite karantino atributą:

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

4 žingsnis: atstatykite konfigūracijos failus¶

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

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

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

./digna license check

8 žingsnis: atnaujinkite repozitorijos 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: perkraukite paslaugas¶

Jei naudojate foninę paslaugą:

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

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

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

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

brew services restart nginx

sudo apachectl restart

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 išvestį ir logs katalogo failus, ar nėra klaidų.
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.