Parameterübersicht

icm/server_port_<xx>

Einstiegspunkt für Requests, Protokolle, Timeouts, etc.

Diesen Parameter müssen Sie pflegen.

Zeichenkette

-

wdisp/auto_ refresh

Zeitspanne, nach der periodisch die Route-Informationstabellen des SAP Web Dispatchers (Servertabelle, Gruppentabelle und URL Mapping-Tabelle) aktualisiert werden.

Der Parameter definiert auch die Frequenz der ping-Requests an die Applikationsserver (s.u.).

Sekunden

25

wdisp/info_ timeout

Timeout für die Abfrage von Konfigurationsdaten bei den Applikationsservern. Bekommt der Web Dispatcher in dieser Zeitspanne keine Antwort, fragt er den nächsten Server.

Der Parameter definiert auch den Timeout für die ping-Requests an die Applikationsserver (s.u.).

Sekunden

180

wdisp/max_ servers

Dieser Parameter bestimmt die maximale Anzahl von Einträgen in der Server-Tabelle des SAP Web Dispatchers.

ganze Zahl (zwischen 64 und 4096)

100

wdisp/max_ server_name_len

Dieser Parameter spezifiziert die maximale Länge eines Eintrags in der Server-Tabelle des SAP Web Dispatchers, d.h. die maximale Länge eines Instanznamens (Profilparameter rdisp/myname der einzelnen Server).

ganze Zahl (zwischen 32 und 128)

64

wdisp/max_ server_groups

Dieser Parameter bestimmt die maximale Anzahl von Einträgen in der Gruppen-Tabelle des SAP Web Dispatchers.

ganze Zahl (zwischen 32 und 4096)

128

wdisp/max_ server_group_ name_len

Dieser Parameter spezifiziert die maximale Länge eines Eintrags in der Gruppen-Tabelle des SAP Web Dispatchers.

ganze Zahl (zwischen 20 und 64)

20

wdisp/max_ url_map_ entries

Mit diesem Parameter legen Sie die maximale Anzahl von Einträgen in der URL-Mapping-Tabelle des SAP Web Dispatchers fest.

ganze Zahl (zwischen 100 und 10000)

300

wdisp/max_ url_map_ path_len

Der Parameter bestimmt die maximale Pfadlänge in der URL-Mapping-Tabelle des SAP Web Dispatchers.

ganze Zahl (zwischen 100 und 2048)

256

wdisp/server_ info_location

Angabe, woher der SAP Web Dispatcher die Information über die Applikationsserver bekommt, an die er die Web Requests verteilen kann.

Der SAP Web Dispatcher bezieht seine Serverinformation vom Message-Server. Der Parameter gibt die (relative) URL an, wo diese Information im Message-Server steht.

Zeichenkette

/msgserver/text/ logon?version=1.2

wdisp/group_ info_location

Angabe, woher der SAP Web Dispatcher die Information über die Servergruppen bekommt, an die er die Web Requests verteilen kann.

Die Angabe erfolgt über eine (absolute oder relative) URL.

Normalerweise bezieht der SAP Web Dispatcher seine Gruppeninformation von einem Applikationsserver. In diesem Fall können Sie den ICF-Service angeben, wo die Gruppen hinterlegt sind.

Wenn kein Applikationsserver mit ICF (ABAP) verfügbar ist, können Sie diese Information auch in einer Datei hinterlegen. In diesem Fall können Sie mit diesem Parameter den Dateipfad angeben, indem Sie ihn auf file:// <path> setzen.

Zeichenkette

/sap/public/ icf_info/ icr_groups

wdisp/url_ map_location

URL, unter der der SAP Web Dispatcher die URL Mapping Info findet.

Pfad im HTTP-Servicebaum der Applikationsserver (AS ABAP).

Wenn kein Applikationsserver mit ICF (ABAP) verfügbar ist, können Sie diese Information auch in einer Datei hinterlegen. In diesem Fall können Sie mit diesem Parameter den Dateipfad angeben, indem Sie ihn auf file:// <path> setzen.

URL-Pfadname

/sap/public/ icf_info/icr_ urlprefix

wdisp/system_ <xx>

Dient zur Konfiguration des Web Dispatchers für mehrere Backendsysteme.

Weitere Informationen: wdisp/system_<xx>

wdisp/server_ info_protocol

wdisp/group_ info_protocol

wdisp/url_ map_protocol

wdisp/ping_ protocol

