Linux-asennusopas digna Release 2026.11:lle¶

Julkaisu: 2026.11

Viimeksi päivitetty: 7. marraskuuta 2026

Sisällysluettelo¶

1. Johdanto
2. Järjestelmävaatimukset
3. Ennen asennusta
4. PostgreSQL-palvelimen asennus
5. Web-palvelimen konfiguraatio
6. Alustava asennus
7. Backendin määritys
8. Dashboardin määritys
9. dignan ajaminen systemd-palveluna
10. Päivitys uuteen julkaisuun

Johdanto¶

Tietoa dignasta¶

digna on kattava tekoälyä hyödyntävä alusta, joka on suunniteltu optimoimaan datalaadun hallintaa erilaisissa data-ympäristöissä, kuten varastoissa, lammissa ja lakehouse-ympäristöissä. Suunniteltu erittäin skaalautuvaksi ja mukautuvaksi, digna vastaa moderneihin datahaasteisiin automaation, reaaliaikaisen valvonnan ja poikkeamien havaitsemisen avulla.

digna koostuu kahdesta pääosasta:

• 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: Web-pohjainen 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 julkaisussa 2026.11¶

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ö Windows- tai macOS-ohjeita?¶

Tämä opas käsittelee Linuxia. Muille alustoille katso Windows Installation Guide tai macOS Installation Guide.

Mitä jakelua tämä opas kattaa?¶

Ohjeet on kirjoitettu kahta yleisintä palvelinjakeluperhettä varten. Jos komennot eroavat, molemmat annetaan:

• Debian-perhe — Debian, Ubuntu. Paketinhallinta: apt.
• RHEL-perhe — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Paketinhallinta: dnf.

Mikä tahansa nykyaikainen jakelu, jossa on systemd, toimii; ainoastaan pakettien nimet ja muutama konfiguraatiopolku vaihtelevat.

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 dignalle olemassa olevaan PostgreSQL-palvelimeen.

Jos asennat PostgreSQL:n samalle koneelle kuin digna:

Jakelun ja arkkitehtuurin tarkistus¶

Tämän oppaan useat komennot eroavat Debian- ja RHEL-perheiden välillä. Tarkista jakelusi ja arkkitehtuuri ajamalla:

cat /etc/os-release
uname -m

• ID=ubuntu tai ID=debian — käytä apt-komentoja.
• ID=rhel, rocky, almalinux tai fedora — käytä dnf-komentoja.
• x86_64 tai aarch64 — asennuspaketin tarvitsemasi arkkitehtuuri.

Ennen asennusta¶

Ennen dignan asentamista varmista, että kaksi keskeistä edellytystä ovat kunnossa:

1. PostgreSQL-palvelin – lasketun mittariston ja suorituskykytietojen tallennusta varten
2. Web-palvelin – digna Dashboardin isännöintiä varten

Jos nämä komponentit eivät ole vielä valmiina, seuraa alla olevia osioita asentaaksesi ja konfiguroidaksesi ne.

Pakettilistan päivittäminen¶

Päivitä pakettien listat ennen asennusta:

sudo apt update

sudo dnf check-update

PostgreSQL-palvelimen asennus¶

Jos sinulla on jo PostgreSQL¶

Jos PostgreSQL on jo asennettu ja käynnissä paikallisella koneella tai käytät hallittua etä-PostgreSQL-palvelinta, voit siirtyä seuraavaan osioon.

PostgreSQL:n asennus¶

Vaihe 1: Asenna palvelinpaketti¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Vaihe 2: Alusta tietokantaklusteri¶

Debian-perheessä paketti luo ja käynnistää klusterin automaattisesti — siirry seuraavaan vaiheeseen.

RHEL-perheessä klusteri täytyy luoda eksplicitisti:

sudo postgresql-setup --initdb

Vaihe 3: Käynnistä ja ota palvelu käyttöön¶

sudo systemctl enable --now postgresql

Tämä käynnistää PostgreSQL:n välittömästi ja konfiguroi sen käynnistymään automaattisesti uudelleenkäynnistyksen yhteydessä.

Vaihe 4: Varmista asennus¶

psql --version
sudo systemctl status postgresql

Näet PostgreSQL-version ja active (running) -palvelun tilan.

Vaihe 5: Yhdistä palvelimeen¶

Linuxin PostgreSQL-paketti luo postgres-järjestelmätilin, joka omistaa klusterin. Yhdistä sen kautta:

