安装和配置

使用以下顺序设置 Workspace Environment Management (WEM) 服务部署。开始部署之前,请检查整个过程,这样您会知晓预期结果。提供指向产品文档和视频的链接。

如果您不熟悉 WEM 服务部署中使用的组件和术语,请参阅 Workspace Environment Management 服务

入门

先注册 Citrix 帐户并申请 WEM 服务试用。

设置资源位置并安装云连接器

资源位置包含基础架构服务器(例如 Active Directory 和 Citrix Cloud Connector)以及向用户交付应用程序和桌面的计算机。

在安装 WEM 代理之前,必须设置资源位置并在每个位置中至少安装一个 Citrix Cloud Connector。为实现高可用性,Citrix 建议您在每个资源位置安装两个云连接器。

请参阅 资源位置Cloud Connector 安装

安装和配置 WEM 代理

注意:

要从管理控制台访问作为应用程序快捷方式在 Citrix Workspace 中发布的资源,请确保在代理主机上安装了适用于 Windows 的 Citrix Workspace 应用程序。有关详细信息,请参阅系统要求

步骤 1:将代理主机加入 AD

代理主机必须与配置的云连接器属于相同的 AD 域。确保每个资源位置中的代理主机都已正确加入。

步骤 2:下载代理

从 WEM 服务下载选项卡下 WEM 代理程序包 (Citrix-Workspace-Environment-Management-Agent-Setup.zip ),然后在每个代理主机上保存副本。

步骤 3:配置组策略(可选)

或者,您可以选择配置组策略。WEM Agent 软件包中提供的代理组策略管理模板添加了代理主机配置策略。

  1. 将 WEM 安装包提供的代理组策略文件夹复制到您的 WEM 域控制器。

  2. 添加 .admx 文件。

    1. 转到代理组策略 > ADMX 文件夹。
    2. 复制这两个文件(Citrix Workspace Environment Management Agent Host Configuration.admxxCitrixBase.admx)。
    3. 转到 <C:\Windows>\PolicyDefinitions 文件夹,然后粘贴文件。
  3. 添加 .adml 文件。

    1. 转到 代理组策略 > ADMX > en-US 文件夹。
    2. 复制这两个文件(Citrix Workspace Environment Management Agent Host Configuration.admlCitrixBase.adml)。
    3. 转到 <C:\Windows>\PolicyDefinitions\en-US 文件夹,然后粘贴文件。
  4. 在组策略管理编辑器窗口中,转到 计算机配置 > 策略 > 管理模板 > Citrix 组件 > Workspace Environment Management > 代理主机配置 ,然后配置以下设置:

    组策略管理编辑器

代理代理配置。WEM 代理依赖互联网连接来连接到 Citrix Cloud 中的 WEM 服务。代理与服务之间的通信有以下目的:

  • 将统计信息和状态上传到 WEM 服务
  • 使代理缓存与 WEM 服务数据库保持同步
  • 检索代理设置和特定于座席配置集的 WEM 设置

或者,您可以选择配置 HTTPS 代理以定义代理与服务通信的方式。为此,请双击 Agent 代理配置 策略,然后键入代理服务器地址。例如,http://10.108.125.51:8080

注意:

WEM 服务不支持要求身份验证的代理服务器。

代理服务端口。WEM 服务不需要。保留状态“未配置”。

缓存的数据同步端口。WEM 服务不需要。保留状态“未配置”。

Citrix Cloud Connector。至少配置一个 Citrix Cloud Connector。代理主机必须与配置的 Cloud Connector 计算机位于同一 AD 域中。

通过CVAD 服务发现 Citrix Cloud Connector。用于控制代理程序是否从相关 Citrix Virtual Apps and Desktops (CVAD) 服务部署中发现 Cloud Connector 信息(如果尚未为代理配置云连接器)。然后代理连接到相应的 Cloud Connector 计算机。

注意:

  • 此设置专为 WEM 代理在 CVAD 服务部署中运行的情况而设计。
  • 如果在代理安装期间配置了云连接器或启用了 Citrix Cloud Connector 策略设置,则此策略设置将不起作用。