Protokoll, das der SAP Web Dispatcher für die Kommunikation mit dem Message-Server bzw. den Applikationsservern zum Austausch der Metadaten (Serverliste, Logon-Gruppen, URL-Mapping) bzw. zur Durchführung der ping-Requests an die Applikationsserver verwenden soll.

Mit HTTPS können Sie diese Kommunikation sicher machen.

Weitere Informationen: Metadatenaustausch über SSL einrichten .

Protokollname, mögliche Werte: http oder https

http

wdisp/enable_ j2ee_groups

Logongruppen für den AS Java erlauben.

Wahrheitswert

FALSE

wdisp/J2EE/ group_info_ location

URL, unter der der Web Dispatcher die Information über die Logon-Gruppen im AS Java bekommt.

URL-Pfadname

/J2EE/icr_ groups

wdisp/J2EE/ url_map_location

URL, unter der der SAP Web Dispatcher die URL Mapping Info für den AS Java findet.

URL-Pfadname

/J2EE/icr_ urlprefix

wdisp/ping_ abap_url

URL, die der SAP Web Dispatcher für ping-Requests verwendet - für ABAP-Server, Java-Server und externe Systeme

Die mit diesen Parametern konfigurierbaren Ping-Requests dienen dem Health Check der Instanzen.

Der angegebene Request wird periodisch an jeden Applikationsserver (d.h. an jede Instanz) geschickt. Wenn der angegebene Request für einen Server nicht innerhalb einer definierten Zeit eine positive Antwort (HTTP Status Code 200 (OK)) liefert, dann wird dieser Server aus dem Web Dispatcher Load Balancing entfernt. Wie oft ein Request an jede Instanz geschickt wird, können Sie über den Parameter wdisp/auto_refresh (s.o.) konfigurieren. Die erlaubte Zeit bis zum Erhalt der Antwort lässt sich über Parameter wdisp/info_timeout konfigurieren.

Weitere Informationen: SAP Web Dispatcher für mehrere Systeme

URL-Pfadname

/sap/public/ icman/ping

wdisp/ping_ java_url

-

wdisp/ping_extsrv_url

wdisp/permission_ table

Absoluter oder relativer Pfad zur URI-Permission-Tabelle. Im Abschnitt SAP Web Dispatcher als URL-Filter sind noch weitere Profilparameter zur Konfiguration der URI-Permission-Tabelle beschrieben.

Zeichenkette (Dateipfad)

wdisp/shm_ attach_mode

Dieser Parameter legt fest, was mit den Shared Memorys des SAP Web Dispatchers passieren soll. Die möglichen Werte und ihre Bedeutung entsprechen den Werten der Startoption -shm_attach_mode des Web Dispatchers und sind im Abschnitt SAP Web Dispatcher starten beschrieben.

Wird die Kommandozeilenoption beim Starten explizit auf einen anderen Wert gesetzt, ist dieser Wert maßgeblich; der Parameterwert wird dann überschrieben.

Ganze Zahl zwischen 1 und 7

6

wdisp/HTTP/ use_pool_for_ new_conn

Aktivieren des Connection Poolings auch für neue Browserverbindungen. Hat der Parameter den Standardwert FALSE , wird das Connection Pooling nur für wieder verwendete (keepalive) Verbindungen zum Browser verwendet.

Beachten sie die Voraussetzungen für die Aktivierung des Parameters im Abschnitt Connection Pooling .

Wahrheitswert (TRUE,1, FALSE,0)

FALSE

wdisp/HTTP/ max_pooled_con

Dieser Parameter bestimmt die maximale Anzahl von HTTP-Verbindungen im Connection Pool vom SAP Web Dispatcher zu einem Applikationsserver.

Die Default-Einstellung muss normalerweise nicht geändert werden!

Anzahl Verbindungen

abhängig von der Dimensionierung, die beim bootstrap oder der Installation mit SAPInst getroffen wird

wdisp/HTTP/ min_pooled_con

Minimale Anzahl von HTTP-Verbindungen, die im Connection Pool des SAP Web Dispatchers pro Applikationsserver gehalten werden. Diese Anzahl von Verbindungen wird schon gehalten, bevor der erste HTTP-Request hereinkommt.

Anzahl Verbindungen

2

wdisp/HTTPS/ dest_logon_group

Siehe SSL-Parameter für den Web Dispatcher

wdisp/HTTPS/ sticky_mask

wdisp/HTTPS/ max_client_ ip_entries

wdisp/HTTPS/ context_timeout

wdisp/HTTPS/ max_pooled_con

wdisp/HTTPS/ min_pooled_con

wdisp/ssl_ encrypt

wdisp/ssl_auth

