Show TOC

Procedure documentationStarting the SAP Web Dispatcher Locate this document in the navigation structure

Procedure

You start the SAP Web Dispatcher with the command:

sapwebdisp pf=<profile name> [-f <trace file> -t <trace level> -cleanup -shm_attach_mode <mode> -auto_restart -version]

The optional parameters have the following meaning:

  • You can use -f to determine the name of the trace file. Default is dev_webdisp.

  • You can use option -t to set the trace level.

  • -cleanup means that common resources (shared memory and so on) are released. This is necessary if the SAP Web Dispatcher ran was not stopped in an orderly manner the last time it ran, but was terminated by a crash.

  • -shm_attach_mode <mode> determines what should happen to the shared memory of the SAP Web Dispatcher. Here, <mode> is a number that is a combination of the following values (bit mask):

    1: Delete the shared memory of the SAP Web Dispatcher (“cleanup”)

    2: Try to connect to the shared memory (“attach”)

    4: Create a new shared memory (“create”)

    This results in the following possible options:

    <mode>

    Meaning

    1

    The shared memory is cleaned up and the SAP Web Dispatcher terminates. The behavior is the same as with the option –cleanup.

    2

    The SAP Web Dispatcher connects to the existing shared memory (attach). If this does not exist, the SAP Web Dispatcher ends with an error.

    3

    Not useful

    4

    The SAP Web Dispatcher creates a new shared memory. If this exists already, the SAP Web Dispatcher ends with an error.

    5

    If a shared memory exists already, it is deleted. A new shared memory is then created.

    6

    The Web Dispatcher attempts to attach itself to an existing shared memory. If a shared memory does not exist, a new one is created. This is also the default value, and the SAP Web Dispatcher behaves like this if options -shm_attach_mode <mode> and -cleanup are not used, and parameter wdisp/shm_attach_mode is not explicitly set to another value.

    7

    wie 5

    Note Note

    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.

    End of the note.

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

Example Example

Normalerweise starten Sie den SAP Web Dispatcher wie folgt:

sapwebdisp pf=<Name des Profils>

Sie können den SAP Web Dispatcher auch ohne Profil starten, indem Sie die Bootstrap-Option verwenden..

End of the example.
SAP Web Dispatcher als Windows-Service einrichten

Unter Windows können Sie den SAP Web Dispatcher als Service starten. Er wird dann immer beim Neustart des Rechners automatisch gestartet.

Rufen Sie hierzu folgendes auf:

ntscmgr install sapwebdisp -b <path>\sapwebdisp.exe -p "service pf=<Profildatei> <options>"

<path> steht hierbei für die Pfad im Dateisystem, wo das Programm liegt, <options> für weitere Parameter wie oben beschrieben. Wenn der Pfad Leerzeichen enthält, müssen Sie ihn in Anführungszeichen setzen (z.B. ... -b "C:\Program Files\sapwebdisp.exe" ...).

Sie sehen dann den SAP Web Dispatcher sapwebdisp in der Liste der Services.

Note Note

ntscmgr ist ein SAP-Programm, das auf dem Rechner installiert sein muss. Details dazu finden Sie in SAP-Hinweis 618053.

Falls Sie Probleme haben, weil Microsoft-DLLs fehlen, beachten Sie dazu SAP-Hinweis 684106.

End of the note.