基础结构服务器。WEM 服务不需要。保留状态“未配置”。

VuemappCMD 额外的同步延迟。指定在启动 Citrix Virtual Apps and Desktops 发布的资源之前,代理应用程序启动器 (VUEMAppCmd.exe) 等待的时间(以毫秒为单位)。这可确保首先完成必要的代理工作。建议的值为 100 到 200。默认值为 0。

步骤 4:安装代理

重要:

虽然 .NET Framework 可以在代理安装期间自动安装,但我们建议您在安装代理之前手动安装它。否则,您需要重新启动计算机才能继续代理安装,并且可能需要很长时间才能完成。

代理下载中提供了客户端安装程序 Citrix Workspace Environment Management 代理。您可以选择以交互方式安装代理,也可以使用命令行安装代理。默认情况下,代理安装到以下文件夹之一,具体取决于您的操作系统 (OS):

  • C:\Program Files (x86)\Citrix\Workspace Environment Management Agent(在 64 位操作系统中)
  • C:\Program Files\ Citrix\Workspace Environment Management Agent(在 32 位操作系统中)

要以交互方式安装代理,请完成以下步骤:

  1. 在计算机上运行 Citrix Workspace Environment Management Agent.exe
  2. 选择 “我同意许可条款和条件”,然后单击 “ 安装”。
  3. 在欢迎页面上,单击 下一步

    注意:

    “欢迎”页面可能需要一些时间才能显示。当所需软件丢失并且正在后台安装时,会发生这种情况。

  4. 在目标文件夹页面上,单击 下一步

    • 默认情况下,目标文件夹字段会自动填充默认文件夹路径。如果要将代理安装到另一个文件夹,请单击更改以导航到该文件夹,然后单击下一步
    • 如果已安装 WEM 代理,则目标文件夹字段将自动填充现有安装文件夹路径。
  5. 在部署类型页面上,选择适用的部署类型,然后单击 下一步。在这种情况下,请选择 云服务部署

    WEM 代理安装 01

  6. 在云服务配置页面上,指定代理连接到的 Citrix Cloud 连接器,然后单击 下一步

    • 跳过配置。如果您已经使用组策略配置了设置,请选择此选项。
    • 配置 Citrix Cloud 连接器。允许您通过键入以逗号分隔的云连接器的 FQDN 或 IP 地址列表来配置 Citrix Cloud Connector。

    注意:

    -  键入每个 Citrix Cloud Connector 的 FQDN 或 IP 地址。确保用逗号 (,) 分隔 FQDN 或 IP 地址。
    
    • 在配置了多个 Cloud Connector 的情况下,WEM 代理会从列表中随机选择一个可访问的云连接器。此设计旨在将流量分配到所有云连接器。

    WEM 代理安装 02

  7. 在 “高级设置” 页面上,为代理配置高级设置,然后单击 “ 下一步”。

    • 备用缓存位置(可选)。用于指定代理缓存的替代位置。单击 浏览 以导航到适用的文件夹。
    • VUEMAppCmd 额外同步延迟(可选)。允许您指定代理应用程序启动器 (VUEMAppCmd.exe) 在发布的资源启动之前等待多长时间。这可确保首先完成必要的代理工作。默认值为 0。

    注意:

    为额外的同步延迟间隔键入的值必须是大于或等于零的整数。

    WEM 代理安装 03

  8. 在 “准备安装” 页面上,单击 “ 安装”。
  9. 单击 “ 完成 ” 退出安装向导。

或者,也可以使用命令行选择 WEM 代理的静默安装。若要执行此操作,请使用以下命令行:

  • Citrix Workspace Environment Management Agent.exe /quiet Cloud=1

您还可以使用命令行选项来指定自定义参数。这样可以在安装过程中自定义代理和系统设置。有关更多信息,请参阅须知

安装后,代理作为以下服务运行: Citrix WEM 代理主机服务Citrix WEM 代理用户登录服务。代理作为账户 LocalSystem运行。不支持更改此帐户。代理服务需要“以本地系统身份登录”权限。

