Installing the SAP Web Dispatcher

Edit online

You can install the SAP Web Dispatcher either stand-alone or you can integrate it into ASCS.

SAP recommends the traditional SAP Web Dispatcher stand-alone installation for the Web Dispatcher installation and for the installation of HA systems. The integration of a stand-alone Web Dispatcher into an HA system is explained in detail here.

The optional Web Dispatcher installation with integration in ASCS is available with SWPM 1.0 SP 24. It is possible but not recommended in HA systems. The *SAPSRV add-on policy does not support an ASCS-integrated installation of the Web Dispatcher out-of-the-box. Manual modification to the policy is required.

See SAP Note 908097: SAP Web Dispatcher: Release, Installation, Patches, Documentation for additional information regarding the Web Dispatcher installation.

To install the SAP Web Dispatcher on z/OS UNIX System Services, you must use the ZSCSinst tool that is part of SAP’s Software Provisioning Manager (SWPM). For details and invocation of ZSCSinst, refer to the SAP Installation Guide.

To make the SAP Web Dispatcher highly available, you must install this SAP component with a virtual host name. Here is an example of a parameter file for ZSCSinst (you must enter the virtual host name as the value of the parameter HOSTNAME): 
SYSTYPE=WD
HOSTNAME=sapwd1wdv
SAPSID=WD1
MOUNTDIR=/sapmnt
KERNELCD=/common/sapdvds/SAP_NW740/51046681_2/SAP_Kernel_7.40_z_OS_64bit_j
         /DATA_UNITS/K_740_U_OS390_64
INSTANCENUMBER=77
WMSHOST=ha3scsv
WMSPORT=8130
WDHTTP=8177
ZSCSinst invocation for an SAP 740 SR2 Web Dispatcher installation with ZSCSinst configuration file WD.WD1: 
./zscsinst 740SR2 WD /u/wd1adm/SWPM/WD.WD1

Postinstallation steps

  • It is mandatory to follow the postinstallation steps as described in the ZSCSinst installation documentation.
  • Make sure that you use the minimum version of the SAP Web Dispatcher executables including the wdispmon executable. See Table 1 for the exact minimum levels and how to determine them.
  • Configure the stand-alone SAP Web Dispatcher to manage more than one SAP system. For details about the multi-system capability of the SAP Web Dispatcher, refer to the SAP online help and search for topic SAP Web Dispatcher for Multiple Systems.
  • For details about the architecture of the SAP Web Dispatcher and its high availability capabilities, search in the SAP online help for topic High Availability of the SAP Web Dispatcher. The SA z/OS *SAPSRV add-on policy implements the option High Availability of SAP Web Dispatcher with External HA Software that is mentioned in the SAP documentation.

    The recommendation is not to use the restart capability (via profile parameter Restart_Program_XX) that is mentioned on this web page. This is because the *SAPSRV add-on policy needs to restart the health check function wdispmon whenever the SAP Web Dispatcher is restarted (see SAP Web Dispatcher health checking).