Silent installation via command line
The VTS administration software can also be installed via the command line. With this type of installation, no visible setup is started. All necessary parameters are transferred via the installation command.
Installation command
The installation command has the following structure:
WTS8setup.exe /qX DEFAULT_CULTURE="de-DE" AC_USERNAME_PROP="Admin" AC_PASSWORD_PROP="xxx" WTS_SERVICE_PORT="7001" WTS_PORTAL_PORT="7011" WTS_PORTAL_URL="xxx"
This command can be supplemented with additional optional parameters. For example:
LICENSE_FILE="c:\TEMP\W12345_001_01_ID21_31001_Lizenz.v2c"
APPDIR="C:\Program Files\Wiener Testsystem 8"
ICON_TP="1"
/L*V "%temp%\WTS8Silent.log"
Explanation of parameters
The possible parameters are:
Parameter | Wert | Beschreibung |
|---|---|---|
/qx |
|
|
DEFAULT_CULTURE | de-DE, en-US, … | Mandatory parameter for initial installation The language of the administration software can also be changed after installation. |
AC_USERNAME_PROP | Text | Mandatory parameter for initial installation Defines the name of the first user for the Vienna Test System. |
AC_PASSWORD_PROP | Text | Defines the password for the user defined by AC_USERNAME_PROP. If NO_AC_PASSWORD is set to 0, this parameter must be used! |
NO_AC_PASSWORD | 0 or 1 | If the parameter is set to 1, no password is required for login. In this case, other suitable measures must be taken to ensure data protection in accordance with the GDPR. If a password is assigned with AC_PASSWORD_PROP, this parameter can be omitted. |
PRODUCT_KEY | Text | Specifies the product key if a software dongle is installed with one. |
LICENSE_FILE | Text | Specifies the path for a v2c license file if it is to be imported during installation. This is not necessary for a first-time installation. |
APPDIR | Path | This entry determines the path in which the Vienna Test System is to be installed. If this parameter is not specified, it is the installation directory: C:\Program Files (x86)\Schuhfried GmbH\Vienna Test System 8. |
ICON_TP | 0 or 1 | If this parameter is set, the setup creates an icon for the testplayer on the desktop and an entry in the Start menu. |
/L*V | Text | This parameter specifies the complete path to a file in which a log file of the installation is created. The file is created during the installation. |
/exelang | 1031 or 1033 | 1031: starts the setup in German 1033: starts the setup in English This parameter is optional. |
WTS_PORTAL_URL | Text | Specifies the address at which the VTS portal should be accessible. This value should be either the domain name or the machine name (default=machine name). The corresponding URL should be specified. |
WTS_SERVICE_PORT | 7001 | Mandatory parameter |
WTS_PORTAL_PORT | 7011 | Specifies the base port for the VTS portal. A free port in the range 7001 to 7999 must be specified here. Please note that seven additional consecutive ports will also be used. This specification is optional. If the default value (7011) is used, the following ports are used: 7011, 7012, 7013, 7014, 7015, 7016, 7017, 7018. |
LICENSE_SERVER_ID | Text | Specifies the IP address or name of the license server in the network, if one is used. This parameter must only be specified if the dongle is connected to a separate license server. In this case, the license server is not the server on which the VTS is installed. The default value is |
DB_SERVER_INSTANCE | Text | Specifies the server name of the SQL server (only to be specified if a user-defined SQL server is to be used). |
DB_CATALOG_NAME | Text | Specifies the catalog name of the SQL server (only to be specified if a user-defined SQL server is to be used). |
SQL_SA_USER | Text | Specifies the login name of the SQL server system administrator (only if a user-defined SQL server is used and the sa user can be specified). |
SQL_SA_PASSWORD | Text | Specifies the password of the SQL server system administrator (only if a user-defined SQL server is used and the sa password can be specified). |
MANDANT_ID | Text | This parameter can be used to set the multi-client with which the testplayer should start (e.g. W12345_001). If “AUTO” is entered, the first multi-client found on the server is selected. If the multi-client is to be entered each time the program is started, MANDANT_ID="-" must be specified. |
CERTIFICATE_FILEPATH | Text | This parameter can be used to specify the file path to your own certificate, which is used for communication between the components. |
CERTIFICATE_PASSWORD | Text | If CERTIFICATE_FILEPATH is set, this parameter can be used to specify the password for your own certificate. |
CERTIFICATE_SUBJECT | Text | If CERTIFICATE_FILEPATH is set, this parameter must be used to specify the subject (or domain) of your own certificate. |
EXISTING_CERTIFICATE_SUBJECT | Text | Optional If this variable is provided, the installation program attempts to find a valid certificate in the Windows certificate store (LocalComputer/Personal) whose CN (common name) corresponds to the provided variable. This certificate must contain a private key that is accessible in the store and is used for all TLS connections and other encryption and signing operations. This variable must not be used simultaneously with EXISTING_CERTIFICATE_THUMBPRINT or CERTIFICATE_FILEPATH. |
EXISTING_CERTIFICATE_THUMBPRINT | Text | Optional If this variable is provided, the installation program attempts to find a valid certificate in the Windows certificate store (LocalComputer/Personal) whose thumbprint matches the provided variable. This certificate must have a private key that is accessible in the store and is used for all TLS connections and other encryption and signing operations. This variable cannot be used simultaneously with EXISTING_CERTIFICATE_SUBJECT or CERTIFICATE_FILEPATH. |
Examples
Installation in English with log file:
WTS8setup.exe /qr DEFAULT_CULTURE="en-US" AC_USERNAME_PROP="admin"
AC_PASSWORD_PROP="admin" /L*V "%temp%\WTS8Silent.log"
WTS_SERVICE_PORT="7001" WTS_PORTAL_PORT="7011" WTS_PORTAL_URL="https://localhost"
7011"Installation in German with creation of the Testplayer icon on the desktop without using a password:
WTS8setup.exe /qr DEFAULT_CULTURE="de-DE" AC_USERNAME_PROP="admin"
NO_AC_PASSWORD="1" ICON_TP="1" WTS_SERVICE_PORT="7001"
WTS_PORTAL_PORT="https://localhost"
Installation with product key:
WTS8setup.exe /qr DEFAULT_CULTURE="de-DE" AC_USERNAME_PROP="admin" AC_PASSWORD_PROP="Admin123" PRODUCT_KEY="xxx-xxx-xxx-xxx-xxx"
WTS_SERVICE_PORT="7001" WTS_PORTAL_PORT="7011"
WTS_PORTAL_URL="https://localhost"
Installation with your own certificate:
WTS8setup.exe /qn DEFAULT_CULTURE="en-US" AC_USERNAME_PROP="admin" AC_PASSWORD_PROP="Admin123"
WTS_SERVICE_PORT="7001" WTS_PORTAL_PORT="https://localhost"
CERTIFICATE_FILEPATH="<path>\certificate.pfx"
CERTIFICATE_PASSWORD="MyCertPwd"
CERTIFICATE_SUBJECT="http://www.schuhfried.com"Notes on use
The parameters AC_USERNAME_PROP, AC_PASSWORD_PROP and NO_AC_PASSWORD are only required for initial installation. Any entries will be ignored during an update.
The parameters DB_SERVER_INSTANCE and DB_CATALOG_NAME only need to be specified if a user-defined SQL server is to be used. If they are not specified, SQL Server Express is automatically installed and used as the database. If DB_SERVER_INSTANCE is specified, the installation of SQL Server Express as a prerequisite is automatically skipped.
The parameters SQL_SA_USER and SQL_SA_PASSWORD only need to be specified if a user-defined SQL Server is used, but they are optional. If they are not specified, the database must have been created or updated before the setup is executed. The setup cannot create or update the database without sa users.
If no dongle (hardware or software dongle) is found and the parameter PRODUCT_KEY is specified, an attempt is made to generate a software dongle. This requires an internet connection. If a dongle is available, any value specified after PRODUCT_KEY is ignored.
Double quotation marks (") around the parameter values are only necessary if the value contains spaces (e.g., a path or file name).
If a parameter is specified, it must contain a value. Empty values (e.g., AC_PASSWORD_PROP="" or AC_PASSWORD_PROP=) are not permitted and will result in incorrect processing.
The parameter /exelang must be placed first, if specified. There must always be a space before the language ID (1031 or 1033). /exelang=1031 will not work.
Available languages
The following language codes can be used for the DEFAULT_CULTURE parameter.
Language | Language code |
|---|---|
Chinese – Simplified | zh-CN |
German | de-DE |
English (USA) | en-US |
French | fr-FR |
Italian | it-IT |
Dutch | nl-NL |
Polish | pl-PL |
Portuguese | pt-PT |
Hungarian | hu-HU |
Rumanian | ro-RO |
Russian | ru-RU |
Swedish | sv-SE |
Slovak | sk-SK |
Slovenian | sl-SI |
Spanish | es-ES |
Czech | cs-CZ |
Turkish | tr-TR |