步骤 5:重新启动计算机以完成安装

下一步的去向

如果要将现有的本地 WEM 数据库迁移到 WEM 服务中,请参阅 迁移

要直接开始使用 WEM 服务,请启动管理控制台并根据需要在其中配置设置。请参阅 管理

先决条件和建议

要确保 WEM 代理正常工作,请注意以下先决条件和建议:

必备条件

验证是否满足以下要求:

  • Windows 服务 系统事件通知服务 配置为在启动时自动启动。

  • WEM 代理服务 Citrix WEM 代理主机服务Citrix WEM 用户登录服务 配置为在启动时自动启动。

  • 代理缓存尽可能驻留在持久的位置。使用非持久性缓存位置可能会导致潜在的缓存同步问题、过多的网络数据使用、性能问题等。

  • 如果代理缓存位于非持久性位置,请在密封基础映像之前执行以下步骤:

    1. 停止 Citrix WEM Agent Host Service。
    2. 删除以下代理本地数据库文件: LocalAgentCache.dbLocalAgentDatabase.db

建议

请按照本节中的建议进行成功的代理部署:

  • 例如,请勿使用登录或启动脚本手动操作 Citrix WEM Agent 主机服务。诸如停止或重新启动 Citrix WEM Agent 主机服务 之类的操作可能会停止 Netlogon 服务的工作,从而导致其他应用程序出现问题。

  • 不要使用登录脚本启动 UI 模式或 CMD 模式代理。否则,某些功能可能无法正常工作。

代理启动行为

  • Citrix WEM Agent 主机服务在服务 启动后自动重新加载通过组策略配置的 Cloud Connector 设置。

  • 如果代理主机服务在首次登录期间未启动,Citrix WEM 代理用户登录服务将自动启动 Citrix WEM Agent Host Service。此行为可确保正确处理用户配置。

  • Citrix WEM Agent Host Service 在启动时自动对以下本地数据库文件执行检查:LocalAgentDatabase.dbLocalAgentDatabase.db。如果已置备虚拟机并且本地数据库文件来自基础映像,则会自动清除数据库文件。

  • Citrix WEM Agent Host Service 启动时,它会自动验证代理本地缓存最近是否已更新。如果高速缓存在超过两个配置的缓存同步时间间隔内更新缓存,则会立即同步高速缓存。例如,假设默认代理缓存同步间隔为 30 分钟。如果在过去 60 分钟内未更新缓存,则会在 Citrix WEM Agent Host Service 启动后立即同步缓存。

  • 在安装过程中,WEM 代理安装程序会将 Windows 服务 系统事件通知服务 配置为自动启动。

  • WEM 代理升级完成后,WEM 代理安装程序会自动启动 Netlogon 服务。

代理缓存实用程序选项

Citrix WEM Agent Host Service 会自动处理设置刷新和缓存同步。仅在需要立即刷新设置并同步缓存的情况下才使用代理缓存实用程序。

使用命令行在代理安装文件夹中运行 AgentCacheUtility.exe 。可执行文件接受以下命令行参数:

  • -help:显示允许的参数列表。
  • -RefreshCache 或者 -r:触发缓存构建或刷新。
  • -RefreshSettings 或者 -S:刷新代理主机设置。
  • -Reinitialize 或者 -I:与 -RefreshCache 选项一起使用时,重新初始化代理缓存。

有关如何使用命令行的详细信息,请参阅以下示例:

  • 刷新代理主机设置:
    • AgentCacheUtility.exe -RefreshSettings
  • 同时刷新代理主机设置和代理缓存:
    • AgentCacheUtility.exe -RefreshSettings -RefreshCache
  • 重新初始化代理缓存:
    • AgentCacheUtility.exe -RefreshCache -Reinitialize

须知

代理可执行文件接受自定义参数,如下所述。

代理设置

