Ghid de instalare pe macOS pentru digna Release 2026.06¶

Release: 2026.06

Ultima actualizare: 5 septembrie 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 în fundal
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.06¶

Această versiune aduce capabilitățile de observabilitate a datelor direct în codul dumneavoastră, permițând dezvoltatorilor să monitorizeze calitatea datelor la sursă. Consultați notele de lansare pentru detalii complete.

Căutați Windows sau Linux?¶

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

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

Mai multe căi din acest ghid diferă între Mac-urile cu Apple Silicon și cele cu Intel. Pentru a verifica ce aveți, deschideți Terminal și rulați:

uname -m

• arm64 — Apple Silicon. Homebrew se instalează în /opt/homebrew.
• x86_64 — Intel. Homebrew se instalează în /usr/local.

Pregătirea înainte de instalare¶

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

1. Homebrew – managerul de pachete folosit pentru a instala componentele de mai jos
2. Serverul PostgreSQL – pentru stocarea metricilor calculate și a datelor de performanță
3. 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.

Instalarea Homebrew¶

Homebrew este managerul de pachete standard pentru macOS și este folosit în tot acest ghid pentru a instala PostgreSQL și nginx.

Pasul 1: Verificați dacă Homebrew este deja instalat¶

Deschideți Terminal (apăsați Cmd + Space, tastați Terminal, apăsați Enter) și rulați:

brew --version

Dacă se afișează un număr de versiune, treceți direct la secțiunea Configurarea serverului PostgreSQL.

Pasul 2: Instalați Homebrew¶

Dacă comanda nu a fost găsită, instalați Homebrew urmând instrucțiunile de pe site-ul oficial Homebrew. Programul de instalare instalează și Xcode Command Line Tools, dacă acestea nu sunt deja prezente.

Pasul 3: Adăugați Homebrew în PATH¶

Pe Apple Silicon, programul de instalare afișează două comenzi pentru a adăuga Homebrew în mediul shell-ului. Rulați-le conform instrucțiunilor, apoi confirmați:

brew --prefix

Ar trebui să se afișeze /opt/homebrew pe Apple Silicon sau /usr/local pe Intel.

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.

Opțiuni de instalare¶

macOS oferă două moduri simple de a instala PostgreSQL. Alegeți unul:

• Homebrew — instalare din linia de comandă, recomandată pentru implementările pe server
• Postgres.app — instalare grafică, comodă pentru evaluarea locală

Instalarea PostgreSQL cu Homebrew¶

Pasul 1: Instalați formula PostgreSQL¶

brew install postgresql@16

Pasul 2: Adăugați PostgreSQL în PATH¶

Formulele PostgreSQL cu versiune sunt keg-only, ceea ce înseamnă că Homebrew nu leagă automat comenzile lor în PATH. Adăugați-le dumneavoastră:

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

Pasul 3: Porniți serviciul PostgreSQL¶

brew services start postgresql@16

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

Pasul 4: Verificați instalarea¶

psql --version

Dacă instalarea a reușit, ar trebui să vedeți versiunea PostgreSQL.

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

psql postgres

Pasul 6: Confirmați portul¶

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

psql postgres -c "SHOW port;"

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

Instalarea PostgreSQL cu Postgres.app¶

Dacă preferați o instalare grafică:

1. Descărcați Postgres.app și trageți-o în folderul Applications
2. Deschideți aplicația și faceți clic pe Initialize pentru a crea un server nou
3. Urmați instrucțiunile aplicației pentru a adăuga instrumentele sale de linie de comandă în PATH
4. Verificați instalarea:

psql --version

Și Postgres.app creează un superutilizator denumit după contul dumneavoastră macOS.

Configurarea web serverului¶

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

• nginx — instalat prin Homebrew, recomandat
• Apache httpd — inclus în macOS

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¶

brew install nginx

Pornirea nginx¶

brew services start nginx

Verificați instalarea¶

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

