Enterprise Connector Configuration Guide

Richard Support -


The Workspot Enterprise Connector (EC) is software that runs as a service on a Windows Server machine in the datacenter that integrates Workspot Control with on-premise resources. The Enterprise Connector communicates with Workspot Control on an outbound HTTPS connection (port 443). The following integrations are currently supported:


  1. A server machine on which to install the EC (IMPORTANT: It is recommended to run the Connector service in an isolated VM - do not install any other connector or services that may consume resources):
    •  Windows Server 2008 R2 or later. 
    •  Member of the Windows domain. 
    •  Minimum of 4 GB of memory (the EC will use ¼ of the available free memory or 1GB, whichever is less).
    •  250 MB of free disk space for installation and runtime usage.
    •  It is not recommended to install the EC on the domain controller.
  2. Server machine must have an outbound connection over HTTPS on port 443 to:
    •  Workspot Control <https://control.workspot.com>
    •  Amazon S3 <https://s3.amazonaws.com/a>>
  3. Download and install the Windows Offline 64-bit version (64-bit Java JRE 8) from the Java website at: http://www.java.com/en/download/manual.jsp.
    The latest executable is "jre-8u171-windows-x64.exe" at this writing.  After installing jre you should run this command line before installing the Enterprise Connector: mklink /D C:\ProgramData\Oracle\Java\javapath "C:\Program Files (x86)\Common Files\Oracle\Java\javapath"
  4. Windows PowerShell 2.0 or above, available by default with Server 2008 and higher.
  5. A domain account with admin privileges to install the EC. The installer will ask for admin privileges if run as non-admin. This domain account will also be used to create the service account necessary to run the EC.
  6. Create a service account in Active Directory and add the user account to the local administrator group of the EC server.
    • Before promoting to production, please grant the EC service account "Log on as a Service" rights via Group Policy.  This will ensure that the account does not lose this privilege in the future and the EC service will be able to start.

Configuring and Installing the Workspot Enterprise Connector

To configure and install the Workspot Enterprise Connector (EC), use the domain-joined server where the EC will be installed. Using a browser on that server, sign into Workspot Control as an administrator.

  1. Create the connector configuration: Go to Setup > Datacenter > Add Datacenter. Enter a Name for the configuration, in this example, "US Datacenter".
    Name this Datacenter

  2. Click on the name, "US Datacenter", to manage Configuration Integration Types.
    post-Add Datacenter

  3. Select and copy the Integration Key and save it for later use during the connector installation.
    Manage Datacenter, Add Connector

  4. Click the Download Connector button to download the Enterprise Connector installer. Launch the Workspot Enterprise Connector Installer, "Workspot_Enterprise_Connector_1.2.0.212.exe" at this writing. Enter the Integration Key; the domain name; the service account created previously in Active Directory and added to this machine's local administrators group; and the account's password. Click on Next >.
    Setup - Workspot_Enterprise_Connector Click on Finish.
    Setup - Workspot_Enterprise_Connector Finish

  5. In Workspot Control: Go to Setup > Datacenter to check the connector status. If installed and configured correctly, the status will show Available and Connected as shown below.
    US Datacenter Available

  6. Add Configuration is now enabled.
    Connector Available


If errors during installation and setup, see: c:\ProgramData\workspot\setup.txt
If errors while the connector is running, see the log file in: C:\Program

Have more questions? Submit a request


Powered by Zendesk