sudo -u postgres psql

Vaihe 6: Vahvista portti¶

Oletus PostgreSQL-portti on 5432. Varmista, mille portille palvelimesi kuuntelee:

sudo -u postgres psql -c "SHOW port;"

Muista arvo — tarvitset sen digna-backendin konfiguroinnissa.

Vaihe 7: Ota salasana-autentikointi käyttöön digna-käyttäjälle¶

digna yhdistää PostgreSQL:ään TCP:n yli käyttäjänä digna_user, joka edellyttää salasana-autentikointia sen sijaan, että käytettäisiin peer/ident-autentikointia. Tarkista, että pg_hba.conf sallii sen.

Etsi tiedosto:

sudo -u postgres psql -c "SHOW hba_file;"

Avaa se editorissa ja varmista, että paikalliset TCP-rivit käyttävät scram-sha-256 (tai vanhemmissa palvelimissa md5) ident-menetelmän sijaan:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Lataa PostgreSQL uudelleen muutoksen jälkeen:

sudo systemctl reload postgresql

Vaihe 8: Jos PostgreSQL sijaitsee eri koneessa¶

Hyväksyäksesi yhteydet toisesta isännästä, aseta listen_addresses postgresql.conf-tiedostossa ja lisää vastaava host-rivi verkollesi pg_hba.conf-tiedostoon:

listen_addresses = '*'

Avaa sitten portti palomuurissa ja käynnistä palvelu uudelleen:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Web-palvelimen konfiguraatio¶

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

• nginx — kevyt ja suositeltava
• Apache httpd — laajalti käytetty vaihtoehto

Tarvitset vain yhden näistä palvelimista.

Molemmat osiot konfiguroivat kaksi dashboardin tarvitsemaa asiaa:

• Single-page application -varmistus, jotta dashboardin URL:n uudelleenlataus ei palauta 404-virhettä
• .md MIME-tyyppi, jotta Markdown-tiedostot palvellaan oikein

nginxin asennus¶

Yleiskatsaus¶

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

Asennus¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginxin käynnistäminen¶

sudo systemctl enable --now nginx

Asennuksen tarkistus¶

1. Avaa selain
2. Mene osoitteeseen http://localhost
3. Näet nginx-tervetuliasivun

Palomuurin avaaminen¶

Jos palvelimeen tavoitellaan muilta koneilta, salli HTTP-liikenne:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Sivuston konfigurointi dashboardille¶

nginx lukee kaikki tiedostot conf.d-hakemistostaan molemmilla jakeluperheillä. Luo oma konfiguraatiotiedosto dignalle sinne:

sudo nano /etc/nginx/conf.d/digna.conf

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

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/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;
    }
}

Poista oletussivusto käytöstä¶

Vain yksi server-lohko voi olla default_server portissa. Debian-perheessä poista paketoitu oletus, jotta se ei aiheuta ristiriitaa:

sudo rm /etc/nginx/sites-enabled/default

RHEL-perheessä kommentoi tai poista server { ... } -lohko tiedostosta /etc/nginx/nginx.conf.

Ota konfiguraatio käyttöön¶

Tarkista syntaksi ja lataa nginx uudelleen:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd:n asennus¶

Yleiskatsaus¶

Apache httpd on saatavilla oletusarkistoista kaikissa tuetuissa jakeluissa. Paketin nimi on apache2 Debian-perheessä ja httpd RHEL-perheessä.

Asennus¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apachen käynnistäminen¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Asennuksen tarkistus¶

1. Avaa selain
2. Mene osoitteeseen http://localhost
3. Näet jakelun oletus Apachen sivun

Pakollinen: mod_rewritein ottaminen käyttöön¶

Dashboard vaatii URL-osoitteiden uudelleenkirjoituksen.

Debian-perheessä ota moduuli käyttöön ja käynnistä uudelleen:

sudo a2enmod rewrite
sudo systemctl restart apache2

RHEL-perheessä mod_rewrite on yleensä ladattu oletuksena. Varmista se:

httpd -M | grep rewrite

Pakollinen: Salli .htaccess-ylikirjoitukset¶

Avaa dokumenttijuuren konfiguraatiotiedosto:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Etsi <Directory>-lohko, joka kattaa dokumenttijuuren (/var/www/html molemmilla perheillä) ja muuta:

AllowOverride None

