Installing and Configuring a Gateway and Primary Broker for Thinfinity Workspace

How to Install and Configure a Gateway and Primary Broker on Separate Computers

Doc Type: How-to
Product: Thinfinity Workspace
Version: 7 and above


This document will guide you through the process of installing and configuring both a Gateway and a Primary Broker on separate hosts. 



1. Prerequisites

Gateway & Primary Broker Hosts

  • Windows x64 Bits Ver.: 8, 8.1, 10, 11.
  • Windows Server X64 Bits Ver.: 2003/8/12/12R2/16/19/22. 
  • CPU 4 Cores.
  • RAM 8 GB.

2. Installation

This type of layout requires installing the Thinfinity Workspace Gateway on one host and the Primary Broker on another host.
We will install the Gateway first and then the Primary Broker.

Gateway Installation

1. Obtain the latest Thinfinity Workspace installation file. Get it at https://www.cybelesoft.com/download/
2. Execute the installation file.
3. Navigate through the Welcome Screen. Click Next.
4. Read and accept the EULA agreement. Click Next.
5. You will be presented with three installation options. For the purposes of this guide, select the Reverse Gateway Only option. Then click Next.



All Components
This option is for a standalone installation. Both a Thinfinity Services and Gateway Services installation coexist on the same computer. This installation can also work together with others in a Scaling and Load Balancing configuration.

Broker and HTML5 Services
This option only applies if you are using a Scaling and Load Balancing configuration. A Thinfinity Services installation works with at least one gateway installation and one or more other Thinfinity Services installations.

Reverse Gateway Only
This option applies only if you are using a Scaling and Load Balancing configuration. A Gateway Services installation works together with two or more Thinfinity Services installations.

6. Specify the destination folder and click Next.



7. Click Install to begin the installation process.
8. When complete, click Finish to exit the installation wizard.



9. Now install the Primary Broker on another host using the same installation file you used for the Gateway.

Primary Broker Installation

Follow the same procedure as for the Gateway installation, but in step 5, Installation Options, select the Broker and HTML5 Services option, click Next, and continue with the remaining steps.



When installing the Gateway and Primary Broker separately, only the Primary Broker requires license registration.

10. When the Primary Broker installation is complete, open the Thinfinity Workspace Configuration Manager from the Start menu.
You will be prompted to register the Thinfinity Workspace Primary Broker.



You can find more information on how to register Thinfinity Workspace on the following links:

3. Configuration

After installing and registering the product, you must configure the Gateway and the Primary Broker independently.

Gateway Configuration

1. Launch Thinfinity Workspace Gateway.
2. In the General tab click the NetworkID button; copy or write down the NetworkID for use with the Primary Broker.



Primary Broker Configuration

3. Open Thinfinity Workspace Configuration Manager.
Enter the same NetworkID and click Add to specify the Gateway (IP : Port). Then click Apply.



The Gateway and Primary Broker are now installed, registered, and configured. You can begin creating connections, configuring security, and other features as needed.
If you have any further inquiries or need additional support, please do not hesitate to reach out to us. Our team is always available to help address any questions or concerns you may have.

    • Related Articles

    • How to Install a Gateway and Primary Broker on a Single Host

      Doc Type: How-to Product: Thinfinity Workspace Version: 7 and above This document will guide you through the process of installing both a Gateway and a Primary Broker on a single host. I. Prerequisites Gateway & Primary Broker Host Windows x64 Bits ...
    • How To Install a Secondary Broker

      Product: Thinfinity Workspace Versions: 7 and later Introduction In this document, we will guide you through the process of installing a Secondary Broker, a crucial component in building a resilient and scalable network infrastructure. Whether you ...
    • How to Configure and Connect a Secondary Broker

      Product: Thinfinity Workspace Versions: 7 and later Introduction In the Thinfinity Workspace environment, a Secondary Broker serves as an essential load-balancing and redundancy component. It delivers high availability and fault tolerance while ...
    • How to Publish a VirtualUI Application on a Secondary Broker

      Product: Thinfinity Workspace Versions: 7 and later Introduction In this document, we will guide you through the process of publishing a VirtualUI application on a Secondary Broker. Publishing VirtualUI applications on a Secondary Broker in ...
    • How to Install and Configure IIS as a Reverse Proxy with Thinfinity Workspace/VirtualUI

      Product: Thinfinity Workspace/VirtualUI Version: 7 and later Introduction This guide will walk you through the step-by-step process of installing and configuring Microsoft Internet Information Services (IIS) as a powerful Reverse Proxy Server in ...