有关 WEM 代理设置,请参阅下面的内容。

  • AgentLocation。用于指定代理安装位置。指定有效的文件夹路径。

  • 云连接器列表。用于指定每个 Citrix Cloud Connector 的 FQDN 或 IP 地址。确保用逗号 (,) 分隔 FQDN 或 IP 地址。

  • VUEMAppCmdDelay。允许您指定代理应用程序启动器 (VUEMAppCmd.exe) 在 Citrix Virtual Apps and Desktops 发布的资源启动之前等待的时间。默认值为 0(毫秒)。为额外的同步延迟间隔键入的值必须是大于或等于零的整数。

  • AgentCacheLocation。用于指定代理缓存的替代位置。如果配置,代理本地缓存文件将保存在指定位置,而不是在代理安装文件夹中。

请注意以下事项:

  • 如果通过命令行配置设置,则 WEM 代理安装程序将使用配置的设置。

  • 如果设置未通过命令行配置,并且存在先前配置的设置,则安装程序将使用之前配置的设置。

  • 如果设置未通过命令行配置,并且没有先前配置的设置,则安装程序将使用默认设置。

系统设置

有关与代理主机关联的系统设置,请参阅下文。

  • GpNetworkStartTimeoutPolicyValue。允许您配置在安装过程中创建的 GpNetworkStartTimeoutPolicyValue 注册表项的值(以秒为单位)。此参数指定组策略在登录时的策略处理期间等待网络可用性通知的时间。参数接受范围为 1(最小值)到 600(最大值)的任何整数。默认情况下,此值为 120。

  • SyncForegroundPolicy。允许您在代理安装期间配置 SyncForegroundPolicy 注册表值。此策略设置确定组策略处理是否同步。可接受的值:0,1。如果未设置该值或将值设置为 0,则 Citrix WEM 代理用户登录服务不会延迟登录,并在后台处理用户组策略设置。如果将该值设置为 1,Citrix WEM 代理用户登录服务将延迟登录,直到用户组策略设置的处理完成为止。默认情况下,该值在安装过程中不会更改。

    重要:

    如果在后台处理组策略设置,则 Windows 命令行管理程序 (Windows 资源管理器) 可能会在处理所有策略设置之前启动。因此,某些设置可能不会在用户第一次登录时生效。如果希望在用户首次登录时处理所有策略设置,请将值设置为 1。

  • WaitForNetwork。允许您配置在安装过程中创建的 WaitForNetwork 注册表项的值(以秒为单位)。此参数指定代理主机等待网络完全初始化和可用的时间。参数接受 0(最小值)到 300(最大值)范围内的任何整数。默认情况下,此值为 30。

以上所有三个注册表项都是在 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon 下创建的。这些密钥用于确保用户环境在登录之前收到基础结构服务器地址 GPO。在 Active Directory 或域控制器服务器响应速度较慢的网络环境中,这可能会导致出现登录屏幕之前额外的处理时间。Citrix 建议您将 gpNetworkStarttimeOutPolicy Value 密钥的值 设置为至少 30 个,以使其产生影响。

  • ServicesPipeTimeout。允许您配置 ServicesPipeTimeout 注册表项的值。密钥是在安装过程中在 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control 下创建的。在允许服务控制管理器报告 WEM 代理服务的状态之前,此注册表项添加延迟。延迟可以防止代理服务在初始化网络之前启动,从而防止代理失败。此参数接受任何值,以毫秒为单位。如果未指定,则使用默认值 60000(60 秒)。

    注意:

    如果未使用命令行配置上述设置,则 WEM 代理安装程序在安装过程中不会处理这些设置。

示例

您还可以使用以下命令行格式配置设置:

  • "Citrix Workspace Environment Management Agent.exe" <key=value>

例如:

  • 指定代理安装位置和 Citrix Cloud Connector
    • "Citrix Workspace Environment Management Agent.exe" /quiet AgentLocation="L:\WEM Agent" Cloud=1 CloudConnectorList=cc1.qa.local,cc2.qa.local
  • 将“用户登录网络等待时间”设置为 60 秒
    • "Citrix Workspace Environment Management Agent.exe" WaitForNetwork=60
安装和配置