解决 WEM LAS 问题

Last published : Nov 13, 2026
本文可帮助您诊断和解决 Workspace Environment Management™ (WEM) 中的 Citrix® 许可激活服务 (LAS) 相关问题。有关设置许可的更多信息,请参阅 设置许可。
如果您遇到 LAS 许可问题,请首先检查 Citrix Cloud™ 中的许可证服务器状态。如果状态不是绿色,请查看激活详细信息以帮助确定原因。
  1. 使用您的帐户登录到 Citrix Cloud。
  2. 转到 许可 > 许可部署 > 许可证服务器。
  3. 展开 Workspace Environment Management 以查看激活列表:
    • ID:计算机 SID
    • 许可证服务器连接:已连接 或 连接丢失
    • 上次成功连接:最近一次成功连接的时间
      许可证服务器状态
  4. 单击 ... > 查看详细信息 以查看某个激活的详细信息:
    • 产品和版本:使用 LAS 激活时使用的 Product_Edition_Model 和 BurnInDate。BurnInDate 通常是产品发布日期。
    • WEM 部署:部署 ID
    • WEM 实例:计算机 SID
    • 主机 ID:计算机 SID
    • LasUniqueEnvID:LAS 提供激活的实例的唯一 ID
      许可服务器激活(/en-us/workspace-environment-management/current-release/media/las-ls-activation.png)

检查与许可服务器的连接

在 WEM 调用 LAS SDK 之前,WEM 基础架构服务会向以下端点发送 POST 请求:
https://{licenseServerAddress}:{lasLicenseServerPort}/lic_admin/lasentitlements
https://{licenseServerAddress}:{lasLicenseServerPort}/ls_server/serverinfo
其中:
  • licenseServerAddress 是 Citrix 许可服务器的地址。
  • lasLicenseServerPort 是 LAS 服务使用的端口(默认值:8083)。
如果任一 URL 被阻止或无法访问,则 Citrix WEM Infrastructure Service Debug.log 中会出现以下错误:
<CheckLasEnabled>d__27.MoveNext() : Error sending POST request: A task was canceled.
确保 WEM 基础架构服务器可以在没有网络或防火墙限制的情况下访问这两个 URL。

测试连接

从 WEM 基础架构服务器运行以下命令,以验证其是否可以访问许可服务器。将 <licenseServer> 替换为您的许可服务器地址。
  1. 检查 LAS 端口是否可访问:
    Test-NetConnection <licenseServer> -Port 8083
    TcpTestSucceeded : True 确认端口已打开。
  2. 检查 LAS 端点是否响应:
    curl.exe -k -X POST "https://<licenseServer>:8083/lic_admin/lasentitlements" -H "Content-Type: application/json" -d "{\"ver\":\"1.0\"}"
    curl.exe -k -X POST "https://<licenseServer>:8083/ls_server/serverinfo" -H "Content-Type: application/json" -d "{\"ver\":\"1.0\"}"
    注意:
    -k 选项绕过 TLS 证书验证,仅用于连接诊断。请勿在生产配置中使用它。
如果命令失败或超时,则 WEM 基础架构服务器无法访问该端点。请检查网络路径、防火墙规则和许可服务器地址。

解决许可证服务器证书问题

如果证书已过期、尚未生效或与许可证服务器名称不匹配,则证书验证可能会失败。

证书已过期或尚未生效

如果许可证服务器证书已过期或尚未生效,则 Citrix WEM Infrastructure Service Debug.log 中会出现以下错误之一:
LICENSING: license server certificate NOT valid, is expired, subject '{subject}', issuer '{issuer}'LICENSING: license server certificate NOT valid, used too soon, subject '{subject}', issuer '{issuer}'
解决方案:
  • 如果证书已过期,请续订。
  • 如果证书是新颁发的且尚未生效,请等到其有效期开始后再重试。

许可证服务器主机名不匹配

