- 主页
- /
- 文章
适用于虚拟桌面基础结构(VDI)的Webex应用程序部署指南
在此文章中新信息和更改信息
此表涵盖与新功能相关的内容更新、现有内容的更改，以及在适用于虚拟桌面基础结构(VDI)的Webex应用程序部署指南中修复的任何重大错误。
有关Webex应用程序VDI更新、新功能、新增的VDI支持和限制的更多信息，请参阅 VDI发行说明。
日期 | 已做更改 | ||||
|---|---|---|---|---|---|
2023年11月13日 | 准备您的环境：
| ||||
2023年8月23日 | 整个文档：
准备您的环境：
部署用于VDI的Webex应用程序：
管理VDI版Webex应用程序并对其进行故障排除：
| ||||
2023年5月18日 | 在功能齐全的会议要求中澄清了有关Azure虚拟桌面的注释。 AVD不支持功能齐全的会议。 | ||||
2023 年 4 月 17 日 | VDI的Webex应用程序 有关禁用VDI版本兼容性检查的新内容。 在托管虚拟桌面和瘦客户端要求中更新了43.4（2023年4月）发行版支持的基础结构和操作系统版本。 | ||||
2023年3月15日 |
| ||||
2023年3月3日 |
| ||||
2023年2月27日 | 添加了同步一些 | ||||
2023年1月11日 | 在托管虚拟桌面和瘦客户端要求中添加了最新测试的基础设施和瘦客户端操作系统版本以及支持的硬件。 包括Apple M2芯片、macOS Ventura、HP ThinPro 8和Dell ThinOS 9.3。 | ||||
2022 年 10 月 26 日 | 已更新 | ||||
2022年8月25日 | 更新了Webex应用程序VDI 42.8版：
更新了以下对象的描述 | ||||
2022年5月30日 |
| ||||
2022 年 4 月 26 日 |
| ||||
2022 年 4 月 25 日 |
| ||||
2022 年 4 月 13 日 |
| ||||
2022年2月9日 |
| ||||
2022 年 2 月 3 日 |
| ||||
2021 年 12 月 15 日 |
| ||||
2021 年 11 月 12 日 |
| ||||
2021 年 10 月 29 日 |
| ||||
2021年10月8日 |
| ||||
2021 年 8 月 10 日 |
| ||||
2021年7月6日 |
| ||||
2021 年 6 月 3 日 | 6月(41.6)发行版的更新，包括以下内容：
其他常规更新：
| ||||
2021年5月3日 |
| ||||
2021 年 4 月 16 日 |
| ||||
2021 年 4 月 9 日 |
| ||||
2021年1月18日 |
| ||||
2020 年 12 月 11 日 |
| ||||
2020 年 9 月 29 日 |
| ||||
2020年7月16日 |
| ||||
2020年6月29日 |
|
VDI版Webex应用程序概述
未优化的情况下，Webex 应用程序消息传递功能会在虚拟桌面基础结构 (VDI) 环境中按原样运行。 不过，完整的 Webex 应用程序体验还包括呼叫和会议，而这些功能需要视频和音频媒体处理。
受发夹效应的限制，在未进行优化的情况下，呼叫、会议及相应的视频功能将不受支持。 由于媒体是从一个用户流向数据中心后才能流向下一用户，呼叫和视频所需的额外带宽会给数据中心造成瓶颈。 在未优化的媒体路径和访问外围设备（如扬声器、麦克风和摄像头等）困难等因素的共同影响下，用户体验难免差强人意。
为了解决“发夹效应”，Webex 应用程序 VDI 插件在虚拟部署中如法炮制 Cisco 的协作体验，以便用户能够使用 Webex 应用程序提供的完整的消息传递、会议和呼叫功能。
为减少延迟并提高媒体质量，VDI 插件通过在瘦客户端终端上的用户之间采取直接流式传输媒体来优化媒体工作流，并利用瘦客户端计算机的硬件进行媒体处理。 此媒体路径不经过托管的虚拟桌面 （HVD）。 其结果就是，您的 VDI 用户能够获得稳定且功能齐全的呼叫和会议体验。
在该体系结构中，Webex 应用程序安装在 VDI 环境的 HVD 上，所需的 VDI 插件则安装在用户的瘦客户端（通常为轻量系统，如改装过的笔记本电脑或台式电脑）上。
使用受支持的基于Linux、Mac或Windows的瘦客户端，用户可从远程虚拟桌面环境访问HVD上的Webex应用程序。 通过受支持的 Webex 应用程序版本，用户可以在瘦客户端上使用所有 Webex 应用程序内置消息传递、会议以及呼叫功能。 此外，您可以将 Webex 应用程序 VDI 与 Unified CM 或 Webex Calling 环境集成，以便用户能够使用受支持的呼叫功能。
 |
