基础架构服务

安装基础架构服务

• .\Citrix Workspace Environment Management 基础设施服务.exe /quiet BrokerLocation="C:\test\Infrastructure Services" /log "C:\test\test.log"
• /quiet BrokerLocation="C:\test\Infrastructure Services" /log "C:\test\test.log"
  • /quiet。表示静默模式。
  • /log。表示日志文件位置。
  • BrokerLocation。表示基础架构服务的安装路径。

创建服务主体名称

• 如果您不使用 Windows 身份验证或负载均衡，请使用以下命令：
  • setspn -C -S [SPN name] [hostname]
  其中 hostname 是基础架构服务器的名称。
• 如果您使用 Windows 身份验证或负载均衡（需要 Windows 身份验证），请使用以下命令：
  • setspn -U -S [SPN name] [accountname]
  其中 accountname 是用于 Windows 身份验证的服务帐户的名称。
• [SPN name] 的默认值为 Norskale/BrokerService。如果同一林中有多个 WEM 部署，您可能需要通过添加以下注册表值来配置多个 SPN：
  • setspn -C -S [SPN name] [hostname] 或 setspns -U -S [SPN name] [accountname]
  • 对于代理计算机： HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Agent Host
  • 对于基础架构和控制台计算机： HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Infrastructure Services
  • 名称：AlternativeSPN
  • 类型：REG_SZ
  • 值： 的实际值

组托管服务帐户

1. 如果您已有现有的 gMSA，请执行以下操作：
   1. 使用以下命令将 Citrix WEM SPN 与帐户绑定：
      • setspn -C -S Norskale/BrokerService [gMSA]$
      其中 gMSA 是 gMSA 帐户的名称。
   2. 使用以下命令将相关计算机添加到帐户：
      • Set-ADServiceAccount -Identity [gMSA] -PrincipalsAllowedToRetrieveManagedPassword [hostname]
      其中 是基础架构服务器的名称。
2. 如果您没有 gMSA，请转到您的域控制器，创建一个，然后将 Citrix WEM SPN 与其绑定。使用以下命令：
   • New-ADServiceAccount [gMSA] -DNSHostName [hostname 1] -PrincipalsAllowedToRetrieveManagedPassword [hostname 2], [hostname 3] -KerberosEncryptionType RC4, AES128, AES256 -ServicePrincipalNames Norskale/BrokerService
   其中 是 DNS 服务器的名称。
   其中 、 是基础架构服务器的名称。
   有关创建 gMSA 的更多信息，请参阅 <https://docs.microsoft.com/zh-cn/windows-server/security/group-managed-service-accounts/getting-started-with-group-managed-service-accounts>。
3. 手动配置 gMSA。
   1. 启用帐户以访问数据库。
      1. 在主 SQL Server 上，导航到 Security > Logins，右键单击 Logins，然后选择 New Login。
      2. 在 Login - New window 中，单击 Search。
      3. 在 Select User or Group 窗口中，按如下所示配置设置，然后单击 OK 退出窗口。
         • 对象类型。仅选择服务帐户。
         • 位置。选择托管服务帐户。
         • 对象名称。键入您在步骤 1 中创建的帐户名称。
      4. 在用户映射页面上，选择要应用 gMSA 的数据库，然后选择 db-owner 作为该数据库的角色成员身份。
      5. 在状态页面上，验证是否已选择授予和启用选项。
      6. 单击确定退出登录 - 新建窗口。
   2. 使用您添加的服务帐户启动 Citrix WEM 基础架构服务。
      1. 在您的基础架构服务器上，打开 Windows 服务管理器，右键单击 Citrix WEM 基础架构服务，然后选择属性。
      2. 在登录页面上，选择此帐户，单击浏览，并按照步骤 3 的第三个子步骤中所述配置设置。
      3. 单击确定退出Citrix WEM 基础架构服务属性窗口。
      4. 在 Windows 服务管理器中，重新启动 Citrix WEM 基础架构服务。
      注意：
      或者，您可以使用 WEM GUI 配置帐户。请参阅创建 WEM 数据库和配置基础架构服务。

