Αρχεία ρυθμίσεων ελεγκτή ρουτινών

Οι ρυθμίσεις του ελεγκτή ρουτινών καθορίζονται από δύο σύνολα αρχείων ρυθμίσεων. Το πρώτο σύνολο αποτελεί τις βασικές ρυθμίσεις που περιγράφουν τις προεπιλεγμένες ρυθμίσεις του μηχανισμού. Το δεύτερο σύνολο αποτελεί τις ρυθμίσεις πρόσθετων λειτουργιών που περιγράφουν τις ρυθμίσεις ειδικά για κάθε εφαρμογή του μηχανισμού. Αυτό το έγγραφο περιγράφει τις λεπτομέρειες κάθε ρυθμίσεων καθώς και τον τρόπο εγγραφής επεκτάσεων των ρυθμίσεων.

Ο <κατάλογος εγκατάστασης> στον οποίο γίνεται παραπομπή σε αυτό το έγγραφο αντιστοιχεί στη διαδρομή στην οποία ο ελεγκτής ρουτινών αποσυσκευάστηκε. Ο κατάλογος αυτός αναφέρεται επίσης και ως %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
καθορίζει αν αυτή η παράμετρος θα προσαρτηθεί, θα προταθεί ή θα αντικαταστήσει την υπάρχουσα παράμετρο



(C) Copyright IBM Corporation 2000, 2006. Με την επιφύλαξη παντός δικαιώματος.