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

Έκδοση: 2026.06

Τελευταία Ενημέρωση: 5 Σεπτεμβρίου 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.06¶

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

Ψάχνετε για 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.06-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]¶

Αυτή η ενότητα ρυθμίζει τις ρυθμίσεις της εφαρμογής 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 = ["*"]

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

Ενότητα [base]¶

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

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
digna_COOKIE_DOMAIN = "localhost"
digna_COOKIE_PATH = "/"
digna_COOKIE_SECURE = false
digna_COOKIE_HTTPONLY = true
digna_COOKIE_SAME_SITE = "lax"
digna_TOKEN_EXPIRES_IN = 86400
digna_MAX_WORKERS = 4
DIGNA_SCHEDULER_MAX_DELAY = 100
DIGNA_CLEANUP_TIME = "12:00"

Ενότητα [encryption]¶

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

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

Ενότητα [logging]¶

Αυτή η ενότητα ρυθμίζει τη συμπεριφορά καταγραφής:

[logging]
digna_LOGGING_MODE = "INFO"
digna_LOGGING_BACKUP_COUNT = 10

Βήμα 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

Overall: OK

Διορθώστε ό,τι αναφέρεται ως FAILED και εκτελέστε ξανά την εντολή πριν συνεχίσετε. Ο πλήρης κατάλογος επιλογών βρίσκεται στην αναφορά CLI.

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

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

cd /opt/digna
./digna repo check

Θα πρέπει να δείτε επιβεβαίωση ότι η σύνδεση έχει επιτευχθεί (το repository αυτό καθαυτό δεν έχει ακόμη αρχικοποιηθεί).

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

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

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

./digna repo install

Αυτή η εντολή εγκαθιστά τους απαραίτητους πίνακες και το schema στη βάση PostgreSQL σας.

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

1. Ανοίξτε ένα νέο παράθυρο Terminal
2. Πλοηγηθείτε στον κατάλογο εγκατάστασης της digna
3. Εκτελέστε την παρακάτω εντολή για να δημιουργήσετε έναν admin χρήστη:

./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 — Όνομα host/IP - --port — Θύρα server

Θα δείτε μηνύματα εκκίνησης που επιβεβαιώνουν ότι ο server τρέχει:

INFO:     Started server process [1234]
INFO:     Waiting for application startup.
INFO:     Application startup complete
INFO:     Uvicorn running on http://localhost: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, το digna προσεγγίζει κάθε τεχνολογία πηγής μέσω ODBC. Οι προηγούμενες εκδόσεις πρόσφεραν επιλογή ανάμεσα σε πρόγραμμα οδήγησης ανά τεχνολογία και ODBC, μέσω του διακόπτη Use ODBC. Η ομάδα digna αποφάσισε να στηριχθεί αποκλειστικά στο ODBC, επειδή μία μόνο τυποποιημένη διεπαφή προσφέρει περισσότερα από ένα σύνολο προγραμμάτων οδήγησης κατά παραγγελία:

• Έλεγχος ταυτότητας — ο έλεγχος ταυτότητας αποτελεί μέρος του ODBC, οπότε μια σύνδεση μπορεί να χρησιμοποιήσει οτιδήποτε υποστηρίζει το πρόγραμμα οδήγησής της: κωδικούς πρόσβασης, tokens και PAT, Kerberos και Active Directory, MFA και ενιαία σύνδεση μέσω προγράμματος περιήγησης, ταυτότητες cloud, πιστοποιητικά πελάτη και TLS. Οι νέες μέθοδοι έρχονται με ενημέρωση του προγράμματος οδήγησης, αντί να περιμένουν μια έκδοση του digna.
• Προγράμματα οδήγησης που συντηρούνται από τους κατασκευαστές των βάσεων δεδομένων — το πρόγραμμα οδήγησης του ίδιου του κατασκευαστή παρακολουθεί νέες εκδόσεις διακομιστή και διορθώσεις ασφαλείας, και μπορείτε να το ενημερώνετε με το δικό σας πρόγραμμα, ανεξάρτητα από το digna.
• Ένας τρόπος για να διαμορφώνετε τα πάντα — κάθε τεχνολογία είναι μια λίστα ιδιοτήτων κλειδιού/τιμής, με την ίδια διεπαφή, την ίδια κρυπτογράφηση ευαίσθητων τιμών και την ίδια αντιμετώπιση προβλημάτων, αντί για διαφορετικό σύνολο πεδίων ανά πηγή.
• Ρύθμιση και εμβέλεια — επιλογές σε επίπεδο προγράμματος οδήγησης, όπως χρονικά όρια, ρυθμίσεις TLS, διακομιστές μεσολάβησης και μεγέθη ανάκτησης, είναι διαθέσιμες για κάθε πηγή, και μπορεί να συνδεθεί οποιαδήποτε τεχνολογία διαθέτει συμβατό πρόγραμμα οδήγησης ODBC, ακόμη και εκείνες για τις οποίες το digna δεν δημοσιεύει ειδικό οδηγό.

