macOS 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ā 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.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 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.06-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ē 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!"

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

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

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

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

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¶

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

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

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

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

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:

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