许可命令

虽然 Citrix Licensing Manager 提供了访问许多许可功能的简单方法，但您也可以使用命令执行许可任务。在许可证服务器上执行在控制台中不可用的高级操作时，您可以使用许可证管理命令。此类操作包括使用 lmdiag 诊断签出问题。

许可证管理命令存储在：

• 32 位计算机上的 C:\Program Files\Citrix\Licensing\LS
• 64 位计算机上的 C:\Program Files (x86)\Citrix\Licensing\LS

许可命令的说明

注意：

在许可证服务器版本 11.16.6 内部版本 34000 中，现有用户管理 lmadmin.exe 已替换为 Citrix 拥有的用户管理 lmgrd.exe。请务必不要使用 lmadmin。

格式许可证命令

许可证管理命令的格式约定：

通用参数

大多数许可证管理命令的有效参数：

诊断签出问题 (lmdiag)

当产品无法签出许可证时，使用 lmdiag 命令可以诊断问题。特别是可以测试许可证是否有效和许可证服务器是否正在运行。运行此命令时，它会尝试签出许可证。

还可以使用 lmdiag 命令查看特定类型的许可证是否正在工作。

示例：

仅在 Citrix Virtual Apps 服务器 Advanced Edition 许可证上运行 lmdiag。指定 MPS_ADV_CCU 作为参数。

语法：

lmdiag -c license_file_list [-n] [feature[:keyword=value]]

如果未指定任何功能，lmdiag 将针对列表中的许可证文件中的所有功能运行。lmdiag 显示与许可证有关的信息，然后尝试签出每个许可证。签出成功后，lmdiag 将指示签出成功。签出失败时，lmdiag 将告知您失败的原因。lmdiag 命令尝试连接到许可证服务器上的每个 TCP/IP 端口。它将检测许可证文件中的端口号是否正确。lmdiag 会列出正在监听的每个 TCP/IP 端口号，并且如果指定了 -c license_file_list，则会诊断指定的文件。

尝试签出许可证时，lmdiag 命令不联系运行 Citrix 产品的计算机。lmdiag 命令仅指示许可证服务器上是否存在问题。即，由于产品指向错误的许可证服务器，因此产品无法签出许可证，但 lmdiag 不会检测此问题。例如，在其上没有该产品许可证的许可证服务器。Citrix 产品指向错误的许可证服务器时，lmdiag 命令会报告其可以签出许可证。

停止守护程序 (lmdown)

lmdown 命令可关闭您的许可证服务器上或您网络中的所有许可证服务器上的许可证管理器守护程序和 Citrix 供应商守护程序。默认情况下，lmdown 命令处于禁用状态。

语法：

lmdown -c license_file_list [-vendor CITRIX] [-q] [-all]

在许可证服务器上运行 lmdown 命令。可以使用 -all 关闭网络中的所有许可证服务器。

如果 lmdown 遇到多台服务器，但您未指定 -all 参数，此命令将显示要关闭的许可证服务器选择。例如，-c 参数指定一个包含许多 *.lic 文件的目录。可以通过使用 -c 并指定许可证服务器的名称来关闭远程许可证服务器。

注意：

如果使用任务管理器来终止许可证管理器守护程序 (Citrix Licensing Service),，请首先停止 lmgrd 进程，然后停止 Citrix 供应商守护程序进程。

要仅停止并重新启动 Citrix 供应商守护程序，请使用 lmdown -c @localhost -vendor CITRIX，然后使用 lmreread -c @localhost -vendor CITRIX 重新启动供应商守护程序。

检查许可证服务器绑定信息 (lmhostid)

lmhostid 命令退回许可证服务器的主机 ID。可以使用该命令查看许可证服务器的主机名。可以打开许可证文件并将该许可证文件中的主机名与您的许可证服务器的主机名进行比较。

注意

使用适用于 Windows 的 Citrix Licensing 版本 11.5 和更高版本可以显示多个主机 ID（如果存在多个主机）。

语法：

lmhostid -bindingidentifier

其中 bindingidentifier 为参数。

重读许可证和选项文件 (lmreread)

lmreread 命令会使 Citrix 供应商守护程序重读对许可证文件和选项文件的更改。重读后，Citrix 供应商守护程序将从此使用新的设置和许可证。

不能远程使用 lmreread；请在许可证服务器本地运行此命令。

语法：

lmreread -c license_file_list [-all] [-vendor CITRIX]

示例：

• lmreread -c @localhost \[-all\]
• lmreread -c @client\_access\_point\_name
• lmreread -c /opt/citrix/licensing/myfiles/CITRIX.lic -vendor CITRIX

显示 Licensing 实用程序列表 (lmutil)

lmutil 命令显示独立使用时的许可实用程序的列表。通过其他命令指定 lmutil 时，它会运行该命令。

语法：

lmutil

lmutil other_command

示例：

• lmutil

  显示所有 Licensing 实用程序。

• lmutil lmstat -c @localhost

  运行 lmstat 命令。

确定许可状态 (lmstat)

lmstat 命令可帮助您监视所有许可活动的状态，并向您提供有关许可证签出的信息，包括：

• 已签出一个或多个许可证的产品
• 签出数据
• 许可证文件的版本
• 许可证服务器名称和端口
• 签出许可证的日期
• 有关 Citrix 供应商守护程序状态和许可证文件的信息

lmstat 命令显示从许可证服务器接收的信息。lmstat 命令显示只有一个对象正在使用许可证，即使多个连接共享该许可证也是如此。

语法：

lmstat [-a] [-c license_file_list] [-f [feature]] [-i [feature] [-s[server] [-S [CITRIX]] [-t timeout_value]

lmstat -c @localhost -a 的输出与此示例类似。由于屏幕空间的限制，此示例中的行可能会换行。

License Server status: 27000@localhost

   License file(s) on localhost: C:\Program Files (x86)\Citrix\Licensing\MyFiles\citrix_startup.lic:C:\Program Files (x86)\Citrix\Licensing\MyFiles\License.lic:

   localhost: license server UP v11.15.0

   Vendor daemon status (on LicenseServer):

      CITRIX: UP v11.15.0

Feature usage info:

   Users of CITRIX: (Total of 10000 licenses issued; Total of 1 licenses in use)

   "CITRIX" v2038.0101, vendor: CITRIX, expiry: permanent(no expiration date)
vendor_string: ;LT=SYS;GP=720;SA=0
floating license

   XDT DDCPrinc-0001.citrix.com XDT XDT_PLT&MPS_PLT_2018.0518 (v1.0) (localhost/27000 102), start Tue 5/8 17:59

Users of CTXLSDIAG: (Total of 10000 licenses issued; Total of 0 licenses in use)

Users of XDT_PLT_CCS: (Total of 200000 licenses issued; Total of 3 licenses in use)

   "XDT_PLT_CCS" v2018.1201, vendor: CITRIX, expiry: 01-dec-2018
vendor_string: ;LT=Retail;GP=720;PSL=10;CL=VDS,VDA,VDE,VDP;SA=0;ODP=0;NUDURMIN=2880;NUDURMAX=525600
floating license

   XDT DDCAux-0001.citrix.com XDT 00001E3A (v2018.0518) (localhost/27000 534201), start Wed 5/9 15:17
   XDT DDCAux-0001.citrix.com XDT 00001E81 (v2018.0518) (localhost/27000 392504), start Wed 5/9 15:18
   XDT DDCAux-0001.citrix.com XDT 00001E0C (v2018.0518) (localhost/27000 419703), start Wed 5/9 15:18
<!--NeedCopy-->

以下各项代表 lmstat 输出的 MPS_ENT_CCU 行中所包含信息的细分：

lmstat -c @localhost -a 命令可能会在已签出许多产品许可证的系统中生成许多网络活动。

可以使用 lmstat -a 验证许可证签出数据。

显示二进制文件的版本 (lmver)

lmver 命令显示许可二进制的版本信息，如同命令实用程序一样。

语法：

lmver binary

示例：

lmver lmdiag

显示或释放用户或设备的许可证 (udadmin)

udadmin 可显示获得许可的用户和设备，并且能够释放指定用户和设备的许可证。

注意：

UDAdmin 工具仅用于报告用户/设备许可模式的许可证使用情况，不用于报告并发许可证的使用情况。

您仅可在以下情况下为用户释放许可证：

• 员工不再与公司关联。
• 员工长期休假。

只能在设备出现故障时释放设备的许可证。

小心：

在自动产生的 90 天租用期之前，除上文重点强调的原因外，大多数许可证版本可能都会违反 Citrix EULA。执行此操作之前，请联系 Citrix。

udadmin 命令行帮助仅以英文显示用法信息，但您可以在非英文系统中使用该命令。

语法：

udadmin [-options] [-delete | -events | -list | -times]

示例：

-  udadmin -list -times

    Usage data is 0 minutes old. Next update in 15 minutes.

    Users:

    u01.01 XDT_ENT_UD 2017.1201 (Thu Sep 14 13:41:07 2017)

    u01.04 XDT_ENT_UD 2017.1201 (Thu Sep 14 13:41:07 2017)
    .
    .
    .

    Devices:

    D.ADV.23 XDT_ADV_UD 2017.1201 (Thu Sep 21 18:31:01 2017)

    D01 XDT_PLT_UD 2017.1201 (Tue Sep 12 14:30:33 2017)

-  udadmin -list -a

    Lists all features, versions, counts of licenses, and the users and devices for each feature.

-  udadmin -f XDT_ENT_UD -device dn01.88 -delete

    Releases one device from one feature.

<!--NeedCopy-->