Post on 18-Jun-2018
Citrix Ready Workspace Hub Preview Installation and Configuration
Citrix Ready Workspace Hub Preview
Contents
Disclaimer...................................................................................................................................................... 1
Overview ....................................................................................................................................................... 2
About Citrix Ready workspace hub ........................................................................................................... 2
System Requirements ............................................................................................................................... 2
Upgrade HDX Ready Pi .............................................................................................................................. 2
Initial setup with internal centralized management..................................................................................... 3
Initial setup with XenMobile ......................................................................................................................... 3
Configuration with no centralized management .......................................................................................... 4
XenApp/XenDesktop configuration .............................................................................................................. 5
Skype for Business .................................................................................................................................... 5
Performance policy ................................................................................................................................... 5
Dual monitor setup ....................................................................................................................................... 7
Enable the Citrix Ready workspace hub in Citrix Receiver............................................................................ 7
Session roaming with proximity authentication ......................................................................................... 10
Session roaming with QR code authentication ........................................................................................... 11
Screen casting with QR code authentication .............................................................................................. 12
Long running session ................................................................................................................................... 14
Security connection .................................................................................................................................... 14
Shortcuts ..................................................................................................................................................... 16
Known Limitations ...................................................................................................................................... 16
Support Information ................................................................................................................................... 17
Citrix Ready Workspace Hub PreviewDisclaimerCitrix Ready Workspace Hub PreviewCitrix Ready Workspace Hub Preview 1
Disclaimer
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CITRIX AND ITS SUPPLIERS MAKE AND YOU
RECEIVE NO WARRANTIES OR CONDITIONS, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE,
AND CITRIX AND ITS SUPPLIERS SPECIFICALLY DISCLAIM WITH RESPECT TO THIS RELEASE
ANY CONDITIONS OF QUALITY, AVAILABILITY, RELIABILITY, SECURITY, LACK OF VIRUSES,
BUGS OR ERRORS, OR SUPPORT AND ANY IMPLIED WARRANTIES, INCLUDING, WITHOUT
LIMITATION, ANY WARRANTY OF TITLE, QUIET ENJOYMENT, QUIET POSSESSION,
MERCHANTABILITY, NONINFRINGEMENT, OR FITNESS FOR A PARTICULAR PURPOSE. TO THE
EXTENT PERMITTED BY APPLICABLE LAW, NEITHER CITRIX, NOR ITS SUPPLIERS SHALL BE
LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL, MULTIPLE,
PUNITIVE OR OTHER DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF
DATA, LOSS OF INCOME, LOSS OF OPPORTUNITY, LOST PROFITS, COSTS OF RECOVERY OR
ANY OTHER DAMAGES), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, AND
WHETHER OR NOT FOR BREACH OF CONTRACT, NEGLIGENCE OR OTHERWISE, AND
WHETHER OR NOT CITRIX, ITS SUPPLIERS, OR LICENSORS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. This document is furnished "AS IS." CITRIX DISCLAIMS ALL
WARRANTIES REGARDING THE CONTENTS OF THIS DOCUMENT, INCLUDING, BUT NOT
LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR ANY
PARTICULAR PURPOSE. This document may contain technical or other inaccuracies or
typographical errors. Citrix reserves the right to revise the information in this document at any
time without notice. This document and the software described in this document constitute
confidential information of Citrix and its licensors, and are furnished under a license from
Citrix. This document and the software may be used and copied only as agreed upon by the
Technology Preview Agreement.
Citrix Ready Workspace Hub Preview Overview 2
Overview
The Citrix Ready workspace hub combines digital and physical environments to deliver apps
and data within a secure smart space. The complete system connects devices (or things), like
mobile apps and sensors, to create an intelligent and responsive environment.
As a component of the Citrix Workspace experience, Citrix Ready workspace hub is built on
the Raspberry Pi 3 platform and becomes a robust service delivered through Citrix Cloud. At
the same time, a secure connection establishes to authorized apps and data. The complete
package is an off-the-shelf IoT edge device that integrates workflows and hardware within
the smart space environment.
Citrix Ready workspace hub users must authenticate their mobile device through Citrix
Receiver to run published apps or desktops like Citrix XenApp and XenDesktop, Citrix
ShareFile, and Microsoft Outlook. The mobile device then connects to the Citrix Ready
workspace hub and casts the desktop or app on a larger display.
Note: This preview is limited for use with Android mobile devices and Citrix Receiver for
Android 3.13.4 or later.
About Citrix Ready workspace hub
Citrix Ready workspace hub enables Citrix Casting, which offers two use cases that improve
user productivity and collaboration. Citrix Casting leverages beacon detection or a QR code
scanner for connecting. With beacon detection, if multiple Citrix Ready workspace hubs are
available, the user must select the appropriate hub. A QR code scanner provides security to
mitigate unintentional casting to the wrong display.
Session roaming - A Citrix session roams from the mobile device to the workspace hub.
Screen casting – The user redirects their display from a remote session to an
unoccupied hub.
Additionally, the admin can set up a smart space environment with multiple display monitors
by using the Secondary Display Adapter. This permits the user to extend the desktop or app
when using either use case.
Citrix Ready Workspace Hub Preview Overview 2
System Requirements
Network
The mobile device must be on the same network as the workspace hub.
Port 55555 must not be blocked between the mobile device and the workspace hub.
For Citrix Casting, ports 1494 and 8500 must not be blocked.
Port 55556 is the default port for SSL connections between mobile devices and the
Citrix Ready workspace hub. You can configure a different SSL port on Pi’s settings
page. If the SSL port is blocked, users cannot establish SSL connections to the hub.
Citrix XenDesktop
Citrix Ready workspace hub is supported on Citrix XenDesktop 7.6 and later.
For session roaming, make sure the Citrix Ready workspace hub can access HDX
servers (VDA).
For session roaming and screen casting, make sure “Use video codec for compression”
policy in Citrix Studio is set to “For the entire screen.” Failure to do so will cause the
screen to crash.
Hardware
Citrix Ready workspace hub
Monitor * 2
Mobile device running Citrix Receiver
HDMI cable and power supply
MicroUSB to USB A Cable (if a Secondary Display Adapter [SDA] is used)
Optional hardware, such as a USB keyboard, USB mouse, or headphones
Second display adapter (SDA) powered by Raspberry Pi Zero.
As of April 2018, only Android devices with Citrix Receiver for Android 3.13.5 and later are
supported. Citrix is planning to port the functionality to other Citrix Receiver platforms in
future releases.
Upgrade HDX Ready Pi
To upgrade an existing HDX Ready Pi device to a Citrix Ready workspace hub, refer to the
following procedures.
Viewsonic: https://www.stratodesk.com/t25-upgrade
nComputing: contact Stratodesk
Citrix Ready Workspace Hub Preview Initial setup with internal centralized management 3
Initial setup with internal centralized
management
To create a Stratodesk Management console, go to Stratodesk’s website and create an
account.
https://www.stratodesk.com/kb/Main_Page
Initial setup with XenMobile
In order to use XenMobile as the management solution for workspace hub, you will need to
configure workspace hub to point the central management URL to:
https://manageiot.xm.cloud.com:443/easyadmin/servlet/XmlRPC
Note: If you’ve previously pointed your device at a NoTouch Management console you may
need to reset the device to factory defaults.
Once pointed to that specific XenMobile instance, the workspace hub sits in a queue waiting
for an admin to take ownership of the device. To do this you need to log into your instance of
XenMobile and follow the instructions on how to add and manage a workspace hub:
https://docs.citrix.com/en-us/xenmobile/xenmobile-service/whats-
new.html#par_anchortitle_1886380862
Note: During the Citrix Ready workspace hub preview, it is not possible to update the
firmware or set up the Citrix Casting features while the workspace hub is managed by
XenMobile Service. XenMobile UEM management is limited to creating a StoreFront
connection today. There are updates planned to address this.
Citrix Ready Workspace Hub Preview Configuration with no centralized management 4
Configuration with no centralized
management
1. Start the Citrix Ready workspace hub device.
2. Go to Start > Configuration.
The default password is “admin”.
3. Go to Connections > Add.
4. Edit the new Connection and select Citrix/WorkspaceHub from Connection mode.
Click Save.
5. At the top of the screen, click the Workspace Hub button.
6. Enter the desired URL for Workspace Hub Launcher (add http:// or https:// to the URL).
Suggestions
NOBG,
Add this line to remove the default Citrix splash screen, after the comma you
can add any URL such as:
https://source.unsplash.com/1920x1080/?nature
This will give your workspace hub a random, yet attractive photo as the default
wallpaper.
<YOUR STOREFRONT URL>
This will make it so the workspace hub loads your companies StoreFront
webpage as the default wallpaper. One advantage to this is you can use the
Workspace Hub as a simple thin client by logging in and launching your apps as
normal.
7. Click Save.
8. Reboot the Citrix Ready workspace hub.
Citrix Ready Workspace Hub Preview XenApp/XenDesktop configuration 5
XenApp/XenDesktop configuration
You will need to make a few changes to your XenApp and XenDesktop configuration to make
sure you have the best experience with Citrix Ready workspace hub.
Skype for Business
In order to use Skype for Business RTME version 2.4 must be installed on the VDA. Earlier
versions will not work. Currently version 2.4 does not support dual display and this will be
addressed in the next version of RTME. The user needs to keep “Use Hardware Rendering =
Off” if RTME is being used (see the Performance policy section for more details).
Performance policy To get the best experience on your Citrix Ready workspace hub (and SDA) you’ll need to
enable H.264 for the full screen. To do this you will need to configure the following policy:
Create a new policy and enable video codec for compression (H.264) for the full screen.
Citrix Ready Workspace Hub Preview XenApp/XenDesktop configuration 6
Citrix Ready Workspace Hub Preview Dual monitor setup 7
Dual monitor setup
In order to support dual monitors a Secondary Display Adapter (SDA) is required. These can be
purchased from ViewSonic or nComputing.
Dual monitors and the SDA are not supported during the Tech Preview process, you may find
success but it is not recommended at this time to use dual monitors.
Enable the Citrix Ready workspace hub
in Citrix Receiver
The Citrix Ready workspace hub is disabled by default in Citrix Receiver for Android. To use the
hub with an Android device, use the following steps.
Device prerequisites:
Citrix Receiver for Android 3.13.5 or later installed
Bluetooth enabled (for proximity authentication)
Mobile device and workspace hub using the same wifi network
Proximity authentication provides a way to
authenticate users and launch a session
automatically.
To use proximity authentication enable
Bluetooth on the mobile device ensure that
the “Add account type as Web Interface”
check box is not selected when setting up
the Citrix Receiver account.
Citrix Ready Workspace Hub Preview Enable the Citrix Ready workspace hub in Citrix Receiver 8
In Citrix Receiver, go to Settings and select
Use Workspace Hub.
Click Configuration to bring up the
Configuration page.
Touch-Free mode is a switch that lets you enable or disable proximity authentication. When
touch-free mode is off, proximity authentication is not available but the other functions of the
Citrix Ready Workspace Hub Preview Enable the Citrix Ready workspace hub in Citrix Receiver 9
Citrix Ready workspace hub are. To use touch-free mode, Bluetooth should be enabled on the
device.
RSSI represents the Bluetooth signal strength relative to the distance between the mobile
device and the hub. Entry RSSI is the range in which the workspace hub beacons are detected.
Exit RSSI is the beginning of the range outside of which of the mobile device no longer
communicates with the workspace hub. Exit RSSI must be equal to or less than Entry RSSI and
values must be negative. The default values are -40 (Entry RSSI) and -70 (Exit RSSI),
respectively. You can adjust these values depending on your environment and your range
from the workspace hub.
As shown below, when you move your mobile device into Range 1, proximity authentication is
triggered and your default desktop or app launches automatically on the workspace hub. As
long as the mobile device remains within Range 1 or 2, the default desktop or app keeps
running on the workspace hub. When you move the device out of Range 1 and 2, the desktop
or app closes automatically.
Hub
Entry RSSI
Exit RSSI
Range 1
Range 2
Preferred Resource is the default desktop or app that launches when the mobile device
enters the proximity authentication range. This setting is specific to the account used to log
into Citrix Receiver. If you have more than one account, you must set a preferred resource for
each. This setting is persistent, which means you need to set your preferred resource only
once per account. After you set in, your preferred resource launches every time you enter
proximity authentication range until you change the setting.
Citrix Ready Workspace Hub Preview Session roaming with proximity authentication 10
For additional information on Citrix Receiver for Android, see https://docs.citrix.com/en-
us/receiver/android/current-release.html
Session roaming with proximity
authentication
After the configuration is complete and Citrix Receiver is launched, the session will roam to
the Citrix Ready workspace hub when the device enters the proximity authentication range of
the hub.
If multiple hubs are within range, the
following dialog appears to let you select
your hub of choice to roam your session.
If multiple Citrix Ready workspace hubs are
within range and Citrix Receiver is running in
the background, a notification appears on
your mobile device.
Click the notification.
With proximity authentication, there are four ways to exit a session:
Move your mobile device out of Range 1 and 2.
Citrix Ready Workspace Hub Preview Session roaming with QR code authentication 11
Use two fingers to swipe down on the Citrix Receiver main interface.
Close Citrix Receiver.
Exit the Windows session on the Citrix Ready workspace hub.
Session roaming with QR code
authentication
To use session roaming with a QR code:
Launch a session on the mobile device.
Click the QR code scan button on the Citrix
Receiver toolbar to scan the QR code on the
Citrix Ready workspace hub.
The session starts roaming to the Citrix
Ready workspace hub.
Close the session using one of the following methods:
Use two fingers to swipe down on the Citrix Receiver main interface.
Close Citrix Receiver.
Exit the Windows session on the Citrix Ready workspace hub.
Citrix Ready Workspace Hub Preview Screen casting with QR code authentication 12
Screen casting with QR code
authentication
To enable screen casting with QR code authentication, you must change the configuration on
Citrix Ready workspace hub’s settings page.
1. Open System configuration.
2. Edit Connections named “Citrix Ready workspace hub”.
Citrix Ready Workspace Hub Preview Screen casting with QR code authentication 13
3. Under Connections > Citrix Ready workspace hub, change Work mode to Casting.
After screen casting the session to the Citrix
Ready workspace hub, Citrix Receiver on the
mobile device acts as soft keyboard and
mouse to control the session on the
workspace hub.
Citrix Ready Workspace Hub Preview Long running session 14
To close the session:
Use two fingers to swipe down on the Citrix Receiver main interface to return the
session to your mobile device.
Close the session in Citrix Receiver.
Exit the Windows session on then Citrix Ready workspace hub to close the session
both on your mobile device and on the hub. Note that it might take about 20 seconds
for the session on the hub to exit. (See Know Limitations)
Long running session
During a long running session, you can put the device down with the screen locked. To ensure
the session runs uninterrupted, consider the following tips:
Battery optimization can interfere with your session. To avoid the effects of battery
optimization, add Citrix Receiver to the Android battery optimization ignore list. To do
this:
On a Google Pixel, go to Settings > Battery > Battery optimization > All apps
> Citrix Receiver > Don’t optimize.
On most Samsung devices, go to Settings > Battery > Battery usage >
Optimize battery usage > All apps > Citrix Receiver > Don’t optimize.
If you’re using a third-party battery optimization app, remove Citrix Receiver
from its optimization list.
To lock the screen and put the device down for a longer time after the Citrix Ready
workspace hub session starts, Citrix recommends that you bring the Citrix Receiver’s
main interface to the foreground before locking your screen. This ensures that the
Android operating system will not end the Citrix Receiver session.
Security connection
SSL/TLS connections between mobile devices and the Citrix Ready workspace hub are
supported but disabled by default. You can enable them on the workspace hub’s
settings page. The SSL/TLS port is configurable. If you enable SSL/TLS, make sure that
the SSL/TLS certificate is loaded and its path configured correctly on the hub. Self-
signed certificates must be installed on Android devices before users start working
with the hub.
Citrix Ready Workspace Hub Preview Security connection 15
To configure SSL/TLS:
1. For information about adding certificates and private keys to the Citrix Ready
workspace hub, see:
https://www.stratodesk.com/kb/Certificates#Method_2:_Distribute_certificate
s_automatically
2. Change the “Require SSL” option to “on,” and update the certificate file
(cert.pem) and private key file (key.pem) names and then click Save. Both
options are under “Connections > Citrix Workspace Hub > Workspace Hub.”
Citrix Ready Workspace Hub Preview Shortcuts 16
Shortcuts
Control-Alt-S, gives a read out of some relevant information when troubleshooting.
Control-Alt-C, brings up the configuration menu.
When Citrix Casting, swiping down on the phone with two fingers disconnects the
session, regardless of the session state or how you casted to the workspace hub.
Known Limitations
In this release, Web Interface stores do not support session roaming. As a result, do
not select the Add account type as Web Interface check box.
While screen casting, if you exit your Windows session on the Citrix Ready workspace
hub by clicking Sign out or Disconnect in Windows, it may take around 20 seconds for
the session to exit on the hub.
Dual-monitor display crashes when H.264 is not set in policies. Dual monitor not
supported during Tech Preview.
To use RTME, Use Hardware Rendering must be set to “Off.” Note that the feature
works only on the primary screen, the window on the secondary screen is gray.
Wireless Mice - You may notice a lag when dragging the mouse if you are on a wireless
mouse. Please report this error in the Citrix workspace hub Discussions forum and the
make/model of the mouse if you get it.
Citrix Casting does not work when the mobile device is not connected to the same
network as the workspace hub.
5G Wireless - The workspace hub is built on the Raspberry Pi4 platform, which does
not support 5G wireless today, however it is possible to support 5G using a USB wifi
dongle (not recommended).
The root CA certificate must be signed with SHA256. Citrix Receiver for Linux does not
accept SHA1-signed certificates. https://support.citrix.com/article/CTX200114
Enlightened Data Transport (EDT) protocol is not supported with Citrix Ready
workspace hub.
Citrix Ready Workspace Hub Preview Support Information 17
Support Information
Support for this preview is available through the Citrix Discussions forum.
https://discussions.citrix.com/forum/1726-citrix-ready-workspace-hub-preview/
Support for the Citrix Ready workspace hub device is available through the approved vendors
NComputing, Stratodesk, and ViewSonic. For more information, contact the support
department at NComputing, Stratodesk, and ViewSonic.
Locations Corporate Headquarters | 851 Cypress Creek Road Fort Lauderdale, FL 33309, United States
Silicon Valley | 4988 Great America Parkway Santa Clara, CA 95054, United States
© 2018 Citrix Systems, Inc. All rights reserved. Citrix, the Citrix logo, and other marks appearing herein are property
of Citrix Systems, Inc. and/or one or more of its subsidiaries, and may be registered with the U.S. Patent and
Trademark Office and in other countries. All other marks are the property of their respective owner(s).