Οδηγός Εγκατάστασης Linux για την digna Έκδοση 2026.11¶

Έκδοση: 2026.11

Τελευταία ενημέρωση: 7 Νοεμβρίου 2026

Περιεχόμενα¶

1. Εισαγωγή
2. Απαιτήσεις Συστήματος
3. Προεγκατάσταση
4. Ρύθμιση PostgreSQL Server
5. Ρύθμιση Web Server
6. Αρχική Εγκατάσταση
7. Διαμόρφωση Backend
8. Διαμόρφωση Dashboard
9. Εκτέλεση digna ως υπηρεσία systemd
10. Αναβάθμιση σε Νέα Έκδοση

Εισαγωγή¶

Σχετικά με την digna¶

digna είναι μια ολοκληρωμένη πλατφόρμα με AI, σχεδιασμένη για την βελτιστοποίηση της διαχείρισης ποιότητας δεδομένων σε διάφορα περιβάλλοντα δεδομένων όπως warehouses, lakes και lakehouses. Χτισμένη για να είναι ιδιαίτερα επεκτάσιμη και προσαρμόσιμη, η digna αντιμετωπίζει σύγχρονα προβλήματα δεδομένων μέσω αυτοματισμού, παρακολούθησης σε πραγματικό χρόνο και ανίχνευσης ανωμαλιών.

Η digna αποτελείται από δύο κύρια συστατικά:

• digna: ο πυρήνας της εφαρμογής, υπεύθυνος για την επεξεργασία δεδομένων και την εκτέλεση ελέγχων ποιότητας. Ενοποιεί το backend και τη διεπαφή γραμμής εντολών σε ένα μόνο εκτελέσιμο αρχείο, αντικαθιστώντας τα ξεχωριστά προγράμματα dignabackend και dignacli των προηγούμενων εκδόσεων.
• dignadashboard: Διεπαφή web που φιλοξενείται σε web server και παρέχει φιλικό περιβάλλον για αλληλεπίδραση με την πλατφόρμα digna και οπτικοποίηση μετρήσεων ποιότητας δεδομένων.

Τι νέο φέρνει η Έκδοση 2026.11¶

Αυτή η έκδοση προσθέτει το digna Data Reconciliation, το digna Agentic με τον digna MCP Server και το digna Engine, το οποίο μπορεί να κάνει profiling δεδομένων μέσα στο digna και να ελέγχει την ακεραιότητα αναφορών μεταξύ διαφορετικών τεχνολογιών βάσεων δεδομένων. Δείτε τις σημειώσεις έκδοσης για πλήρεις λεπτομέρειες.

Για μια εγκατάσταση, η έκδοση φέρνει έναν νέο μηχανισμό migrations για το repository, μια προαιρετική ενότητα [duckdb] στο config.toml για το digna Engine και ένα νέο αρχείο άδειας. Η ενότητα αναβάθμισης καλύπτει καθένα από αυτά.

Ψάχνετε για Windows ή macOS;¶

Αυτός ο οδηγός καλύπτει Linux. Για άλλες πλατφόρμες, δείτε τον Οδηγό Εγκατάστασης για Windows ή τον Οδηγό Εγκατάστασης για macOS.

Σε ποιες διανομές αναφέρεται αυτός ο οδηγός;¶

Οι οδηγίες είναι γραμμένες για τις δύο πιο κοινές οικογένειες server. Όπου διαφέρουν, παρέχονται και οι δύο εντολές:

• Οικογένεια Debian — Debian, Ubuntu. Διαχειριστής πακέτων: apt.
• Οικογένεια RHEL — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Διαχειριστής πακέτων: dnf.

Οποιαδήποτε σύγχρονη διανομή με systemd θα λειτουργήσει· μόνο τα ονόματα πακέτων και μερικές διαδρομές διαμόρφωσης αλλάζουν.

Απαιτήσεις Συστήματος¶

Πριν ξεκινήσετε την εγκατάσταση, βεβαιωθείτε ότι το σύστημά σας πληροί τις ακόλουθες ελάχιστες απαιτήσεις:

Επιλογές Εγκατάστασης Βάσης Δεδομένων¶

Εάν το PostgreSQL είναι ήδη εγκατεστημένο: Μπορείτε να προσθέσετε μια νέα βάση δεδομένων για την digna στον υπάρχοντα PostgreSQL Server σας.

Εάν εγκαθιστάτε το PostgreSQL στον ίδιο μηχάνημα με την digna:

Έλεγχος Διανομής και Αρχιτεκτονικής¶

Πολλές εντολές σε αυτόν τον οδηγό διαφέρουν μεταξύ των οικογενειών Debian και RHEL. Για να ελέγξετε σε ποια είστε, εκτελέστε:

cat /etc/os-release
uname -m

• ID=ubuntu ή ID=debian — χρησιμοποιήστε τις εντολές apt.
• ID=rhel, rocky, almalinux ή fedora — χρησιμοποιήστε τις εντολές dnf.
• x86_64 ή aarch64 — η αρχιτεκτονική του πακέτου εγκατάστασης που χρειάζεστε.

