macOS-asennusopas digna Release 2026.06:lle¶

Julkaisu: 2026.06

Viimeksi päivitetty: 5. syyskuuta 2026

Sisällysluettelo¶

1. Johdanto
2. Järjestelmävaatimukset
3. Esiasennuksen valmistelut
4. PostgreSQL-palvelimen asennus
5. Web-palvelimen määritys
6. Alkuasennus
7. Backendin määritys
8. Dashboardin määritys
9. digna:n ajaminen taustapalveluna
10. Päivitys uuteen julkaisuun

Johdanto¶

Tietoa digna:sta¶

digna on kattava tekoälypohjainen alusta, joka on suunniteltu optimoimaan datalaadun hallintaa erilaisissa dataympäristöissä, kuten varastoissa, järvissä ja lakehouse-ratkaisuissa. Skalautuvuutensa ja mukautettavuutensa ansiosta digna vastaa nykyaikaisiin datahaasteisiin automaation, reaaliaikaisen seurannan ja poikkeamien tunnistuksen avulla.

digna koostuu kahdesta pääkomponentista:

• digna: sovelluksen ydin, joka vastaa tietojen käsittelystä ja laatutarkistusten suorittamisesta. Se yhdistää taustajärjestelmän ja komentorivikäyttöliittymän yhteen suoritettavaan tiedostoon ja korvaa aiempien julkaisujen erilliset ohjelmat dignabackend ja dignacli.
• dignadashboard: Verkkopohjainen käyttöliittymä, joka isännöidään web-palvelimella ja tarjoaa käyttäjäystävällisen tavan käyttää digna-alustaa ja visualisoida datalaatumittareita.

Mitä uutta Release 2026.06:ssa¶

Tässä julkaisussa datan observabiliteetti tuodaan suoraan koodiin, jolloin kehittäjät voivat seurata datalaatua jo lähteellä. Katso täydelliset tiedot release notes.

Etsitkö Windowsia tai Linuxia?¶

Tämä opas kattaa macOS:n. Muille alustoille katso Windows Installation Guide tai Linux Installation Guide.

Järjestelmävaatimukset¶

Ennen asennuksen aloittamista varmista, että järjestelmäsi täyttää seuraavat vähimmäisvaatimukset:

Tietokannan asennusvaihtoehdot¶

Jos PostgreSQL on jo asennettu: Voit lisätä uuden tietokannan digna:lle olemassa olevaan PostgreSQL-palvelimeesi.

Jos asennat PostgreSQL:n samalle koneelle kuin digna:

Arkkitehtuurin tarkistus¶

Monet tämän oppaan polut eroavat Apple Silicon- ja Intel-masien välillä. Tarkista laitteesi arkkitehtuuri avaamalla Terminal ja suorittamalla:

uname -m

• arm64 — Apple Silicon. Homebrew asentuu polkuun /opt/homebrew.
• x86_64 — Intel. Homebrew asentuu polkuun /usr/local.

Esiasennuksen valmistelut¶

Ennen digna:n asentamista varmista, että kolme keskeistä edellytystä on paikallaan:

1. Homebrew – pakettienhallinta, jolla asennetaan alla olevat komponentit
2. PostgreSQL Server – laskettujen mittareiden ja suorituskykytiedon tallennukseen
3. Web-palvelin – digna Dashboardin isännöintiin

Jos näitä komponentteja ei ole vielä asennettu, seuraa alla olevia osioita asentaaksesi ja konfiguroidaksesi ne.

Homebrew'n asennus¶

Homebrew on macOS:n yleinen pakettienhallinta ja sitä käytetään tässä oppaassa PostgreSQL:n ja nginx:n asentamiseen.

Vaihe 1: Tarkista, onko Homebrew jo asennettu¶

Avaa Terminal (paina Cmd + Space, kirjoita Terminal, paina Enter) ja suorita:

brew --version

Jos komentoon palautuu versiopäivämäärä, siirry kohtaan PostgreSQL-palvelimen asennus.

Vaihe 2: Asenna Homebrew¶

Jos komentoa ei löydy, asenna Homebrew seuraamalla ohjeita virallisella Homebrew-sivustolla. Asentaja asentaa myös Xcode Command Line Tools -paketin, jos sitä ei ole jo asennettu.

Vaihe 3: Lisää Homebrew PATHiin¶

Apple Siliconilla asennusohjelma tulostaa kaksi komentoa Homebrew'n lisäämiseksi shell-ympäristöön. Suorita ne ohjeiden mukaisesti ja vahvista:

brew --prefix

Tämän pitäisi tulostaa /opt/homebrew Apple Siliconilla tai /usr/local Intelillä.

PostgreSQL-palvelimen asennus¶

Jos sinulla on jo PostgreSQL¶

Jos PostgreSQL on jo asennettu ja käynnissä paikallisella koneellasi tai käytät hallinnoitua etä-PG-palvelinta, voit siirtyä seuraavaan osioon: Web-palvelimen määritys.

Asennusvaihtoehdot¶

macOS tarjoaa kaksi suoraviivaista tapaa asentaa PostgreSQL. Valitse yksi:

• Homebrew — komentorivityökalu, suositeltu palvelinympäristöihin
• Postgres.app — graafinen asennus, kätevä paikalliseen arviointiin

PostgreSQL:n asennus Homebrew'lla¶

Vaihe 1: Asenna PostgreSQL-formula¶

brew install postgresql@16

Vaihe 2: Lisää PostgreSQL PATHiin¶

Versioidut PostgreSQL-formulat ovat keg-only, joten Homebrew ei linkitä niiden komentoja PATHiin automaattisesti. Lisää ne itse:

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

Vaihe 3: Käynnistä PostgreSQL-palvelu¶

brew services start postgresql@16

Tämä käynnistää PostgreSQL:n välittömästi ja asettaa sen käynnistymään automaattisesti kirjautuessasi sisään.

Vaihe 4: Vahvista asennus¶

psql --version

Näet PostgreSQL-version, jos asennus onnistui.

Vaihe 5: Yhdistä palvelimeen¶

psql postgres

Vaihe 6: Vahvista portti¶

Oletusportti PostgreSQL:lle on 5432. Varmista palvelimen kuuntelema portti:

psql postgres -c "SHOW port;"

Muista tämän arvo myöhempiä digna-backendin asetuksia varten.

PostgreSQL:n asennus Postgres.app:illa¶

Jos haluat graafisen asennuksen:

1. Lataa Postgres.app ja raahaa se Applications-kansioon
2. Avaa sovellus ja klikkaa Initialize luodaksesi uuden palvelimen
3. Seuraa sovelluksen ohjeita lisätäksesi komentorivityökalut PATHiin
4. Vahvista asennus:

psql --version

Postgres.app luo myös superkäyttäjän, jonka nimi vastaa macOS-käyttäjätiliäsi.

Web-palvelimen määritys¶

digna tarvitsee web-palvelimen dashboardin isännöintiin. Valitse yksi seuraavista vaihtoehdoista:

• nginx — asennetaan Homebrew'lla, suositeltu
• Apache httpd — sisältyy macOS:ään

Tarvitset vain yhden näistä palvelimista ja konfiguroit sen seuraavien riippuvuuksien mukaisesti:

• Single-page-application fallback, jotta dashboard-URL:n uudelleenlataus ei aiheuta 404-virhettä
• .md-MIME-tyyppi, jotta Markdown-tiedostot toimitetaan oikealla tyypillä

nginx-määritys¶

Yleiskatsaus¶

nginx on kevyt, korkean suorituskyvyn web-palvelin, joka sopii hyvin staattisen digna-dashboardin tarjoamiseen.

Asennus¶

brew install nginx

nginx:n käynnistäminen¶

brew services start nginx

Vahvista asennus¶

1. Avaa selaimesi
2. Siirry osoitteeseen http://localhost:8080
3. Näet nginxin tervetulosivun

Sivuston konfigurointi dashboardille¶

Homebrew'n nginx-konfiguraatio lataa kaikki tiedostot servers-hakemistostaan. Luo oma konfiguraatiotiedosto digna:lle sinne:

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

Liitä seuraava, korvaten /path/to/digna/dashboard todellisella polulla purettuun dashboard-kansioon:

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

Ota konfiguraatio käyttöön¶

Testaa syntaksivirheet ja lataa nginx uudelleen:

nginx -t
brew services restart nginx

Apache httpd -määritys¶

Yleiskatsaus¶

macOS sisältää Apache httpd:n, joten asennusta ei tarvita. Se on oletuksena pois päältä.

Apachen käynnistäminen¶

sudo apachectl start

Vahvista asennus¶

1. Avaa selain
2. Siirry osoitteeseen http://localhost
3. Näet viestin "It works!"

Pakollinen: mod_rewritein ottaminen käyttöön¶

Dashboard vaatii URL-uudelleenkirjoituksen. Avaa Apache-konfiguraatio:

sudo nano /etc/apache2/httpd.conf

Etsi seuraava rivi ja poista edestä # niin että se on kommentoimaton:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Pakollinen: salli .htaccess-ylikirjoitukset¶

Saman tiedoston sisällä etsi <Directory "/Library/WebServer/Documents"> -lohko ja vaihda:

AllowOverride None

muotoon:

AllowOverride All

Pakollinen: MIME-tyyppi Markdown-tiedostoille¶

Lisää httpd.conf-tiedostoon seuraava rivi, jotta Markdown-tiedostot toimitetaan oikein:

AddType text/markdown .md

Ota konfiguraatio käyttöön¶

Tarkista syntaksivirheet ja käynnistä Apache uudelleen:

sudo apachectl configtest
sudo apachectl restart

Alkuasennus¶

Vaihe 1: Luo digna-repositorio ja käyttäjä¶

digna-repositorio tallentaa kaikki digna:n laskemat mittarit. Se toimii keskitettynä tietokantana analytiikka- ja suorituskykytiedolle.

Luo skeema ja käyttäjä¶

Avaa PostgreSQL-asiakasohjelma (psql, pgAdmin tai muu) ja suorita seuraavat SQL-komennot:

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

Korvaa seuraavat paikkamerkit:

• <digna_repo_schema> — haluamasi skeeman nimi (esim. dignarepo)
• <digna_repo_user> — haluamasi käyttäjänimi (esim. digna_user)
• <digna_repo_password> — turvallinen salasana tälle käyttäjälle

Esimerkki:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Suorittaaksesi nämä Terminalissa yhdessä vaiheessa:

psql postgres

Liitä sitten lauseet postgres=# -kehotteessa ja poistu kirjoittamalla \q.

Vaihe 2: Pura digna-asennuspaketti¶

1. Etsi sinulle toimitettu digna-asennus ZIP-tiedosto
2. Pura se haluamaasi asennushakemistoon — esimerkiksi /opt/digna tai ~/digna
3. Purkamisen jälkeen sinun pitäisi nähdä seuraavat kohteet:
4. dashboard/ — Web-dashboardin käyttöliittymä
5. digna — Pääsuoritettava tiedosto (backend + CLI yhdessä)

Pura Terminalista:

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

Tee suoritettavasta tiedostosta ajettava¶

Riippuen siitä, miten arkisto on siirretty, suoritusoikeus ei välttämättä säily purkamisen yhteydessä. Aseta se manuaalisesti:

cd /opt/digna
chmod +x digna

Jos macOS estää sovelluksen käynnistämisen¶

Selain- tai sähköpostilataukset merkitään usein karanteeniattribuutilla. Jos macOS ilmoittaa, että sovellusta "ei voi avata, koska kehittäjää ei voida varmentaa", poista attribuutti asennushakemistosta:

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

Vaihtoehtoisesti avaa System Settings → Privacy & Security, etsi estetty kohde sivun alaosasta ja valitse Open Anyway.

Vaihe 3: Asenna lisenssitiedosto¶

1. Etsi sinulle toimitettu license.toml-tiedosto
2. Kopioi se digna-asennuksen juurihakemistoon (samaan hakemistoon jossa config.toml ja digna-suoritettava ovat)

Miksi tämä on tärkeää: Lisenssitiedosto sisältää asiakastiedot, lisenssin vanhenemispäivän ja digitaaliset allekirjoitukset. Älä muokkaa tätä tiedostoa — kaikki muutokset mitätöivät sen.

Hakemistorakenne asennuksen jälkeen:

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

Backendin määritys¶

Vaihe 1: Luo ja muokkaa konfiguraatiotiedostoa¶

config_template.toml -tiedosto toimitetaan digna-asennushakemistossasi. Sinun tarvitsee vain nimetä se config.toml -tiedostoksi.

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

Sijainti: /opt/digna/config.toml

Avaa config.toml tekstieditorissa ja konfiguroi alla olevat osiot.

[app] -osio¶

Tämä osio määrittää digna-backendin sovellusasetukset:

[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] -osio¶

Tämä osio määrittää yhteyden PostgreSQL-tietokantaan:

[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] -osio¶

Tämä osio sisältää turva- ja evästeasetuksia:

[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] -osio¶

Tämä osio sisältää avaimen, jolla arkiston arkaluontoiset arvot salataan. Se on pakollinen — config check raportoi osion [encryption] tilassa FAILED, jos avain puuttuu.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] -osio¶

