Το αρχείο serviceconfig.xml

Περιεχόμενα

Σημείωση

Όταν σε αυτό το έγγραφο γίνεται παραπομπή σε θέσεις αρχείων ή καταλόγων, το στοιχείο <install-home> αντιστοιχεί στον κατάλογο όπου έχει αποσυμπιεστεί το πακέτο του ελεγκτή ρουτινών.  Αυτός ο κατάλογος εμφανίζεται επίσης ως %TPTP_AC_HOME% στα αρχεία ρυθμίσεων.

Εισαγωγή

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

Το αρχείο serviceconfig.xml περιλαμβάνει τις ακόλουθες ενότητες:

Αν ορίσετε τη μεταβλητή περιβάλλοντος TPTP_AC_HOME, ο ελεγκτής ρουτινών θα αναζητά το αρχείο config/serviceconfig.xml στη διαδρομή που ορίζεται από αυτή τη μεταβλητή. Διαφορετικά, ο ελεγκτής ρουτινών θα αναζητά το αρχείο στη θέση όπου είναι εγκατεστημένος. Η προεπιλεγμένη διαδρομή του αρχείου serviceconfig.xml είναι  <install-home>/config/serviceconfig.xml.

Για κάθε χρήση ενός ελεγκτή ρουτινών που εκτελείται στο ίδιο σύστημα, πρέπει να υπάρχει ένα ξεχωριστό αρχείο serviceconfig.xml με διαφορετικές ρυθμίσεις επιπέδου μεταφοράς.  

Σημείωση

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

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

Ρύθμιση ελεγκτή ρουτινών

Σε αυτή την ενότητα παρουσιάζεται η ιεραρχία των στοιχείων που περιλαμβάνονται στο αρχείο serviceconfig.xml. Η σειρά των στοιχείων που εμφανίζονται στο ίδιο επίπεδο δεν έχει σημασία. Τα στοιχεία πρώτου επιπέδου (AgentControllerEnvironment, Logging, Agent, Plugin, ProcessController, Connection, ApplicationAliases και PeerConnectionTransport) μπορούν να εμφανίζονται μόνο μία φορά στο αρχείο ρυθμίσεων. Κάθε στοιχείο στην ιεραρχία εμφανίζεται ως υπερδιασύνδεση που οδηγεί στην αναλυτική περιγραφή του στοιχείου στην ενότητα Στοιχεία και γνωρίσματα.

AgentControllerConfiguration
    AgentControllerEnvironment
        Variable
    Logging
    Agent
    Plugin
    ProcessController
    Connection
        TransportLayer
            Configuration
                Port
                PipeName
                MemName
               
SecuredPort
               
FilePort
               
IsDataMultiplexed
                ProcessPolling
               
Jvm
                Version
                SecurityEnabled
                UserDefinition
                Keystore
                KeystorePassword
                Hosts
                   
Allow
                    Deny
    CommandExtractor
    ApplicationAliases
        Application
            Variable
            Parameter
     PeerConnectionTransport

Στοιχεία και γνωρίσματα


Στοιχείο:
AgentControllerConfiguration
Αποτελεί το κεντρικό στοιχείο στη ρύθμιση του ελεγκτή ρουτινών. Οι ρυθμίσεις που ορίζονται σε αυτό το στοιχείο χρησιμοποιούνται από τον ελεγκτή ρουτινών κατά την εκκίνησή του. Μπορεί να περιλαμβάνει τα υποστοιχεία που εμφανίζονται στην ακόλουθη. Κάθε υποστοιχείο μπορεί να οριστεί μόνο μία φορά.

Υποστοιχεία:     AgentControllerEnvironment
                            Logging
                            Agent
                            Plugin
                            ProcessController
                            Connection
                            ApplicationAliases
                            PeerConnectionTransport

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

Χρησιμοποιείται από το στοιχείο: AgentControllerConfiguration

Υποστοιχεία: Variable

Στοιχείο: Variable
Το στοιχείο Variable ορίζει μια μεταβλητή περιβάλλοντος και τον τρόπο με τον οποίο θα τοποθετηθεί στο υπάρχον περιβάλλον ώστε να σχηματιστεί το προεπιλεγμένο περιβάλλον για όλες τις εφαρμογές και τις ρουτίνες που εκκινούνται από τον ελεγκτή ρουτινών. Μπορείτε να ορίσετε 0 ή περισσότερα στοιχεία Variable για το στοιχείο AgentControllerEnvironment.

