Product Documentation

快速入门

Aug 25, 2016

Citrix 建议在您升级或安装新的 Citrix 产品时,应将许可证服务器升级到最新版本。 新的许可证服务器是向后兼容的,并且可用于较旧的产品和许可证文件。 新产品经常要求最新的许可证服务器以正确签出许可证。

许可您的产品包括以下几个步骤:

  1. 确保具有最新的许可证服务器版本。
  2. 验证系统要求。
  3. 安装 Licensing。
  4. 从“我的帐户”获取许可证文件,或者,如果您具有许可证代码,可使用 Citrix Licensing Manager。
  5. 安装您的 Citrix 产品(或者,如果已经安装了,请重新启动 Citrix 产品,使得可以识别新许可证)
  6. 配置在产品安装期间未设置的产品端许可通信设置(如果适用)。 包括正确设置产品的产品版本。 有关这些设置的详细信息包含在产品文档中。

    请确保产品端版本设置与已购买的许可证正确匹配。 例如,如果已购买铂金版许可证,请确保产品中的版本设置指示铂金版(而非企业版或高级版)。

Important

许可证服务器不需要域成员身份。  您可以将许可证服务器安装在工作组中,并且仍代表 Citrix 产品执行所有许可功能。 要使用 Active Directory 用户或组管理许可证管理控制台或 Citrix Licensing Manager 用户,用户必须属于域;否则,请使用 Windows 用户。

有关许可组件和过程的概述,请参阅技术预览

确保具有最新的许可证服务器

升级或安装新的 Citrix 产品时,请始终安装最新版本的许可证服务器。 新许可证服务器是向后兼容的,并且可用于较旧的产品和许可证文件;但是,新产品需要使用最新的许可证服务器才能正确签出许可证。 可以通过产品介质安装或升级到最新版本。

注意:Citrix 不提供许可证服务器组件的修补程序,并且不支持在较旧的许可证服务器上安装较新的产品。 许可证服务器的最新版本通常包含早期版本中出现的问题的解决方法。

查找许可证服务器版本号

如果不确定许可证服务器版本是否为最新版本,可以通过将您的版本号与下载站点上的版本号进行比较来进行验证。

在具有“许可证管理控制台”的许可证服务器上:

  1. 在 Windows 系统中:从程序菜单 Citrix > 许可证管理控制台启动许可证管理控制台。

    在许可证服务器 VPX 和远程系统中:打开一个 Web 浏览器,转到 https://许可证服务器名称:安全 Web 端口。

  2. 单击管理,然后选择系统信息选项卡。 在信息列表中查看发行版本。

安全注意事项

Citrix 建议在您升级或安装新的 Citrix 产品时,应将许可证服务器升级到最新版本。 新的许可证服务器是向后兼容的,并且可用于较旧的产品和许可证文件。 每次释放一个新许可证服务器时,该服务器中包含的安全功能可能会优于之前的版本。

Citrix 还建议您在配置环境或使用 Licensing 管理控制台时注意以下安全事项。

  • 配置许可证服务器环境,以便仅允许可信网络中经过授权的管理员访问 Licensing 管理控制台端口。 可以通过相应地配置网络或基于主机的防火墙来实现此操作。
  • 使用 Licensing 管理控制台时,应避免访问不可信 Web 站点或单击不可信 URL。

防火墙考虑因素

确定是否需要在许可证服务器与任何产品服务器之间安装防火墙。 Citrix 建议在安装 Licensing 之前确定产品是否通过防火墙与许可证服务器进行通信。 有关防火墙方面的考虑因素可能会对安装许可证服务器的位置产生影响。

许可证服务器 VPX 具有默认的已启用的端口。 要更改端口,请使用 Linux 的 iptables 命令。

如果环境中有硬件防火墙,则必须手动创建必需的规则。

如果在您的产品与许可证服务器之间有防火墙,则需要配置端口号。 本配置过程需要:
  • 确定需要更改哪个端口号。 可以在安装过程中或安装后更改端口号。
  • 打开防火墙端口。 打开防火墙上您已经修改的任何端口,以便可以进行通信。 对于 Windows Server 2008,许可证服务器版本 11.5 或更高版本会自动配置内置防火墙。
  • 修改产品端设置。 您的 Citrix 产品必须配置为与“许可证管理控制台”中相同的端口号。 如果您并未更改产品中引用的端口号,该产品可能无法访问许可证服务器。 您可以在安装产品期间和安装产品之后更改产品端设置。 关于这些设置的信息,请参阅您的产品文档。

