Ghid de instalare pe Linux pentru digna Release 2026.11¶

Release: 2026.11

Ultima actualizare: 7 noiembrie 2026

Cuprins¶

1. Introducere
2. Cerințe de sistem
3. Pregătirea înainte de instalare
4. Configurarea serverului PostgreSQL
5. Configurarea web serverului
6. Instalarea inițială
7. Configurarea backend-ului
8. Configurarea dashboard-ului
9. Rularea digna ca serviciu systemd
10. Actualizarea la o versiune nouă

Introducere¶

Despre digna¶

digna este o platformă completă, bazată pe AI, concepută pentru a optimiza gestionarea calității datelor în diverse medii de date, cum ar fi data warehouses, data lakes și lakehouses. Construită pentru scalabilitate și adaptabilitate ridicate, digna abordează provocările moderne ale datelor prin automatizare, monitorizare în timp real și detectarea anomaliilor.

digna este alcătuită din două componente principale:

• digna: nucleul aplicației, responsabil de prelucrarea datelor și de efectuarea verificărilor de calitate. Reunește backend-ul și interfața în linie de comandă într-un singur executabil, înlocuind programele separate dignabackend și dignacli din versiunile anterioare.
• dignadashboard: o interfață web găzduită pe un web server, care oferă o modalitate prietenoasă de a interacționa cu platforma digna și de a vizualiza metricile de calitate a datelor.

Noutăți în Release 2026.11¶

Această versiune adaugă digna Data Reconciliation, digna Agentic împreună cu digna MCP Server și digna Engine, care poate profila datele în interiorul digna și poate verifica integritatea referențială între tehnologii de baze de date diferite. Consultați notele de lansare pentru detalii complete.

Pentru instalare, versiunea aduce un nou mecanism de migrare a repository-ului, o secțiune opțională [duckdb] în config.toml pentru digna Engine și un nou fișier de licență. Secțiunea despre actualizare le tratează pe fiecare dintre ele.

Căutați Windows sau macOS?¶

Acest ghid acoperă Linux. Pentru alte platforme, consultați Ghidul de instalare Windows sau Ghidul de instalare macOS.

Ce distribuții acoperă acest ghid?¶

Instrucțiunile sunt scrise pentru cele mai răspândite două familii de servere. Acolo unde cele două diferă, sunt indicate ambele comenzi:

• Familia Debian — Debian, Ubuntu. Manager de pachete: apt.
• Familia RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Manager de pachete: dnf.

Orice distribuție modernă cu systemd va funcționa; se schimbă doar numele pachetelor și câteva căi de configurare.

Cerințe de sistem¶

Înainte de a începe instalarea, asigurați-vă că sistemul dumneavoastră îndeplinește următoarele cerințe minime:

Opțiuni de instalare a bazei de date¶

Dacă PostgreSQL este deja instalat: Puteți adăuga o bază de date nouă pentru digna pe serverul PostgreSQL existent.

Dacă instalați PostgreSQL pe aceeași mașină cu digna:

Verificarea distribuției și a arhitecturii¶

Mai multe comenzi din acest ghid diferă între familiile Debian și RHEL. Pentru a verifica pe care dintre ele vă aflați, rulați:

cat /etc/os-release
uname -m

• ID=ubuntu sau ID=debian — folosiți comenzile apt.
• ID=rhel, rocky, almalinux sau fedora — folosiți comenzile dnf.
• x86_64 sau aarch64 — arhitectura pachetului de instalare de care aveți nevoie.

Pregătirea înainte de instalare¶

Înainte de a instala digna, asigurați-vă că sunt pregătite două cerințe preliminare esențiale:

1. Serverul PostgreSQL – pentru stocarea metricilor calculate și a datelor de performanță
2. Web serverul – pentru găzduirea digna Dashboard

Dacă aceste componente nu sunt deja configurate, urmați secțiunile de mai jos pentru a le instala și configura.