Στην πράξη αυτό σημαίνει ότι ο διακόπτης Use ODBC και τα ξεχωριστά πεδία κεντρικού υπολογιστή, θύρας, βάσης δεδομένων, χρήστη και κωδικού πρόσβασης δεν υπάρχουν πλέον. Κάθε σύνδεση που δεν χρησιμοποιεί ήδη ODBC πρέπει να μεταφερθεί σε ODBC — δεν υπάρχει αυτόματη μετατροπή, οπότε προγραμματίστε το πριν από την αναβάθμιση:

1. Εξετάστε κάθε σύνδεση βάσης δεδομένων που ορίζεται στην εγκατάστασή σας και σημειώστε εκείνες που δεν χρησιμοποιούν ακόμη ODBC — καθεμιά από αυτές θα πρέπει να διαμορφωθεί εκ νέου.
2. Εγκαταστήστε το αντίστοιχο πρόγραμμα οδήγησης ODBC στον κεντρικό υπολογιστή digna — οι συνδέσεις ανοίγουν από τον διακομιστή που εκτελεί το backend του digna, όχι από το πρόγραμμα περιήγησης. Δείτε Εγκατάσταση του προγράμματος οδήγησης ODBC στον κεντρικό υπολογιστή digna.
3. Έχετε έτοιμες τις ιδιότητες ODBC για κάθε επηρεαζόμενη σύνδεση. Οι οδηγοί ανά τεχνολογία παραθέτουν για κάθε πηγή ένα δοκιμασμένο σύνολο ιδιοτήτων.

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

Η δημιουργία αντιγράφου ασφαλείας του Repository της digna είναι ΥΠΟΧΡΕΩΤΙΚΗ

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

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

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

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

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

Αν η digna τρέχει ως υπηρεσία στο παρασκήνιο, σταματήστε την πρώτα:

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

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

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

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

cd /opt/digna
mv dignabackend dignabackend_old

mv dignacli dignacli_old

mv dashboard dashboard_old

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

1. Αποσυμπιέστε το νέο ZIP αρχείο εγκατάστασης digna
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

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

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

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

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

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

./digna config check

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

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

Κάθε έκδοση αδειοδοτείται ξεχωριστά. Αντιγράψτε το license.toml που σας παρείχε η ομάδα της digna για αυτή την έκδοση στον κατάλογο εγκατάστασης, αντικαθιστώντας το παλιό:

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

./digna license check

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

Πλοηγηθείτε στον κατάλογο εγκατάστασης της digna και εκτελέστε:

cd /opt/digna
./digna repo upgrade

Αυτό ενημερώνει το schema του PostgreSQL στην τελευταία έκδοση διατηρώντας όλα τα υπάρχοντα δεδομένα.

Βήμα 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. Πλοηγηθείτε στο dashboard της digna
2. Επιβεβαιώστε ότι το περιβάλλον φορτώνει σωστά
3. Ελέγξτε τα logs του server για τυχόν σφάλματα
4. Μεταφέρετε σε ODBC κάθε σύνδεση που δεν το χρησιμοποιούσε ακόμη και έπειτα δοκιμάστε όλες τις συνδέσεις — δείτε Δοκιμή σύνδεσης