Technical Information Unattended installation of ThinPrint Engine components

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: info@cortado.com
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