Unattended installation of ThinPrint Engine components Technical Information Cortado AG Alt-Moabit 91 a/b 10559 Berlin Germany / Alemania Cortado, Inc. 7600 Grandview Avenue Suite 200 Denver, Colorado 80002 USA / EEUU Cortado Pty. Ltd. Level 20, The Zenith Centre, Tower A 821 Pacific Highway Chatswood, NSW 2067 Australia E-Mail: [email protected] Web: www.thinprint.com Issued: October 15, 2014 (v78) Contents Products and components ............................................................................................... 3 Preparations .................................................................................................................. 3 Components for unattended installation ............................................................................ 4 Modes of unattended installation ...................................................................................... 5 Unpacking the setup file .................................................................................................. 5 Installation via setup file ................................................................................................. 6 Installation via .msi and .mst file ...................................................................................... 7 Parameters for setup file, ThinPrint MSIs and MsiExec.exe .................................................. 9 Examples .................................................................................................................... 11 © Cortado AG 2014 2 Manual Products and components Unattended installation, uninstallation and/or update is possible with the following ThinPrint products or tools: Product Installation program RDP Engine Setup.exe or ThinPrint RDP Engine 10.msi ThinPrint Engine Setup_ThinPrintEngine_x64.exe or Setup_ThinPrintEngine_x86.exe or ThinPrint Engine10.msi Cortado License Server CortadoLicenseServer_x64.exe or CortadoLicenseServer_x86.exe or Cortado License Server 10.msi Desktop Extension Setup_DesktopExtension_x64.exe or Setup_DesktopExtension_x86.exe or Desktop Extension 10.msi Desktop Engine .print Desktop Engine.msi Personal Printing Setup.exe oder Personal Printing 3.0.msi 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 Engine10.msi. For unattended installation of the license server, and the activation of users for ThinPrint via a web interface, please refer to the License Server manual. Information about unattended installation of ThinPrint Clients can be found in the technical information Preconfiguration and unattended installation of ThinPrint Client Windows. You will find those documents at: www.thinprint.com→ RESOURCES & SUPPORT→ GUIDES & MANUALS. System requirements © Cortado AG 2014 This documentation refers to the unattended installation of ThinPrint 10, RDP Engine 10, Desktop Extension 10 and Desktop Engine 7.6. Please consider the system requirements in the respective manuals. Update installations are possible on systems on which the previous version is running. Preparations Administrator permissions are required for all installation and configuration procedures. Therefore log on as a member of the user group ADMINISTRATORS or DOMAIN ADMINISTRATORS. Unattended Installation.fm Manual 3 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 When starting an unattended installation, only one of the three functions may be executed: Note! When starting an unattended installation, only one of the three functions may be executed: • Installation or • uninstallation or • update ThinPrint 10 • First, install the license server on any server, and activate your users for ThinPrint10. 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 Cortado license server on a separate machine. This allows you to continue working with the old version until the new one is fully functional. Enter the new (ThinPrint 10) license keys there. • Perform an update of the ThinPrint Engine to version 10 and specify the license server address. If you start the update by script and not in the command line, the script may not contain UNC1 paths or paths to mapped drives. • Delete your old license keys and complete the letter of destruction, which you then send to Cortado. Activate your (new) licenses and activate your users/user groups for ThinPrint, see License server manual: www.thinprint.com→ RESOURCES & SUPPORT→ GUIDES & MANUALS. Components for unattended installation • Installation program (Illus. 4) The files for installing, updating, or uninstalling ThinPrint or Cortado components are named setup or .msi (see table on Page 3). • Log file (option) The installation program records all steps in a log file or it lists error messages there in case of failure. 4 Name convention for accessing network resources under Microsoft operating systems (universal naming convention); example: \\server\directory Manual Unattended Installation.fm © Cortado AG 2014 1 Modes of unattended installation The installation routines are delivered as a setup file (CORTADOLICENSESERVER _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. See Pages 6 and 9. Or: • Installation via .msi file without an .mst file Distribution of the .msi file (ThinPrint Engine10.msi, Cortado License Server 10.msi, ThinPrint RDP Engine 10.msi or Desktop Extension 10.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 2 will be created, and then it will be distributed together with the .msi file (e.g. ThinPrint Engine10.msi). Advantage: It is not necessary that the target servers are running at that time. See Page 7. 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. – Finally restart Windows to finish the installation if it isn’t done automatically. Below, the process is described in detail. Unpacking the setup file Extract the .msi file of the setup program using the command prompt (Illus. 1): Setup_ThinPrintEngine_x64.exe /s /a"C:\install\TP10\ ISSetupPrerequisites" /v"TARGETDIR=C:\install\TP10/qb" © Cortado AG 2014 Illus. 1 Illus. 1 2 Unattended Installation.fm Unpacking setup file (example for ThinPrint Engine) .mst file = transformation file Manual 5 Illus. 2 This will unpack the .msi files and the prerequisites (in this case: Windows Installer, Hotfixes, and others) to C:\INSTALL\TP10 (Illus. 2). Illus. 3 Illus. 2 setup file unpacked (example for ThinPrint Engine 10) Installation via setup file – Copy the setup file together with the unpacked files to a directory of the target server (Illus. 3). Illus. 4 Illus. 3 Installation software in a directory of the target machine (example) – Run the command prompt, change to the directory the setup file and the respective .msi file have been copied to (Illus. 4). – Start the unattended installation (Illus. 4) e.g. with the following command3: The parameter description can be found on Page 9. 3 6 Installation of ThinPrint Engine onto a print server (server role: PS), language: French, with indication of the license server. Manual Unattended Installation.fm © Cortado AG 2014 Setup_ThinPrintEngine_x64.exe /s /v"/qn SERVERROLE=PS LANG=FRA LICENSESERVER=192.168.149.116" Illus. 5 Illus. 4 Starting unattended installation on the target machine (example) 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 (www.instedit.com). Here is an example for InstEd: • Run InstEd. • Select FILE→ OPEN, mark the installation software (e.g. ThinPrint Engine10.msi), and click OPEN. to confirm. The window Illus. 5 will appear. Illus. 6 INSTED: Adding a transform file (example) © Cortado AG 2014 Illus. 5 Unattended Installation.fm Manual 7 • Select TRANSFORM→ NEW TRANSFORM, and enter a file name for the .mst (transform) file (Illus. 6). Illus. 7 Illus. 6 InstEd: Enter a file name for the transform file (example) • Select PROPERTY and enter the desired settings. You may e.g. specify the license server, by entering the parameter LICENSESERVER and its IP address (Illus. 7). Illus. 8 Illus. 7 InstEd: Enter a property with its value (example) – Distribute the .msi file of ThinPrint Engine together with its .mst file to the target servers. © Cortado AG 2014 8 Manual Unattended Installation.fm Parameters for setup file, ThinPrint MSIs and MsiExec.exe © Cortado AG 2014 Setup file or .msi file Parameters for setup file or the respective .msi file: Parameter Meaning /s Doesn’t show the initial dialog /v All following characters will be assigned as parameters to MsiExec.exe. SERVERROLE (ThinPrint Engine only) Specifies server role or installation option: PS = Print server TS = Terminal server TSE = Terminal Server Extension (printing only via a print server) AT = Administration Tools (for remote configuration) CUST = Custom installation; parameters are set using ADDLOCAL ADDLOCAL (ThinPrint Engine only) Combines features for custom installation: Portmon = ThinPrint Engine Tracking = Tracking Service TPOG = TP Output Gateway TPOGPS = TP Output Gateway PS TPVLSvc = V-Layer (only together with Portmon + TPOG) TPAC = AutoConnect VCG = Virtual Channel Gateway PTC = Print-to-Cloud PTE = Print-to-ePaper Session = Session-in-Session AdminTools = Administration Tools (for remote configuration) LicenseManager = License Manager CCLUCS = License Manager service ADDLOCAL (Desktop Extension only) Combines features for custom installation: TPOG = TP Output Gateway TPAC = AutoConnect VCG = Virtual Channel Gateway Session = Session-in-Session REMOVE (ThinPrint Engine and Desktop Extension only) With REMOVE instead of ADDLOCAL you can remove separate components. FORCELANG 1 = hkey_local_machine\software\ThinPrint\Lang will be overridden with LANG property value. Unattended Installation.fm Manual 9 Meaning LANG Sets language acronym for ThinPrint MMC components (if it doesn’t exist or if FORCELANG is set to 1) in hkey_local_machine\software\ThinPrint\Lang: deu = German enu = English fra = French esn = Spanish LANG has priority over /L. /L Language ID: 1031 = German (Germany) 1033 = English (United States) 1034 = Spanish 1036 = French CITRIXCLIENTDIR (ThinPrint Engine only) Full path of Citrix ICA Client installation INSTALLDIR (ThinPrint Engine and Personal Printing only) ThinPrint Engine installation directory /a Unpack the setup file TARGETDIR Extraction directory for setup file LICENSESERVER (ThinPrint Engine) License server address LICENSESERVERPORT (ThinPrint Engine) License server TCP port WEBSITEPORT (ThinPrint Engine) TCP port for web configuration of the license server TCP (Desktop Engine only) 0 = ThinPrint port will be configured as Virtual Channel (default) 1 = ThinPrint port will be configured for TCP/IP REBOOT (Desktop Engine only) 0 = no reboot after a silent installation (default) 1 = reboot after a silent installation CLEANUP (Desktop Engine only) for silent installation, default: 0 0 = any pre-existing configuration will be retained 1 = any pre-existing configuration will be replaced Manual Unattended Installation.fm © Cortado AG 2014 10 Parameter MsiExec.exe Extract of parameters for MsiExec.exe: Parameter Meaning /i Installation /x Uninstallation /qn Silent installation (q), no user interface (n) /qb Silent installation (q), basic user interface (b) /l*v Detailed logging See also the Windows Installer Command-Line options at: http://msdn.microsoft.com/en-us/library/aa367988(VS.85).aspx or http://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. © Cortado AG 2014 Setup_ThinPrintEngine_x64.exe /L1033 /S /V" SERVERROLE=TS /qb /L*v installation.log" Unattended Installation.fm Manual 11 Example 4: 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 5: 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 6: 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 Engine10.msi" SERVERROLE=CUST ADDLOCAL="Portmon,Tracking" LANG="deu" Example 7: 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" TCP1 /L*v installLog.txt © Cortado AG 2014 12 Manual Unattended Installation.fm