macOS diegimo vadovas digna leidimui 2026.06¶

Leidimas: 2026.06

Paskutinį kartą atnaujinta: 2026 m. rugsėjo 5 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.06¶

Šis leidimas įterpia duomenų stebėjimo (observability) galimybes tiesiai į jūsų kodą, leidžiant kūrėjams stebėti duomenų kokybę prie pat šaltinio. Pilną informaciją rasite išleidimo pastabose.

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.06-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 dignabackend programos nustatymus:

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

[base] skyrius¶

Šiame skyriuje yra saugumo ir slapukų nustatymai:

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

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

Overall: OK

Pataisykite viską, kas pranešama kaip FAILED, ir prieš tęsdami paleiskite komandą dar kartą. 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

Turėtumėte matyti patvirtinimą, kad ryšys užmegztas (savęs repozitorija dar nebus inicializuota).

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

4 žingsnis: įdiekite repozitorijos schemą¶

Tas pačioje direktorijoje vykdykite:

./digna repo install

Ši komanda įdiegs reikiamas lenteles ir schemą jūsų PostgreSQL duomenų bazėje.

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 - --port — serverio prievadas

Turėtumėte matyti paleidimo žinutes, patvirtinančias, kad serveris veikia:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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ą¶

Prieš atnaujinimą¶

Pirmiausia patikrinkite visus duomenų bazės ryšius

Nuo leidimo 2026.06 digna kiekvieną šaltinio technologiją pasiekia per ODBC. Ankstesni leidimai siūlė pasirinkimą tarp konkrečiai technologijai skirtos tvarkyklės ir ODBC, pažymimą jungikliu Use ODBC. digna komanda nusprendė remtis vien ODBC, nes viena standartinė sąsaja duoda daugiau nei pagal užsakymą sukurtų tvarkyklių rinkinys:

• Tapatybės nustatymas — tapatybės nustatymas yra ODBC dalis, todėl ryšys gali naudoti viską, ką palaiko jo tvarkyklė: slaptažodžius, prieigos raktus ir PAT, Kerberos ir Active Directory, MFA ir naršyklės vienkartinį prisijungimą, debesijos tapatybes, kliento sertifikatus ir TLS. Nauji metodai atkeliauja su tvarkyklės atnaujinimu, o ne laukiant digna leidimo.
• Tvarkyklės, kurias prižiūri duomenų bazių gamintojai — gamintojo tvarkyklė seka naujas serverio versijas ir saugumo pataisas, o jūs galite ją atnaujinti savo tempu, nepriklausomai nuo digna.
• Vienas būdas viską sukonfigūruoti — kiekviena technologija yra raktų ir reikšmių savybių sąrašas su ta pačia sąsaja, tuo pačiu jautrių reikšmių šifravimu ir ta pačia trikčių diagnostika, o ne skirtingais laukų rinkiniais kiekvienam šaltiniui.
• Derinimas ir aprėptis — tvarkyklės parinktys, tokios kaip skirtieji laikai, TLS nuostatos, tarpiniai serveriai ir nuskaitymo dydžiai, prieinamos kiekvienam šaltiniui, o prijungti galima bet kurią technologiją su atitinkama ODBC tvarkykle, taip pat ir tas, kurioms digna neskelbia atskiro vadovo.

Praktikoje tai reiškia, kad jungiklio Use ODBC bei atskirų pagrindinio kompiuterio, prievado, duomenų bazės, naudotojo ir slaptažodžio laukų nebeliko. Kiekvieną ryšį, kuris dar nenaudoja ODBC, reikia perkelti į ODBC — automatinio konvertavimo nėra, todėl suplanuokite tai prieš naujinimą:

1. Peržiūrėkite kiekvieną jūsų diegime apibrėžtą duomenų bazės ryšį ir pasižymėkite tuos, kurie dar nenaudoja ODBC — kiekvieną jų reikės sukonfigūruoti iš naujo.
2. Įdiekite atitinkamą ODBC tvarkyklę digna pagrindiniame kompiuteryje — ryšiai atveriami iš serverio, kuriame veikia digna užkulisinė dalis, o ne iš naršyklės. Žiūrėkite ODBC tvarkyklės diegimas digna pagrindiniame kompiuteryje.
3. Turėkite paruoštas ODBC savybes kiekvienam susijusiam ryšiui. Technologijų vadovai kiekvienam šaltiniui pateikia išbandytą savybių rinkinį.

Po naujinimo kiekvieną susijusį ryšį perkelkite į ODBC ir išbandykite jį iš skydelio — žiūrėkite Duomenų bazės ryšio kūrimas ir Ryšio tikrinimas.

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

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 aplankus, kad naują leidimą būtų galima įdiegti šalia jų:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

[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 ž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 atnaujintas config.toml yra išsamus:

./digna config check

Kiekvienas skyrius turi pranešti OK. Pataisykite viską, kas pranešama kaip FAILED, ir prieš tęsdami paleiskite komandą dar kartą.

7 žingsnis: pakeiskite licencijos failą¶

Kiekvienai laidai licencija išduodama atskirai. Nukopijuokite license.toml, kurį digna komanda pateikė šiai laidai, į diegimo katalogą, pakeisdami senąjį:

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

./digna license check

8 žingsnis: atnaujinkite repozitorijos schemą¶

Eikite į digna diegimo katalogą ir vykdykite:

cd /opt/digna
./digna repo upgrade

Tai atnaujins PostgreSQL schemą į naujausią versiją, išsaugant visus esamus duomenis.

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. Atidarykite digna dashboard
2. Patikrinkite, ar sąsaja užsikrauna teisingai
3. Peržiūrėkite serverio žurnalus dėl klaidų
4. Kiekvieną ryšį, kuris dar nenaudojo ODBC, perkelkite į ODBC, tada išbandykite visus ryšius — žiūrėkite Ryšio tikrinimas