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

Release: 2026.06

Τελευταία Ενημέρωση: 30 Αυγούστου 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.06¶

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

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

Αυτή η ενότητα διαμορφώνει τις ρυθμίσεις της εφαρμογής backend:

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

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

digna repo check

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

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

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

digna repo install

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

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

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

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 - --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 σας και ακολουθήστε τα αντίστοιχα βήματα ανάπτυξης.

Ανάπτυξη στο 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, το 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 εξασφαλίζει ότι μπορείτε να επαναφέρετε τα δεδομένα αν η αναβάθμιση αντιμετωπίσει απρόβλεπτα προβλήματα.

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

Βήμα 1: Σταματήστε και Αφαιρέστε την Εγγραφή της Παλιάς Υπηρεσίας¶

Αν το digna τρέχει ως υπηρεσία Windows, σταματήστε το με τα αρχεία batch της τρέχουσας εγκατάστασής σας — οι εντολές digna windows ανήκουν στη νέα έκδοση και δεν είναι ακόμη διαθέσιμες:

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

Στη συνέχεια αφαιρέστε την εγγραφή της υπηρεσίας, πάλι με το παλιό αρχείο batch. Η εγγραφή δείχνει στο παλιό εκτελέσιμο και στα scripts του, τα οποία αντικαθιστά αυτή η αναβάθμιση, οπότε δεν μπορεί να επαναχρησιμοποιηθεί:

uninstall_service.bat

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

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

# Rename the folder containing dignabackend
ren dignabackend dignabackend_old

# Rename the folder containing dignacli
ren dignacli dignacli_old

# Rename dashboard
ren dashboard dashboard_old

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

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

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

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

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

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

digna config check

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

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

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

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

digna license check

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

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

digna repo upgrade

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

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

Η παλιά εγγραφή αφαιρέθηκε στο Βήμα 1, οπότε η υπηρεσία εγγράφεται ξανά — αυτή τη φορά με το εκτελέσιμο digna, το οποίο δεν έχει αρχεία batch:

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

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

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

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

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

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

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