Σκοπός:

Σε αυτή τη μελέτη, περιγράφεται η διαδικασία εγκατάστασης και εκτέλεσης του Pegasus .NET Devices.

Λειτουργία:

Το Pegasus .NET Devices είναι απαραίτητο εκτελέσιμο για την επικοινωνία του Pegasus Web App με πληθώρα εξωτερικών συσκευών όπως:

• Συσκευές POS
• Εκτυπωτές
• Ταμειακές

κ.α.

Ουσιαστικά η εφαρμογή αυτή υλοποιεί έναν WebSocket Server ο οποίος θα παραλαμβάνει τα αιτήματα από το Pegasus WebApp προκειμένου να επιτευχθεί επικοινωνία με τις παραπάνω κατηγορίες συσκευών.

Προϋποθέσεις:

• Θα πρέπει να έχετε εγκαταστήσει το τελευταίο Microsoft Visual C++ Redistributable(έχει δοκιμαστεί η έκδοση 14.38.33135.0 την οποία μπορείτε να κατεβάσετε από εδώ). Επίσης είναι απαραίτητη η επανεκκίνηση του Η/Υ για να ολοκληρωθεί η εγκατάσταση και να λειτουργήσει σωστά το Pegasus .NET Devices.
• Η έκδοση των Windows που λειτουργεί σωστά το Devices ειναι τα Windows 10 και οι νεότερες εκδόσεις.
• Θα πρέπει να είναι ενεργό και να εκτελείται το service των Windows [Windows Management Instrumentation] ([Διαχείριση Οργάνων των Windows]). Μπορείτε από το cmd να εκτελέσετε την παρακάτω εντολή ώστε να δείτε την κατάσταση του service
  sc query winmgmt

Ρυθμίσεις:

Εγκατάσταση Pegasus .NET Devices

1. Κατεβάζετε το αρχείο Pegasus .NET Devices και το εκτελείτε. Καλείστε να επιλέξετε το path εγκατάστασης. Το default path εγκατάστασης είναι το C:\TESAESA\Pegasus_Devices\ .

Προτείνεται αν αυτό χρειαστεί να αλλάξει, να χρησιμοποιηθεί κάποιο path χωρίς κενά και μόνο με λατινικούς χαρακτήρες. Θα εγκατασταθεί η εφαρμογή Pegasus .NET Devices και θα δημιουργηθεί το shortcut [Devices.exe] στην Επιφάνεια Εργασίας.

Εκτελείτε την εφαρμογή. Δεν θα ανοίξει κάποιο παράθυρο αλλά θα προσθέσει στα Toolbar Items της Taskbar των Windows την εφαρμογή [Pegasus Devices]. 

Pegasus .NET Devices: Βασικές Ρυθμίσεις και Εκτέλεση

1. Με διπλό κλικ στο toolbar item, ανοίγει το βασικό παράθυρο της εφαρμογής.

Πριν κάνετε οποιαδήποτε ενέργεια, θα χρειαστεί να δημιουργήσετε χειροκίνητα έναν φάκελο ονόματι logs στο επίπεδο C:\TESAESA\logs.

Ορίζετε την Πόρτα στην οποία θα ακούει ο WebSocket Server. Είναι η πόρτα του WebSocket Server στην οποία θα δέχεται requests από το Web App. Ως προεπιλεγμένη τιμή έρχεται η 50063.

2. Με κλικ στο button [Play], εκκινεί ο websocket server και το log ενημερώνεται σχετικά:

Pegasus .NET Devices: Εκτέλεση με την εκκίνηση του Η/Υ

Μπορείτε να ρυθμίσετε το Pegasus .NET Devices να τρέχει με την εκκίνηση των Windows, ακολουθώντας τα παρακάτω βήματα:

1. Δημιουργείτε ένα αρχείο εκτέλεσης εντολών (κατάληξη .bat) χρησιμοποιώντας πχ το windows notepad. Το κείμενο που θα περιέχει είναι:
   
   start "" /D "C:\TESAESA\Pegasus_Devices\" devices.exe autorun
   
   όπου C:\TESAESA\Pegasus_Devices το φάκελο όπου έχετε εγκαταστήσει το Pegasus Devices. Με το όρισμα autorun ο server εκκινεί αυτόματα.
   
   
2. Αντιγράφετε το .bat αρχείο στον startup folder των Windows (για Windows 10/11, ο startup folder βρίσκεται στο C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup)

Pegasus .NET Devices: Αναβάθμιση

Σε περίπτωση που βγει νέα έκδοση Pegasus .NET Devices και θέλετε να την εγκαταστήσετε, θα πρέπει να κάνετε πρώτα απεγκατάσταση της προηγούμενης.

Σημείωση: δεν θα χρειαστεί εκ νέου στήσιμο. Οι ρυθμίσεις παραμένουν ως έχουν.

Pegasus .NET Devices: Ενεργοποίηση των log αρχείων για καταγραφή σφαλμάτων

Σε περιπτώσεις όπου ο [Έλεγχος συνδεσιμότητας] στο WebSocket που θα δημιουργήσετε είναι επιτυχής αλλά λαμβάνετε κάποιο σφάλμα κατά την επικοινωνία με τις εξωτερικές συσκευές, μπορείτε να ενεργοποιήσετε τα log καταγραφής σφαλμάτων.

Με τη διαδικασία αυτή κατά την εκτέλεση του Pegasus Device δημιουργούνται logs που καταγράφουν τις ενέργειες της εφαρμογής. Τα αρχεία αυτά αποθηκεύονται στον φάκελο logs που δημιουργήσατε κατά την εγκατάσταση το Pegasus Devices.

Για να γίνει η ενεργοποίηση της καταγραφής των log αρχείο θα πρέπει

1. Μέσα από το φάκελο του Pegasus Device να ανοίξετε το αρχείο Pegasus.config

2. Στο αρχείο θα παραμετροποιήσετε τη γραμμή
   <var key="logLevel" value="OFF" />
   σε
   <var key="logLevel" value="DEBUG" />

3. Αποθηκεύετε τις αλλαγές σας και εκτελείτε ξανά το Pegasus Device

Αφού δημιουργήσετε τα αρχεία των logs μπορείτε να μας τα στείλετε ώστε να τα ελέγξουμε. Επικοινωνήστε με το Τεχνικό Τμήμα της ΤΕΣΑΕ, καταχωρώντας μια ΠΠΥ μέσα από το extranet σας.