Reîmprospătarea indexului de pachete¶

Actualizați listele de pachete înainte de a instala ceva:

sudo apt update

sudo dnf check-update

Configurarea serverului PostgreSQL¶

Dacă aveți deja PostgreSQL¶

Dacă PostgreSQL este deja instalat și rulează pe mașina locală sau dacă folosiți un server PostgreSQL gestionat, la distanță, puteți trece direct la secțiunea următoare.

Instalarea PostgreSQL¶

Pasul 1: Instalați pachetul serverului¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Pasul 2: Inițializați clusterul de baze de date¶

Pe familia Debian, pachetul creează și pornește automat un cluster — treceți la pasul următor.

Pe familia RHEL, clusterul trebuie creat explicit:

sudo postgresql-setup --initdb

Pasul 3: Porniți și activați serviciul¶

sudo systemctl enable --now postgresql

Aceasta pornește imediat PostgreSQL și îl configurează să pornească din nou automat la pornirea sistemului.

Pasul 4: Verificați instalarea¶

psql --version
sudo systemctl status postgresql

Ar trebui să vedeți versiunea PostgreSQL și un serviciu active (running).

Pasul 5: Conectați-vă la server¶

Un pachet PostgreSQL pentru Linux creează un cont de sistem postgres care deține clusterul. Conectați-vă prin intermediul acestuia:

sudo -u postgres psql

Pasul 6: Confirmați portul¶

Portul implicit PostgreSQL este 5432. Pentru a confirma portul pe care ascultă serverul:

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

Notați valoarea — veți avea nevoie de ea la configurarea backend-ului digna.

Pasul 7: Activați autentificarea prin parolă pentru utilizatorul digna¶

digna se conectează la PostgreSQL prin TCP ca digna_user, ceea ce necesită autentificare prin parolă, nu peer authentication. Verificați că fișierul pg_hba.conf permite acest lucru.

Găsiți fișierul:

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

Deschideți-l într-un editor și confirmați că liniile TCP locale folosesc scram-sha-256 (sau md5 pe serverele mai vechi), nu ident:

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

Reîncărcați PostgreSQL după orice modificare:

sudo systemctl reload postgresql

Pasul 8: Dacă PostgreSQL rulează pe o altă mașină¶

Pentru a accepta conexiuni de la o altă gazdă, setați listen_addresses în postgresql.conf și adăugați o linie host corespunzătoare pentru rețeaua dumneavoastră în pg_hba.conf:

listen_addresses = '*'

Apoi deschideți portul în firewall și reporniți serviciul:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Configurarea web serverului¶

digna necesită un web server pentru a găzdui dashboard-ul. Alegeți una dintre următoarele opțiuni:

• nginx — ușor și recomandat
• Apache httpd — alternativă larg răspândită

Trebuie să instalați și să configurați doar unul dintre aceste servere.

Ambele secțiuni configurează două lucruri de care depinde dashboard-ul:

• O rută de rezervă pentru aplicația single-page, astfel încât reîmprospătarea unui URL al dashboard-ului să nu returneze 404
• Un tip MIME pentru .md, astfel încât fișierele Markdown să fie servite corect

Configurarea nginx¶

Prezentare generală¶

nginx este un web server ușor și performant, foarte potrivit pentru servirea dashboard-ului static digna.

Instalare¶

sudo apt install -y nginx

sudo dnf install -y nginx

Pornirea nginx¶

sudo systemctl enable --now nginx

Verificați instalarea¶

1. Deschideți browserul
2. Accesați http://localhost
3. Ar trebui să vedeți pagina de bun venit nginx

Deschiderea firewall-ului¶

Dacă serverul este accesat de pe alte mașini, permiteți traficul HTTP:

sudo ufw allow 'Nginx Full'

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

Configurarea unui site pentru dashboard¶

Pe ambele familii de distribuții, nginx include fiecare fișier din directorul său conf.d. Creați acolo un fișier de configurare dedicat pentru digna:

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