|
有关每个发行版的新功能，请参阅发行说明了解更多信息。
VDI环境概述
VDI组件
在优化的虚拟环境中使用Webex应用程序需要以下组件。
连接代理—将虚拟化提供程序连接到瘦客户端的资源和连接管理器(Citrix、VMware)。
托管虚拟桌面(HVD)—远程运行Webex应用程序的虚拟机(VM)。
瘦客户端—用户用于远程登录到虚拟桌面的终端（例如，低调或重用的台式电脑或笔记本电脑）。 连接代理和VDI插件安装在瘦客户端设备上，因此可以访问HVD环境。
插件-安装在瘦客户端上的软件，用于将媒体处理分担到用户设备而非HVD资源。 支持的Webex应用程序VDI插件版本从Webex应用程序 <UNK> DI发行说明的“下载”标签页链接。
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex VDI插件一起安装。
Webex应用程序—在HVD上安装并运行的应用程序。 HVD安装程序受支持的版本位于Webex应用程序 <UNK> DI发行说明的“下载”标签页。
环境类型
永久模式—在永久环境中，用户注销后将保留用户的本地操作系统更改。
所有用户首选项都位于漫游数据库(
spark_roaming_store.db）。 这个数据库比主数据库小得多(spark_persistent_store.db）。非持久模式—在非持久环境中，用户注销后不保留用户的本地操作系统更改。 用户会话期间缓存适用的用户特定信息（用户数据、配置文件和设置）。
如果您是非永久性VDI客户（每次用户注销时都会删除的VDI环境），您可以快速备份和恢复
spark_roaming_store.db以便VDI用户不会在会话之间丢失首选项。漫游数据库包含所有用户凭证和首选项，使用AES256加密。 作为VDI客户，您应始终备份漫游数据库，以便在整个VDI会话中维护用户凭证和首选项。
体系结构
架构图显示了具有现有支持呼叫服务部署的典型Webex应用程序VDI部署中涉及的组件、信令和优化媒体流： Unified CM、Webex 或BroadWorks。
每个程序框图的左侧是包含虚拟环境的公司网络。 这种虚拟环境通过在虚拟数据中心运行应用程序、操作系统和用户数据来减轻用户端硬件的负载。 借助该框架，您可以从中央位置管理环境，用户可以从受支持的瘦客户端远程访问该环境。
公司网络中的组件包括托管虚拟桌面(HVD)、您管理的安装和运行Webex应用程序的中央环境，以及与用户瘦客户端终端的虚拟通道连接（通过Cisco HVDAgent）。
用户在瘦客户端上安装Webex VDI插件并登录到连接代理（Citrix或VMware），这是一款创建与HVD连接的软件。 连接代理执行许多任务，包括：
验证用户名并为用户提供连接。
允许用户连接到特定虚拟桌面。
登录后，瘦客户端端点通过显示器、键盘、鼠标、USB设备等外围设备模拟与应用程序和操作系统的交互，就像软件安装在瘦客户端上一样。 用户在此端点上使用瘦客户端应用程序访问远程服务器上的Webex应用程序。
该架构优化了信令和媒体的方向。 它通过HTTPS、WSS和SIP与Webex云或BroadWorks云（右侧）进行信令通信。 会议（Webex应用程序）和呼叫（Unified CM、Webex 或BroadWorks）的独立媒体流通过SRTP建立。
您必须在HVD上更新Webex应用程序。 新版本每两个月发布一次，与之前的瘦客户端VDI插件向后兼容。 新的瘦客户端VDI插件构建版本也每两个月提供一次。 下载软件 并查看 说明 ，了解有关版本兼容性的更多信息。
使用Unified CM的Webex VDI
适用于MRA的Webex VDI与Unified CM和Expressways
程序框图中的Expressway用于表示Mobile and Remote Access (MRA)部署。 要使MRA与Webex应用程序VDI配合使用，HVD必须能够将请求发送到通常在DMZ中配置的Expressway-E。
带有Webex 的Webex应用程序VDI
使用Webex for BroadWorks的Webex VDI
包含Meetings的Webex应用程序VDI
退回模式
VDI 无法建立虚拟通道时，Webex 应用程序的 VDI 回退模式可为基本音频和视频通话提供短期支持。 回退模式支持标准通话和通话录制。 但不支持完整的功能集。 导致切换到回退模式的服务器或网络问题，会降低通话质量。
Webex应用程序VDI登录流程
Webex应用程序VDI架构由两个主要组件组成： 用于VDI的Webex应用程序和用于瘦客户端的Webex VDI插件。 VDI插件安装在瘦客户端上，而应用程序安装在HVD上。
当用户启动虚拟经纪客户端（Citrix Workspace应用程序或VMWare Horizon Client）时，供应商的软件会启动虚拟通道。 Webex应用程序插件和代理使用此虚拟通道进行通信。
下图显示了通过移动和远程访问(MRA)部署Unified CM呼叫时在正常Webex应用程序使用期间设置的预期协议会话。
| 虽然图中描述了基于MRA的Webex应用程序VDI，但流程与本地VDI部署相同。 但是，与基于MRA的VDI不同，内部部署不会通过DMZ路由流量，并且所有流量都位于LAN上。 |
要开始会话，用户首先启动虚拟代理-客户端（Citrix Workspace App或VMware Horizon Client），连接到连接代理，然后选择HVD或虚拟应用程序。 选中后，将在用户的瘦客户端（物理机）和Hypervisor上托管的HVD（虚拟机）之间设置虚拟通道。
用户在HVD上启动Webex应用程序后，Webex将确定其是否处于虚拟环境中，以及Unified CM是否用于电话服务。 如果启用了Unified CM，Webex应用程序将启动
teamshvdagent.exe处理并开始内部服务发现。 （内部服务发现包括UDS DNS SRV查找、Unified CM验证、主群集查找和配置检索。）然后，Webex应用程序客户端和Webex应用程序VDI插件设置用于通过虚拟通道交换数据的所有控制流。 设置这些通道后，Webex应用程序客户端将语音服务域信息发送到Webex应用程序VDI插件。
接下来，Webex应用程序VDI插件执行服务发现。 Webex应用程序VDI插件通过引用从Webex应用程序客户端发送到其的语音服务域信息来做到这一点。 在这种情况下，Webex应用程序VDI插件解析_collab DNS SRV记录，因为VDI插件机器正在从外部网络连接，因此需要通过MRA进行连接。 服务发现完成后，Webex应用程序VDI插件将Expressway-E FQDN发送到Webex应用程序客户端。
在接收和缓存Expressway-E FQDN后，Webex应用程序(HVD)会为Expressway-E FQDN执行DNS记录查找。 对于单个NIC部署，此步骤将检索Expressway-E的IP地址（带拆分DNS的内部IP或不带拆分DNS的外部IP），用于通过端口8443进行Edge配置和SSO验证。
如果在双网络接口部署中设置了Expressway-E，两个接口都可以有一个内部IP地址。 在该情况下，内部接口与外部接口的配置相反。
检索Edge详细信息后，Webex应用程序(HVD)会为UDS和TFTP请求建立与ExpressWAY-E IP的HTTPS连接。 通过此过程，Webex应用程序(HVD)验证和检索配置详细信息，例如软电话设备配置、应用程序拨号规则和目录查找拨号规则。
Webex VDI插件解析Expressway-E外部IP，然后发送到Webex应用程序(HVD)。 通过上一步中检索的设备信息，Webex应用程序通过Expressway-E外部界面开始CSF设备（Windows桌面）注册。
托管虚拟桌面和瘦客户端要求
确保您的VDI环境满足受支持服务器(安装Webex应用程序的托管虚拟桌面(HVD))和瘦客户端（安装Webex VDI插件的用户端设备）的要求。
| 对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。 |
托管的虚拟桌面
VDI组件 | 支持的平台 | ||||
|---|---|---|---|---|---|
| 单会话操作系统-安装在HVD上 |
|
||||
多会话操作系统-安装在HVD上 |
|
||||
多会话云虚拟化服务 |
|
||||
| 托管虚拟桌面的连接代理 |
连接代理是创建与托管虚拟桌面连接的软件。 连接代理执行许多任务，包括：
|
Windows瘦客户端
VDI组件 | 支持的平台 | ||
|---|---|---|---|
| 基于 Microsoft Windows 的瘦客户端硬件 | 支持的硬件
支持的软件 我们支持以下Windows版本的64位架构：
|
||
| 基于 Windows Embedded Standard 的瘦客户端硬件 | 支持的硬件 已安装 2 GB 的 RAM 可用物理内存 128 MB 可用磁盘空间 256 MB CPU 性能会影响最大视频分辨率。 使用 Windows Embedded Standard 瘦客户端时，所需分辨率取决于 CPU：
与 DirectX 11 兼容的 GPU USB 2.0（用于 USB 摄像头和音频设备） 支持的软件
|
||
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Linux瘦客户端
VDI组件 | 支持的平台 | ||
|---|---|---|---|
| 瘦客户端操作系统 | Ubuntu（64位）
|
||
Unicon eLux（64位）
|
|||
HP ThinPro 7.1（生命周期终止） HP ThinPro 8.0、8.1（64位）
|
|||
IGEL OS
|
|||
Dell Wyse ThinOS
|
|||
10ZiG Zero Client瘦客户端
|
|||
Stratodesk NoTouch操作系统
|
|||
| Ubuntu/Thinpro瘦客户端硬件 | 瘦客户端的最低硬件要求如下：
|
||
| eLux RP 6瘦客户端硬件 | 最低硬件要求 下列系统属性可使用基本eLux RP 6功能启用。
|
||
| 已测试和推荐的设备 |
*根据硬件要求，不建议将这些设备与虚拟背景配合使用。 有关更多信息，请参阅虚拟背景要求。 （VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
||
Citrix Workspace应用程序或VMware Horizon客户端 |
|
macOS瘦客户端
VDI组件 | 支持的平台 | ||||
|---|---|---|---|---|---|
| 基于MacOS的瘦客户端硬件 | 支持的硬件
在以下任何Apple硬件上安装Intel Core 2 Duo或更高版本的处理器：
支持的软件 以下macOS版本支持Webex应用程序VDI插件：
| ||||
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Webex应用程序和插件要求
从Webex应用程序VDI发行说明的“下载”标签页中获取Webex应用程序（安装在HVD ）和Webex应用程序插件（安装在用户瘦客户端计算机上） 必要的安装构建。
虽然我们支持发行说明中所述的向后兼容性，但我们建议您尽可能使用最新版本的安装程序。
对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。
VDI用户通常对其计算机没有管理员控制权，插件也不需要管理员权限。 但是，如果您的用户需要与Outlook集成，则必须使用在Microsoft Outlook中显示用户状态中的指示注册办公室集成。dll文件。
耳机要求
对于Webex应用程序VDI，除非另有说明，否则我们支持与独立版Webex应用程序相同的头戴式耳机。 有关更多信息，请参阅有关头戴式耳机支持的详细信息。
支持用于呼叫和会议的实时媒体工作流程
Webex应用程序VDI支持以下实时媒体工作流：
Webex上的呼叫（内置在应用程序中）
Unified CM
Webex Calling
适用于 BroadWorks 的 Webex
Webex Meetings
要集成受支持的呼叫服务和Webex Meetings，您必须遵循这些解决方案文档中的配置步骤。 选择一个选项，然后使用该部分中链接的文档。
Unified CM要求
如果要将Unified CM用作Webex应用程序VDI用户的呼叫服务，请使用部署指南完成所需的配置步骤。 文档包含服务、前提条件和部署步骤的概述。
将呼叫移至会议
要支持此功能，请确保已 正确配置Unified CM呼叫部署。
此外，请确保以下VDI配置到位，以便支持将负载转移到会议： 功能齐全的会议要求。
移动和远程访问 (MRA)
支持Mobile and Remote Access (MRA)。 按照 way MRA文档 中的标准MRA部署步骤，并在支持的VDI部署中牢记以下几点：
有关VDI支持的更多指导，请参阅移动和远程访问(MRA)要求。
必须至少运行X12。7和更高版本。
支持双NIC部署。 您必须确保从HVD连接到Expressway-E的外部和内部IP地址。 您必须在HVD和ExpressWAY-E的外部IP之间添加NAT。
Webex 要求
| 如果您的HVD支持IPv4和IPv6，我们建议您在HVD环境中禁用IPV6，以防止Webex 出现兼容性问题。 |
Control Hub 中的配置（合作伙伴和管理员）
使用 Control Hub，您可以在其中预配置和配置设置、功能、设备和用户。 Webex Calling已启用的组织。 在 Control Hub 中开始Webex Calling 前提条件和端口参考材料，确保您的环境支持此配置。 您可以按顺序使用以下信息，让您的组织正常运作Webex Calling ：
Webex for BroadWorks要求
VDI环境中的Webex应用程序支持Webex for BroadWorks。 Webex for BroadWorks 是一种在 Webex 中集成 BroadWorks Calling 的服务。 订阅者使用一个应用程序（Webex 应用程序）来利用两个平台提供的功能。
| 有关Webex for BroadWorks的一般信息，请参阅Webex for BroadWorks解决方案指南。 |
功能齐全的会议要求
在为功能齐全的会议部署Webex应用程序VDI时，请记住以下几点：
将Webex应用程序安装到托管虚拟桌面(HVD)上。
您必须为加入功能齐全的Webex会议的用户安装Webex应用程序VDI插件。
对于Linux瘦客户端，您还必须安装适用于Linux的Webex Meetings VDI插件（请参阅 瘦客户端系统上安装Webex Meetings VDI插件）。
移动和远程访问(MRA)要求
必要条件
您必须至少运行Expressway X12.7 才能让MRA使用Webex VDI的穿越对。 早期版本必须升级到X12.7或更高版本以避免路由问题。
确保Expressway的HVD环境中的Webex、外部接口和内部接口（双NIC部署）之间的连接。
使用Webex应用程序VDI的MRA工作流程
有关使用Webex VDI工作流程的MRA的信息，请参阅 bex应用程序VDI登录流程。
双重NIC注意事项
在使用Expressway-E双NIC部署的MRA上部署Webex应用程序VDI时，请牢记这些设计注意事项。
静态路由—验证Expressway-E上的默认网关。 通常情况下，这是外部接口IP子网的默认网关。 验证Expressway默认网关配置后，必须为用于HVD机器的IP子网添加静态路由到Expressway-E。
静态路由将流量从Expressway-E的内部接口发送到HVD子网。 由于UDS和TFTP配置查询从HVD发送到Expressway E内部接口，因此需要此配置。 Unified CM响应请求后，如果静态路由到HVD子网不存在，Expressway-E将通过默认网关发送响应。
NAT转换—从HVD到Expressway-E外部接口的SIP流量在到达ExpressWAY之前需要更改源IP，以避免路由问题。 NAT解决了这个问题。 NAT转换必须在作为HVD和Expressway-E之间路径的网络设备上进行。
DNS配置
内部DNS
对于双NIC部署，您可以使用解析为内部接口IP地址的FQDN指定Expressway-E地址。 通过拆分DNS，您可以选择使用公共DNS上可用的相同FQDN。 如果不使用拆分DNS，则必须使用不同的FQDN。
为了避免路由问题，从HVD到Expressway-E外部接口的SIP流量需要更改源IP才能到达Expressway。 您必须在HVD和Expressway-E之间的网络设备上设置NAT转换。
对于具有静态NAT的单个NIC，必须使用解析为公共IP地址的FQDN指定Expressway-E地址。 此设置还意味着外部防火墙必须允许流量从HVD中的Webex应用程序到Expressway-E的外部FQDN。 这种设计称为NAT反射，可能并非所有类型的防火墙都支持这种设计。
内部DNS必须配置为
_cisco-uds._tcp.<domain>SRV记录，以便Webex应用程序可以发现Unified CM。
公共DNS
SRV记录
公共外部DNS必须配置为 _collab-edge._tls.<domain> SRV记录，以便终端可以发现用于MRA的Expressway-Es。
地理DNS
在43.6及更高版本中，您可以将Webex应用程序配置为与GeoDNS配合使用。 此选项允许应用程序连接到地理位置最近的Expressway-E，从而提高网络效率。
如果您已为SRV记录配置GeoDNS，我们建议您在HVD上编辑注册表，如下所示：
打开注册表至
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native。创建名为新的DWORD密钥
VDIGeoDnsEnabled。设置
VDIGeoDnsEnabled到1。(设置
VDIGeoDnsEnabled到0（默认值）如果要在此HVD上禁用Webex应用程序的GeoDNS兼容性)。保存注册表。
防火墙配置
内部和外部防火墙都必须允许以下出站连接从HVD上的Webex应用程序到Expressway-E：
SIP —TCP 5061
HTTPS —TCP 8443
外部防火墙还必须允许从用户瘦客户端到Expressway的以下入站连接：
媒体- UDP 36002–59999
新信息和更改信息
此表涵盖与新功能相关的内容更新、现有内容的更改，以及在适用于虚拟桌面基础结构(VDI)的Webex应用程序部署指南中修复的任何重大错误。
有关Webex应用程序VDI更新、新功能、新增的VDI支持和限制的更多信息，请参阅 VDI发行说明。
日期 | 已做更改 | ||||
|---|---|---|---|---|---|
2023年11月13日 | 准备您的环境：
| ||||
2023年8月23日 | 整个文档：
准备您的环境：
部署用于VDI的Webex应用程序：
管理VDI版Webex应用程序并对其进行故障排除：
| ||||
2023年5月18日 | 在功能齐全的会议要求中澄清了有关Azure虚拟桌面的注释。 AVD不支持功能齐全的会议。 | ||||
2023 年 4 月 17 日 | VDI的Webex应用程序 有关禁用VDI版本兼容性检查的新内容。 在托管虚拟桌面和瘦客户端要求中更新了43.4（2023年4月）发行版支持的基础结构和操作系统版本。 | ||||
2023年3月15日 |
| ||||
2023年3月3日 |
| ||||
2023年2月27日 | 添加了同步一些 | ||||
2023年1月11日 | 在托管虚拟桌面和瘦客户端要求中添加了最新测试的基础设施和瘦客户端操作系统版本以及支持的硬件。 包括Apple M2芯片、macOS Ventura、HP ThinPro 8和Dell ThinOS 9.3。 | ||||
2022 年 10 月 26 日 | 已更新 | ||||
2022年8月25日 | 更新了Webex应用程序VDI 42.8版：
更新了以下对象的描述 | ||||
2022年5月30日 |
| ||||
2022 年 4 月 26 日 |
| ||||
2022 年 4 月 25 日 |
| ||||
2022 年 4 月 13 日 |
| ||||
2022年2月9日 |
| ||||
2022 年 2 月 3 日 |
| ||||
2021 年 12 月 15 日 |
| ||||
2021 年 11 月 12 日 |
| ||||
2021 年 10 月 29 日 |
| ||||
2021年10月8日 |
| ||||
2021 年 8 月 10 日 |
| ||||
2021年7月6日 |
| ||||
2021 年 6 月 3 日 | 6月(41.6)发行版的更新，包括以下内容：
其他常规更新：
| ||||
2021年5月3日 |
| ||||
2021 年 4 月 16 日 |
| ||||
2021 年 4 月 9 日 |
| ||||
2021年1月18日 |
| ||||
2020 年 12 月 11 日 |
| ||||
2020 年 9 月 29 日 |
| ||||
2020年7月16日 |
| ||||
2020年6月29日 |
|
VDI版Webex应用程序概述
未优化的情况下，Webex 应用程序消息传递功能会在虚拟桌面基础结构 (VDI) 环境中按原样运行。 不过，完整的 Webex 应用程序体验还包括呼叫和会议，而这些功能需要视频和音频媒体处理。
受发夹效应的限制，在未进行优化的情况下，呼叫、会议及相应的视频功能将不受支持。 由于媒体是从一个用户流向数据中心后才能流向下一用户，呼叫和视频所需的额外带宽会给数据中心造成瓶颈。 在未优化的媒体路径和访问外围设备（如扬声器、麦克风和摄像头等）困难等因素的共同影响下，用户体验难免差强人意。
为了解决“发夹效应”，Webex 应用程序 VDI 插件在虚拟部署中如法炮制 Cisco 的协作体验，以便用户能够使用 Webex 应用程序提供的完整的消息传递、会议和呼叫功能。
为减少延迟并提高媒体质量，VDI 插件通过在瘦客户端终端上的用户之间采取直接流式传输媒体来优化媒体工作流，并利用瘦客户端计算机的硬件进行媒体处理。 此媒体路径不经过托管的虚拟桌面 （HVD）。 其结果就是，您的 VDI 用户能够获得稳定且功能齐全的呼叫和会议体验。
在该体系结构中，Webex 应用程序安装在 VDI 环境的 HVD 上，所需的 VDI 插件则安装在用户的瘦客户端（通常为轻量系统，如改装过的笔记本电脑或台式电脑）上。
使用受支持的基于Linux、Mac或Windows的瘦客户端，用户可从远程虚拟桌面环境访问HVD上的Webex应用程序。 通过受支持的 Webex 应用程序版本，用户可以在瘦客户端上使用所有 Webex 应用程序内置消息传递、会议以及呼叫功能。 此外，您可以将 Webex 应用程序 VDI 与 Unified CM 或 Webex Calling 环境集成，以便用户能够使用受支持的呼叫功能。
|
|
有关每个发行版的新功能，请参阅发行说明了解更多信息。
VDI环境概述
VDI组件
在优化的虚拟环境中使用Webex应用程序需要以下组件。
连接代理—将虚拟化提供程序连接到瘦客户端的资源和连接管理器(Citrix、VMware)。
托管虚拟桌面(HVD)—远程运行Webex应用程序的虚拟机(VM)。
瘦客户端—用户用于远程登录到虚拟桌面的终端（例如，低调或重用的台式电脑或笔记本电脑）。 连接代理和VDI插件安装在瘦客户端设备上，因此可以访问HVD环境。
插件-安装在瘦客户端上的软件，用于将媒体处理分担到用户设备而非HVD资源。 支持的Webex应用程序VDI插件版本从Webex应用程序 <UNK> DI发行说明的“下载”标签页链接。
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex VDI插件一起安装。
Webex应用程序—在HVD上安装并运行的应用程序。 HVD安装程序受支持的版本位于Webex应用程序 <UNK> DI发行说明的“下载”标签页。
环境类型
永久模式—在永久环境中，用户注销后将保留用户的本地操作系统更改。
所有用户首选项都位于漫游数据库(
spark_roaming_store.db）。 这个数据库比主数据库小得多(spark_persistent_store.db）。非持久模式—在非持久环境中，用户注销后不保留用户的本地操作系统更改。 用户会话期间缓存适用的用户特定信息（用户数据、配置文件和设置）。
如果您是非永久性VDI客户（每次用户注销时都会删除的VDI环境），您可以快速备份和恢复
spark_roaming_store.db以便VDI用户不会在会话之间丢失首选项。漫游数据库包含所有用户凭证和首选项，使用AES256加密。 作为VDI客户，您应始终备份漫游数据库，以便在整个VDI会话中维护用户凭证和首选项。
体系结构
架构图显示了具有现有支持呼叫服务部署的典型Webex应用程序VDI部署中涉及的组件、信令和优化媒体流： Unified CM、Webex 或BroadWorks。
每个程序框图的左侧是包含虚拟环境的公司网络。 这种虚拟环境通过在虚拟数据中心运行应用程序、操作系统和用户数据来减轻用户端硬件的负载。 借助该框架，您可以从中央位置管理环境，用户可以从受支持的瘦客户端远程访问该环境。
公司网络中的组件包括托管虚拟桌面(HVD)、您管理的安装和运行Webex应用程序的中央环境，以及与用户瘦客户端终端的虚拟通道连接（通过Cisco HVDAgent）。
用户在瘦客户端上安装Webex VDI插件并登录到连接代理（Citrix或VMware），这是一款创建与HVD连接的软件。 连接代理执行许多任务，包括：
验证用户名并为用户提供连接。
允许用户连接到特定虚拟桌面。
登录后，瘦客户端端点通过显示器、键盘、鼠标、USB设备等外围设备模拟与应用程序和操作系统的交互，就像软件安装在瘦客户端上一样。 用户在此端点上使用瘦客户端应用程序访问远程服务器上的Webex应用程序。
该架构优化了信令和媒体的方向。 它通过HTTPS、WSS和SIP与Webex云或BroadWorks云（右侧）进行信令通信。 会议（Webex应用程序）和呼叫（Unified CM、Webex 或BroadWorks）的独立媒体流通过SRTP建立。
您必须在HVD上更新Webex应用程序。 新版本每两个月发布一次，与之前的瘦客户端VDI插件向后兼容。 新的瘦客户端VDI插件构建版本也每两个月提供一次。 下载软件 并查看 说明 ，了解有关版本兼容性的更多信息。
使用Unified CM的Webex VDI
适用于MRA的Webex VDI与Unified CM和Expressways
程序框图中的Expressway用于表示Mobile and Remote Access (MRA)部署。 要使MRA与Webex应用程序VDI配合使用，HVD必须能够将请求发送到通常在DMZ中配置的Expressway-E。
带有Webex 的Webex应用程序VDI
使用Webex for BroadWorks的Webex VDI
包含Meetings的Webex应用程序VDI
退回模式
VDI 无法建立虚拟通道时，Webex 应用程序的 VDI 回退模式可为基本音频和视频通话提供短期支持。 回退模式支持标准通话和通话录制。 但不支持完整的功能集。 导致切换到回退模式的服务器或网络问题，会降低通话质量。
Webex应用程序VDI登录流程
Webex应用程序VDI架构由两个主要组件组成： 用于VDI的Webex应用程序和用于瘦客户端的Webex VDI插件。 VDI插件安装在瘦客户端上，而应用程序安装在HVD上。
当用户启动虚拟经纪客户端（Citrix Workspace应用程序或VMWare Horizon Client）时，供应商的软件会启动虚拟通道。 Webex应用程序插件和代理使用此虚拟通道进行通信。
下图显示了通过移动和远程访问(MRA)部署Unified CM呼叫时在正常Webex应用程序使用期间设置的预期协议会话。
| 虽然图中描述了基于MRA的Webex应用程序VDI，但流程与本地VDI部署相同。 但是，与基于MRA的VDI不同，内部部署不会通过DMZ路由流量，并且所有流量都位于LAN上。 |
要开始会话，用户首先启动虚拟代理-客户端（Citrix Workspace App或VMware Horizon Client），连接到连接代理，然后选择HVD或虚拟应用程序。 选中后，将在用户的瘦客户端（物理机）和Hypervisor上托管的HVD（虚拟机）之间设置虚拟通道。
用户在HVD上启动Webex应用程序后，Webex将确定其是否处于虚拟环境中，以及Unified CM是否用于电话服务。 如果启用了Unified CM，Webex应用程序将启动
teamshvdagent.exe处理并开始内部服务发现。 （内部服务发现包括UDS DNS SRV查找、Unified CM验证、主群集查找和配置检索。）然后，Webex应用程序客户端和Webex应用程序VDI插件设置用于通过虚拟通道交换数据的所有控制流。 设置这些通道后，Webex应用程序客户端将语音服务域信息发送到Webex应用程序VDI插件。
接下来，Webex应用程序VDI插件执行服务发现。 Webex应用程序VDI插件通过引用从Webex应用程序客户端发送到其的语音服务域信息来做到这一点。 在这种情况下，Webex应用程序VDI插件解析_collab DNS SRV记录，因为VDI插件机器正在从外部网络连接，因此需要通过MRA进行连接。 服务发现完成后，Webex应用程序VDI插件将Expressway-E FQDN发送到Webex应用程序客户端。
在接收和缓存Expressway-E FQDN后，Webex应用程序(HVD)会为Expressway-E FQDN执行DNS记录查找。 对于单个NIC部署，此步骤将检索Expressway-E的IP地址（带拆分DNS的内部IP或不带拆分DNS的外部IP），用于通过端口8443进行Edge配置和SSO验证。
如果在双网络接口部署中设置了Expressway-E，两个接口都可以有一个内部IP地址。 在该情况下，内部接口与外部接口的配置相反。
检索Edge详细信息后，Webex应用程序(HVD)会为UDS和TFTP请求建立与ExpressWAY-E IP的HTTPS连接。 通过此过程，Webex应用程序(HVD)验证和检索配置详细信息，例如软电话设备配置、应用程序拨号规则和目录查找拨号规则。
Webex VDI插件解析Expressway-E外部IP，然后发送到Webex应用程序(HVD)。 通过上一步中检索的设备信息，Webex应用程序通过Expressway-E外部界面开始CSF设备（Windows桌面）注册。
托管虚拟桌面和瘦客户端要求
确保您的VDI环境满足受支持服务器(安装Webex应用程序的托管虚拟桌面(HVD))和瘦客户端（安装Webex VDI插件的用户端设备）的要求。
| 对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。 |
托管的虚拟桌面
VDI组件 | 支持的平台 | ||||
|---|---|---|---|---|---|
| 单会话操作系统-安装在HVD上 |
|
||||
多会话操作系统-安装在HVD上 |
|
||||
多会话云虚拟化服务 |
|
||||
| 托管虚拟桌面的连接代理 |
连接代理是创建与托管虚拟桌面连接的软件。 连接代理执行许多任务，包括：
|
Windows瘦客户端
VDI组件 | 支持的平台 | ||
|---|---|---|---|
| 基于 Microsoft Windows 的瘦客户端硬件 | 支持的硬件
支持的软件 我们支持以下Windows版本的64位架构：
|
||
| 基于 Windows Embedded Standard 的瘦客户端硬件 | 支持的硬件 已安装 2 GB 的 RAM 可用物理内存 128 MB 可用磁盘空间 256 MB CPU 性能会影响最大视频分辨率。 使用 Windows Embedded Standard 瘦客户端时，所需分辨率取决于 CPU：
与 DirectX 11 兼容的 GPU USB 2.0（用于 USB 摄像头和音频设备） 支持的软件
|
||
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Linux瘦客户端
VDI组件 | 支持的平台 | ||
|---|---|---|---|
| 瘦客户端操作系统 | Ubuntu（64位）
|
||
Unicon eLux（64位）
|
|||
HP ThinPro 7.1（生命周期终止） HP ThinPro 8.0、8.1（64位）
|
|||
IGEL OS
|
|||
Dell Wyse ThinOS
|
|||
10ZiG Zero Client瘦客户端
|
|||
Stratodesk NoTouch操作系统
|
|||
| Ubuntu/Thinpro瘦客户端硬件 | 瘦客户端的最低硬件要求如下：
|
||
| eLux RP 6瘦客户端硬件 | 最低硬件要求 下列系统属性可使用基本eLux RP 6功能启用。
|
||
| 已测试和推荐的设备 |
*根据硬件要求，不建议将这些设备与虚拟背景配合使用。 有关更多信息，请参阅虚拟背景要求。 （VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
||
Citrix Workspace应用程序或VMware Horizon客户端 |
|
macOS瘦客户端
VDI组件 | 支持的平台 | ||||
|---|---|---|---|---|---|
| 基于MacOS的瘦客户端硬件 | 支持的硬件
在以下任何Apple硬件上安装Intel Core 2 Duo或更高版本的处理器：
支持的软件 以下macOS版本支持Webex应用程序VDI插件：
| ||||
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Webex应用程序和插件要求
从Webex应用程序VDI发行说明的“下载”标签页中获取Webex应用程序（安装在HVD ）和Webex应用程序插件（安装在用户瘦客户端计算机上） 必要的安装构建。
虽然我们支持发行说明中所述的向后兼容性，但我们建议您尽可能使用最新版本的安装程序。
对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。
VDI用户通常对其计算机没有管理员控制权，插件也不需要管理员权限。 但是，如果您的用户需要与Outlook集成，则必须使用在Microsoft Outlook中显示用户状态中的指示注册办公室集成。dll文件。
耳机要求
对于Webex应用程序VDI，除非另有说明，否则我们支持与独立版Webex应用程序相同的头戴式耳机。 有关更多信息，请参阅有关头戴式耳机支持的详细信息。
支持用于呼叫和会议的实时媒体工作流程
Webex应用程序VDI支持以下实时媒体工作流：
Webex上的呼叫（内置在应用程序中）
Unified CM
Webex Calling
适用于 BroadWorks 的 Webex
Webex Meetings
要集成受支持的呼叫服务和Webex Meetings，您必须遵循这些解决方案文档中的配置步骤。 选择一个选项，然后使用该部分中链接的文档。
Unified CM要求
如果要将Unified CM用作Webex应用程序VDI用户的呼叫服务，请使用部署指南完成所需的配置步骤。 文档包含服务、前提条件和部署步骤的概述。
将呼叫移至会议
要支持此功能，请确保已 正确配置Unified CM呼叫部署。
此外，请确保以下VDI配置到位，以便支持将负载转移到会议： 功能齐全的会议要求。
移动和远程访问 (MRA)
支持Mobile and Remote Access (MRA)。 按照 way MRA文档 中的标准MRA部署步骤，并在支持的VDI部署中牢记以下几点：
有关VDI支持的更多指导，请参阅移动和远程访问(MRA)要求。
必须至少运行X12。7和更高版本。
支持双NIC部署。 您必须确保从HVD连接到Expressway-E的外部和内部IP地址。 您必须在HVD和ExpressWAY-E的外部IP之间添加NAT。
Webex 要求
| 如果您的HVD支持IPv4和IPv6，我们建议您在HVD环境中禁用IPV6，以防止Webex 出现兼容性问题。 |
配置： Control Hub （合作伙伴和管理员）
使用 Control Hub，您可以在其中预配置和配置设置、功能、设备和用户。 Webex Calling已启用的组织。 在 Control Hub 中开始Webex Calling 前提条件和端口参考材料，确保您的环境支持此配置。 您可以按顺序使用以下信息，让您的组织正常运作Webex Calling ：
 | 每篇文章的顶部都包含一个地铁地图，让您知道自己在整体配置工作流中所处的位置，以免丢失位置。 |
Webex for BroadWorks要求
VDI环境中的Webex应用程序支持Webex for BroadWorks。 Webex for BroadWorks 是一种在 Webex 中集成 BroadWorks Calling 的服务。 订阅者使用一个应用程序（Webex 应用程序）来利用两个平台提供的功能。
| 有关Webex for BroadWorks的一般信息，请参阅Webex for BroadWorks解决方案指南。 |
功能齐全的会议要求
在为功能齐全的会议部署Webex应用程序VDI时，请记住以下几点：
将Webex应用程序安装到托管虚拟桌面(HVD)上。
您必须为加入功能齐全的Webex会议的用户安装Webex应用程序VDI插件。
对于Linux瘦客户端，您还必须安装适用于Linux的Webex Meetings VDI插件（请参阅 瘦客户端系统上安装Webex Meetings VDI插件）。
移动和远程访问(MRA)要求
必要条件
您必须至少运行Expressway X12.7 才能让MRA使用Webex VDI的穿越对。 早期版本必须升级到X12.7或更高版本以避免路由问题。
确保Expressway的HVD环境中的Webex、外部接口和内部接口（双NIC部署）之间的连接。
使用Webex应用程序VDI的MRA工作流程
有关使用Webex VDI工作流程的MRA的信息，请参阅 bex应用程序VDI登录流程。
双重NIC注意事项
在使用Expressway-E双NIC部署的MRA上部署Webex应用程序VDI时，请牢记这些设计注意事项。
静态路由—验证Expressway-E上的默认网关。 通常情况下，这是外部接口IP子网的默认网关。 验证Expressway默认网关配置后，必须为用于HVD机器的IP子网添加静态路由到Expressway-E。
静态路由将流量从Expressway-E的内部接口发送到HVD子网。 由于UDS和TFTP配置查询从HVD发送到Expressway E内部接口，因此需要此配置。 Unified CM响应请求后，如果静态路由到HVD子网不存在，Expressway-E将通过默认网关发送响应。
NAT转换—从HVD到Expressway-E外部接口的SIP流量在到达ExpressWAY之前需要更改源IP，以避免路由问题。 NAT解决了这个问题。 NAT转换必须在作为HVD和Expressway-E之间路径的网络设备上进行。
DNS配置
内部DNS
对于双NIC部署，您可以使用解析为内部接口IP地址的FQDN指定Expressway-E地址。 通过拆分DNS，您可以选择使用公共DNS上可用的相同FQDN。 如果不使用拆分DNS，则必须使用不同的FQDN。
为了避免路由问题，从HVD到Expressway-E外部接口的SIP流量需要更改源IP才能到达Expressway。 您必须在HVD和Expressway-E之间的网络设备上设置NAT转换。
对于具有静态NAT的单个NIC，必须使用解析为公共IP地址的FQDN指定Expressway-E地址。 此设置还意味着外部防火墙必须允许流量从HVD中的Webex应用程序到Expressway-E的外部FQDN。 这种设计称为NAT反射，可能并非所有类型的防火墙都支持这种设计。
内部DNS必须配置为
_cisco-uds._tcp.<domain>SRV记录，以便Webex应用程序可以发现Unified CM。
公共DNS
SRV记录
公共外部DNS必须配置为 _collab-edge._tls.<domain> SRV记录，以便终端可以发现用于MRA的Expressway-Es。
地理DNS
在43.6及更高版本中，您可以将Webex应用程序配置为与GeoDNS配合使用。 此选项允许应用程序连接到地理位置最近的Expressway-E，从而提高网络效率。
如果您已为SRV记录配置GeoDNS，我们建议您在HVD上编辑注册表，如下所示：
打开注册表至
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native。创建名为新的DWORD密钥
VDIGeoDnsEnabled。设置
VDIGeoDnsEnabled到1。(设置
VDIGeoDnsEnabled到0（默认值）如果要在此HVD上禁用Webex应用程序的GeoDNS兼容性)。保存注册表。
防火墙配置
内部和外部防火墙都必须允许以下出站连接从HVD上的Webex应用程序到Expressway-E：
SIP —TCP 5061
HTTPS —TCP 8443
外部防火墙还必须允许从用户瘦客户端到Expressway的以下入站连接：
媒体- UDP 36002–59999
Webex应用程序VDI部署任务流程
这些步骤将指导您了解如何在VDI环境中部署Webex应用程序。 这些步骤包括您需要在托管虚拟桌面(HVD)环境中执行的操作，以及用户需要在瘦客户端上执行的操作。
准备工作
| 如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须在部署VDI之前使用准备环境章节中的说明部署呼叫服务（Unified CM、Webex 或BroadWorks）。 |
| 1 | 配置以下托管虚拟桌面类型之一： 要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。 |
| 2 | 在以下平台的瘦客户端计算机上安装Webex应用程序VDI插件：
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。 瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 可从 Webex应用程序VDI发行说明获取支持平台的瘦客户端插件。 |
| 3 | （可选）在Linux瘦客户端上，您还必须在瘦客户端系统上 Webex Meetings VDI插件。 对于Webex应用程序中功能齐全的会议，您必须在Linux瘦客户端上安装两个单独的VDI插件。 |
配置托管虚拟桌面并安装Webex应用程序
要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。
准备工作
遵循为VDI版Webex应用程序做好环境准备中的所有前提条件。
如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须先部署呼叫服务（Unified CM、Webex 或BroadWorks），然后再部署VDI。
本节仅介绍如何在现有HVD环境中安装Webex应用程序。 有关HVD部署最佳实践，请参阅Citrix或Vmware文档。
| 1 | 以拥有域管理权限的新用户身份登录Microsoft Windows HVD。 | ||
| 2 | 将 HVD 加入企业域。 | ||
| 3 | 设置 Citrix 或 VMware 对 HVD 的访问权限。 | ||
| 4 | 如果您的组织有自己的下载站点，其中包含站点特定的Webex应用程序，请转至该站点并下载组织特定的版本。 否则，对于通用版本，请转至 Webex应用程序VDI发行说明>下载并下载所需的Webex应用程序：
| ||
| 5 | 使用管理权限，使用这些命令和参数在HVD上安装应用程序(这些示例使用的下载目录
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。 | ||
| 6 | 复制 HVD 映像。 有关克隆Microsoft Windows HVD图像最佳实践的更多信息，请参阅Citrix或VMware产品的文档。 |
下一步
有关用户首选项以及如何保留的信息，请参阅用户首选项。
安装参数、说明和所需权限
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。
| 参数 | 笔记 | 需要管理员安装权限 |
|---|---|---|
ALLUSERS=1 | 在c：\program文件中安装Webex应用程序。 这在共享环境（通常是非持久VDI）中很有用。 如果未指定此参数，Webex应用程序安装在 %LocalAppData%\ \Cisco Spark | ✓ |
| 值为 如果您希望手动维护升级，请使用此选项。 使用 bex应用程序VDI发行说明 链接的版本。 参数不会影响非VDI环境。 值为 这一论点必须伴之以。 | ✓ |
| 控制优化的VDI解决方案。 （正式支持。）
| ✓ |
| 仅适用于捆绑安装程序。 在安装Webex应用程序的捆绑组件时，如果该应用程序版本与站点版本兼容，您可以使用此参数锁定用于加入会议的应用程序版本。 | ✓ |
INSTALLWV2=1 | 在安装Webex应用程序的同时安装Microsoft的WebView2嵌入式浏览器 有关Webex应用程序和WebView2要求的更多信息，请参阅 bex应用程序| WebView2要求。 | ✓ |
ROAMINGENABLED=1 | 如果指定了此参数，则漫游数据库( 这一论点必须伴之以。 有关更多信息，请参阅用户首选项。 | ✓ |
安装比较
用户可能在Citrix环境中，尚未安装瘦客户端或虚拟通道已断开连接。 通过回退到非虚拟Webex应用程序安装，我们支持此场景。 在此模式下，应用程序会显示警告，提示视频质量可能会受到影响。 连接虚拟通道后，应用程序可以更改为 VDI 模式。
使用此表了解不同的安装组合及其如何影响Unified CM、Webex 和Webex应用程序上的呼叫的媒体优化。
| HVD VDI参数 | 瘦客户端插件 | 启用呼叫服务的用户 | 在 Webex 应用程序上的呼叫 |
|---|---|---|---|
| ENABLEVDI=0 | 未安装 | 媒体未优化 | 媒体未优化 |
| ENABLEVDI=0 | 已安装 | 媒体未优化 | 媒体未优化 |
ENABLEVDI=1 * ENABLEVDI=2 ** | 已安装 | 支持的部署；媒体已优化 | 支持的部署；媒体已优化 |
ENABLEVDI=1 * ENABLEVDI=2 ** | 未安装 | 退回到未优化的媒体 | 退回到未优化的媒体 |
*此参数不会自动检测VDI环境。
**此参数会自动检测VDI环境。
用户首选项
所有用户首选项都位于漫游数据库( spark_roaming_store.db ）。 这个数据库比主数据库小得多( spark_persistent_store.db ）。
如果您是非永久性VDI客户（每次用户注销时都会删除的VDI环境），您可以快速备份和恢复文件夹 Appdata\Roaming\CiscoSpark 以便VDI用户不会在会话之间丢失首选项。
漫游数据库包含所有用户凭证和首选项，使用AES256加密。 作为VDI客户，您应始终备份上述文件夹，以便在整个VDI会话中维护用户凭证和首选项。
要解密漫游数据库，还应该同步VDI会话中的以下文件夹：
AppData\Roaming\Microsoft\CredentialsAppData\Roaming\Microsoft\CryptoAppData\Roaming\Microsoft\ProtectAppData\Roaming\Microsoft\SystemCertificates
为Webex应用程序配置Azure虚拟桌面
使用这些高级步骤在Azure虚拟桌面（之前称为Windows虚拟桌面）上部署新的Windows环境。 AVD是云管理的VDI解决方案。 用户通过虚拟Windows环境访问Webex应用程序。
| 我们不支持在Azure虚拟桌面上使用Webex应用程序的功能齐全的会议。 |
准备工作
此解决方案需要Microsoft Azure订阅。
您必须拥有具有Tenant 角色的用户帐户。
用户帐户必须同步到Azure Active Directory。
| 1 | 在Azure管理门户中完成部署步骤，以创建主机池、虚拟机和相关设置。 主机池是提供类似服务的VM的集合。 Azure表示虚拟环境何时准备就绪。 |
| 2 | 使用Windows客户端测试用户是否可以访问主机池。 有关特定的部署步骤，请参阅有关AVD入门的Microsoft文档。 |
在Windows瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，必须在瘦客户端设备上安装Webex应用程序VDI插件。
从 Webex应用程序VDI发行说明下载瘦客户端插件。
如果您无法为用户安装VDI插件，请在其瘦客户端设备上引导他们完成这些步骤。
准备工作
有关Windows版Webex应用程序VDI插件支持的平台列表，请参阅 瘦客户端 。
需要在中央HVD环境中安装Webex应用程序。
| 1 | 转至 bex应用程序VDI发行说明>下载，然后下载适用于Windows的Webex应用程序VDI插件安装程序。 |
| 2 | 运行 |
| 3 | 要打开可执行文件，请单击确定。 |
| 4 | 阅读EULA，如果您同意，请单击接受并安装。 |
| 5 | 要完成安装，请单击完成(Finish)。 |
| 6 | （可选）如果您或用户为功能齐全的会议手动安装两个插件，请按照 在瘦客户端系统上安装Meetings VDI插件中的步骤操作。 |
下一步
| 要使Webex应用程序能够为用户正常运行，您必须使用官方瘦客户端插件。 要进行确认，运行状况检查将显示虚拟通道的已连接状态。
|
在Linux瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。 瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
准备工作
请参阅 ux瘦客户端 ，了解Linux版Webex应用程序VDI插件支持的平台列表。
| 要使Webex应用程序能够为用户正常运行并针对VDI进行优化，您必须使用瘦客户端构建。 要确认，Webex应用程序中的运行状况检查会显示虚拟通道的已连接状态。
|
在macOS瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。 瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
运行MacOS安装程序(PKG)以安装Webex VDI插件。
准备工作
有关macOS版Webex应用程序VDI插件支持的平台列表，请参阅macOS瘦客户端。
| 1 | 从 bex应用程序VDI发行说明>下载 macOS瘦客户端系统的Webex应用程序插件。 |
| 2 | 运行 |
| 3 | 阅读EULA，如果您同意，请单击继续(Continue)。 |
| 4 | 单击安装，如果出现必须先关闭Citrix Workspace客户端或VMware Horizon客户端的提示，请单击关闭应用程序并安装。 如果当时无法关闭Citrix或VMware，也可以单击稍后安装。 |
| 5 | 单击其余屏幕以完成安装。 |
下一步
当用户首次启动Webex应用程序VDI插件时，接受以下所需的权限：
| 许可 | 描述 |
|---|---|
| 访问摄像头 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
| 访问麦克风 | 在呼叫中使用麦克风传输语音。 |
| 录制屏幕 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
| 要使Webex应用程序能够为用户正常运行，您必须使用下载站点上的官方瘦客户端插件。 要进行确认，运行状况检查将显示虚拟通道的已连接状态。 |
在瘦客户端系统上安装Webex Meetings VDI插件
对于使用Webex应用程序的功能齐全的会议：
在Windows或MacOS瘦客户端上，安装捆绑的(App + Meetings)插件。
在Linux瘦客户端上，在安装独立的应用程序VDI插件后安装独立的Meetings VDI插件。
准备工作
仅在HVD环境中安装Webex应用程序。 无需其他应用程序。
确保您遵循功能齐全的会议要求。
安装适用于Windows的捆绑插件：
此安装程序将Webex应用程序和Webex Meetings VDI插件作为一个软件包提供。 版本号可在下载页面上找到。 该捆绑插件安装程序每两个月发布一次。
为macOS安装捆绑插件：
此安装程序将Webex应用程序和Webex Meetings VDI插件作为一个软件包提供。 版本号可在下载页面上找到。 作为独立插件的Webex Meetings VDI每月发布一次，但这个捆绑插件安装程序每两个月发布一次。
VDI版Webex应用程序的已知问题和限制
功能
有关每个发行版的功能限制，请参阅Webex应用程序VDI发行说明。
Webex应用程序和VDI客户端
对于VDI模式，我们仅支持在 Webex应用程序VDI发行说明上发布的Windows版Webex应用程序（HVD安装程序）和Webex应用程序瘦客户端插件版本。
我们仅支持HVD和瘦客户端环境的IPv4。
当用户不使用VDI优化的解决方案或处于回退模式时，高清视频会被禁用，Webex应用程序会显示一条通知，告知您可能会看到媒体质量问题。
我们不建议用户在未优化或回退模式下使用VDI。 其摄像头或头戴式耳机可能无法正常工作，并且可能遇到媒体质量较差的情况。
在MacOS VDI客户端上，当HVD连接全屏时，视频源溢出到MacOS系统栏或应用程序菜单。
在Linux VDI客户端上，传入呼叫不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。 只有HVD上选择的音频设备才会播放铃声。
Unified CM呼叫
仅适用于使用Expressway进行的内部呼叫： 如果用于MRA的穿越对中HVD和Expressway-E之间没有NAT，则ExpressWAY将SIP和媒体信令视为内部，不会将媒体传输到瘦客户端。 要解决此问题，请在HVD和Expressway之间部署NAT。 这样，当HVD向ExpressWAY-E发送SIP邀请时，它会首先转到NAT。 然后，Expressway-E可以传输到瘦客户端。
对于备用模式，“模式选择”注册表项无法控制自动应答的Unified CM呼叫的媒体。
Citrix
多任务功能不适用于VDI上的Webex应用程序。
在非优化模式或回退模式下，Citrix设备映射最多支持4个设备。
在Linux版Citrix上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。 因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
在安装Webex应用程序VDI客户端之前，包括更新接收器/工作空间环境时，必须安装Citrix Receiver/Workspace。 如果未安装Citrix或VMWare客户端，Webex应用程序VDI客户端将显示错误并结束安装。
对于Windows，如果您运行的Citrix Workspace版本早于2002年，则必须在卸载并重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。 如果您运行版本2002或更高版本，则无需卸载并重新安装。
对于所有受支持的Linux版Citrix Workspace，您必须在卸载和重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。
Citrix Receiver/Workspace使用32位架构。 Webex应用程序VDI适用于此环境。
Azure虚拟桌面（之前称为Windows虚拟桌面）
在用于本地Unified CM呼叫的Azure虚拟桌面(AVD)上，我们目前仅支持在MRA下工作的瘦客户端。 WVD桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。 如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。 Webex 和Webex应用程序内置呼叫不受影响。
AVD不支持AVD客户端设置中的“将会话调整为窗口”。
对于AVD部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
VMware
在安装Webex应用程序VDI客户端之前，必须先安装VMware Horizon客户端。 如果未安装Citrix或VMware客户端，Webex应用程序VDI客户端将显示错误并结束安装。
41.4 及以上版本 Webex VDI 插件支持 VMWare Horizon 客户端 8.x 版 (2103)。
对于兼容模式： 如果用户使用之前的VDI插件版本（仅包括将Webex应用程序升级到41.4），通话中的视频可能无法正确显示。
我们不支持32位架构上的VMWare Horizon客户端，因为我们停止了用于Windows的32位插件。
Webex应用程序VDI客户端必须与VMware Horizon客户端具有相同的架构： 64位VMware Horizon客户端可与（64位）Webex应用程序VDI客户端配合使用。 VMware Horizon客户端只有一个安装程序，默认安装为64位。
如果
vdpService.dll存在于C:\Program Files (x86)\VMware\VMware Horizon View Client\x64，您有64位的VMware Horizon客户端。如果
vdpService.dll在以下C:\Program Files (x86)\VMware\VMware Horizon View Client\，您有32位VMware Horizon客户端。在适用于Linux和Windows的VMware上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。 因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
在用于本地Unified CM呼叫的VMware Cloud桌面上，我们目前仅支持在MRA下工作的瘦客户端。 VMware Cloud桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。 如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。 Webex 和Webex应用程序内置呼叫不受影响。
对于VMware Cloud桌面部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
在VMware Horizon Client上Connect USB设备中检查摄像头或音频设备后，HVD中的Webex无法检测或显示这些设备。
亚马逊工作空间
- 在托管虚拟桌面上，请按照此处的说明为GPO启用WSP分机。
- 如果在通过命令行手动进行新安装后，Webex应用程序的健康检查器中报告了“未检测到VDI环境”，请先尝试注销/登录托管的Windows桌面。
杂项
在Citrix和Windows虚拟桌面vGPU环境中，Webex应用程序不会被检测到在VDI环境中工作。
我们建议您安装Webex应用程序
ENABLEVDI=1来执行VDI优化。我们支持一个Webex应用程序VDI客户端与一个Webex应用程序实例一起工作。 用户可以启动多个Citrix或VMware会话，但只有一个连接实例有效，其他实例恢复为非VDI模式。
Webex应用程序VDI首先检测到CitRIX，然后在HVD环境中检测VMware。 如果要使用VMware，请确保未安装Citrix代理。
升级管理
虚拟桌面上的Webex应用程序升级
对于VDI环境，Webex应用程序的新发行版每两个月发布一次。 您可以从 Webex应用程序VDI发行说明>下载获取最新和受支持的版本。
我们建议您在虚拟桌面上为Webex应用程序启用自动升级。 此选项可确保用户自动获得最新功能。 另一种选择是在新发行版可用时手动升级。
您有两个选项可在虚拟桌面上启用Webex应用程序的自动升级：
在初始安装期间从命令行启用（请参阅本书部署章节中的为Webex应用程序配置托管虚拟桌面）。
在虚拟桌面上编辑Windows注册表项：
在注册表项中
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native，设置AutoUpgradeEnabled=1。如果要手动升级Webex应用程序，请设置
AutoUpgradeEnabled=0。
|
|
瘦客户端升级
Webex应用程序VDI插件每两个月发布一次。
我们建议您为插件启用自动升级。 要为VDI插件启用自动升级，您必须在虚拟桌面上编辑Windows注册表项：
在注册表项中
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native，设置AutoUpgradeVDIPluginEnabled=1。在同一路径中，请检查
AutoUpgradeEnabled=1。
如果要阻止插件的自动升级，请设置 AutoUpgradeVDIPluginEnabled=0 在虚拟桌面上。 如果选择此选项，必须手动升级插件以保持与应用程序的版本兼容性。
|
|
Citrix或VMware升级
在管理Citrix或VMware连接代理的升级或更改时，请记住此信息。 请务必使用“准备您的环境”一章中列出的受支持版本。
Citrix
安装或升级 | Windows和Mac瘦客户端 | Linux瘦客户端 |
|---|---|---|
新安装 | 在Windows或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 | 在Linux瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 |
升级 | 如果您在Citrix环境中看到升级通知，执行此升级不会影响Windows或Mac瘦客户端上的Webex应用程序VDI插件。 | 如果您在Citrix环境中看到升级通知，必须在升级Citrix环境后在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
重新安装 |
| 要重新安装任何受支持的Citrix Workspace版本，您必须在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
VMware
安装或升级 | Windows瘦客户端 | Linux和Mac瘦客户端 |
|---|---|---|
新安装 | 在Windows瘦客户端上安装Webex App VDI插件之前，请先安装VMware Horizon客户端。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 | 在Linux或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装VMware Horizon客户端。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 |
升级 | 如果您在VMware环境中看到升级通知，执行此升级不会影响Windows瘦客户端上的Webex应用程序VDI插件。 | 如果您在VMware环境中看到升级通知，必须在升级Citrix环境后在Linux或Mac瘦客户端上重新安装Webex应用程序VDI插件。 |
重新安装 | 对于VMware重新安装，Windows VDI插件可以正常工作，不受影响。 | 要重新安装VMware，您必须在Linux或Mac瘦客户端上重新安装Webex应用程序插件。 |
安装后禁用VDI检测
如果您有用户不想使用VDI客户端，并且Webex应用程序已部署，您可以在安装后禁用VDI检测。 完成此配置后，Webex应用程序将在未优化的解决方案上运行。
| 1 | 根据您在HVD中部署Webex应用程序的方式，打开以下安装路径之一：
|
| 2 | 重命名 |
下一步
如果稍后卸载Webex应用程序，TSDetectionib_bL.dll将保留在文件夹中。 您必须在卸载Webex应用程序之前将文件重命名为TSDetectionLib.dll，或在卸载Webex应用程序后ib_b 手动删除TSDetectionL.dll。
在Webex应用程序VDI回退模式中启用或禁用高级视频功能
通过修改注册表，您可以启用或禁用特定的Webex应用程序功能，例如高清(HD)和屏幕共享。 这样做可以节省数据中心服务器上的资源。 您还可以决定用户是否可以进行全屏或仅HVD窗口的屏幕共享。 如果您的用户使用的系统能够使用更高级的视频功能，您可以根据需要启用这些功能。
准备工作
您可以在安装VDI插件之前或之后修改注册表项。
对Windows注册表进行更改时应非常谨慎。 我们建议您在使用这些步骤之前备份注册表。
虚拟背景在缺省情况下被禁用。
要启用这些用户，请按照 Webex用户的虚拟背景 步骤进行操作。
确保用户的瘦客户端设备满足虚拟背景 要求。
| 1 | 在Windows搜索或运行窗口中，输入，然后按 | ||
| 2 | 转至 <UNK> KEY__ <UNK> \ \Cisco Spark Native\。 | ||
| 3 | 根据需要更改以下注册表项的值： | ||
| 4 | 为 VDIFallBackConf 选择DWORD值：
| ||
| 5 | 为 VDIBackgroundEnabled 选择DWORD值：
| ||
| 6 | 为 VDIScreenShareEnabled 选择DWORD值：
|
配置 VDI 插件通知
默认情况下，如果用户的Citrix或VMware客户端连接到没有VDI插件的HVD，系统会通知用户。 此时将显示通知，通知他们安装VDI插件，以便启用优化的VDI模式。 如果需要，用户可以关闭提醒。
此外，如果Webex应用程序VDI插件的版本与HVD上的Webex应用程序不兼容，将弹出窗口通知用户升级Webex应用程序VDI插件。 提醒每周显示一次，直到用户采取行动为止。 用户也可以驳回此通知。
作为管理员，您可以在组织范围内启用或禁用这些通知。
准备工作
您可以在安装VDI插件之前或之后修改注册表项。
| 对Windows注册表进行更改时应非常谨慎。 我们建议您在使用这些步骤之前备份注册表。 |
| 1 | 在Windows搜索或运行窗口中，输入，然后按 |
| 2 | 转至 <UNK> KEY__ <UNK> \ \Cisco Spark Native\。 |
| 3 | 为 VDIPluginNotificationEnabled 选择DWORD（32位）注册键值：
|
禁用VDI版本兼容性检查
默认情况下，HVD上的Webex应用程序会检查与瘦客户端上的Webex VDI插件的版本兼容性。 插件版本不应超过Webex应用程序后面的4个两个月发行版。 例如，如果HVD上的Webex应用程序版本为43.8（2023年8月），则以下插件版本兼容：
43.8 (N) 2023年8月
43.6 (N-1) 2023年6月
43.4 (N-2) 2023年4月
43.2 (N-3) 2023年2月
42.12 (N-4) 2022年12月
在升级托管虚拟桌面后，此兼容性最多可让您在6个月内升级瘦客户端插件。
如果Webex VDI插件与HVD上的Webex应用程序不兼容，则Webex应用程序进入回退模式。 用户会看到升级插件的弹出通知。 提醒每周显示一次，直到用户采取行动为止。
您可以使用HVD上的注册表来控制版本兼容性检查：
| 我们建议您在使用这些步骤之前备份注册表。 |
在Windows Run窗口中，输入
regedit然后按Enter键。请转至
HKEY_LOCAL_MACHINE\Software\Cisco Spark Native\。创建名为DWORD（32位）注册表项
VDIDisableCompatibilityVersionCheck并给出以下值之一：0-启用版本兼容性检查（默认）。1—禁用版本兼容性检查。
振铃器和警报设置不适用于所有设备
在Linux VDI客户端上，传入呼叫的铃声不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。 只有HVD上选择的音频设备才会播放铃声。
出现此问题的原因可能是Citrix或VMware上的音频设备映射。
检查注册表项 VDIDisablePlaytoneOnLinuxTCEnabled 在HVD环境中。 如果Linux瘦客户端用户正在观察此回铃音问题，请将此键的值设置为 1 。
Webex 应用程序中的诊断
Webex应用程序（桌面和VDI）中提供的诊断功能可帮助您和您的用户解决连接问题、检查媒体质量并收集重要的故障诊断信息。
在Webex应用程序中设置呼叫功能(Unified CM)时，您可能会遇到与连接或所需设置（例如语音域和UC服务）相关的问题。 使用此工具，您可以诊断哪些服务配置正确，哪些服务缺失。 无论您是迁移到Webex应用程序中的呼叫(Unified CM)还是设置新用户，此功能都可用于故障排除场景和减少支持案例。
当用户体验出现问题时，他们可以 诊断视图并导出数据，以便与您共享或支持人员。
Unified CM设置—电话服务正常工作的关键设置（适用于Jabber迁移以及新用户设置），例如：
Unified CM 版本
UC服务域
单点登录
语音邮件等UC服务
用于MRA的Expressway
媒体质量—视频、音频和双向共享的质量
设备—当用户连接到设备时的设备信息
有关显示诊断窗口的快捷键，请参阅键盘和导航快捷键。
浏览器内容重定向
浏览器内容重定向(BCR)是VDI环境的一种优化，可减少虚拟机上的负载。
在虚拟桌面上启用BCR后，Webex应用程序无法通过远程屏幕共享、应用程序共享或屏幕部分共享来共享浏览器内容。
Webex用户可以使用本地屏幕共享来共享浏览器。
Webex应用程序VDI部署任务流程
这些步骤将指导您了解如何在VDI环境中部署Webex应用程序。 这些步骤包括您需要在托管虚拟桌面(HVD)环境中执行的操作，以及用户需要在瘦客户端上执行的操作。
准备工作
| 如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须在部署VDI之前使用准备环境章节中的说明部署呼叫服务（Unified CM、Webex 或BroadWorks）。 |
| 1 | 配置以下托管虚拟桌面类型之一： 要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。 |
| 2 | 在以下平台的瘦客户端计算机上安装Webex应用程序VDI插件：
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。 瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 可从 Webex应用程序VDI发行说明获取支持平台的瘦客户端插件。 |
| 3 | （可选）在Linux瘦客户端上，您还必须在瘦客户端系统上 Webex Meetings VDI插件。 对于Webex应用程序中功能齐全的会议，您必须在Linux瘦客户端上安装两个单独的VDI插件。 |
配置托管虚拟桌面并安装Webex应用程序
要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。
准备工作
遵循为VDI版Webex应用程序做好环境准备中的所有前提条件。
如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须先部署呼叫服务（Unified CM、Webex 或BroadWorks），然后再部署VDI。
本节仅介绍如何在现有HVD环境中安装Webex应用程序。 有关HVD部署最佳实践，请参阅Citrix或Vmware文档。
| 1 | 以拥有域管理权限的新用户身份登录Microsoft Windows HVD。 | ||
| 2 | 将 HVD 加入企业域。 | ||
| 3 | 设置 Citrix 或 VMware 对 HVD 的访问权限。 | ||
| 4 | 如果您的组织有自己的下载站点，其中包含站点特定的Webex应用程序，请转至该站点并下载组织特定的版本。 否则，对于通用版本，请转至 Webex应用程序VDI发行说明>下载并下载所需的Webex应用程序：
| ||
| 5 | 使用管理权限，使用这些命令和参数在HVD上安装应用程序(这些示例使用的下载目录
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。 | ||
| 6 | 复制 HVD 映像。 有关克隆Microsoft Windows HVD图像最佳实践的更多信息，请参阅Citrix或VMware产品的文档。 |
下一步
有关用户首选项以及如何保留的信息，请参阅用户首选项。
安装参数、说明和所需权限
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。
| 参数 | 笔记 | 需要管理员安装权限 |
|---|---|---|
ALLUSERS=1 | 在c：\program文件中安装Webex应用程序。 这在共享环境（通常是非持久VDI）中很有用。 如果未指定此参数，Webex应用程序安装在 %LocalAppData%\ \Cisco Spark | ✓ |
| 值为 如果您希望手动维护升级，请使用此选项。 使用 bex应用程序VDI发行说明 链接的版本。 参数不会影响非VDI环境。 值为 这一论点必须伴之以。 | ✓ |
| 控制优化的VDI解决方案。 （正式支持。）
| ✓ |
| 仅适用于捆绑安装程序。 在安装Webex应用程序的捆绑组件时，如果该应用程序版本与站点版本兼容，您可以使用此参数锁定用于加入会议的应用程序版本。 | ✓ |
INSTALLWV2=1 | 在安装Webex应用程序的同时安装Microsoft的WebView2嵌入式浏览器 有关Webex应用程序和WebView2要求的更多信息，请参阅 bex应用程序| WebView2要求。 | ✓ |
ROAMINGENABLED=1 | 如果指定了此参数，则漫游数据库( 这一论点必须伴之以。 有关更多信息，请参阅用户首选项。 | ✓ |
安装比较
用户可能在Citrix环境中，尚未安装瘦客户端或虚拟通道已断开连接。 通过回退到非虚拟Webex应用程序安装，我们支持此场景。 在此模式下，应用程序会显示警告，提示视频质量可能会受到影响。 连接虚拟通道后，应用程序可以更改为 VDI 模式。
使用此表了解不同的安装组合及其如何影响Unified CM、Webex 和Webex应用程序上的呼叫的媒体优化。
| HVD VDI参数 | 瘦客户端插件 | 启用呼叫服务的用户 | 在 Webex 应用程序上的呼叫 |
|---|---|---|---|
| ENABLEVDI=0 | 未安装 | 媒体未优化 | 媒体未优化 |
| ENABLEVDI=0 | 已安装 | 媒体未优化 | 媒体未优化 |
ENABLEVDI=1 * ENABLEVDI=2 ** | 已安装 | 支持的部署；媒体已优化 | 支持的部署；媒体已优化 |
ENABLEVDI=1 * ENABLEVDI=2 ** | 未安装 | 退回到未优化的媒体 | 退回到未优化的媒体 |
*此参数不会自动检测VDI环境。
**此参数会自动检测VDI环境。
用户首选项
所有用户首选项都位于漫游数据库( spark_roaming_store.db ）。 这个数据库比主数据库小得多( spark_persistent_store.db ）。
如果您是非永久性VDI客户（每次用户注销时都会删除的VDI环境），您可以快速备份和恢复文件夹 Appdata\Roaming\CiscoSpark 以便VDI用户不会在会话之间丢失首选项。
漫游数据库包含所有用户凭证和首选项，使用AES256加密。 作为VDI客户，您应始终备份上述文件夹，以便在整个VDI会话中维护用户凭证和首选项。
要解密漫游数据库，还应该同步VDI会话中的以下文件夹：
AppData\Roaming\Microsoft\CredentialsAppData\Roaming\Microsoft\CryptoAppData\Roaming\Microsoft\ProtectAppData\Roaming\Microsoft\SystemCertificates
为Webex应用程序配置Azure虚拟桌面
使用这些高级步骤在Azure虚拟桌面（之前称为Windows虚拟桌面）上部署新的Windows环境。 AVD是云管理的VDI解决方案。 用户通过虚拟Windows环境访问Webex应用程序。
| 我们不支持在Azure虚拟桌面上使用Webex应用程序的功能齐全的会议。 |
准备工作
此解决方案需要Microsoft Azure订阅。
您必须拥有具有Tenant 角色的用户帐户。
用户帐户必须同步到Azure Active Directory。
| 1 | 在Azure管理门户中完成部署步骤，以创建主机池、虚拟机和相关设置。 主机池是提供类似服务的VM的集合。 Azure表示虚拟环境何时准备就绪。 |
| 2 | 使用Windows客户端测试用户是否可以访问主机池。 有关特定的部署步骤，请参阅有关AVD入门的Microsoft文档。 |
在Windows瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，必须在瘦客户端设备上安装Webex应用程序VDI插件。
从 Webex应用程序VDI发行说明下载瘦客户端插件。
如果您无法为用户安装VDI插件，请在其瘦客户端设备上引导他们完成这些步骤。
准备工作
有关Windows版Webex应用程序VDI插件支持的平台列表，请参阅 瘦客户端 。
需要在中央HVD环境中安装Webex应用程序。
| 1 | 转至 bex应用程序VDI发行说明>下载，然后下载适用于Windows的Webex应用程序VDI插件安装程序。 |
| 2 | 运行 |
| 3 | 要打开可执行文件，请单击确定。 |
| 4 | 阅读EULA，如果您同意，请单击接受并安装。 |
| 5 | 要完成安装，请单击完成(Finish)。 |
| 6 | （可选）如果您或用户为功能齐全的会议手动安装两个插件，请按照 在瘦客户端系统上安装Meetings VDI插件中的步骤操作。 |
下一步
| 要使Webex应用程序能够为用户正常运行，您必须使用官方瘦客户端插件。 要进行确认，运行状况检查将显示虚拟通道的已连接状态。
|
在Linux瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。 瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
准备工作
请参阅 ux瘦客户端 ，了解Linux版Webex应用程序VDI插件支持的平台列表。
| 要使Webex应用程序能够为用户正常运行并针对VDI进行优化，您必须使用瘦客户端构建。 要确认，Webex应用程序中的运行状况检查会显示虚拟通道的已连接状态。
|
在macOS瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。 瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
运行MacOS安装程序(PKG)以安装Webex VDI插件。
准备工作
有关macOS版Webex应用程序VDI插件支持的平台列表，请参阅macOS瘦客户端。
| 1 | 从 bex应用程序VDI发行说明>下载 macOS瘦客户端系统的Webex应用程序插件。 |
| 2 | 运行 |
| 3 | 阅读EULA，如果您同意，请单击继续(Continue)。 |
| 4 | 单击安装，如果出现必须先关闭Citrix Workspace客户端或VMware Horizon客户端的提示，请单击关闭应用程序并安装。 如果当时无法关闭Citrix或VMware，也可以单击稍后安装。 |
| 5 | 单击其余屏幕以完成安装。 |
下一步
当用户首次启动Webex应用程序VDI插件时，接受以下所需的权限：
| 许可 | 描述 |
|---|---|
| 访问摄像头 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
| 访问麦克风 | 在呼叫中使用麦克风传输语音。 |
| 录制屏幕 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
| 要使Webex应用程序能够为用户正常运行，您必须使用下载站点上的官方瘦客户端插件。 要进行确认，运行状况检查将显示虚拟通道的已连接状态。 |
在瘦客户端系统上安装Webex Meetings VDI插件
对于使用Webex应用程序的功能齐全的会议：
在Windows或MacOS瘦客户端上，安装捆绑的(App + Meetings)插件。
在Linux瘦客户端上，在安装独立的应用程序VDI插件后安装独立的Meetings VDI插件。
准备工作
仅在HVD环境中安装Webex应用程序。 无需其他应用程序。
确保您遵循功能齐全的会议要求。
安装适用于Windows的捆绑插件：
此安装程序将Webex应用程序和Webex Meetings VDI插件作为一个软件包提供。 版本号可在下载页面上找到。 该捆绑插件安装程序每两个月发布一次。
为macOS安装捆绑插件：
此安装程序将Webex应用程序和Webex Meetings VDI插件作为一个软件包提供。 版本号可在下载页面上找到。 作为独立插件的Webex Meetings VDI每月发布一次，但这个捆绑插件安装程序每两个月发布一次。
VDI版Webex应用程序的已知问题和限制
功能
有关每个发行版的功能限制，请参阅Webex应用程序VDI发行说明。
Webex应用程序和VDI客户端
对于VDI模式，我们仅支持在 Webex应用程序VDI发行说明上发布的Windows版Webex应用程序（HVD安装程序）和Webex应用程序瘦客户端插件版本。
我们仅支持HVD和瘦客户端环境的IPv4。
当用户不使用VDI优化的解决方案或处于回退模式时，高清视频会被禁用，Webex应用程序会显示一条通知，告知您可能会看到媒体质量问题。
我们不建议用户在未优化或回退模式下使用VDI。 其摄像头或头戴式耳机可能无法正常工作，并且可能遇到媒体质量较差的情况。
在MacOS VDI客户端上，当HVD连接全屏时，视频源溢出到MacOS系统栏或应用程序菜单。
在Linux VDI客户端上，传入呼叫不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。 只有HVD上选择的音频设备才会播放铃声。
Unified CM呼叫
仅适用于使用Expressway进行的内部呼叫： 如果用于MRA的穿越对中HVD和Expressway-E之间没有NAT，则ExpressWAY将SIP和媒体信令视为内部，不会将媒体传输到瘦客户端。 要解决此问题，请在HVD和Expressway之间部署NAT。 这样，当HVD向ExpressWAY-E发送SIP邀请时，它会首先转到NAT。 然后，Expressway-E可以传输到瘦客户端。
对于备用模式，“模式选择”注册表项无法控制自动应答的Unified CM呼叫的媒体。
Citrix
多任务功能不适用于VDI上的Webex应用程序。
在非优化模式或回退模式下，Citrix设备映射最多支持4个设备。
在Linux版Citrix上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。 因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
在安装Webex应用程序VDI客户端之前，包括更新接收器/工作空间环境时，必须安装Citrix Receiver/Workspace。 如果未安装Citrix或VMWare客户端，Webex应用程序VDI客户端将显示错误并结束安装。
对于Windows，如果您运行的Citrix Workspace版本早于2002年，则必须在卸载并重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。 如果您运行版本2002或更高版本，则无需卸载并重新安装。
对于所有受支持的Linux版Citrix Workspace，您必须在卸载和重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。
Citrix Receiver/Workspace使用32位架构。 Webex应用程序VDI适用于此环境。
Azure虚拟桌面（之前称为Windows虚拟桌面）
在用于本地Unified CM呼叫的Azure虚拟桌面(AVD)上，我们目前仅支持在MRA下工作的瘦客户端。 WVD桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。 如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。 Webex 和Webex应用程序内置呼叫不受影响。
AVD不支持AVD客户端设置中的“将会话调整为窗口”。
对于AVD部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
VMware
在安装Webex应用程序VDI客户端之前，必须先安装VMware Horizon客户端。 如果未安装Citrix或VMware客户端，Webex应用程序VDI客户端将显示错误并结束安装。
41.4 及以上版本 Webex VDI 插件支持 VMWare Horizon 客户端 8.x 版 (2103)。
对于兼容模式： 如果用户使用之前的VDI插件版本（仅包括将Webex应用程序升级到41.4），通话中的视频可能无法正确显示。
我们不支持32位架构上的VMWare Horizon客户端，因为我们停止了用于Windows的32位插件。
Webex应用程序VDI客户端必须与VMware Horizon客户端具有相同的架构： 64位VMware Horizon客户端可与（64位）Webex应用程序VDI客户端配合使用。 VMware Horizon客户端只有一个安装程序，默认安装为64位。
如果
vdpService.dll存在于C:\Program Files (x86)\VMware\VMware Horizon View Client\x64，您有64位的VMware Horizon客户端。如果
vdpService.dll在以下C:\Program Files (x86)\VMware\VMware Horizon View Client\，您有32位VMware Horizon客户端。在适用于Linux和Windows的VMware上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。 因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
在用于本地Unified CM呼叫的VMware Cloud桌面上，我们目前仅支持在MRA下工作的瘦客户端。 VMware Cloud桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。 如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。 Webex 和Webex应用程序内置呼叫不受影响。
对于VMware Cloud桌面部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
在VMware Horizon Client上Connect USB设备中检查摄像头或音频设备后，HVD中的Webex无法检测或显示这些设备。
亚马逊工作空间
- 在托管虚拟桌面上，请按照此处的说明为GPO启用WSP分机。
- 如果在通过命令行手动进行新安装后，Webex应用程序的健康检查器中报告了“未检测到VDI环境”，请先尝试注销/登录托管的Windows桌面。
杂项
在Citrix和Windows虚拟桌面vGPU环境中，Webex应用程序不会被检测到在VDI环境中工作。
我们建议您安装Webex应用程序
ENABLEVDI=1来执行VDI优化。我们支持一个Webex应用程序VDI客户端与一个Webex应用程序实例一起工作。 用户可以启动多个Citrix或VMware会话，但只有一个连接实例有效，其他实例恢复为非VDI模式。
Webex应用程序VDI首先检测到CitRIX，然后在HVD环境中检测VMware。 如果要使用VMware，请确保未安装Citrix代理。
升级管理
虚拟桌面上的Webex应用程序升级
对于VDI环境，Webex应用程序的新发行版每两个月发布一次。 您可以从 Webex应用程序VDI发行说明>下载获取最新和受支持的版本。
我们建议您在虚拟桌面上为Webex应用程序启用自动升级。 此选项可确保用户自动获得最新功能。 另一种选择是在新发行版可用时手动升级。
您有两个选项可在虚拟桌面上启用Webex应用程序的自动升级：
在初始安装期间从命令行启用（请参阅本书部署章节中的为Webex应用程序配置托管虚拟桌面）。
在虚拟桌面上编辑Windows注册表项：
在注册表项中
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native，设置AutoUpgradeEnabled=1。如果要手动升级Webex应用程序，请设置
AutoUpgradeEnabled=0。
|
|
瘦客户端升级
Webex应用程序VDI插件每两个月发布一次。
我们建议您为插件启用自动升级。 要为VDI插件启用自动升级，您必须在虚拟桌面上编辑Windows注册表项：
在注册表项中
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native，设置AutoUpgradeVDIPluginEnabled=1。在同一路径中，请检查
AutoUpgradeEnabled=1。
如果要阻止插件的自动升级，请设置 AutoUpgradeVDIPluginEnabled=0 在虚拟桌面上。 如果选择此选项，必须手动升级插件以保持与应用程序的版本兼容性。
|
|
Citrix或VMware升级
在管理Citrix或VMware连接代理的升级或更改时，请记住此信息。 请务必使用“准备您的环境”一章中列出的受支持版本。
Citrix
安装或升级 | Windows和Mac瘦客户端 | Linux瘦客户端 |
|---|---|---|
新安装 | 在Windows或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 | 在Linux瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 |
升级 | 如果您在Citrix环境中看到升级通知，执行此升级不会影响Windows或Mac瘦客户端上的Webex应用程序VDI插件。 | 如果您在Citrix环境中看到升级通知，必须在升级Citrix环境后在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
重新安装 |
| 要重新安装任何受支持的Citrix Workspace版本，您必须在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
VMware
安装或升级 | Windows瘦客户端 | Linux和Mac瘦客户端 |
|---|---|---|
新安装 | 在Windows瘦客户端上安装Webex App VDI插件之前，请先安装VMware Horizon客户端。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 | 在Linux或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装VMware Horizon客户端。 您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 |
升级 | 如果您在VMware环境中看到升级通知，执行此升级不会影响Windows瘦客户端上的Webex应用程序VDI插件。 | 如果您在VMware环境中看到升级通知，必须在升级Citrix环境后在Linux或Mac瘦客户端上重新安装Webex应用程序VDI插件。 |
重新安装 | 对于VMware重新安装，Windows VDI插件可以正常工作，不受影响。 | 要重新安装VMware，您必须在Linux或Mac瘦客户端上重新安装Webex应用程序插件。 |
安装后禁用VDI检测
如果您有用户不想使用VDI客户端，并且Webex应用程序已部署，您可以在安装后禁用VDI检测。 完成此配置后，Webex应用程序将在未优化的解决方案上运行。
| 1 | 根据您在HVD中部署Webex应用程序的方式，打开以下安装路径之一：
|
| 2 | 重命名 |
下一步
如果稍后卸载Webex应用程序，TSDetectionib_bL.dll将保留在文件夹中。 您必须在卸载Webex应用程序之前将文件重命名为TSDetectionLib.dll，或在卸载Webex应用程序后ib_b 手动删除TSDetectionL.dll。
在Webex应用程序VDI回退模式中启用或禁用高级视频功能
通过修改注册表，您可以启用或禁用特定的Webex应用程序功能，例如高清(HD)和屏幕共享。 这样做可以节省数据中心服务器上的资源。 您还可以决定用户是否可以进行全屏或仅HVD窗口的屏幕共享。 如果您的用户使用的系统能够使用更高级的视频功能，您可以根据需要启用这些功能。
准备工作
您可以在安装VDI插件之前或之后修改注册表项。
对Windows注册表进行更改时应非常谨慎。 我们建议您在使用这些步骤之前备份注册表。
虚拟背景在缺省情况下被禁用。
要启用这些用户，请按照 Webex用户的虚拟背景 步骤进行操作。
确保用户的瘦客户端设备满足虚拟背景 要求。
| 1 | 在Windows搜索或运行窗口中，输入，然后按 | ||
| 2 | 转至 <UNK> KEY__ <UNK> \ \Cisco Spark Native\。 | ||
| 3 | 根据需要更改以下注册表项的值： | ||
| 4 | 为 VDIFallBackConf 选择DWORD值：
| ||
| 5 | 为 VDIBackgroundEnabled 选择DWORD值：
| ||
| 6 | 为 VDIScreenShareEnabled 选择DWORD值：
|
配置 VDI 插件通知
默认情况下，如果用户的Citrix或VMware客户端连接到没有VDI插件的HVD，系统会通知用户。 此时将显示通知，通知他们安装VDI插件，以便启用优化的VDI模式。 如果需要，用户可以关闭提醒。
此外，如果Webex应用程序VDI插件的版本与HVD上的Webex应用程序不兼容，将弹出窗口通知用户升级Webex应用程序VDI插件。 提醒每周显示一次，直到用户采取行动为止。 用户也可以驳回此通知。
作为管理员，您可以在组织范围内启用或禁用这些通知。
准备工作
您可以在安装VDI插件之前或之后修改注册表项。
| 对Windows注册表进行更改时应非常谨慎。 我们建议您在使用这些步骤之前备份注册表。 |
| 1 | 在Windows搜索或运行窗口中，输入，然后按 |
| 2 | 转至 <UNK> KEY__ <UNK> \ \Cisco Spark Native\。 |
| 3 | 为 VDIPluginNotificationEnabled 选择DWORD（32位）注册键值：
|
禁用VDI版本兼容性检查
默认情况下，HVD上的Webex应用程序会检查与瘦客户端上的Webex VDI插件的版本兼容性。 插件版本不应超过Webex应用程序后面的4个两个月发行版。 例如，如果HVD上的Webex应用程序版本为43.8（2023年8月），则以下插件版本兼容：
43.8 (N) 2023年8月
43.6 (N-1) 2023年6月
43.4 (N-2) 2023年4月
43.2 (N-3) 2023年2月
42.12 (N-4) 2022年12月
在升级托管虚拟桌面后，此兼容性最多可让您在6个月内升级瘦客户端插件。
如果Webex VDI插件与HVD上的Webex应用程序不兼容，则Webex应用程序进入回退模式。 用户会看到升级插件的弹出通知。 提醒每周显示一次，直到用户采取行动为止。
您可以使用HVD上的注册表来控制版本兼容性检查：
| 我们建议您在使用这些步骤之前备份注册表。 |
在Windows Run窗口中，输入
regedit然后按Enter键。请转至
HKEY_LOCAL_MACHINE\Software\Cisco Spark Native\。创建名为DWORD（32位）注册表项
VDIDisableCompatibilityVersionCheck并给出以下值之一：0-启用版本兼容性检查（默认）。1—禁用版本兼容性检查。
振铃器和警报设置不适用于所有设备
在Linux VDI客户端上，传入呼叫的铃声不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。 只有HVD上选择的音频设备才会播放铃声。
出现此问题的原因可能是Citrix或VMware上的音频设备映射。
检查注册表项 VDIDisablePlaytoneOnLinuxTCEnabled 在HVD环境中。 如果Linux瘦客户端用户正在观察此回铃音问题，请将此键的值设置为 1 。
Webex 应用程序中的诊断
Webex应用程序（桌面和VDI）中提供的诊断功能可帮助您和您的用户解决连接问题、检查媒体质量并收集重要的故障诊断信息。
在Webex应用程序中设置呼叫功能(Unified CM)时，您可能会遇到与连接或所需设置（例如语音域和UC服务）相关的问题。 使用此工具，您可以诊断哪些服务配置正确，哪些服务缺失。 无论您是迁移到Webex应用程序中的呼叫(Unified CM)还是设置新用户，此功能都可用于故障排除场景和减少支持案例。
当用户体验出现问题时，他们可以 诊断视图并导出数据，以便与您共享或支持人员。
Unified CM设置—电话服务正常工作的关键设置（适用于Jabber迁移以及新用户设置），例如：
Unified CM 版本
UC服务域
单点登录
语音邮件等UC服务
用于MRA的Expressway
媒体质量—视频、音频和双向共享的质量
设备—当用户连接到设备时的设备信息
有关显示诊断窗口的快捷键，请参阅键盘和导航快捷键。
浏览器内容重定向
浏览器内容重定向(BCR)是VDI环境的一种优化，可减少虚拟机上的负载。
在虚拟桌面上启用BCR后，Webex应用程序无法通过远程屏幕共享、应用程序共享或屏幕部分共享来共享浏览器内容。
Webex用户可以使用本地屏幕共享来共享浏览器。
新信息和更改信息
此表涵盖与新功能相关的内容更新、现有内容的更改，以及在适用于虚拟桌面基础结构(VDI)的Webex应用程序部署指南中修复的任何重大错误。
有关Webex应用程序VDI更新、新功能、新增的VDI支持和限制的更多信息，请参阅 VDI发行说明。
|
日期 |
已做更改 |
|---|---|
|
2023年11月13日 |
准备您的环境：
|
|
2023年8月23日 |
整个文档：
准备您的环境：
用于VDI的Webex应用程序：
用于VDI的Webex应用程序并进行故障排除：
|
|
2023年5月18日 |
在功能齐全的会议要求中澄清了有关Azure虚拟桌面的注释。AVD不支持功能齐全的会议。 |
|
2023 年 4 月 17 日 |
VDI的Webex应用程序 有关禁用VDI版本兼容性检查的新内容。 在托管虚拟桌面和瘦客户端要求中更新了43.4（2023年4月）发行版支持的基础结构和操作系统版本。 |
|
2023年3月15日 |
|
|
2023年3月3日 |
|
|
2023年2月27日 |
添加了在VDI会话之间同步一些 |
|
2023年1月11日 |
在托管虚拟桌面和瘦客户端要求中添加了最新测试的基础设施和瘦客户端操作系统版本以及支持的硬件。包括Apple M2芯片、macOS Ventura、HP ThinPro 8和Dell ThinOS 9.3。 |
|
2022年10月26日 |
更新了“ |
|
2022年8月25日 |
更新了Webex应用程序VDI 42.8版：
更新了 |
|
2022年5月30日 |
|
|
2022 年 4 月 26 日 |
|
|
2022 年 4 月 25 日 |
|
|
2022 年 4 月 13 日 |
|
|
2022年2月9日 |
|
|
2022 年 2 月 3 日 |
|
|
2021年12月15日 |
|
|
2021 年 11 月 12 日 |
|
|
2021年10月29日 |
|
|
2021年10月8日 |
|
|
2021 年 8 月 10 日 |
|
|
2021年7月6日 |
|
|
2021年6月3日 |
6月(41.6)发行版的更新，包括以下内容：
其他常规更新：
|
|
2021年5月3日 |
|
|
2021 年 4 月 16 日 |
|
|
2021年4月9日 |
|
|
2021年1月18日 |
|
|
2020 年 12 月 11 日 |
|
|
2020 年 9 月 29 日 |
|
|
2020年7月16日 |
|
|
2020年6月29日 |
|
VDI版Webex应用程序概述
未优化的情况下，Webex 应用程序消息传递功能会在虚拟桌面基础结构 (VDI) 环境中按原样运行。不过，完整的 Webex 应用程序体验还包括呼叫和会议，而这些功能需要视频和音频媒体处理。
受发夹效应的限制，在未进行优化的情况下，呼叫、会议及相应的视频功能将不受支持。由于媒体是从一个用户流向数据中心后才能流向下一用户，呼叫和视频所需的额外带宽会给数据中心造成瓶颈。在未优化的媒体路径和访问外围设备（如扬声器、麦克风和摄像头等）困难等因素的共同影响下，用户体验难免差强人意。
为了解决“发夹效应”，Webex 应用程序 VDI 插件在虚拟部署中如法炮制 Cisco 的协作体验，以便用户能够使用 Webex 应用程序提供的完整的消息传递、会议和呼叫功能。
为减少延迟并提高媒体质量，VDI 插件通过在瘦客户端终端上的用户之间采取直接流式传输媒体来优化媒体工作流，并利用瘦客户端计算机的硬件进行媒体处理。此媒体路径不经过托管的虚拟桌面 （HVD）。其结果就是，您的 VDI 用户能够获得稳定且功能齐全的呼叫和会议体验。
在该体系结构中，Webex 应用程序安装在 VDI 环境的 HVD 上，所需的 VDI 插件则安装在用户的瘦客户端（通常为轻量系统，如改装过的笔记本电脑或台式电脑）上。
使用受支持的基于Linux、Mac或Windows的瘦客户端，用户可从远程虚拟桌面环境访问HVD上的Webex应用程序。借助受支持的Webex应用程序版本，用户可以在瘦客户端上使用所有内置消息传递、会议和呼叫功能。此外，您可以将 Webex 应用程序 VDI 与 Unified CM 或 Webex Calling 环境集成，以便用户能够使用受支持的呼叫功能。
-
虚拟桌面上的Webex应用程序仍在处理轻量级数据，例如呼叫信令和从云端检索配置。
-
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex应用程序VDI插件一起安装。
有关每个发行版的新功能，请参阅发行说明 了解更多信息。
VDI环境概述
VDI组件
在优化的虚拟环境中使用Webex应用程序需要以下组件。
-
连接代理—将虚拟化提供程序连接到瘦客户端的资源和连接管理器(Citrix、VMware)。
-
托管虚拟桌面(HVD)—远程运行Webex应用程序的虚拟机(VM)。
-
瘦客户端—用户用于远程登录到虚拟桌面的终端（例如，低调或重用的台式电脑或笔记本电脑）。连接代理和VDI插件安装在瘦客户端设备上，因此可以访问HVD环境。
-
插件-安装在瘦客户端上的软件，用于将媒体处理分担到用户设备，而不是HVD资源。支持的Webex应用程序VDI插件版本从Webex应用程序 DI发行说明的“下载”标签页链接。
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex VDI插件一起安装。
-
bex应用程序—在HVD上安装并运行的应用程序。HVD安装程序受支持的版本位于Webex应用程序 DI发行说明的“下载”标签页。
环境类型
-
模式—在永久环境中，用户注销后将保留用户的本地操作系统更改。
所有用户首选项都在漫游数据库(
spark_roaming_store。db)中。此数据库比主db (spark_persistent_store。db)小得多。 -
持久模式—在非持久环境中，用户注销后不保留用户的本地操作系统更改。用户会话期间缓存适用的用户特定信息（用户数据、配置文件和设置）。
如果您是非持久VDI客户（每次用户注销时都会删除这种VDI环境），您可以快速备份和恢复
spark_roaming_store。db，以便VDI用户不会在会话之间失去首选项。漫游数据库包含所有用户凭证和首选项，使用AES256加密。作为VDI客户，您应始终备份漫游数据库，以便在整个VDI会话中维护用户凭证和首选项。
体系结构
架构图显示了具有现有支持呼叫服务部署的典型Webex应用程序VDI部署中涉及的组件、信令和优化媒体流：Unified CM、Webex 或BroadWorks。
每个程序框图的左侧是包含虚拟环境的公司网络。这种虚拟环境通过在虚拟数据中心运行应用程序、操作系统和用户数据来减轻用户端硬件的负载。借助该框架，您可以从中央位置管理环境，用户可以从受支持的瘦客户端远程访问该环境。
公司网络中的组件包括托管虚拟桌面(HVD)、您管理的安装和运行Webex应用程序的中央环境，以及与用户瘦客户端终端的虚拟通道连接（通过Cisco HVDAgent）。
在瘦客户端上，用户安装Webex VDI插件并登录到连接代理（Citrix或VMware），这是一款创建与HVD连接的软件。连接代理执行多项任务，包括：
-
验证用户名并为用户提供连接。
-
允许用户连接到特定虚拟桌面。
登录后，瘦客户端端点通过显示器、键盘、鼠标、USB设备等外围设备模拟与应用程序和操作系统的交互，就像软件安装在瘦客户端上一样。用户在此端点上使用瘦客户端应用程序访问远程服务器上的Webex应用程序。
该架构优化了信令和媒体的方向。它通过HTTPS、WSS和SIP与Webex云或BroadWorks云（右侧）进行信令通信。会议（Webex应用程序）和呼叫（Unified CM、Webex 或BroadWorks）的独立媒体流通过SRTP建立。
您必须在HVD上更新Webex应用程序。新版本每两个月发布一次，与之前的瘦客户端VDI插件向后兼容。新的瘦客户端VDI插件构建版本也每两个月提供一次。下载该软件 并参阅发行说明 ，了解有关版本兼容性的更多信息。
使用Unified CM的Webex VDI
适用于MRA的Webex VDI与Unified CM和Expressways
程序框图中的Expressway用于表示Mobile and Remote Access (MRA)部署。要使MRA与Webex应用程序VDI配合使用，HVD必须能够将请求发送到通常在DMZ中配置的Expressway-E。
带有Webex 的Webex应用程序VDI
使用Webex for BroadWorks的Webex VDI
包含Meetings的Webex应用程序VDI
备用模式
VDI 无法建立虚拟通道时，Webex 应用程序的 VDI 回退模式可为基本音频和视频通话提供短期支持。回退模式支持标准通话和通话录制。但不支持完整的功能集。导致切换到回退模式的服务器或网络问题，会降低通话质量。
Webex应用程序VDI登录流程
Webex应用程序VDI架构由两个主要组件组成：用于VDI的Webex应用程序和用于瘦客户端的Webex VDI插件。VDI插件安装在瘦客户端上，而应用程序安装在HVD上。
当用户启动虚拟经纪客户端（Citrix Workspace应用程序或VMWare Horizon Client）时，供应商的软件会启动虚拟通道。Webex应用程序插件和代理使用此虚拟通道进行通信。
下图显示了通过移动和远程访问(MRA)部署Unified CM呼叫时在正常Webex应用程序使用期间设置的预期协议会话。
虽然图中描述了基于MRA的Webex应用程序VDI，但流程与本地VDI部署相同。但是，与基于MRA的VDI不同，内部部署不会通过DMZ路由流量，并且所有流量都位于LAN上。
-
要开始会话，用户首先启动虚拟代理-客户端（Citrix Workspace App或VMware Horizon Client），连接到连接代理，然后选择HVD或虚拟应用程序。选中后，将在用户的瘦客户端（物理机）和Hypervisor上托管的HVD（虚拟机）之间设置虚拟通道。
-
用户在HVD上启动Webex应用程序后，Webex将确定其是否处于虚拟环境中，以及Unified CM是否用于电话服务。如果启用了Unified CM，Webex应用程序将启动
shvdagent.exe进程并开始内部服务发现。（内部服务发现包括UDS DNS SRV查找、Unified CM验证、主群集查找和配置检索。） -
然后，Webex应用程序客户端和Webex应用程序VDI插件设置用于通过虚拟通道交换数据的所有控制流。设置这些通道后，Webex应用程序客户端将语音服务域信息发送到Webex应用程序VDI插件。
-
接下来，Webex应用程序VDI插件执行服务发现。Webex应用程序VDI插件通过引用从Webex应用程序客户端发送到它的语音服务域信息来做到这一点。在这种情况下，Webex应用程序VDI插件解析_collab DNS SRV记录，因为VDI插件机器正在从外部网络连接，因此需要通过MRA进行连接。服务发现完成后，Webex应用程序VDI插件将Expressway-E FQDN发送到Webex应用程序客户端。
-
在接收和缓存Expressway-E FQDN后，Webex应用程序(HVD)会为Expressway-E FQDN执行DNS记录查找。对于单个NIC部署，此步骤将检索Expressway-E的IP地址（带拆分DNS的内部IP或不带拆分DNS的外部IP），用于通过端口8443进行Edge配置和SSO验证。
如果在双网络接口部署中设置了Expressway-E，两个接口都可以有一个内部IP地址。在该情况下，内部接口与外部接口的配置相反。
-
检索Edge详细信息后，Webex应用程序(HVD)会为UDS和TFTP请求建立与ExpressWAY-E IP的HTTPS连接。通过此过程，Webex应用程序(HVD)验证和检索配置详细信息，例如软电话设备配置、应用程序拨号规则和目录查找拨号规则。
-
Webex VDI插件解析Expressway-E外部IP，然后发送到Webex应用程序(HVD)。通过上一步中检索的设备信息，Webex应用程序通过Expressway-E外部界面开始CSF设备（Windows桌面）注册。
托管虚拟桌面和瘦客户端要求
确保您的VDI环境满足受支持服务器(安装Webex应用程序的托管虚拟桌面(HVD))和瘦客户端（安装Webex VDI插件的用户端设备）的要求。
对于从Webex应用程序加入Webex会议的用户，请参阅 bex Meetings VDI的托管虚拟桌面和瘦客户端要求。
托管的虚拟桌面
|
VDI组件 |
支持的平台 |
|---|---|
| 单会话操作系统-安装在HVD上 |
|
|
多会话操作系统-安装在HVD上 |
|
|
多会话云虚拟化服务 |
|
| 托管虚拟桌面的连接代理 |
连接代理是创建与托管虚拟桌面连接的软件。连接代理执行多项任务，包括：
|
Windows瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 基于 Microsoft Windows 的瘦客户端硬件 |
支持的硬件
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（适用于VDI的Webex应用程序与Windows独立应用程序的要求相同。） 支持的软件 我们支持以下Windows版本的64位架构：
|
| 基于 Windows Embedded Standard 的瘦客户端硬件 |
支持的硬件 已安装 2 GB 的 RAM 可用物理内存 128 MB 可用磁盘空间 256 MB CPU 性能会影响最大视频分辨率。使用 Windows Embedded Standard 瘦客户端时，所需分辨率取决于 CPU：
这些硬件规格仅为所需分辨率提供参考。其他因素也会影响视频分辨率。 与 DirectX 11 兼容的 GPU USB 2.0（用于 USB 摄像头和音频设备） 支持的软件
|
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Linux瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 瘦客户端操作系统 |
Ubuntu（64位）
|
|
Unicon eLux（64位）
|
|
|
HP ThinPro 7.1（生命周期终止） HP ThinPro 8.0，8.1（64位）
|
|
|
IGEL OS
|
|
|
Dell Wyse ThinOS
Dell Wyse ThinOS支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系Dell获取技术支持。有关详细信息，请参阅您受支持版本的 Dell Wyse ThinOS文档 ；其发行说明的“ |
|
|
10ZiG Zero Client瘦客户端 10ZiG0客户端瘦客户端支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系10ZiG以获得技术支持。有关详细信息，请参阅特定瘦客户端的 10ZiG页面 。 |
|
|
Stratodesk NoTouch操作系统 Stratodesk NoTouch操作系统支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系Stratodesk获取技术支持。有关更多信息，请参阅Stratodesk NoTouch OS文档 ，了解您支持的版本。 |
|
| Ubuntu/Thinpro瘦客户端硬件 |
瘦客户端的最低硬件要求如下：
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（适用于VDI的Webex应用程序与Windows独立应用程序的要求相同。） |
| eLux RP 6瘦客户端硬件 |
最低硬件要求 下列系统属性可使用基本eLux RP 6功能启用。
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（适用于VDI的Webex应用程序与Windows独立应用程序的要求相同。） |
| 已测试和推荐的设备 |
*根据硬件要求，不建议将这些设备与虚拟背景配合使用。有关更多信息，请参阅虚拟背景要求 。（适用于VDI的Webex应用程序与Windows独立应用程序的要求相同。） |
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
macOS瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 基于MacOS的瘦客户端硬件 |
支持的硬件
Intel Core 2 Duo or later processors on any of the following Apple hardware:
If you want users to use virtual backgrounds, you must meet the virtual background requirements. (Webex App for VDI has the same requirements as the Windows standalone app.) Supported software The Webex App VDI plugin is supported on the following macOS versions:
|
|
Citrix Workspace app or VMware Horizon client |
|
Webex App and plugin requirements
-
Get the necessary install builds of the Webex App (installed on HVD) and Webex App plugin (installed on a user's thin client machine) from the Downloads tab of the Webex App VDI release notes.
-
While we support backwards compatibility, as outlined in the release notes, we recommend that you use the latest versions of the install builds wherever possible.
-
For users joining Webex meetings from Webex App, please refer to Hosted virtual desktop and thin client requirements for Webex meetings VDI.
-
VDI users typically do not have admin control over their machine and the plugin does not require admin privileges. However, if your users require Outlook integration, you must register the office integration .dll file using the directions in Enable users' status to display in Microsoft Outlook.
Headset Requirements
For Webex App VDI, we support the same headsets as the standalone Webex App unless otherwise noted. See Details about headset support for more information.
Supported realtime media workflows for calling and meetings
Webex App VDI supports the following realtime media workflows:
-
Calls on Webex (built into the app)
-
Unified CM
-
Webex Calling
-
Webex for BroadWorks
-
Webex Meetings
To integrate a supported calling service and Webex Meetings, you must follow configuration steps in the documentation for those solutions. Choose an option and then use the documentation that is linked in that section.
Unified CM requirements
If you want to use Unified CM as your call service for Webex App VDI users, use the Deployment Guide to walk through the required configuration steps. The document contains an overview of the service, prerequisites, and deployment steps.
Move a call to a meeting
To support this feature, make sure you've configured your Unified CM calling deployment correctly.
Additionally, make sure the following VDI configuration is in place so that offloading to meetings is supported:Full-featured meetings requirements.
移动和远程访问 (MRA)
Mobile and Remote Access (MRA) is supported. Follow the standard MRA deployment steps in the Expressway MRA documentation and keep the following points in mind for a supported VDI deployment:
-
See Mobile and Remote Access (MRA) requirements for more guidance for VDI support.
-
You must run a minimum of X12.7 and later.
-
Dual NIC deployments are supported. You must ensure there's a connection from the HVD to both the external and internal IP addresses of the Expressway-E. You must add a NAT between the HVD and the external IP of the Expressway-E.
Webex Calling requirements
If your HVD supports IPv4 and IPv6, we recommend that you disable IPV6 in your HVD environment to prevent compatibility issues with Webex Calling.
Configuration in Control Hub (partners and administrators)
Control Hub ( https://admin.webex.com) is a web-based management portal that integrates withWebex Calling to streamline your orders and configuration, and centralize your management of the bundled offer—Webex Calling, Webex App, and Meetings.
作为合作伙伴服务商，您可以向客户定制、营销和销售 Webex Calling。您可以设置和延长试用，为客户部署服务，以及创建和部署您客户的订单。有关更多合作伙伴资源，请参阅 Webex Calling Sales Connect 资源。(Requires partner credentials).
As a customer administrator on a trial or paid subscription to Webex Calling, you can set up your organization in the Control Hub by adding locations, licenses, phone numbers, calling features, users, and Workspaces (Room Devices that register to the Webex cloud).
Make sure that your environment supports Webex Calling by following the prerequisites and port reference material before you start specific configuration steps in the Control Hub. You can refer to the following configuration work flow diagram and the article links, in the order presented, to get your organization up and running with Webex Calling:
For more information on the Webex Calling offer, see Cisco Webex Calling in the Cisco Collaboration Flex Plan for End Customers Data Sheet.
Webex for BroadWorks requirements
The Webex App in a VDI environment supports Webex for BroadWorks. Webex for BroadWorks 是一种在 Webex 中集成 BroadWorks Calling 的服务。订户使用单个应用程序（Webex应用程序）来利用两个平台提供的功能。
For general information about Webex for BroadWorks, see the Webex for BroadWorks Solution Guide.
Full-featured meetings requirements
Keep these points in mind when deploying Webex App VDI for full-featured meetings:
-
Install the Webex App onto the Hosted Virtual Desktop (HVD).
-
You must install Webex App VDI plugin for users joining full-featured Webex meetings.
Refer to Hosted virtual desktop and thin client requirements for Webex meetings VDI.
-
For Linux thin clients, you must also install the Webex Meetings VDI plugin for Linux (see Install Webex Meetings VDI plugin on thin client systems).
Mobile and Remote Access (MRA) requirements
必要条件
-
You must run a minimum of Expressway X12.7 for the traversal pair for MRA to work with Webex VDI. Earlier versions must be upgraded to X12.7 or later to avoid routing issues.
-
Ensure connectivity between Webex in the HVD environment, external interface, and internal interface (dual NIC deployment) of Expressway.
MRA with Webex App VDI workflow
For information about the MRA with Webex VDI workflow, see Webex App VDI login flow.
Dual NIC considerations
Keep these design considerations in mind when deployment Webex App VDI over MRA with an Expressway-E dual NIC deployment.
-
Static route—Verify the default gateway on the Expressway-E. Typically, this is the default gateway of the external interface IP subnet. Once you verify the Expressway default gateway configuration, you must add a Static Route to the Expressway-E for the IP subnet that is used for the HVD machines.
The static route sends traffic out of the internal interface of the Expressway-E to the HVD subnet. This configuration is needed, because of the UDS and TFTP config queries sent from the HVD to the Expressway E internal interface. Once Unified CM responds to the request, the Expressway-E sends the response through the default gateway if the static route to the HVD subnet does not exist.
-
NAT transition—The SIP traffic from the HVD to the Expressway-E external interface needs to have the source IP changed before reaching the Expressway to avoid a routing issue. NAT addresses this problem. A NAT translation must be put in place on a network device that is the path between the HVD and Expressway-E.
DNS configuration
Internal DNS
-
For dual NIC deployments, you can specify the Expressway-E address using a FQDN that resolves to the IP address of the internal interface. With split DNS, you can optionally use the same FQDN that is available on the public DNS. If you don't use split DNS, you must use a different FQDN.
To avoid a routing issue, the SIP traffic from the HVD to the Expressway-E external interface needs to have the source IP changed before reaching the Expressway. You must set up a NAT translation on a network device that is between the HVD and Expressway-E.
-
For single NIC with static NAT, you must specify the Expressway-E address using a FQDN that resolves to the public IP address. This setup also means that the external firewall must allow traffic from the Webex app in HVD to the external FQDN of the Expressway-E. This design is known as NAT reflection, and may not be supported by all types of firewalls.
-
The internal DNS must be configured with
_cisco-uds._tcp.<domain>SRV records so that the Webex app can discover Unified CM.
Public DNS
SRV records
The public, external DNS must be configured with _collab-edge._tls.<domain> SRV records so that endpoints can discover the Expressway-Es to use for MRA.
GeoDNS
In versions 43.6 and later, you can configure the Webex App to work with GeoDNS. This option improves network efficiency by enabling the App to connect to the geographically nearest Expressway-E.
If you have configured GeoDNS for your SRV records, we recommend that you edit the registry on your HVD as follows:
-
Open the registry to
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native. -
Create a new DWORD key named
VDIGeoDnsEnabled. -
Set
VDIGeoDnsEnabledto1.(Set
VDIGeoDnsEnabledto0(the default) if you want to disable GeoDNS compatibility for the Webex App on this HVD). -
Save the registry.
Firewall configuration
Both the internal and external firewall must allow the following outbound connections from Webex App on the HVD to Expressway-E:
-
SIP—TCP 5061
-
HTTPS—TCP 8443
The external firewall must also allow the following inbound connections from the user thin client to Expressway:
-
Media—UDP 36002–59999
Webex App VDI deployment task flow
These steps walk you through how to deploy the Webex App in your VDI environment. The steps include what you need to do on the hosted virtual desktop (HVD) environment and what users need to do on their thin clients.
准备工作
Prepare your environment for Webex App for VDI
If you want your Webex App VDI users to have access to calling features in your organization, you must use the directions in the Prepare your environment chapter to deploy a call service (Unified CM, Webex Calling, or BroadWorks) before you deploy VDI.
| 1 |
Configure one of the following types of Hosted Virtual Desktop:
To prepare for your users wanting to access the Webex App remotely from thin client devices, set up the Webex App on the centralized hosted virtual desktop (HVD) environment. |
| 2 |
Install the Webex App VDI plugin on thin client machines for the following platforms:
After Webex App is installed on your central HVD environment, you next get your users to install a Webex App VDI plugin on their thin client devices. Thin clients are typically lightweight or repurposed computers that users use to establish a remote connection with a centralized HVD server where Webex App is hosted. The thin client plugins for supported platforms are available from the Webex App VDI release notes. |
| 3 |
(Optional) On Linux thin clients, you must also Install Webex Meetings VDI plugin on thin client systems. For full-featured meetings in Webex App, you must install two separate VDI plugins on Linux thin clients. |
Configure hosted virtual desktop and install Webex App
To prepare for your users wanting to access the Webex App remotely from thin client devices, set up Webex App on the centralized hosted virtual desktop (HVD) environment.
准备工作
-
Follow all the prerequisites in Prepare your environment for Webex App for VDI.
If you want your Webex App VDI users to have access to calling features in your organization, you must deploy a call service (Unified CM, Webex Calling, or BroadWorks) before you deploy VDI.
-
This section only covers how to install the Webex App in an existing HVD environment. See the Citrix or Vmware documentation for HVD deployment best practices.
| 1 |
Sign in to Microsoft Windows HVD as a new user with domain administration rights. |
| 2 |
将 HVD 加入企业域。 |
| 3 |
设置 Citrix 或 VMware 对 HVD 的访问权限。 |
| 4 |
If your organization has its own download site that includes your site-specific Webex App, go to that site and download your organization-specific version. Otherwise, for the generic version, go to Webex App VDI release notes > Downloads and download the Webex App you need:
|
| 5 |
Using administrative permissions, install the app on the HVD using these command and arguments (these examples use a download directory of
See the following table for explanations of the arguments that you can use when installing Webex App in a VDI environment. |
| 6 |
复制 HVD 映像。 For more information about the best practices for cloning Microsoft Windows HVD images, see the documentation for your Citrix or VMware product. |
下一步
For information about user preferences and how to preserve them, see User preferences.
Installation arguments, explanations, and required privileges
See the following table for explanations of the arguments that you can use when installing Webex App in a VDI environment.
| 参数 | 说明 | Requires admin install privileges |
|---|---|---|
ALLUSERS=1 |
Installs Webex App in c:\program files. This is useful in a shared environment (typically non-persistent VDI). This is a mandatory argument for installation. VDI must be installed per HVD. Per user installation is not supported yet. | ✓ |
|
|
A value of Use this option if you prefer to manually maintain upgrades. Use the versions that are linked from the Webex App VDI release notes. The argument does not affect a non-VDI environment. A value of This argument must be accompanied by | ✓ |
|
|
Controls the optimized VDI solution. (Officially supported.)
| ✓ |
|
Only for the bundle installer. When installing the bundled components for Webex App, you can use this argument to lock the version of the app that is used to join meetings, if the version is compatible with the site version. | ✓ |
INSTALLWV2=1 |
Install Microsoft's WebView2 embedded browser while installing Webex App using the For more information on the Webex App and WebView2 requirements, see Webex App | WebView2 requirement. | ✓ |
ROAMINGENABLED=1 |
If this argument is specified, then the roaming database ( This argument must be accompanied by See User preferences for more information. | ✓ |
Installation comparison
Users may be in a Citrix environment and not have the thin client installed or the virtual channel is disconnected. We support this scenario with fallback to a non-virtual Webex App installation. 在此模式下，应用程序会显示警告，提示视频质量可能会受到影响。连接虚拟通道后，应用程序可以更改为 VDI 模式。
Use this table to understand the different installation combinations and how they affect media optimization for Unified CM, Webex Calling, and calls on Webex App.
| HVD VDI argument | Thin client plugin | Call service-enabled User | 在 Webex 应用程序上的呼叫 |
|---|---|---|---|
| ENABLEVDI=0 | Not installed | Media is not optimized | Media is not optimized |
| ENABLEVDI=0 | 已安装 | Media is not optimized | Media is not optimized |
|
ENABLEVDI=1 * ENABLEVDI=2 ** | 已安装 | Supported deployment; media is optimized | Supported deployment; media is optimized |
|
ENABLEVDI=1 * ENABLEVDI=2 ** | Not installed | Fallback to non-optimized media | Fallback to non-optimized media |
* This argument does not detect the VDI environment automatically.
** This argument detects the VDI environment automatically.
User preferences
All user preferences are in the roaming database (spark_roaming_store.db). This database is much smaller than the main db (spark_persistent_store.db).
If you are a non-persistent VDI customer (a VDI environment that is deleted everytime the user logs out), you can quickly back up and restore the folder Appdata\Roaming\CiscoSpark so that VDI users won't lose preferences between sessions.
The roaming database contains all user credentials and preferences, encrypted using AES256. As a VDI customer, you should always back up the above folder, so that user credentials and preferences are maintained across VDI sessions.
To decrypt the roaming database, you should also synchronize the following folders across VDI sessions:
-
AppData\Roaming\Microsoft\Credentials -
AppData\Roaming\Microsoft\Crypto -
AppData\Roaming\Microsoft\Protect -
AppData\Roaming\Microsoft\SystemCertificates
Configure Azure Virtual Desktop for the Webex App
Use these high-level steps to deploy a new Windows environment on Azure Virtual Desktop (formerly Windows Virtual Desktop). AVD is a cloud-managed VDI solution. Users access the Webex App through a virtualized Windows environment.
We do not support full-featured meetings using the Webex App on Azure Virtual Desktop.
准备工作
-
This solution requires a Microsoft Azure subscription.
-
You must have a user account with the TenantCreator role.
-
User accounts must be synchronized into Azure Active Directory.
| 1 |
Walk through the deployment steps in the Azure admin portal to create the host pool, virtual machines, and related settings. A host pool is a collection of VMs that offer a similar service. Azure indicates when the virtual environment is ready. |
| 2 |
Use the Windows client to test if a user can access the host pool. For specific deployment steps, see the Microsoft documentation on getting started with AVD. |
Install the Webex App VDI plugin on Windows thin client systems
After you install Webex App on your central HVD environment, you must install a Webex App VDI plugin on the thin client devices.
Download the thin client plugins from the Webex App VDI release notes.
If you're unable to install the VDI plugin for your users, walk them through these steps on their thin client devices.
准备工作
-
See Windows thin clients for a list of supported platforms for the Webex App VDI Plugin for Windows.
-
Webex App needs to be installed on your central HVD environment.
| 1 |
Go to Webex App VDI release notes > Downloads, and download the Webex App VDI plugin installer for Windows. |
| 2 |
Run the |
| 3 |
To open the executable file, click OK. |
| 4 |
Read the EULA and, if you agree, click Accept and Install. |
| 5 |
To complete the installation, click Finish. |
| 6 |
(Optional) If you or users are manually installing the two plugins for full featured meetings, follow the steps in Install Meetings VDI plugin on thin client systems. |
下一步
For Webex App to function properly for your users, you must use the official thin client plugin. To confirm, the Health Check shows a connected status for the Virtual Channel.
Install the Webex App VDI plugin on Linux thin client systems
After Webex App is installed on your central HVD environment, you next get your users to install a Webex App VDI plugin on their thin client devices. Thin clients are typically lightweight or repurposed computers that users use to establish a remote connection with a centralized HVD server where Webex App is hosted. The thin client plugins for supported platforms are linked from the Webex App VDI release notes.
准备工作
See Linux thin clients for a list of supported platforms for the Webex App VDI Plugin for Linux.
For Webex App to function properly for your users and be optimized for VDI, you must use the thin client build. To confirm, the Health Check in Webex App shows a connected status for the Virtual Channel.
Install the Webex App VDI plugin on macOS thin client systems
After Webex App is installed on your central HVD environment, you next get your users to install a Webex App VDI plugin on their thin client devices. Thin clients are typically lightweight or repurposed computers that users use to establish a remote connection with a centralized HVD server where Webex App is hosted. The thin client plugins for supported platforms are linked from the Webex App VDI release notes.
Run the MacOS installer (PKG) to install the Webex VDI plugin.
准备工作
See macOS thin clients for a list of supported platforms for the Webex App VDI plugin for macOS.
| 1 |
Download the Webex App plugin for your macOS thin client systems from Webex App VDI release notes > Downloads. |
| 2 |
Run the |
| 3 |
Read the EULA and, if you agree, click Continue. |
| 4 |
Click Install, and if a prompt appears that Citrix Workspace client or VMware Horizon client must be closed first, click Close Application and Install. You can also click Install Later if you cannot close Citrix or VMware at the time. |
| 5 |
Click through the remaining screens to complete the installation. |
下一步
When users launch the Webex App VDI plugin for the first time, accept the following required permissions:
| 许可 | 描述 |
|---|---|
| Access Camera | Uses the camera in a video call, or trying to open the camera in Settings. |
| Access Microphone | Uses the microphone for voice in a call. |
| Record Screen | Uses the camera in a video call, or trying to open the camera in Settings. |
For Webex App to function properly for your users, you must use the official thin client plugin from the download site. To confirm, the Health Check shows a connected status for the Virtual Channel.
Install Webex Meetings VDI plugin on thin client systems
For full featured meetings with Webex App:
-
On Windows or MacOS thin clients, install the bundled (App + Meetings) plugin.
-
On Linux thin clients, install the separate Meetings VDI plugin after installing the separate App VDI plugin.
准备工作
-
Install only the Webex App in the HVD environment. No other apps are required.
-
Make sure you follow the Full-featured meetings requirements.
Known issues and limitations with Webex App for VDI
功能
For feature limitations for each release, see the Webex App VDI release notes.
Webex App and VDI client
-
For VDI mode, we only support the provided Webex App for Windows (HVD installer) and Webex App thin-client plugin versions that are posted on Webex App VDI release notes.
-
We only support IPv4 for the HVD and thin client environments.
-
When users either don't use the VDI optimized solution or are in fall back mode, HD video is disabled and Webex App shows a notification that you may see a media quality issue.
We do not recommend that users use VDI in unoptimized or fallback mode. Their camera or headset may not work and they may experience poor media quality.
-
On the MacOS VDI client, a video feed spills into the MacOS system bar or Application menu when the HVD connection is full screen.
-
On Linux VDI clients, an incoming call does not ring all devices (including speakers on the thin client) even if that option is selected in Webex App on the HVD host. Only the audio device selected on the HVD plays the ringtone.
Unified CM 呼叫
-
For on-premises calling only with Expressways: if there is is no NAT between the HVD and Expressway-E in a traversal pair used for MRA, Expressway treats the SIP and media signaling as internal and does not transmit the media to the thin client. To fix this, deploy a NAT between the HVD and the Expressways. That way, when HVD sends a SIP INVITE to the Expressway-E, it goes to the NAT first. Then, Expressway-E can transmit to the thin client.
-
For fallback mode, the Mode Selection registry key cannot control the media for an auto-answered Unified CM call.
Citrix
-
The multitasking feature does not work with the Webex App on VDI.
-
In non-optimization mode or fall back mode, Citrix device mapping supports a maximum of 4 devices.
-
On Citrix for Linux, we only support voicemail playback by using the default device on the thin client. So when you want to play back voicemail using your preferred audio device, you need to open the sound settings on the thin client to set the device that you want to use by default.
-
You must install Citrix Receiver/Workspace before you install the Webex App VDI client, including when you update the Receiver/Workspace environment. If either a Citrix or VMWare client are not installed, the Webex App VDI client shows an error and the installation ends.
-
For Windows, if you're running a version of Citrix Workspace that is earlier than 2002, you must reinstall (uninstall and then install again or repair) the Webex App VDI client after you uninstall and reinstall the Citrix Receiver/Workspace. If you run version 2002 or later, you don't have to uninstall and reinstall.
For all supported versions of Citrix Workspace for Linux, you must reinstall (uninstall and then install again or repair) the Webex App VDI client after you uninstall and reinstall the Citrix Receiver/Workspace.
-
Citrix Receiver/Workspace uses 32-bit architecture. Webex App VDI works with this environment.
Azure Virtual Desktop (Formerly Windows Virtual Desktop)
-
On Azure Virtual Desktop (AVD) for on-premises Unified CM calling, we currently only support the thin client working under MRA. Webex App in a WVD desktop (a cloud based remote desktop) works on MRA. If the thin client is on-premises, Unified CM calling may be blocked by some firewall settings. Webex Calling and Webex App built-in calling are not affected.
-
AVD doesn't support "Fit session to Window" in the AVD client setup.
-
For AVD deployments, you must enable the UDP connections between the internal network and the Expressway-E—port ranges from 16384–32767.
VMware
-
You must install VMware Horizon client before you install the Webex App VDI client. If either a Citrix or VMware client are not installed, the Webex App VDI client shows an error and the installation ends.
-
VMware Horizon client version 8.x (2103) is supported from the Webex VDI plugin version 41.4 onward.
For compatibility mode: If users have the previous VDI plugin version (including only upgrading the Webex app to 41.4), video in a call may not appear correctly.
-
We do not support VMWare Horizon client on 32-bit architecture, because we discontinued the 32-bit plugin for Windows.
The Webex App VDI client must have the same architecture as VMware Horizon client: the 64-bit VMware Horizon client works with the (64-bit) Webex App VDI client. The VMware Horizon client only has one installer and the default installation is 64-bit.
If
vdpService.dllexists inC:\Program Files (x86)\VMware\VMware Horizon View Client\x64, you have the 64-bit VMware Horizon client.If
vdpService.dllis underC:\Program Files (x86)\VMware\VMware Horizon View Client\, you have the 32-bit VMware Horizon client. -
On VMware for Linux and Windows, we only support voicemail playback by using the default device on the thin client. So when you want to play back voicemail using your preferred audio device, you need to open the sound settings on the thin client to set the device that you want to use by default.
-
On VMware Cloud desktop for on-premises Unified CM calling, we currently only support the thin client working under MRA. Webex App in a VMware Cloud desktop (a cloud based remote desktop) works on MRA. If the thin client is on-premises, Unified CM calling may be blocked by some firewall settings. Webex Calling and Webex App built-in calling are not affected.
-
For VMware Cloud desktop deployments, you must enable the UDP connections between the internal network and the Expressway-E—port ranges from 16384–32767.
-
After you check check the camera or audio device in Connect USB Device on the VMware Horizon Client, Webex in HVD cannot detect or show those devices.
Amazon WorkSpaces
- On the hosted virtual desktop, please follow instructions here to enable extensions for WSP by GPO.
- In case "No VDI environment is detected" was reported in Health Checker of Webex App after new installing manually by command line, please try to sign out/sign in hosted Windows desktop first.
其他
-
In Citrix and Windows Virtual Desktop vGPU environments, Webex App is not detected as working in a VDI environment.
We recommend you install the Webex App with the
ENABLEVDI=1argument, to enforce VDI optimization. -
We support one Webex App VDI client working together with one instance of Webex App. Users can start multiple Citrix or VMware sessions, but only one connection instance works and the other instances fall back to non-VDI mode.
-
Webex App VDI detects Citrix at first and then VMware in the HVD environment. If you want to use VMware, make sure no Citrix Agent is installed.
Upgrade management
Webex App upgrades on the virtual desktop
For VDI environments, a new release of the Webex App comes out every two months. You can get the latest and supported versions from Webex App VDI release notes > Downloads.
We recommend that you enable automatic upgrades for the Webex App on the virtual desktop. This option ensures that users automatically get the latest features. Another option is to manually upgrade when the new release is available.
You have two options to enable automatic upgrade of the Webex App on the virtual desktop:
-
Enable it during initial installation from the command line (see Configure hosted virtual desktop for Webex App in the deployment chapter of this book).
-
Edit a Windows registry key on the virtual desktop:
In the registry entry for
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native, setAutoUpgradeEnabled=1.If you want to manually upgrade the Webex App, set
AutoUpgradeEnabled=0.
-
VDI users of Webex App do not receive monthly updates, because monthly thick client releases are not pushed to hosted virtual desktops.
VDI users are prompted to upgrade when the virtual desktop version of Webex App becomes available (released once every two months).
-
The upgrade package is stored in
%appdata%\Local\CiscoSparkLauncher. If this folder is non-persistent in user's environment, Webex App rolls back to the previous version after rebooting the virtual desktop. -
The Webex App on your HVD is backwards compatible with the Webex App VDI plugins (N-4) on your users' thin clients. Keep in mind that the latest features and functionality may not work if you or your users are not using the latest HVD version and VDI plugin. See Version Support in the Release Notes for more information.
Thin client upgrades
The Webex App VDI plugin is released once every two months.
We recommend that you enable automatic upgrades for the plugins. To enable automatic upgrades for the VDI plugin, you must edit a Windows registry key on the virtual desktop:
-
In the registry entry for
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Spark Native, setAutoUpgradeVDIPluginEnabled=1. -
In the same path, check that
AutoUpgradeEnabled=1.
If you want to prevent automatic upgrade of the plugin, set AutoUpgradeVDIPluginEnabled=0 on the virtual desktop. If you choose this option, you must manually upgrade the plugins to maintain version compatibility with the app.
-
Automatic upgrade of the plugins is only available with Webex App 42.2 and later.
-
Automatic upgrade of the plugin is supported on Windows and MacOS thin clients. The plugin does not automatically upgrade on Linux thin clients.
-
Users are prompted to upgrade the plugin after the Webex App has upgraded on the virtual desktop.
-
We recommend that you keep the plugin and the virtual desktop Webex App on the latest version. There is some backwards compatibility if you can't upgrade them together. See
Version support
in the Release notes for more information.
Citrix or VMware upgrades
Keep this information in mind as you manage upgrades or changes to your Citrix or VMware connection brokers. Be sure to use the supported versions that are listed in the Prepare Your Environment chapter.
Citrix
|
Install or upgrade |
Windows and Mac thin clients |
Linux thin clients |
|---|---|---|
|
New install |
Install Citrix Receiver or Workspace before you install the Webex App VDI plugin on a Windows or Mac thin client. You and your users see a warning in the VDI plugin installation steps that reminds you to install the connection broker first. |
Install Citrix Receiver or Workspace before you install the Webex App VDI plugin on a Linux thin client. You and your users see a warning in the VDI plugin installation steps that reminds you to install the connection broker first. |
|
升级 |
If you see an upgrade notice in the Citrix environment, performing this upgrade does not affect the Webex App VDI plugin on a Windows or Mac thin client. |
If you see an upgrade notice in the Citrix environment, you must reinstall the Webex App VDI plugin on a Linux thin client after upgrading your Citrix environment. |
|
Reinstall |
|
For reinstallation of any supported Citrix Workspace version, you must reinstall the Webex App VDI plugin on a Linux thin client. |
VMware
|
Install or upgrade |
Windows thin client |
Linux and Mac thin clients |
|---|---|---|
|
New install |
Install the VMware Horizon client before you install the Webex App VDI plugin on a Windows thin client. You and your users see a warning in the VDI plugin installation steps that reminds you to install the connector broker first. |
Install the VMware Horizon client before you install the Webex App VDI plugin on a Linux or Mac thin client. You and your users see a warning in the VDI plugin installation steps that reminds you to install the connector broker first. |
|
升级 | If you see an upgrade notice in the VMware environment, performing this upgrade does not affect the Webex App VDI plugin on a Windows thin client. |
If you see an upgrade notice in the VMware environment, you must reinstall the Webex App VDI plugin on a Linux or Mac thin client after upgrading your Citrix environment. |
|
Reinstall |
For a VMware reinstallation, the Windows VDI plugin works and is not affected. |
For a VMware reinstallation, you must reinstall the Webex App plugin on a Linux or Mac thin client. |
Disable VDI detection after installation
If you have users that don't want to use the VDI client and Webex App is already deployed, you can disable VDI detection after installation. After this configuration, Webex App runs on the non-optimized solution.
| 1 |
Open one of the following installation paths, depending on how you deployed Webex App in your HVD:
|
| 2 |
Rename |
下一步
If you uninstall Webex App later, the TSDetectionLib_b.dll remains in the folder. You must either rename the file back to TSDetectionLib.dll before you uninstall Webex App or delete the TSDetectionLib_b.dll manually after you uninstall Webex App.
Enable or disable advanced video features in Webex App VDI fallback mode
By modifying the registry, you can enable or disable specific Webex App features such as high definition (HD) and screen sharing. Doing so can save resources on the server in the data center. You can also decide whether users can do full or HVD window only screen share. If your users are on systems that are capable of more advanced video features, you can enable the features as needed.
准备工作
-
You can modify the registry keys before or after the VDI plugin is installed.
Changes to the Windows registry should be done with extreme caution. We recommend that you make a backup of your registry before using these steps.
-
Virtual backgrounds are disabled by default.
-
To enable them, follow the steps in Configure Virtual Backgrounds for Webex Users.
-
Make sure your users' thin client devices meet the system requirements for virtual backgrounds.
-
| 1 |
In Windows search or the Run window, type regedit and then press Enter |
| 2 |
Go to HKEY_LOCAL_MACHINE\Software\Cisco Spark Native\. |
| 3 |
Change values for the following registry keys as needed: |
| 4 |
Choose a DWORD value for VDIFallBackConf:
This registry key only works when |
| 5 |
Choose a DWORD value for VDIBackgroundEnabled:
|
| 6 |
Choose a DWORD value for VDIScreenShareEnabled:
|
Configure VDI plugin notification
By default, users are notified if their Citrix or VMware client is connecting to an HVD without the VDI plugin. A notice appears to let them know to install the VDI plugin so that optimized VDI mode is enabled. Users can dismiss the reminder if they want.
Also, if the version of Webex App VDI plugin is not compatible with Webex App on HVD, a popup notifies users to upgrade the Webex App VDI plugin. The reminder appears weekly until users take action. Users can also dismiss this notification.
As an administrator, you can enable or disable these notifications at the organization-wide level.
准备工作
You can modify the registry keys before or after the VDI plugin is installed.
Changes to the Windows registry should be done with extreme caution. We recommend that you make a backup of your registry before using these steps.
| 1 |
In Windows search or the Run window, type regedit and then press Enter |
| 2 |
Go to HKEY_LOCAL_MACHINE\Software\Cisco Spark Native\. |
| 3 |
Choose a DWORD (32-bit) reg key value for VDIPluginNotificationEnabled:
|
Disable VDI version compatibility check
By default, Webex App on the HVD checks for version compatibility with the Webex VDI plugin on the thin client. The plugin version should not be more than 4 bi-monthly releases behind the Webex App. For example, if Webex App on the HVD is version 43.8 (August 2023), then the following plugin versions are compatible:
-
43.8 (N) August 2023
-
43.6 (N-1) June 2023
-
43.4 (N-2) April 2023
-
43.2 (N-3) February 2023
-
42.12 (N-4) December 2022
This compatibility gives you up to 6 months to upgrade your thin client plugins, after you upgrade your hosted virtual desktops.
If the Webex VDI plugin is not compatible with Webex App on the HVD, then the Webex App goes into fall-back mode. Users see a popup notification to upgrade the plugin. The reminder appears weekly until users take action.
You can use the registry on the HVD to control the version compatibility check:
We recommend that you back up your registry before using these steps.
-
In the Windows Run window, type
regeditand then press Enter. -
Go to
HKEY_LOCAL_MACHINE\Software\Cisco Spark Native\. -
Create a DWORD (32-bit) registry key named
VDIDisableCompatibilityVersionCheckand give it one of these values:0—Enables the version compatibility check (default).1—Disables the version compatibility check.
Ringers and alerts setting not working for all devices
On Linux VDI clients, the ringtone for an incoming call does not ring all devices (including speakers on the thin client) even if that option is selected in Webex App on the HVD host. Only the audio device selected on the HVD plays the ringtone.
This issue may arise because of the audio device mapping on Citrix or VMware.
Check the registry key VDIDisablePlaytoneOnLinuxTCEnabled on your HVD environment. If a Linux thin client user is observing this ringback tone issue, set the value of this key to 1.
Webex 应用程序中的诊断
The diagnostics available in the Webex App (desktop and VDI) help you and your users resolve connection issues, check media quality, and collect important troubleshooting information.
When you set up Calling in Webex App (Unified CM), you may encounter issues related to the connection or required settings (such as voice domain and UC services). Using this tool, you can diagnose what services are configured correctly and what is missing. This feature is useful for troubleshooting scenarios and reducing support cases, whether you're migrating to Calling in Webex App (Unified CM) or setting up new users.
When user experience issues, they can access the diagnostics view and export the data to share with you or support.
-
Unified CM Settings—Critical settings (for Jabber migration as well as new user setup) for phone services to work correctly, such as:
-
Unified CM 版本
-
UC service domain
-
SSO
-
UC services such as voicemail
-
Expressway for MRA
-
-
Media quality—Quality for video, audio, and sharing in both directions
-
Devices—Device information, when users are connected to devices
For shortcut keys to show the diagnostics window, see Keyboard and navigation shortcuts.
Browser content redirection
Browser content redirection (BCR) is an optimization of the VDI environment that reduces the load on the virtual desktop machine.
When BCR is enabled on the virtual desktop, the Webex App cannot share the browser content by remote screen share, application share, or screen portion share.
Webex users can use local screen sharing to share their browser.
新信息和更改信息
新信息和更改信息
此表涵盖与新功能相关的内容更新、现有内容的更改，以及在适用于虚拟桌面基础结构(VDI)的Webex应用程序部署指南中修复的任何重大错误。
有关Webex应用程序VDI更新、新功能、新增的VDI支持和限制的更多信息，请参阅 VDI发行说明。
|
日期 |
已做更改 |
|---|---|
|
2023年11月13日 |
准备您的环境：
|
|
2023年8月23日 |
整个文档：
准备您的环境：
用于VDI的Webex应用程序：
用于VDI的Webex应用程序并对其进行故障排除：
|
|
2023年5月18日 |
在功能齐全的会议要求中澄清了有关Azure虚拟桌面的注释。AVD不支持功能齐全的会议。 |
|
2023 年 4 月 17 日 |
VDI的Webex应用程序 有关禁用VDI版本兼容性检查的新内容。 在托管虚拟桌面和瘦客户端要求中更新了43.4（2023年4月）发行版支持的基础结构和操作系统版本。 |
|
2023年3月15日 |
|
|
2023年3月3日 |
|
|
2023年2月27日 |
添加了在VDI会话之间同步一些 |
|
2023年1月11日 |
在托管虚拟桌面和瘦客户端要求中添加了最新测试的基础设施和瘦客户端操作系统版本以及支持的硬件。包括Apple M2芯片、macOS Ventura、HP ThinPro 8和Dell ThinOS 9.3。 |
|
2022年10月26日 |
更新了“ |
|
2022年8月25日 |
更新了Webex应用程序VDI 42.8版：
更新了 |
|
2022年5月30日 |
|
|
2022 年 4 月 26 日 |
|
|
2022 年 4 月 25 日 |
|
|
2022 年 4 月 13 日 |
|
|
2022年2月9日 |
|
|
2022 年 2 月 3 日 |
|
|
2021年12月15日 |
|
|
2021 年 11 月 12 日 |
|
|
2021年10月29日 |
|
|
2021年10月8日 |
|
|
2021 年 8 月 10 日 |
|
|
2021年7月6日 |
|
|
2021年6月3日 |
6月(41.6)发行版的更新，包括以下内容：
其他常规更新：
|
|
2021年5月3日 |
|
|
2021 年 4 月 16 日 |
|
|
2021年4月9日 |
|
|
2021年1月18日 |
|
|
2020 年 12 月 11 日 |
|
|
2020 年 9 月 29 日 |
|
|
2020年7月16日 |
|
|
2020年6月29日 |
|
概述
VDI版Webex应用程序概述
未优化的情况下，Webex 应用程序消息传递功能会在虚拟桌面基础结构 (VDI) 环境中按原样运行。不过，完整的 Webex 应用程序体验还包括呼叫和会议，而这些功能需要视频和音频媒体处理。
受发夹效应的限制，在未进行优化的情况下，呼叫、会议及相应的视频功能将不受支持。由于媒体是从一个用户流向数据中心后才能流向下一用户，呼叫和视频所需的额外带宽会给数据中心造成瓶颈。在未优化的媒体路径和访问外围设备（如扬声器、麦克风和摄像头等）困难等因素的共同影响下，用户体验难免差强人意。
为了解决“发夹效应”，Webex 应用程序 VDI 插件在虚拟部署中如法炮制 Cisco 的协作体验，以便用户能够使用 Webex 应用程序提供的完整的消息传递、会议和呼叫功能。
为减少延迟并提高媒体质量，VDI 插件通过在瘦客户端终端上的用户之间采取直接流式传输媒体来优化媒体工作流，并利用瘦客户端计算机的硬件进行媒体处理。此媒体路径不经过托管的虚拟桌面 （HVD）。其结果就是，您的 VDI 用户能够获得稳定且功能齐全的呼叫和会议体验。
在该体系结构中，Webex 应用程序安装在 VDI 环境的 HVD 上，所需的 VDI 插件则安装在用户的瘦客户端（通常为轻量系统，如改装过的笔记本电脑或台式电脑）上。
使用受支持的基于Linux、Mac或Windows的瘦客户端，用户可从远程虚拟桌面环境访问HVD上的Webex应用程序。借助受支持的Webex应用程序版本，用户可以在瘦客户端上使用所有内置消息传递、会议和呼叫功能。此外，您可以将 Webex 应用程序 VDI 与 Unified CM 或 Webex Calling 环境集成，以便用户能够使用受支持的呼叫功能。
-
虚拟桌面上的Webex应用程序仍在处理轻量级数据，例如呼叫信令和从云端检索配置。
-
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex应用程序VDI插件一起安装。
有关每个发行版的新功能，请参阅发行说明 了解更多信息。
VDI环境概述
VDI组件
在优化的虚拟环境中使用Webex应用程序需要以下组件。
-
连接代理—将虚拟化提供程序连接到瘦客户端的资源和连接管理器(Citrix、VMware)。
-
托管虚拟桌面(HVD)—远程运行Webex应用程序的虚拟机(VM)。
-
瘦客户端—用户用于远程登录到虚拟桌面的终端（例如，低调或重用的台式电脑或笔记本电脑）。连接代理和VDI插件安装在瘦客户端设备上，因此可以访问HVD环境。
-
插件-安装在瘦客户端上的软件，用于将媒体处理分担到用户设备，而不是HVD资源。支持的Webex应用程序VDI插件版本从Webex应用程序 DI发行说明的“下载”标签页链接。
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex VDI插件一起安装。
-
bex应用程序—在HVD上安装并运行的应用程序。HVD安装程序受支持的版本位于Webex应用程序 DI发行说明的“下载”标签页。
环境类型
-
模式—在永久环境中，用户注销后将保留用户的本地操作系统更改。
所有用户首选项都在漫游数据库(
spark_roaming_store。db)中。此数据库比主db (spark_persistent_store。db)小得多。 -
持久模式—在非持久环境中，用户注销后不保留用户的本地操作系统更改。用户会话期间缓存适用的用户特定信息（用户数据、配置文件和设置）。
如果您是非持久VDI客户（每次用户注销时都会删除这种VDI环境），您可以快速备份和恢复
spark_roaming_store。db，以便VDI用户不会在会话之间失去首选项。漫游数据库包含所有用户凭证和首选项，使用AES256加密。作为VDI客户，您应始终备份漫游数据库，以便在整个VDI会话中维护用户凭证和首选项。
体系结构
架构图显示了具有现有支持呼叫服务部署的典型Webex应用程序VDI部署中涉及的组件、信令和优化媒体流：Unified CM、Webex 或BroadWorks。
每个程序框图的左侧是包含虚拟环境的公司网络。这种虚拟环境通过在虚拟数据中心运行应用程序、操作系统和用户数据来减轻用户端硬件的负载。借助该框架，您可以从中央位置管理环境，用户可以从受支持的瘦客户端远程访问该环境。
公司网络中的组件包括托管虚拟桌面(HVD)、您管理的安装和运行Webex应用程序的中央环境，以及与用户瘦客户端终端的虚拟通道连接（通过Cisco HVDAgent）。
用户在瘦客户端上安装Webex VDI插件并登录到连接代理（Citrix或VMware），这是一款创建与HVD连接的软件。连接代理执行许多任务，包括：
-
验证用户名并为用户提供连接。
-
允许用户连接到特定虚拟桌面。
登录后，瘦客户端端点通过显示器、键盘、鼠标、USB设备等外围设备模拟与应用程序和操作系统的交互，就像软件安装在瘦客户端上一样。用户在此端点上使用瘦客户端应用程序访问远程服务器上的Webex应用程序。
该架构优化了信令和媒体的方向。它通过HTTPS、WSS和SIP与Webex云或BroadWorks云（右侧）进行信令通信。会议（Webex应用程序）和呼叫（Unified CM、Webex 或BroadWorks）的独立媒体流通过SRTP建立。
您必须在HVD上更新Webex应用程序。新版本每两个月发布一次，与之前的瘦客户端VDI插件向后兼容。新的瘦客户端VDI插件构建版本也每两个月提供一次。下载该软件 并参阅发行说明 ，了解有关版本兼容性的更多信息。
使用Unified CM的Webex VDI
适用于MRA的Webex VDI与Unified CM和Expressways
程序框图中的Expressway用于表示Mobile and Remote Access (MRA)部署。要使MRA与WeBEX应用程序VDI配合使用，HVD必须能够将请求发送到通常在DMZ中配置的Expressway-E。
带有Webex 的Webex应用程序VDI
使用Webex for BroadWorks的Webex VDI
包含Meetings的Webex应用程序VDI
备用模式
VDI 无法建立虚拟通道时，Webex 应用程序的 VDI 回退模式可为基本音频和视频通话提供短期支持。回退模式支持标准通话和通话录制。但不支持完整的功能集。导致切换到回退模式的服务器或网络问题，会降低通话质量。
准备您的环境
Webex应用程序VDI登录流程
Webex应用程序VDI架构由两个主要组件组成：用于VDI的Webex应用程序和用于瘦客户端的Webex VDI插件。VDI插件安装在瘦客户端上，而应用程序安装在HVD上。
当用户启动虚拟经纪客户端（Citrix Workspace应用程序或VMWare Horizon Client）时，供应商的软件会启动虚拟通道。Webex应用程序插件和代理使用此虚拟通道进行通信。
下图显示了通过移动和远程访问(MRA)部署Unified CM呼叫时在正常Webex应用程序使用期间设置的预期协议会话。
虽然图中描述了基于MRA的Webex应用程序VDI，但流程与本地VDI部署相同。但是，与基于MRA的VDI不同，内部部署不会通过DMZ路由流量，并且所有流量都位于LAN上。
-
要开始会话，用户首先启动虚拟代理-客户端（Citrix Workspace App或VMware Horizon Client），连接到连接代理，然后选择HVD或虚拟应用程序。选中后，将在用户的瘦客户端（物理机）和Hypervisor上托管的HVD（虚拟机）之间设置虚拟通道。
-
用户在HVD上启动Webex应用程序后，Webex将确定其是否处于虚拟环境中，以及Unified CM是否用于电话服务。如果启用了Unified CM，Webex应用程序将启动
shvdagent.exe进程并开始内部服务发现。（内部服务发现包括UDS DNS SRV查找、Unified CM验证、主群集查找和配置检索。） -
然后，Webex应用程序客户端和Webex应用程序VDI插件设置用于通过虚拟通道交换数据的所有控制流。设置这些通道后，Webex应用程序客户端将语音服务域信息发送到Webex应用程序VDI插件。
-
接下来，Webex应用程序VDI插件执行服务发现。Webex应用程序VDI插件通过引用从Webex应用程序客户端发送到它的语音服务域信息来做到这一点。在这种情况下，Webex应用程序VDI插件解析_collab DNS SRV记录，因为VDI插件机器正在从外部网络连接，因此需要通过MRA进行连接。服务发现完成后，Webex应用程序VDI插件将Expressway-E FQDN发送到Webex应用程序客户端。
-
在接收和缓存Expressway-E FQDN后，Webex应用程序(HVD)会为Expressway-E FQDN执行DNS记录查找。对于单个NIC部署，此步骤将检索Expressway-E的IP地址（带拆分DNS的内部IP或不带拆分DNS的外部IP），用于通过端口8443进行Edge配置和SSO验证。
如果在双网络接口部署中设置了Expressway-E，两个接口都可以有一个内部IP地址。在该情况下，内部接口与外部接口的配置相反。
-
检索Edge详细信息后，Webex应用程序(HVD)会为UDS和TFTP请求建立与ExpressWAY-E IP的HTTPS连接。通过此过程，Webex应用程序(HVD)验证和检索配置详细信息，例如软电话设备配置、应用程序拨号规则和目录查找拨号规则。
-
Webex VDI插件解析Expressway-E外部IP，然后发送到Webex应用程序(HVD)。通过上一步中检索的设备信息，Webex应用程序通过Expressway-E外部界面开始CSF设备（Windows桌面）注册。
托管虚拟桌面和瘦客户端要求
确保您的VDI环境满足受支持服务器(安装Webex应用程序的托管虚拟桌面(HVD))和瘦客户端（安装Webex VDI插件的用户端设备）的要求。
对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。
托管的虚拟桌面
|
VDI组件 |
支持的平台 |
|---|---|
| 单会话操作系统-安装在HVD上 |
|
|
多会话操作系统-安装在HVD上 |
|
|
多会话云虚拟化服务 |
|
| 托管虚拟桌面的连接代理 |
连接代理是创建与托管虚拟桌面连接的软件。连接代理执行许多任务，包括：
|
Windows瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 基于 Microsoft Windows 的瘦客户端硬件 |
支持的硬件
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） 支持的软件 我们支持以下Windows版本的64位架构：
|
| 基于 Windows Embedded Standard 的瘦客户端硬件 |
支持的硬件 已安装 2 GB 的 RAM 可用物理内存 128 MB 可用磁盘空间 256 MB CPU 性能会影响最大视频分辨率。使用 Windows Embedded Standard 瘦客户端时，所需分辨率取决于 CPU：
这些硬件规格仅为所需分辨率提供参考。其他因素也会影响视频分辨率。 与 DirectX 11 兼容的 GPU USB 2.0（用于 USB 摄像头和音频设备） 支持的软件
|
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Linux瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 瘦客户端操作系统 |
Ubuntu（64位）
|
|
Unicon eLux（64位）
|
|
|
HP ThinPro 7.1（生命周期终止） HP ThinPro 8.0、8.1（64位）
|
|
|
IGEL OS
|
|
|
Dell Wyse ThinOS
Dell Wyse ThinOS支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系Dell以获取技术支持。有关详细信息，请参阅您受支持版本的 Dell Wyse ThinOS文档 ；其发行说明的“ |
|
|
10ZiG Zero Client瘦客户端 10ZiG0客户端瘦客户端支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系10ZiG以获得技术支持。有关详细信息，请参阅特定瘦客户端的 10ZiG页面 。 |
|
|
Stratodesk NoTouch操作系统 Stratodesk NoTouch操作系统支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系Stratodesk获取技术支持。有关更多信息，请参阅Stratodesk NoTouch OS文档 ，了解您支持的版本。 |
|
| Ubuntu/Thinpro瘦客户端硬件 |
瘦客户端的最低硬件要求如下：
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
| eLux RP 6瘦客户端硬件 |
最低硬件要求 下列系统属性可使用基本eLux RP 6功能启用。
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
| 已测试和推荐的设备 |
*根据硬件要求，不建议将这些设备与虚拟背景配合使用。有关更多信息，请参阅虚拟背景要求 。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
macOS瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 基于MacOS的瘦客户端硬件 |
支持的硬件
在以下任何Apple硬件上安装Intel Core 2 Duo或更高版本的处理器：
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） 支持的软件 以下macOS版本支持Webex应用程序VDI插件：
|
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Webex应用程序和插件要求
-
从Webex应用程序VDI发行说明的“下载”标签页 Webex应用程序（安装在HVD ）和Webex应用程序插件（安装在用户瘦客户端计算机上）。
-
虽然我们支持发行说明中所述的向后兼容性，但我们建议您尽可能使用最新版本的安装程序。
-
对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。
-
VDI用户通常对其计算机没有管理员控制权，插件也不需要管理员权限。但是，如果您的用户需要与Outlook集成，则必须使用在Microsoft Outlook中显示用户状态中的指示注册办公室集成。dll文件。
耳机要求
对于Webex应用程序VDI，除非另有说明，否则我们支持与独立版Webex应用程序相同的头戴式耳机。有关更多信息，请参阅有关头戴式耳机支持的详细信息 。
支持用于呼叫和会议的实时媒体工作流程
Webex应用程序VDI支持以下实时媒体工作流：
-
Webex上的呼叫（内置在应用程序中）
-
Unified CM
-
Webex Calling
-
Webex for BroadWorks
-
Webex Meetings
要集成受支持的呼叫服务和Webex Meetings，您必须遵循这些解决方案文档中的配置步骤。选择一个选项，然后使用该部分中链接的文档。
Unified CM要求
如果要将Unified CM用作Webex应用程序VDI用户的呼叫服务，请使用部署指南 完成所需的配置步骤。文档包含服务、前提条件和部署步骤的概述。
将呼叫转入会议
要支持此功能，请确保已 正确配置Unified CM呼叫部署。
此外，请确保以下VDI配置到位，以便支持将负载转移到会议：功能齐全的会议要求。
移动和远程访问 (MRA)
支持Mobile and Remote Access (MRA)。按照 way MRA文档 中的标准MRA部署步骤，并在支持的VDI部署中牢记以下几点：
-
有关VDI支持的更多指导，请参阅移动和远程访问(MRA)要求 。
-
必须至少运行X12。7和更高版本。
-
支持双NIC部署。您必须确保从HVD连接到Expressway-E的外部和内部IP地址。您必须在HVD和ExpressWAY-E的外部IP之间添加NAT。
Webex 要求
如果您的HVD支持IPv4和IPv6，我们建议您在HVD环境中禁用IPV6，以防止Webex 出现兼容性问题。
Control Hub中的配置（合作伙伴和管理员）
Control Hub (https://admin.webex.com)是一个与Webex 集成的基于Web的管理门户，可简化您的订单和配置，并集中管理捆绑服务（Webex 、Webex应用程序和Meetings）。
作为合作伙伴服务商，您可以向客户定制、营销和销售 Webex Calling。您可以设置和延长试用，为客户部署服务，以及创建和部署您客户的订单。有关更多合作伙伴资源，请参阅 Webex Calling Sales Connect 资源。（需要合作伙伴凭证）。
作为试用或付费订阅Webex 的客户管理员，您可以通过添加位置、许可证、电话号码、呼叫功能、用户和工作空间（注册到Webex云的协作室设备）在Control Hub中设置您的组织。
在Control Hub中开始特定配置步骤之前，请遵循先决条件和端口参考资料，确保您的环境支持Webex 。您可以按显示的顺序参阅以下配置工作流图和文章链接，以使您的组织启动并运行Webex ：
有关Webex 产品的更多信息，请参阅 isco Collaboration Flex Plan中的Cisco Webex Calling。
Webex for BroadWorks要求
VDI环境中的Webex应用程序支持Webex for BroadWorks。Webex for BroadWorks 是一种在 Webex 中集成 BroadWorks Calling 的服务。订户使用单个应用程序（Webex应用程序）来利用两个平台提供的功能。
有关Webex for BroadWorks的一般信息，请参阅Webex for BroadWorks解决方案指南。
功能齐全的会议要求
在为功能齐全的会议部署Webex应用程序VDI时，请记住以下几点：
-
将Webex应用程序安装到托管虚拟桌面(HVD)上。
-
您必须为加入功能齐全的Webex会议的用户安装Webex应用程序VDI插件。
-
对于Linux瘦客户端，您还必须安装适用于Linux的Webex Meetings VDI插件（请参阅 瘦客户端系统上安装Webex Meetings VDI插件）。
移动和远程访问(MRA)要求
必要条件
-
您必须至少运行Expressway X12.7 才能让MRA使用Webex VDI的穿越对。早期版本必须升级到X12.7或更高版本以避免路由问题。
-
确保Expressway的HVD环境中的Webex、外部接口和内部接口（双NIC部署）之间的连接。
使用Webex应用程序VDI的MRA工作流程
有关使用Webex VDI工作流程的MRA的信息，请参阅 bex应用程序VDI登录流程。
双重NIC注意事项
在使用Expressway-E双NIC部署的MRA上部署Webex应用程序VDI时，请牢记这些设计注意事项。
-
路由—验证Expressway-E上的默认网关。通常情况下，这是外部接口IP子网的默认网关。验证Expressway默认网关配置后，必须为用于HVD机器的IP子网添加静态路由到Expressway-E。
静态路由将流量从Expressway-E的内部接口发送到HVD子网。由于UDS和TFTP配置查询从HVD发送到Expressway E内部接口，因此需要此配置。Unified CM响应请求后，如果静态路由到HVD子网不存在，Expressway-E将通过默认网关发送响应。
-
AT转换—从HVD到Expressway-E外部接口的SIP流量在到达ExpressWAY之前需要更改源IP，以避免路由问题。NAT解决了这个问题。NAT转换必须在作为HVD和Expressway-E之间路径的网络设备上进行。
DNS配置
内部DNS
-
双NIC部署，您可以使用解析为内部接口IP地址的FQDN指定Expressway-E地址。通过拆分DNS，您可以选择使用公共DNS上可用的相同FQDN。如果不使用拆分DNS，则必须使用不同的FQDN。
为了避免路由问题，从HVD到Expressway-E外部接口的SIP流量需要更改源IP才能到达Expressway。您必须在HVD和Expressway-E之间的网络设备上设置NAT转换。
-
对于具有静态NAT的单个NIC，您必须使用解析为公共IP地址的FQDN指定Expressway-E地址。此设置还意味着外部防火墙必须允许流量从HVD中的Webex应用程序到Expressway-E的外部FQDN。这种设计称为NAT反射，可能并非所有类型的防火墙都支持这种设计。
-
内部DNS必须配置为
_cisco-uds._tcp。SRV记录，以便Webex应用程序可以发现Unified CM。
公共DNS
SRV记录
公共外部DNS必须配置_collab-edge._tls。 SRV记录，以便终端可以发现用于MRA的Expressway-Es。
地理DNS
在43.6及更高版本中，您可以将Webex应用程序配置为与GeoDNS配合使用。此选项允许应用程序连接到地理位置最近的Expressway-E，从而提高网络效率。
如果您已为SRV记录配置GeoDNS，我们建议您在HVD上编辑注册表，如下所示：
-
打开注册表至
HKEY_local_MACHINE\SOFTWARE\Cisco Spark Native。 -
创建名为
DIGeoDnsEnabled的新DWORD键。 -
将
DIGeoDnsEnabled设置为1。(如果要在此HVD上对Webex应用程序禁用GeoDNS兼容性，请将
VDIGeoDnsEnabled设置为0（默认值）。 -
保存注册表。
防火墙配置
内部和外部防火墙都必须允许以下出站连接从HVD上的Webex应用程序到Expressway-E：
-
SIP —TCP 5061
-
HTTPS —TCP 8443
外部防火墙还必须允许从用户瘦客户端到Expressway的以下入站连接：
-
媒体- UDP 36002–59999
部署Webex应用程序VDI
Webex应用程序VDI部署任务流程
这些步骤将指导您了解如何在VDI环境中部署Webex应用程序。这些步骤包括您需要在托管虚拟桌面(HVD)环境中执行的操作，以及用户需要在瘦客户端上执行的操作。
开始之前
如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须在部署VDI之前使用准备环境 章节中的说明部署呼叫服务（Unified CM、Webex 或BroadWorks）。
| 1 |
配置以下托管虚拟桌面类型之一： 要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。 |
| 2 |
在以下平台的瘦客户端计算机上安装Webex应用程序VDI插件：
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 可从 Webex应用程序VDI发行说明获取支持平台的瘦客户端插件。 |
| 3 |
（可选）在Linux瘦客户端上，您还必须在瘦客户端系统上 Webex Meetings VDI插件。 对于Webex应用程序中功能齐全的会议，您必须在Linux瘦客户端上安装两个单独的VDI插件。 |
配置托管虚拟桌面并安装Webex应用程序
要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。
开始之前
-
遵循为VDI版Webex应用程序做好环境准备中的所有前提条件。
如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须先部署呼叫服务（Unified CM、Webex 或BroadWorks），然后再部署VDI。
-
本节仅介绍如何在现有HVD环境中安装Webex应用程序。有关HVD部署最佳实践，请参阅Citrix或Vmware文档。
| 1 |
以拥有域管理权限的新用户身份登录Microsoft Windows HVD。 |
| 2 |
将 HVD 加入企业域。 |
| 3 |
设置 Citrix 或 VMware 对 HVD 的访问权限。 |
| 4 |
如果您的组织有自己的下载站点，其中包含站点特定的Webex应用程序，请转至该站点并下载组织特定的版本。否则，对于通用版本，请转至 Webex应用程序VDI发行说明>下载 并下载所需的Webex应用程序：
|
| 5 |
使用管理权限，使用这些命令和参数在HVD上安装应用程序(这些示例使用
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。 |
| 6 |
复制 HVD 映像。 有关克隆Microsoft Windows HVD图像最佳实践的更多信息，请参阅Citrix或VMware产品的文档。 |
下一步
有关用户首选项以及如何保留的信息，请参阅用户首选项。
安装参数、说明和所需权限
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。
| 参数 | 说明 | 需要管理员安装权限 |
|---|---|---|
所有用户=1 |
在c：\program文件中安装Webex应用程序。这在共享环境（通常是非持久VDI）中很有用。 这是安装的必填参数。每个HVD必须安装VDI。尚不支持按用户安装。 | ✓ |
|
|
值 如果您希望手动维护升级，请使用此选项。 使用 bex应用程序VDI发行说明 链接的版本。参数不会影响非VDI环境。 值 此参数必须伴有 | ✓ |
|
|
控制优化的VDI解决方案。（正式支持。）
| ✓ |
|
仅适用于捆绑包安装程序。在安装Webex应用程序的捆绑组件时，如果该应用程序版本与站点版本兼容，您可以使用此参数锁定用于加入会议的应用程序版本。 | ✓ |
安装WV2=1 |
使用 有关Webex应用程序和WebView2要求的更多信息，请参阅 bex应用程序| WebView2要求。 | ✓ |
启用ROAMING=1 |
如果指定了此参数，则漫游数据库( 此参数必须伴有 有关更多信息，请参阅用户首选项 。 | ✓ |
安装比较
用户可能在Citrix环境中，尚未安装瘦客户端或虚拟通道已断开连接。通过回退到非虚拟Webex应用程序安装，我们支持此场景。在此模式下，应用程序会显示警告，提示视频质量可能会受到影响。连接虚拟通道后，应用程序可以更改为 VDI 模式。
使用此表了解不同的安装组合及其如何影响Unified CM、Webex 和Webex应用程序上的呼叫的媒体优化。
| HVD VDI参数 | 瘦客户端插件 | 启用呼叫服务的用户 | 在 Webex 应用程序上的呼叫 |
|---|---|---|---|
| ENABLEVDI=0 | 未安装 | 媒体未优化 | 媒体未优化 |
| ENABLEVDI=0 | 已安装 | 媒体未优化 | 媒体未优化 |
|
ENABLEVDI=1 * ENABLEVDI=2 ** | 已安装 | 支持的部署；媒体已优化 | 支持的部署；媒体已优化 |
|
ENABLEVDI=1 * ENABLEVDI=2 ** | 未安装 | 退回到未优化的媒体 | 退回到未优化的媒体 |
*此参数不会自动检测VDI环境。
**此参数会自动检测VDI环境。
用户首选项
所有用户首选项都在漫游数据库(spark_roaming_store。db)中。此数据库比主db (spark_persistent_store。db)小得多。
如果您是非持久VDI客户（用户每次注销时都会删除的VDI环境），您可以快速备份和恢复 Appdata\Ro \CiscoSpark 文件夹，以便VDI用户不会在会话之间丢失首选项。
漫游数据库包含所有用户凭证和首选项，使用AES256加密。作为VDI客户，您应始终备份上述文件夹，以便在整个VDI会话中维护用户凭证和首选项。
要解密漫游数据库，还应该同步VDI会话中的以下文件夹：
-
AppData\Ro \Microsoft\Credentials -
AppData\Ro \Microsoft\Crypto -
AppData\Ro \Microsoft\Protect -
AppData\Ro \Microsoft\SystemCertificate
为Webex应用程序配置Azure虚拟桌面
使用这些高级步骤在Azure虚拟桌面（之前称为Windows虚拟桌面）上部署新的Windows环境。AVD是云管理的VDI解决方案。用户通过虚拟Windows环境访问Webex应用程序。
我们不支持在Azure虚拟桌面上使用Webex应用程序的功能齐全的会议。
开始之前
-
此解决方案需要Microsoft Azure订阅。
-
您必须拥有具有Tenant 角色的用户帐户。
-
用户帐户必须同步到Azure Active Directory。
| 1 |
在Azure管理门户中完成部署步骤，以创建主机池、虚拟机和相关设置。 主机池是提供类似服务的VM的集合。Azure表示虚拟环境何时准备就绪。 |
| 2 |
使用Windows客户端测试用户是否可以访问主机池。 有关特定的部署步骤，请参阅有关AVD入门的Microsoft文档。 |
在Windows瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，必须在瘦客户端设备上安装Webex应用程序VDI插件。
从 Webex应用程序VDI发行说明下载瘦客户端插件。
如果您无法为用户安装VDI插件，请在其瘦客户端设备上引导他们完成这些步骤。
开始之前
-
有关Windows版Webex应用程序VDI插件支持的平台列表，请参阅 瘦客户端 。
-
需要在中央HVD环境中安装Webex应用程序。
| 1 |
转至 bex应用程序VDI发行说明>下载，然后下载适用于Windows的Webex应用程序VDI插件安装程序。 |
| 2 |
运行您下载的 |
| 3 |
要打开可执行文件，请单击确定。 |
| 4 |
阅读EULA，如果您同意，请单击接受并安装。 |
| 5 |
要完成安装，请单击完成(Finish)。 |
| 6 |
（可选）如果您或用户为功能齐全的会议手动安装两个插件，请按照 在瘦客户端系统上安装Meetings VDI插件中的步骤操作。 |
下一步
要使Webex应用程序能够为用户正常运行，您必须使用官方瘦客户端插件。要进行确认，运行状况检查将显示虚拟通道的已连接状态。
在Linux瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
开始之前
请参阅 ux瘦客户端 ，了解Linux版Webex应用程序VDI插件支持的平台列表。
要使Webex应用程序能够为用户正常运行并针对VDI进行优化，您必须使用瘦客户端构建。要确认，Webex应用程序中的运行状况检查会显示虚拟通道的已连接状态。
在macOS瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
运行MacOS安装程序(PKG)以安装Webex VDI插件。
开始之前
有关macOS版Webex应用程序VDI插件支持的平台列表，请参阅macOS瘦客户端 。
| 1 |
从 bex应用程序VDI发行说明>下载 macOS瘦客户端系统的Webex应用程序插件。 |
| 2 |
运行 |
| 3 |
阅读EULA，如果您同意，请单击继续(Continue)。 |
| 4 |
单击安装，如果出现必须先关闭Citrix Workspace客户端或VMware Horizon客户端的提示，请单击关闭应用程序并安装。 如果当时无法关闭Citrix或VMware，也可以单击稍后安装 。 |
| 5 |
单击其余屏幕以完成安装。 |
下一步
当用户首次启动Webex应用程序VDI插件时，接受以下所需的权限：
| 许可 | 描述 |
|---|---|
| 访问摄像头 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
| 访问麦克风 | 在呼叫中使用麦克风传输语音。 |
| 录制屏幕 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
要使Webex应用程序能够为用户正常运行，您必须使用下载站点上的官方瘦客户端插件。要进行确认，运行状况检查将显示虚拟通道的已连接状态。
在瘦客户端系统上安装Webex Meetings VDI插件
对于使用Webex应用程序的功能齐全的会议：
-
在Windows或MacOS瘦客户端上，安装捆绑的(App + Meetings)插件。
-
在Linux瘦客户端上，在安装独立的应用程序VDI插件后安装独立的Meetings VDI插件。
开始之前
-
仅在HVD环境中安装Webex应用程序。无需其他应用程序。
-
确保您遵循功能齐全的会议要求。
VDI版Webex应用程序的已知问题和限制
功能
有关每个发行版的功能限制，请参阅Webex应用程序VDI发行说明。
Webex应用程序和VDI客户端
-
对于VDI模式，我们仅支持在 Webex应用程序VDI发行说明上发布的Windows版Webex应用程序（HVD安装程序）和Webex应用程序瘦客户端插件版本。
-
我们仅支持HVD和瘦客户端环境的IPv4。
-
当用户不使用VDI优化的解决方案或处于回退模式时，高清视频会被禁用，Webex应用程序会显示一条通知，告知您可能会看到媒体质量问题。
我们不建议用户在未优化或回退模式下使用VDI。其摄像头或头戴式耳机可能无法正常工作，并且可能遇到媒体质量较差的情况。
-
在MacOS VDI客户端上，当HVD连接全屏时，视频源溢出到MacOS系统栏或应用程序菜单。
-
在Linux VDI客户端上，传入呼叫不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。只有HVD上选择的音频设备才会播放铃声。
Unified CM 呼叫
-
仅适用于使用Expressway进行的内部呼叫：如果用于MRA的穿越对中HVD和Expressway-E之间没有NAT，则ExpressWAY将SIP和媒体信令视为内部，不会将媒体传输到瘦客户端。要解决此问题，请在HVD和Expressway之间部署NAT。这样，当HVD向ExpressWAY-E发送SIP邀请时，它会首先转到NAT。然后，Expressway-E可以传输到瘦客户端。
-
对于备用模式，“模式选择”注册表项无法控制自动应答的Unified CM呼叫的媒体。
Citrix
-
多任务功能不适用于VDI上的Webex应用程序。
-
在非优化模式或回退模式下，Citrix设备映射最多支持4个设备。
-
在Linux版Citrix上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
-
在安装Webex应用程序VDI客户端之前，包括更新接收器/工作空间环境时，必须安装Citrix Receiver/Workspace。如果未安装Citrix或VMWare客户端，Webex应用程序VDI客户端将显示错误并结束安装。
-
对于Windows，如果您运行的Citrix Workspace版本早于2002年，则必须在卸载并重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。如果您运行版本2002或更高版本，则无需卸载并重新安装。
对于所有受支持的Linux版Citrix Workspace，您必须在卸载和重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。
-
Citrix Receiver/Workspace使用32位架构。Webex应用程序VDI适用于此环境。
Azure虚拟桌面（之前称为Windows虚拟桌面）
-
在用于本地Unified CM呼叫的Azure虚拟桌面(AVD)上，我们目前仅支持在MRA下工作的瘦客户端。WVD桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。Webex 和Webex应用程序内置呼叫不受影响。
-
AVD不支持AVD客户端设置中的“将会话调整为窗口”。
-
对于AVD部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
VMware
-
在安装Webex应用程序VDI客户端之前，必须先安装VMware Horizon客户端。如果未安装Citrix或VMware客户端，Webex应用程序VDI客户端将显示错误并结束安装。
-
Webex VDI插件版本41.4及更高版本支持VMware Horizon客户端版本8.x (2103)。
对于兼容模式：如果用户使用之前的VDI插件版本（仅包括将Webex应用程序升级到41.4），通话中的视频可能无法正确显示。
-
我们不支持32位架构上的VMWare Horizon客户端，因为我们停止了用于Windows的32位插件。
Webex应用程序VDI客户端必须与VMware Horizon客户端具有相同的架构：64位VMware Horizon客户端可与（64位）Webex应用程序VDI客户端配合使用。VMware Horizon客户端只有一个安装程序，默认安装为64位。
如果
vdpService.dll存在于C：\Program Files (x86)\VMware\VMware Horizon View Client\x64，您有64位的VMware Horizon客户端。如果
vdpService.dll在以下C：\Program Files (x86)\VMware\VMware Horizon View Client\，您有32位VMware Horizon客户端。 -
在适用于Linux和Windows的VMware上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
-
在用于本地Unified CM呼叫的VMware Cloud桌面上，我们目前仅支持在MRA下工作的瘦客户端。VMware Cloud桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。Webex 和Webex应用程序内置呼叫不受影响。
-
对于VMware Cloud桌面部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
-
在VMware Horizon Client上Connect USB设备 中检查摄像头或音频设备后，HVD中的Webex无法检测或显示这些设备。
亚马逊工作空间
- 在托管虚拟桌面上，请按照此处 的说明为GPO启用WSP分机。
- 如果在通过命令行手动进行新安装后，Webex应用程序的健康检查器中报告了“未检测到VDI环境”，请先尝试注销/登录托管的Windows桌面。
其他
-
在Citrix和Windows虚拟桌面vGPU环境中，Webex应用程序不会被检测到在VDI环境中工作。
我们建议您安装使用
ABLEVDI=1参数的Webex应用程序，以执行VDI优化。 -
我们支持一个Webex应用程序VDI客户端与一个Webex应用程序实例一起工作。用户可以启动多个Citrix或VMware会话，但只有一个连接实例有效，其他实例恢复为非VDI模式。
-
Webex应用程序VDI首先检测到CitRIX，然后在HVD环境中检测VMware。如果要使用VMware，请确保未安装Citrix代理。
管理VDI版Webex应用程序
升级管理
虚拟桌面上的Webex应用程序升级
对于VDI环境，Webex应用程序的新发行版每两个月发布一次。您可以从 Webex应用程序VDI发行说明>下载获取最新和受支持的版本。
我们建议您在虚拟桌面上为Webex应用程序启用自动升级。此选项可确保用户自动获得最新功能。另一种选择是在新发行版可用时手动升级。
您有两个选项可在虚拟桌面上启用Webex应用程序的自动升级：
-
在初始安装期间从命令行启用（请参阅本书部署章节中的为Webex应用程序配置托管虚拟桌面 ）。
-
在虚拟桌面上编辑Windows注册表项：
在
HKEY_local_MACHINE\SOFTWARE\Cisco Spark Native的注册表项中，设置AutoUpgrade =1。如果要手动升级Webex应用程序，请设置
Upgrade =0。
-
Webex应用程序的VDI用户不会收到每月更新，因为每月的厚客户端发行版不会推送到托管的虚拟桌面。
当 桌面版本 Webex应用程序可用（每两个月发布一次）时，系统会提示VDI用户升级。
-
升级包存储在
%appdata%\Local\CiscoSparkLauncher。如果此文件夹在用户的环境中不是持久的，Webex应用程序会在重启虚拟桌面后回滚到以前的版本。 -
HVD上的Webex应用程序向后兼容用户瘦客户端上的Webex应用程序VDI插件(N-4)。请记住，如果您或您的用户未使用最新的HVD版本和VDI插件，则可能无法使用最新的特性和功能。有关更多信息，请参阅发行说明 中的版本支持 。
-
Webex应用程序的自动升级不适用于慢速通道。
瘦客户端升级
Webex应用程序VDI插件每两个月发布一次。
我们建议您为插件启用自动升级。要为VDI插件启用自动升级，您必须在虚拟桌面上编辑Windows注册表项：
-
在
HKEY_local_MACHINE\SOFTWARE\Cisco Spark Native的注册表项中，设置AutoUpgradeVDIPlugin =1。 -
在同一路径中，检查
AutoUpgrade =1。
如果要阻止插件的自动升级，请在虚拟桌面上设置 AutoUpgradeVDIPlugin =0 。如果选择此选项，必须手动升级插件以保持与应用程序的版本兼容性。
-
插件的自动升级仅适用于Webex应用程序42.2及更高版本。
-
Windows和MacOS瘦客户端支持自动升级插件。插件不会在Linux瘦客户端上自动升级。
-
在虚拟桌面上升级Webex应用程序后，系统会提示用户升级插件。
-
我们建议您保留插件和虚拟桌面Webex应用程序的最新版本。如果无法一起升级它们，则存在一些向后兼容性。有关更多信息，请参阅
发行说明
中的版本支持 。 -
插件的自动升级也应用于慢速通道。
Citrix或VMware升级
在管理Citrix或VMware连接代理的升级或更改时，请记住此信息。请务必使用“准备您的环境”一章中列出的受支持版本。
Citrix
|
安装或升级 |
Windows和Mac瘦客户端 |
Linux瘦客户端 |
|---|---|---|
|
新安装 |
在Windows或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 |
在Linux瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 |
|
升级 |
如果您在Citrix环境中看到升级通知，执行此升级不会影响Windows或Mac瘦客户端上的Webex应用程序VDI插件。 |
如果您在Citrix环境中看到升级通知，必须在升级Citrix环境后在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
|
重新安装 |
|
要重新安装任何受支持的Citrix Workspace版本，您必须在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
VMware
|
安装或升级 |
Windows瘦客户端 |
Linux和Mac瘦客户端 |
|---|---|---|
|
新安装 |
在Windows瘦客户端上安装Webex App VDI插件之前，请先安装VMware Horizon客户端。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 |
在Linux或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装VMware Horizon客户端。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 |
|
升级 | 如果您在VMware环境中看到升级通知，执行此升级不会影响Windows瘦客户端上的Webex应用程序VDI插件。 |
如果您在VMware环境中看到升级通知，必须在升级Citrix环境后在Linux或Mac瘦客户端上重新安装Webex应用程序VDI插件。 |
|
重新安装 |
对于VMware重新安装，Windows VDI插件可以正常工作，不受影响。 |
要重新安装VMware，您必须在Linux或Mac瘦客户端上重新安装Webex应用程序插件。 |
安装后禁用VDI检测
如果您有用户不想使用VDI客户端，并且Webex应用程序已部署，您可以在安装后禁用VDI检测。完成此配置后，Webex应用程序将在未优化的解决方案上运行。
| 1 |
根据您在HVD中部署Webex应用程序的方式，打开以下安装路径之一：
|
| 2 |
重命名 |
下一步
如果稍后卸载Webex应用程序，TSDetectionib_bL.dll将保留在文件夹中。您必须在卸载Webex应用程序之前将文件重命名为TSDetectionLib.dll，或在卸载Webex应用程序后ib_b 手动删除TSDetectionL.dll。
在Webex应用程序VDI回退模式中启用或禁用高级视频功能
通过修改注册表，您可以启用或禁用特定的Webex应用程序功能，例如高清(HD)和屏幕共享。这样做可以节省数据中心服务器上的资源。您还可以决定用户是否可以进行全屏或仅HVD窗口的屏幕共享。如果您的用户使用的系统能够使用更高级的视频功能，您可以根据需要启用这些功能。
开始之前
-
您可以在安装VDI插件之前或之后修改注册表项。
对Windows注册表进行更改时应非常谨慎。我们建议您在使用这些步骤之前备份注册表。
-
虚拟背景在缺省情况下被禁用。
-
要启用这些用户，请按照 Webex用户的虚拟背景 步骤进行操作。
-
确保用户的瘦客户端设备满足虚拟背景 要求。
-
| 1 |
在Windows搜索或“运行”窗口中，输入 regedit ，然后按 Enter键 |
| 2 |
转至 KEY__ \ \Cisco Spark Native\。 |
| 3 |
根据需要更改以下注册表项的值： |
| 4 |
为 VDIFallBackConf 选择DWORD值：
此注册表项仅在安装期间 |
| 5 |
为 VDIBackgroundEnabled 选择DWORD值：
|
| 6 |
为 VDIScreenShareEnabled 选择DWORD值：
|
配置VDI插件通知
默认情况下，如果用户的Citrix或VMware客户端连接到没有VDI插件的HVD，系统会通知用户。此时将显示通知，通知他们安装VDI插件，以便启用优化的VDI模式。如果需要，用户可以关闭提醒。
此外，如果Webex应用程序VDI插件的版本与HVD上的Webex应用程序不兼容，将弹出窗口通知用户升级Webex应用程序VDI插件。提醒每周显示一次，直到用户采取行动为止。用户也可以驳回此通知。
作为管理员，您可以在组织范围内启用或禁用这些通知。
开始之前
您可以在安装VDI插件之前或之后修改注册表项。
对Windows注册表进行更改时应非常谨慎。我们建议您在使用这些步骤之前备份注册表。
| 1 |
在Windows搜索或“运行”窗口中，输入 regedit ，然后按 Enter键 |
| 2 |
转至 KEY__ \ \Cisco Spark Native\。 |
| 3 |
为 VDIPluginNotificationEnabled 选择DWORD（32位）注册键值：
|
禁用VDI版本兼容性检查
默认情况下，HVD上的Webex应用程序会检查与瘦客户端上的Webex VDI插件的版本兼容性。插件版本不应超过Webex应用程序后面的4个两个月发行版。例如，如果HVD上的Webex应用程序版本为43.8（2023年8月），则以下插件版本兼容：
-
43.8 (N) 2023年8月
-
43.6 (N-1) 2023年6月
-
43.4 (N-2) 2023年4月
-
43.2 (N-3) 2023年2月
-
42.12 (N-4) 2022年12月
在升级托管虚拟桌面后，此兼容性最多可让您在6个月内升级瘦客户端插件。
如果Webex VDI插件与HVD上的Webex应用程序不兼容，则Webex应用程序进入回退模式。用户会看到升级插件的弹出通知。提醒每周显示一次，直到用户采取行动为止。
您可以使用HVD上的注册表来控制版本兼容性检查：
我们建议您在使用这些步骤之前备份注册表。
-
在Windows运行窗口中，输入
项，然后按Enter键。 -
转至
KEY__ \ \Cisco Spark Native\。 -
创建名为
VDIDisableCompatibilityVersionCheck的DWORD（32位）注册表项，并为其提供下列值之一：0-启用版本兼容性检查（默认）。1-禁用版本兼容性检查。
振铃器和警报设置不适用于所有设备
在Linux VDI客户端上，传入呼叫的铃声不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。只有HVD上选择的音频设备才会播放铃声。
出现此问题的原因可能是Citrix或VMware上的音频设备映射。
在HVD环境中检查注册表项 DIDisablePlaytoneOnLinuxTCEnabled 。如果Linux瘦客户端用户观察到此回铃音问题，请将此键的值设置为 1。
Webex 应用程序中的诊断
Webex应用程序（桌面和VDI）中提供的诊断功能可帮助您和您的用户解决连接问题、检查媒体质量并收集重要的故障诊断信息。
在Webex应用程序(Unified CM)中设置呼叫功能时，您可能会遇到与连接或所需设置（例如语音域和UC服务）相关的问题。使用此工具，您可以诊断哪些服务配置正确，哪些服务缺失。无论您是迁移到Webex应用程序中的呼叫(Unified CM)还是设置新用户，此功能都可用于故障排除场景和减少支持案例。
当用户体验出现问题时，他们可以 诊断视图并导出数据 ，以便与您共享或支持人员。
-
Unified CM设置—电话服务正常工作的关键设置（适用于Jabber迁移以及新用户设置），例如：
-
Unified CM 版本
-
UC服务域
-
SSO
-
语音邮件等UC服务
-
用于MRA的Expressway
-
-
媒体质量 -视频、音频和双向共享的质量
-
设备 -当用户连接到设备时的设备信息
有关显示诊断窗口的快捷键，请参阅键盘和导航快捷键。
浏览器内容重定向
浏览器内容重定向(BCR)是VDI环境的一种优化，可减少虚拟机上的负载。
在虚拟桌面上启用BCR后，Webex应用程序无法通过远程屏幕共享、应用程序共享或屏幕部分共享来共享浏览器内容。
Webex用户可以使用本地屏幕共享来共享浏览器。
新信息和更改信息
新信息和更改信息
此表涵盖与新功能相关的内容更新、现有内容的更改，以及在适用于虚拟桌面基础结构(VDI)的Webex应用程序部署指南中修复的任何重大错误。
有关Webex应用程序VDI更新、新功能、新增的VDI支持和限制的更多信息，请参阅 VDI发行说明。
|
日期 |
已做更改 |
|---|---|
|
2023年11月13日 |
准备您的环境：
|
|
2023年8月23日 |
整个文档：
准备您的环境：
用于VDI的Webex应用程序：
用于VDI的Webex应用程序并对其进行故障排除：
|
|
2023年5月18日 |
在功能齐全的会议要求中澄清了有关Azure虚拟桌面的注释。AVD不支持功能齐全的会议。 |
|
2023 年 4 月 17 日 |
VDI的Webex应用程序 有关禁用VDI版本兼容性检查的新内容。 在托管虚拟桌面和瘦客户端要求中更新了43.4（2023年4月）发行版支持的基础结构和操作系统版本。 |
|
2023年3月15日 |
|
|
2023年3月3日 |
|
|
2023年2月27日 |
添加了在VDI会话之间同步一些 |
|
2023年1月11日 |
在托管虚拟桌面和瘦客户端要求中添加了最新测试的基础设施和瘦客户端操作系统版本以及支持的硬件。包括Apple M2芯片、macOS Ventura、HP ThinPro 8和Dell ThinOS 9.3。 |
|
2022年10月26日 |
更新了“ |
|
2022年8月25日 |
更新了Webex应用程序VDI 42.8版：
更新了 |
|
2022年5月30日 |
|
|
2022 年 4 月 26 日 |
|
|
2022 年 4 月 25 日 |
|
|
2022 年 4 月 13 日 |
|
|
2022年2月9日 |
|
|
2022 年 2 月 3 日 |
|
|
2021年12月15日 |
|
|
2021 年 11 月 12 日 |
|
|
2021年10月29日 |
|
|
2021年10月8日 |
|
|
2021 年 8 月 10 日 |
|
|
2021年7月6日 |
|
|
2021年6月3日 |
6月(41.6)发行版的更新，包括以下内容：
其他常规更新：
|
|
2021年5月3日 |
|
|
2021 年 4 月 16 日 |
|
|
2021年4月9日 |
|
|
2021年1月18日 |
|
|
2020 年 12 月 11 日 |
|
|
2020 年 9 月 29 日 |
|
|
2020年7月16日 |
|
|
2020年6月29日 |
|
概述
VDI版Webex应用程序概述
未优化的情况下，Webex 应用程序消息传递功能会在虚拟桌面基础结构 (VDI) 环境中按原样运行。不过，完整的 Webex 应用程序体验还包括呼叫和会议，而这些功能需要视频和音频媒体处理。
受发夹效应的限制，在未进行优化的情况下，呼叫、会议及相应的视频功能将不受支持。由于媒体是从一个用户流向数据中心后才能流向下一用户，呼叫和视频所需的额外带宽会给数据中心造成瓶颈。在未优化的媒体路径和访问外围设备（如扬声器、麦克风和摄像头等）困难等因素的共同影响下，用户体验难免差强人意。
为了解决“发夹效应”，Webex 应用程序 VDI 插件在虚拟部署中如法炮制 Cisco 的协作体验，以便用户能够使用 Webex 应用程序提供的完整的消息传递、会议和呼叫功能。
为减少延迟并提高媒体质量，VDI 插件通过在瘦客户端终端上的用户之间采取直接流式传输媒体来优化媒体工作流，并利用瘦客户端计算机的硬件进行媒体处理。此媒体路径不经过托管的虚拟桌面 （HVD）。其结果就是，您的 VDI 用户能够获得稳定且功能齐全的呼叫和会议体验。
在该体系结构中，Webex 应用程序安装在 VDI 环境的 HVD 上，所需的 VDI 插件则安装在用户的瘦客户端（通常为轻量系统，如改装过的笔记本电脑或台式电脑）上。
使用受支持的基于Linux、Mac或Windows的瘦客户端，用户可从远程虚拟桌面环境访问HVD上的Webex应用程序。借助受支持的Webex应用程序版本，用户可以在瘦客户端上使用所有内置消息传递、会议和呼叫功能。此外，您可以将 Webex 应用程序 VDI 与 Unified CM 或 Webex Calling 环境集成，以便用户能够使用受支持的呼叫功能。
-
虚拟桌面上的Webex应用程序仍在处理轻量级数据，例如呼叫信令和从云端检索配置。
-
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex应用程序VDI插件一起安装。
有关每个发行版的新功能，请参阅发行说明 了解更多信息。
VDI环境概述
VDI组件
在优化的虚拟环境中使用Webex应用程序需要以下组件。
-
连接代理—将虚拟化提供程序连接到瘦客户端的资源和连接管理器(Citrix、VMware)。
-
托管虚拟桌面(HVD)—远程运行Webex应用程序的虚拟机(VM)。
-
瘦客户端—用户用于远程登录到虚拟桌面的终端（例如，低调或重用的台式电脑或笔记本电脑）。连接代理和VDI插件安装在瘦客户端设备上，因此可以访问HVD环境。
-
插件-安装在瘦客户端上的软件，用于将媒体处理分担到用户设备，而不是HVD资源。支持的Webex应用程序VDI插件版本从Webex应用程序 DI发行说明的“下载”标签页链接。
对于Linux瘦客户端，您必须将Webex Meetings VDI插件与Webex VDI插件一起安装。
-
bex应用程序—在HVD上安装并运行的应用程序。HVD安装程序受支持的版本位于Webex应用程序 DI发行说明的“下载”标签页。
环境类型
-
模式—在永久环境中，用户注销后将保留用户的本地操作系统更改。
所有用户首选项都在漫游数据库(
spark_roaming_store。db)中。此数据库比主db (spark_persistent_store。db)小得多。 -
持久模式—在非持久环境中，用户注销后不保留用户的本地操作系统更改。用户会话期间缓存适用的用户特定信息（用户数据、配置文件和设置）。
如果您是非持久VDI客户（每次用户注销时都会删除这种VDI环境），您可以快速备份和恢复
spark_roaming_store。db，以便VDI用户不会在会话之间失去首选项。漫游数据库包含所有用户凭证和首选项，使用AES256加密。作为VDI客户，您应始终备份漫游数据库，以便在整个VDI会话中维护用户凭证和首选项。
体系结构
架构图显示了具有现有支持呼叫服务部署的典型Webex应用程序VDI部署中涉及的组件、信令和优化媒体流：Unified CM、Webex 或BroadWorks。
每个程序框图的左侧是包含虚拟环境的公司网络。这种虚拟环境通过在虚拟数据中心运行应用程序、操作系统和用户数据来减轻用户端硬件的负载。借助该框架，您可以从中央位置管理环境，用户可以从受支持的瘦客户端远程访问该环境。
公司网络中的组件包括托管虚拟桌面(HVD)、您管理的安装和运行Webex应用程序的中央环境，以及与用户瘦客户端终端的虚拟通道连接（通过Cisco HVDAgent）。
用户在瘦客户端上安装Webex VDI插件并登录到连接代理（Citrix或VMware），这是一款创建与HVD连接的软件。连接代理执行许多任务，包括：
-
验证用户名并为用户提供连接。
-
允许用户连接到特定虚拟桌面。
登录后，瘦客户端端点通过显示器、键盘、鼠标、USB设备等外围设备模拟与应用程序和操作系统的交互，就像软件安装在瘦客户端上一样。用户在此端点上使用瘦客户端应用程序访问远程服务器上的Webex应用程序。
该架构优化了信令和媒体的方向。它通过HTTPS、WSS和SIP与Webex云或BroadWorks云（右侧）进行信令通信。会议（Webex应用程序）和呼叫（Unified CM、Webex 或BroadWorks）的独立媒体流通过SRTP建立。
您必须在HVD上更新Webex应用程序。新版本每两个月发布一次，与之前的瘦客户端VDI插件向后兼容。新的瘦客户端VDI插件构建版本也每两个月提供一次。下载该软件 并参阅发行说明 ，了解有关版本兼容性的更多信息。
使用Unified CM的Webex VDI
适用于MRA的Webex VDI与Unified CM和Expressways
程序框图中的Expressway用于表示Mobile and Remote Access (MRA)部署。要使MRA与WeBEX应用程序VDI配合使用，HVD必须能够将请求发送到通常在DMZ中配置的Expressway-E。
带有Webex 的Webex应用程序VDI
使用Webex for BroadWorks的Webex VDI
包含Meetings的Webex应用程序VDI
备用模式
VDI 无法建立虚拟通道时，Webex 应用程序的 VDI 回退模式可为基本音频和视频通话提供短期支持。回退模式支持标准通话和通话录制。但不支持完整的功能集。导致切换到回退模式的服务器或网络问题，会降低通话质量。
准备您的环境
Webex应用程序VDI登录流程
Webex应用程序VDI架构由两个主要组件组成：用于VDI的Webex应用程序和用于瘦客户端的Webex VDI插件。VDI插件安装在瘦客户端上，而应用程序安装在HVD上。
当用户启动虚拟经纪客户端（Citrix Workspace应用程序或VMWare Horizon Client）时，供应商的软件会启动虚拟通道。Webex应用程序插件和代理使用此虚拟通道进行通信。
下图显示了通过移动和远程访问(MRA)部署Unified CM呼叫时在正常Webex应用程序使用期间设置的预期协议会话。
虽然图中描述了基于MRA的Webex应用程序VDI，但流程与本地VDI部署相同。但是，与基于MRA的VDI不同，内部部署不会通过DMZ路由流量，并且所有流量都位于LAN上。
-
要开始会话，用户首先启动虚拟代理-客户端（Citrix Workspace App或VMware Horizon Client），连接到连接代理，然后选择HVD或虚拟应用程序。选中后，将在用户的瘦客户端（物理机）和Hypervisor上托管的HVD（虚拟机）之间设置虚拟通道。
-
用户在HVD上启动Webex应用程序后，Webex将确定其是否处于虚拟环境中，以及Unified CM是否用于电话服务。如果启用了Unified CM，Webex应用程序将启动
shvdagent.exe进程并开始内部服务发现。（内部服务发现包括UDS DNS SRV查找、Unified CM验证、主群集查找和配置检索。） -
然后，Webex应用程序客户端和Webex应用程序VDI插件设置用于通过虚拟通道交换数据的所有控制流。设置这些通道后，Webex应用程序客户端将语音服务域信息发送到Webex应用程序VDI插件。
-
接下来，Webex应用程序VDI插件执行服务发现。Webex应用程序VDI插件通过引用从Webex应用程序客户端发送到它的语音服务域信息来做到这一点。在这种情况下，Webex应用程序VDI插件解析_collab DNS SRV记录，因为VDI插件机器正在从外部网络连接，因此需要通过MRA进行连接。服务发现完成后，Webex应用程序VDI插件将Expressway-E FQDN发送到Webex应用程序客户端。
-
在接收和缓存Expressway-E FQDN后，Webex应用程序(HVD)会为Expressway-E FQDN执行DNS记录查找。对于单个NIC部署，此步骤将检索Expressway-E的IP地址（带拆分DNS的内部IP或不带拆分DNS的外部IP），用于通过端口8443进行Edge配置和SSO验证。
如果在双网络接口部署中设置了Expressway-E，两个接口都可以有一个内部IP地址。在该情况下，内部接口与外部接口的配置相反。
-
检索Edge详细信息后，Webex应用程序(HVD)会为UDS和TFTP请求建立与ExpressWAY-E IP的HTTPS连接。通过此过程，Webex应用程序(HVD)验证和检索配置详细信息，例如软电话设备配置、应用程序拨号规则和目录查找拨号规则。
-
Webex VDI插件解析Expressway-E外部IP，然后发送到Webex应用程序(HVD)。通过上一步中检索的设备信息，Webex应用程序通过Expressway-E外部界面开始CSF设备（Windows桌面）注册。
托管虚拟桌面和瘦客户端要求
确保您的VDI环境满足受支持服务器(安装Webex应用程序的托管虚拟桌面(HVD))和瘦客户端（安装Webex VDI插件的用户端设备）的要求。
对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。
托管的虚拟桌面
|
VDI组件 |
支持的平台 |
|---|---|
| 单会话操作系统-安装在HVD上 |
|
|
多会话操作系统-安装在HVD上 |
|
|
多会话云虚拟化服务 |
|
| 托管虚拟桌面的连接代理 |
连接代理是创建与托管虚拟桌面连接的软件。连接代理执行许多任务，包括：
|
Windows瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 基于 Microsoft Windows 的瘦客户端硬件 |
支持的硬件
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） 支持的软件 我们支持以下Windows版本的64位架构：
|
| 基于 Windows Embedded Standard 的瘦客户端硬件 |
支持的硬件 已安装 2 GB 的 RAM 可用物理内存 128 MB 可用磁盘空间 256 MB CPU 性能会影响最大视频分辨率。使用 Windows Embedded Standard 瘦客户端时，所需分辨率取决于 CPU：
这些硬件规格仅为所需分辨率提供参考。其他因素也会影响视频分辨率。 与 DirectX 11 兼容的 GPU USB 2.0（用于 USB 摄像头和音频设备） 支持的软件
|
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Linux瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 瘦客户端操作系统 |
Ubuntu（64位）
|
|
Unicon eLux（64位）
|
|
|
HP ThinPro 7.1（生命周期终止） HP ThinPro 8.0、8.1（64位）
|
|
|
IGEL OS
|
|
|
Dell Wyse ThinOS
Dell Wyse ThinOS支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系Dell以获取技术支持。有关详细信息，请参阅您受支持版本的 Dell Wyse ThinOS文档 ；其发行说明的“ |
|
|
10ZiG Zero Client瘦客户端 10ZiG0客户端瘦客户端支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系10ZiG以获得技术支持。有关详细信息，请参阅特定瘦客户端的 10ZiG页面 。 |
|
|
Stratodesk NoTouch操作系统 Stratodesk NoTouch操作系统支持特定版本的Webex VDI插件。由于此第三方集成，您必须联系Stratodesk获取技术支持。有关更多信息，请参阅Stratodesk NoTouch OS文档 ，了解您支持的版本。 |
|
| Ubuntu/Thinpro瘦客户端硬件 |
瘦客户端的最低硬件要求如下：
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
| eLux RP 6瘦客户端硬件 |
最低硬件要求 下列系统属性可使用基本eLux RP 6功能启用。
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
| 已测试和推荐的设备 |
*根据硬件要求，不建议将这些设备与虚拟背景配合使用。有关更多信息，请参阅虚拟背景要求 。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） |
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
macOS瘦客户端
|
VDI组件 |
支持的平台 |
|---|---|
| 基于MacOS的瘦客户端硬件 |
支持的硬件
在以下任何Apple硬件上安装Intel Core 2 Duo或更高版本的处理器：
如果您希望用户使用虚拟背景，您必须满足虚拟背景要求。（VDI版Webex应用程序与Windows独立应用程序的要求相同。） 支持的软件 以下macOS版本支持Webex应用程序VDI插件：
|
|
Citrix Workspace应用程序或VMware Horizon客户端 |
|
Webex应用程序和插件要求
-
从Webex应用程序VDI发行说明的“下载”标签页 Webex应用程序（安装在HVD ）和Webex应用程序插件（安装在用户瘦客户端计算机上）。
-
虽然我们支持发行说明中所述的向后兼容性，但我们建议您尽可能使用最新版本的安装程序。
-
对于从Webex应用程序加入Webex会议的用户，请参阅 bex meetings VDI的托管虚拟桌面和瘦客户端要求。
-
VDI用户通常对其计算机没有管理员控制权，插件也不需要管理员权限。但是，如果您的用户需要与Outlook集成，则必须使用在Microsoft Outlook中显示用户状态中的指示注册办公室集成。dll文件。
耳机要求
对于Webex应用程序VDI，除非另有说明，否则我们支持与独立版Webex应用程序相同的头戴式耳机。有关更多信息，请参阅有关头戴式耳机支持的详细信息 。
支持用于呼叫和会议的实时媒体工作流程
Webex应用程序VDI支持以下实时媒体工作流：
-
Webex上的呼叫（内置在应用程序中）
-
Unified CM
-
Webex 呼叫
-
Webex for BroadWorks
-
Webex Meetings
要集成受支持的呼叫服务和Webex Meetings，您必须遵循这些解决方案文档中的配置步骤。选择一个选项，然后使用该部分中链接的文档。
Unified CM要求
如果要将Unified CM用作Webex应用程序VDI用户的呼叫服务，请使用部署指南 完成所需的配置步骤。文档包含服务、前提条件和部署步骤的概述。
将呼叫转入会议
要支持此功能，请确保已 正确配置Unified CM呼叫部署。
此外，请确保以下VDI配置到位，以便支持将负载转移到会议：功能齐全的会议要求。
移动和远程访问 (MRA)
支持Mobile and Remote Access (MRA)。按照 way MRA文档 中的标准MRA部署步骤，并在支持的VDI部署中牢记以下几点：
-
有关VDI支持的更多指导，请参阅移动和远程访问(MRA)要求 。
-
必须至少运行X12。7和更高版本。
-
支持双NIC部署。您必须确保从HVD连接到Expressway-E的外部和内部IP地址。您必须在HVD和ExpressWAY-E的外部IP之间添加NAT。
Webex 要求
如果您的HVD支持IPv4和IPv6，我们建议您在HVD环境中禁用IPV6，以防止Webex 出现兼容性问题。
Control Hub中的配置（合作伙伴和管理员）
Control Hub (https://admin.webex.com)是一个与Webex 集成的基于Web的管理门户，可简化您的订单和配置，并集中管理捆绑服务（Webex 、Webex应用程序和Meetings）。
作为合作伙伴服务商，您可以向客户定制、营销和销售 Webex Calling。您可以设置和延长试用，为客户部署服务，以及创建和部署您客户的订单。有关更多合作伙伴资源，请参阅 Webex Calling Sales Connect 资源。（需要合作伙伴凭证）。
作为试用或付费订阅Webex 的客户管理员，您可以通过添加位置、许可证、电话号码、呼叫功能、用户和工作空间（注册到Webex云的协作室设备）在Control Hub中设置您的组织。
在Control Hub中开始特定配置步骤之前，请遵循先决条件和端口参考资料，确保您的环境支持Webex 。您可以按显示的顺序参阅以下配置工作流图和文章链接，以使您的组织启动并运行Webex ：
有关Webex 产品的更多信息，请参阅 isco Collaboration Flex Plan中的Cisco Webex Calling。
Webex for BroadWorks要求
VDI环境中的Webex应用程序支持Webex for BroadWorks。Webex for BroadWorks 是一种在 Webex 中集成 BroadWorks Calling 的服务。订户使用单个应用程序（Webex应用程序）来利用两个平台提供的功能。
有关Webex for BroadWorks的一般信息，请参阅Webex for BroadWorks解决方案指南。
功能齐全的会议要求
在为功能齐全的会议部署Webex应用程序VDI时，请记住以下几点：
-
将Webex应用程序安装到托管虚拟桌面(HVD)上。
-
您必须为加入功能齐全的Webex会议的用户安装Webex应用程序VDI插件。
-
对于Linux瘦客户端，您还必须安装适用于Linux的Webex Meetings VDI插件（请参阅 瘦客户端系统上安装Webex Meetings VDI插件）。
移动和远程访问(MRA)要求
必要条件
-
您必须至少运行Expressway X12.7 才能让MRA使用Webex VDI的穿越对。早期版本必须升级到X12.7或更高版本以避免路由问题。
-
确保Expressway的HVD环境中的Webex、外部接口和内部接口（双NIC部署）之间的连接。
使用Webex应用程序VDI的MRA工作流程
有关使用Webex VDI工作流程的MRA的信息，请参阅 bex应用程序VDI登录流程。
双重NIC注意事项
在使用Expressway-E双NIC部署的MRA上部署Webex应用程序VDI时，请牢记这些设计注意事项。
-
路由—验证Expressway-E上的默认网关。通常情况下，这是外部接口IP子网的默认网关。验证Expressway默认网关配置后，必须为用于HVD机器的IP子网添加静态路由到Expressway-E。
静态路由将流量从Expressway-E的内部接口发送到HVD子网。由于UDS和TFTP配置查询从HVD发送到Expressway E内部接口，因此需要此配置。Unified CM响应请求后，如果静态路由到HVD子网不存在，Expressway-E将通过默认网关发送响应。
-
AT转换—从HVD到Expressway-E外部接口的SIP流量在到达ExpressWAY之前需要更改源IP，以避免路由问题。NAT解决了这个问题。NAT转换必须在作为HVD和Expressway-E之间路径的网络设备上进行。
DNS配置
内部DNS
-
双NIC部署，您可以使用解析为内部接口IP地址的FQDN指定Expressway-E地址。通过拆分DNS，您可以选择使用公共DNS上可用的相同FQDN。如果不使用拆分DNS，则必须使用不同的FQDN。
为了避免路由问题，从HVD到Expressway-E外部接口的SIP流量需要更改源IP才能到达Expressway。您必须在HVD和Expressway-E之间的网络设备上设置NAT转换。
-
对于具有静态NAT的单个NIC，您必须使用解析为公共IP地址的FQDN指定Expressway-E地址。此设置还意味着外部防火墙必须允许流量从HVD中的Webex应用程序到Expressway-E的外部FQDN。这种设计称为NAT反射，可能并非所有类型的防火墙都支持这种设计。
-
内部DNS必须配置为
_cisco-uds._tcp。SRV记录，以便Webex应用程序可以发现Unified CM。
公共DNS
SRV记录
公共外部DNS必须配置_collab-edge._tls。 SRV记录，以便终端可以发现用于MRA的Expressway-Es。
地理DNS
在43.6及更高版本中，您可以将Webex应用程序配置为与GeoDNS配合使用。此选项允许应用程序连接到地理位置最近的Expressway-E，从而提高网络效率。
如果您已为SRV记录配置GeoDNS，我们建议您在HVD上编辑注册表，如下所示：
-
打开注册表至
HKEY_local_MACHINE\SOFTWARE\Cisco Spark Native。 -
创建名为
DIGeoDnsEnabled的新DWORD键。 -
将
DIGeoDnsEnabled设置为1。(如果要在此HVD上对Webex应用程序禁用GeoDNS兼容性，请将
VDIGeoDnsEnabled设置为0（默认值）。 -
保存注册表。
防火墙配置
内部和外部防火墙都必须允许以下出站连接从HVD上的Webex应用程序到Expressway-E：
-
SIP —TCP 5061
-
HTTPS —TCP 8443
外部防火墙还必须允许从用户瘦客户端到Expressway的以下入站连接：
-
媒体- UDP 36002–59999
部署Webex应用程序VDI
Webex应用程序VDI部署任务流程
这些步骤将指导您了解如何在VDI环境中部署Webex应用程序。这些步骤包括您需要在托管虚拟桌面(HVD)环境中执行的操作，以及用户需要在瘦客户端上执行的操作。
开始之前
如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须在部署VDI之前使用准备环境 章节中的说明部署呼叫服务（Unified CM、Webex 或BroadWorks）。
| 1 |
配置以下托管虚拟桌面类型之一： 要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。 |
| 2 |
在以下平台的瘦客户端计算机上安装Webex应用程序VDI插件：
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。 可从 Webex应用程序VDI发行说明获取支持平台的瘦客户端插件。 |
| 3 |
（可选）在Linux瘦客户端上，您还必须在瘦客户端系统上 Webex Meetings VDI插件。 对于Webex应用程序中功能齐全的会议，您必须在Linux瘦客户端上安装两个单独的VDI插件。 |
配置托管虚拟桌面并安装Webex应用程序
要为希望从瘦客户端设备远程访问Webex应用程序的用户做好准备，请在集中式托管虚拟桌面(HVD)环境中设置Webex应用程序。
开始之前
-
遵循为VDI版Webex应用程序做好环境准备中的所有前提条件。
如果您希望Webex应用程序VDI用户能够访问组织中的呼叫功能，则必须先部署呼叫服务（Unified CM、Webex 或BroadWorks），然后再部署VDI。
-
本节仅介绍如何在现有HVD环境中安装Webex应用程序。有关HVD部署最佳实践，请参阅Citrix或Vmware文档。
| 1 |
以拥有域管理权限的新用户身份登录Microsoft Windows HVD。 |
| 2 |
将 HVD 加入企业域。 |
| 3 |
设置 Citrix 或 VMware 对 HVD 的访问权限。 |
| 4 |
如果您的组织有自己的下载站点，其中包含站点特定的Webex应用程序，请转至该站点并下载组织特定的版本。否则，对于通用版本，请转至 Webex应用程序VDI发行说明>下载 并下载所需的Webex应用程序：
|
| 5 |
使用管理权限，使用这些命令和参数在HVD上安装应用程序(这些示例使用
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。 |
| 6 |
复制 HVD 映像。 有关克隆Microsoft Windows HVD图像最佳实践的更多信息，请参阅Citrix或VMware产品的文档。 |
下一步
有关用户首选项以及如何保留的信息，请参阅用户首选项。
安装参数、说明和所需权限
请参阅下表，了解在VDI环境中安装Webex应用程序时可以使用的参数说明。
| 参数 | 说明 | 需要管理员安装权限 |
|---|---|---|
所有用户=1 |
在c：\program文件中安装Webex应用程序。这在共享环境（通常是非持久VDI）中很有用。 这是安装的必填参数。每个HVD必须安装VDI。尚不支持按用户安装。 | ✓ |
|
|
值 如果您希望手动维护升级，请使用此选项。 使用 bex应用程序VDI发行说明 链接的版本。参数不会影响非VDI环境。 值 此参数必须伴有 | ✓ |
|
|
控制优化的VDI解决方案。（正式支持。）
| ✓ |
|
仅适用于捆绑包安装程序。在安装Webex应用程序的捆绑组件时，如果该应用程序版本与站点版本兼容，您可以使用此参数锁定用于加入会议的应用程序版本。 | ✓ |
安装WV2=1 |
使用 有关Webex应用程序和WebView2要求的更多信息，请参阅 bex应用程序| WebView2要求。 | ✓ |
启用ROAMING=1 |
如果指定了此参数，则漫游数据库( 此参数必须伴有 有关更多信息，请参阅用户首选项 。 | ✓ |
安装比较
用户可能在Citrix环境中，尚未安装瘦客户端或虚拟通道已断开连接。通过回退到非虚拟Webex应用程序安装，我们支持此场景。在此模式下，应用程序会显示警告，提示视频质量可能会受到影响。连接虚拟通道后，应用程序可以更改为 VDI 模式。
使用此表了解不同的安装组合及其如何影响Unified CM、Webex 和Webex应用程序上的呼叫的媒体优化。
| HVD VDI参数 | 瘦客户端插件 | 启用呼叫服务的用户 | 在 Webex 应用程序上的呼叫 |
|---|---|---|---|
| ENABLEVDI=0 | 未安装 | 媒体未优化 | 媒体未优化 |
| ENABLEVDI=0 | 已安装 | 媒体未优化 | 媒体未优化 |
|
ENABLEVDI=1 * ENABLEVDI=2 ** | 已安装 | 支持的部署；媒体已优化 | 支持的部署；媒体已优化 |
|
ENABLEVDI=1 * ENABLEVDI=2 ** | 未安装 | 退回到未优化的媒体 | 退回到未优化的媒体 |
*此参数不会自动检测VDI环境。
**此参数会自动检测VDI环境。
用户首选项
所有用户首选项都在漫游数据库(spark_roaming_store。db)中。此数据库比主db (spark_persistent_store。db)小得多。
如果您是非持久VDI客户（用户每次注销时都会删除的VDI环境），您可以快速备份和恢复 Appdata\Ro \CiscoSpark 文件夹，以便VDI用户不会在会话之间丢失首选项。
漫游数据库包含所有用户凭证和首选项，使用AES256加密。作为VDI客户，您应始终备份上述文件夹，以便在整个VDI会话中维护用户凭证和首选项。
要解密漫游数据库，还应该同步VDI会话中的以下文件夹：
-
AppData\Ro \Microsoft\Credentials -
AppData\Ro \Microsoft\Crypto -
AppData\Ro \Microsoft\Protect -
AppData\Ro \Microsoft\SystemCertificate
为Webex应用程序配置Azure虚拟桌面
使用这些高级步骤在Azure虚拟桌面（之前称为Windows虚拟桌面）上部署新的Windows环境。AVD是云管理的VDI解决方案。用户通过虚拟Windows环境访问Webex应用程序。
我们不支持在Azure虚拟桌面上使用Webex应用程序的功能齐全的会议。
开始之前
-
此解决方案需要Microsoft Azure订阅。
-
您必须拥有具有Tenant 角色的用户帐户。
-
用户帐户必须同步到Azure Active Directory。
| 1 |
在Azure管理门户中完成部署步骤，以创建主机池、虚拟机和相关设置。 主机池是提供类似服务的VM的集合。Azure表示虚拟环境何时准备就绪。 |
| 2 |
使用Windows客户端测试用户是否可以访问主机池。 有关特定的部署步骤，请参阅有关AVD入门的Microsoft文档。 |
在Windows瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，必须在瘦客户端设备上安装Webex应用程序VDI插件。
从 Webex应用程序VDI发行说明下载瘦客户端插件。
如果您无法为用户安装VDI插件，请在其瘦客户端设备上引导他们完成这些步骤。
开始之前
-
有关Windows版Webex应用程序VDI插件支持的平台列表，请参阅 瘦客户端 。
-
需要在中央HVD环境中安装Webex应用程序。
| 1 |
转至 bex应用程序VDI发行说明>下载，然后下载适用于Windows的Webex应用程序VDI插件安装程序。 |
| 2 |
运行您下载的 |
| 3 |
要打开可执行文件，请单击确定。 |
| 4 |
阅读EULA，如果您同意，请单击接受并安装。 |
| 5 |
要完成安装，请单击完成(Finish)。 |
| 6 |
（可选）如果您或用户为功能齐全的会议手动安装两个插件，请按照 在瘦客户端系统上安装Meetings VDI插件中的步骤操作。 |
下一步
要使Webex应用程序能够为用户正常运行，您必须使用官方瘦客户端插件。要进行确认，运行状况检查将显示虚拟通道的已连接状态。
在Linux瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
开始之前
请参阅 ux瘦客户端 ，了解Linux版Webex应用程序VDI插件支持的平台列表。
要使Webex应用程序能够为用户正常运行并针对VDI进行优化，您必须使用瘦客户端构建。要确认，Webex应用程序中的运行状况检查会显示虚拟通道的已连接状态。
在macOS瘦客户端系统上安装Webex应用程序VDI插件
在中央HVD环境中安装Webex应用程序后，您接下来会让用户在其瘦客户端设备上安装Webex应用程序VDI插件。瘦客户端通常是轻量级或重用的计算机，用户用于与托管Webex应用程序的集中式HVD服务器建立远程连接。支持平台的瘦客户端插件从 Webex应用程序VDI发行说明链接。
运行MacOS安装程序(PKG)以安装Webex VDI插件。
开始之前
有关macOS版Webex应用程序VDI插件支持的平台列表，请参阅macOS瘦客户端 。
| 1 |
从 bex应用程序VDI发行说明>下载 macOS瘦客户端系统的Webex应用程序插件。 |
| 2 |
运行 |
| 3 |
阅读EULA，如果您同意，请单击继续(Continue)。 |
| 4 |
单击安装，如果出现必须先关闭Citrix Workspace客户端或VMware Horizon客户端的提示，请单击关闭应用程序并安装。 如果当时无法关闭Citrix或VMware，也可以单击稍后安装 。 |
| 5 |
单击其余屏幕以完成安装。 |
下一步
当用户首次启动Webex应用程序VDI插件时，接受以下所需的权限：
| 许可 | 描述 |
|---|---|
| 访问摄像头 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
| 访问麦克风 | 在呼叫中使用麦克风传输语音。 |
| 录制屏幕 | 在视频通话中使用摄像头，或尝试在“设置”中打开摄像头。 |
要使Webex应用程序能够为用户正常运行，您必须使用下载站点上的官方瘦客户端插件。要进行确认，运行状况检查将显示虚拟通道的已连接状态。
在瘦客户端系统上安装Webex Meetings VDI插件
对于使用Webex应用程序的功能齐全的会议：
-
在Windows或MacOS瘦客户端上，安装捆绑的(App + Meetings)插件。
-
在Linux瘦客户端上，在安装独立的应用程序VDI插件后安装独立的Meetings VDI插件。
开始之前
-
仅在HVD环境中安装Webex应用程序。无需其他应用程序。
-
确保您遵循功能齐全的会议要求。
VDI版Webex应用程序的已知问题和限制
功能
有关每个发行版的功能限制，请参阅Webex应用程序VDI发行说明。
Webex应用程序和VDI客户端
-
对于VDI模式，我们仅支持在 Webex应用程序VDI发行说明上发布的Windows版Webex应用程序（HVD安装程序）和Webex应用程序瘦客户端插件版本。
-
我们仅支持HVD和瘦客户端环境的IPv4。
-
当用户不使用VDI优化的解决方案或处于回退模式时，高清视频会被禁用，Webex应用程序会显示一条通知，告知您可能会看到媒体质量问题。
我们不建议用户在未优化或回退模式下使用VDI。其摄像头或头戴式耳机可能无法正常工作，并且可能遇到媒体质量较差的情况。
-
在MacOS VDI客户端上，当HVD连接全屏时，视频源溢出到MacOS系统栏或应用程序菜单。
-
在Linux VDI客户端上，传入呼叫不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。只有HVD上选择的音频设备才会播放铃声。
Unified CM 呼叫
-
仅适用于使用Expressway进行的内部呼叫：如果用于MRA的穿越对中HVD和Expressway-E之间没有NAT，则ExpressWAY将SIP和媒体信令视为内部，不会将媒体传输到瘦客户端。要解决此问题，请在HVD和Expressway之间部署NAT。这样，当HVD向ExpressWAY-E发送SIP邀请时，它会首先转到NAT。然后，Expressway-E可以传输到瘦客户端。
-
对于备用模式，“模式选择”注册表项无法控制自动应答的Unified CM呼叫的媒体。
Citrix
-
多任务功能不适用于VDI上的Webex应用程序。
-
在非优化模式或回退模式下，Citrix设备映射最多支持4个设备。
-
在Linux版Citrix上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
-
在安装Webex应用程序VDI客户端之前，包括更新接收器/工作空间环境时，必须安装Citrix Receiver/Workspace。如果未安装Citrix或VMWare客户端，Webex应用程序VDI客户端将显示错误并结束安装。
-
对于Windows，如果您运行的Citrix Workspace版本早于2002年，则必须在卸载并重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。如果您运行版本2002或更高版本，则无需卸载并重新安装。
对于所有受支持的Linux版Citrix Workspace，您必须在卸载和重新安装Citrix Receiver/Workspace后重新安装（卸载然后再次安装或修复）Webex应用程序VDI客户端。
-
Citrix Receiver/Workspace使用32位架构。Webex应用程序VDI适用于此环境。
Azure虚拟桌面（之前称为Windows虚拟桌面）
-
在用于本地Unified CM呼叫的Azure虚拟桌面(AVD)上，我们目前仅支持在MRA下工作的瘦客户端。WVD桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。Webex 和Webex应用程序内置呼叫不受影响。
-
AVD不支持AVD客户端设置中的“将会话调整为窗口”。
-
对于AVD部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
VMware
-
在安装Webex应用程序VDI客户端之前，必须先安装VMware Horizon客户端。如果未安装Citrix或VMware客户端，Webex应用程序VDI客户端将显示错误并结束安装。
-
Webex VDI插件版本41.4及更高版本支持VMware Horizon客户端版本8.x (2103)。
对于兼容模式：如果用户使用之前的VDI插件版本（仅包括将Webex应用程序升级到41.4），通话中的视频可能无法正确显示。
-
我们不支持32位架构上的VMWare Horizon客户端，因为我们停止了用于Windows的32位插件。
Webex应用程序VDI客户端必须与VMware Horizon客户端具有相同的架构：64位VMware Horizon客户端可与（64位）Webex应用程序VDI客户端配合使用。VMware Horizon客户端只有一个安装程序，默认安装为64位。
如果
vdpService.dll存在于C：\Program Files (x86)\VMware\VMware Horizon View Client\x64，您有64位的VMware Horizon客户端。如果
vdpService.dll在以下C：\Program Files (x86)\VMware\VMware Horizon View Client\，您有32位VMware Horizon客户端。 -
在适用于Linux和Windows的VMware上，我们仅通过使用瘦客户端上的默认设备支持语音邮件播放。因此，当您想要使用首选音频设备播放语音邮件时，需要在瘦客户端上打开声音设置，以设置要在缺省情况下使用的设备。
-
在用于本地Unified CM呼叫的VMware Cloud桌面上，我们目前仅支持在MRA下工作的瘦客户端。VMware Cloud桌面（基于云的远程桌面）中的Webex应用程序可用于MRA。如果瘦客户端在本地，Unified CM呼叫可能会被某些防火墙设置阻止。Webex 和Webex应用程序内置呼叫不受影响。
-
对于VMware Cloud桌面部署，必须启用内部网络与Expressway-E -端口之间的UDP连接，范围为16384–32767。
-
在VMware Horizon Client上Connect USB设备 中检查摄像头或音频设备后，HVD中的Webex无法检测或显示这些设备。
亚马逊工作空间
- 在托管虚拟桌面上，请按照此处 的说明为GPO启用WSP分机。
- 如果在通过命令行手动进行新安装后，Webex应用程序的健康检查器中报告了“未检测到VDI环境”，请先尝试注销/登录托管的Windows桌面。
其他
-
在Citrix和Windows虚拟桌面vGPU环境中，Webex应用程序不会被检测到在VDI环境中工作。
我们建议您安装使用
ABLEVDI=1参数的Webex应用程序，以执行VDI优化。 -
我们支持一个Webex应用程序VDI客户端与一个Webex应用程序实例一起工作。用户可以启动多个Citrix或VMware会话，但只有一个连接实例有效，其他实例恢复为非VDI模式。
-
Webex应用程序VDI首先检测到CitRIX，然后在HVD环境中检测VMware。如果要使用VMware，请确保未安装Citrix代理。
管理VDI版Webex应用程序
升级管理
虚拟桌面上的Webex应用程序升级
对于VDI环境，Webex应用程序的新发行版每两个月发布一次。您可以从 Webex应用程序VDI发行说明>下载获取最新和受支持的版本。
我们建议您在虚拟桌面上为Webex应用程序启用自动升级。此选项可确保用户自动获得最新功能。另一种选择是在新发行版可用时手动升级。
您有两个选项可在虚拟桌面上启用Webex应用程序的自动升级：
-
在初始安装期间从命令行启用（请参阅本书部署章节中的为Webex应用程序配置托管虚拟桌面 ）。
-
在虚拟桌面上编辑Windows注册表项：
在
HKEY_local_MACHINE\SOFTWARE\Cisco Spark Native的注册表项中，设置AutoUpgrade =1。如果要手动升级Webex应用程序，请设置
Upgrade =0。
-
Webex应用程序的VDI用户不会收到每月更新，因为每月的厚客户端发行版不会推送到托管的虚拟桌面。
当 桌面版本 Webex应用程序可用（每两个月发布一次）时，系统会提示VDI用户升级。
-
升级包存储在
%appdata%\Local\CiscoSparkLauncher。如果此文件夹在用户的环境中不是持久的，Webex应用程序会在重启虚拟桌面后回滚到以前的版本。 -
HVD上的Webex应用程序向后兼容用户瘦客户端上的Webex应用程序VDI插件(N-4)。请记住，如果您或您的用户未使用最新的HVD版本和VDI插件，则可能无法使用最新的特性和功能。有关更多信息，请参阅发行说明 中的版本支持 。
-
Webex应用程序的自动升级不适用于慢速通道。
瘦客户端升级
Webex应用程序VDI插件每两个月发布一次。
我们建议您为插件启用自动升级。要为VDI插件启用自动升级，您必须在虚拟桌面上编辑Windows注册表项：
-
在
HKEY_local_MACHINE\SOFTWARE\Cisco Spark Native的注册表项中，设置AutoUpgradeVDIPlugin =1。 -
在同一路径中，检查
AutoUpgrade =1。
如果要阻止插件的自动升级，请在虚拟桌面上设置 AutoUpgradeVDIPlugin =0 。如果选择此选项，必须手动升级插件以保持与应用程序的版本兼容性。
-
插件的自动升级仅适用于Webex应用程序42.2及更高版本。
-
Windows和MacOS瘦客户端支持自动升级插件。插件不会在Linux瘦客户端上自动升级。
-
在虚拟桌面上升级Webex应用程序后，系统会提示用户升级插件。
-
我们建议您保留插件和虚拟桌面Webex应用程序的最新版本。如果无法一起升级它们，则存在一些向后兼容性。有关更多信息，请参阅
发行说明
中的版本支持 。 -
插件的自动升级也应用于慢速通道。
Citrix或VMware升级
在管理Citrix或VMware连接代理的升级或更改时，请记住此信息。请务必使用“准备您的环境”一章中列出的受支持版本。
Citrix
|
安装或升级 |
Windows和Mac瘦客户端 |
Linux瘦客户端 |
|---|---|---|
|
新安装 |
在Windows或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 |
在Linux瘦客户端上安装Webex应用程序VDI插件之前，请先安装Citrix Receiver或Workspace。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接代理。 |
|
升级 |
如果您在Citrix环境中看到升级通知，执行此升级不会影响Windows或Mac瘦客户端上的Webex应用程序VDI插件。 |
如果您在Citrix环境中看到升级通知，必须在升级Citrix环境后在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
|
重新安装 |
|
要重新安装任何受支持的Citrix Workspace版本，您必须在Linux瘦客户端上重新安装Webex应用程序VDI插件。 |
VMware
|
安装或升级 |
Windows瘦客户端 |
Linux和Mac瘦客户端 |
|---|---|---|
|
新安装 |
在Windows瘦客户端上安装Webex App VDI插件之前，请先安装VMware Horizon客户端。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 |
在Linux或Mac瘦客户端上安装Webex应用程序VDI插件之前，请先安装VMware Horizon客户端。您和您的用户会在VDI插件安装步骤中看到一条警告，提醒您先安装连接器代理。 |
|
升级 | 如果您在VMware环境中看到升级通知，执行此升级不会影响Windows瘦客户端上的Webex应用程序VDI插件。 |
如果您在VMware环境中看到升级通知，必须在升级Citrix环境后在Linux或Mac瘦客户端上重新安装Webex应用程序VDI插件。 |
|
重新安装 |
对于VMware重新安装，Windows VDI插件可以正常工作，不受影响。 |
要重新安装VMware，您必须在Linux或Mac瘦客户端上重新安装Webex应用程序插件。 |
安装后禁用VDI检测
如果您有用户不想使用VDI客户端，并且Webex应用程序已部署，您可以在安装后禁用VDI检测。完成此配置后，Webex应用程序将在未优化的解决方案上运行。
| 1 |
根据您在HVD中部署Webex应用程序的方式，打开以下安装路径之一：
|
| 2 |
重命名 |
下一步
如果稍后卸载Webex应用程序，TSDetectionib_bL.dll将保留在文件夹中。您必须在卸载Webex应用程序之前将文件重命名为TSDetectionLib.dll，或在卸载Webex应用程序后ib_b 手动删除TSDetectionL.dll。
在Webex应用程序VDI回退模式中启用或禁用高级视频功能
通过修改注册表，您可以启用或禁用特定的Webex应用程序功能，例如高清(HD)和屏幕共享。这样做可以节省数据中心服务器上的资源。您还可以决定用户是否可以进行全屏或仅HVD窗口的屏幕共享。如果您的用户使用的系统能够使用更高级的视频功能，您可以根据需要启用这些功能。
开始之前
-
您可以在安装VDI插件之前或之后修改注册表项。
对Windows注册表进行更改时应非常谨慎。我们建议您在使用这些步骤之前备份注册表。
-
虚拟背景在缺省情况下被禁用。
-
要启用这些用户，请按照 Webex用户的虚拟背景 步骤进行操作。
-
确保用户的瘦客户端设备满足虚拟背景 要求。
-
| 1 |
在Windows搜索或“运行”窗口中，输入 regedit ，然后按 Enter键 |
| 2 |
转至 KEY__ \ \Cisco Spark Native\。 |
| 3 |
根据需要更改以下注册表项的值： |
| 4 |
为 VDIFallBackConf 选择DWORD值：
此注册表项仅在安装期间 |
| 5 |
为 VDIBackgroundEnabled 选择DWORD值：
|
| 6 |
为 VDIScreenShareEnabled 选择DWORD值：
|
配置VDI插件通知
默认情况下，如果用户的Citrix或VMware客户端连接到没有VDI插件的HVD，系统会通知用户。此时将显示通知，通知他们安装VDI插件，以便启用优化的VDI模式。如果需要，用户可以关闭提醒。
此外，如果Webex应用程序VDI插件的版本与HVD上的Webex应用程序不兼容，将弹出窗口通知用户升级Webex应用程序VDI插件。提醒每周显示一次，直到用户采取行动为止。用户也可以驳回此通知。
作为管理员，您可以在组织范围内启用或禁用这些通知。
开始之前
您可以在安装VDI插件之前或之后修改注册表项。
对Windows注册表进行更改时应非常谨慎。我们建议您在使用这些步骤之前备份注册表。
| 1 |
在Windows搜索或“运行”窗口中，输入 regedit ，然后按 Enter键 |
| 2 |
转至 KEY__ \ \Cisco Spark Native\。 |
| 3 |
为 VDIPluginNotificationEnabled 选择DWORD（32位）注册键值：
|
禁用VDI版本兼容性检查
默认情况下，HVD上的Webex应用程序会检查与瘦客户端上的Webex VDI插件的版本兼容性。插件版本不应超过Webex应用程序后面的4个两个月发行版。例如，如果HVD上的Webex应用程序版本为43.8（2023年8月），则以下插件版本兼容：
-
43.8 (N) 2023年8月
-
43.6 (N-1) 2023年6月
-
43.4 (N-2) 2023年4月
-
43.2 (N-3) 2023年2月
-
42.12 (N-4) 2022年12月
在升级托管虚拟桌面后，此兼容性最多可让您在6个月内升级瘦客户端插件。
如果Webex VDI插件与HVD上的Webex应用程序不兼容，则Webex应用程序进入回退模式。用户会看到升级插件的弹出通知。提醒每周显示一次，直到用户采取行动为止。
您可以使用HVD上的注册表来控制版本兼容性检查：
我们建议您在使用这些步骤之前备份注册表。
-
在Windows运行窗口中，输入
项，然后按Enter键。 -
转至
KEY__ \ \Cisco Spark Native\。 -
创建名为
VDIDisableCompatibilityVersionCheck的DWORD（32位）注册表项，并为其提供下列值之一：0-启用版本兼容性检查（默认）。1-禁用版本兼容性检查。
振铃器和警报设置不适用于所有设备
在Linux VDI客户端上，传入呼叫的铃声不会在所有设备（包括瘦客户端上的扬声器）振铃，即使在HVD主机上的Webex应用程序中选择了该选项。只有HVD上选择的音频设备才会播放铃声。
出现此问题的原因可能是Citrix或VMware上的音频设备映射。
在HVD环境中检查注册表项 DIDisablePlaytoneOnLinuxTCEnabled 。如果Linux瘦客户端用户观察到此回铃音问题，请将此键的值设置为 1。
Webex 应用程序中的诊断
Webex应用程序（桌面和VDI）中提供的诊断功能可帮助您和您的用户解决连接问题、检查媒体质量并收集重要的故障诊断信息。
在Webex应用程序(Unified CM)中设置呼叫功能时，您可能会遇到与连接或所需设置（例如语音域和UC服务）相关的问题。使用此工具，您可以诊断哪些服务配置正确，哪些服务缺失。无论您是迁移到Webex应用程序中的呼叫(Unified CM)还是设置新用户，此功能都可用于故障排除场景和减少支持案例。
当用户体验出现问题时，他们可以 诊断视图并导出数据 ，以便与您共享或支持人员。
-
Unified CM设置—电话服务正常工作的关键设置（适用于Jabber迁移以及新用户设置），例如：
-
Unified CM 版本
-
UC服务域
-
SSO
-
语音邮件等UC服务
-
用于MRA的Expressway
-
-
媒体质量 -视频、音频和双向共享的质量
-
设备 -当用户连接到设备时的设备信息
有关显示诊断窗口的快捷键，请参阅键盘和导航快捷键。
浏览器内容重定向
浏览器内容重定向(BCR)是VDI环境的一种优化，可减少虚拟机上的负载。
在虚拟桌面上启用BCR后，Webex应用程序无法通过远程屏幕共享、应用程序共享或屏幕部分共享来共享浏览器内容。
Webex用户可以使用本地屏幕共享来共享浏览器。
