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 位于相同的网络(Wi-Fi 或局域网)中。
  • 请勿在移动设备与 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 可以访问 Virtual Delivery Agent 服务器。
  • 对于会话漫游和屏幕投射,请确保 Citrix Studio 中的使用视频编解码器进行压缩策略设置为针对整个屏幕。否则可能会导致出现性能问题。

硬件

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

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

  • Android:Citrix Receiver 3.13.5 及更高版本;适用于 Android 的 Citrix Workspace 应用程序 1808 及更高版本
  • iOS:适用于 iOS 的 Citrix Workspace 应用程序 1810.1
  • 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. 为初始启动屏幕键入所需的 URL(在 URL 中添加 http://https://)。该链接通常指向 StoreFront 或 Citrix Gateway URL;但是,您可以配置要在 Hub 上启动的任何 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

要提高显示器分辨率,请对 Windows VDA 启用 ClearType 属性。请参阅 Microsoft Cleartype 概述如何在 Windows 10 中打开或关闭 ClearType 以了解详细信息。

双显示器设置

要支持双显示器,需要使用辅助显示适配器 (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(辅助显示)

SDA 图片

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

您可以将 Citrix Workspace 应用程序与 Citrix Ready Workspace Hub 结合使用。这款简单易用的软件提供了对用户有权访问的特定工作区应用程序和桌面的无缝安全访问。Workspace Hub 允许您从多个平台和客户端启动工作区资源。有关将设备配置为 Workspace Hub 结合使用的详细信息,请参阅适用于 AndroidiOSWindowsMac 平台的文档。

使用会话漫游或屏幕投射启动 Workspace Hub 会话。会话漫游允许您通过输入邻近身份验证范围或扫描 QR 代码来启动连接到 Workspace Hub 的会话。但是,屏幕投射要求在设备上启动该会话,然后触发 QR 代码来传输会话。

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

邻近身份验证可以自动对用户进行身份验证并启动会话,无需用户触摸设备。邻近身份验证依赖于蓝牙技术来定位移动设备。配置完成并启动 Citrix Workspace 应用程序后,当设备进入 Hub 的邻近身份验证范围时,会话将漫游到 Citrix Ready Workspace Hub。此功能仅适用于 Android 设备。

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

可以扫描 Hub 初始启动屏幕上的 QR 代码以漫游您的会话。当会话漫游到 Workspace Hub 后,Workspace Hub 可以完全控制会话中可用的所有外围设备。

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

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

有关到 Hub 的会话漫游和屏幕投射的详细信息,请参阅适用于 iOSAndroid 设备的帮助文档。

长时间运行的会话

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

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

标准日志记录

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

支持 Citrix Virtual Apps

使用 Citrix Workspace 应用程序从 Workspace Hub 启动应用程序时,您的会话可能会在打开初始启动屏幕后打开。有两种方法可将已启动的会话置于前台。

  1. 在初始启动屏幕左下角的菜单图标中,单击 Citrix Virtual Apps > 显示所有 Citrix Virtual Apps 以在窗口化模式下查看已启动的会话。
  2. 选择 Citrix Virtual Apps > 应用程序名称以在前台显示特定的会话。

自动导航初始启动屏幕

在 Citrix Ready Workspace Hub 1812 版本中,Citrix 引入了一项实验性功能,即自动导航初始启动屏幕。在 Workspace Hub 中为初始启动屏幕配置多个 URL。单击页面底部的箭头以在您的资源之间进行无缝导航。

配置

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 数据

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

数据点 注册表项名称 说明
是否启用自动导航功能 auto_navigation 指示是否已启用自定导航功能。1:已启用。0:已禁用
操作系统版本 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 连接受支持且出于安全起见已处于启用状态。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. 将证书文件 (cert.pem) 和私钥文件 (key.pem) 的名称,然后单击保存。这两个选项都在 Connections(连接)> Workspace Hub > Workspace Hub 下。
  3. 重新启动 Workspace Hub 以使所做的更改生效。

SSL 图片

您还可以通过将需要 SSL选项更改为来禁用 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 证书已加载,并且已在 Hub 上正确配置其路径。SSL 配置问题会导致启动 Citrix Casting 失败。如果会话停止响应,则将显示一条警告消息来通知您。

用户问题 建议
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 是否已正确配置。

已修复的问题

有关版本 1812 中已修复问题的完整列表,请参阅针对 CVAD 修复的问题部分。

已知问题

有关 Citrix Ready Workspace Hub 的已知问题的详细信息,请参阅 CVAD 中的已知问题部分。

支持信息

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