Skip to content

Plan for worker installation

In zervicepoint terms, the "Worker" is a summary of the zervicepoint systems Client Web Service, Provisioning System and Provisioning Inventory System installed on a server in a on-premises environment.

List of prerequisites for Zervicepoint Worker

  • Windows Server (2016/2019/2022)
  • Service Account(s)
  • DNS entry for ClientWebService
  • SSL Certificate for ClientWebService

OS requirements

  • Windows Server 2016
    • Standard or Datacenter
  • Windows Server 2019
    • Standard or Datacenter
  • Windows Server 2022 (Recommended)
    • Standard or Enterprise

Windows Features requirements

The following Windows features should be installed on the server:

Add-WindowsFeature -Name @(
    'Net-Framework-45-Core',
    'Web-Server',
    'Web-Log-Libraries',
    'Web-Request-Monitor',
    'Web-Net-Ext45',
    'Web-Windows-Auth',
    'Web-Asp-Net45',
    'Web-ISAPI-Ext',
    'Web-ISAPI-Filter',
    'Net-WCF-HTTP-Activation45',
    'Web-Mgmt-Console'
)

Service Accounts

You can use either a local or domain service account. We recommend using a domain service account in order to easily authenticate with Active Directory.

The service account for ClientWebService should have "read" related permissions to systems it integrates with, while the ProvisioningSystem service should have read/write.

Service account for Client Web Service

  • Local or domain account (i.e svc-zp-cws)
  • Permissions
    • Log on as service on the worker server
    • Full control permissions to client web service data signing certificate

Service account for Provisioning System service

  • Local or domain account (i.e svc-zp-ps)
  • Permissions
    • Local Administrator

Network

Allow the following network traffic

Protocol Origin Destination Port
TCP Worker server portal.zervicepoint.com 443, 9900, 20000, 30000
TCP Client Worker server 443
TCP Client portal.zervicepoint.com 443, 20000

Verify that the customer clients and servers are able to access the Zervicepoint cloud environment

  • The server has internet access
  • The ports above has been configured
  • No proxy is blocking the clients and servers from reaching Zervicepoint cloud environment

Client web service

DNS record

  • A DNS host (A/AAAA/CNAME) record that points to the worker server, i.e. cws.example.com

SSL Certificate

SSL Certificate is required for Client Web Service.

  • Used by Client Web Service for encrypting communication (https)
  • Should have same common name as the DNS record for the worker server. (i.e cws.example.com)

This certificate must be installed in the Local Machine personal folder on the worker server prior to the installation wizard.

Configure Client Web Service URL

Set your Client Web Service URL in the Zervicepoint Admin Webl.

Go to Edit Store > Select Worker Authentication and then:

  1. Update Client Web Service Url

Replace cws.example.com with your chosen hostname for Client Web Service.

https://cws.example.com:443/ProviderService.svc/CallProvider
  1. Ensure Authentication method is assigned to Key.
  2. Save settings.

Next steps