Skip to content

Volumetric Capture Setup

perukas edited this page Nov 7, 2019 · 36 revisions

This page describes how to setup the high-end workstation PC, in order to use the Volumetric Capture Application.

Workstation PC Specifications

  • CPU: Intel i7 7700K (or better)
  • RAM: 16 GB of RAM (or more)
  • GPU: Nvidia Geforce 960 (or better)
  • HDD: The Hard Disk Drive's capacity is not really an issue; it depends on the needs of each user. The recommended capacity is at least 1 TB of storage. However, a writing speed of 7200 rpm (or faster) is essential.
  • A 1Gbps (U/D) LAN Switch is needed, in order to achieve Workstation - Capturers (Intel NUCs) communication.

RabbitMQ Setup

The communication between the Workstation PC and the mini-PCs (Intel NUCs) is achieved by utilizing a RabbitMQ message broker. The following steps explain how to install and setup a RabbitMQ broker on the Workstation PC:

  • Download and install the Erlang Compiler, by choosing Windows x64 Binary file.

  • Download the RabbitMQ installation file from RabbitMQ webpage and install.

  • In order to estamblish communication between the different parts of the system, you will have to open port: 5672 on Windows Firewall.

    • Open Windows Start Menu and search for Control Panel
    • In Control Panel open Windows Defender Firewall
    • In the left panel select Advanced Settings
    • In the left panel of the window that poped-up select Inbound Rules
    • In the right panel that appeard select New Rule...
    • In the window that appeared select Port and hit Next
    • In Specific local ports text box type 5672 and hit next
    • In the next window leave the Allow Connection option selected and hit next
    • In the next window leave everything selected and hit next
    • In the next window you can add a name for the rule and a description, so as to know that you created that rule, and it's not a Windows default rule.
    • Repeat all the steps in order to create an Outbound Rule too, for the same port
    • The same rules for port 5672 must be added to each capturer PC (Intel-NUC) also.
  • Additionally, you will have to open outbound connections to port: 15672, (the same way as the previous step, but putting 15672 instead of 5672 as the port number), in order to use RabbitMQ's management interface. This is done by following the steps described above. You just have to create a new Inbound Rule for port 15672.

  • To enable RabbitMQ's management interface follow the instructions here

  • When the management plugin is enabled, you can use it by opening you web browser and typing localhost:15672. The default username and password are guest and guest respectively.

  • You will have to create a new user with username: volumetric and password: capture

    • In your favorite browser type: localhost:15672. The RabbitMQ's sign in screen will appear.
    • Sign in as a guest, with username guest and password guest.
    • Go to tab Admin
    • Go to Add user and type in the new user's username and password, which must be volumetric and capture respectivelly, and set the newly created user to be an Admin account.
    • When the new user is created, select the user from the users table in the same page, and click the Set Permissions button in the redirected page.
  • In order to achieve initial communication between the Volumetric Capture and Remote Eye applications, we use the Remote Eye Windows Service. This service runs in the background of the Capturer's mini-PCs, and listens to port: 11234 (UDP) in network's broadcast channel. Thus, you have to follow the steps above for creating inbound and outbound Windows Firewall rules, for all the PCs (workstation and mini-PCs) for port: 11234 (UDP).

Volumetric Capture Setup

To use the Volumetric Capture application:

  • Download the latest release of Volumetric Capture from the Releases section.
  • Extract the zipped folder in a directory of your choosing (e.g. C:/). Avoid using paths that include "spaces".
  • Create a shortcut of volumetric_capture.exe on your desktop if you want.
  • Just double click the volumetric_capture.exe (or the shortcut if you created one), and you are ready to go.

nPTP and PTPd Synchronization

In order to synchronize the devices with the nPTP and PTPd methods you should also allow UDP connections on port 320 (both incoming and outgoing) on the workstation's firewall as well as on the mini-PCs