Install WorkZone Mass Dispatch

The manual installation procedure for WorkZone Mass Dispatch depends on whether you install Mass dispatch in a single-server or multi-server environment.

Important: In a WorkZone environment with multiple servers, you must only install WorkZone Mass Dispatch on one server because mass dispatch processes must be started and completed on the same server. Install WorkZone Mass Dispatch on one server under the Default Web Site, and make sure that the MassDispatchServiceUrl parameter in the wzp_settings table is configured to point to this server. If you want to use HTTPS, you need a certificate on the server that you install WorkZone Mass Dispatch on.

  • You must run WorkZone Mass Dispatch under the WorkZone Process service account. See Service accounts.
  • By default, WorkZone Mass Dispatch is disabled after the installation. You enable it in WorkZone Configurator. Go to Global > Feature settings, select Mass Dispatch, and click Save.

Single-server environment

  1. Copy the KMD.WorkZone.MassDispatch.Setup.msi file to your computer.
  2. Execute the following command as administrator:

    3. msiexec /i <Path to the location of the msi file> ServiceDomain="<Domain>" ServiceUserName="sa_wzprocess" ServicePassword="<Password of the service user>"

    For example:

    msiexec /i C:\Users\testadmin\Desktop\KMD.WorkZone.MassDispatch.Setup.msi ServiceDomain="LMDOM" ServiceUserName="sa_wzprocess" ServicePassword="WZP"

Multi-server environment

Prerequisites:

  • Ensure that HTTP/HTTPS (port 80/443) traffic is allowed from the web servers to the server where WorkZone Mass Dispatch is installed.

  • If you use HTTPS, a server certificate is needed on the server where WorkZone Mass Dispatch is installed.

  1. Copy the KMD.WorkZone.MassDispatch.Setup.msi file to your computer.
  2. Execute the following command as administrator:

    3. msiexec /i <Path to the location of the msi file> SiteName="Default Web Site" ServiceDomain="<Domain>" ServiceUserName="sa_wzprocess" ServicePassword="<Password of the service user>"

    For example:

    msiexec /i C:\Users\testadmin\Desktop\KMD.WorkZone.MassDispatch.Setup.msi SiteName="Default Web Site" ServiceDomain="LMDOM" ServiceUserName="sa_wzprocess" ServicePassword="WZP"

Configure WorkZone Process to use the WorkZone Mass Dispatch service in a multi-server environment

For WorkZone Process to use the WorkZone Mass Dispatch service, you must configure the Process parameter named MassDispatchServiceUrl to point to the URL of the service. Currently, you can set the parameter in the wzp_settings table using ScanSql.

Before you set the parameter, make sure it doesn't already exist. You can, for example, delete the parameter before you insert it.

DELETE from wzp_settings where module = 'WorkZone' and key = 'MassDispatchServiceUrl';

And then insert the parameter:

INSERT into wzp_settings(row_id, module, key, value,type) values (wzp_settings$row_id.nextval, 'WorkZone', 'MassDispatchServiceUrl', 'https://<server name>/MassDispatch', 'URL');

Where <server name> is the fully qualified server name of the server that WorkZone Mass Dispatch is installed on.

Mass Dispatch access codes

You need to apply one or both of the two access codes below to users who will work with mass dispatch.

  • Apply the MASSDISPATCH access code to users who should be able to start a mass dispatch.
  • Apply the MASSDISPATCHSEND access code to users should be able to execute the actual mass dispatch.