icm/server_port_<xx> (SAP-Bibliothek - Architektur des SAP Web Application Servers)

icm/server_port_<xx>

Verwendung

Mit diesem Parameter wird der für ein Protokoll zu benutzende Service/Port spezifiziert. Es kann der Servicename oder die Portnummer angegeben werden.

Zusätzlich können optional weitere Eigenschaften des Services festgelegt werden. Diese sind in der Vorgehensweise beschrieben.

Voraussetzungen

Es muss mit dem Parameter icm/plugin_<xx> ein Plugin für das Protokoll angegeben sein, sonst kann der Service nicht gestartet werden. Mehrere Services können nicht auf einen Port gebunden werden. Ein Service kann auch nicht gestartet werden, wenn bereits ein anderes Programm den Port/Service benutzt.

Vorgehensweise

Das verwendete Protokoll und der Servicename bzw. die Portnummer müssen angegeben werden.

Weitere optionale Angaben sind im Folgenden beschrieben.

Timeout

Wird bei stehenden Verbindungen über einen bestimmten Zeitraum keine Kommunikation mehr betrieben, so wird die Verbindung geschlossen (siehe auch icm/keep_alive_timeout). Der Zeitraum wird mit dem dritten Parameterwert <keep alive timeout> (in Sekunden) angegeben. Kein Timeout wird mit -1 gesetzt.

Wertebereich	Einheit	Defaulteinstellung
10 - 32000	Sekunden	30

Das Zeitlimit gilt für folgende Fälle:

Die Zeit zwischen dem Erhalt von TCP-Paketen bei Anfragen
Die Zeit zwischen den Bestätigungen von TCP-Paketen, die als Antwort vom Server geschickt werden.

Je nach Netzwerkanbindung (intern, LAN, WAN) kann es sinnvoll sein, diesen Parameterwert zu erhöhen, jedoch sollte der Wert nicht kleiner als 10 Sekunden sein. Bei einem zu hoch eingestelltem Parameterwert kann der Durchsatz des Servers durch extrem langsame Netzwerkverbindungen deutlich sinken.

Externes Bindeprogramm verwenden

Für das Binden von Ports < 1024 auf UNIX wird dieser Parameter um die (optionale) Angabe EXTBIND=1 erweitert (siehe Binden von Ports < 1024 auf UNIX).

Port nicht an alle Rechnernamen binden

Mit dem optionalen Parameter HOST=<Rechnername oder IP-Adresse> kann spezifiziert werden, dass der Port nicht an alle Rechnernamen gebunden werden soll (Standard), sondern nur an den angegebenen.

X.509 Zertifikate

Mit dem optionalen Parameter VCLIENT kann bei der Verwendung von SSL spezifiziert werden, ob der Client ein X.509 Zertifikat vorweisen muss oder nicht. Es gibt insgesamt drei Stufen der Verifikation (0-2):

0: Es ist kein Zertfikat notwendig und der Server fordert auch keines an.
1: Der Server fordert den Client zur Übermittlung eines Zertifikates auf. Schickt der Client kein Zertifikat, wird die Authentifizierung auf eine andere Art (z.B. Basic) durchgeführt (Defaulteinstellung).
2: Ein Client muss ein gültiges Zertifikat an den Server übermitteln, andernfalls wird der Zugriff verweigert.

Dieser serverspezifische Wert übersteuert den mit dem Parameter icm/HTTPS/verify_client eingestellten Wert.

Wertebereich

Einheit

Defaulteinstellung

PROT=<Protokollname>, PORT=<Port oder Servicename>[, TIMEOUT=<keep alive timeout, EXTBIND=1, HOST=<Rechnername>, VCLIENT=<SSL Client Verifikation>]

PROT=HTTP, PORT=8080, TIMEOUT=15

PROT=SMTP, PORT=80, TIMEOUT=45, EXTBIND=1, HOST=prd.sap.de

PROT=HTTPS, PORT=443, TIMEOUT=15, VCLIENT=0

Zeichenkette

Hinweis

Dieser Parameter sieht für das Binden von Ports < 1024 auf UNIX folgendermaßen aus:

icm/server_port_<xx> = PROT=<Protokoll>, PORT=<Port>, [TIMEOUT=<timeout>,] EXTBIND=1 [, HOST=<Rechnername>]