Inbetriebnahme des SAP Web Dispatchers (SAP-Bibliothek - Architektur des SAP Web Application Servers)

Inbetriebnahme des SAP Web Dispatchers

Verwendung

Im Folgenden wird beschrieben, wie Sie den SAP Web Dispatcher starten und stoppen, und welche Voraussetzungen Ihr System erfüllen muss, dass Sie den SAP Web Dispatcher einsetzen können.

Die Verwendung des SAP Web Dispatchers ist unter SAP Web Dispatcher beschrieben.

Voraussetzungen

Voraussetzungen für die Inbetriebnahme des SAP Web Dispatchers sind:

SAP Web AS 6.20 mit 6.20-Kernel

Der HTTP-Port für den SAP Message-Server ist konfiguriert (Profilparameter ms/http_port)

eine Profildatei für den SAP Web Dispatcher (vgl. Beispiel: Profildatei eines SAP Web Dispatchers und Profilparameter des SAP Web Dispatchers)

Der SAP Web Dispatcher muss den HTTP-Port des SAP Message-Servers erreichen können

Folgende Services im HTTP Service-Baum (Transaktion SICF) müssen aktiviert sein:

/sap/public/icman

/sap/public/icf_info/*

(vgl. Anlegen eines ICF-Services und Aktivieren und Deavtivieren eines ICF-Services)

Vorgehensweise

Starten des SAP Web Dispatchers

Sie starten den SAP Web Dispatcher mit dem Kommando

sapwebdisp pf=<Name des Profils> [-f <tracefile> -t <tracelevel> -cleanup -shm_attch_mode <mode> -auto_restart -version]

Hierbei haben die optionalen Parameter die folgende Bedeutung.

-f können Sie verwenden, um den Namen der Trace-Datei festzulegen. Standard ist dev_webdisp.

Mit der Option -t können Sie den Tracelevel setzen.

-cleanup bewirkt, dass gemeinsame Ressourcen (Shared Memory,etc.) freigegeben werden. Dies ist notwendig, falls der SAP Web Dispatcher das letzte Mal nicht ordnungsgemäß gestoppt wurde, sondern durch einen Crash beendet wurde.

-shm_attch_mode <mode> legt fest, was mit den Shared-Memorys des SAP Web Dispatchers passieren soll. Hierbei ist <mode> eine Zahl, die als Kombination der folgenden Werte (Bitmaske) zu verstehen ist:

1: Shared Memorys des SAP Web Dispatchers löschen (cleanup)

2: Verbinden an das Shared Memory versuchen (attach)

4: Neues Shared Memory anlegen (create)

Hieraus ergeben sich folgende mögliche Werte:

1: Das Shared Memorys wird aufgeräumt (cleanup), anschließend beendet sich der SAP Web Dispatcher. Das Verhalten ist also dasselbe wie bei der Option von –cleanup.

2: Der SAP Web Dispatcher verbindet sich mit dem bestehendes Shared Memory (attach). Existiert dies nicht, beendet sich der SAP Web Dispatcher mit einem Fehler.

3: nicht sinnvoll

4: Der SAP Web Dispatcher legt ein neues Shared Memory an. Existiert das Shared Memory bereits, beendet sich der SAP Web Dispatcher mit einem Fehler. Dies ist auch der Default-Wert, d.h. so verhält sich der SAP Web Dispatcher, wenn die Optionen -shm_attch_mode <mode> und -cleanup nicht verwendet werden.

5: Falls schon ein Shared Memory existiert, wird dieses gelöscht. Anschließend wird ein neues Shared Memory angelegt.

6: Es wird versucht, sich an ein bestehenden Shared Memory zu attachen. Existiert kein Shared Memory, so wird ein neues angelegt.

7: wie 5

Hinweis

Diese Einstellungen sind für die Verwaltung der SSL-Client-IP-Adressen interessant. Bei entsprechenden Einstellungen gehen diese Informationen im SHM nicht verloren, sondern können auch nach einem Absturz des SAP Web Dispatchers weiter verwendet werden. Siehe hierzu SAP Web Dispatcher und SSL.

-auto_restart: Mit dieser Option können Sie den SAP Web Dispatcher auf Prozessebene hochverfügbar machen. Das Vorgehen ist im Abschnitt Hochverfügbarkeit des SAP Web Dispatchers beschrieben.

-version zeigt die Version des SAP Web Dispatchers an. Das Programm wird nicht gestartet.

Beispiel

Normalerweise starten Sie den SAP Web Dispatcher wie folgt:

sapwebdisp pf=<Name des Profils>

Stoppen des SAP Web Dispatchers

Wollen Sie den SAP Web Dispatcher stoppen, so ermitteln Sie die PID und geben Sie folgendes Kommando ein: kill -2 <pid> (UNIX) bzw. sapntkill -2 <pid> (Windows NT).

Empfehlung

Die PID des SAP Web Dispatchers können Sie der Trace-Datei dev_webdisp im Work-Verzeichnis entnehmen.

Ergebnis

Der SAP Web Dispatcher wurde gestartet bzw. gestoppt.