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. 


See Also

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  http://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. Select your optional features to install:

  • Lockdown Manager: This is required if you want to run Quicklaunch as a kiosk from a non-admin account.
  • Zoom Meeting Manager: this is required if you are using Zoom meetings.  Only applies to Ultimate Edition
  • Visual C++ Redistributable: this is required if you are using Zoom Meeting Manager and do not already have installed VC++ Redistributables for Visual Studio 2017


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





Video

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 Without Lockdown Manager:


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




Silent Install With Lockdown Manager:


  1. Lockdown Manager MUST be installed from the account that will be running Quicklaunch.  This account does not need admin privileges. It can be a standard domain account.
  2. The Quicklaunch Account must have already been set up 
  3. NOTE: To obtain the domain and user name for the command line below, open a NON-ELEVATED command prompt and enter "set".  Use the values of environment variables for USERDOMAIN and USERNAME.
  4. From ADMINISTRATIUVE command prompt, enter:


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




Silent Install With Zoom:


QuicklaunchInstallerx.x.x.x.exe ZOOM_INSTALL="1" 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




Silent Install With Zoom and VC++ redistributables


QuicklaunchInstallerx.x.x.x.exe /exenoui ADDLOCAL=ALL 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




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