Χρησιμοποιείται από το στοιχείο: AgentControllerEnvironment

Γνωρίσματα:

name
Αυτή η τιμή σειράς χαρακτήρων ορίζει το όνομα της μεταβλητής περιβάλλοντος.
value
Αυτή η τιμή σειράς χαρακτήρων ορίζει την τιμή της μεταβλητής περιβάλλοντος.
position
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων μπορεί να είναι "append", "prepend" ή "replace". Το συγκεκριμένο γνώρισμα ορίζει τη θέση όπου θα τοποθετηθεί η μεταβλητή περιβάλλοντος σε σχέση με το προεπιλεγμένο περιβάλλον.

Στοιχείο: Logging
Ορίζει το επίπεδο σοβαρότητας των πληροφοριών που θα καταγράφονται, τη μορφή με την οποία θα καταγράφονται και τη θέση του αρχείου καταγραφής. Αν παραλειφθεί, όλες οι προειδοποιήσεις για κρίσιμα και σοβαρά συμβάντα θα καταγράφονται σε μορφή CBE στον ίδιο κατάλογο όπου εκτελείται ο ελεγκτής ρουτινών. Μπορείτε να ορίσετε μόνο τη θέση του αρχείου καταγραφής και όχι το όνομά του (tptpAgentCtrl.log).

Χρησιμοποιείται από το στοιχείο: AgentControllerConfiguration

Γνωρίσματα:

level
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων ορίζει το επίπεδο σοβαρότητας των μηνυμάτων που πρέπει να καταγράφονται. Επιλέγοντας ένα επίπεδο, θα καταγράφονται τα συμβάντα αυτού του επιπέδου και όλα τα συμβάντα που είναι σοβαρότερα. Η ακόλουθη λίστα περιλαμβάνει τα διαθέσιμα επίπεδα ταξινομημένα κατά σειρά σοβαρότητας:
  • DEBUG - Περιλαμβάνει μηνύματα που παρέχουν λεπτομέρειες χαμηλού επιπέδου για την εσωτερική ροή της εκτέλεσης κώδικα του ελεγκτή ρουτινών και των ρουτινών.
  • INFORMATION - Περιλαμβάνει φυσιολογικά συμβάντα που μπορεί να ενδιαφέρουν το χρήστη του προγράμματος.
  • WARNING - Περιλαμβάνει μη αναμενόμενα συμβάντα που μάλλον δεν δημιουργούν πρόβλημα στη λειτουργία του προγράμματος.
  • CRITICAL - (Προεπιλογή) Περιλαμβάνει συμβάντα όπου η κανονική λειτουργία του προγράμματος διακόπηκε λόγω σφάλματος.
  • SEVERE - Περιλαμβάνει μόνο τα συμβάντα που έχουν ως αποτέλεσμα τον τερματισμό του προγράμματος.
format
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων ορίζει τη μορφή που χρησιμοποιείται για την εγγραφή των μηνυμάτων στο αρχείο καταγραφής. Ορίστε μία από τις ακόλουθες τιμές:
  • CBE - (Προεπιλογή) Τα μηνύματα θα καταγράφονται σε μορφή CBE (Common Base Event). Αυτή η μορφή επιτρέπει την καταγραφή λεπτομερών πληροφοριών σχετικά με την πηγή και την περίσταση του μηνύματος. Η ανάγνωση των μηνυμάτων αυτής της μορφής γίνεται με τη χρήση ενός βοηθήματος αρχείων καταγραφής CBE.
  • Simple - Τα μηνύματα θα καταγράφονται ως απλό κείμενο.
directory