Προεγκατάσταση¶

Πριν εγκαταστήσετε την digna, βεβαιωθείτε ότι δύο βασικές προϋποθέσεις είναι σε ισχύ:

1. PostgreSQL Server – για αποθήκευση υπολογισμένων μετρικών και δεδομένων απόδοσης
2. Web Server – για τη φιλοξενία του digna Dashboard

Εάν αυτά τα στοιχεία δεν είναι ήδη ρυθμισμένα, ακολουθήστε τις παρακάτω ενότητες για να τα εγκαταστήσετε και να τα διαμορφώσετε.

Ανανέωση του Ευρετηρίου Πακέτων¶

Ενημερώστε τις λίστες πακέτων πριν εγκαταστήσετε οτιδήποτε:

sudo apt update

sudo dnf check-update

Ρύθμιση PostgreSQL Server¶

Εάν Έχετε Ήδη το PostgreSQL¶

Εάν το PostgreSQL είναι ήδη εγκατεστημένο και ενεργοποιημένο στον τοπικό σας υπολογιστή ή αν χρησιμοποιείτε έναν διαχειριζόμενο απομακρυσμένο PostgreSQL server, μπορείτε να προχωρήσετε στην επόμενη ενότητα.

Εγκατάσταση PostgreSQL¶

Βήμα 1: Εγκαταστήστε το Πακέτο Server¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Βήμα 2: Αρχικοποίηση του Database Cluster¶

Στην οικογένεια Debian, το πακέτο δημιουργεί και ξεκινάει αυτόματα ένα cluster — παραλείψτε αυτό το βήμα.

Στην οικογένεια RHEL, το cluster πρέπει να δημιουργηθεί ρητά:

sudo postgresql-setup --initdb

Βήμα 3: Εκκίνηση και Ενεργοποίηση της Υπηρεσίας¶

sudo systemctl enable --now postgresql

Αυτό ξεκινάει αμέσως την PostgreSQL και την ρυθμίζει να ξεκινάει αυτόματα κατά την εκκίνηση.

Βήμα 4: Επαλήθευση της Εγκατάστασης¶

psql --version
sudo systemctl status postgresql

Θα πρέπει να δείτε την έκδοση του PostgreSQL και την υπηρεσία ως active (running).

Βήμα 5: Σύνδεση στον Server¶

Ένα πακέτο PostgreSQL για Linux δημιουργεί έναν system λογαριασμό postgres που κατέχει το cluster. Συνδεθείτε μέσω αυτού:

sudo -u postgres psql

Βήμα 6: Επιβεβαίωση Θύρας¶

Η προεπιλεγμένη θύρα PostgreSQL είναι 5432. Για να επιβεβαιώσετε σε ποια θύρα ακούει ο server σας:

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

Σημειώστε την τιμή — θα τη χρειαστείτε κατά τη ρύθμιση του backend της digna.

Βήμα 7: Ενεργοποίηση Επαλήθευσης με Κωδικό για τον Χρήστη digna¶

Η digna συνδέεται με την PostgreSQL μέσω TCP ως digna_user, το οποίο απαιτεί έλεγχο ταυτότητας με κωδικό και όχι peer authentication. Ελέγξτε ότι το pg_hba.conf το επιτρέπει.

Εντοπίστε το αρχείο:

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

Ανοίξτε το σε έναν επεξεργαστή και επιβεβαιώστε ότι οι γραμμές για το τοπικό TCP χρησιμοποιούν scram-sha-256 (ή md5 σε παλαιότερους servers) αντί για 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

Επαναφορτώστε την PostgreSQL μετά από οποιαδήποτε αλλαγή:

sudo systemctl reload postgresql

Βήμα 8: Εάν η PostgreSQL Τρέχει σε Άλλο Μηχάνημα¶

Για να δεχτεί συνδέσεις από διαφορετικό host, ορίστε το listen_addresses στο postgresql.conf και προσθέστε μια αντίστοιχη γραμμή host για το δίκτυό σας στο pg_hba.conf:

listen_addresses = '*'

Έπειτα ανοίξτε τη θύρα στο firewall και επανεκκινήστε την υπηρεσία:

sudo ufw allow 5432/tcp

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

sudo systemctl restart postgresql

Ρύθμιση Web Server¶

Η digna χρειάζεται web server για να φιλοξενήσει το dashboard. Επιλέξτε μία από τις παρακάτω επιλογές:

• nginx — ελαφρύ και συνιστώμενο
• Apache httpd — ευρέως διαδεδομένη εναλλακτική

Χρειάζεται να εγκαταστήσετε και να διαμορφώσετε έναν μόνο από αυτούς τους servers.

Και οι δύο ενότητες διαμορφώνουν δύο πράγματα που εξαρτάται το dashboard:

• Single-page-application fallback, ώστε το ανανέωμα ενός URL του dashboard να μην επιστρέφει 404
• Τύπος MIME για .md, ώστε τα αρχεία Markdown να σερβίρονται σωστά

