Products & components

System requirements

Preparations

Update installation from ThinPrint 9.x to ThinPrint 10.0 and then to 11 or 12

Components for unattended installation

Modes of unattended installation

Unpacking the setup file

Installation via setup file

Installation via .msi and .mst file

Parameters for setup file, ThinPrint MSIs and MsiExec.exe

Setup file or .msi file

MsiExec.exe

Examples

---

Products & components

Unattended installation, uninstallation and/or update is possible with the following ThinPrint products or tools:

You can download the required installation routines from the Cortado Enterprise Portal:
cep.cortado.com/en/resources/softwaredownload

The setup file is used to install the respective ThinPrint software. The setup file itself normally calls up the actual installation routine as an .msi file, e. g. ThinPrint Engine11.msi.

For unattended installation of the license server, and the activation of users for ThinPrint via a web interface, please refer to License Server.
Information about unattended installation of ThinPrint Clients can be found in Unattended installation of ThinPrint Client Windows.

System requirements

This documentation refers to the unattended installation of ThinPrint 10.0, 10.6, 10.6 FR1, 11 and 12 as well as RDP Engine 11 and 12, Desktop Agent 11, Desktop Engine 7.6 and Personal Printing 4.0. Please consider the system requirements in the respective manuals.
Update installations are possible on systems on which the previous version is run­ning.

Preparations

Administrator permissions are required for all installation and configuration proce­dures. Therefore log on as a member of the user group Administrators or Domain Administrators.

Has ThinPrint been installed previously?

If a ThinPrint or Cortado product was installed previously, but you don't want to keep its settings, delete the following keys in the Windows registry:

hkey_local_machine\software\ThinPrint
hkey_current_user\software\ThinPrint

Note! When starting unattended installation, only one of the three functions may be executed:

• installation or
• uninstallation or
• update

Update installation from ThinPrint 9.x to ThinPrint 10.0 and then to 11 or 12

• First, install the license server on any server (activate your users for ThinPrint, if necessary).
  If you are already using ThinPrint, proceed as follows:
  • Apply for new license keys in the Cortado Enterprise Portal (free of charge for customers with an update subscription): https://enterpriseportal.cortado.com
  • Install the License Server 10.0.2 (= 10.0 + hotfix HF2) on a separate machine. This allows you to continue working with the old version until the new one is fully functional. Here, install the integrated 30-days license key.
  • Perform an update of the ThinPrint Engine(s) to version 10.0 and specify the license server. If you start the update by script and not in the command line, the script may not contain UNC paths or paths to mapped drives (example for a UNC path: \\server\directory)
  • Perform a License Server update to version 11. Here install your version 11 licenses key (or older keys with their update subscription keys).
  • Perform an update of the ThinPrint Engine(s) to version 11.
  • Delete your old license keys and complete the letter of destruction, which you then send to ThinPrint or Cortado.
  • Activate your (new) licenses, see License Server.

Components for unattended installation

• Installation program
  The files for installing, updating, or uninstalling ThinPrint or Cortado compo­nents are named setup or .msi (see table above).
• Log file (option)
  The installation program records all steps in a log file or it lists error messages there in case of failure.

Modes of unattended installation

The installation routines are delivered as a setup file (ThinPrintLicense­Server_x64.exe, for example). From this routine an .msi file can be unpacked using the parameter /a.
You have to decide on one of the following procedures for unattended installation:

Ether:

• Installation via setup file
  All necessary components will be copied to the target machine. Afterwards the setup file will be started there with parameters.

Or:

• Installation via .msi file without an .mst file
  Distribution of the .msi file (e. g. ThinPrint Engine11.msi or ThinPrint License Server 11.msi). Extract the .msi file from the setup file with the parameter /a.

Or:

• Installation via .msi file with an .mst file
  First, an .mst file (transformation file) will be created, and then it will be distributed together with the .msi file (e. g. ThinPrint Engine11.msi). Advantage: It is not necessary that the target servers are running at that time.

Note! There are many possibilities for software distributing, for example from the command prompt, using a batch file, the Active Directory or a third-party solution.

• Finally restart Windows to finish the installation if it isn’t done automatically.

Below, the process is described in detail:

Unpacking the setup file

The setup.exe files for unattended installation can be downloaded from the Cortado Enterprise Portal:

cep.cortado.com/en/resources/softwaredownload

• Extract the .msi file of the setup program using the command prompt:

Setup_ThinPrintEngine_x64.exe /s /a"C:\install\TP11\ISSetupPrerequisites" /b"C:\install\TP11\cache" /v"TARGETDIR=C:\install\TP11 /qb"

