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

Release: 2026.11

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

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

1. Εισαγωγή
2. Απαιτήσεις Συστήματος
3. Προεγκατάσταση
4. Διαμόρφωση PostgreSQL Server
5. Διαμόρφωση Web Server
6. Αρχική Εγκατάσταση
7. Διαμόρφωση Backend
8. Διαμόρφωση Dashboard
9. Εκτέλεση του digna ως Υπηρεσία Windows
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 και ένα νέο αρχείο άδειας. Η ενότητα αναβάθμισης καλύπτει καθένα από αυτά.

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

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

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

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

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

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

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

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

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

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

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

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

Αν έχετε ήδη PostgreSQL¶

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

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

Ακολουθήστε αυτά τα βήματα για να εγκαταστήσετε το PostgreSQL σε Windows:

Βήμα 1: Κατεβάστε το PostgreSQL¶

1. Επισκεφτείτε τη σελίδα PostgreSQL Downloads
2. Επιλέξτε Windows
3. Κατεβάστε τον πιο πρόσφατο installer

Βήμα 2: Εκτελέστε τον Installer¶

1. Κάντε διπλό κλικ στο αρχείο installer που κατεβάσατε
2. Ακολουθήστε τα βήματα του οδηγού εγκατάστασης

Βήμα 3: Επιλογή Καταλόγου Εγκατάστασης¶

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

Βήμα 4: Επιλογή Στοιχείων Εγκατάστασης¶

Για μία τυπική εγκατάσταση, κρατήστε τις προεπιλεγμένες επιλογές των συστατικών.

Βήμα 5: Ορισμός Κωδικού του Superuser του PostgreSQL¶

Εισάγετε και επιβεβαιώστε έναν κωδικό για τον superuser του PostgreSQL (postgres). Αποθηκεύστε αυτόν τον κωδικό με ασφάλεια — θα τον χρειαστείτε αργότερα.

Βήμα 6: Διαμόρφωση Αριθμού Θύρας¶

Η προεπιλεγμένη θύρα του PostgreSQL είναι 5432. Μπορείτε να χρησιμοποιήσετε την προεπιλογή ή να ορίσετε άλλη θύρα εάν χρειάζεται.

Βήμα 7: Επιλογή Locale¶

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

Βήμα 8: Ολοκλήρωση Εγκατάστασης¶

Κάντε κλικ στο Next για τα υπόλοιπα βήματα και τέλος Finish.

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

Ανοίξτε το Command Prompt και επαληθεύστε ότι το PostgreSQL είναι εγκατεστημένο:

psql --version

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

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

Το digna απαιτεί έναν web server για να φιλοξενήσει το dashboard. Επιλέξτε μία από τις ακόλουθες επιλογές:

• Internet Information Services (IIS)
• Apache Tomcat

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

Ρύθμιση IIS¶

Επισκόπηση¶

Το Internet Information Services (IIS) είναι ο web server της Microsoft για τη φιλοξενία ιστοτόπων και web εφαρμογών.

Ενεργοποίηση IIS¶

1. Άνοιγμα Πίνακα Ελέγχου
2. Πατήστε Win + R

3. Πληκτρολογήστε control και πατήστε Enter

4. Μετάβαση σε Windows Features

5. Κάντε κλικ στο Programs

6. Επιλέξτε Turn Windows features on or off

7. Ενεργοποίηση Internet Information Services

8. Κάντε κύλιση και βρείτε Internet Information Services (IIS)
9. Επιλέξτε το checkbox για να το ενεργοποιήσετε

10. Κάντε κλικ στο + για να επεκτείνετε και επαληθεύστε ότι έχουν επιλεγεί τα εξαρτήματα:

    • Web Management Tools
    • World Wide Web Services

11. Κλικ στο OK για να εφαρμοστούν οι αλλαγές

12. Επαλήθευση Εγκατάστασης IIS

13. Ανοίξτε τον browser σας
14. Μεταβείτε στο http://localhost
15. Πρέπει να δείτε τη σελίδα καλωσορίσματος του IIS

Απαιτείται: URL Rewrite Module¶

Το IIS χρειάζεται το component URL Rewrite. Κατεβάστε και εγκαταστήστε το από τη επίσημη σελίδα της Microsoft.

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

Για να διασφαλίσετε ότι τα αρχεία Markdown (.md) σερβίρονται σωστά από το IIS:

1. Ανοίξτε το IIS Manager (πατήστε Win + R, πληκτρολογήστε inetmgr, πατήστε Enter)
2. Πλοηγηθείτε στο Your Site > MIME Types
3. Κάντε κλικ στο Add...
4. Διαμορφώστε:
5. File name extension: .md
6. MIME type: text/markdown

Ρύθμιση Apache Tomcat¶

Επισκόπηση¶

Το Apache Tomcat είναι ένας open-source servlet container και web server Java.

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

1. Κατεβάστε το Apache Tomcat
2. Επισκεφτείτε Apache Tomcat Downloads

3. Κατεβάστε τη διανομή ZIP για Windows

4. Αποσυμπιέστε το αρχειο

5. Αποσυμπιέστε το ZIP σε έναν κατάλογο στο σύστημά σας

6. Παράδειγμα: C:\Program Files\Apache Tomcat

7. Επαληθεύστε ότι το Tomcat τρέχει

8. Ανοίξτε τον browser σας
9. Μεταβείτε στο http://localhost:8080
10. Πρέπει να δείτε τη σελίδα καλωσορίσματος του Apache Tomcat

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

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

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

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

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

Βήμα 2: Εξαγωγή του Πακέτου Εγκατάστασης του digna¶

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

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

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

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

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

digna_installation/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
└── dashboard/          (web interface)
    └── (dashboard files)

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

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

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

Τοποθεσία: digna_installation/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:

[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 = "C:\\path\\to\\digna\\tmp"

mkdir C:\path\to\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. Ανοίξτε Command Prompt
2. Πλοηγηθείτε στον κατάλογο εγκατάστασης του digna (όπου βρίσκονται config.toml και το εκτελέσιμο digna)
3. Εκτελέστε τον έλεγχο σύνδεσης:

digna repo check

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

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

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

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

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

digna repo upgrade

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

✅ Repo schema 'dignarepo' is up to date.

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

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

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

Παράδειγμα:

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

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

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

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

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

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

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

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

Ανάπτυξη στο IIS¶

1. Άνοιγμα IIS Manager

2. Πατήστε Win + R, πληκτρολογήστε inetmgr, πατήστε Enter

3. Δημιουργία Νέου Website

4. Στο αριστερό πάνελ, κάντε δεξί κλικ στο Sites

5. Επιλέξτε Add Website...

6. Διαμόρφωση του Website

7. Site Name: Εισάγετε ένα όνομα (π.χ., "dignaDashboard")
8. Physical Path: Κάντε κλικ στο Browse και επιλέξτε τον φάκελο dashboard

9. Binding: Ορίστε διεύθυνση IP και θύρα (προεπιλεγμένη θύρα 80 για HTTP, 443 για HTTPS)

10. Έναρξη του Website

11. Κάντε κλικ στο OK για να δημιουργήσετε τον ιστότοπο

12. Κάντε δεξί κλικ στο νέο site και επιλέξτε Start

13. Έλεγχος Εγκατάστασης

14. Ανοίξτε τον browser σας
15. Μεταβείτε στο http://localhost (ή στο ρυθμισμένο URL)
16. Πρέπει να δείτε τη σελίδα εισόδου του digna dashboard

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

1. Αντιγραφή Dashboard στο Tomcat
2. Αντιγράψτε το φάκελο dashboard στον κατάλογο webapps του Tomcat
3. Μετονομάστε τον αν χρειάζεται (π.χ., σε digna)

4. Παράδειγμα: C:\Program Files\Apache Tomcat\webapps\digna

5. Επαλήθευση Ανάπτυξης

6. Ανανέωση ή φόρτωση της διαχειριστικής σελίδας του Tomcat (http://localhost:8080)

7. Θα πρέπει να δείτε το "digna" (ή το όνομα που επιλέξατε) στη λίστα των αναπτυγμένων εφαρμογών

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

9. Ανοίξτε τον browser σας
10. Μεταβείτε στο http://localhost:8080/digna
11. Πρέπει να δείτε τη σελίδα εισόδου του digna dashboard

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

Γιατί να χρησιμοποιήσετε Υπηρεσία Windows;¶

Η εκτέλεση του digna backend ως υπηρεσία Windows διασφαλίζει ότι: - Ξεκινά αυτόματα όταν κάνει boot ο server - Τρέχει στο παρασκήνιο χωρίς ανοιχτό παράθυρο Command Prompt - Επανεκκινείται αυτόματα αν παρουσιαστεί σφάλμα - Μπορεί να διαχειρίζεται μέσω των Windows Services

Οι Εντολές windows¶

Η υπηρεσία διαχειρίζεται από το ίδιο το εκτελέσιμο digna, μέσω των υποεντολών digna windows. Δεν υπάρχουν αρχεία batch προς εκτέλεση.

Κάθε εντολή δέχεται την επιλογή --name για να απευθυνθεί σε υπηρεσία εγγεγραμμένη με μη προεπιλεγμένο όνομα. Η πλήρης λίστα επιλογών βρίσκεται στην αναφορά του CLI.

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

1. Άνοιγμα Command Prompt ως Administrator
2. Δεξί κλικ στο Command Prompt

3. Επιλέξτε "Run as Administrator"

4. Πλοήγηση στον κατάλογο εγκατάστασης του digna

   cd C:\path\to\digna
   

5. Εγγραφή της υπηρεσίας

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Η υπηρεσία εγγράφεται με αυτόματη εκκίνηση, οπότε θα ξεκινά μαζί με τα Windows. Δεν ξεκινά αμέσως — δείτε την επόμενη ενότητα.

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

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

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

digna windows start

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

digna windows stop

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

Αν χρειαστεί να μετακινήσετε την εγκατάσταση του digna:

1. Σταματήστε και αφαιρέστε την εγγραφή της τρέχουσας υπηρεσίας

   cd C:\old\path\digna
   digna windows stop
   digna windows uninstall
   

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

3. Μετακινήστε ολόκληρο τον φάκελο εγκατάστασης του digna στη νέα τοποθεσία

4. Εγγράψτε ξανά την υπηρεσία από τη νέα τοποθεσία

   cd C:\new\path\digna
   digna windows install
   

Επαναλάβετε όσες τιμές --address, --port ή --account χρησιμοποιήσατε την πρώτη φορά — η προηγούμενη εγγραφή δεν υπάρχει πλέον.

1. Εκκίνηση της υπηρεσίας

   digna windows start
   

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

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

   cd C:\path\to\digna
   digna windows stop
   

2. Αφαιρέστε την Εγγραφή της Υπηρεσίας

   digna windows uninstall
   

Η υπηρεσία digna έχει πλέον αφαιρεθεί από τις υπηρεσίες των Windows.

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

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

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

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

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

Αίτηση για το Αρχείο Άδειας της Έκδοσης 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¶

Ανοίξτε ένα Command Prompt ως Administrator και σταματήστε την υπηρεσία με το εκτελέσιμο digna της τρέχουσας εγκατάστασής σας:

cd C:\path\to\digna
digna windows stop

Η υπηρεσία παραμένει καταχωρημένη. Το νέο εκτελέσιμο παίρνει τη θέση του παλιού στον ίδιο κατάλογο, οπότε η καταχώρηση συνεχίζει να δείχνει στο σωστό αρχείο.

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

cd C:\path\to\digna\bin
stop_service.bat
uninstall_service.bat

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

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

cd C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

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

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

1. Αποσυμπιέστε το νέο πακέτο εγκατάστασης digna ZIP
2. Αντιγράψτε το νέο εκτελέσιμο digna και τον φάκελο dashboard στον κατάλογο εγκατάστασης

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

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

copy /Y C:\path\to\new\license.toml license.toml

digna license check

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

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

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

cd C:\path\to\digna
digna windows start

Εάν αναβαθμίσατε από έκδοση πριν από την 2026.06 και καταργήσατε την καταχώρηση της υπηρεσίας στο Βήμα 1, καταχωρήστε την πρώτα ξανά με το εκτελέσιμο digna:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

Δώστε στα --address και --port τις τιμές στις οποίες εξυπηρετούσε η παλιά υπηρεσία, εκτός αν θέλετε τις προεπιλογές 127.0.0.1 και 8000. Προσθέστε --account και --password αν η παλιά υπηρεσία εκτελούνταν με λογαριασμό domain. Δείτε Εκτέλεση του digna ως Υπηρεσία Windows για την πλήρη λίστα επιλογών.

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

cd C:\path\to\digna
digna serve --address <address> --port <port>

Εάν χρησιμοποιείτε IIS ή Tomcat, επανεκκινήστε τον αντίστοιχο web server.

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

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

   digna version
   

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

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

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

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