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

Έκδοση: 2026.11

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

Πίνακας Περιεχομένων¶

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

Εισαγωγή¶

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

digna είναι μια ολοκληρωμένη πλατφόρμα με τεχνητή νοημοσύνη σχεδιασμένη να βελτιστοποιεί τη διαχείριση ποιότητας δεδομένων σε διάφορα περιβάλλοντα δεδομένων όπως 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 ή Linux;¶

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

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

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

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

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

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

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

Ποια διαδρομή χρησιμοποιείται σε αυτόν τον οδηγό διαφέρει ανάμεσα σε Apple Silicon και Intel Macs. Για να ελέγξετε ποια έχετε, ανοίξτε το Terminal και εκτελέστε:

uname -m

• arm64 — Apple Silicon. Το Homebrew εγκαθίσταται στο /opt/homebrew.
• x86_64 — Intel. Το Homebrew εγκαθίσταται στο /usr/local.

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

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

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

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

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

Το Homebrew είναι ο τυπικός διαχειριστής πακέτων για macOS και χρησιμοποιείται σε όλο αυτόν τον οδηγό για την εγκατάσταση του PostgreSQL και του nginx.

Βήμα 1: Έλεγχος Εγκατάστασης Homebrew¶

Ανοίξτε το Terminal (πατήστε Cmd + Space, πληκτρολογήστε Terminal, πατήστε Enter) και εκτελέστε:

brew --version

Εάν εμφανιστεί αριθμός έκδοσης, προχωρήστε στην ενότητα Ρύθμιση Διακομιστή PostgreSQL.

Βήμα 2: Εγκατάσταση Homebrew¶

Εάν η εντολή δεν βρέθηκε, εγκαταστήστε το Homebrew ακολουθώντας τις οδηγίες στον επίσημο ιστότοπο Homebrew. Ο εγκαταστάτης επίσης εγκαθιστά τα Xcode Command Line Tools εάν δεν υπάρχουν ήδη.

Βήμα 3: Προσθήκη Homebrew στο PATH¶

Σε Apple Silicon, ο εγκαταστάτης εκτυπώνει δύο εντολές για να προσθέσετε το Homebrew στο περιβάλλον του shell σας. Εκτελέστε τις όπως υποδεικνύεται και στη συνέχεια επιβεβαιώστε:

brew --prefix

Αυτό θα πρέπει να εκτυπώσει /opt/homebrew σε Apple Silicon ή /usr/local σε Intel.

Ρύθμιση Διακομιστή PostgreSQL¶

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

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

Επιλογές Εγκατάστασης¶

Το macOS προσφέρει δύο απλούς τρόπους εγκατάστασης του PostgreSQL. Επιλέξτε ένα:

• Homebrew — εγκατάσταση μέσω γραμμής εντολών, συνιστάται για server deployments
• Postgres.app — γραφική εγκατάσταση, βολική για τοπική αξιολόγηση

Εγκατάσταση PostgreSQL με Homebrew¶

Βήμα 1: Εγκατάσταση του Formula PostgreSQL¶

brew install postgresql@16

Βήμα 2: Προσθήκη PostgreSQL στο PATH¶

Τα versioned PostgreSQL formulas είναι keg-only, που σημαίνει ότι το Homebrew δεν συνδέει αυτόματα τις εντολές τους στο PATH σας. Προσθέστε τις χειροκίνητα:

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

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

brew services start postgresql@16

Αυτό ξεκινά το PostgreSQL άμεσα και το ρυθμίζει να ξεκινά αυτόματα όταν συνδεθείτε.

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

psql --version

Θα πρέπει να δείτε την έκδοση του PostgreSQL εάν η εγκατάσταση ήταν επιτυχής.

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

psql postgres

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

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

psql postgres -c "SHOW port;"

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

Εγκατάσταση PostgreSQL με Postgres.app¶

Εάν προτιμάτε γραφική εγκατάσταση:

1. Κατεβάστε το Postgres.app και σύρετέ το στο φάκελο Applications
2. Ανοίξτε την εφαρμογή και κάντε κλικ στο Initialize για να δημιουργήσετε νέο server
3. Ακολουθήστε τις οδηγίες της εφαρμογής για να προσθέσετε τα εργαλεία γραμμής εντολών στο PATH σας
4. Επαληθεύστε την εγκατάσταση:

psql --version

Το Postgres.app επίσης δημιουργεί έναν superuser με το όνομα του λογαριασμού macOS σας.

Διαμόρφωση Web Server¶

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

• nginx — εγκατάσταση μέσω Homebrew, συνιστάται
• Apache httpd — περιλαμβάνεται στο macOS

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

Και οι δύο ενότητες ρυθμίζουν δύο στοιχεία από τα οποία εξαρτάται το dashboard:

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

Ρύθμιση nginx¶

Επισκόπηση¶

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

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

brew install nginx

Εκκίνηση nginx¶

brew services start nginx

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

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

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

Η διαμόρφωση nginx του Homebrew περιλαμβάνει κάθε αρχείο στον φάκελο servers. Δημιουργήστε ένα αφιερωμένο αρχείο διαμόρφωσης για την digna εκεί:

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

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

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

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

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