Configurarea unui site pentru dashboard¶

Configurația nginx din Homebrew include fiecare fișier din directorul său servers. Creați acolo un fișier de configurare dedicat pentru digna:

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

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

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

Aplicați configurația¶

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

nginx -t
brew services restart nginx

Configurarea Apache httpd¶

Prezentare generală¶

macOS include Apache httpd, așa că nu este necesară nicio instalare. Este dezactivat implicit.

Pornirea Apache¶

sudo apachectl start

Verificați instalarea¶

1. Deschideți browserul
2. Accesați http://localhost
3. Ar trebui să vedeți mesajul "It works!"

Obligatoriu: activați mod_rewrite¶

Dashboard-ul necesită rescrierea URL-urilor. Deschideți configurația Apache:

sudo nano /etc/apache2/httpd.conf

Găsiți linia următoare și eliminați # de la început pentru a o decomenta:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Obligatoriu: permiteți suprascrierile .htaccess¶

În același fișier, găsiți blocul <Directory "/Library/WebServer/Documents"> și modificați:

AllowOverride None

în:

AllowOverride All

Obligatoriu: tipul MIME pentru fișierele Markdown¶

Tot în httpd.conf, 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 apachectl restart

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 Terminal într-un singur pas:

psql postgres

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 sau ~/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 Terminal:

unzip digna-2026.06-macos.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
chmod +x digna

Dacă macOS blochează aplicația¶

Fișierele descărcate printr-un browser sau un client de e-mail sunt marcate cu un atribut de carantină. Dacă macOS raportează că aplicația "nu poate fi deschisă deoarece dezvoltatorul nu poate fi verificat", eliminați atributul din directorul de instalare:

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

Alternativ, deschideți System Settings → Privacy & Security, găsiți elementul blocat în partea de jos a paginii și faceți clic pe Open Anyway.

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
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ă setările aplicației backend digna:

[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 = ["*"]

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

Secțiunea [base]¶

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

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

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_BACKUP_COUNT = 10

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

Overall: OK

Corectați tot ce este raportat ca FAILED și rulați comanda din nou înainte de a continua. Lista completă a opțiunilor se află în referința CLI.

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

1. Deschideți 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

Ar trebui să vedeți o confirmare că conexiunea este stabilită (repository-ul în sine nu a fost încă inițializat).

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

Pasul 4: Instalați schema repository-ului¶

În același director, rulați:

./digna repo install

Această comandă instalează tabelele și schema necesare în baza de date PostgreSQL.

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 - --port — portul serverului

Ar trebui să vedeți mesajele de pornire care confirmă că serverul rulează:

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

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 $(brew --prefix)/etc/nginx/servers/digna.conf

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

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

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

5. Reîncărcați nginx

   nginx -t
   brew services restart nginx
   

6. Testați instalarea

7. Deschideți browserul
8. Accesați http://localhost:8080 (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 /Library/WebServer/Documents/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 /Library/WebServer/Documents/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 apachectl restart
   

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

Rularea digna ca serviciu în fundal¶

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

Rularea backend-ului digna ca serviciu în fundal asigură că acesta:

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

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 launchd
• 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
chmod +x *.sh

Instalarea serviciului¶

1. Deschideți 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 launchd, 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 Terminal
2. Accesați /opt/digna/bin
3. Rulați:

   sudo ./start_service.sh
   

Pentru a opri serviciul¶

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

   sudo ./stop_service.sh
   

Verificarea serviciului¶

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

sudo launchctl list | grep digna

O linie care începe cu un ID de proces indică faptul că serviciul rulează. Un - în prima coloană înseamnă că este înregistrat, dar oprit.

Mutarea serviciului într-un director nou¶

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

Actualizarea la o versiune nouă¶

Înainte de actualizare¶

Verificați mai întâi toate conexiunile la baze de date

Începând cu Release 2026.06, digna accesează fiecare tehnologie sursă prin ODBC. Versiunile anterioare ofereau alegerea între un driver specific fiecărei tehnologii și ODBC, selectată prin comutatorul Use ODBC. Echipa digna a decis să se bazeze exclusiv pe ODBC, deoarece o singură interfață standard vă oferă mai mult decât un set de drivere făcute la comandă:

• Autentificare — autentificarea face parte din ODBC, așa că o conexiune poate folosi tot ce acceptă driverul său: parole, token-uri și PAT-uri, Kerberos și Active Directory, MFA și autentificare unică din browser, identități în cloud, certificate de client și TLS. Metodele noi vin odată cu o actualizare a driverului, fără a aștepta o versiune digna.
• Drivere întreținute de producătorii bazelor de date — driverul propriu al producătorului urmărește noile versiuni de server și corecțiile de securitate, iar dumneavoastră îl puteți actualiza după propriul calendar, independent de digna.
• Un singur mod de a configura totul — fiecare tehnologie este o listă de proprietăți cheie/valoare, cu aceeași interfață, aceeași criptare a valorilor sensibile și aceeași depanare, în locul unui set diferit de câmpuri pentru fiecare sursă.
• Reglare și acoperire — opțiunile driverului, precum timpii de expirare, setările TLS, proxy-urile și dimensiunile de citire, sunt disponibile pentru fiecare sursă, iar orice tehnologie cu un driver ODBC conform poate fi conectată, inclusiv cele pentru care digna nu publică un ghid dedicat.

În practică, aceasta înseamnă că comutatorul Use ODBC și câmpurile separate pentru gazdă, port, bază de date, utilizator și parolă nu mai există. Fiecare conexiune care nu folosește deja ODBC trebuie trecută pe ODBC — nu există conversie automată, așa că planificați acest lucru înainte de actualizare:

1. Parcurgeți fiecare conexiune la baze de date definită în instalarea dumneavoastră și notați-le pe cele care nu folosesc încă ODBC — fiecare dintre ele va trebui reconfigurată.
2. Instalați driverul ODBC corespunzător pe gazda digna — conexiunile sunt deschise de pe serverul care rulează backend-ul digna, nu din browser. Consultați Instalarea driverului ODBC pe gazda digna.
3. Pregătiți proprietățile ODBC pentru fiecare conexiune afectată. Ghidurile pe tehnologii prezintă, pentru fiecare sursă, un set de proprietăți verificat.

După actualizare, treceți fiecare conexiune afectată pe ODBC și testați-o din dashboard — consultați Crearea unei conexiuni la baza de date și Testarea unei conexiuni.

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

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

Procesul de actualizare¶

Pasul 1: Opriți serviciul digna¶

Dacă digna rulează ca serviciu în fundal, 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 Terminal.

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

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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, dacă este necesar, eliminați atributul de carantină:

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

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

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'

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 (Cmd+Shift+R).

Pasul 6: Validați configurația¶

Confirmați că config.toml actualizat 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 și rulați comanda din nou înainte de a continua.

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

Fiecare versiune este licențiată separat. Copiați fișierul license.toml furnizat de echipa digna pentru această versiune în directorul de instalare, înlocuindu-l pe cel vechi:

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

./digna license check

Pasul 8: Actualizați schema repository-ului¶

Accesați directorul de instalare digna și rulați:

cd /opt/digna
./digna repo upgrade

Aceasta actualizează schema PostgreSQL la cea mai recentă versiune, păstrând toate datele existente.

Pasul 9: Reporniți serviciile¶

Dacă rulați ca serviciu în fundal:

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, reporniți web serverul respectiv:

brew services restart nginx

sudo apachectl restart

Pasul 10: Verificați actualizarea¶

1. Accesați dashboard-ul digna
2. Verificați că interfața se încarcă corect
3. Verificați logurile serverului pentru eventuale erori
4. Treceți pe ODBC fiecare conexiune care nu îl folosea încă, apoi testați toate conexiunile — consultați Testarea unei conexiuni