Skip to main content
All CollectionsWeb Platform
T-Pro Device Controller - System Admin Installation Guide
T-Pro Device Controller - System Admin Installation Guide

Admin => This article provides installation information for the Device Controller, including virtual channel installations

Updated over a week ago

The Device Controller enables T-Pro applications to communicate with multiple external devices, e.g. footpedals and microphones.

Minimum Requirements

The following operational systems have been successfully tested by T-Pro. Other configurations might be possible but would require testing.

Server

Version

Microsoft Windows Server

2008 / 2012 / 2016

Client

Version

Microsoft Windows Home / Pro

10+

Standard Client Installation

  1. Download the T-Pro Device Controller Installer for Microsoft Windows from the following links:
    ​

    1. EMEA Customers
      ​

    2. APAC Customers
      ​

  2. After the download is complete, locate the file and open it. Be sure to grant the installer permission to run. The installation has the following steps.

    1. Welcome screen - click Next

    2. Select Installation options - select desired options

    3. Choose installation folder - it is recommended that the default is used, click next

    4. Start installing Device Controller - click Install

a) Welcome Screen

Click Next

b) Standard Installation Options

Confirm installation options and click Next

It is recommended that the default options are used:

  • Run Device Controller automatically after Windows start up.

    • Device Controller will start every time the user logs into Windows

  • Run Device Controller automatically after installation.

    • Device controller will start immediately after being installed, note that you will not see this, Device Controller opens in the System Tray only.

  • Open T-Pro Web in a headless browser (deselect to open in a normal tab).

    • Leave this unchecked if you want T-Pro to open in a separate tab in your browser.

    • Check this option if you want to open T-Pro in a headless browser, this will open T-Pro in a separate window that has none of the usual browser controls. This is a good option if you want to maximise the amount of screen space available to T-Pro.

  • Advanced options

    • These should only be selected by a network administrator, they are options for client and server installations when Device Connect is used in Remote Desktop setups. See the Advanced Installation and Troubleshooting Guide.

c) Choose the Installation Folder

Click Next

d) Start the Installation

Click Install

=> You will be prompted by Windows to allow the installation, click Yes when the following message is presented: ‘Do you want to allow this app to make changes to your device?’

Click Finish to complete the installation

=> Installation is complete, the installer will have placed either a T-Pro Web or a T-Pro Web Recorder icon on the desktop.

To check that Device Controller is running and what version is installed:

Open the system tray, then hover over the Device Controller icon.

Virtual Channel Installations

The virtual channel allows the Device Controller to pass commands from the local Windows client to the remote server via an RDP connection.

Virtual channel server

The server part of the Virtual Channel must be installed on the remote machine. To install TProVCServer, users can select the "Virtual channel server installation" checkbox.

This option will add the TProVCServer.exe to the installation folder. T-Pro Device Controller will be able to start the server on the app start-up.

Virtual channel plugin

The plugin part of the Virtual Channel must be installed on the local machine. To install TProVC-Plugin, users can select the "Virtual Channel Plugin" checkbox.

This option will add the TProVC-Plugin-x86.dll or TProVC-Plugin-x64.dll (depending on Windows bitness) to the installation folder and register the .dll files in the system. Also, the installation will add these registry values to the HKEY_LOCAL_MACHINE root folder:

  • SOFTWARE\Microsoft\Terminal Server Client\Default\AddIns\TProVC-Plugin\Name

  • SOFTWARE\Microsoft\Terminal Server Client\Default\AddIns\TProVC-Plugin\ip

  • SOFTWARE\Microsoft\Terminal Server Client\Default\AddIns\TProVC-Plugin\enabled

User setup(optional starting from version 1.3.0.6)

To use the recorder with this feature, the user will need to have an AD username and an AD session username set in the EDIT ACCOUNT page.

The exact values can be random, as the Device Controller now tracks WIndows sessions regardless of AD information provided by the users.

Performing connection

The connection between the plugin and the server will be set automatically when the user connects to the server via RDP and Device Controller is running in both the local machine and server. When the connection is established, a Windows notification will be shown:

Command Line Driven Installation

Default MSI installation parameters

/quiet - run the installation without any UI, if no additional parameters are supplied, the installation will be completed with the default configuration.

/log [filename] - run the installation with log output to the supplied file name

Installation options

The default app configuration is as follows:

  • Run Device Controller automatically after Windows startup. is enabled

  • Run Device Controller automatically after installation. is enabled

  • Open T-Pro Web in a headerless browser(deselect to open in a normal tab). is enabled

  • Virtual Channel Plugin is disabled

  • Virtual channel server installation is disabled

  • Enable external connections is disabled

Option parameters

  • RUNATWINDOWSSTARTUP=0 - Disable Run Device Controller automatically after Windows startup. Options: omit or set to 1 to enable

  • RUNAFTERINSTALL=0 - Disable Run Device Controller automatically after installation. Options: omit or set to 1 to enable

  • HEADLESS=0 - Disable Open T-Pro Web in a headerless browser(deselect to open in a normal tab). Options: omit or set to 1 to enable

  • VIRTUALCHANNELPLUGIN=1 - Enables Virtual Channel Plugin. Options: omit or set to 0 to disable

  • VIRTUALCHANNELSERVERINSTALL=1 - Enables Virtual channel server installation. Options: omit or set to 0 to disable

  • ENABLEEXTERNALCONNECTIONS=1 - Enables Enable external connections (Contact your administrator). Options: omit or set to 0 to disable

Note: If the value was set to 1 by default, changing it to 0 will not affect the UI, but the installer logic will function as described above(this is due to how WiX Checkboxes handle the values, if any value is supplied, the checkbox is checked by default).

For example: if you supplied the RUNAFTERINSTALL=0 parameter, the Run Device Controller automatically after installation. checkbox will still be checked, but the application will not start after the installation.

If you have any more queries, please do not hesitate to contact our Helpdesk or
​[email protected]​. © 2024

Did this answer your question?