Lipiți următorul conținut, înlocuind /opt/digna/dashboard cu calea reală către folderul dashboard extras:

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

Dezactivați site-ul implicit¶

Un singur bloc server poate fi default_server pentru un port. Pe familia Debian, eliminați site-ul implicit din pachet, pentru a nu intra în conflict:

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

Pe familia RHEL, comentați sau ștergeți blocul server { ... } din /etc/nginx/nginx.conf.

Aplicați configurația¶

Testați configurația pentru erori de sintaxă, apoi reîncărcați nginx:

sudo nginx -t
sudo systemctl reload nginx

Configurarea Apache httpd¶

Prezentare generală¶

Apache httpd este disponibil în repository-urile implicite ale fiecărei distribuții acceptate. Pachetul se numește apache2 pe familia Debian și httpd pe familia RHEL.

Instalare¶

sudo apt install -y apache2

sudo dnf install -y httpd

Pornirea Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Verificați instalarea¶

1. Deschideți browserul
2. Accesați http://localhost
3. Ar trebui să vedeți pagina Apache implicită a distribuției

Obligatoriu: activați mod_rewrite¶

Dashboard-ul necesită rescrierea URL-urilor.

Pe familia Debian, activați modulul și reporniți:

sudo a2enmod rewrite
sudo systemctl restart apache2

Pe familia RHEL, mod_rewrite este încărcat implicit. Confirmați acest lucru:

httpd -M | grep rewrite

Obligatoriu: permiteți suprascrierile .htaccess¶

Deschideți fișierul de configurare pentru document root:

sudo nano /etc/apache2/apache2.conf

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

Găsiți blocul <Directory> care acoperă document root (/var/www/html pe ambele familii) și modificați:

AllowOverride None

în:

AllowOverride All

Obligatoriu: tipul MIME pentru fișierele Markdown¶

În același fișier, adăugați linia următoare, astfel încât fișierele Markdown să fie servite corect:

AddType text/markdown .md

Aplicați configurația¶

Verificați configurația pentru erori de sintaxă, apoi reporniți Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Instalarea inițială¶

Pasul 1: Configurați repository-ul digna¶

Repository-ul digna stochează toate metricile calculate de digna. Acesta funcționează ca bază de date centrală pentru datele analitice și de performanță.

Creați schema repository-ului și utilizatorul¶

Deschideți clientul PostgreSQL (psql, pgAdmin sau similar) și executați următoarele comenzi SQL:

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

Înlocuiți următorii substituenți:

• <digna_repo_schema> — numele dorit pentru schemă (de ex. dignarepo)
• <digna_repo_user> — numele de utilizator dorit (de ex. digna_user)
• <digna_repo_password> — o parolă sigură pentru acest utilizator

Exemplu:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Pentru a le rula din shell într-un singur pas:

sudo -u postgres psql

Apoi lipiți instrucțiunile la promptul postgres=# și tastați \q pentru a ieși.

Pasul 2: Extrageți pachetul de instalare digna¶

1. Găsiți fișierul ZIP de instalare digna care v-a fost furnizat
2. Extrageți-l în locația de instalare dorită — de exemplu /opt/digna
3. După extragere, ar trebui să vedeți următoarele elemente:
4. dashboard/ — interfața web a dashboard-ului
5. digna — executabilul principal (backend + CLI combinate)

Pentru extragerea din shell:

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

Faceți executabilul rulabil¶

În funcție de modul în care a fost transferată arhiva, bitul de execuție s-ar putea să nu se păstreze la extragere. Setați-l explicit:

cd /opt/digna
sudo chmod +x digna

Creați un cont de serviciu¶

Pentru implementările de producție se recomandă rularea backend-ului sub un utilizator dedicat, fără privilegii:

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

Pasul 3: Instalați fișierul de licență¶