Tämä osio määrittää lokituksen käyttäytymisen:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Vaihe 2: Tarkista konfiguraatio¶

Varmista ennen arkiston alustusta, että config.toml on täydellinen ja oikein muodostettu. Suorita digna-asennushakemistossasi:

digna config check

Jokainen osio tarkistetaan erikseen, joten yksittäinen virhe ei peitä muiden tilaa:

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

Korjaa kaikki, mikä raportoidaan tilassa FAILED, ja suorita komento uudelleen ennen jatkamista. Täydellinen luettelo valinnoista on CLI-viitteessä.

Vaihe 3: Alusta repositorio¶

1. Avaa Terminal
2. Siirry digna-asennushakemistoon (jossa config.toml ja digna-suoritettava sijaitsevat)
3. Testaa yhteys:

cd /opt/digna
./digna repo check

Saat vahvistuksen, että yhteys on muodostettu (repo ei vielä ole alustettu).

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

Vaihe 4: Asenna repositorion skeema¶

Samaalla hakemistossa suorita:

./digna repo install

Tämä komento asentaa tarvittavat taulut ja skeeman PostgreSQL-tietokantaasi.

Vaihe 5: Luo ylläpitäjäkäyttäjä¶

1. Avaa uusi Terminal-ikkuna
2. Siirry digna-asennushakemistoon
3. Luo ylläpitäjäkäyttäjä seuraavalla komennolla:

./digna user add <email> <password> "<display_name>" --admin

Esimerkki:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

Tämä luo käyttäjän sähköpostiosoitteella admin@example.com ja täysillä järjestelmänvalvojan oikeuksilla.

Vaihe 6: Käynnistä digna-palvelin¶

Digna-asennushakemistossa käynnistä palvelin:

./digna serve --address <host> --port <port>

Parametrit: - --address — Palvelimen isäntä/IP - --port — Palvelimen portti

Näet käynnistysviestejä, jotka vahvistavat palvelimen käynnistyneen:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost:8082

Dashboardin määritys¶

Vaihe 1: Ota dashboard käyttöön web-palvelimella¶

digna-dashboard lukee oman konfiguraationsa tiedostosta dashboard/dashboard_config.toml. Tätä tiedostoa ei toimiteta asennuksen mukana — luot sen dashboard/-hakemistoon dashboardin tiedostojen rinnalle.

Sen sisältö on kuvattu kohdassa Yhden kirjautumisen (SSO) yleiskatsaus, jossa tiedostoa myös tarvitaan: se sisältää dashboardin tarjoamat kirjautumisvaihtoehdot ja monen instanssin käyttöönotoissa backend-yhteyden.

Valitse web-palvelimesi ja seuraa vastaavia käyttöönotto-ohjeita.

Käyttöönotto nginx:llä¶

Jos noudatit nginx-määritystä, server-lohko osoittaa jo dashboard-kansioosi eikä tiedoston kopiointia tarvita.

1. Vahvista polku
2. Avaa $(brew --prefix)/etc/nginx/servers/digna.conf

3. Varmista, että root osoittaa purettuun dashboard-kansioon

4. Varmista, että kansio on luettavissa

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

5. Lataa nginx uudelleen

   nginx -t
   brew services restart nginx
   

6. Testaa asennus

7. Avaa selain
8. Siirry osoitteeseen http://localhost:8080 (tai konfiguroituun URL-osoitteeseen)
9. Näet digna-dashboardin kirjautumissivun

Käyttöönotto Apache httpd:llä¶

1. Kopioi dashboard dokumenttihakemistoon

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

2. Lisää uudelleenkirjoitussäännöt

Luo .htaccess-tiedosto asennetun kansion sisälle, jotta dashboard-reitit säilyvät selainuudelleenlatauksissa:

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

Liitä seuraava:

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. Käynnistä Apache uudelleen

   sudo apachectl restart
   

2. Avaa dashboard

3. Avaa selain
4. Siirry osoitteeseen http://localhost/digna
5. Näet digna-dashboardin kirjautumissivun

digna:n ajaminen taustapalveluna¶

Miksi ajaa digna palveluna?¶

digna-backendin ajaminen taustapalveluna varmistaa, että se:

• Käynnistyy automaattisesti koneen käynnistyessä
• Ajaa taustalla ilman auki olevaa Terminal-ikkunaa
• Käynnistyy uudelleen automaattisesti virheen sattuessa
• On hallittavissa launchctl-työkalulla, joka on macOS:n palvelunhallinta

Palvelunhallintatiedostot¶

Kaikki tarvittavat tiedostot sijaitsevat digna-asennushakemistossa polussa: bin/

Seuraavat shell-skriptit ovat käytettävissä:

• install_service.sh — rekisteröi digna:n launchd:iin
• uninstall_service.sh — poistaa rekisteröinnin
• start_service.sh — käynnistää rekisteröidyn palvelun
• stop_service.sh — pysäyttää käynnissä olevan palvelun

Tee skripteistä suoritettavia¶

Purkaminen ei välttämättä säilytä suoritusoikeuksia. Ennen ensimmäistä käyttökertaa:

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

Palvelun asennus¶

1. Avaa Terminal

2. Siirry bin-hakemistoon

   cd /opt/digna/bin
   

3. Suorita asennusskripti

   sudo ./install_service.sh
   

Digna-palvelu on nyt rekisteröity launchd:iin automaattisen käynnistyksen kanssa. Palvelu ei välttämättä käynnisty heti — katso seuraava osio sen käynnistämiseksi.

Palvelun käynnistäminen ja pysäyttäminen¶

Palvelun käynnistäminen¶

1. Avaa Terminal
2. Siirry /opt/digna/bin
3. Suorita:

   sudo ./start_service.sh
   

Palvelun pysäyttäminen¶

1. Avaa Terminal
2. Siirry /opt/digna/bin
3. Suorita:

   sudo ./stop_service.sh
   

Palvelun tarkistus¶

Varmista, että palvelu on rekisteröity ja käynnissä:

sudo launchctl list | grep digna

Rivi, joka alkaa prosessi-ID:llä, tarkoittaa että palvelu on käynnissä. - ensimmäisessä sarakkeessa tarkoittaa, että se on rekisteröity mutta pysäytetty.

Palvelun siirtäminen uuteen hakemistoon¶

launchd tallentaa suoritettavan tiedoston absoluuttisen polun, joten asennuksen siirto vaatii palvelun uudelleenrekisteröinnin:

1. Poista nykyinen palvelu

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

2. Siirrä sovellustiedostot

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

3. Asenna palvelu uudelleen

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

4. Käynnistä palvelu

   sudo ./start_service.sh
   

Palvelun poistaminen¶

1. Pysäytä käynnissä oleva palvelu

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

2. Poista palvelu

   sudo ./uninstall_service.sh
   

Digna-palvelu on nyt poistettu launchd:stä.

Päivittäminen uuteen julkaisuun¶

Ennen päivitystä¶

Tarkista ensin kaikki tietokantayhteydet

Julkaisusta 2026.06 alkaen digna tavoittaa jokaisen lähdeteknologian ODBC:n kautta. Aiemmat julkaisut tarjosivat valinnan teknologiakohtaisen ajurin ja ODBC:n välillä kytkimellä Use ODBC. digna-tiimi päätti rakentaa pelkästään ODBC:n varaan, koska yksi standardoitu rajapinta antaa enemmän kuin joukko räätälöityjä ajureita:

• Todennus — todennus on osa ODBC:tä, joten yhteys voi käyttää kaikkea, mitä sen ajuri tukee: salasanoja, tokeneita ja PAT-tunnisteita, Kerberosta ja Active Directorya, monivaiheista tunnistautumista ja selainpohjaista kertakirjautumista, pilvi-identiteettejä, asiakasvarmenteita ja TLS:ää. Uudet menetelmät tulevat ajuripäivityksen mukana sen sijaan, että odotettaisiin digna-julkaisua.
• Tietokantatoimittajien ylläpitämät ajurit — toimittajan oma ajuri seuraa uusia palvelinversioita ja tietoturvakorjauksia, ja voit päivittää sen omassa aikataulussasi dignasta riippumatta.
• Yksi tapa määrittää kaikki — jokainen teknologia on avain–arvo-ominaisuuksien luettelo, samalla käyttöliittymällä, samalla arkaluontoisten arvojen salauksella ja samalla vianmäärityksellä, eikä eri kenttäjoukolla lähdettä kohden.
• Hienosäätö ja kattavuus — ajuritason valinnat kuten aikakatkaisut, TLS-asetukset, välityspalvelimet ja hakukoot ovat käytettävissä jokaiselle lähteelle, ja mikä tahansa teknologia, jolla on standardin mukainen ODBC-ajuri, voidaan liittää — myös sellaiset, joille digna ei julkaise omaa opasta.

