macOS-asennusopas digna Release 2026.11:lle¶

Julkaisu: 2026.11

Viimeksi päivitetty: 7. marraskuuta 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.11:ssä¶

Tämä julkaisu tuo mukanaan digna Data Reconciliationin, digna Agenticin ja digna MCP Serverin sekä digna Enginen, joka voi profiloida dataa dignan sisällä ja tarkistaa viite-eheyden eri tietokantateknologioiden välillä. Katso täydet tiedot release notes.

Asennuksen kannalta julkaisu tuo uuden repositorion migraatiomekanismin, valinnaisen [duckdb]-osion config.toml-tiedostoon digna Engineä varten sekä uuden lisenssitiedoston. Päivitysosio käsittelee jokaisen niistä.

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.11-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ässä osiossa määritetään dashboardin ja backendin välinen cross-origin resource sharing (CORS):

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

[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!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

[base] -osio¶

Tämä osio sisältää turva-, eväste- ja tarkastusasetuksia:

[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] -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_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[duckdb] -osio (valinnainen)¶

Uutta Release 2026.11:ssä. Tämä osio määrittää digna Enginen resurssit. digna Engine profiloi dataa dignan sisällä niille tietokantayhteyksille, joiden profilointisijainti on digna Engine, ja suorittaa viite-eheystarkistuksia eri tietokantayhteyksien tietolähteiden välillä. Katso Profilointisijainti.

Osio on valinnainen. Ilman sitä käytetään alla olevia oletusarvoja.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

mkdir -p /opt/digna/tmp

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
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

Korjaa kaikki, mikä raportoidaan tilassa FAILED, ja suorita komento uudelleen ennen jatkamista. Kohdan Unknown keys alla oleva WARNING luettelee config.toml-tiedoston avaimet, joita digna ei lue; niillä ei ole vaikutusta, joten poista ne tai korjaa niiden kirjoitusasu. 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

Uudessa skeemassa komento muodostaa yhteyden ja ilmoittaa sitten, ettei repositoriota ole vielä asennettu:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

Tässä vaiheessa tämä on odotettu tulos: se vahvistaa, että digna tavoittaa PostgreSQL:n ja skeeman. Yhteys- tai todennusvirhe sen sijaan viittaa [repo]-osioon tai PostgreSQL-asetuksiin.

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

Vaihe 4: Asenna repositorion skeema¶

Samassa hakemistossa suorita:

./digna repo upgrade

Tämä komento asentaa tarvittavat taulut repositorion skeemaan ja päättyy ilmoitukseen:

✅ Repo schema 'dignarepo' is up to date.

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 (oletus 127.0.0.1) - --port — Palvelimen portti (oletus 8000)

Kun palvelin on käynnissä, se tulostaa osoitteen, jota se kuuntelee:

Server running on http://127.0.0.1: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¶

Tämä osio päivittää Release 2026.06 -asennuksen versioon Release 2026.11. Jos asennuksesi on vanhempi, lue ensin Päivitys julkaisua 2026.06 vanhemmasta versiosta.

Ennen päivitystä¶

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

Lisenssitiedoston pyytäminen Release 2026.11:tä varten

Release 2026.11 vaatii uuden license.toml-tiedoston. Pyydä se digna-tiimiltä ennen aloittamista ja pidä se valmiina vaihetta 7 varten.

Päivitys julkaisua 2026.06 vanhemmasta versiosta¶

Release 2026.06 toi kolme muutosta, jotka ovat yhä voimassa, kun päivität vanhemman asennuksen suoraan versioon 2026.11:

• Vain ODBC. digna tavoittaa jokaisen lähdeteknologian ODBC:n kautta. Jokainen tietokantayhteys, joka ei vielä käytä ODBC:tä, on muutettava ODBC:ksi päivityksen jälkeen; automaattista muunnosta ei ole. Asenna ODBC-ajurit digna-isäntään etukäteen, katso ODBC-ajurin asentaminen digna-isäntään, ja pidä kunkin yhteyden ominaisuudet valmiina teknologiaoppaista. Databricks Legacy -liitintä ei enää ole; siirrä nämä yhteydet Databricks-liittimeen.
• Yksi suoritettava tiedosto. dignabackend ja dignacli on korvattu yhdellä suoritettavalla tiedostolla digna, joka yhdistää backendin ja CLI:n.
• config.toml. [encryption]-osio on pakollinen, eikä DIGNA_APP_HOST- ja DIGNA_APP_PORT-asetuksia enää lueta: palvelin saa osoitteensa ja porttinsa komennolta digna serve. Vertaa tiedostoasi kohtaan Backendin määritys.

Alla olevat vaiheet kertovat, missä vanhempi asennus vaatii jotain muuta. Vaiheen 8 repositorion päivitys tuo minkä tahansa aiemman julkaisun repositorion suoraan versioon 2026.11.

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 suoritettava tiedosto ja dashboard-kansio uudelleen, jotta uusi julkaisu voidaan ottaa käyttöön niiden rinnalle:

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

Säilytä digna_old, kunnes olet varmistanut päivityksen, ja dashboard_old, kunnes olet palauttanut siitä konfiguraatiotiedostosi (katso vaihe 4). Sen jälkeen voit poistaa molemmat.

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

Release 2026.11 ei vaadi muutoksia config.toml-tiedostoon: tiedosto, joka toimii Release 2026.06:n kanssa, toimii edelleen. Kaksi muutosta on valinnaisia:

• Lisää [duckdb]-osio, jos tietokantayhteyksien on määrä käyttää digna Engineä eivätkä sen oletusarvot sovi isännällesi.
• Jätä [app]-osio pois, jos käänteinen välityspalvelin tarjoaa dashboardin ja backendin saman originin alla.

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

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ä config.toml on täydellinen ennen kuin kosket arkistoon:

./digna config check

Jokaisen osion on raportoitava OK. Korjaa kaikki, mikä raportoidaan tilassa FAILED, poista kohdan Unknown keys alla luetellut avaimet ja suorita komento uudelleen ennen jatkamista.

Vaihe 7: Vaihda lisenssitiedosto¶

Lisenssitiedosto siirtyy yleensä julkaisusta seuraavaan. Release 2026.11 on poikkeus: se lisää kaksi lisensoitua moduulia, digna Data Reconciliationin ja digna Agenticin, eikä ennen versiota 2026.11 myönnetty lisenssi sisällä niitä. Kopioi digna-tiimin Release 2026.11:tä 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¶

Suorita dignan asennushakemistossa:

cd /opt/digna
./digna repo upgrade

Release 2026.11 hallitsee repositorion skeemaa versioitujen migraatioiden avulla. Ensimmäinen päivitys aiemmasta julkaisusta tuo skeeman edellisen järjestelmän viimeiseen versioon, kirjaa sen lähtökohdakseen ja soveltaa sitten Release 2026.11:n migraatiot. Se päättyy ilmoituksiin:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Kaikki olemassa olevat tiedot säilyvät. Näet repositorion tilan milloin tahansa komennolla ./digna repo check: se luettelee viimeisimmän sovelletun migraation ja mahdolliset odottavat migraatiot.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

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. Vahvista uuden suoritettavan tiedoston julkaisu:

   ./digna version
   

   Ensimmäisen rivin on oltava Release: 2026.11.

2. Avaa digna-dashboard ja varmista, että käyttöliittymä latautuu oikein.

3. Tarkista palvelimen tuloste ja logs-hakemiston tiedostot virheiden varalta.
4. Testaa tietokantayhteytesi — katso Yhteyden testaaminen. Jos päivitit julkaisua 2026.06 vanhemmasta versiosta, muuta ensin jokainen yhteys, joka ei vielä käyttänyt ODBC:tä, ODBC:ksi.

Uusien moduulien käytön aloittamiseen katso digna Data Reconciliation, AI-agentin yhdistäminen digna MCP Serveriä varten ja Profilointisijainti digna Engineä varten.