1. Găsiți fișierul license.toml care v-a fost furnizat
2. Copiați-l în directorul rădăcină al instalării digna (unde se află config.toml și executabilul digna)

De ce este important: Fișierul de licență conține informațiile dumneavoastră de client, data de expirare a licenței și semnătura digitală. Nu modificați acest fișier — orice modificare îl invalidează.

Structura directorului după configurare:

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

Configurarea backend-ului¶

Pasul 1: Creați și editați fișierul de configurare¶

Fișierul config_template.toml este furnizat în directorul de instalare digna. Trebuie doar să-l redenumiți în config.toml.

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

Locație: /opt/digna/config.toml

Deschideți config.toml într-un editor de text și configurați fiecare secțiune de mai jos.

Secțiunea [app]¶

Această secțiune configurează partajarea resurselor între origini (CORS) dintre dashboard și backend:

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

Secțiunea [repo]¶

Această secțiune configurează conexiunea la baza de date PostgreSQL:

[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

Secțiunea [base]¶

Această secțiune conține setările de securitate, pentru cookie-uri și pentru inspecții:

[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

Secțiunea [encryption]¶

Această secțiune conține cheia folosită pentru a cripta valorile sensibile stocate în repository. Este obligatorie — config check raportează secțiunea [encryption] ca FAILED dacă lipsește cheia.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Secțiunea [logging]¶

Această secțiune configurează comportamentul de logging:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

Secțiunea [duckdb] (opțională)¶

Nou în Release 2026.11. Această secțiune stabilește resursele digna Engine, care profilează datele în interiorul digna pentru conexiunile la baze de date a căror locație de profilare este digna Engine și rulează verificări de integritate referențială între surse de date aflate pe conexiuni la baze de date diferite. Consultați Locația de profilare.

Secțiunea este opțională. Fără ea se aplică valorile implicite de mai jos.

[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

Pasul 2: Validați configurația¶

Înainte de a inițializa repository-ul, verificați dacă config.toml este complet și corect alcătuit. În directorul de instalare digna, rulați:

./digna config check

Fiecare secțiune este validată separat, astfel încât o singură greșeală nu ascunde starea celorlalte:

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

Corectați tot ce este raportat ca FAILED și rulați comanda din nou înainte de a continua. Un WARNING la Unknown keys enumeră cheile din config.toml pe care digna nu le citește; acestea nu au niciun efect, așa că eliminați-le sau corectați-le ortografia. Lista completă a opțiunilor se află în referința CLI.

Pasul 3: Inițializați repository-ul¶

1. Deschideți un terminal
2. Accesați directorul de instalare digna (unde se află config.toml și executabilul digna)
3. Rulați testul de conexiune:

cd /opt/digna
./digna repo check

Pe o schemă nouă, comanda se conectează și apoi raportează că încă nu este instalat niciun repository:

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

În acest moment, acesta este rezultatul așteptat: confirmă că digna ajunge la PostgreSQL și la schemă. O eroare de conexiune sau de autentificare indică, în schimb, o problemă în secțiunea [repo] sau în configurarea PostgreSQL.

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

Pasul 4: Instalați schema repository-ului¶

În același director, rulați:

./digna repo upgrade

Această comandă instalează tabelele necesare în schema repository-ului și se încheie cu:

✅ Repo schema 'dignarepo' is up to date.

Pasul 5: Creați un utilizator administrator¶

Utilizatorul administrator este creat direct în schema repository-ului, astfel încât serverul nu trebuie să ruleze încă. În directorul de instalare digna, rulați:

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

Exemplu:

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

Aceasta creează un utilizator cu adresa de e-mail admin@example.com și privilegii administrative complete.

Pasul 6: Porniți serverul digna¶

În directorul de instalare digna, porniți serverul cu:

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

Parametri: - --address — numele de gazdă/IP-ul serverului (implicit 127.0.0.1) - --port — portul serverului (implicit 8000)

Când serverul a pornit, acesta afișează adresa pe care ascultă:

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

Configurarea dashboard-ului¶

Pasul 1: Implementați dashboard-ul pe web server¶

Dashboard-ul digna își citește propria configurație din dashboard/dashboard_config.toml. Acest fișier nu este livrat cu instalarea — îl creați în directorul dashboard/, alături de fișierele dashboard-ului.

Conținutul său este descris în Single Sign-On, unde este de altfel și nevoie de fișier: acesta conține opțiunile de autentificare oferite de dashboard și, pentru implementările cu mai multe instanțe, conexiunea la backend.

Alegeți web serverul și urmați pașii de implementare corespunzători.

Implementarea pe nginx¶

Dacă ați urmat secțiunea Configurarea nginx, blocul server indică deja folderul dashboard și nu este necesară nicio copiere.

1. Confirmați calea
2. Deschideți /etc/nginx/conf.d/digna.conf

3. Verificați că root indică folderul dashboard extras

4. Asigurați-vă că folderul poate fi citit

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

5. Reîncărcați nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Testați instalarea

7. Deschideți browserul
8. Accesați http://localhost (sau URL-ul configurat)
9. Ar trebui să vedeți pagina de autentificare a dashboard-ului digna

Implementarea pe Apache httpd¶

1. Copiați dashboard-ul în document root

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

2. Adăugați regulile de rescriere

Creați un fișier .htaccess în folderul implementat, astfel încât rutele dashboard-ului să reziste la reîmprospătarea browserului:

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

Lipiți următorul conținut:

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. Reporniți Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Accesați dashboard-ul

3. Deschideți browserul
4. Accesați http://localhost/digna
5. Ar trebui să vedeți pagina de autentificare a dashboard-ului digna

Pasul 2: SELinux (doar familia RHEL)¶

Pe RHEL, Rocky, AlmaLinux și Fedora, SELinux este implicit în modul enforcing și va împiedica web serverul să citească fișiere din afara locațiilor așteptate. Verificați dacă este activ:

getenforce

Dacă rezultatul este Enforcing și serviți dashboard-ul din /opt/digna/dashboard, etichetați directorul astfel încât web serverul să-l poată citi:

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

Rularea digna ca serviciu systemd¶

De ce să rulați digna ca serviciu?¶

Rularea backend-ului digna ca serviciu systemd asigură că acesta:

• Pornește automat la pornirea mașinii
• Rulează în fundal, fără o fereastră de terminal deschisă
• Repornește automat dacă se blochează
• Poate fi gestionat prin systemctl, managerul de servicii standard din Linux

Fișierele de gestionare a serviciului¶

Toate fișierele necesare se află în directorul de instalare digna, în: bin/

Sunt disponibile următoarele scripturi shell:

• install_service.sh — înregistrează digna în systemd
• uninstall_service.sh — anulează înregistrarea serviciului
• start_service.sh — pornește serviciul înregistrat
• stop_service.sh — oprește serviciul aflat în execuție

Facerea scripturilor executabile¶

Este posibil ca extragerea să nu păstreze bitul de execuție. Înainte de prima utilizare:

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

Instalarea serviciului¶

1. Deschideți un terminal

2. Accesați folderul bin

   cd /opt/digna/bin
   

3. Rulați scriptul de instalare

   sudo ./install_service.sh
   

Serverul digna este acum înregistrat în systemd, cu pornire automată activată. Serviciul nu pornește imediat — consultați secțiunea următoare pentru a-l porni.

Pornirea și oprirea serviciului¶

Pentru a porni serviciul¶

1. Deschideți un terminal
2. Accesați /opt/digna/bin
3. Rulați:

   sudo ./start_service.sh
   

Pentru a opri serviciul¶

1. Deschideți un terminal
2. Accesați /opt/digna/bin
3. Rulați:

   sudo ./stop_service.sh
   

Gestionarea serviciului cu systemctl¶

După înregistrare, serviciul poate fi controlat și cu comenzile systemd standard, din orice director:

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

Verificarea serviciului¶

Pentru a confirma că serviciul este înregistrat și rulează:

systemctl is-enabled digna
systemctl is-active digna

enabled înseamnă că serviciul pornește la pornirea sistemului; active înseamnă că rulează în acest moment.

Vizualizarea logurilor serviciului¶

systemd captează tot ce scrie backend-ul în consolă. Pentru a citi aceste mesaje:

sudo journalctl -u digna -n 100

Pentru a urmări logul în timp real în timp ce reproduceți o problemă:

sudo journalctl -u digna -f

Mutarea serviciului într-un director nou¶

Fișierul unit stochează calea absolută către executabil, așa că mutarea instalării necesită reînregistrarea serviciului:

1. Dezinstalați serviciul curent

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

2. Mutați fișierele aplicației

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

3. Reinstalați serviciul

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

4. Porniți serviciul

   sudo ./start_service.sh
   

Dezinstalarea serviciului¶

1. Opriți serviciul aflat în execuție

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

2. Dezinstalați serviciul

   sudo ./uninstall_service.sh
   

Serverul digna nu mai este acum înregistrat în systemd.

Actualizarea la o versiune nouă¶

Această secțiune actualizează o instalare Release 2026.06 la Release 2026.11. Dacă instalarea dumneavoastră este mai veche, citiți mai întâi Actualizarea de la o versiune mai veche decât 2026.06.

Înainte de actualizare¶

Crearea unei copii de siguranță a repository-ului digna este obligatorie

Înainte de a actualiza digna, faceți o copie de siguranță a repository-ului (PostgreSQL) pentru a vă proteja împotriva pierderii de date. O copie de siguranță vă permite recuperarea dacă actualizarea întâmpină probleme neașteptate.

Pentru a crea o copie de siguranță din shell:

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

Solicitarea fișierului de licență pentru Release 2026.11

Release 2026.11 necesită un nou license.toml. Solicitați-l echipei digna înainte de a începe și pregătiți-l pentru Pasul 7.

Actualizarea de la o versiune mai veche decât 2026.06¶

Release 2026.06 a adus trei schimbări care se aplică în continuare atunci când actualizați o instalare mai veche direct la 2026.11:

• Doar ODBC. digna accesează fiecare tehnologie sursă prin ODBC. Fiecare conexiune la baze de date care nu folosește încă ODBC trebuie trecută pe ODBC după actualizare; nu există conversie automată. Instalați în prealabil driverele ODBC pe gazda digna, consultați Instalarea driverului ODBC pe gazda digna, și pregătiți proprietățile fiecărei conexiuni din ghidurile pe tehnologii. Conectorul Databricks Legacy nu mai există; mutați acele conexiuni pe conectorul Databricks.
• Un singur executabil. dignabackend și dignacli sunt înlocuite de executabilul unic digna, care reunește backend-ul și CLI-ul.
• config.toml. Secțiunea [encryption] este obligatorie, iar DIGNA_APP_HOST și DIGNA_APP_PORT nu mai sunt citite: serverul își preia adresa și portul din digna serve. Comparați fișierul dumneavoastră cu Configurarea backend-ului.

Pașii de mai jos indică unde o instalare mai veche necesită altceva. Actualizarea repository-ului de la Pasul 8 aduce un repository din orice versiune anterioară direct la 2026.11.

Procesul de actualizare¶

Pasul 1: Opriți serviciul digna¶

Dacă digna rulează ca serviciu systemd, opriți-l mai întâi:

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

Dacă digna rulează în prim-plan, apăsați Ctrl+C în fereastra sa de terminal.

Pasul 2: Faceți o copie de siguranță a instalării curente¶

În directorul de instalare digna, redenumiți executabilul și folderul dashboard al instalării curente, astfel încât noua versiune să poată fi implementată alături de ele:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

Păstrați digna_old până când ați verificat actualizarea, iar dashboard_old până când v-ați restaurat din el fișierele de configurare (consultați Pasul 4). După aceea le puteți șterge pe amândouă.

Pasul 3: Extrageți și implementați noua versiune¶

1. Extrageți noul fișier ZIP de instalare digna
2. Copiați noul executabil digna și folderul dashboard în directorul de instalare
3. Restabiliți bitul de execuție și proprietarul (contul de serviciu):

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

Pasul 4: Restaurați fișierele de configurare¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Release 2026.11 nu necesită nicio modificare a config.toml: un fișier care funcționează cu Release 2026.06 funcționează în continuare. Două modificări sunt opționale:

• Adăugați o secțiune [duckdb] dacă conexiunile la baze de date vor folosi digna Engine, iar valorile implicite ale acestuia nu se potrivesc gazdei dumneavoastră.
• Omiteți secțiunea [app] dacă un reverse proxy servește dashboard-ul și backend-ul sub aceeași origine.

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

Pasul 5: Reîncărcați web serverul¶

Dashboard-ul este un set de fișiere statice, așa că web serverul — și browserul — pot servi în continuare versiunea anterioară. Reîncărcați sau reporniți web serverul care găzduiește folderul dashboard, apoi reîncărcați pagina forțat (Ctrl+F5).

Pasul 6: Validați configurația¶

Confirmați că config.toml este complet înainte de a atinge repository-ul:

./digna config check

Fiecare secțiune trebuie să raporteze OK. Corectați tot ce este raportat ca FAILED, eliminați cheile enumerate la Unknown keys și rulați comanda din nou înainte de a continua.

Pasul 7: Înlocuiți fișierul de licență¶

În mod normal, un fișier de licență se păstrează de la o versiune la alta. Release 2026.11 este o excepție: adaugă două module licențiate, digna Data Reconciliation și digna Agentic, iar o licență emisă înainte de 2026.11 nu le conține. Copiați fișierul license.toml furnizat de echipa digna pentru Release 2026.11 în directorul de instalare, înlocuindu-l pe cel vechi:

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

./digna license check

Pasul 8: Actualizați schema repository-ului¶

În directorul de instalare digna, rulați:

cd /opt/digna
./digna repo upgrade

Release 2026.11 gestionează schema repository-ului prin migrări versionate. Prima actualizare de la o versiune anterioară aduce schema la ultima versiune a vechiului sistem, o înregistrează ca punct de pornire și apoi aplică migrările din Release 2026.11. Se încheie cu:

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

Toate datele existente sunt păstrate. Pentru a vedea oricând starea repository-ului, rulați ./digna repo check: comanda afișează cea mai recentă migrare aplicată și eventualele migrări în așteptare.

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

Pasul 9: Reporniți serviciile¶

Dacă rulați ca serviciu systemd:

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

Dacă rulați manual, reporniți serverul:

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

Dacă folosiți nginx sau Apache, reîncărcați web serverul respectiv:

sudo systemctl reload nginx

sudo systemctl restart apache2

Pe familia RHEL, reaplicați etichetarea SELinux dacă directorul dashboard a fost înlocuit:

sudo restorecon -Rv /opt/digna/dashboard

Pasul 10: Verificați actualizarea¶

1. Confirmați versiunea noului executabil:

   ./digna version
   

   Prima linie trebuie să fie Release: 2026.11.

2. Accesați dashboard-ul digna și verificați că interfața se încarcă corect.

3. Verificați logurile serverului pentru erori:

   sudo journalctl -u digna -n 100
   

4. Testați conexiunile la baze de date — consultați Testarea unei conexiuni. După o actualizare de la o versiune mai veche decât 2026.06, treceți mai întâi pe ODBC fiecare conexiune care nu îl folosea încă.

Pentru a începe cu noile module, consultați digna Data Reconciliation, Conectarea unui agent AI pentru digna MCP Server și Locația de profilare pentru digna Engine.