nginx -t
brew services restart nginx

Ρύθμιση Apache httpd¶

Επισκόπηση¶

Το macOS περιλαμβάνει τον Apache httpd, οπότε δεν απαιτείται εγκατάσταση. Είναι απενεργοποιημένος από προεπιλογή.

Εκκίνηση Apache¶

sudo apachectl start

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

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

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

Το dashboard απαιτεί URL rewriting. Ανοίξτε τη διαμόρφωση του Apache:

sudo nano /etc/apache2/httpd.conf

Βρείτε την ακόλουθη γραμμή και αφαιρέστε το αρχικό # για να την αποσχολιάσετε:

LoadModule rewrite_module libexec/apache2/mod_rewrite.so

Απαιτούμενο: Επιτρέψτε overrides με .htaccess¶

Στο ίδιο αρχείο, εντοπίστε το μπλοκ <Directory "/Library/WebServer/Documents"> και αλλάξτε:

AllowOverride None

σε:

AllowOverride All

Απαιτούμενο: Τύπος MIME για Αρχεία Markdown¶

Ακόμη στο httpd.conf, προσθέστε την ακόλουθη γραμμή ώστε τα αρχεία Markdown να σερβίρονται σωστά:

AddType text/markdown .md

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

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

sudo apachectl configtest
sudo apachectl restart

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

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

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

Δημιουργία Schema και Χρήστη για το 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>;

Αντικαταστήστε τις ακόλουθες θέσεις κράτησης:

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

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

psql postgres

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

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

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

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

unzip digna-2026.11-macos.zip -d /opt/digna

Κάντε το Εκτελέσιμο Runnable¶

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

cd /opt/digna
chmod +x digna

Εάν το macOS Αποκλείει την Εφαρμογή¶

Αρχεία που έχουν ληφθεί μέσω browser ή mail client έχουν σημαδευτεί με καραντίνα. Εάν το macOS αναφέρει ότι η εφαρμογή "cannot be opened because the developer cannot be verified", αφαιρέστε την ιδιότητα από τον κατάλογο εγκατάστασης:

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

Εναλλακτικά, ανοίξτε τις System Settings → Απόρρητο & Ασφάλεια, εντοπίστε το αποκλεισμένο στοιχείο στο κάτω μέρος της σελίδας και κάντε κλικ στο Open Anyway.

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

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

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

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

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

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

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

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

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

Ενότητα [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]
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"

mkdir -p /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. Ανοίξτε το Terminal
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.

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

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

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

./digna repo upgrade

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

✅ Repo schema 'dignarepo' is up to date.

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

Ο χρήστης διαχειριστή δημιουργείται απευθείας στο 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¶

Στον κατάλογο εγκατάστασης της 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

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

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

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

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

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

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

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

1. Επιβεβαιώστε τη διαδρομή
2. Ανοίξτε $(brew --prefix)/etc/nginx/servers/digna.conf

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

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

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

5. Reload nginx

   nginx -t
   brew services restart nginx
   

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

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

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

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

   sudo cp -R /opt/digna/dashboard /Library/WebServer/Documents/digna
   

2. Προσθήκη Κανόνων Rewrite

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

sudo nano /Library/WebServer/Documents/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 apachectl restart
   

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

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

Εκτέλεση digna ως Υπηρεσία στο Παρασκήνιο¶

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

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

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

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

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

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

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

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

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

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

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

1. Ανοίξτε Terminal

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

   cd /opt/digna/bin
   

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

   sudo ./install_service.sh
   

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

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

Για να Ξεκινήσετε την Υπηρεσία¶

1. Ανοίξτε Terminal
2. Πλοηγηθείτε στο /opt/digna/bin
3. Τρέξτε:

   sudo ./start_service.sh
   

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

1. Ανοίξτε Terminal
2. Πλοηγηθείτε στο /opt/digna/bin
3. Τρέξτε:

   sudo ./stop_service.sh
   

Επαλήθευση της Υπηρεσίας¶

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

sudo launchctl list | grep digna

Μια γραμμή που ξεκινά με process ID δείχνει ότι η υπηρεσία τρέχει. Ένα - στην πρώτη στήλη σημαίνει ότι είναι εγγεγραμμένη αλλά σταματημένη.

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

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

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 πλέον έχει καταργηθεί από το launchd.

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

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

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

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

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

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

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 τρέχει ως υπηρεσία στο παρασκήνιο, σταματήστε την πρώτα:

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

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

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

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

cd /opt/digna
mv digna digna_old
mv dashboard dashboard_old

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

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

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

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

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

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 και στη συνέχεια φορτώστε ξανά τη σελίδα με πλήρη ανανέωση (Cmd+Shift+R).

Βήμα 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 στον κατάλογο εγκατάστασης, αντικαθιστώντας το παλιό:

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: Επανεκκίνηση των Υπηρεσιών¶

Εάν τρέχετε ως υπηρεσία στο παρασκήνιο:

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

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

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

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

brew services restart nginx

sudo apachectl restart

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

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

   ./digna version
   

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

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

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

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