Αρχεία ρυθμίσεων ελεγκτή ρουτινών
Οι ρυθμίσεις του ελεγκτή ρουτινών καθορίζονται από δύο σύνολα αρχείων ρυθμίσεων.
Το πρώτο σύνολο αποτελεί τις βασικές ρυθμίσεις που περιγράφουν τις προεπιλεγμένες ρυθμίσεις του μηχανισμού.
Το δεύτερο σύνολο αποτελεί τις ρυθμίσεις πρόσθετων λειτουργιών που περιγράφουν τις ρυθμίσεις ειδικά για κάθε εφαρμογή του μηχανισμού.
Αυτό το έγγραφο περιγράφει τις λεπτομέρειες κάθε ρυθμίσεων καθώς και τον τρόπο εγγραφής επεκτάσεων των ρυθμίσεων.
Ο <κατάλογος εγκατάστασης> στον οποίο γίνεται παραπομπή σε αυτό το έγγραφο αντιστοιχεί στη διαδρομή στην οποία ο ελεγκτής ρουτινών αποσυσκευάστηκε. Ο κατάλογος αυτός αναφέρεται επίσης και ως %RASERVER_HOME% στα αρχεία ρυθμίσεων.
Βασικές ρυθμίσεις
Οι βασικές ρυθμίσεις αποτελούνται από το αρχείο <κατάλογος εγκατάστασης>/config/serviceconfig.xml το οποίο κατασκευάζεται με τη χρήση σχήματος XML <κατάλογος εγκατάστασης>/config/serviceconfig.xsd.
Με αυτόν τον τρόπο καθορίζονται οι προεπιλεγμένες ρυθμίσεις, όπως οι μεταβλητές περιβάλλοντος συστήματος, οι ρυθμίσεις εφαρμογής και η δυνατότητα σύνδεσης του ελεγκτή ρουτινών.
Οι βασικές ρυθμίσεις διατίθενται για όλες τις ρυθμίσεις και φορτώνονται κατά την εκκίνηση
της υπηρεσίας μηχανισμού. Οι προγραμματιστές εφαρμογών δεν πρέπει να τροποποιούν αυτό το βασικό αρχείο ρυθμίσεων καθώς οποιαδήποτε αλλαγή στις βασικές ρυθμίσεις θα ισχύσει καθολικά. Οι ρυθμίσεις πρόσθετων λειτουργιών (περιγράφονται παρακάτω) πρέπει να χρησιμοποιούνται για τον καθορισμό των ρυθμίσεων ειδικά για πρόσθετες λειτουργίες και εφαρμογές.
Ρυθμίσεις πρόσθετων λειτουργιών
Κάθε εφαρμογή οριζόμενη από το χρήστη πρέπει να διατηρεί το αρχείο ρυθμίσεων και τις
εξαρτήσεις της μέσα στον κατάλογο της πρόσθετης λειτουργίας <κατάλογος
εγκατάστασης>/plugin/<όνομα πρόσθετης λειτουργίας> όπου το <όνομα
πρόσθετης λειτουργίας> αποτελεί ένα μοναδικό όνομα το οποίο προσδιορίζει την
εφαρμογή. Το αρχείο ρυθμίσεων της πρόσθετης λειτουργία pluginconfig.xml πρέπει να τοποθετείται μέσα στον υποκατάλογο config του καταλόγου της πρόσθετης λειτουργίας.
Συνήθως τα αρχεία JAR τοποθετούνται μέσα στον υποκατάλογο lib του καταλόγου της πρόσθετης λειτουργίας.
Οι προγραμματιστές μπορούν να χρησιμοποιούν το σχήμα XML <κατάλογος εγκατάστασης>/config/pluginconfig.xsd που θα τους βοηθήσει στην κατασκευή του αρχείου ρυθμίσεων της πρόσθετης λειτουργίας.
Στοιχεία και γνωρίσματα
Στοιχείο: AgentControllerConfiguration
Αποτελεί το κεντρικό στοιχείο των βασικών ρυθμίσεων. Οι ρυθμίσεις χρησιμοποιούνται για την εκκίνηση της υπηρεσίας μηχανισμού.
Χρησιμοποιείται από: Βασικές ρυθμίσεις
Υποστοιχεία: AgentControllerEnvironment, Application, Hosts, Service, Agent, Option, Plugin
Γνωρίσματα:
- activeConfiguration
- καθορίζει τις ρυθμίσεις που θα φορτωθούν κατά την εκκίνηση του μηχανισμού
- filePort
- καθορίζει τη θύρα ακρόασης της υπηρεσίας μεταφοράς αρχείων του ελεγκτή ρουτινών. Η προεπιλεγμένη τιμή είναι 10005.
- isDataMultiplexed
- καθορίζει αν τα δεδομένα δημιουργίας προφίλ και καταγραφής πρέπει να μεταβιβαστούν μέσω ενός καναλιού ελέγχου του ελεγκτή ρουτινών.
Ως προεπιλογή, το κανάλι δεδομένων χρησιμοποιεί μια αυθαίρετη θύρα για τη μετάδοση
δεδομένων και μπορεί να μπλοκάρει αν υπάρχει ένα τείχος προστασίας. Η μεταφορά των
δεδομένων μέσω του καναλιού ελέγχου επιτρέπει το άνοιγμα ενός συνόλου προκαθορισμένων
θυρών για τις αιτήσεις εισερχόμενων συνδέσεων μέσω ενός τείχους προστασίας. Σε αυτές τις θύρες συμπεριλαμβάνεται και η προεπιλεγμένη θύρα 10002, η ασφαλής θύρα 10003 και η θύρα του εξυπηρετητή αρχείων 10005. Η προεπιλεγμένη τιμή για αυτό το γνώρισμα είναι false.
- jvm
- η πλήρως προσδιορισμένη διαδρομή της δυναμικής βιβλιοθήκης περιβάλλοντος εκτέλεσης εικονικής μηχανής Java (jvm.dll ή libjvm.so)
- loggingDetail
- ενεργοποίηση της λειτουργίας καταγραφής αριθμού γραμμής του μηχανισμού αν έχει οριστεί ΥΨΗΛΟ επίπεδο
- loggingDirectory
- ο κατάλογος στον οποίο δημιουργείται το αρχείο καταγραφής servicelog.log του μηχανισμού
- loggingLevel
- φίλτρο σοβαρότητας για μηνύματα καταγραφής
- port
- θύρα μηχανισμού για τη λειτουργία ακρόασης της εισερχόμενης μη ασφαλής
σύνδεσης πελάτη
- processPolling
- καθορίζει αν θα ενεργοποιηθεί ή όχι ο ενεργός έλεγχος της κατάστασης διεργασίας. Αυτό το γνώρισμα χρησιμοποιείται κυρίως στα συστήματα με λειτουργικό σύστημα Windows για να διασφαλιστεί ότι ο ελεγκτής ρουτινών ειδοποιείται κάθε φορά που τερματίζεται μια διεργασία.
Η προεπιλεγμένη τιμή είναι "true".
- securedPort
- θύρα μηχανισμού για τη λειτουργία ακρόασης της εισερχόμενης
ασφαλούς σύνδεσης πελάτη
- version
- εκδοχή του μηχανισμού
Στοιχείο: PluginConfiguration
Αποτελεί το κεντρικό στοιχείο των ρυθμίσεων πρόσθετων λειτουργιών. Οι ρυθμίσεις φορτώνονται αφού φορτωθούν πρώτα οι βασικές ρυθμίσεις.
Χρησιμοποιείται από: Ρυθμίσεις πρόσθετων λειτουργιών
Υποστοιχεία: AgentControllerEnvironment, Application, Service, Agent, Option
Γνωρίσματα:
- requires
- μια λίστα που διαχωρίζεται με κόμματα του(ων) ονόματος(ων) των
πρόσθετων λειτουργιών από τις οποίες αυτές οι ρυθμίσεις εξαρτώνται. Όπως συμβαίνει και
στο TPTP 4.0, έχει προστεθεί ένα επίθημα ταυτότητας εκδοχής στα ονόματα των πρόσθετων
λειτουργιών. Αποτελείται από ένα χαρακτήρα υπογραμμής που ακολουθείται από τον αριθμό εκδοχής της έκδοσης. Για παράδειγμα: org.eclipse.tptp.platform.agentcontroller_4.0.0.
Για να διασφαλιστεί η συμβατότητα των πρόσθετων λειτουργιών για εφαρμογές που διαθέτουν
εξαρτήσεις σε πρόσθετες λειτουργίες από προγενέστερες εκδόσεις (πρόσθετες λειτουργίες
χωρίς επίθημα ταυτότητας εκδοχών), έχετε την επιλογή να καθορίσετε το όνομα της πρόσθετης
λειτουργίας για το γνώρισμα "requires" εξαιρώντας την ταυτότητα εκδοχής. Σε
αυτή την περίπτωση, ο φορτωτής ρυθμίσεων του ελεγκτή ρουτινών θα επιχειρήσει πρώτα να
εντοπίσει το πλήρες όνομα της πρόσθετης λειτουργίας συμπεριλαμβανομένου του επιθήματος
ταυτότητας εκδοχής. Αν δεν το επιτύχει, ο φορτωτής ρυθμίσεων θα αναζητήσει το όνομα της
πρόσθετης λειτουργίας χωρίς το επίθημα ταυτότητας εκδοχής. Αν υπάρχουν περισσότερες από
μία πρόσθετες λειτουργίες με το ίδιο όνομα, θα χρησιμοποιηθεί το πρώτο όνομα πρόσθετης
λειτουργίας που θα επιστραφεί από το λειτουργικό σύστημα.
Στοιχείο: AgentControllerEnvironment
Αποτελεί ένα σύμβολο κράτησης θέσεων για καθολικές μεταβλητές περιβάλλοντος που συνεισφέρονται από αυτές τις ρυθμίσεις.
Δημοσιεύονται στο σύστημα και διατίθενται για όλες τις άλλες ρυθμίσεις συμπεριλαμβανομένων των βασικών ρυθμίσεων.
Χρησιμοποιείται από: AgentControllerConfiguration, PluginConfiguration
Υποστοιχεία: Variable
Γνωρίσματα:
- configuration
- το όνομα των ρυθμίσεων στις οποίες θα προστεθούν οι μεταβλητές περιβάλλοντος
Στοιχείο: Application
Αποτελεί σύμβολο κράτησης θέσεων για περιβάλλον ειδικά για μια εφαρμογή. Οι ρυθμίσεις που βρίσκονται εντός είναι ορατές μόνο σε αυτή την συγκεκριμένη εφαρμογή.
Χρησιμοποιείται από: AgentControllerConfiguration, PluginConfiguration
Υποστοιχεία: Variable, Parameter
Γνωρίσματα:
- configuration
- το όνομα των ρυθμίσεων στις οποίες θα προστεθεί η εφαρμογή
- executable
- το όνομα της εφαρμογής, οι πελάτες πρέπει να χρησιμοποιούν αυτό το όνομα για τον προσδιορισμό αυτής της εφαρμογής
- path
- η πραγματική πλήρως προσδιορισμένη διαδρομή του προγράμματος το οποίο πρέπει να εκτελέσει αυτή η εφαρμογή
- location
- ο κατάλογος εργασίας αυτής της εφαρμογής
- extends
- το όνομα ρυθμίσεων στις οποίες η ίδια εφαρμογή έχει ήδη οριστεί, με αυτόν τον τρόπο θα προστεθούν οι τρέχουσες ρυθμίσεις στην αρχή
Στοιχείο: Hosts
Αποτελεί σύμβολο κράτησης θέσεων για πληροφορίες του υπολογιστή. Χρησιμοποιείται από το μηχανισμό για να επιτρέπει / αποτρέπει τη σύνδεση συγκεκριμένου(ων) συστήματος(ων).
Χρησιμοποιείται από: AgentControllerConfiguration
Υποστοιχεία: Allow, Deny
Γνωρίσματα:
configurationτο όνομα των ρυθμίσεων όπου χρησιμοποιήθηκαν οι πληροφορίες υπολογιστή
Στοιχείο: Allow
Καθορίζει τους υπολογιστές που επιτρέπεται να συνδεθούν στο μηχανισμό.
Χρησιμοποιείται από: Hosts
Γνωρίσματα:
- host
- όνομα ή διεύθυνση IP του υπολογιστή
- net
- υποδίκτυο
- mask
- μάσκα υποδικτύου
Στοιχείο: Deny
Καθορίζει τους υπολογιστές που δεν επιτρέπεται να συνδεθούν στο μηχανισμό.
Χρησιμοποιείται από: Hosts
Γνωρίσματα:
- host
- όνομα ή διεύθυνση IP του υπολογιστή
- net
- υποδίκτυο
- mask
- μάσκα υποδικτύου
Στοιχείο: Service
Καθορίζει τη λειτουργική μονάδα οριζόμενη από το χρήστη που θα φορτωθεί κατά την εκκίνηση του μηχανισμού.
Χρησιμοποιείται από: AgentControllerConfiguration, PluginConfiguration
Υποστοιχεία: Option
Γνωρίσματα:
- configuration
- το όνομα των ρυθμίσεων όπου θα φορτωθεί αυτή η υπηρεσία
- name
- το όνομα της υπηρεσίας
- path
- η πλήρως προσδιορισμένη διαδρομή της δυναμικής βιβλιοθήκης φόρτωσης
Στοιχείο: Agent
Καθορίζει πληροφορίες ειδικά για ρουτίνες.
Χρησιμοποιείται από: AgentControllerConfiguration, PluginConfiguration
Υποστοιχεία: Option
Γνωρίσματα:
- configuration
- το όνομα των ρυθμίσεων όπου χρησιμοποιούνται αυτές οι ρυθμίσεις ρουτίνας
- name
- το όνομα της ρουτίνας
- type
- το είδος της ρουτίνας
- dataChannelSize
- το μέγεθος της κοινόχρηστης μνήμης που θα κατανεμηθεί για την επικοινωνία μεταξύ διεργασιών
- logFile
- πλήρως προσδιορισμένη διαδρομή για το αρχείο καταγραφής το οποίο πραγματοποιεί εγγραφή των μηνυμάτων που αποστέλλονται από τη ρουτίνα
- client
- καθορίζει αν η ρουτίνα αυτή είναι δυναμική ή χωρίς γραφικό περιβάλλον
Στοιχείο: Option
Χρησιμοποιείται για την αποθήκευση ζεύγους ονόματος/τιμής.
Χρησιμοποιείται από: AgentControllerConfiguration, PluginConfiguration, Service, Agent
Γνωρίσματα:
- name
- το όνομα της επιλογής (π.χ. χώρος ονομάτων)
- type
- το είδος της επιλογής (π.χ. όνομα επιλογής)
- value
- η τιμή της επιλογής
Στοιχείο: Plugin
Καθορίζει τον κατάλογο στον οποίο θα γίνει αναζήτηση ρυθμίσεων πρόσθετων λειτουργιών
Χρησιμοποιείται από: AgentControllerConfiguration
Γνωρίσματα:
pathπλήρως προσδιορισμένος κατάλογος στον οποίο θα γίνει αναζήτηση των ρυθμίσεων
πρόσθετων λειτουργιών
Στοιχείο: Variable
Μεταβλητή περιβάλλοντος.
Χρησιμοποιείται από: Application, AgentControllerEnvironment
Γνωρίσματα:
- name
- το όνομα της μεταβλητής περιβάλλοντος (π.χ. CLASSPATH)
- value
- η τιμή της μεταβλητής περιβάλλοντος
- position
- καθορίζει αν αυτή η τιμή θα προσαρτηθεί, θα προταθεί ή θα αντικαταστήσει την υπάρχουσα τιμή
Στοιχείο: Parameter
Παράμετρος προγράμματος.
Χρησιμοποιείται από: Application
Γνωρίσματα:
- value
- τιμή της παραμέτρου προγράμματος
- position
- καθορίζει αν αυτή η παράμετρος θα προσαρτηθεί, θα προταθεί ή θα αντικαταστήσει την υπάρχουσα παράμετρο