Unattended Setup (by command line)

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

Motivation

"Unattended installation" refers to the process of installing software without requiring user interaction during its execution. This method is often used in managing a large number of computers, where manually performing installations would be impractical and time-consuming.

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

POWERSHELL

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" ^
TEST_DPE_CREDENTIALS_CHECKBOX="Checkbox" ^
DIGASYSTEM_CONFIGURATION="" ^
DIGASYSTEM_COMPUTER_REGISTRY="myComputer" ^
DIGASYSTEM_TURBOPLAYER_CONFIGURATION="myTurboPlayerConfig" ^
DIGASYSTEM_TURBOPLAYER_GUI_NUMBER=3

Adjust at least
- USER_NAME,
- DOMAIN_NAME,
- USER_PASSWORD,
- DPE_URL,
- DPE_USER,
- DPE_PASSWORD,
- 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.

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.

Property name	Explanation	Example	Type	Allowed values	Default value
APPDIR	The directory where TurboPlayer Service is to be installed.	C:\TurboPlayerService\	string	a valid folder	C:\Program Files (x86)\DigaSystem\TurboPlayer Service\
USER_NAME	The user name of the credentials under which the TP service should run	myname	string		(empty)
DOMAIN_NAME	The domain of the user name for the credentials under which the TP service should run	domainname	string		(empty)
USER_PASSWORD	The password of the credentials under which the TP service should run	mypassword	string		(empty)
START_TURBOPLAYER_SERVICE	Start service after installation. (empty) means START_TURBOPLAYER_SERVICE=""	(empty)	string	(empty), Checked	Checked
DPE_URL	URL of DPE	http://dpehost	url		(empty)
DPE_USER	Name of DPE user.	dpeuser	string		(empty)
DPE_PASSWORD	Password of DPE user.	****	string		(empty)
TEST_DPE_CREDENTIALS_CHECKBOX	Enable or disable the DPE credential check. (empty) means TEST_DPE_CREDENTIALS_CHECKBOX=""	(empty)	string	(empty), CheckBox	CheckBox
DIGASYSTEM_CONFIGURATION	Name of TurboPlayer Service configuration	myTpsConfig	string		(empty)
DIGASYSTEM_COMPUTER_REGISTRY	Name of the computer where TurboPlayer engine is running and which TurboPlayer service should control.	tpHost	string		(empty)
DIGASYSTEM_TURBOPLAYER_CONFIGURATION	Name of the TurboPlayer configuration which specifies the connection properties to the TurboPlayer Engine.		string
DIGASYSTEM_TURBOPLAYER_GUI_NUMBER	The number which sepcify the ports used to communicate between the GUI and the engine. All GUI Numbers of TurboPlayer GUIs and TurboPlayer Services which connect to a specific TurboPlayer Engine must be different.	3	int		2

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