Parameterübersicht

Die folgende Tabelle gibt eine Übersicht über die Profilparameter des SAP Web Dispatchers.

Die Parameter, die auch für den Internet Communication Manager (ICM) gelten, sind unter Profilparameter für ICM und SAP Web Dispatcher beschrieben.

Parameter	Bedeutung	Einheit	Default-Wert
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. Die Logon-Gruppen werden in der Transaktion `SMLG` gepflegt.	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. Sie können 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	`/msgserver/text/logon`
`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 (Transaktion SMLG). 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. Normalerweise ist das ein Pfad im http-Servicebaum der Applikationsserver (Transaktion SICF). 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>	Zeichenkette	-
`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.	Protokollname, mögliche Werte: `http` oder `https`	`http`
`wdisp/enable_j2ee_groups`	Logongruppen für den AS Java erlauben (vgl. Configuring Logon Groups on AS Java) Achtung Die Logongruppen für AS Java funktionieren nur in Java-only-Systemen! Ende der Warnung.	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. Achtung Wird die Kommandozeilenoption beim Starten explizit auf einen anderen Wert gesetzt, ist dieser Wert maßgeblich; der Parameterwert wird dann überschrieben. Ende der Warnung.	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. Achtung Beachten sie die Voraussetzungen für die Aktivierung des Parameters im Abschnitt Connection Pooling. Ende der Warnung.	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 Defaulteinstellung muss normalerweise nicht geändert werden!	Anzahl Verbindungen	`32768`
`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
`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, vgl. 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: Syntax x-sap-webdisp-ap: http=<port>, https=<port>, <protocolXYZ>=<port> Ende des Codes 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` Achtung Da mit diesem Formfeld das Server-Loadbalancing beliebig ausgehebelt werden kann (Denial-of-Service-Attacken), ist dieses Verhalten standardmäßig ausgeschaltet und muss mittels obigem Parameter explizit aktiviert werden. Ende der Warnung.	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. Beispiel Der Web Dispatcher erhält einen Request für eine Logongruppe "WEB", es ist aber kein Server der Gruppe "WEB" erreichbar. Dann versucht der Web Dispatcher einen alternativen Server unter allen erreichbaren Servern zu finden und leitet den Request dorthin weiter. Sie können dieses Verhalten unterdrücken, indem Sie den Parameter auf `false` setzen. Dann gibt der Web Dispatcher in diesen Fällen einen Fehler zurück. Ende des Beispiels.	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.