(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων ορίζει τη θέση όπου θα δημιουργηθεί το αρχείο καταγραφής. Η προεπιλεγμένη θέση είναι ο κατάλογος από τον οποίο εκτελείται ο ελεγκτής ρουτινών.

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

Χρησιμοποιείται από το στοιχείο: AgentControllerConfiguration

Γνωρίσματα:

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

Στοιχείο: Plugin
Αυτό το στοιχείο ορίζει τον κατάλογο στον οποίο θα τοποθετούνται οι επεκτάσεις της ρύθμισης του ελεγκτή ρουτινών.  Οι επεκτάσεις αυτές ορίζονται στα αρχεία ρυθμίσεων pluginconfig.xml.  Οι υποκατάλογοι σε αυτόν τον κατάλογο μπορεί να περιέχουν εκτελέσιμα αρχεία που σχετίζονται με συγκεκριμένες επεκτάσεις.

Χρησιμοποιείται από το στοιχείο: AgentControllerConfiguration

Γνωρίσματα:

path
Αυτή η τιμή σειράς χαρακτήρων ορίζει την πλήρη διαδρομή του καταλόγου στον οποίο ο ελεγκτής ρουτινών θα αναζητά τις επεκτάσεις.
Στοιχείο: ProcessController
Το στοιχείο ProcessController περιέχει απλά μια τιμή η οποία ορίζει τη διαδρομή του εκτελέσιμου αρχείου που θα εκκινεί ο ελεγκτής ρουτινών και θα το καλεί για την εκκίνηση των ρουτινών και των εφαρμογών. Ο ελεγκτής ρουτινών θα καλεί από προεπιλογή τη ρουτίνα tptpProcessController(.exe) η οποία βρίσκεται στον ίδιο κατάλογο με τον ελεγκτή ρουτινών. Το εκτελέσιμο αρχείο πρέπει να εγγραφεί στον ελεγκτή ρουτινών και να είναι σε θέση να επεξεργαστεί το σύνολο εντολών για αυτό το περιβάλλον διεπαφής. Σε αντίθεση με τις άλλες ρουτίνες, επειδή οι πληροφορίες εκκίνησης αυτής της ρουτίνας περιορίζονται στη διαδρομή που ορίζεται εδώ, η ρουτίνα δεν χρειάζεται να έχει έναν υποκατάλογο στον κατάλογο ρουτινών και δεν μπορεί να λάβει ορίσματα γραμμής εντολών.

Χρησιμοποιείται από το στοιχείο: AgentControllerConfiguration

Στοιχείο: Connection
Αυτό το στοιχείο είναι απαραίτητο και πρέπει να περιλαμβάνει τουλάχιστον ένα στοιχείο TransportLayer για κάθε ένα από τα είδη συνδέσεων που χρησιμοποιούνται από τον ελεγκτή ρουτινών (socket, named-pipe και shared memory).

Χρησιμοποιείται από το στοιχείο: AgentControllerEnvironment

Υποστοιχεία: TransportLayer

Γνωρίσματα:

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

Στοιχείο: TransportLayer
Αυτό το στοιχείο ορίζει ένα επίπεδο μεταφοράς (Transport Layer). Το επίπεδο μεταφοράς είναι ένα πρόσθετο συστατικό στοιχείο στον ελεγκτή ρουτινών που είναι υπεύθυνο για την αποστολή και τη λήψη δεδομένων ανάμεσα στα συστατικά στοιχεία σε ένα σύστημα μέσω ενός μηχανισμού επικοινωνίας διεργασιών.

Χρησιμοποιείται από το στοιχείο: Connection

Υποστοιχεία: Configuration
                       CommandExtractor  

Γνωρίσματα:

loadlib
Αυτή η τιμή σειράς χαρακτήρων ορίζει το όνομα της βιβλιοθήκης που θα φορτώνεται για αυτό το επίπεδο μεταφοράς χωρίς το επίθημα (π.χ. χωρίς το επίθημα .dll ή .so). Για τον εντοπισμό της βιβλιοθήκης χρησιμοποιείται η συνήθης διαδρομή συστήματος.
type
Αυτή η τιμή σειράς χαρακτήρων ορίζει την ταυτότητα του είδους του επιπέδου μεταφοράς.  Οι δυνατές τιμές είναι TPTP_SOCKET, TPTP_NAMEDPIPE, TPTP_SHAREDMEM, TPTP_CCTL και TPTP_ACTL.  Τα προσαρμοσμένα επίπεδα μεταφοράς τα χρησιμοποιούν άλλες ταυτότητες.  Οι τιμές TPTP_CCTL και TPTP_ACTL είναι προσαρμοσμένα επίπεδα μεταφοράς που παρέχουν συμβατότητα με προηγούμενες εκδόσεις για τους πελάτες και τις ρουτίνες που χρησιμοποιούν τα περιβάλλοντα διεπαφής του αρχικού ελεγκτή ρουτινών.

Στοιχείο: Configuration
Το στοιχείο Configuration περιλαμβάνει ένα υποστοιχείο που ορίζει το μηχανισμό επικοινωνίας διεργασιών για κάθε επίπεδο μεταφοράς (Transport Layer). Οι διαθέσιμοι μηχανισμοί είναι socket, named-pipe (ονομασμένος δίαυλος), shared memory (κοινόχρηστη μνήμη) και CCTL.   Το επίπεδο μεταφοράς δεδομένων δεν έχει στοιχεία ρύθμισης. Τα προσαρμοσμένα επίπεδα μεταφοράς μπορεί να έχουν συγκεκριμένα στοιχεία ρύθμισης.

Χρησιμοποιείται από το στοιχείο: TransportLayer

Υποστοιχεία:      Port (μόνο με τα επίπεδα μεταφοράς socketTL και CCTL)
                            PipeName (μόνο με το επίπεδο μεταφοράς namedPipeTL)
                            MemName (μόνο με το επίπεδο μεταφοράς sharedMemTL)
                            SecuredPort (μόνο με το επίπεδο μεταφοράς CCTL)
                            FilePort (μόνο με το επίπεδο μεταφοράς CCTL)
                            IsDataMultiplexed (μόνο με το επίπεδο μεταφοράς CCTL)
                            ProcessPolling (μόνο με το επίπεδο μεταφοράς CCTL)
                            Jvm (μόνο με το επίπεδο μεταφοράς CCTL)
                            Version (μόνο με το επίπεδο μεταφοράς CCTL)
                            SecurityEnabled (μόνο με το επίπεδο μεταφοράς CCTL)
                            UserDefinition (μόνο με το επίπεδο μεταφοράς CCTL όταν έχει ενεργοποιηθεί η ασφάλεια)
                            Keystore (μόνο με το επίπεδο μεταφοράς CCTL όταν έχει ενεργοποιηθεί η ασφάλεια)
                            KeystorePassword (μόνο με το επίπεδο μεταφοράς CCTL όταν έχει ενεργοποιηθεί η ασφάλεια)
                            Hosts (μόνο με το επίπεδο μεταφοράς CCTL)

Στοιχείο: Port
Το στοιχείο Port ορίζει τη θύρα που θα χρησιμοποιηθεί για επικοινωνία socket. Το στοιχείο Port ισχύει μόνο όταν χρησιμοποιείται με τα επίπεδα μεταφοράς TPTP_SOCKET και TPTP_CCTL. Η τιμή του στοιχείου είναι ένας ακέραιος αριθμός που δηλώνει τη θύρα (αριθμός θύρας) που θα χρησιμοποιείται για τη σύνδεση socket.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: PipeName
Το στοιχείο PipeName δηλώνει ότι το επίπεδο μεταφοράς είναι για επικοινωνία ονομασμένου διαύλου (named-pipe). Το στοιχείο PipeName ισχύει μόνο όταν χρησιμοποιείται με το στοιχείο namedPipeTL loadlib. Η τιμή του στοιχείου είναι μια σειρά χαρακτήρων που ορίζει το όνομα του διαύλου που θα χρησιμοποιείται για τη σύνδεση.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: MemName
Το στοιχείο MemName δηλώνει ότι το επίπεδο μεταφοράς είναι για επικοινωνία κοινόχρηστης μνήμης (shared memory). Το στοιχείο MemName ισχύει μόνο όταν χρησιμοποιείται με το στοιχείο sharedMemTL loadlib. Η τιμή του στοιχείου είναι μια σειρά χαρακτήρων που ορίζει το όνομα του πόρου κοινόχρηστης μνήμης που θα χρησιμοποιείται για τη σύνδεση.

Χρησιμοποιείται από το στοιχείο: Configuration
 

Στοιχείο: SecuredPort
Το στοιχείο SecuredPort ορίζει τη θύρα που θα χρησιμοποιηθεί για ασφαλή επικοινωνία socket. Το στοιχείο SecuredPort ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL. Η τιμή του στοιχείου είναι ένας ακέραιος αριθμός που δηλώνει τη θύρα (αριθμός θύρας) που θα χρησιμοποιείται για την ασφαλή σύνδεση socket.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: FilePort
Το στοιχείο FilePort ορίζει το επίπεδο μεταφοράς που θα χρησιμοποιείται για επικοινωνία socket από την υπηρεσία μεταφοράς αρχείων. Το στοιχείο FilePort ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL. Η τιμή του στοιχείου είναι ένας ακέραιος αριθμός που δηλώνει τη θύρα (αριθμός θύρας) που θα χρησιμοποιείται για τη σύνδεση socket.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: IsDataMultiplexed
Το στοιχείο IsDataMultiplexed ορίζει αν τα δεδομένα δημιουργίας προφίλ και καταγραφής θα μεταδίδονται μέσω του καναλιού ελέγχου του ελεγκτή ρουτινών. Το κανάλι δεδομένων χρησιμοποιεί από προεπιλογή μια αυθαίρετη θύρα για τη μετάδοση δεδομένων και μπορεί να μπλοκάρει όταν χρησιμοποιείται τείχος προστασίας. Η μεταφορά των δεδομένων μέσω του καναλιού ελέγχου επιτρέπει το άνοιγμα ενός συνόλου προκαθορισμένων θυρών για τις εισερχόμενες αιτήσεις συνδέσεων μέσω ενός τείχους προστασίας. Αυτό το σύνολο περιλαμβάνει την προεπιλεγμένη θύρα 10002, την ασφαλή θύρα 10003 και τη θύρα του εξυπηρετητή αρχείων 10005. Αυτό το στοιχείο πρέπει να ρυθμιστεί με μια λογική τιμή. Η προεπιλεγμένη τιμή "FALSE".  Το στοιχείο IsDataMultiplexed ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: ProcessPolling
Το στοιχείο ProcessPolling ορίζει αν θα ενεργοποιηθεί ο ενεργός έλεγχος της κατάστασης διεργασιών. Αυτό το γνώρισμα διασφαλίζει ότι ο ελεγκτής ρουτινών θα ενημερώνεται κάθε φορά που τερματίζεται μια διεργασία. Αυτό το στοιχείο πρέπει να ρυθμιστεί με μια λογική τιμή. Η προεπιλεγμένη τιμή "TRUE".  Το στοιχείο ProcessPolling ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: Jvm
Το στοιχείο Jvm ορίζει την πλήρη διαδρομή της δυναμικής βιβλιοθήκης χρόνου εκτέλεσης του JVM (jvm.dll ή libjvm.so) που θα χρησιμοποιείται από την υπηρεσία μεταφοράς αρχείων και τα συστατικά στοιχεία ασφαλούς σύνδεσης. Το στοιχείο Jvm ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: Version
Το στοιχείο Version ορίζει τον αριθμό έκδοσης του ελεγκτή ρουτινών που θα αναφέρεται στα άλλα συστατικά στοιχεία. Το στοιχείο Version ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: SecurityEnabled
Το στοιχείο SecurityEnabled ορίζει αν οι πελάτες που θα συνδέονται σε αυτό το πεδίο μεταφοράς πρέπει να χρησιμοποιούν την ασφαλή θύρα για τη σύνδεση.  Όταν η ασφάλεια είναι ενεργοποιημένη και ένας πελάτης προσπαθήσει να συνδεθεί στη μη ασφαλή θύρα, ο πελάτης θα λάβει τη διεύθυνση της ασφαλούς θύρας και η προσπάθεια σύνδεσης δεν θα γίνει δεκτή.  Αυτό το στοιχείο πρέπει να ρυθμιστεί με μια λογική τιμή. Η προεπιλεγμένη τιμή "FALSE".  Το στοιχείο SecurityEnabled ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: UserDefinition
Το στοιχείο UserDefinition ορίζει τους χρήστες που θα μπορούν να συνδεθούν σε αυτό το επίπεδο μεταφοράς.  Αν οριστεί η τιμή "ANY", θα επιτρέπεται η σύνδεση σε όλους τους χρήστες των οποίων τα στοιχεία έχουν εξακριβωθεί μέσω του λειτουργικού συστήματος.  Αν η ασφάλεια είναι ενεργοποιημένη, αυτό το στοιχείο είναι απαραίτητο. Για να ορίσετε συγκεκριμένους χρήστες, καταχωρήστε τα ονόματά τους διαχωρίζοντάς τα με κόμμα.  Το στοιχείο UserDefinition ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: Keystore
Το στοιχείο Keystore ορίζει τη θέση του αρχείου αποθήκευσης κλειδιών για τις ασφαλείς συνδέσεις.  Αν η ασφάλεια είναι ενεργοποιημένη, αυτό το στοιχείο είναι απαραίτητο. Το στοιχείο Keystore ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

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

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: Hosts
Το στοιχείο Hosts χρησιμοποιείται για τον έλεγχο των υπολογιστών που θα μπορούν να συνδέονται μέσω αυτού του επιπέδου μεταφοράς. Αυτό το στοιχείο περιλαμβάνει ένα ή περισσότερα στοιχεία Allow ή Deny.  Το στοιχείο Hosts ισχύει μόνο όταν χρησιμοποιείται με το επίπεδο μεταφοράς TPTP_CCTL.

Χρησιμοποιείται από το στοιχείο: Configuration

Στοιχείο: Allow
Το στοιχείο Allow ορίζει έναν υπολογιστή στον οποίο επιτρέπεται να συνδέεται στον ελεγκτή ρουτινών μέσω αυτού του πρωτοκόλλου μεταφοράς.

Χρησιμοποιείται από το στοιχείο: Hosts

Γνωρίσματα:

host
Αυτή η σειρά χαρακτήρων ορίζει το όνομα ή τη διεύθυνση IP του υπολογιστή. Αν θέλετε να επιτρέπονται οι συνδέσεις από οποιοδήποτε υπολογιστή, ορίστε την τιμή "ALL".  Αν θέλετε να επιτρέπονται οι συνδέσεις μόνο από τοπικές διεργασίες, ορίστε την τιμή "LOCAL".
net
Αυτό το γνώρισμα ορίζει ένα υποδίκτυο από το οποίο θα επιτρέπονται συνδέσεις.
mask
Αυτό το γνώρισμα ορίζει μια μάσκα υποδικτύου που θα χρησιμοποιείται για την αποδοχή των συνδέσεων.

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

Χρησιμοποιείται από το στοιχείο: Hosts

Γνωρίσματα:

host
Αυτή η σειρά χαρακτήρων ορίζει το όνομα ή τη διεύθυνση IP του υπολογιστή στον οποίο δεν θα επιτρέπεται η σύνδεση.
net
Αυτό το γνώρισμα ορίζει ένα υποδίκτυο από το οποίο δεν θα επιτρέπονται συνδέσεις.
mask
Αυτό το γνώρισμα ορίζει μια μάσκα υποδικτύου που θα χρησιμοποιείται για την απόρριψη των συνδέσεων.

Στοιχείο: CommandExtractor
Αυτό το στοιχείο ορίζει μια λειτουργία εξαγωγής εντολών. Η λειτουργία εξαγωγής εντολών είναι ένα πρόσθετο συστατικό στοιχείο σε ένα επίπεδο μεταφοράς που εξάγει τις εντολές από τη ροή επικοινωνίας των διεργασιών. Αυτή η τιμή σειράς χαρακτήρων ορίζει το όνομα της βιβλιοθήκης που θα φορτώνεται χωρίς το επίθημα (π.χ. χωρίς το επίθημα .dll ή .so) ή το πρόθημα (π.χ. "lib" για Linux). Για τον εντοπισμό της βιβλιοθήκης χρησιμοποιείται η συνήθης διαδρομή συστήματος.

Χρησιμοποιείται από το στοιχείο: TransportLayer
 

Στοιχείο: ApplicationAliases
Το στοιχείο ApplicationAliases είναι μια προαιρετική λίστα με ορισμούς ψευδωνύμων εφαρμογών.

Χρησιμοποιείται από το στοιχείο: AgentControllerConfiguration

Υποστοιχεία: Application

Γνωρίσματα:

launchAliasesOnly
(Προαιρετικό γνώρισμα) Αυτό το γνώρισμα έχει τιμή "true" ή "false" (προεπιλογή). Αν οριστεί η τιμή "true", θα εκκινούνται μόνο οι εφαρμογές που περιλαμβάνονται σε αυτή τη λίστα. Αν οριστεί η τιμή "false" ή παραλειφθεί, ο ελεγκτής ρουτινών θα μπορεί να εκκινήσει οποιαδήποτε εφαρμογή.

Στοιχείο: Application
Το στοιχείο Application ορίζει ένα ψευδώνυμο και τις πληροφορίες εκκίνησης για μια εφαρμογή.

Χρησιμοποιείται από το στοιχείο: ApplicationAliases

Υποστοιχεία: Variable
                         Parameter

Γνωρίσματα:

executable
Αυτή η τιμή σειράς χαρακτήρων ορίζει το ψευδώνυμο του εκτελέσιμου αρχείου της εφαρμογής που ορίζεται στο γνώρισμα διαδρομής (path).
location
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων ορίζει τον κατάλογο από τον οποίο θα εκκινείται το εκτελέσιμο αρχείο. Αυτός ο κατάλογος αναφέρεται και ως κατάλογος εργασίας του εκτελέσιμου αρχείου.
path
Αυτή η τιμή σειράς χαρακτήρων ορίζει την πλήρη διαδρομή της εφαρμογής που θα εκκινείται. Αυτή η διαδρομή χρησιμοποιείται στη θέση του ψευδωνύμου κατά την εκκίνηση του εκτελέσιμου αρχείου της εφαρμογής.

Στοιχείο: Variable
Το στοιχείο Variable ορίζει μια μεταβλητή περιβάλλοντος και τον τρόπο με τον οποίο πρέπει να τοποθετηθεί στο υπάρχον περιβάλλον κατά την εκκίνηση της εφαρμογής. Μπορείτε να ορίσετε 0 ή περισσότερα στοιχεία μεταβλητής για μια εφαρμογή.

Χρησιμοποιείται από το στοιχείο: Application

Γνωρίσματα:

name
Αυτή η τιμή σειράς χαρακτήρων ορίζει το όνομα της μεταβλητής περιβάλλοντος.
value
Αυτή η τιμή σειράς χαρακτήρων ορίζει την τιμή της μεταβλητής περιβάλλοντος.
position
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων μπορεί να είναι >"append", "prepend" ή "replace". Το συγκεκριμένο γνώρισμα ορίζει τη θέση όπου θα τοποθετηθεί η μεταβλητή περιβάλλοντος σε σχέση με το προεπιλεγμένο περιβάλλον.

Στοιχείο: Parameter
Το στοιχείο Parameter ορίζει ένα όρισμα γραμμής εντολών που θα δίδεται στην εφαρμογή όταν εκκινείται. Μπορείτε να ορίσετε 0 ή περισσότερα στοιχεία παραμέτρου για μια εφαρμογή.

Χρησιμοποιείται από το στοιχείο: Application

Γνωρίσματα:

value
Αυτή η τιμή σειράς χαρακτήρων ορίζει ένα όρισμα γραμμής εντολών.
position
(Προαιρετικό γνώρισμα) Αυτή η τιμή σειράς χαρακτήρων μπορεί να είναι "append", "prepend" ή "replace". Το συγκεκριμένο γνώρισμα ορίζει τη θέση όπου θα τοποθετηθεί αυτό το όρισμα σε σχέση με τα υπάρχοντα ορίσματα γραμμής εντολών.

Στοιχείο: PeerConnectionTransport
Αυτό το απαραίτητο στοιχείο ορίζει το επίπεδο μεταφοράς που θα χρησιμοποιείται για τις συνδέσεις μεταξύ του ελεγκτή ρουτινών που διαβάζει αυτό το αρχείο ρυθμίσεων και των χρήσεων ομότιμων ελεγκτών ρουτινών.  Η τιμή (όνομα) για αυτό το στοιχείο πρέπει να συμφωνεί με το είδος ενός συγκεκριμένου επιπέδου μεταφοράς που έχει οριστεί στην ενότητα Connection του αρχείου ρυθμίσεων (π.χ. TPTP_CCTL).

Χρησιμοποιείται από το στοιχείο: AgentControllerConfiguration


Παράδειγμα αρχείου serviceconfig.xml

Αυτό το παράδειγμα παρουσιάζει ένα ενδεικτικό αρχείο ρυθμίσεων του ελεγκτή ρουτινών:

<?xml version="1.0" encoding="UTF-8"?>
<AgentControllerConfiguration>
    <AgentControllerEnvironment configuration="default">
        <Variable name="JAVA_PATH" value="C:\Program Files\Java\j2re1.4.2_08\bin\java.exe" position="replace"/>
        <Variable name="RASERVER_HOME" value="C:\Eclipse\Projects\AgentController" position="replace"/>
        <Variable name="TPTP_AC_HOME" value="%RASERVER_HOME%" position="replace"/>
        <Variable name="PLUGINS_HOME" value="%RASERVER_HOME%\plugins" position="replace"/>
        <Variable name="PATH" value="%RASERVER_HOME%\bin" position="prepend"/>
    </AgentControllerEnvironment>
    <ApplicationAliases>
        <Application configuration="default" executable="java.exe" path="%JAVA_PATH%" location="%SYS_TEMP_DIR%">
            <Variable name="CLASSPATH" value="%CLASSPATH_ORG_ECLIPSE_EQUINOX_COMMON%" position="append"/>
            <Variable name="PATH" value="%RASERVER_HOME%\bin" position="prepend"/>
        </Application>
    </ApplicationAliases>
    <Plugin path="%PLUGINS_HOME%"/>
    <Agent path="%TPTP_AC_HOME%\agents"/>
    <Logging level="INFORMATION" format="CBE" directory="%TPTP_AC_HOME%\config"/>
    <ProcessController>%TPTP_AC_HOME%\bin\tptpProcessController.exe</ProcessController>
    <Connection name="Dev">
        <TransportLayer loadlib="socketTL" type="TPTP_SOCKET">
            <Configuration>
                <Port>10006</Port>
            </Configuration>
            <CommandExtractor>tptpCmdExtr</CommandExtractor>
        </TransportLayer>
        <TransportLayer loadlib="namedPipeTL" type="TPTP_LOG">
            <Configuration>
                <PipeName>acmasterlog</PipeName>
            </Configuration>
            <CommandExtractor>tptpCmdExtr</CommandExtractor>
        </TransportLayer>
        <TransportLayer loadlib="namedPipeTL" type="TPTP_NAMEDPIPE">
            <Configuration>
                <PipeName>acmaster</PipeName>
            </Configuration>
            <CommandExtractor>tptpCmdExtr</CommandExtractor>
        </TransportLayer>
        <TransportLayer loadlib="sharedMemTL" type="TPTP_SHAREDMEM">
            <Configuration>
                <MemName>acbuffer</MemName>
            </Configuration>
            <CommandExtractor>tptpCmdExtr</CommandExtractor>
        </TransportLayer>
        <TransportLayer loadlib="tptpCCTL" type="TPTP_CCTL">
            <Configuration>
                <Port>10002</Port>
                <SecuredPort>10003</SecuredPort>
                <FilePort>10005</FilePort>
                <IsDataMultiplexed>false</IsDataMultiplexed>
                <ProcessPolling>true</ProcessPolling>
                <Jvm>C:\Program Files\Java\j2re1.4.2_08\bin\client\jvm.dll</Jvm>
                <Version>4.2.0</Version>
                <SecurityEnabled>true</SecurityEnabled>
                <UserDefinition>ANY</UserDefinition>
                <Keystore>C:\Eclipse\Projects\AgentController\security\tptpSampleKeystore</Keystore>
                <KeystorePassword>password</KeystorePassword>
                <Hosts configuration="default">
                    <Allow host="LOCAL"/>
                </Hosts>
            </Configuration>
            <CommandExtractor>tptpCmdExtr</CommandExtractor>
        </TransportLayer>
        <TransportLayer loadlib="tptpACTL" type="TPTP_ACTL">
            <Configuration/>
            <CommandExtractor>tptpCmdExtr</CommandExtractor>
        </TransportLayer>
    </Connection>
    <PeerConnectionTransport>TPTP_CCTL</PeerConnectionTransport>
</AgentControllerConfiguration>


Copyright (C) 2005, 2006 Intel Corporation.