Unattended Setup (by command line)

This page describes the installation of TurboPlayer Service in an enterprise environment or an automated test environment from the command line.

Installation Procedure

The TurboPlayer Service setup consists of TurboPlayerServiceSetup.exe, TurboPlayerServiceSetup.msi, the .Net 6.0 Runtimes (x86, x64) and the ASP .NET Core 6.0 Runtimes (x86, x64). We recommend to copy the complete installation folder into a local directory, because access to mounted network drives may conflict with elevated privileges required during the installation process.

Installation with a batch file

• Create an new text file with your favorite Text editor (or Notepad)

• Copy the following text to the text file

TurboPlayerServiceSetup.exe /L*V setup.log /qn ^
APPDIR="C:\Program Files (x86)\DigaSystem\TurboPlayer Service\" ^
USER_NAME="username" ^
DOMAIN_NAME="domain" ^
USER_PASSWORD="password" ^
START_TURBOPLAYER_SERVICE="Checked" ^
DPE_URL="https://mydomain.com/DpeWebApplication/" ^
DPE_USER="dpeUser" ^
DPE_PASSWORD="dpePassword" ^
CONNECTION_USE_SECURE_PROTOCOLS="SecureProtocols" ^
CERTIFICATE_THUMBPRINT="01234567890abcdef01234567890abcdef012345" ^
TEST_DPE_CREDENTIALS_CHECKBOX="Checkbox" ^
DIGASYSTEM_CONFIGURATION="myTPServiceConfig" ^
DIGASYSTEM_COMPUTER_REGISTRY="%COMPUTERNAME%" ^
DIGASYSTEM_TURBOPLAYER_CONFIGURATION="myTurboPlayerConfig" ^
DIGASYSTEM_TURBOPLAYER_GUI_NUMBER=2

• Adjust at least

  • USER_NAME,

  • DOMAIN_NAME,

  • USER_PASSWORD,

  • DPE_URL,

  • DPE_USER,

  • DPE_PASSWORD,

  • CERTIFICATE_THUMBPRINT

  • DIGASYSTEM_COMPUTER_REGISTRY and

  • DIGASYSTEM_TURBOPLAYER_CONFIGURATION

with the appropriated values for your company. For a description of the parameters see the table below.

• Save the new text file as UnattendedSetup.bat in the folder where TurboPlayerServiceSetup.exe is located.

• Open a command line window with elevated rights by press Windows+R, to open the Run dialog, type cmd and press Ctrl+Shift+ENTER.

• Change the current directory to the path where TurboPlayerServiceSetup.exe is located.

• Type UnattendedSetup.bat to start the installation.

If the installation was successful, the TurboPlayer Service is started.

TurboPlayer Service Connection Check

The installation directory contains a Connection Test HTML page (C:\Program Files (x86)\DigaSystem\TurboPlayer Service\TurboPlayerServiceTest.html ). Open the TurboPlayer Service Connection Check page by double-clicking on TurboPlayerServiceTest.html

• Click Open WebSocket Connection button. The Connection Status should change to WebSocket Connection is open.

• Click GetVersion button. The Result column should display the version number of the installed TurboPlayer service.

• Enter a valid DigaSystem credentials (Username and Password) which has the required rights to monitor or control TurboPlayer.

• Click Login. The Result column should display OK.

• Click Heartbeat. The Result column should display OK.

• Click GetGlobalStatus. If the Result column displays Service has not license, see License File

Troubleshooting

If there was an error during the installation, open the setup.log file which is created by the installation. Search for the last “Error” in the log file to find the reason why the installation has failed.

If the installation succeeds but the TurboPlayer Service failed to start, information about the root cause can be found in the service log file. The log files for the service are stored in <Installation folder>/Log/<Configuration Name>. 

Setting Properties

Properties are (among other) the data which the user would normally enter into the installer's GUI. Properties come as pairs of name and value. You can set properties for unattended setup on the command line by adding value=name pairs after all command line switches.

Note: Environment variables can be used e.g., "%ProgramFiles%\My TPS" would expand to "C:\Program Files\My TPS"