配置负载平衡

1. 为 WEM 基础设施服务创建一个 Windows 基础设施服务帐户，以便连接到 WEM 数据库。
2. 创建 WEM 数据库时，选择“使用 Windows 身份验证进行基础设施服务数据库连接”选项并指定基础设施服务帐户名称。有关详细信息，请参阅创建 Workspace Environment Management 数据库。
3. 将每个基础设施服务配置为使用 Windows 身份验证而不是 SQL 身份验证连接到 SQL 数据库：选择“启用 Windows 帐户模拟”选项并提供基础设施服务帐户凭据。有关详细信息，请参阅配置基础设施服务。
4. 配置 WEM 基础设施服务的 SPN 以使用基础设施服务帐户名称。有关详细信息，请参阅创建服务主体名称。
   重要提示：
   在部署 WEM 环境之前，决定是使用服务帐户还是计算机帐户。WEM 环境部署后，您无法切换回来。例如，如果您在使用计算机帐户后想要对传入请求进行负载平衡，则必须使用计算机帐户而不是服务帐户。

5. 创建一个虚拟 IP 地址 (VIP)，该地址涵盖您希望置于 VIP 后面的基础设施服务器数量。当代理连接到 VIP 时，VIP 涵盖的所有基础设施服务器都符合条件。
6. 配置代理主机配置 GPO 时，将基础设施服务器设置设为 VIP，而不是任何单个基础设施服务器的地址。有关详细信息，请参阅安装和配置代理。
7. 管理控制台与基础设施服务之间的连接需要会话持久性。（代理与基础设施服务之间的会话持久性不是必需的。）我们建议您将每个管理控制台直接连接到基础设施服务服务器，而不是使用 VIP。

创建工作区环境管理数据库

1. 如果数据库管理实用程序尚未打开，请从“开始”菜单中选择“Citrix>Workspace Environment Management>WEM Database Management Utility”。
   
2. 点击 创建数据库，然后点击 下一步。
   
3. 键入以下数据库信息，然后点击 下一步：
   • 服务器和实例名称。数据库将托管在哪个 SQL Server 上的地址。基础架构服务器必须能够完全按照键入的方式访问此地址。将服务器和实例名称键入为计算机名称、完全限定域名或 IP 地址。将完整实例地址指定为 serveraddress,port\\instancename。如果未指定端口，则使用默认 SQL 端口号 (1433)。
   • 数据库名称。要创建的 SQL 数据库的名称。
   注意：
   连字符 (-) 和斜杠 (/) 等特殊字符不允许在数据库名称中使用。
   • 数据文件：SQL Server 上 .mdf 文件位置的路径。
   • 日志文件：SQL Server 上 .ldf 文件位置的路径。
   注意：
   数据库管理实用程序无法查询 SQL Server 以获取数据和日志文件的默认位置。它们默认为 MS SQL Server 默认安装的默认值。请确保这两个字段中的值与您的 MS SQL Server 安装正确匹配，否则数据库创建过程将失败。
   
4. 提供向导可用于创建数据库的数据库服务器凭据，然后点击 下一步。这些凭据独立于基础架构服务在数据库创建后用于连接数据库的凭据。它们不会被存储。
   默认情况下，选择“使用集成连接”选项。它允许向导使用其运行身份的 Windows 帐户连接到 SQL 并创建数据库。如果此 Windows 帐户没有足够的权限来创建数据库，您可以将数据库管理实用程序作为具有足够权限的 Windows 帐户运行，或者您可以清除此选项并提供具有足够权限的 SQL 帐户。
   
