Skip to content

Setup a cluster system#

Overview#

The process of setting up a cluster system with MiddleVR is the following:

  • Prepare all cluster nodes:
    • Install MiddleVR on all cluster nodes. This will install the MiddleVR Daemon and automatically open required firewall ports
  • Make sure your applications and configurations are accessible by all cluster nodes
    • Either by copying them on each cluster node
    • Or creating a shared folder connected on a network drive

Prepare all cluster nodes#

Install MiddleVR#

Install MiddleVR on all machines. At the end of the setup, make sure that "Startup folder" is checked. This will make sure the MiddleVR Daemon is automatically run at startup of windows.

Clicking on "Run Daemon" will start MiddleVR Daemon.

Make your application accessible to all cluster nodes#

Make sure your applications and configurations are accessible from all the computers of the cluster. The most common way is to use a Shared Folder. If you want to speed-up the loading of your apps, you might prefer doing a Local Copy.

Shared folder#

This technique makes updating apps easier because you only have to update in on the shared folder.

Prepare the cluster server#

  • Make sure the server has the correct license. Only the server requires a license. See Installing a license

Note: Make sure to activate the license on the computer that will be using the license. Any license that is not activated on the right computer will be necessitate a license regeneration fee.

  • Clients don't need to have any license

Run the test application#

  • On the server:
    • Copy the Outpost demo folder from C:\Program Files\Middlevr2\demo\demo_outpost to your shared network folder, for example to Z:\
    • Open MiddleVRConfig.exe
    • Go to the App panel
    • Add the Outpost demo from "Z:"
    • Add the configuration file from "Z:"
    • Press Run

Troubleshoot#

The support website has a lot of resources to help you troubleshoot your setup:

You can also submit a support request:

Advanced#

Firewall#

MiddleVR ports#

The MiddleVR installer should open the MiddleVR ports automatically.

MiddleVR communicates on:

  • TCP: 9995, 9997, 9998 and 9999
  • UDP: 9996, 9998
Network Devices#

Some tracking system communicate their data via network.

Only the cluster server connects to the devices, so there is no need to open those ports on cluster clients.

  • VRPN: UDP 3883

  • ART DTrack : UDP 5000

  • OptiTrack : UDP 1510-1511

  • Vicon : UDP/TCP 801

Local copy#

A local copy of the application on all cluster nodes at the exact same location. The goal is mainly to speed-up the loading process.

MiddleVR config can automatically synchronize a folder by using the Cluster Management - Sync Folder feature:

Creating a shared folder#

Windows 10#

Make sure Windows has file sharing enabled in Windows Settings > Managed Advanced Sharing Settings

Right-click on your folder, select Properties, go in the Sharing tab:

Click on "Advanced Sharing" and enable "Share this folder":

Windows 7#

Right-click on your folder and select "Share with":

Manually connecting a network drive#

Right click on your computer in the file explorer and selecting "Map a network driver":

Make sure to mount the folder with the same drive on all computers, including the server: