Cloud Connector Installation Guide

Cloud Connector Installation Guide

This document outlines the requirements and steps for installing the Cloud Connector on a Windows machine.

Prerequisites

  • Windows Server, accessible from the internet, with administrative privileges.

  • Public IP and port accessible from the internet.

  • Network access to all required internal integrations.

    • For example: If your Cloud Connector server is 192.168.1.50, and you have a MSSQL based integration @ 192.168.1.100, you would need a firewall rule of:

      • Source: 192.168.1.50

      • Destination: 192.168.1.100

      • Protocol: TCP

      • Port: 1433

    • So that the cloud connector service can access your MSSQL database.

  • Client ID (UUID) and RTVision Cloud Site Admin Credentials (provided via email).

Installation Steps

  1. Obtain the Installer

    • Download the Cloud Connector installer (.exe.zip) from here.

    • Unzip the file to get the installer.exe

    • You may encounter an “untrusted publisher” warning when running the executable. Bypass this prompt if it appears*

  2. Run the Installer as Administrator

    • Right-click the downloaded .exe file.

    • Select Run as Administrator.

  3. Configure the Connector

    • Name: Provide a name (e.g. cc1).

    • Client ID: Paste the UUID from your email.

    • IP and Port:

      • Specify the server IP and port for the Cloud Connector service to listen on.

        • If the server is assigned a private IP, also provide the public IP and port that it can be accessed from externally via NAT.

      • TCP/443 is recommended unless your server is already running a web server on that port.

    • Once all required fields are valid, the Next button appears (bottom-right corner).

  4. Authorize Each Site

    • On the subsequent screen, click Authorize for each site.

    • A set of options appears, letting you to navigate to the site by either:

      • Copying the site URL

      • Opening in browser

      • Scanning a QR code

    • Log in to each site with the admin credentials emailed alongside the Client ID, and authorize access.

  5. Complete the Setup

    • Once at least one site is authorized, the Next button reappears.

    • Clicking Next downloads, installs, and starts the Cloud Connector as a Windows service.

    • A successful installation will display a Running status as shown below

    image-20250321-201423.png

Note: The “untrusted publisher” prompt is temporary until the installer is signed with an EV certificate that is working on to be obtained.

Install ODBC Drivers (If Needed)

If a database connection is required, install a compatible ODBC driver (e.g., for SQL Server):

 

Inform us when completed

  • from here site setup is going need to be done by RTVision to have the integrations use the cloud connector