5. 输入 VUEM 管理员和数据库安全详细信息，然后点击 下一步。您在此处提供的凭据将由基础架构服务在数据库创建后用于连接数据库。它们存储在数据库中。
   • 初始管理员组。此用户组预配置为管理控制台的完全访问管理员。只有配置为 Workspace Environment Management 管理员的用户才允许使用管理控制台。指定一个有效的用户组，否则您将无法自行使用管理控制台。
   • 使用 Windows 身份验证进行基础结构服务数据库连接。清除此选项（默认设置）时，数据库会要求基础结构服务使用 vuemUser SQL 用户帐户连接到数据库。vuemUser SQL 用户帐户由安装过程创建。这要求为 SQL 实例启用混合模式身份验证。
   选中此选项时，数据库会要求基础结构服务使用 Windows 帐户连接到数据库。在这种情况下，您选择的 Windows 帐户不得已在 SQL 实例上拥有登录名。换句话说，您不能使用创建数据库时所用的 Windows 帐户来运行基础结构服务。
   要选择 gMSA，请按照选择 AD 用户的相同步骤操作。
   • 设置 vuemUser SQL 用户帐户密码。默认情况下，vuemUser SQL 帐户创建时会使用一个 8 个字符的密码，该密码包含大小写字母、数字和标点符号。如果您想输入自己的 vuemUser SQL 帐户密码（例如，如果您的 SQL 策略要求更复杂的密码），请选择此选项。
   重要提示：
   • 如果您打算在 SQL Server Always On 可用性组中部署 Workspace Environment Management 数据库，则必须设置 vuemUser SQL 用户帐户密码。
   • 如果在此处设置密码，请记住在配置基础结构服务时指定相同的密码。

6. 在摘要窗格中，查看您选择的设置，确认无误后单击创建数据库。
7. 当您收到数据库创建成功通知时，单击完成退出向导。
   如果在数据库创建过程中发生错误，请检查基础结构服务安装目录中的日志文件“Citrix WEM Database Management Utility Debug Log.log”。

配置基础结构服务

1. 从开始菜单中选择 Citrix > 工作区环境管理 > WEM 基础架构服务配置实用程序。
2. 在数据库设置选项卡中输入以下详细信息：
   • 数据库服务器和实例。托管 Workspace Environment Management 数据库的 SQL Server 实例的地址。必须能够从基础结构服务器按键入内容准确访问此地址。将完整实例地址指定为“serveraddress, port\\instancename”。如果未指定端口，则使用默认 SQL 端口号 (1433)。
   • 数据库故障转移服务器和实例。如果您正在使用数据库镜像，请在此处指定故障转移服务器地址。
   • 数据库名称。SQL 实例上 Workspace Environment Management 数据库的名称。
   
3. 在网络设置选项卡中，键入基础架构服务使用的端口：
   • 管理端口。此端口由管理控制台用于连接到基础架构服务。
   • 代理服务端口。此端口由您的代理主机用于连接到基础架构服务。
   • 缓存同步端口。此端口由代理服务用于将其缓存与基础架构服务同步。
   • WEM 监视端口。
   