This will unpack the .msi file and the prerequisites (in this case: Windows Installer, Hotfixes, and others) to c:\install\TP11
The /b parameter ensures that the signature of the MSI file is retained (with unpacking) by buffering (in the subdirectory \cache).

Installation via setup file

• Copy the setup file together with the unpacked files to a directory of the target server.

• Run the command prompt, change to the directory the setup file and the respective .msi file have been copied to.
• Start the unattended installation e. g. with the following com­mand:

Setup_ThinPrintEngine_x64.exe /s /v"/qn SERVERROLE=PS LANG=FRA LICENSESERVER=192.168.149.116"

Here: installation of ThinPrint Engine onto a print server (server role: PS), language: French, with indi­cation of the license server.

Installation via .msi and .mst file

• Create an .mst file for the ThinPrint Engine’s .msi file. To do so, use a (free) tool – e. g. Orca (from Microsoft) or InstEd (instedit.com). Here is an example for InstEd:
  • Run InstEd.
  • Select File→ Open, mark the installation software (e. g. ThinPrint Engine11.msi), and click Open to confirm.

• Select Transform→ New Transform, and enter a file name for the .mst (transform) file.

• Select Property and enter the desired settings. You may e. g. specify the license server address, by adding the parameter Licenseserver and its IP address.

• Distribute the .msi file of ThinPrint Engine together with its .mst file to the target servers.

Parameters for setup file, ThinPrint MSIs and MsiExec.exe

Setup file or .msi file

Parameters for setup file or the respective .msi file:

MsiExec.exe

Extract of parameters for MsiExec.exe:

See also the Windows Installer Command-Line options at:

msdn.microsoft.com/en-us/library/aa367988(VS.85).aspx or
technet.microsoft.com/en-us/library/cc759262%28v=WS.10%29.aspx

Examples

Example 1: The following command installs the ThinPrint Engine silently and sets the language of the ThinPrint MMC components to French.

Setup_ThinPrintEngine_x64.exe /L1036 /s /v"/qb

Example 2: The following command installs the ThinPrint Engine silently, sets the ThinPrint module language to German (deu) and changes the INSTALLDIR property to "C:\Program Files \ MyFolder".

Setup_ThinPrintEngine_x64.exe /L1031 /S /V"/qb INSTALLDIR=\"C:\Program Files\MyFolder\""

Example 3: The following command installs the ThinPrint Engine silently, sets the ThinPrint module language to English, creates a log file and installs and configures the software as terminal server.

Setup_ThinPrintEngine_x64.exe /L1033 /S /V" SERVERROLE=TS /qb /L*v installation.log"

Example 4: The following command installs the Desktop Agent components AutoConnect, Output Gateway, and Virtual Channel Gateway silently and disables printer groups with ThinPrint Self Service.

msiexec.exe /qb /i "ThinPrint Desktop Agent 11.msi" ADDLOCAL="TPAC,TPOG,VCG" PRINTERGROUPS=0

Example 5: The following command installs only the Desktop Agent component ThinPrint Self Service silently as well as the associated service that connects to the license server. If the account you are installing with does not have administrator permissions on the license server, use the parameters LICSRVUSER (account) and LICSRVPASS (password) additionally.

msiexec.exe /qb /i "ThinPrint Desktop Agent 11.msi" ADDLOCAL=TPSelfService LICENSESERVER=192.168.149.13 LICSRVUSER=ourdomain\administrator LICSRVPASS=12345678

Example 6: The following command installs only the Desktop Extension components AutoConnect, Output Gateway, and Virtual Channel Gateway silently.

msiexec.exe /qb /i "Desktop Extension 10.msi" ADDLOCAL="TPAC,TPOG,VCG"

Example 7: The following command installs only the Session-in-Session component of ThinPrint Engine silently and sets the ThinPrint module language to English.

Setup_ThinPrintEngine_x64.exe /L1033 /s /v"/qb SERVERROLE=CUST ADDLOCAL=\"Session\""

Example 8: The following command installs the ThinPrint Engine silently, creates a log file, sets the ThinPrint module language to deu and creates custom installation with the features: Portmon (= ThinPrint Engine) and Tracking Service.

msiexec.exe /qb /L*v installation.log /i "ThinPrint Engine11.msi" SERVERROLE=CUST ADDLOCAL="Portmon,Tracking" LANG="deu"

Example 9: The following command installs the Desktop Engine silently, creates a log file, and sets the port protocol to TCP/IP.

msiexec.exe /qb /i ".print Desktop Engine.msi" TCP=1 /L*v installLog.txt