Ρύθμιση nginx¶

Επισκόπηση¶

Το nginx είναι ένας ελαφρύς, υψηλών επιδόσεων web server κατάλληλος για την παροχή του στατικού digna dashboard.

Εγκατάσταση¶

sudo apt install -y nginx

sudo dnf install -y nginx

Εκκίνηση του nginx¶

sudo systemctl enable --now nginx

Επαλήθευση της Εγκατάστασης¶

1. Ανοίξτε τον browser σας
2. Πλοηγηθείτε στο http://localhost
3. Θα πρέπει να δείτε τη σελίδα καλωσορίσματος του nginx

Άνοιγμα Firewall¶

Εάν ο server προσεγγίζεται από άλλες μηχανές, επιτρέψτε την κίνηση HTTP:

sudo ufw allow 'Nginx Full'

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

Διαμόρφωση Site για το Dashboard¶

Το nginx περιλαμβάνει κάθε αρχείο στον κατάλογο conf.d και στις δύο οικογένειες διανομών. Δημιουργήστε ένα ξεχωριστό αρχείο διαμόρφωσης για την digna εκεί:

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

Επικολλήστε τα παρακάτω, αντικαθιστώντας το /opt/digna/dashboard με την πραγματική διαδρομή στο εξαγόμενο φάκελο dashboard:

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

Απενεργοποίηση της Προεπιλεγμένης Τοποθεσίας¶

Μόνο ένα server block μπορεί να είναι το default_server για μια θύρα. Στην οικογένεια Debian, αφαιρέστε την πακεταρισμένη προεπιλογή ώστε να μην υπάρχει σύγκρουση:

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

Στην οικογένεια RHEL, σχολιάστε ή διαγράψτε το block server { ... } μέσα στο /etc/nginx/nginx.conf.

Εφαρμογή της Διαμόρφωσης¶

Δοκιμάστε τη σύνταξη της διαμόρφωσης και μετά επαναφορτώστε το nginx:

sudo nginx -t
sudo systemctl reload nginx

Ρύθμιση Apache httpd¶

Επισκόπηση¶

Το Apache httpd είναι διαθέσιμο στα προεπιλεγμένα repositories όλων των υποστηριζόμενων διανομών. Το πακέτο ονομάζεται apache2 στην οικογένεια Debian και httpd στην οικογένεια RHEL.

Εγκατάσταση¶

sudo apt install -y apache2

sudo dnf install -y httpd

Εκκίνηση του Apache¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Επαλήθευση της Εγκατάστασης¶

1. Ανοίξτε τον browser σας
2. Πλοηγηθείτε στο http://localhost
3. Θα πρέπει να δείτε την προεπιλεγμένη σελίδα του Apache της διανομής

Απαιτείται: Ενεργοποίηση mod_rewrite¶

Το dashboard απαιτεί URL rewriting.

Στην οικογένεια Debian, ενεργοποιήστε το module και επανεκκινήστε:

sudo a2enmod rewrite
sudo systemctl restart apache2

Στην οικογένεια RHEL, το mod_rewrite φορτώνεται από προεπιλογή. Επιβεβαιώστε το:

httpd -M | grep rewrite

Απαιτείται: Επιτρέψτε .htaccess Overrides¶

Ανοίξτε το αρχείο διαμόρφωσης για το document root σας:

sudo nano /etc/apache2/apache2.conf

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

Εντοπίστε το block <Directory> που καλύπτει το document root (/var/www/html και στις δύο οικογένειες) και αλλάξτε:

AllowOverride None

σε:

AllowOverride All

Απαιτείται: MIME Type για Αρχεία Markdown¶

Στο ίδιο αρχείο, προσθέστε την παρακάτω γραμμή ώστε τα αρχεία Markdown να σερβίρονται σωστά:

AddType text/markdown .md

Εφαρμογή της Διαμόρφωσης¶

Ελέγξτε τη σύνταξη της διαμόρφωσης και μετά επανεκκινήστε τον Apache:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

Αρχική Εγκατάσταση¶

Βήμα 1: Ρύθμιση του Repository της digna¶

Το repository της digna αποθηκεύει όλες τις μετρικές που υπολογίζει η digna. Λειτουργεί ως η κεντρική βάση δεδομένων για αναλυτικά και δεδομένα απόδοσης.

Δημιουργία Σχήματος Repository και Χρήστη¶

Ανοίξτε τον PostgreSQL client σας (psql, pgAdmin ή παρόμοιο) και εκτελέστε τις ακόλουθες εντολές 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>;

Αντικαταστήστε τα παρακάτω placeholders:

• <digna_repo_schema> — Το επιθυμητό όνομα του schema (π.χ., dignarepo)
• <digna_repo_user> — Το επιθυμητό όνομα χρήστη (π.χ., digna_user)
• <digna_repo_password> — Ένας ασφαλής κωδικός για αυτόν τον χρήστη

Παράδειγμα:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Για να τρέξετε αυτά από το shell σε ένα βήμα:

sudo -u postgres psql

Έπειτα επικολλήστε τις δηλώσεις στο postgres=# prompt και πληκτρολογήστε \q για έξοδο.

Βήμα 2: Αποσυμπίεση του Πακέτου Εγκατάστασης digna¶

1. Εντοπίστε το αρχείο ZIP εγκατάστασης digna που σας έχει παρασχεθεί
2. Αποσυμπιέστε το στον επιθυμητό κατάλογο εγκατάστασης — για παράδειγμα /opt/digna
3. Μετά την αποσυμπίεση, θα πρέπει να δείτε τα παρακάτω αντικείμενα:
4. dashboard/ — Διεπαφή web dashboard
5. digna — Κύριο εκτελέσιμο (backend + CLI σε ένα)

Για να αποσυμπιέσετε από το shell:

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

Κάντε το Εκτελέσιμο Να Είναι Ενεργό¶

Ανάλογα με τον τρόπο μεταφοράς του αρχείου, το bit εκτέλεσης μπορεί να μην έχει διατηρηθεί. Ορίστε το ρητά:

cd /opt/digna
sudo chmod +x digna

Δημιουργία Λογαριασμού Υπηρεσίας¶

Συνιστάται να τρέχετε το backend με έναν αφιερωμένο μη προνομιούχο χρήστη για παραγωγικές εγκαταστάσεις:

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

Βήμα 3: Εγκατάσταση του Αρχείου Άδειας¶

1. Εντοπίστε το αρχείο license.toml που σας έχει παρασχεθεί
2. Αντιγράψτε το στον ριζικό κατάλογο εγκατάστασης της digna (όπου βρίσκεται το config.toml και το εκτελέσιμο digna)

Γιατί έχει σημασία: Το αρχείο άδειας περιέχει τις πληροφορίες πελάτη σας, ημερομηνία λήξης άδειας και ψηφιακή υπογραφή. Μην τροποποιείτε αυτό το αρχείο — οποιαδήποτε αλλαγή θα το ακυρώσει.

Δομή καταλόγου μετά τη ρύθμιση:

/opt/digna/
├── config.toml         (αρχείο διαμόρφωσης)
├── license.toml        (ΤΟ ΑΡΧΕΙΟ ΑΔΕΙΑΣ ΣΑΣ - αντιγράψτε εδώ)
├── digna               (κύριο εκτελέσιμο)
├── bin/                (scripts διαχείρισης υπηρεσίας)
└── dashboard/          (διεπαφή web)
    └── (αρχεία dashboard)

Διαμόρφωση Backend¶

Βήμα 1: Δημιουργία και Επεξεργασία του Αρχείου Διαμόρφωσης¶

Το αρχείο config_template.toml παρέχεται στον κατάλογο εγκατάστασης της digna. Απλά μετονομάστε το σε config.toml.

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

Τοποθεσία: /opt/digna/config.toml

Ανοίξτε το config.toml σε έναν επεξεργαστή κειμένου και ρυθμίστε κάθε ενότητα παρακάτω.

Ενότητα [app]¶

Αυτή η ενότητα διαμορφώνει την κοινή χρήση πόρων μεταξύ διαφορετικών origins (CORS) ανάμεσα στο dashboard και το backend:

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

Ενότητα [repo]¶

Αυτή η ενότητα διαμορφώνει τη σύνδεση με τη βάση 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

Ενότητα [base]¶

Αυτή η ενότητα περιέχει ρυθμίσεις ασφάλειας, cookies και επιθεωρήσεων:

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

Αυτή η ενότητα περιέχει το κλειδί που χρησιμοποιείται για την κρυπτογράφηση ευαίσθητων τιμών που αποθηκεύονται στο repository. Είναι υποχρεωτική — το config check αναφέρει την ενότητα [encryption] ως FAILED αν λείπει το κλειδί.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Ενότητα [logging]¶

Αυτή η ενότητα διαμορφώνει τη συμπεριφορά logging:

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

Ενότητα [duckdb] (Προαιρετική)¶

Νέο στην Έκδοση 2026.11. Αυτή η ενότητα ορίζει τους πόρους του digna Engine, το οποίο κάνει profiling δεδομένων μέσα στο digna για συνδέσεις βάσεων δεδομένων με τοποθεσία profiling digna Engine, και εκτελεί ελέγχους ακεραιότητας αναφορών μεταξύ πηγών δεδομένων σε διαφορετικές συνδέσεις βάσεων δεδομένων. Δείτε Τοποθεσία Profiling.

Η ενότητα είναι προαιρετική. Χωρίς αυτήν ισχύουν οι παρακάτω προεπιλογές.