4. 在高级设置选项卡中，输入模拟和自动刷新设置。
   • 启用 Windows 帐户模拟。默认情况下，此选项处于未选中状态，基础架构服务使用混合模式身份验证连接到数据库（使用在数据库创建期间创建的 SQL 帐户 vuemUser）。如果您在数据库创建期间选择了 Windows 基础架构服务帐户，则必须选择此选项并指定相同的 Windows 帐户，以便基础架构服务在连接期间进行模拟。您选择的帐户必须是基础架构服务器上的本地管理员。
     要选择 gMSA，请遵循与选择 AD 用户相同的步骤。
   • 设置 vuemUser SQL 用户帐户密码。允许您通知基础架构服务在数据库创建期间为 vuemUser SQL 用户配置的自定义密码。仅当您在数据库创建期间提供了自己的密码时才启用此选项。
   • 基础架构服务缓存刷新延迟。基础架构服务刷新其缓存之前的时间（以分钟为单位）。如果基础架构服务无法连接到 SQL，则使用缓存。
   • 基础架构服务 SQL 状态监视延迟。基础架构服务每次尝试轮询 SQL 服务器之间的时间（以秒为单位）。
   • 基础架构服务 SQL 连接超时。基础架构服务在尝试与 SQL 服务器建立连接时等待的时间（以秒为单位），超过此时间将终止尝试并生成错误。
   • 启用调试模式。如果启用，基础架构服务将设置为详细日志记录模式。
   • 即使在线也使用缓存。如果启用，基础架构服务将始终从其缓存中读取站点设置。
   • 启用性能优化。允许您优化连接代理数量超过特定阈值（默认为 200）的场景中的性能。因此，代理或管理控制台连接到基础架构服务所需的时间更短。
     • 最小工作线程数。指定线程池按需创建的最小工作线程数。将工作线程数设置为 30-3000 之间。根据连接代理的数量确定该值。默认情况下，最小工作线程数为 200。
     • 最小异步 I/O 线程数。指定线程池按需创建的最小异步 I/O 线程数。将异步 I/O 线程数设置为 30-3000 之间。根据连接代理的数量确定该值。默认情况下，最小异步 I/O 线程数为 200。
   重要提示：
   当代理或管理控制台间歇性地与基础架构服务断开连接时，此功能特别有用。
   注意：
   您在“启用性能优化”字段中设置的值将在发出新请求时以及在切换到用于管理线程创建和销毁的算法之前使用。有关详细信息，请参阅 <https://docs.microsoft.com/zh-cn/dotnet/api/system.threading.threadpool.setminthreads?view=netframework-4.8> 和 <https://support.microsoft.com/en-sg/help/2538826/wcf-service-may-scale-up-slowly-under-load>。
   • 使用 Google Analytics 帮助改进 Workspace Environment Management。如果选中，基础架构服务会将匿名分析数据发送到 Google Analytics 服务器。
   • 不使用 Google Analytics 帮助改进 Workspace Environment Management。如果选中，基础架构服务不会将匿名分析数据发送到 Google Analytics 服务器。
   重要提示：
   从 2212 版本开始，Workspace Environment Management 会根据托管基础架构服务的计算机所在的区域确定要选择的选项。如果计算机位于非欧洲地区，则选择第一个选项。如果计算机位于欧洲地区，则选择第二个选项。此行为仅适用于全新安装。
   
5. 您可以使用“数据库维护”选项卡配置数据库维护。
   • 启用计划的数据库维护。如果启用，此设置会定期从数据库中删除旧的统计记录。
   • 统计信息保留期。确定用户和代理统计信息的保留时间。默认值为 365 天。
   • 系统监控保留期。确定系统优化统计信息的保留时长。默认值为 90 天。
   • 代理注册保留期。确定代理注册日志在数据库中的保留时长。默认值为 1 天。
   • 执行时间。确定执行数据库维护操作的时间。默认值为 02:00。
   提示
   作为最佳实践，我们建议您启用计划的数据库维护，以减小数据库大小并实现最佳性能。如果单个 WEM 部署中存在多个基础架构服务，则仅为一个基础架构服务启用它。
   
6. 您可以选择使用许可选项卡在基础架构服务配置期间指定 Citrix 许可证服务器。如果未指定，则当管理控制台首次连接到新的 Workspace Environment Management 数据库时，您必须在管理控制台功能区的关于选项卡中输入 Citrix 许可证服务器凭据。在这两种情况下，Citrix 许可证服务器信息都存储在数据库中的相同位置。
   • 全局许可证服务器覆盖。启用此选项可键入 Workspace Environment Management 使用的 Citrix 许可证服务器的名称。您在此处键入的信息将覆盖 Workspace Environment Management 数据库中已有的任何 Citrix 许可证服务器信息。