Enterprise Connector Configuration Guide

Richard Support -

Overview

The Workspot Enterprise Connector (or simply Connector) is software that runs as a service on a Windows Server machine in the datacenter that integrates Workspot Control with your Active Directory (AD) server. The Enterprise Connector communicates with Workspot Control on an outbound HTTPS connection (port 443)

Prerequisites

  1. Run the Connector service in an isolated VM - do not install any other connector or services that may consume resources.
  2. Server requirements for Connector:
    • Windows Server 2008 R2 or later.
    • Member of the Windows domain.
    • Minimum of 4 GB of memory (the Connector 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 Connector on the domain controller.
  3. The server machine must have an outbound connection over HTTPS on port 443 to:
  4. Connector requires the Java Runtime Environment.
    • Workspot recommends Azul Zulu OpenJDK 8.
    • Workspot also supports Oracle Java JRE 8 (Offline 64-bit for Windows).
      • If you install Oracle Java, 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"
  5. Windows PowerShell 2.0 or above, available by default with Server 2008 and higher.
  6. A domain account with admin privileges to install the Connector. 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 Connector.
  7. Create a service account in Active Directory and add the user account to the local administrator group of the Connector server.
    • For production installations, grant the Connector 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 Connector service will be able to start.

Configuring and Installing the Workspot Enterprise Connector

To configure and install the Workspot Enterprise Connector:

  1. Log in as an administrator to the domain-joined server where the Connector will be installed.
  2. From this server, use a browser to sign into Workspot Control as an Administrator. If using a Microsoft browser, disabling enhanced mode temporarily may be necessary to allow you to login or download the Connector.
  3. Create the connector configuration: Go to Setup > Datacenter > Add Datacenter. Enter a Name for the configuration, in this example, "US Datacenter".
    Name this Datacenter

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

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

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

  7. In Services, verify that the Workspot Enterprise Connector service is running
  8. Returning to your browser's Workspot Control tab, 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

  9. Add Configuration is now enabled.
    Connector Available

Troubleshooting

  • If errors occur during installation and setup, see: c:\ProgramData\workspot\setup.txt.
  • If Connector doesn't seem to be running, start it in Services.
  • If errors occur while Connector is running, see the log file in: C:\Program
    Files\Workspot_Enterprise_Connector\log.

 

Have more questions? Submit a request

Comments

Powered by Zendesk