Linux-asennusopas digna Release 2026.06:lle¶

Julkaisu: 2026.06

Viimeksi päivitetty: 5. syyskuuta 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.06¶

Tässä julkaisussa datan observoitavuusominaisuudet tuodaan suoraan koodiin, jolloin kehittäjät voivat valvoa datan laatua lähteellä. Katso täydet tiedot release notes.

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

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

[base] -osio¶

Tämä osio sisältää suojaus- ja evästeasetukset:

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

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

cd /opt/digna
./digna repo check

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

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

Vaihe 4: Asenna repositorion skeema¶

Sama hakemisto auki, suorita:

./digna repo install

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

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 - --port — Palvelimen portti

Näet käynnistysviestit, jotka vahvistavat palvelimen olevan käynnissä:

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

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

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 kansiot uudelleen, jotta uusi julkaisu voidaan ottaa käyttöön niiden rinnalle:

cd /opt/digna
sudo mv dignabackend dignabackend_old

sudo mv dignacli dignacli_old

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

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

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:

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

./digna license check

Vaihe 8: Päivitä repositorion skeema¶

Siirry dignan asennushakemistoon ja suorita:

cd /opt/digna
./digna repo upgrade

Tämä päivittää PostgreSQL-skeeman uusimpaan versioon säilyttäen kaikki olemassa olevat tiedot.

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

sudo journalctl -u digna -n 100