安装适用于 Windows 的 Licensing 组件

Licensing 组件可以安装在独立的专用服务器上,也可以安装在与其他应用程序共享的服务器上。 此外,也可以使用 Web 或应用程序服务器;但是,下面提到的位置占用资源的程度较低。 如果运行的服务器少于 50 台或者许可证数少于 10000 个,则可以将许可证服务器与产品安装到同一台服务器上。 可以监视 CPU 和内存负载(lmadmin.exe 和 CITRIX.exe),以确定是否应将许可证服务器重新分配到其他系统。

Important

请使用新的 CitrixLicensing.exe 文件以便所有安装顺利进行,但 Active Directory 部署除外。 在这种情况下,请使用 .msi 文件。

请确保 .exe 和 .msi 文件都可供安装使用。

使用图形界面安装许可证服务器和控制台

如果安装许可证服务器期间或之后未成功对其进行配置,则任何后续许可证服务器升级都将失败。

  1. 从 citrix.com 下载许可证服务器,然后以管理员或管理员组成员身份启动许可证服务器安装程序 CitrixLicensing.exe。
  2. 遵循安装程序图形界面以接受目标文件夹。

    Licensing 组件安装在 32 位计算机上的 C:\Program Files\Citrix\Licensing 中以及 64 位计算机上的 C:\Program Files (x86)\Citrix\Licensing 中。

  3. 在“配置”页面上,接受或更改供 Licensing 组件使用的默认端口号,并选择是否允许安装程序配置 Windows 防火墙例外。   如果需要,可以在安装后更改这些端口号。   如果选择在不配置许可证服务器的情况下完成安装,请重新启动 CitrixLicensing.exe 安装程序或使用许可证服务器配置工具在安装后配置设置。 您可从以下位置打开配置工具:C:\Program Files\Citrix\Licensing\LS\resource\Licensing.Configuration.Tool.exe。
    • 许可证服务器端口号为 27000
    • 供应商守护程序端口号为 7279
    • 管理控制台 Web 端口为 8082
    • Web Services for Licensing 端口为 8083
  4. 许可证服务器根据您的登录方式添加许可证管理控制台的默认管理员。 如果您在域中,许可证服务器将添加安装用户(域\用户)作为许可证管理控制台的默认管理员。 如果您是本地 Windows 用户,许可证服务器将添加安装用户(计算机\用户)作为许可证管理控制台的默认管理员。 将默认添加 BUILTIN\administrator 组,该组允许所有管理员管理 Licensing。  可以删除 BUILTIN\administrator,以限制指定用户的许可。 有权管理许可证管理控制台的任何用户还可以管理 Citrix Licensing Manager。
  5. 选择启动许可证管理控制台或 Citrix Licensing Manager 以及是否加入 Citrix 客户体验改善计划。

如果未从产品的管理控制台选择 Citrix Licensing Manager 或许可证,现在即可转至 Citrix Web 站点以获取运行 Citrix 产品所需的许可证文件。   下文“获取许可证文件”中详细介绍了此过程。

使用命令行安装 Licensing

使用 CitrixLicensing.exe 命令安装 Licensing 时,可通过在命令行的任意位置(选项与其参数之间的位置除外)添加 Property=value 来设置属性。

请确保以管理员权限运行命令行。 要使用提升的权限启动命令提示符,请选择开始,右键单击命令提示符,然后选择以管理员身份运行。   

注意︰由于 Citrix Service Provider 程序要求 使用客户体验改善计划 (CEIP) 和 Call Home,因此,如果您是 Citrix Service Provider,则无法禁用 CEIP 或 Call Home。 

以下示例命令行将在静默模式下安装 Licensing。 添加要设置的属性。

不换行在一行中键入命令。 以下示例由于空间限制显示为多行。

CitrixLicensing.exe /quiet /l install.log INSTALLDIR=安装目录 WSLPORT=端口号
LSPORT=端口号 VDPORT=端口号 MCPORT=端口号 CEIPOPTIN=

其中:

  • /quiet 指定无提示(安静)安装。
  • /l 指定日志文件位置
  • INSTALLDIR 是存储许可证服务器可执行文件的位置。可选参数。  默认位置为 c:\program files\citrix licensing 或 c:\program files (x86)\citrix\licensing。
  • WSLPORT 是用于 Web Services for Licensing 的端口号。可选参数。  默认值为 8083。
  • LSPORT 是用于许可证服务器的端口号。可选参数。  默认值为 27000。
  • VDPORT 是用于供应商守护程序的端口号。可选参数。  默认值为 7279。
  • MCPORT 是用于控制台的端口号。可选参数。  默认值为 8082。
  • CEIPOPTIN 指定是否参与或如何参与 Citrix 客户体验改善计划 (CEIP) 或 Call Home 计划。可选参数。  默认值为“无”。
    • Diagnostic(诊断)- Call Home
    • Anonymous(匿名)- CEIP

    可以通过编辑 CITRIX.opt 文件来修改安装时所做的选择:

    #CITRIX CEIP value

    其中 value 为 DIAG、ANON 或 NONE

在 VPX 上,请勿修改 CITRIX.opt 文件。 以根用户身份执行以下命令并选择 CEIP 选项 [1.DIAG 2.ANON 3.NONE]

# reset_ceip.sh

 

使用命令行为 Active Directory 部署安装 Licensing

使用 Msiexec 命令安装 Licensing 时,可通过在命令行的任何位置(选项与其参数之间的位置除外)添加 Property="value" 来设置属性。 .msi 中不支持群集。

注意:请务必以管理员权限运行命令行。  要使用提升的权限启动命令提示符,请选择开始,右键单击命令提示符,然后选择以管理员身份运行。   

以下示例命令行将在静默模式下安装许可,并创建日志文件以捕获有关此操作的信息。   请在开关后添加要设置的属性。

不换行在一行中键入命令。 以下示例由于空间限制显示为多行。

msiexec /I ctx_licensing.msi /l*v install.log /qn INSTALLDIR=安装目录 LICSERVERPORT=端口号
VENDORDAEMONPORT=端口号 MNGMTCONSOLEWEBPORT=端口号 WEBSERVICELICENSINGPORT=端口号 CEIPOPTIN=value

其中:

  • /l*v 是安装程序日志的位置。可选参数。 
  • /qn 指定无提示(安静)安装。
  • INSTALLDIR 是存储许可证服务器可执行文件的位置。可选参数。  默认位置为 c:\program files\citrix licensing 或 c:\program files (x86)\citrix\licensing。
  • LICSERVERPORT 是用于许可证服务器的端口号。可选参数。  默认值为 27000。
  • VENDORDAEMONPORT 是用于供应商守护程序的端口号。可选参数。  默认值为 7279。
  • MNGMTCONSOLEWEBPORT 是用于控制台的端口号。可选参数。  默认值为 8082。
  • WEBSERVICELICENSINGPORT 是用于 Citrix Licensing Manager 的端口号。可选参数。  默认值为 8083。
  • CEIPOPTIN 指定是否参与或如何参与 Citrix 客户体验改善计划 (CEIP) 或 Call Home 计划。可选参数。  默认值为“无”。
    • Diagnostic(诊断)- Call Home
    • Anonymous(匿名)- CEIP

    可以通过编辑 CITRIX.opt 文件来修改安装时所做的选择:

    #CITRIX CEIP value

    其中 value 为 DIAG、ANON 或 NONE

获取许可证文件

安装许可组件之后,就可以获取许可证文件了。

可以通过以下几种方式获取许可证文件:

  • XenApp 和 XenDesktop 中的 Studio。 有关详细信息,请参阅 eDocs 中 XenApp 和 XenDesktop 文档中的许可证
  • Citrix Licensing Manager。
  • 许可证管理控制台。
  • citrix.com。

前往 Citrix Web 站点之前,需要准备好下列信息:

  • 许可证代码。 查找此代码:在 Citrix 安装介质包上、从 Citrix 接收的电子邮件中,或从专享升级服务管理续订信息系统 (Subscription Advantage Management-Renewal-Information, SAMRI) 中。
  • 我的帐户的用户 ID 和密码。 可以在我的帐户上注册获得密码。

    注意:如果找不到这些项,请与 Citrix 客户服务联系。

  • 安装许可组件的服务器的名称。 此名称的输入字段区分大小写,因此,请确保复制的名称与计算机上显示的名称完全相同。

    可以在许可证管理控制台“管理”区域中的“系统信息”选项卡上找到许可证服务器主机名和 MAC 地址(以太网)。 还可以在许可证服务器上的命令提示符中运行 hostnamecommand。

  • 希望许可证文件中包含的许可证数量。 无需一次下载您有权享有的所有许可证。 例如,如果贵公司购买了 100 个许可证,您当前只能选择分配和下载 50 个。 稍后,可以在另一个许可证文件中分配剩余的许可证。 可以拥有多个许可证文件。

通过 Citrix Licensing Manager 获取证书

注意事项 - 使用 Citrix Licensing Manager 分配和下载许可证时请注意以下事项:

  • 单击“分配和下载”后,无法取消此操作。 如果“分配和下载”失败,请使用 citrix.com 上的“我的帐户”。
  • Citrix Licensing Manager 仅可分配零售许可证(非评估或演示许可证或专享升级服务续订),且不支持重新下载或重新分配许可证文件。 要使用这些功能,请使用“我的帐户”。
  • 如果您重命名了许可证服务器,则必须重新分配旧许可证服务器名称下已分配的所有许可证文件。 有关重新分配文件的详细信息,请参阅重新分配许可证文件
  1. 开始菜单中单击所有程序 > Citrix > Citrix Licensing Manager,或者从远程计算机 https://许可证服务器名称:8083 进行操作。
  2. 要更改端口和/或语言,请单击页面顶部菜单栏中的设置。 更改后单击保存
  3. 单击分配许可证,键入许可证访问代码(包含在 Citrix 发送的电子邮件中),然后单击显示许可证
  4. 从显示的列表中选择一个产品,然后单击分配和下载。 要选择多个产品,请先选择一个产品,单击分配和下载,然后选择另一个产品,单击分配和下载,依此类推,系统将按顺序处理这些产品。 请注意,分配并下载适用于特定许可证访问代码的所有许可证后,将无法再次使用该许可证访问代码。 如果必须使用该代码执行其他事务,请登录我的帐户
  5. 要显示新安装的许可证,请刷新许可证管理控制台。

使用许可证管理控制台获取许可证文件

  1. 在 Windows 系统中:启动控制台(开始 > 所有程序 > Citrix > 许可证管理控制台)。


    在许可证服务器 VPX 和远程系统中:
    打开 Web 浏览器,转到 https://许可证服务器名称:安全 Web 端口

  2. 单击管理供应商守护程序配置
  3. 单击导入许可证
  4. 单击 citrix.com 链接。
  5. 我的帐户页面中,输入您的用户 ID 和密码。
  6. 选择 All Licensing Tools(所有许可工具)。
  7. 在主菜单中选择 Allocate(分配)。
  8. 按照分配过程进行操作并生成文件。
  9. 选择要下载的许可证,单击 Download(下载)并将文件保存到以下位置:
    • C:\Program Files\Citrix\Licensing\MyFiles(在 32 位计算机上)
    • C:\Program Files (x86)\Citrix\Licensing\MyFiles(在 64 位计算机上)
    • /opt/citrix/licensing/myfiles(对于许可证服务器 VPX)
  10. 在许可证管理控制台的导入许可证文件页面上,浏览至许可证文件。
  11. 如果直接将文件复制到 MyFiles 目录中,或者如果文件与现有文件具有相同的名称,请选择覆盖许可证服务器上的许可证文件
  12. 单击导入许可证
  13. 单击供应商守护程序配置,然后在 Citrix 供应商守护程序行单击管理
  14. 单击重读许可证文件,使许可证服务器能够识别新文件。

    许可证服务器读取许可证后,用户即可开始使用这些许可证。

