The objective of unattended installation is to roll out and to use ThinPrint Client immediately without user interaction. In most cases, the default settings are sufficient: The print data of ThinPrint Engine will be decompressed by ThinPrint Client. The client printers will be created or mapped into a terminal or a virtual desktop session, while default printer will be retained.
If these settings are not sufficient, a preconfiguration can make sense – instead of local or remote configuration of each ThinPrint Client. A couple of ThinPrint Client parameters can be set with its installation using the .msi file. For all further settings, one should use a tool for generating .mst files. This tool is able to preconfigure all of the ThinPrint Client settings – you can even set further values in the Windows Registry which are not changeable with ThinPrint Client Manager user interface.
Preconfiguration can also be useful when Connection Service shall be used, because specific settings on ThinPrint Client are necessary. Or if you want to print with encryption, the name of the imported client certificate can be set here. More information can be found in the section Unattended installation with preconfiguration.
Unpacking the .msi file
ThinPrint offers a Setup.exe file for the installation of ThinPrint Client Windows. The file can be downloaded at https://www.thinprint.com/en/resources-support/software/clientsandtools/. The unattended installation can be performed using the Setup.exe or using the .msi installer. To extract the .msi file copy the Setup.exe to a local directory and run the following command in this directory:
Note! See also the section Unpacking the setup file in Unattended installation of ThinPrint Engine components.
- Version 11 of ThinPrint Client Windows can be installed on Windows machines running from Windows 7 / 2008 R2.
- Version 10 of ThinPrint Client Windows can be installed on Windows machines running from Windows XP / 2003 with Service Pack 2 or Service Pack 3 (for XP x86) and Microsoft XML Paper Specification Essentials Pack (XPSEP).
- Version 9.0 can be used on Windows Vista machines.
- For older Windows versions the ThinPrint Client version 7.0 can be used; for unattended installation of this version a different instruction is available.
ThinPrint Client Windows can be installed with or without preconfiguration. The settings can also be changed later on unattended.
- Installation without preconfiguration
If you want to run an installation of ThinPrint Client Windows without preconfiguration, simply copy the relevant .msi installation file (see above) to the client machines and start unattended installation from the command prompt or with a batch file. Therefore, you can use different Windows or ThinPrint parameters (see section Examples with parameters).
- Installation with preconfiguration
If you want to run an installation of ThinPrint Client Windows with preconfiguration, the process is as follows:1. Creation of a Windows Installer transformation file (with the file extension .mst)
using an appropriate tool (including saving the selected installation options in the transformation file).
2. Software distribution / installation
Copying the .msi, the .mst, and the .bat files (if desired) to the client machines and starting unattended installation.
Preparing to install
For installation of ThinPrint Client Windows, you need the .msi installation file (see above) in a local directory. Administrator permissions are required.
If the ICA type of ThinPrint Client Windows shall be installed you should know the path to the Citrix ICA client on the target machines.
Installation of a preconfigured file requires uninstallation of all (old or recent) ThinPrint Clients on client machines. This can also be done unattended, as described in the section Unattended uninstallation. The values of ThinPrint Client in the Windows Registry will not be deleted. A list of Registry values can be found in the client manual.
Unattended Installation without preconfiguration
Unattended installation without preconfiguration means that ThinPrint Client Windows will be rolled out to client machines with default settings. An appropriate administration tool is used for distributing ThinPrint Client through the network, e. g. Microsoft System Center Configuration Manager.
Alternative 1: Setup.exe
- Copy the ThinPrint Client Windows installation software Setup.exe to a directory of the target computer.
- Run the Command Prompt, and change to the directory the Setup.exe has been copied to.
- Start the unattended installation e. g. with the following command:
Setup.exe /s /v"/qb"
Setup.exe /s /v"/qb adminonly=1 certname=\"ThinPrint GmbH\" addlocal=TCPAPP"
After /v always a quotation mark ( ” ) follows. If a parameter necessitate another quotation mark (here for certname) then a backslash ( \ ) is necessary before it (in this example: \” ThinPrint GmbH \” ). A parameter description can be found in the section Parameters.
Alternative 2: .msi file
- Copy the unpacked .msi file including its subdirectories (see above) to a directory on the target computer.
Note! As an alternative to copying the ThinPrint installation files to the clients, you can also leave them on the server and map the relevant drives on the clients.
- Start the ThinPrint Client installation routine with:
<system directory> \ msiexec /qb /i <path to .msi file>
c:\Windows\System32\msiexec /qb /i "c:\install\ThinPrint Client Windows 11.msi"
Examples with parameters
In contrast to unattended installation with preconfiguration, here you can use specific parameters in the command line call-up of the ThinPrint Clients. The following shows the use of both Windows Installer parameters and ThinPrint parameters.
The parameters you can use with both Setup.exe (parameter /v) and .msi file installation.
Windows Installer parameters
Naming an installation directory
If you want to name an installation directory for the unattended installation of ThinPrint Client Windows, start the ThinPrint Client installation routine with:
<system directory> \ msiexec /qb /i <path to .msi file> INSTALLDIR=<installation path>
c:\Windows\System32\msiexec /qb /i "c:\install\ThinPrint Client Windows 11.msi" INSTALLDIR="C:\Program Files\ThinPrint Client"
Further parameters can be found in the section Parameters.
Installation of a certain language version
To install ThinPrint Clients Windows in a certain language start the installation routine with:
<system directory> \ msiexec /qb /i <path to .msi file> LANG=<language>
c:\Windows\System32\msiexec /qb /i "c:\install\ThinPrint Client Windows 11.msi" LANG="esn"
Installation with path to Citrix ICA Client for the ICA type of ThinPrint Client Windows
If multiple Citrix ICA Clients are installed on the target computer (e. g. general or web client) or if problems occur during automatic path detection, you can run unattended installation for the ICA type of ThinPrint Client Windows with input of the path to the desired Citrix ICA Client. Start the installation routine with:
<system directory> \ msiexec /qb /i <path to .msi file> ADDLOCAL="ICA" CITRIXCLIENTDIR=<path to citrix ica client>
c:\Windows\System32\msiexec /qb /i "c:\install\ThinPrint Client Windows 11.msi" ADDLOCAL="ICA" CITRIXCLIENTDIR="C:\Program Files\Citrix\ICA Client"
Further parameters can be found in the section Parameters.
Installation of ThinPrint Client Service Windows
Under certain conditions the installation of ThinPrint Client as a Windows service require input of a user (with administrator permissions) and password. This information can be entered at the start of the unattended installation as follows:
<system directory> \ msiexec /qb /i <path to .msi file> ADDLOCAL="TCPSRV" SRVUSER=<user name> SRVPASS=<password>
c:\Windows\System32\msiexec /qb /i "c:\install\ThinPrint Client Windows 11.msi" ADDLOCAL="TCPSRV" SRVUSER="admin" SRVPASS="xxxx"
If the account (srvuser + srvpass) has been omitted the network service account will be used. To specify more ThinPrint specific preconfigurations, we recommend use of a transformation file (see Creating a transformation file). Further parameters can be found in the section Parameters..
Unattended installation with preconfiguration
An appropriate tool (e. g. Orca or InstEd) lets you create a sample configuration for a selected ThinPrint Client Windows type as a Windows Installer transformation (.mst) file. The tool’s user interface offers you the option of making several configuration settings for ThinPrint Client Windows and these settings may be saved to an .mst file. By installing the selected .msi file using this .mst file, you can install a preconfigured ThinPrint Client Windows on the target computers – attended or unattended.
Creating a transformation file
Create an .mst file for the ThinPrint Engine’s .msi file. To do so, use a (free) transformation tool – e. g. Orca (from Microsoft) or InstEd (www.instedit.com). Here is an example for InstEd:
1. Run InstEd.
2. Select File→ Open, mark the installation software of ThinPrint Client (in this example: ThinPrint Client Windows 9.0.msi), and click Open to confirm. This window will appear:
3. Select Transform→ New Transform, and enter a file name for the .mst (transform) file. The names of .mst and of .msi file should match.
4. Under Property select Add Row in the context menu for each parameter. In each case enter a parameter’s name (Parameters) as well as its value.
5. In this way add all required parameters (see Parameters.).
6. Save the .mst file. Afterwards you can distribute the .msi file of ThinPrint Client together with its .mst file to the target computers.
Note! There are many possibilities for software distributing, for example from the command prompt, using a batch file, the Active Directory (see Microsoft knowledge-base article 302430), or third-party solutions as ASDIS or Microsoft System Center Configuration Manager.
A list of available parameters of ThinPrint Cients Windows’s installer, for setting registry entries and additional parameters is available here:
Rolling out the preconfigured client
The transformation tool has now created a Windows Installer transformation file (.mst file). The file is found in the same directory as the .msi file. To roll out the configured ThinPrint Clients, you will need both .msi file and .mst file – and a batch file, if desired.
There are many possibilities for software distributing, for example from the command prompt, using a batch file, the Active Directory (see Microsoft knowledge-base article 302430), or third-party solutions as ASDIS or Microsoft System Center Configuration Manager.
When installing the .msi file via the command prompt you can also specify the .mst file:
<system directory> \ msiexec /qb /i <path to .msi file> TRANSFORMS=@<name .mst file>
c:\Windows\System32\msiexec /qb /i “c:\install\ThinPrint Client Windows 11.msi” TRANSFORMS=@”ThinPrint Client Windows 11.mst”
Uninstalling ThinPrint Client Windows
– Select Control Panel®Programs and Features, then select ThinPrint Client Windows and click Uninstall.
An unattended uninstallation can also be performed for the ThinPrint Client. Enter the following in the command line:
<system directory> \ msiexec /qb /x <path to .msi file>
c:\Windows\System32\msiexec /qb /x "c:\install\ThinPrint Client Windows 11.msi"