CAUTION - this is a Beta Release

  • do not use in a production environment
  • only for registered customers
  • subject to change



Overview

Quicklaunch is moving from using Microsoft's ClickOnce installation technology to using MSI.  MSI provides much greater control over installation and the ability for remote installations.  


Quicklaunch's ClickOnce installation will be phased out during 2019. 


Features

The Quicklaunch MSI installer has several new features:

  • Automatically copies settings from old ClickOnce installations
  • Per machine installation - Quicklaunch is available to all users who log into a computer
  • Can specify location of install folder at install time
  • Can specify location of settings folder at install time
  • Quicklaunch can run under local user account that does not require admin privileges
  • Silent update without prompting for UAC
  • Can be pre-loaded onto computers
  • Can be silently installed from the command line
  • Can be incorporated into SCCM/GPO for installations
  • Lockdown Manager included as optional install


Requirements

  • Admin privileges are required for install and uninstall
  • Connection to the internet
  • Quicklaunch ClickOnce must be uninstalled prior to using the new MSI installer (prompted for this during install)
  • Quicklaunch and its associated files need to be whitelisted with Virus scanners
  • Lockdown Manager (kiosk mode) can only be used for a single user per machine


Install Process

1. Download the latest install package from http://qlinstall.ucworkspace.com/V4/Beta




2. Run the install package.  You will be prompted with the Quicklaunch Setup Wizard page:




3. Read the license agreement thoroughly:




4. Select if you want to install the Lockdown Manager.  This is required if you want to run Quicklaunch as a kiosk from a non-admin account.


5. Specify the locations for the installation files:

  • Product install path - This is for the Quicklaunch program files.  It is recommended you take the default.
  • Quicklaunch application data folder - This is for the Quicklaunch settings files, and other related Quicklaunch data files.  It is recommended you take the default.
  • Quicklaunch import folder - This is the folder for doing automatic settings imports.  It is recommended you take the default.



6.  You will be prompted for elevated (admin) privileges to install Quicklaunch


7. Quicklaunch will now install. It will copy over your existing Quicklaunch settings to the specified application data folder.




8. Once complete, you can view release notes.


9.  Click Finish and Quicklaunch will start.





Uninstall

To uninstall Quicklaunch go to Windows settings, Apps & Features.  Search for Quicklaunch and click Uninstall.  You will be prompted if you would like to delete your settings files (located in the App Data Folder specified during installation). Uninstall removes all Quicklaunch programs, registry entries, scheduled tasks, services.


Extracting the MSI from the Downloaded Install Executable (advanced, optional)

NOTE: this is an advanced topic and should only be done by technical support staff who are trained in Windows Installer.  

If you require the MSI file, it can be extracted from the downloaded install executable by the following command line:


QuicklaunchInstallerX.X.X.X.0.exe /extract "%temp%\qlinstall"


To install this MSI, use the following command:


msiexec /i QuicklaunchInstaller.msi



Command Line Installation for Silent Install (advanced, optional)

NOTE: this is an advanced topic and should only be done by technical support staff who are trained in Windows Installer.  



Without Lockdown Manager:


For silent install - from an administrative command prompt, enter:


QuicklaunchInstallerxx.xx.xx.xx.exe APPDIR="C:\Program Files (x86)\UC Workspace\" QL_SETTINGS_DIR="C:\ProgramData\UC Workspace\Quicklaunch\" QL_IMPORT_DIR="C:\ProgramData\UC Workspace\Quicklaunch\Import\" /L*V "%temp%\qlinstall.log" /qn




With Lockdown Manager:


  1. Lockdown Manager MUST be installed from the account that will be running Quicklaunch.  This account doe not the admin privileges, but will be prompted for elevated privileges during install.
  2. NOTE: To obtain the domain and user name for the command line below, open a command prompt (non-elevated) and enter "set".  Use the values of environment variables for USERDOMAIN and USERNAME.
  3. For silent install - from an administrative command prompt, enter:


QuicklaunchInstallerxx.xx.xx.xx.exe LOCKDOWNMANAGER_INSTALL="true" APPDIR="C:\Program Files (x86)\UC Workspace\" QL_SETTINGS_DIR="C:\ProgramData\UC Workspace\Quicklaunch\" QL_IMPORT_DIR="C:\ProgramData\UC Workspace\Quicklaunch\Import\" LOCKDOWN_MANAGER_USERNAME="domain\user" /L*V "%temp%\qlinstall.log" /qn



Technical Information


Registry Entries

Quicklaunch installer creates registry entries under HKLM\Software\UC Workspace.  These registry entries are critical to the operation of Quicklaunch and should not be altered.


Services

Quicklaunch installs a service under SYSTEM called QuickLaunchHelperService.  This process is used for automatic updates.  If automatic updates are not desired, this service can be disabled along with turning off updates in Quicklaunch settings.  Automatic updates are downloaded as MSI bootstrapper packages that are signed and verified with size and MD5.


Temporary Files

During installation and update, Quicklaunch creates temporary files.  These are placed in the user defined temporary folder (%TEMP%) and the system defined temporary folder (typically c:\windows\temp)


Event Logs

Quicklaunch installer creates a number of Quicklaunch Event sources under the Application event log.  All Quicklaunch event sources start with "Quicklaunch".


File Signing

All Quicklaunch installers, executables and libraries are signed from DigiCert to Iluminari Tech