wdisp/ssl_cred

wdisp/ssl_ certhost

wdisp/load_ balancing_ strategy

Loadbalancing-Strategie des SAP Web Dispatchers.

Weitere Informationen: Serverauswahl und Lastausgleich durch den SAP Web Dispatcher

Loadbalancing-Strategie

Mögliche Werte:

weighted_round_robin

simple_weighted_round_robin

adaptive

weighted_ round_robin

wdisp/max_ permitted_ uri_len

wdisp/permitted_ uri_char_range

wdisp/max_ permission_ table_size

wdisp/max_ permission_ table_entry_size

Parameter zur Konfiguration des SAP Web Dispatcher als URL-Filter

wdisp/add_ xforwardedfor_ header

Der Parameter bestimmt, ob der SAP Web Dispatcher im Headerfeld x-forwarded-for die IP-Adresse des Clients dazufügt. Damit kann die Anwendung im Applikationsserver die Route auslesen, die der Request genommen hat. Hat der Parameter den Wert false , lässt der Web Dispatcher das Headerfeld unverändert.

Wahrheitswert ( true oder false )

false

wdisp/add_ client_protocol_ header

Der Parameter bestimmt, ob das Protokoll zwischen Browser und Web Dispatcher (HTTP oder HTTPS) dem Applikationsserver mitgeteilt wird.

Diese Info wird durch das Headerfeld clientprotocol übermittelt.

Der Applikationsserver benötigt diese Information, wenn es einen Protokollwechsel am Web Dispatcher gibt, zur Generierung von absoluten URLs (dem Headerfeld host kann er Host und Port des Web Dispatchers entnehmen).

Wahrheitswert ( true oder false )

false

wdisp/handle_ webdisp_ap_ header

Mit diesem Parameter teilt der Web Dispatcher seine Ports (Access Points) für die unterschiedlichen Protokolle dem Applikationsserver in einem HTTP-Header mit. Im Applikationsserver kann nun ohne manuelle Konfiguration ein Protokollwechsel (z.B. von HTTP nach HTTPS) oder ein Redirect programmiert werden.

Das Headerfeld, das vom Web Dispatcher gesetzt wird, hat folgende Syntax:

x-sap-webdisp-ap: http= <port> , https= <port> , <protocolXYZ> = <port>

z.B.:

x-sap-webdisp-ap: http=80,https=443

x-sap-webdisp-ap: http=80

Ganze Zahl zwischen 0 und 3; die Werte haben folgende Bedeutung:

0: keine Aktion (altes Verhalten)

1: Headerfeld mit eigenen Erreichbarkeitsinfos setzen (wenn vorhanden wird das Feld ersetzt)

2: Headerfeld setzen, wenn nicht bereits vorhanden

3: Headerfeld löschen, wenn vorhanden

0

wdisp/enable_ sap_hostid

Wenn dieser Parameter den Wert true hat, kann mittels Formfeld sap-hostid in der Request-URI eine Server-Destination explizit angegeben werden, um das Loadbalancing explizit zu übersteuern.

Die wird z.B. für das Debugging von Serverknoten oder zu Testzwecken benötigt.

webdisp.wdf.sap.corp:4711/sap/public/icman/ping?sap-hostid=binmain_BIN_53

Wahrheitswert ( true oder false )

false

wdisp/redispatch_ foreign_sessions

Falls dieser Parameter den Wert true hat, versucht der Web Dispatcher für fehlgeschlagene stateful Requests (fehlerhaftes Session-Cookie oder Ziel-Server nicht erreichbar oder Logongruppe nicht erreichbar) via stateless-Loadbalancing eine alternative Server-Destination zu finden.

Dies hat folgende Vorteile:

• Das jeweilige Backend (AS Java, AS ABAP) gibt „sprechendere“ Fehlerseiten zurück (etwa „Bitte erneut anmelden“ ), der Web Dispatcher bleibt also für den Anwender transparent.

• Ein echtes Session-Failover wird ermöglicht, falls das jeweilige Server-Backend in der Lage ist, „fremde“ Sessions zu übernehmen.

Wahrheitswert ( true oder false )

true

wdisp/HTTP/ esid_support

wdisp/HTTP/ jsessionid_ tab_support

wdisp/HTTP/ max_session_ tab_logon_ groups

wdisp/HTTP/ max_session_ tab_entries

wdisp/HTTP/ context_timeout

Diese Parameter dienen zur Konfiguration des Session-Dispatchings. Die Beschreibung finden Sie im Abschnitt Parametereinstellungen für Session-Dispatching .