[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

Βήμα 2: Επικυρώστε τη διαμόρφωση¶

Πριν αρχικοποιήσετε το repository, ελέγξτε ότι το config.toml είναι πλήρες και σωστά δομημένο. Στον κατάλογο εγκατάστασης digna εκτελέστε:

./digna config check

Κάθε ενότητα επικυρώνεται ξεχωριστά, ώστε ένα μεμονωμένο σφάλμα να μην κρύβει την κατάσταση των υπολοίπων:

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

Διορθώστε ό,τι αναφέρεται ως FAILED και εκτελέστε ξανά την εντολή πριν συνεχίσετε. Ένα WARNING κάτω από το Unknown keys παραθέτει κλειδιά του config.toml που το digna δεν διαβάζει· δεν έχουν καμία επίδραση, οπότε αφαιρέστε τα ή διορθώστε τη γραφή τους. Ο πλήρης κατάλογος επιλογών βρίσκεται στην αναφορά CLI.

Βήμα 3: Αρχικοποίηση του Repository¶

1. Ανοίξτε ένα τερματικό
2. Πλοηγηθείτε στον κατάλογο εγκατάστασης της digna (όπου βρίσκονται το config.toml και το εκτελέσιμο digna)
3. Τρέξτε το τεστ σύνδεσης:

cd /opt/digna
./digna repo check

Σε ένα νέο schema, η εντολή συνδέεται και στη συνέχεια αναφέρει ότι δεν έχει εγκατασταθεί ακόμη repository:

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

Σε αυτό το σημείο αυτό είναι το αναμενόμενο αποτέλεσμα: επιβεβαιώνει ότι το digna φτάνει στο PostgreSQL και στο schema. Ένα σφάλμα σύνδεσης ή ελέγχου ταυτότητας, αντίθετα, παραπέμπει στην ενότητα [repo] ή στη ρύθμιση του PostgreSQL.

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

Βήμα 4: Εγκατάσταση του Σχήματος Repository¶

Στον ίδιο κατάλογο, τρέξτε:

./digna repo upgrade

Αυτή η εντολή εγκαθιστά τους απαραίτητους πίνακες στο schema του repository και ολοκληρώνεται με:

✅ Repo schema 'dignarepo' is up to date.

Βήμα 5: Δημιουργία Διαχειριστή (Admin)¶

Ο χρήστης διαχειριστή δημιουργείται απευθείας στο schema του repository, οπότε ο server δεν χρειάζεται ακόμη να εκτελείται. Στον κατάλογο εγκατάστασης της digna, εκτελέστε:

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

Παράδειγμα:

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

Αυτό δημιουργεί έναν χρήστη με τη διεύθυνση ηλεκτρονικού ταχυδρομείου admin@example.com και πλήρη δικαιώματα διαχειριστή.

Βήμα 6: Εκκίνηση του digna Server¶

Στον κατάλογο εγκατάστασης της digna, ξεκινήστε τον server με:

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

Παράμετροι: - --address — Hostname/IP του server (προεπιλογή 127.0.0.1) - --port — Θύρα του server (προεπιλογή 8000)

Όταν ο server είναι σε λειτουργία, εμφανίζει τη διεύθυνση στην οποία ακούει:

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

Διαμόρφωση Dashboard¶

Βήμα 1: Ανάπτυξη του Dashboard στον Web Server¶

Το digna dashboard διαβάζει τη δική του διαμόρφωση από το dashboard/dashboard_config.toml. Το αρχείο αυτό δεν παρέχεται με την εγκατάσταση — το δημιουργείτε στον κατάλογο dashboard/, δίπλα στα αρχεία του dashboard.

Το περιεχόμενό του περιγράφεται στην ενότητα Ενιαία Σύνδεση (SSO), όπου και χρειάζεται το αρχείο: περιέχει τις επιλογές σύνδεσης που προσφέρει το dashboard και, για αναπτύξεις πολλαπλών instances, τη σύνδεση με το backend.

Επιλέξτε τον web server σας και ακολουθήστε τα αντίστοιχα βήματα ανάπτυξης.

Ανάπτυξη σε nginx¶

Εάν ακολουθήσατε την ενότητα Ρύθμισης nginx, το server block ήδη δείχνει στον φάκελο dashboard και δεν απαιτείται αντιγραφή.

1. Επιβεβαιώστε τη διαδρομή
2. Ανοίξτε /etc/nginx/conf.d/digna.conf

3. Επαληθεύστε ότι το root δείχνει στον εξαγόμενο φάκελο dashboard

4. Βεβαιωθείτε ότι ο φάκελος είναι αναγνώσιμος

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

5. Επαναφόρτωση nginx

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Δοκιμή της Εγκατάστασης

7. Ανοίξτε τον browser σας
8. Πλοηγηθείτε στο http://localhost (ή στο ρυθμισμένο URL)
9. Θα πρέπει να δείτε τη σελίδα εισόδου του digna dashboard

Ανάπτυξη σε Apache httpd¶

1. Αντιγράψτε το Dashboard στο Document Root

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

2. Προσθέστε τους Κανόνες Rewrite

Δημιουργήστε ένα αρχείο .htaccess μέσα στον εγκατεστημένο φάκελο ώστε οι διαδρομές του dashboard να επιβιώνουν στο ανανέωμα του browser:

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

Επικολλήστε τα παρακάτω:

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. Επανεκκινήστε τον Apache

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Πρόσβαση στο Dashboard

3. Ανοίξτε τον browser σας
4. Πλοηγηθείτε στο http://localhost/digna
5. Θα πρέπει να δείτε τη σελίδα εισόδου του digna dashboard

Βήμα 2: SELinux (μόνο για RHEL Family)¶

Στο RHEL, Rocky, AlmaLinux και Fedora, το SELinux είναι στο Enforcing από προεπιλογή και θα εμποδίσει τον web server από το να διαβάζει αρχεία εκτός των αναμενόμενων τοποθεσιών. Ελέγξτε εάν είναι ενεργό:

getenforce

Εάν το αποτέλεσμα είναι Enforcing και σερβίρετε το dashboard από /opt/digna/dashboard, επισημάνετε τον κατάλογο ώστε ο web server να μπορεί να τον διαβάσει:

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

Εκτέλεση digna ως υπηρεσία systemd¶

Γιατί να τρέξετε την digna ως υπηρεσία;¶

Η εκτέλεση του backend της digna ως υπηρεσία systemd διασφαλίζει ότι:

• Ξεκινά αυτόματα κατά την εκκίνηση του μηχανήματος
• Τρέχει στο παρασκήνιο χωρίς ανοιχτό παράθυρο τερματικού
• Επανεκκινά αυτόματα αν καταρρεύσει
• Μπορεί να διαχειριστεί μέσω του systemctl, του τυπικού διαχειριστή υπηρεσιών του Linux

Αρχεία Διαχείρισης Υπηρεσίας¶

Όλα τα απαραίτητα αρχεία βρίσκονται στον κατάλογο εγκατάστασης της digna κάτω από: bin/

Τα ακόλουθα shell scripts είναι διαθέσιμα:

• install_service.sh — Εγγράφει την digna στο systemd
• uninstall_service.sh — Αφαιρεί την εγγραφή της υπηρεσίας
• start_service.sh — Ξεκινά την εγγεγραμμένη υπηρεσία
• stop_service.sh — Σταματά την τρέχουσα υπηρεσία

Κάντε τα Scripts Εκτελέσιμα¶

Η αποσυμπίεση μπορεί να μην έχει διατηρήσει το executable bit. Πριν την πρώτη χρήση:

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

Εγκατάσταση της Υπηρεσίας¶

1. Ανοίξτε ένα τερματικό

2. Πλοηγηθείτε στον φάκελο bin

   cd /opt/digna/bin
   

3. Τρέξτε το script εγκατάστασης

   sudo ./install_service.sh
   

Η digna server έχει τώρα εγγραφεί στο systemd με αυτόματη εκκίνηση ενεργοποιημένη. Η υπηρεσία δεν ξεκινά αμέσως — δείτε την επόμενη ενότητα για να την ξεκινήσετε.

Εκκίνηση και Στάση της Υπηρεσίας¶

Για να ξεκινήσετε την υπηρεσία¶

1. Ανοίξτε ένα τερματικό
2. Πλοηγηθείτε στο /opt/digna/bin
3. Εκτελέστε:

   sudo ./start_service.sh
   

Για να σταματήσετε την υπηρεσία¶

1. Ανοίξτε ένα τερματικό
2. Πλοηγηθείτε στο /opt/digna/bin
3. Εκτελέστε:

   sudo ./stop_service.sh
   

Διαχείριση της Υπηρεσίας με systemctl¶

Μόλις εγγραφεί, η υπηρεσία μπορεί επίσης να ελεγχθεί με τις τυπικές εντολές systemd από οποιονδήποτε κατάλογο:

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

Επιβεβαίωση της Υπηρεσίας¶

Για να επιβεβαιώσετε ότι η υπηρεσία είναι εγγεγραμμένη και τρέχει:

systemctl is-enabled digna
systemctl is-active digna

enabled σημαίνει ότι η υπηρεσία ξεκινάει κατά την εκκίνηση· active σημαίνει ότι τρέχει τώρα.

Προβολή των Logs της Υπηρεσίας¶

Το systemd καταγράφει ό,τι γράφει το backend στην κονσόλα. Για να το διαβάσετε:

sudo journalctl -u digna -n 100

Για να ακολουθήσετε το log ζωντανά ενώ αναπαράγετε ένα πρόβλημα:

sudo journalctl -u digna -f

Μετακίνηση της Υπηρεσίας σε Νέο Κατάλογο¶

Το unit αρχείο αποθηκεύει την απόλυτη διαδρομή προς το εκτελέσιμο, οπότε η μετακίνηση της εγκατάστασης απαιτεί επανεγγραφή της υπηρεσίας:

1. Απεγκαταστήστε την τρέχουσα υπηρεσία

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

2. Μετακινήστε τα αρχεία της εφαρμογής

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

3. Εγκαταστήστε ξανά την υπηρεσία

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

4. Ξεκινήστε την υπηρεσία

   sudo ./start_service.sh
   

Απεγκατάσταση της Υπηρεσίας¶

1. Σταματήστε την τρέχουσα υπηρεσία

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

2. Απεγκαταστήστε την υπηρεσία

   sudo ./uninstall_service.sh
   

Η digna server έχει πλέον αφαιρεθεί από το systemd.

Αναβάθμιση σε Νέα Έκδοση¶

Αυτή η ενότητα αναβαθμίζει μια εγκατάσταση της Έκδοσης 2026.06 στην Έκδοση 2026.11. Αν η εγκατάστασή σας είναι παλαιότερη, διαβάστε πρώτα την ενότητα Αναβάθμιση από Έκδοση Πριν από την 2026.06.

Πριν την Αναβάθμιση¶

Η δημιουργία αντιγράφου ασφαλείας (backup) του digna Repository είναι υποχρεωτική

Πριν αναβαθμίσετε την digna, δημιουργήστε backup του repository σας (PostgreSQL) για προστασία από απώλεια δεδομένων. Ένα backup εξασφαλίζει ότι μπορείτε να ανακτήσετε σε περίπτωση απρόβλεπτων προβλημάτων κατά την αναβάθμιση.

Για να δημιουργήσετε backup από το shell:

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

Αίτηση για το Αρχείο Άδειας της Έκδοσης 2026.11

Η Έκδοση 2026.11 χρειάζεται νέο license.toml. Ζητήστε το από την ομάδα της digna πριν ξεκινήσετε και έχετέ το έτοιμο για το Βήμα 7.

Αναβάθμιση από Έκδοση Πριν από την 2026.06¶

Η Έκδοση 2026.06 έφερε τρεις αλλαγές που εξακολουθούν να ισχύουν όταν αναβαθμίζετε μια παλαιότερη εγκατάσταση απευθείας στην 2026.11:

• Μόνο ODBC. Το digna προσεγγίζει κάθε τεχνολογία πηγής μέσω ODBC. Κάθε σύνδεση βάσης δεδομένων που δεν χρησιμοποιεί ακόμη ODBC πρέπει να μεταφερθεί σε ODBC μετά την αναβάθμιση· δεν υπάρχει αυτόματη μετατροπή. Εγκαταστήστε εκ των προτέρων τα προγράμματα οδήγησης ODBC στον host του digna, δείτε Εγκατάσταση του ODBC Driver στον Host του digna, και έχετε έτοιμες τις ιδιότητες κάθε σύνδεσης από τους οδηγούς ανά τεχνολογία. Ο σύνδεσμος Databricks Legacy δεν υπάρχει πλέον· μεταφέρετε αυτές τις συνδέσεις στον σύνδεσμο Databricks.
• Ένα εκτελέσιμο. Τα dignabackend και dignacli αντικαθίστανται από το ενιαίο εκτελέσιμο digna, που ενοποιεί το backend και το CLI.
• config.toml. Η ενότητα [encryption] είναι υποχρεωτική, και τα DIGNA_APP_HOST και DIGNA_APP_PORT δεν διαβάζονται πλέον: ο server λαμβάνει τη διεύθυνση και τη θύρα του από το digna serve. Συγκρίνετε το αρχείο σας με την ενότητα Διαμόρφωση Backend.

Τα παρακάτω βήματα επισημαίνουν πού μια παλαιότερη εγκατάσταση χρειάζεται κάτι διαφορετικό. Η αναβάθμιση του repository στο Βήμα 8 φέρνει ένα repository οποιασδήποτε προηγούμενης έκδοσης απευθείας στην 2026.11.

Διαδικασία Αναβάθμισης¶

Βήμα 1: Σταματήστε την υπηρεσία digna¶

Εάν η digna τρέχει ως υπηρεσία systemd, σταματήστε την πρώτα:

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

Εάν η digna τρέχει σε πρώτο πλάνο, πατήστε Ctrl+C στο παράθυρο τερματικού της.

Βήμα 2: Δημιουργήστε αντίγραφο της τρέχουσας εγκατάστασης¶

Στον κατάλογο εγκατάστασης digna, μετονομάστε το εκτελέσιμο και τον φάκελο του dashboard της τρέχουσας εγκατάστασης, ώστε η νέα έκδοση να μπορεί να αναπτυχθεί δίπλα τους:

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

Κρατήστε το digna_old μέχρι να επαληθεύσετε την αναβάθμιση και τον dashboard_old μέχρι να επαναφέρετε από αυτόν τα αρχεία διαμόρφωσής σας (δείτε το Βήμα 4). Μετά μπορείτε να διαγράψετε και τα δύο.

Βήμα 3: Αποσυμπίεση και Ανάπτυξη της Νέας Έκδοσης¶

1. Αποσυμπιέστε το νέο πακέτο εγκατάστασης digna ZIP
2. Αντιγράψτε το νέο εκτελέσιμο digna και τον φάκελο dashboard στον κατάλογο εγκατάστασης
3. Επαναφέρετε το bit εκτέλεσης και την ιδιοκτησία του λογαριασμού υπηρεσίας:

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

Βήμα 4: Επαναφορά των Αρχείων Διαμόρφωσης¶

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

Η Έκδοση 2026.11 δεν απαιτεί καμία αλλαγή στο config.toml: ένα αρχείο που λειτουργεί με την Έκδοση 2026.06 συνεχίζει να λειτουργεί. Δύο αλλαγές είναι προαιρετικές:

• Προσθέστε μια ενότητα [duckdb] αν οι συνδέσεις βάσεων δεδομένων πρόκειται να χρησιμοποιούν το digna Engine και οι προεπιλογές του δεν ταιριάζουν στον host σας.
• Παραλείψτε την ενότητα [app] αν ένας reverse proxy σερβίρει το dashboard και το backend κάτω από ένα origin.

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

Βήμα 5: Επαναφόρτωση του Web Server¶

Το dashboard είναι ένα σύνολο στατικών αρχείων, οπότε ο web server σας — και ο browser — μπορεί να εξακολουθούν να σερβίρουν την προηγούμενη έκδοση. Επαναφορτώστε ή επανεκκινήστε τον web server που φιλοξενεί τον φάκελο dashboard και στη συνέχεια φορτώστε ξανά τη σελίδα με πλήρη ανανέωση (Ctrl+F5).

Βήμα 6: Επικυρώστε τη διαμόρφωση¶

Βεβαιωθείτε ότι το config.toml είναι πλήρες πριν αγγίξετε το repository:

./digna config check

Κάθε ενότητα πρέπει να αναφέρει OK. Διορθώστε ό,τι αναφέρεται ως FAILED, αφαιρέστε τα κλειδιά που παρατίθενται κάτω από το Unknown keys και εκτελέστε ξανά την εντολή πριν συνεχίσετε.

Βήμα 7: Αντικατάσταση του Αρχείου Άδειας¶

Ένα αρχείο άδειας κανονικά μεταφέρεται από τη μία έκδοση στην επόμενη. Η Έκδοση 2026.11 αποτελεί εξαίρεση: προσθέτει δύο αδειοδοτούμενα modules, το digna Data Reconciliation και το digna Agentic, και μια άδεια που εκδόθηκε πριν από την 2026.11 δεν τα περιέχει. Αντιγράψτε το license.toml που σας παρείχε η ομάδα της digna για την Έκδοση 2026.11 στον κατάλογο εγκατάστασης, αντικαθιστώντας το παλιό:

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

./digna license check

Βήμα 8: Αναβάθμιση του Σχήματος Repository¶

Στον κατάλογο εγκατάστασης της digna, εκτελέστε:

cd /opt/digna
./digna repo upgrade

Η Έκδοση 2026.11 διαχειρίζεται το schema του repository με migrations που φέρουν αριθμό έκδοσης. Η πρώτη αναβάθμιση από προηγούμενη έκδοση φέρνει το schema στην τελευταία έκδοση του προηγούμενου μηχανισμού, την καταγράφει ως σημείο εκκίνησης και στη συνέχεια εφαρμόζει τα migrations της Έκδοσης 2026.11. Ολοκληρώνεται με:

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

Όλα τα υπάρχοντα δεδομένα διατηρούνται. Για να δείτε την κατάσταση του repository οποιαδήποτε στιγμή, εκτελέστε ./digna repo check: παραθέτει το πιο πρόσφατο εφαρμοσμένο migration και όσα εκκρεμούν.

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

Βήμα 9: Επανεκκίνηση των Υπηρεσιών¶

Εάν τρέχετε ως υπηρεσία systemd:

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

Εάν τρέχετε χειροκίνητα, επανεκκινήστε τον server:

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

Εάν χρησιμοποιείτε nginx ή Apache, επαναφορτώστε τον αντίστοιχο web server:

sudo systemctl reload nginx

sudo systemctl restart apache2

Στην οικογένεια RHEL, εφαρμόστε ξανά την επισήμανση SELinux εάν αντικαταστάθηκε ο κατάλογος dashboard:

sudo restorecon -Rv /opt/digna/dashboard

Βήμα 10: Επαλήθευση της Αναβάθμισης¶

1. Επιβεβαιώστε την έκδοση του νέου εκτελέσιμου:

   ./digna version
   

   Η πρώτη γραμμή πρέπει να είναι Release: 2026.11.

2. Ανοίξτε το digna dashboard και επιβεβαιώστε ότι η διεπαφή φορτώνει σωστά.

3. Ελέγξτε τα logs του server για σφάλματα:

   sudo journalctl -u digna -n 100
   

4. Δοκιμάστε τις συνδέσεις βάσεων δεδομένων σας — δείτε Δοκιμή σύνδεσης. Μετά από αναβάθμιση από έκδοση πριν από την 2026.06, μεταφέρετε πρώτα σε ODBC κάθε σύνδεση που δεν το χρησιμοποιούσε ήδη.

Για να ξεκινήσετε με τα νέα modules, δείτε digna Data Reconciliation, Σύνδεση ενός AI Agent για τον digna MCP Server και Τοποθεσία Profiling για το digna Engine.