Citrix Ready Workspace Hub

Citrix Ready Workspace Hub 将数字环境和物理环境结合在一起,在安全的智能空间中交付应用程序和数据。完整的系统连接了设备(或一些对象),例如移动应用程序和传感器,以创建智能化的响应环境。

Citrix Ready Workspace Hub 在 Raspberry Pi 3 平台上构建,并且成为通过 Citrix Cloud 交付的强大服务。Citrix Ready Workspace Hub 用户可以通过 Citrix Workspace 应用程序对其移动设备进行身份验证,以运行已发布的应用程序或桌面。例如,Citrix Virtual Apps and Desktops、Citrix Content Collaboration 和 Microsoft Outlook。然后,移动设备将连接到 Citrix Ready Workspace Hub,并将桌面或应用程序投射到更大的显示器上。

Citrix Ready Workspace Hub 启用了 Citrix Casting,它提供了两个提高用户工作效率和协作的用例。

  • 会话漫游 - Citrix 会话从移动设备(Android 设备)漫游到 Workspace Hub。
  • 屏幕投射 - 用户从 Android 或 Windows 设备将其显示内容从远程会话重定向到未占用的 Hub。

Citrix Casting 使用信标检测或 QR 代码扫描仪进行连接。使用信标检测时,如果多个 Citrix Ready Workspace Hub 都可用,用户必须选择恰当的 Hub。此外,通过 QR 代码扫描仪,可以安全地缓解意外投射到错误的显示器带来的风险。

此外,管理员还可以使用辅助显示适配器 (SDA) 设置一个包含多台显示器的环境。这样将允许最终用户在使用用例时扩展桌面或应用程序。

系统要求

网络

  • 移动设备必须与 Workspace Hub 位于相同的网络中。
  • 请勿在移动设备与 Workspace Hub 之间阻止端口 55555。
  • 对于 Citrix Casting,请勿阻止端口 1494。
  • 端口 55556 为移动设备与 Citrix Ready Workspace Hub 之间的 SSL 连接的默认端口。可以在 Pi 的设置页面上配置不同的 SSL 端口。如果阻止了 SSL 端口,用户将无法与 Hub 之间建立 SSL 连接。

Citrix Virtual Desktops

Citrix Ready Workspace Hub 在 Citrix XenDesktop 7.6 及更高版本中受支持。

  • 对于会话漫游,请确保 Citrix Ready Workspace Hub 可以访问 HDX 服务器 (VDA)。
  • 对于会话漫游和屏幕投射,请确保 Citrix Studio 中的使用视频编解码器进行压缩策略设置为针对整个屏幕。否则可能会导致出现性能问题。

硬件

  • Citrix Ready Workspace Hub
  • 两个显示器(仅适用于双显示器设置)
  • 运行 Citrix Workspace 应用程序的移动设备
  • HDMI 电缆和电源
  • Micro USB 到 USB A 电缆(如果使用辅助显示适配器 [SDA])
  • 可选硬件,例如 USB 键盘、USB 鼠标或耳机
  • Raspberry Pi Zero 提供支持的 SDA

截至 2018 年 9 月,我们支持运行以下操作系统和 Citrix Receiver 或 Citrix Workspace 应用程序版本的设备:

  • Android:Citrix Receiver 3.13.5 及更高版本;适用于 Android 的 Citrix Workspace 应用程序 1808 及更高版本
  • Mac:适用于 Mac 的 Citrix Workspace 应用程序 1808(预览版,仅限屏幕投射)
  • Windows:适用于 Windows 的 Citrix Workspace 应用程序 1809(仅限屏幕投射)

升级 HDX Ready Pi

要将现有 HDX Ready Pi 设备升级到 Citrix Ready Workspace Hub,请参阅以下过程。

通过内部集中式管理完成的初始设置

要创建 Stratodesk 管理控制台,请转到 Stratodesk 的 Web 站点并创建一个帐户。 https://www.stratodesk.com/kb/Main_Page

Citrix Endpoint Management 的初始设置

要将 Citrix Endpoint Management 用作 Citrix Ready Workspace Hub 的管理解决方案,需要将 Workspace Hub 配置为指向中央管理 URL。请按照 Citrix Endpoint Management Server 上记录的步骤进行操作。

注意

如果之前已在 NoTouch 管理控制台上指出您的设备,可能需要将该设备重置为出厂默认设置。