muotoon:

AllowOverride All

Pakollinen: MIME-tyyppi Markdown-tiedostoille¶

Lisää samaan tiedostoon seuraava rivi, jotta Markdown-tiedostot palvellaan oikein:

AddType text/markdown .md

Ota konfiguraatio käyttöön¶

Tarkista syntaksi ja käynnistä Apache uudelleen:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Alustava asennus¶

Vaihe 1: Luo dignan repositorio¶

digna-repositorio tallentaa kaikki dignan laskemat mittarit. Se toimii keskitettynä tietokantana analytiikka- ja suorituskykytiedoille.

Luo skeema ja käyttäjä¶

Avaa PostgreSQL-asiakas (psql, pgAdmin tai vastaava) 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> — Haluttu skeeman nimi (esim. dignarepo)
• <digna_repo_user> — Haluttu 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;

Yhdellä komennolla kuoren kautta:

sudo -u postgres psql

Liitä sitten yllä olevat lauseet postgres=# -kehotteeseen ja kirjoita \q poistuaksesi.

Vaihe 2: Pura digna-asennuspaketti¶

1. Etsi sinulle toimitettu digna-asennus ZIP-tiedosto
2. Pura se haluamaasi asennushakemistoon — esimerkiksi /opt/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ä)

Kuoren kautta purkaminen:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Tee suoritustiedostosta suoritettava¶

Riippuen siitä, miten arkisto on siirretty, suoritusoikeus ei ehkä säily purkamisen yhteydessä. Aseta se eksplisiittisesti:

cd /opt/digna
sudo chmod +x digna

Luo palvelutili¶

On suositeltavaa ajaa backend erillisenä ei-privilegioituna käyttäjänä tuotantoympäristöissä:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Vaihe 3: Asenna lisenssitiedosto¶

1. Etsi sinulle toimitettu license.toml-tiedosto
2. Kopioi se dignan asennushakemiston juureen (kohtaan, jossa config.toml ja digna-suoritustiedosto sijaitsevat)

Miksi tämä on tärkeää: Lisenssitiedosto sisältää asiakastietosi, lisenssin vanhenemispäivän ja digitaalisen allekirjoituksen. Älä muokkaa tätä tiedostoa — muutokset mitätöivät sen.

Hakemistorakenne asennuksen jälkeen:

/opt/digna/
├── config.toml         (konfiguraatiotiedosto)
├── license.toml        (OMA LISENSSITIEDOSTOSI - kopioi tänne)
├── digna               (pääsuoritettava)
├── bin/                (palvelunhallintaskriptit)
└── dashboard/          (web-käyttöliittymä)
    └── (dashboard-tiedostot)

Backendin määritys¶

Vaihe 1: Luo ja muokkaa konfiguraatiotiedostoa¶

config_template.toml -tiedosto toimitetaan dignan asennushakemistossa. Tarvitsee vain nimetä se config.toml-tiedostoksi.

cd /opt/digna
sudo 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

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

[base] -osio¶

Tämä osio sisältää suojaus-, eväste- ja tarkastusasetukset:

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

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /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 repositorioyhteys¶

1. Avaa terminaali
2. Siirry dignan asennushakemistoon (jossa config.toml ja digna-suoritustiedosto sijaitsevat)
3. Suorita yhteystarkistus:

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.

sudo ln -s /opt/digna/digna /usr/local/bin/digna

Vaihe 4: Asenna repositorion skeema¶

Sama hakemisto auki, 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 terminaali-ikkuna
2. Siirry dignan asennushakemistoon
3. Suorita seuraava komento luodaksesi ylläpitäjäkäyttäjän:

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

Dignan asennushakemistossa käynnistä palvelin komennolla:

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

Parametrit: - --address — Palvelimen hostname/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

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

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 nginxillä¶

Jos seurasit nginxin asennusta, server-lohko osoittaa jo dashboard-kansioosi eikä kopiointia tarvita.

1. Varmista polku
2. Avaa /etc/nginx/conf.d/digna.conf

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

4. Varmista, että kansio on luettavissa

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

5. Lataa nginx uudelleen

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Testaa asennus

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

Käyttöönotto Apachella¶

1. Kopioi dashboard dokumenttijuureen

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Lisää uudelleenkirjoitussäännöt

Luo .htaccess-tiedosto asennettuun kansioon, jotta dashboardin reitit säilyvät sivun uudelleenlatauksen aikana:

sudo nano /var/www/html/digna/.htaccess

Liitä seuraava sisältö:

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 systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Avaa dashboard

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

Vaihe 2: SELinux (vain RHEL-perhe)¶

RHEL:ssä, Rockyssä, AlmaLinuxissa ja Fedoressa SELinux on oletuksena päällä (enforcing) ja estää web-palvelinta lukemasta tiedostoja odotetuista sijainneista. Tarkista onko se aktiivinen:

getenforce

Jos tulos on Enforcing ja tarjoat dashboardia /opt/digna/dashboard -kansiosta, leimaa hakemisto jotta web-palvelin voi lukea sitä:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

dignan ajaminen systemd-palveluna¶

Miksi ajaa digna palveluna?¶

digna-backendin ajaminen systemd-palveluna varmistaa, että se:

• Käynnistyy automaattisesti koneen käynnistyessä
• Ajetaan taustalla ilman avointa terminaali-ikkunaa
• Käynnistyy automaattisesti uudelleen kaatumisen jälkeen
• On hallittavissa systemctl-komennolla, joka on standardi Linux-palvelunhallinta

Palvelunhallintatiedostot¶

Kaikki tarvittavat tiedostot löytyvät dignan asennushakemistosta kansiosta: bin/

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

• install_service.sh — Rekisteröi dignan systemd:hen
• 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
sudo chmod +x *.sh

Palvelun asennus¶

1. Avaa terminaali

2. Siirry bin-kansioon

   cd /opt/digna/bin
   

3. Suorita asennusskripti

   sudo ./install_service.sh
   

digna-palvelin on nyt rekisteröity systemd:hen automaattisella käynnistyksellä. Palvelu ei välttämättä käynnisty heti — katso seuraavaa osiota käynnistystä varten.

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

Palvelun käynnistäminen¶

1. Avaa terminaali
2. Siirry /opt/digna/bin-hakemistoon
3. Suorita:

   sudo ./start_service.sh
   

Palvelun pysäyttäminen¶

1. Avaa terminaali
2. Siirry /opt/digna/bin-hakemistoon
3. Suorita:

   sudo ./stop_service.sh
   

Palvelun hallinta systemctl:llä¶

Kun palvelu on rekisteröity, sitä voi hallita myös standardeilla systemd-komennoilla mistä tahansa hakemistosta:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Palvelun vahvistus¶

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

systemctl is-enabled digna
systemctl is-active digna

enabled tarkoittaa, että palvelu käynnistyy bootissa; active tarkoittaa, että se on käynnissä juuri nyt.

Palvelulokit¶

systemd tallentaa kaiken, mitä backend kirjoittaa konsoliin. Lue lokit:

sudo journalctl -u digna -n 100

Seuraa lokia reaaliaikaisesti toistaen ongelman:

sudo journalctl -u digna -f

Siirto uuteen hakemistoon¶

Yksikkötiedosto tallentaa absoluuttisen polun suoritettavaan tiedostoon, joten asennuksen siirto edellyttää palvelun uudelleenrekisteröintiä:

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-palvelin on nyt poistettu systemd:stä.

Päivitys 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 pakollista

Ennen dignan päivittämistä, varmuuskopioi repositoriosi (PostgreSQL) datan menetyksen varalta. Varmuuskopio mahdollistaa palautuksen, jos päivityksessä ilmenee odottamattomia ongelmia.

Luo varmuuskopio kuoren kautta:

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 ajetaan systemd-palveluna, pysäytä se ensin:

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

Jos digna ajetaan etualalla, paina Ctrl+C sen terminaali-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
sudo mv digna digna_old
sudo 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-suoritustiedosto ja dashboard-kansio asennushakemistoon
3. Palauta suoritusoikeus ja palvelutilin omistus:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Vaihe 4: Palauta konfiguraatiotiedostosi¶

sudo 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ä (Ctrl+F5).

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:

sudo 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 systemd-palveluna:

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

Jos ajettiin manuaalisesti, käynnistä palvelin uudelleen:

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

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

sudo systemctl reload nginx

sudo systemctl restart apache2

RHEL-perheessä, jos dashboard-hakemisto korvattiin, aseta SELinux-leimat uudelleen:

sudo restorecon -Rv /opt/digna/dashboard

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 palvelinlokit virheiden varalta:

   sudo journalctl -u digna -n 100
   

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.