手动获取许可证文件

  1. 在 Web 浏览器中,转到 http://www.citrix.com.cn/
  2. 单击我的帐户并输入您的用户 ID 和密码。
  3. 选择 All Licensing Tools(所有许可工具)。
  4. 在主菜单中选择 Allocate(分配)。
  5. 按照分配过程进行操作并生成文件。
  6. 选择要下载的许可证,然后单击 Download(下载)并将文件保存到某个目录(请记住该文件下载到的位置;您将需要此位置)。 下面为建议的位置:
    • C:\Program Files\Citrix\Licensing\MyFiles(在 32 位计算机上)
    • C:\Program Files (x86)\Citrix\Licensing\MyFiles(在 64 位计算机上)
    • /opt/citrix/licensing/myfiles(对于许可证服务器 VPX)
  7. 在许可证服务器上,将许可证文件从保存它的目录复制到 myfiles 目录(在 32 位计算机上为 C:\Program Files\Citrix\Licensing\MyFiles,在 64 位计算机上为 C:\Program Files (x86)\Citrix\Licensing\MyFiles,对于许可证服务器 VPX 为 /opt/citrix/licensing/myfiles)。

    提示:请确保许可证文件保留 .lic 文件扩展名。 有些复制进程不能识别具有该扩展名的文件类型,而会在复制期间添加“.txt”文件扩展名。 无法导入具有错误文件扩展名的许可证文件。

  8. 在命令提示符下,导航至:
    • C:\Program Files\Citrix\Licensing\LS(在 32 位计算机上)
    • C:\Program Files (x86)\Citrix\Licensing\LS(在 64 位计算机上)
    • /opt/citrix/licensing/LS(对于许可证服务器 VPX)

    并键入以下命令:lmreread -c @localhost -all

在 Windows 上禁用域名截断

如果您在同一个许可证服务器上托管多个租户,请确保许可证服务器不截断 @domain.com。

警告:注册表编辑不当会导致严重问题,可能导致需要重新安装操作系统。 Citrix 无法保证因“注册表编辑器”使用不当导致出现的问题能够得以解决。 使用“注册表编辑器”需自担风险。 在编辑注册表之前,请务必进行备份。

  1. 找到以下注册表项:

    对于 32 位计算机:HKLM\Software\citrix\licenseserver

    对于 64 位计算机:HKLM\Software\Wow6432Node\citrix\licenseserver

    名称:UDUseDomain

  2. 将此注册表项设置为 1。
    数据说明
    0截断域字段。 (默认值)
    1不截断域字段。

在 Citrix 许可证服务器 VPX 上禁用域名截断

  1. 在命令行中,转至 /opt/citrix/licensing/LS/conf/ud_settings.conf 文件。
  2. 使用 vi 编辑器,设置 CTX_UD_USERDOMAIN=1
  3. 重新启动许可证服务器 VPX 或 Citrix Licensing 守护程序。
设置说明
CTX_UD_USERDOMAIN=1使用用户配置文件中的用户域。 禁用域名截断。
CTX_UD_USERDOMAIN=0不使用用户配置文件中的用户域。 (默认值)

从较早的许可证服务器 VPX 版本移动许可证文件

此过程仅移动许可证文件。 必须在新许可证服务器上重新配置所有用户。 确保您所移动的许可证文件具有正确的所有权和权限。

  1. 将旧 Citrix 许可证服务器 VPX 的许可证文件备份到网络共享上。
    所有 *.lic 许可证文件来自:/opt/citrix/licensing/myfilescitrix_startup.lic 除外
  2. 关闭旧许可证服务器
  3. 采用与旧许可证服务器相同的绑定方式启动新 Citrix 许可证服务器 VPX。
    绑定可以是在许可证文件的 SERVER 行中指定的 MAC 地址、主机名或 IP 地址。
  4. 将网络共享上备份的许可证文件还原到新的许可证服务器上。 将文件还原到:/opt/citrix/licensing/myfiles,文件所有权为 ctxlsuser:lmadmin用户:组),权限为 644
  5. ctxlsuser 身份运行此命令:/opt/citrix/licensing/LS/lmreread  -c  @localhost