Parameter

Der Vertreter läßt sich über verschiedene Parameter in seinem Laufzeitverhalten beeinflußen.  Solche Parameter werden in Form von Java™-Eigenschaften als Teil des Kommandos oder eingebettet in eine Start-Datei mit angegeben.

Java™-Eigenschaften werden auf die folgende Weise 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:

• Port - muß angegeben werden
• Ziel - muß angegeben werden
• Logbuch

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 ...

Der Wert der 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 ...

Der Wert der 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ß der Wert der Java™-Eigenschaft genRob.genGate.log bestimmte Schlüsselworte enthalten.

Folgende Schlüsselworte gibt es:

• connect - Verbindungsverarbeitung,
• directories - Verzeichnisdienst-Zugriff,
• 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 den Wert der Eigenschaft leer (genRob.genGate.log=), so ist das gleichbedeutend mit dem Weglassen der Eigenschaft.