Online Help System
Contents
IndexBookmarkPrint

Home >  >  > Orphaned Pages

MSI Installation Switches

Silent Installation – for 32 and 64 bit MSI Installers

This functionality is provided for network administrators – not for single user licenses to be copied to multiple machines – which is illegal. A license is required for each machine to which PDF-XChange is installed – except for evaluation use in demonstration mode.

Assuming you have a multiple user license – installing PDF-XChange to many workstations – it may be useful to be able to silently install without the need for any user interaction. This allows you to execute the install either from the command line with certain parameters and switches applied and distribute this with the main installation executable for your users to run directly – alleviating the need for the System Administrator to visit each user and install.

Please note as with any system device – such as a printer, full Administrator privileges are required to install on later 'Win32' versions of Microsoft Windows.

Here is an example of the full command line string available: Most items are optional unless otherwise stated

msiexec /Option <Required Parameter> [Optional Parameter] [PROPERTY=PropertyValue]

N.B. Please note that the indicated string content must begin and end with double quote marks (")!

Possible options for msiexec are:

Options  Parameter 
DESCRIPTION
  /package or /i
<Product.msi>
Installs or configures a product.
 /a <Product.msi>
Administrative install - Installs a product on the network.
 /j <u|m>
<Product.msi>
Advertises  a product - m to all users, u to current user.
Additional parameters can be used:
[/t <Transform List>]
[/g<Language ID>]
 /uninstall /x
<Product.msi>
Uninstall the product. Parameter can be .msi file or Product Code.
  /quiet

Quiet mode - Installs the application without user interaction.
  /passive

Unattended mode - progress bar only.
 /q[n|b|r|f]

Sets user interface level:
n - no UI
b - Basic UI
r - Reduced UI
f - Full UI (default)
 /norestart

Do not restart after the installation is complete.
 /promptrestart

Prompts the user for restart if necessary.
 /forcerestart

Always restart the computer after installation.
 /l  <LogFile>  Defines logging level for installation. Possible modifiers are:
i - Status messages
w - Nonfatal warnings
e - All error messages
a - Start up of actions
r - Action-specific records
u - User requests
c - Initial UI parameters
m - Out-of-memory or fatal exit information
o - Out-of-disk-space messages
p - Terminal properties
v - Verbose output
x - Extra debugging information
+ - Append to existing log file
! - Flush each line to the log
* - Log all information, except for v and x options
 /log  <LogFile>  Equivalent for /l* <LogFile>
 /f  <Product.msi> Repairs a product. Parameter is an .msi file or Product Code.
May have the following modifiers:
p - only if file is missing
o - if file is missing or an older version is installed (default)
e - if file is missing or an equal or older version is installed
d - if file is missing or a different version is installed
c - if file is missing or checksum does not match the calculated value
a - forces all files to be reinstalled
u - all required user-specific registry entries (default)
m - all required computer-specific registry entries (default)
s - all existing shortcuts (default)
v - runs from source and recaches local package
For additional options and more detailed description please refer to Microsoft Web Sites.


Properties

Public properties defined by PDF-XChange installation may be specified as well as standard MSI public properties. For complete list of standard public properties please refer to: http://msdn.microsoft.com/en-gb/library/aa370905(VS.85).aspx

Most useful properties are:
 ADDLOCAL  <list of features>
The value of the ADDLOCAL property is a list of features that are delimited by commas, and are to be installed locally. PDF-XChange PRO installer defines the following features:
F_Drivers - components of PDF-XChange driver;
F_Help_Drv – Help file for driver, OfficeAddin and Office2PDF. Requires F_Drivers.
F_Langs_Drv – Localization files for the Driver, OfficeAddin and
Office2PDF.  Requires F_Drivers.
F_Wizard – PDF-Tools application.
F_Help_Wiz – Help file for PDF-Tools. Requires F_Wizard
F_Langs_Wiz – Language localization files for PDF-Tools. Requires F_Wizard
F_Office2PDF – components of Office2PDF. Requires F_Drivers
F_OfficeAddin – Addin for MS Office applications for converting documents to PDF.  Requires F_Drivers
F_IEAddin – Addin for MS Internet Explorer which allows to convert web pages to PDF files.
F_Viewer – PDF-XChange Editor and main components.
F_VLangs – Localization files for the Editor. Requires F_Viewer.
F_Plugins – Plugins modules for the Editor. Requires F_Viewer. If specified, the following features can be used to install plugins:
     F_Plugin_SP – to install SpellChecker plugin. Requires F_Plugins
     F_FileOpenPlugin – install plugin that provide support for file            secured by FileOpen. Requires F_Plugins
     F_ReadOutLoudPlugin – install the plugin that provides read out      loud functionality. Requires F_Plugins
     F_OCRPlugin – install plugin that allow OCR image based PDF            files in the Editor.  Requires F_Plugins.
F_BrowserPlugins – plug-ins for web browsers (MS Internet explorer, Mozilla FireFox, Opera, Safari, and Chrome) which allows viewing PDF files inside these browsers. Requires F_Viewer as well as F_IEPlugin and/or F_NPPlugin.
     F_IEPlugin – IE plugin. Requires F_BrowserPlugins and                      F_Viewer.
     F_NPPlugin – Firefox, Chrome, Safari and Opera plugin. Requires        F_BrowserPlugins and F_Viewer.
F_ShellExt – Plugins for Windows Explorer and Windows shell. These
extensions allows to view PDF thumbnails into Windows Explorer,
shows properties of PDF files, handling preview of PDF files into
Windows Vista and Office 2007, provides IFilter component which
allows Windows Desktop Search engine to make search inside PDF
files;
 INSTALLLOCATION    Specifies the folder where products will be installed.
 PNAME <name> Specifies the name of the printer which will be used. Default value is "PDF-XChange Printer 2012"
 SET_PRINTER_AS_DEFAULT
  If specified and has value of "1", PDF-XChange printer will be set as default printer after installation. If not specified, PDF-XChange printer will not be set as default.
 SET_AS_DEFAULT

If not specified or specified and has value of "1", PDF-XChange Editor will be set as default application for PDF files.
 VIEW_IN_BROWSERS

If not specified or specified and has value of "1", PDF-XChange Editor will be configured to open PDF files inside browsers.
 DESKTOP_SHORTCUTS

If not specified or specified and has value of "1" installer will place shortcuts for installed application on Desktop.
 PROGRAMSMENU_SHORTCUTS

If not specified or specified and has value of "1" installer will create program menu group for installed application and their components.
 USERNAME
<username>
Specifies the username for which applications will be registered.
 ORGANIZATION
<oname>
Specifies the organization name for which applications will be registered.
 USERMAIL
<email>
Specifies the user email.
 KEYFILE
<xcvault file>
Specifies the UNC location of the license vault file <filename>.xcvault. 
 KEYDATA <regkey>   Specifies registration key. 
 EDITOR_LANGUAGE <id>*   Specifies a language for the Editor.  Requires F_Vlangs
 DDEFLANGID <id>**   Specifies a language for the print driver.  Requires F_Langs_Drv
 PDEFLANGID  <id>**  Specifies a language for PDF-Tools.  Requires F_Langs_Wiz


* <id> for your target language can be found here: http://msdn.microsoft.com/en-us/library/ee825488(v=cs.20).aspx
The “Language Culture Name” is used with EDITOR_LANGUAGE.  – E.g. for German use de-DE

** <id> for your target language can be found here: http://msdn.microsoft.com/en-us/library/ee825488(v=cs.20).aspx
Use the “Culture Code” for DDEFLANGID and PDEFLANGID. It is in hexadecimal, it must be converted to decimal for use.  – E.g. for German use 1031 (1031 is decimal for the hex value 0x0407)




Command-line Examples:

1. Install the application in quiet mode (no user input) to folder "C:\Program Files\Tracker":
msiexec /i PDFXC5Pro_x64.msi /quiet INSTALLLOCATION="C:\Program Files\Tracker"

2. Install the application in quiet mode to default folder. Specify the user license info with key as a string:
msiexec /i PDFXC5Pro_x64.msi /quiet USERNAME="John Smith" USERMAIL="abc@a.b.c" KEYDATA="PXP50-fgte.....+ZeuiMCiV3Vc6Z0A="

3. Install the application in quiet mode to default folder. Specify the user license info with key as a vault file:
msiexec /i PDFXC5Pro_x64.msi /quiet USERNAME="John Smith" USERMAIL="abc@a.b.c" KEYFILE="\valid\UNC\path\to\vault\file.xcvault"

4. Install only PDF-XChange, Office add-in, and PDF Tools. Specify new name for the printer:
msiexec /i PDFXC5Pro_x64.msi /quiet ADDLOCAL="F_Drivers,F_OfficeAddin,F_Wizard" PNAME="My PDF Printer"

5. Install all products in using German for the application UI.  If ADDLOCAL is not called then all features, including all languages, are available to the installer and the following properties can be used.  If ADDLOCAL is used to specify components and an alternative language it to be used then the corresponding language component(s) (F_Vlangs, F_Land_Drv and/or F_Langs_Wiz) MUST be explicitly called:
msiexec /i PDFXC5Pro_x64.msi /quiet EDITOR_LANGUAGE=de-DE DDEFLANGID=1031 PDEFLAGID=1031



See also


Was this information helpful?YesNo