Käytännössä tämä tarkoittaa, ettei kytkintä Use ODBC eikä erillisiä isäntä-, portti-, tietokanta-, käyttäjä- ja salasanakenttiä ole enää olemassa. Jokainen yhteys, joka ei jo käytä ODBC:tä, on muutettava ODBC:ksi — automaattista muunnosta ei ole, joten suunnittele tämä ennen päivitystä:

1. Käy läpi jokainen asennuksessasi määritelty tietokantayhteys ja merkitse muistiin ne, jotka eivät vielä käytä ODBC:tä — jokainen niistä on määritettävä uudelleen.
2. Asenna vastaava ODBC-ajuri digna-isäntään — yhteydet avataan palvelimelta, jolla digna-taustajärjestelmä toimii, ei selaimesta. Katso ODBC-ajurin asentaminen digna-isäntään.
3. Pidä ODBC-ominaisuudet valmiina jokaiselle koskevalle yhteydelle. Teknologiaoppaat luettelevat lähdekohtaisen, koetellun ominaisuusjoukon.

Muuta päivityksen jälkeen jokainen koskeva yhteys ODBC:ksi ja testaa se hallintapaneelista — katso Tietokantayhteyden luominen ja Yhteyden testaaminen.

digna-repositorion varmuuskopiointi on pakollinen

Ennen digna:n päivittämistä, varmuuskopioi repositoriosi (PostgreSQL) estääksesi datan menetyksen. Varmuuskopio varmistaa palautusmahdollisuuden, jos päivityksessä ilmenee odottamattomia ongelmia.

Luo varmuuskopio Terminalissa:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Päivitysprosessi¶

Vaihe 1: Pysäytä digna-palvelu¶

Jos digna on käynnissä taustapalveluna, pysäytä se ensin:

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

Jos digna on ajossa etualalla, keskeytä se painamalla Ctrl + C sen Terminal-ikkunassa.

Vaihe 2: Varmuuskopioi nykyinen asennus¶

Nimeä digna-asennushakemistossa nykyisen asennuksen kansiot uudelleen, jotta uusi julkaisu voidaan ottaa käyttöön niiden rinnalle:

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

Vaihe 3: Pura ja ota uusi versio käyttöön¶

1. Pura uusi digna-asennus ZIP-tiedosto
2. Kopioi uusi digna-suoritettava ja dashboard-kansio asennushakemistoosi
3. Palauta suoritusoikeus ja tarvittaessa poista karanteeniattribuutti:

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

Vaihe 4: Palauta konfiguraatiotiedostosi¶

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'

Vaihe 5: Lataa web-palvelin uudelleen¶

Dashboard koostuu staattisista tiedostoista, joten web-palvelimesi — ja selain — saattaa yhä tarjoilla edellistä versiota. Lataa uudelleen tai käynnistä uudelleen se web-palvelin, joka isännöi dashboard-kansiota, ja lataa sitten sivu uudelleen pakotetulla päivityksellä (Cmd+Shift+R).

Vaihe 6: Tarkista konfiguraatio¶

Varmista, että päivitetty config.toml on täydellinen ennen kuin kosket arkistoon:

./digna config check

Jokaisen osion on raportoitava OK. Korjaa kaikki, mikä raportoidaan tilassa FAILED, ja suorita komento uudelleen ennen jatkamista.

Vaihe 7: Vaihda lisenssitiedosto¶

Jokainen julkaisu lisensoidaan erikseen. Kopioi digna-tiimin tätä julkaisua varten toimittama license.toml asennushakemistoon vanhan tiedoston tilalle:

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

./digna license check

Vaihe 8: Päivitä repositorion skeema¶

Siirry digna-asennushakemistoon ja suorita:

cd /opt/digna
./digna repo upgrade

Tämä päivittää PostgreSQL-skeeman uusimpaan versioon säilyttäen kaiken olemassa olevan datan.

Vaihe 9: Käynnistä palvelut uudelleen¶

Jos ajetaan taustapalveluna:

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

Jos ajetaan manuaalisesti, käynnistä palvelin uudelleen:

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

Jos käytät nginx:iä tai Apachea, käynnistä vastaava web-palvelin uudelleen:

brew services restart nginx

sudo apachectl restart

Vaihe 10: Vahvista päivitys¶

1. Avaa digna-dashboard
2. Varmista, että käyttöliittymä latautuu oikein
3. Tarkista palvelinlokit mahdollisten virheiden varalta
4. Muuta jokainen yhteys, joka ei vielä käyttänyt ODBC:tä, ODBC:ksi ja testaa sitten kaikki yhteydet — katso Yhteyden testaaminen