gloob / gpii-wix-installer

WiX based Windows Installer for the GPII. This repository will be superceded by the core repository at: https://github.com/gpii/gpii-windows-installer

GPII Windows installer

WiX based Windows installer for GPII

Building

Requirements

• A local copy of the GPII/windows repository. You should be able to build the repository, so all requirements of building GPII/windows apply here as well.
• WiX Toolset v3.10
• MSBuild Extension Pack v4

Make sure MSBuild and the WiX folder are in the path.

Staging

• Build GPII/windows (including the listeners - see https://github.com/GPII/windows/blob/master/provisioning/build.bat)
• Edit line 10 of setup/build.cmd and replace C:\projects\gpii\windows with the path of your local GPII/windows repository (no trailing backslash)
• Run setup/build.cmd

Staging makes a private copy of the GPII/windows repository inside the staging folder and uses that for building the installer. Any files not needed (eg Git and Vagrant related folders) are excluded.

After running build.cmd, an MSI file can be found in the output folder.
Whenever there are changes to the local GPII/windows repository, rerun build.cmd to make a new installer.

Unattended installation

The installer is a standard MSI file and as such it can be also executed using msiexec.exe and supports all the command-line options available to msiexec.exe.

To perform an unattended installation (requires administrative rights):

msiexec /qn /i GPII.msi

To perform an unattended installation and keep a verbose log to log.txt:

msiexec /qn /lv log.txt /i GPII.msi

To silently uninstall:

msiexec /qn /x GPII.msi

Customizing

You can pass a number of property key/values to the installer to customize its behavior.
For example, to perform an unattended installation to C:\GPII:

msiexec /qn /i GPII.msi INSTALLFOLDER=C:\GPII

To perform an unattended installation to C:\GPII that does not include the listeners:

msiexec /qn /i GPII.msi INSTALLFOLDER=C:\GPII ADDLOCAL=GPIIFeature,VCRedist

To perform an unattended installation to C:\GPII that does not include the listeners and creates no desktop shortcuts:

msiexec /qn /i GPII.msi INSTALLFOLDER=C:\GPII ADDLOCAL=GPIIFeature,VCRedist DESKTOP_SHORTCUTS=0

The list of possible properties include:

Name	Value	Description
INSTALLFOLDER	A folder name Default: C:\Program Files\GPII or C:\Program Files (x86)\GPII	The installation folder
ADDLOCAL	Comma (,) separated list </br/>Possible values: GPIIFeature VCRedist USBListenerFeature RFIDListenerFeature ALL (Default)	The GPII features that will get installed. It is advisable to always include GPIIFeature (the main GPII platform) and VCRedist (the Visual C++ Redistributable Package) and only use this property to control installation (or not) of the listeners.
SHORTCUTS	0 or 1 (Default)	Whether or not to create any desktop and start menu shortcuts
DESKTOP_SHORTCUTS	0 or 1 (Default)	Whether or not to create any desktop shortcuts
START_MENU_SHORTCUTS	0 or 1 (Default)	Whether or not to create any start menu shortcuts
GPII_SHORTCUTS GPII_DESKTOP_SHORTCUTS GPII_START_MENU_SHORTCUTS	0 or 1 (Default)	Whether or not to create shortcuts for the main GPII platform
USB_LISTENER_SHORTCUTS USB_LISTENER_DESKTOP_SHORTCUTS USB_LISTENER_START_MENU_SHORTCUTS	0 or 1 (Default)	Whether or not to create shortcuts for the USB Listener
RFID_LISTENER_SHORTCUTS RFID_LISTENER_DESKTOP_SHORTCUTS RFID_LISTENER_START_MENU_SHORTCUTS	0 or 1 (Default)	Whether or not to create shortcuts for the RFID Listener
GPII_AUTOSTART RFID_LISTENER_AUTOSTART USB_LISTENER_AUTOSTART	0 (Default) or 1	Whether or not to autostart the respective component on Windows sign in

An exhaustive list of other properties can be found at the Windows Installer Guide.