Der Vertreter läßt sich über verschiedene Parameter in seinem Laufzeitverhalten beeinflußen. Solche Parameter werden als Java™-Eigenschaften als Teil des Kommandos oder eingebettet in eine Start-Datei mit angegeben.
Java™-Eigenschaften werden in der folgenden Form der Java™-VM übergeben:
-DName=Wert
Zur Vereinfachung sollte ihre Angabe gleich nach java erfolgen, um Komplikationen zu vermeiden.
java -DName=Wert -classpath ...
Name und Wert dürfen keine Leerzeichen enthalten oder müssen in Shell- bzw. Kommandozeileninterpreter-spezifische Steuerzeichen, wie z.B. Anführungszeichen, eingefaßt werden.
Folgende Parameter kennt der Vertreterdienst:
Server-bezogene Parameter sind in der Dokumentation des Roblet®-Servers zu finden.
Port
Roblet®-Anwendungen brauchen einen Ersatz-Server-Namen, um den über einen Vertreter vermittelten Roblet®-Server im lokalen Netz ansprechen zu können. Über die Java™-Eigenschaft genRob.genGate.port wird der Port-Anteil des Namens festgelegt - es handelt sich um das TCP-Port, an dem der Vertreter auf eingehende Rufe lauscht. Der Host-Teil des Namens ergibt ist einfach der Host-Name (oder IP-Adresse) des Rechners, auf dem die Vertreter-Instanz läuft.
Hier ein Beispiel:
java -DgenRob.genGate.port=12001 ...
Die Eigenschaft muß gesetzt sein und eine positive ganze Zahl kleiner 65536 sein.
Ziel
Bei seiner Arbeit nimmt der Vertreter nur Rufe und Daten entgegen und leitet sie weiter. Die lokal (vgl. Port) eingenden Rufe und Daten werden an das per Java™-Eigenschaft genRob.genGate.target angegebene Ziel weitergeleitet. Ziel kann dabei direkt der Roblet®-Server sein, für den der Vertreter stellvertretend wirkt, oder eine weitere Vertreter-Instanz oder auch z.B. ein SSH-Tunnel o.a.m.
Hier ein Beispiel:
java -DgenRob.genGate.target=remote.uni-xxx.de:12001 ...
Die Eigenschaft muß gesetzt sein und muß eine Kombination aus Host-Namen und Port-Adresse, getrennt durch einen Doppelpunkt, sein. Der Host-Name muß ein korrekter DNS-Name oder IP-Adresse sein. Das TCP-Port muß eine ganze Zahl größer Null und kleiner 65536 sein.
Logbuch
Ein Vertreter kann viele Informationen über seine Aktivitäten ins Logbuch des Roblet®-Servers eintragen. Das Eintragen ins Logbuch ist standardmäßig abgeschaltet.
Um Informationen ins Logbuch eintragen zu lassen, muß die Java™-Eigenschaft genRob.genGate.log bestimmte Schlüsselworte enthalten.
Folgende Schlüsselworte gibt es:
- connect - Verbindungsverarbeitung,
- jini - Jini™-Arbeit,
- module - Generelle Vorgänge ((Einheit-Anforderungen etc.)),
- server - Verbindungsannahme,
- tunnel - Kommunikation und
- version - Modulversion.
Hier ein Beispiel:
java -DgenRob.genGate.log=version,module ...
Läßt man die Eigenschaft leer (genRob.genGate.log=), so ist das gleichbedeutend mit dem Weglassen der Eigenschaft.