不通过任何集中式管理功能进行的配置

  1. 启动 Citrix Ready Workspace Hub 设备。
  2. 转至启动 > 配置。默认密码为 admin。
  3. 转至连接 > 添加
  4. 编辑新连接并从“连接模式”中选择 Citrix/WorkspaceHub。单击保存
  5. 在屏幕顶部,单击 Workspace Hub 按钮。
  6. 键入所需的 Workspace Hub 启动器的 URL(在 URL 中添加 http://https://)。该 URL 通常指向 StoreFront 或 Citrix Gateway URL;但是,您可以将其指向要在引导时显示的任何 URL。
  7. 单击保存
  8. 重新启动 Citrix Ready Workspace Hub。

Citrix Virtual Apps and Desktops 配置

请对您的 Citrix Virtual Apps and Desktops 配置做几项更改,以确保使用 Citrix Ready Workspace Hub 时能够获得最佳体验。

Skype for Business

要使用 Skype for Business,请在 VDA 上安装 HDX RealTime Optimization Pack 版本 2.4。如果正在使用 Optimization Pack,请将使用硬件呈现设置为(有关更多详细信息,请参阅下面的“性能策略”部分)。

注意

版本 2.4 当前不支持双显示器。

性能策略

要在 Citrix Ready Workspace Hub(和 SDA)上获得最佳体验,请对全屏模式启用 H.264 编码。为此,请创建一个策略,并对全屏模式启用视频编解码器以进行 H.264 压缩 (H.264)。

性能策略设置图片

压缩图片

要确认已对全屏模式启用 H.264 压缩以便 SDA 能够正常运行,请参阅以下过程之一。

  • 查看来自 Deliver Controller 的 Citrix 策略。
  • 在 VDA 会话中,使用 HDX Monitor 3.x。请参阅知识中心文章 CTX135817
  • 在 VDA 会话中,将以下行置于终端中:wmic /namespace:\\root\citrix\hdx path citrix_virtualchannel_thinwire get /value

然后可以验证是否已为全屏 H.264 模式正确配置图形模式:

  1. Component_VideoCodecUse = FullScreen
  2. Component_Encoder = DeepCompressionV2Encoder
  3. IsActive = Active

如果为选择性屏幕 H.264 配置了图形模式,请确认:

  1. Component_VideoCodecUse = 针对主动变化的区域
  2. Component_Encoder = CompatibilityEncoder
  3. IsActive = Active

双显示器设置

要支持双显示器,需要使用辅助显示适配器 (SDA)。可以从 ViewSonic 或 NComputing 购买 SDA。有关详细信息,请参阅 https://www.stratodesk.com/kb/Multimonitor

物理设置

SDA 中有两个 Micro USB 端口。其中一个标记为 Power,另一个标记为 USB。将标准 Raspberry Pi USB 电源适配器插入到电源端口中,然后使用标准 USB-to-USB 电缆将 SDA 的 USB 端口连接到 Citrix Ready Workspace Hub。

软件设置

请参阅上面的 Citrix Virtual Apps and Desktops 配置部分。请按照在两个屏幕上设置 H.264 呈现中的性能策略进行操作。

将会话漫游到 Citrix Ready Workspace Hub 时,可以自动启动双显示器。要更改布局和对齐配置,请在 Stratodesk 管理控制台中,转至配置路径 Connections(连接)> Workspace Hub > Citrix Workspace 应用程序 > Secondary Display Adapter(辅助显示适配器)

SDA 图片

Citrix Workspace 应用程序中的 Citrix Ready Workspace Hub

默认情况下,Citrix Ready Workspace Hub 在 Citrix Workspace 应用程序中处于禁用状态。

要在 Android 设备中使用 Workspace Hub,请参阅配置中的“Citrix Ready Workspace Hub”部分。

要在 Windows 设备中使用 Workspace Hub,请参阅配置 Citrix Ready Workspace Hub

在 Citrix Ready Workspace Hub 1809 版中,Citrix 引入了适用于 Mac 的屏幕投射功能作为预览版。要参与预览版,请联系 https://podio.com/webforms/20584651/1410453

使用邻近身份验证的会话漫游

邻近身份验证可以自动对用户进行身份验证并启动 HDX 会话,无需用户触控移动设备。邻近身份验证依赖于蓝牙技术来定位移动设备。

配置完成并启动 Citrix Workspace 应用程序后,当 Android 设备进入 Hub 的邻近身份验证范围时,会话将漫游到 Citrix Ready Workspace Hub。

如果范围内存在多个 Hub,系统将显示以下对话框,以使您选择会话要漫游到的 Hub。

选择 Hub 图片

如果范围内存在多个 Citrix Ready Workspace Hub,并且 Citrix Workspace 应用程序正在后台运行,您的移动设备上将显示一条通知。

单击该通知。

多个 Hub 图片

使用邻近身份验证时,可以通过四种方式退出会话:

  • 将移动设备移出范围 1 和 2。
  • 使用两根手指在 Citrix Workspace 应用程序主界面上向下轻扫。
  • 关闭 Citrix Workspace 应用程序。
  • 在 Citrix Ready Workspace Hub 中退出 Windows 会话。

使用 QR 代码身份验证的会话漫游

可以扫描 Hub 屏幕上的 QR 代码以漫游您的会话。

要在 Android 设备中使用利用 QR 代码的会话漫游,请执行以下操作:

  1. 在移动设备上启动会话。
  2. 单击 Citrix Workspace 应用程序工具栏中的 QR 代码扫描按钮以扫描 Citrix Ready Workspace Hub 上的 QR 代码。
  3. 会话将开始漫游到 Citrix Ready Workspace Hub。

QR 按钮图片

使用以下方法之一关闭会话:

  • 使用两根手指在 Citrix Workspace 应用程序主界面上向下轻扫。
  • 关闭 Citrix Workspace 应用程序。
  • 在 Citrix Ready Workspace Hub 中退出 Windows 会话。

使用 QR 代码身份验证的屏幕投射

要将 HDX 会话投射到 Hub,必须先在设备上启动 HDX 会话,然后在 Hub 上扫描 QR 代码。将会话投射到 Hub 后,可以在移动设备上使用键盘和鼠标来控制 Hub 上的会话。

必须更改 Citrix Ready Workspace Hub 的设置页面上的配置,才能在 Android 设备中启用使用 QR 代码身份验证的屏幕投射。

  1. 打开 System configuration(系统配置)。

    “System configuration”(系统配置)图片

  2. 编辑名为 Citrix Ready Workspace Hub 的 Connections(连接)。

    编辑 Workspace Hub 图片

  3. Connections(连接)> Citrix Ready Workspace Hub 下,将 Work mode(工作模式)更改为 Casting(投射)。

    漫游图片

将会话屏幕投射到 Citrix Ready Workspace Hub 后,移动设备上的 Citrix Workspace 应用程序将用作软键盘和鼠标以控制 Hub 上的会话。 软控制图片

要关闭会话,请执行以下操作:

  • 使用两根手指在 Citrix Workspace 应用程序主界面上向下轻扫以将会话返回到您的移动设备。
  • 关闭 Citrix Workspace 应用程序中的会话。
  • 退出 Windows 会话,然后退出 Citrix Ready Workspace Hub,以同时关闭您的移动设备和 Hub 上的会话。可能需要大约 20 秒钟的时间,Hub 上的会话才能退出。(请参阅“已知限制”)

长时间运行的会话

在长时间运行的会话过程中,可以在锁定屏幕后将 Android 设备放下。为确保会话持续不间断地运行,请注意以下提示:

  • 电池优化会影响您的会话。要避免电池优化产生的影响,请将 Citrix Workspace 应用程序添加到 Android 的电池优化忽略列表中:
    • 在 Google Pixel 中,转至设置 > 电池 > 电池优化 > 所有应用程序 > Citrix Receiver > 不优化
    • 在大多数 Samsung 设备中,转至设置 > 电池 > 电池使用情况 > 优化电池使用情况 > 所有应用程序 > Citrix Receiver > 不优化
    • 如果使用的是第三方电池优化应用程序,请从其优化列表中删除适用于 Linux 的 Citrix Workspace 应用程序。
  • 要在 Citrix Ready Workspace Hub 会话启动后锁定屏幕并放下设备较长时间,Citrix 建议您在锁定屏幕之前将 Citrix Workspace 应用程序的主界面置于前台。这样可以确保移动设备操作系统不会结束 Citrix Workspace 应用程序会话。

标准日志记录

此功能允许您记录 Citrix Ready Workspace Hub 中运行的进程的执行,并提供了一种动态更改不同模块的调试级别的方式。

配置

ctxlogd 守护程序和 setlog 实用程序包括在 Hub 软件包中。默认情况下,ctxlogd 守护程序将在启动 Hub 时启动。

ctxlogd 守护程序

跟踪的所有其他服务都基于 ctxlogd 守护程序。如果不希望保留跟踪的 Hub,可以通过终止与 ctxlogd 相关的进程来停止 ctxlogd 守护程序。日志文件 wsh.log 位于 /opt/Citrix/WorkspaceHub/Logs 下。

setlog 实用程序

通过 /opt/Citrix/WorkspaceHub/lib/wshlog 下的 setlog 实用程序,可以动态更改不同模块的调试级别。只有 root 用户有权运行该实用程序。可以在命令开头添加“sudo”以使用 pi 用户运行该命令。

例如:

  1. 要检查所有模块的当前日志级别,请运行以下命令:

    sudo /opt/Citrix/WorkspaceHub/lib/wshlog/setlog levels

  2. 要将 controlService 模块的日志级别设置为 verbose,请运行以下命令:

    sudo /opt/Citrix/WorkspaceHub/lib/wshlog/setlog level WSH_CONTROLSERVICE verbose

可以通过帮助手册“sudo /opt/Citrix/WorkspaceHub/lib/wshlog/ setlog –help”获取更多用法信息。

Citrix 客户体验改善计划

当您参与 Citrix 客户体验改善计划 (CEIP) 时,将向 Citrix 发送匿名的统计数据和使用情况信息,帮助提高 Citrix 产品的质量和性能。

Citrix Ready Workspace Hub 按照 How Google uses data when you use our partners’ sites or apps(当您使用我们的合作伙伴站点或应用程序时,Google 如何使用数据) 中所述使用 Google Analytics 进行数据分析。如果不希望将您的数据发送到 Google Analytics,可以关闭 CEIP。

CEIP 开关

默认情况下,您自动参与 CEIP。可以通过 Stratodesk UI 关闭 CEIP。

从 Workspace Hub 收集的 CEIP 数据

下表列出了收集的匿名信息类型。数据中不包含任何识别出您是客户的详细信息。

数据点 注册表项名称 说明
操作系统版本 os_release PI 操作系统的版本信息,例如 4.9.35-v7
OS 版本 os_version PI 操作系统的版本信息,例如 2017-07-05-raspbian-Jessie
Workspace Hub 版本 wsh_version Workspace Hub 的版本信息,例如 1.0.72
是否已启用 SSL 功能 ssl_mode 指示是否已启用 SSL 功能。1:已启用。0:已禁用
是否使用双显示器 monitor_mode 指示是否使用双显示器。1:双显示器。0:单显示器
显示器分辨率 monitor_resolution_p3 通过 p3 连接的显示器的屏幕分辨率
显示器分辨率 monitor_resolution_p0 通过 p0 连接的显示器的屏幕分辨率
会话持续时间(仅适用于会话漫游) session_time 会话的持续时间

安全连接

移动设备与 Citrix Ready Workspace Hub 之间的 SSL/TLS 连接受支持,但默认处于禁用状态。可以在 Hub 的设置页面上将其启用。SSL/TLS 端口可配置。如果启用了 SSL/TLS,请确保 SSL/TLS 证书已加载,并且其路径在 Hub 上正确配置。用户开始使用 Hub 之前,必须在 Android 设备上安装自签名证书。

要配置 SSL/TLS,请执行以下操作:

  1. 有关将证书和私钥添加到 Citrix Ready Workspace Hub 的信息,请参阅: https://www.stratodesk.com/kb/Certificates#Method_2:_Distribute_certificates_automatically
  2. Require SSL(需要 SSL)选项更改为 on(开),更改证书文件 (cert.pem) 和私钥文件 (key.pem) 名称,然后单击 Save(保存)。这两个选项都在 Connections(连接)> Workspace Hub > Workspace Hub 下。

SSL 图片

快捷方式

  • Control-Alt-S,读取相关故障排除信息。
  • Control-Alt-C,提取出配置菜单。
  • 使用 Citrix Casting 时,使用两根手指在手机上向下轻扫将断开会话连接,而无论会话状态为何,或者您如何投射到 Workspace Hub。

已知限制

  • Web Interface 应用商店不支持会话漫游。因此,请勿选中将帐户类型添加为 Web Interface 复选框。
  • 进行屏幕投射时,如果您通过在 Windows 中单击注销断开连接在 Citrix Ready Workspace Hub 中退出 Windows 会话,可能需要大约 20 秒钟的时间,Hub 上的会话才会退出。
  • 双显示器支持会话漫游。会话投射不受支持。
  • 要使用 HDX RealTime Optimization Pack,必须将使用硬件呈现设置为。此功能仅适用于主屏幕。辅助屏幕上的窗口显示为灰色。
  • 无线鼠标设备 - 拖动无线鼠标时您可能会发现滞后情况。在 Citrix Workspace Hub 讨论论坛中报告此错误。包括鼠标的制造商和型号。
  • 仅当移动设备与 Workspace Hub 连接到相同的网络时,Citrix Casting 才起作用。
  • 5G 无线网络 - Workspace Hub 在 Raspberry Pi3 平台上构建,当前不支持 5G 无线网络。但是,可以支持使用 USB Wi-Fi 硬件保护装置的 5G 网络(不推荐)。
  • 必须使用 SHA256 对根 CA 证书进行签名。适用于 Linux 的 Citrix Workspace 应用程序不接受 SHA1 签名的证书。 https://support.citrix.com/article/CTX200114
  • Citrix Ready Workspace Hub 不支持 Enlightened Data Transport (EDT) 协议。

故障排除

屏幕投射失败

Citrix Ready Workspace Hub 屏幕投射支持全屏 H.264 和选择性 H.264 图形模式。但是,为了获得最佳性能,Citrix 建议您使用全屏 H.264。如果遇到屏幕投射失败问题,请检查图形模式以确保其已正确配置。

“不兼容的服务器”消息

在适用于 Android 的 Citrix Workspace 应用程序中,会话投射失败会导致显示以下消息:

不兼容的服务器图片

如果图形模式在 VDA 中配置为选择性 H.264,则将出现此错误。屏幕投射在使用全屏 H.264 图形模式时性能更加出色。请在 System Configuration(系统配置)> Connections(连接)> Workspace Hub 中将图形模式重新配置为“全屏”,或者将 VDA 升级到版本 7.19 或更高版本。

SSL 相关问题

默认情况下,SSL 在 Citrix Ready Workspace Hub 中处于禁用状态。要启用 SSL/TLS,请确保 SSL 证书已加载,并且其路径在 Hub 上正确配置。SSL 配置问题会导致投射会话失败,但不显示错误消息。

用户问题 建议
WorkspaceHubControlService 进程未正确启动。 在终端上,输入以下命令:ps –ef|grep ControlService。如果找不到任何进程,请咨询 IT,确认端口 55555 和 55556 在网络中未被阻止。
SSL 处于启用状态,但证书未安装在 Hub 中,或者为其配置了不正确的证书路径。 请确认在 Citrix Ready Workspace Hub 中安装了证书和密钥文件。为此,请转至 /opt/Citrix/WorkspaceHub/keystore/certs 并确认是否已安装证书。如果使用 Stratodesk 映像,请按照该路径在 System Configure(系统配置)> Connections(连接)> Citrix Workspace Hub > Workspace Hub 中查找 ssl_enabled 配置项。如果使用 Citrix 映像,请检查 /opt/Citrix/WorkspaceHub/config/ 下是否存在 ssl.config 文件。
SSL 在 Citrix Ready Workspace Hub 中处于启用状态,但在 Android 客户端上未安装证书。 请在 Android 客户端上安装密钥文件。
DisplayConnector 进程正在运行。 DisplayConnector 进程的早期实例未正确终止。请终止该进程,并再次尝试投射。

会话漫游失败

设置新 Citrix Ready Workspace Hub 后会出现此问题。Workspace Hub 配置不适合 VDA 会话时,会话漫游将失败。

要解决此问题,请执行以下操作:

  1. 使用 Hub 上安装的适用于 Linux 的 Citrix Workspace 应用程序启动 VDA 会话。
  2. 验证 SSL 是否已正确配置。

已修复的问题

以下问题在版本 1809 中已修复:

  1. 如果您过快地走出范围,会话可能无法正确断开连接。

    [WH-602]

  2. 管理员无法设置 SSL 密钥和证书的完整路径。

    [WH-745]

  3. 您可能会遇到 Citrix Ready Workspace Hub 间歇性断开连接的问题。

    [WH-770]

  4. 会话处于空闲状态或者被锁定之后,Citrix Ready Workspace Hub 可能会断开与键盘的连接。

    [WH-790]

  5. 在选择性 H.264 图形模式下将视频从主屏幕移动到辅助屏幕时,Hub 屏幕可能会变得无响应。

    [WH-835]

  6. 执行屏幕投射操作时,蓝牙 MAC 地址在 StratoDesk 操作系统中始终相同。

    [WH-1060]

  7. 在会话漫游中,QR 代码始终针对选择性 H.264 图形模式在屏幕上显示。

    [WH-1071]

  8. 有时无法生成 QR 代码。

    [WH-1106]

已知问题

  1. 在 Microsoft Windows 10 会话桌面上存在非预期的黑色行。

    [WH-860]

  2. Hublauncher 可能会意外崩溃并显示 Hub 登录页面。 [WH-1371]

  3. 当您在 Windows 设备上退出扩展模式以便进行屏幕投射时,鼠标可能会跳至屏幕中间。

    [WH-1402]

  4. 从Xiaomi Mi 平板设备进行会话投射的过程中,DisplayConnector 鼠标线程意外终止。

    [WH-1419]

支持信息

对 Citrix Ready Workspace Hub 设备的支持通过从其处购买了该设备的核准供应商提供。这些供应商为 NComputingStratodeskViewSonic