Overview

Quicklaunch has moved 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. 


See Also

Silent Upgrade from Quicklaunch V3 to Quicklaunch V4

SE Deployment Guide

PE Deployment Guide

UE Deployment Guide

Meeting Manager


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
  • For Lockdown Manager, QUicklaunch must be installed from the room account that will use Quicklaunch


Install Process

1. Exit Quicklaunch, If it is running.


2. Download the latest install package from  https://qlinstall.ucworkspace.com/



3. Run the install package.  


4.  If you have Quicklaunch installed, it will prompt you to remove it.  Follow the instructions:




5.  You will be prompted with the Quicklaunch Setup Wizard page:




6. Read the license agreement thoroughly:




7.  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.



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


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




11. Once complete, you can view release notes.


12.  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.



Cleaning up All Quicklaunch Files (e.g. Settings files)

See Complete Removal of Quicklaunch Settings



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 (replace the x.x.x.x with your downloaded version number):


QuicklaunchInstallerX.X.X.X.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.  



Silent Install 


For silent install - from an administrative command prompt, enter (replace the x.x.x.x with your downloaded version number)


QuicklaunchInstallerx.x.x.x.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



To start lockdown manager.

  1. from the conference room account, from a NON-ELEVATED command prompt
  2. run the command:
C:\Program Files (x86)\UC Workspace\Lockdown Manager\Quicklaunch.LockdownManager.exe enable





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 



Quicklaunch uninstall fails with an error "Quicklaunch.x.x.x.x msi is missing in %AppData%\Roaming"

Solution:
- Download the same version of the Quicklaunch from https://qlinstall.ucworkspace.com/archive/

- Extract the MSI in Command Prompt using this command QuicklaunchInstallerX.X.X.X.exe /extract  

- Navigate to the Windows Installed Apps menu and Click on Uninstall

- Point the location to where the extracted MSI is on your PC