如果许可证服务器主机名与证书不匹配,则 Citrix WEM Infrastructure Service Debug.log 中会出现以下错误:
LICENSING: license server certificate NOT valid, hostname mismatch, subject '{subject}', issuer '{issuer}'
解决方案:
验证您指定的 Citrix 许可证服务器名称 是否与证书中定义的名称之一匹配。主机名必须与以下 任一 项匹配:
  • 证书的 Subject 字段。
  • 证书的 Subject Alternative Name (SAN) 扩展中列出的 DNS 名称。
如果主机名与这些条目中的任何一个都不匹配,请更新许可证服务器名称,或使用正确的 DNS 名称重新颁发证书。
配置实用程序中的许可证服务器名称(/en-us/workspace-environment-management/current-release/media/las-cert-hostname-config.png)
证书主题字段证书主题备用名称扩展

证书接受对话框未显示

如果许可证服务器证书不受信任,则应显示“接受安全证书”对话框,您必须手动接受证书才能继续。
接受安全证书对话框
WEM 从以下 URL 检索许可证和证书信息:
https://{licenseServerAddress}:{lasLicenseServerPort}/ls_server/serverinfo
如果此 URL 被阻止或无法访问,WEM 将无法检索许可证服务器信息,并且证书接受对话框不会显示。
解决方案:
确保 WEM 基础结构服务器可以在没有任何网络或防火墙限制的情况下访问上述 URL。

强制显示证书接受对话框

如果需要强制显示证书接受对话框,请按照配置方法对应的步骤操作。
如果您使用“WEM 基础结构服务配置实用程序”为特定的 WEM 基础结构服务器配置了许可证服务器,请执行以下操作:
  1. 删除 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Norskale\Infrastructure Services 下的注册表值 SpecificLasLicenseServerCertificateThumbprint。
  2. 重新打开“WEM 基础结构服务配置实用程序”。
  3. 再次单击“保存配置”。
    此操作会触发“接受安全证书”对话框,允许您手动接受许可证服务器证书。
如果您在 WEM 控制台中全局配置了许可证服务器:
  1. 清除数据库中 VUEMParameters 表中 GlobalLasLicenseServerCertificateThumbprint 的值。
  2. 在 WEM 控制台中重新配置许可证服务器。此操作会触发证书接受过程。
注意:
不正确地编辑注册表可能会导致严重问题,可能需要重新安装操作系统。修改注册表之前,请务必备份注册表。

收集详细的 LAS 日志

如果上述步骤无法解决问题,请启用跟踪级别日志记录并收集 LAS 客户端日志以供 Citrix 支持。在报告问题的组件上启用日志记录:
  • WEM 基础架构服务器,用于解决基础架构服务或旧版控制台的问题。
  • Web 控制台服务器,用于解决 Web 控制台的问题。
要启用日志记录,请按照以下步骤操作:
  1. 在受影响的服务器上,打开“注册表编辑器” (regedit.exe)。
  2. 导航到以下注册表项:
    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\WEM\Licensing
  3. 创建具有以下设置的“字符串值 (REG_SZ)”:
    • 名称:LasLicenseServerLogLevel
    • 值: Trace
  4. 重新启动服务以使更改生效:
    • 在 WEM 基础架构服务器上,重新启动 Citrix WEM Infrastructure Service。
    • 在 Web 控制台服务器上,重新启动 Citrix WEM Public API Service。
  5. 重现问题,然后收集 Citrix WEM LAS Client Log.log 文件并将其提供给 Citrix 支持。日志文件位于组件安装文件夹的 Licensing\Las 子文件夹中:
    • WEM infrastructure server:<Infrastructure Service installation folder>\Licensing\Las。默认情况下,安装文件夹为 C:\Program Files (x86)\Citrix\Workspace Environment Management Infrastructure Services。
    • On-premises web console 服务器:<Web Console installation folder>\Licensing\Las。默认情况下,安装文件夹为 C:\Program Files (x86)\Citrix\Workspace Environment Management Web Console。
注意:
错误地编辑注册表可能会导致严重问题,可能需要重新安装操作系统。更改注册表之前,请务必备份注册表。