Overview of Running Windows Workspot Client in Kiosk Mode
Kiosk mode lets users run applications using Workspot without requiring them to enter their email and on-board as is required in non-kiosk mode.
- Workspot Enterprise Connector
- Active Directory [AD] Integration
- Download Workspot Client MSI
Installer Runtime Switches for use with the Workspot Windows Client
For Desktop Mode:
msiexec /i WorkspotSetup64.msi BZ.FIXED_INSTALL_ARGUMENTS="/LOG=%temp%\WorkspotInstall.log /mode=Workspot /VERYSILENT /SUPPRESSMSGBOXES /skiprdpversioncheck=true" /LOG %temp%\WorkspotInstallMSI.log /quiet
For Kiosk Mode:
msiexec /i WorkspotSetup64.msi BZ.FIXED_INSTALL_ARGUMENTS="/LOG=%temp%\WorkspotInstall.log /domain=org.domain.com /mode=kiosk /closebutton=disable" /log %temp%\WorkspotInstallMSI.log
Installer switches can be specified two ways:
For the MSI, the format is:
msiexec /Option <Required Parameter> [Optional Parameter]
</package | /i> <Product.msi>
Installs or configures a product
Administrative install - Installs a product on the network
/j<u|m> <Product.msi> [/t <Transform List>] [/g <Language ID>]
Advertises a product
m to all users, u to current user
Uninstalls the product
</uninstall | /x> <Product.msi | ProductCode>
General Usage Switches
/mode=kiosk or workspot
If value is: kiosk - This is used to set up kiosk mode (the /domain flag must be used with this switch or it will result in an install error). In this mode, users will use their domain credentials to login to Workspot.
If value is: workspot – This mode is used to setup Workspot on Windows based endpoints that are used by multiple users. The Workspot client will be installed so multiple users can access the same program files while the user configuration and entitlements will remain with the user profile.
/closebutton=close, disable or minimize
The installation time option is used to determine the behavior of the Close (X) button on the Workspot Windows client. If this switch is not included or included with “close”, the button will function normally. If “disable” is selected, the button will be greyed out. If “minimize” is chosen, when the button is hit, the Workspot client will minimized to the taskbar. This switch is only applicable when used with the /mode=kiosk. If this option is not present during kiosk installation, the default action for the button is close.
This switch will set the "Use all monitors for Remote Desktop" when Workspot starts the first time. This is most useful for Kiosk mode, where the settings are not (supposed to be) persistent. For Kiosk mode, this is included in the BZ.FIXED_INSTALL_ARGUMENTS.
Value is the domain (this is used with kiosk mode). For example: /domain=org.domain.com
This switch is used to force the client to not use the end points video hardware graphics card to decode the video and use software decoding for OpenGL based graphics. Using this flag will increase CPU utilization.
Suppress installation messages for the batch run so it will not stop to wait for user input.
Detailed output goes to a log file. This is useful for debugging or when silent mode is used. The installation supports creating both log files.
If the parameter is specified inside the “BZ.FIXED_INSTALL_ARGUMENTS” section, install log details will be created for the Workspot components.
Usage: /LOG filename
When the option is specified for the msi parameters, Microsoft MSI installation details such as error codes, tasks and sources.
This is a switch directly for msiexec. When specified, the install will run silently. /VERYSILENT /SUPPRESSMSGBOXES are still needed.
Steps for a Successful Workspot Client Windows-Kiosk Installation
- Windows Workspot Client Installer and Kiosk Invocation
- Windows Workspot Client Installer Launched into Kiosk Mode Successfully
- Accept License Agreement
- Ready To Install Kiosk
- Progress Bar While Installing Kiosk
- Successful Kiosk Install
- Registry Settings Review
- Simple User Credentials
- Windows Workspot Client Installer and Kiosk Invocation: Kiosk mode installation occurs when you run the Windows Workspot Client installer with the appropriate parameters.
i.e: msiexec /i WorkspotSetup64.msi BZ.FIXED_INSTALL_ARGUMENTS="/LOG=c:\install.log /mode=kiosk /domain=corp.mycompany.local"
For additional guidance see Installer Runtime Switches for use with the Workspot Windows Client above.
For example, Figure 1 shows the execution of WorkspotSetup64[.msi] in the CMD prompt with the mode and domain parameters set accordingly, /mode=kiosk /domain=<fqdn>.
Figure 1 - Windows Workspot Client Installer and Kiosk Invocation
- Windows Workspot Client Installer Launched into Kiosk Mode Successfully Figure 2 - Windows Workspot Client Installer Launched into Kiosk Mode Successfully
- Accept License Agreement Figure 3 - Accept License Agreement
- Ready To Install Kiosk Figure 4 - Ready To Install Kiosk
- Progress Bar While Installing Kiosk Figure 5 - Progress Bar While Installing Kiosk
- Successful Kiosk Install Figure 6 - Successful Kiosk Install
- Registry Settings Review: The Workspot client will look to HKCU to determine if kiosk mode is set. The Windows Workspot installer takes /mode=kiosk flag and writes the following registry entry to define kiosk mode: HKCU\Software\Workspot\Settings\General ProductMode=Kiosk. Figure 7 - Registry Settings Review
- Simple User Credentials
Figure 8 - Simple User Credentials