更新或修改网络许可证文件

关于网络许可证

网络许可证包含您的组织被授权安装并运行的每个产品的加密密码。

通常，您不需要修改服务器或客户端计算机上的网络许可证文件。但是，在某些情况下，您必须编辑许可证文件：

在网络许可证文件内

网络许可证文件是一种特殊格式的 ASCII 文本文件，其中包含您有权运行的每个产品的加密产品密码。每个产品密码用于确认适合该产品的密钥数。网络许可证管理器可授予或拒绝对某产品的访问权限，具体取决于与每个产品关联的许可证密钥的可用性。

  • 每个 INCREMENT 行标识一个产品、该产品的可用密钥数以及其他信息。（您的许可证文件中的 INCREMENT 行可能不包括该示例中所示的每个组成项。）

  • 反斜杠 (\) 字符指示该行延续到下一行。

  • 以井号 (#) 开头的行是注释行。在安装期间处理许可证文件时，MathWorks® 安装程序将使用这些注释行中的信息，例如许可证服务器主机 ID 或 Internet 地址。

# BEGIN---------------BEGIN---------------BEGIN
# MATLAB license passcode file.
# LicenseNo: 123456           HostID: 6C4B905F446E
#
# R2021b
#
INCREMENT MATLAB MLM 46 30-jan-2025 13 FDC7243F4976  \
        VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0:  \
        DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720  \
        NOTICE=product=MATLAB SN=123456 SIGN="00C8 0547 EFDF 50D7 B9CE  \
        4C9D 3348 561B E9E3 6CCA 7986 C2F6 38C8 794F EE84"
INCREMENT SIMULINK MLM 46 30-jan-2025 1 7DE4D05FF067  \
        VENDOR_STRING=vi=0:at=200:ae=1:lu=300:lo=CN:ei=1234567:lr=1:2p=0:  \
        DUP_GROUP=UH asset_info=123456 ISSUED=21-Nov-2021 BORROW=720  \
        NOTICE=product=SIMULINK SN=123456 SIGN="00BE C534 0A32 1821  \
        AFCE D040 2085 3E00 9005 4983 7EFB 875F E4A7 FEE6 9548"

许可证的处理

当您安装网络许可证管理器或 MATLAB 软件时，安装程序会分别处理用于服务器和客户端计算机的网络许可证：

在服务器上安装网络许可证管理器期间

在服务器上，安装程序将：

  • 制作名为 license.dat 的网络许可证文件的副本，处理该文件以添加 SERVER 和 DAEMON 行，并将此副本放在您要安装网络许可证管理器的 /etc 文件夹中。

  • SERVER 行用于标识服务器名称、主机 ID 和端口号。DAEMON 行用于确认网络许可证管理器守护进程的名称。

  • 对于网络指定用户许可证，当安装程序在安装期间创建选项文件时，还会将 Options= 语法添加到您的许可证文件中的 DAEMON 行。该语法指定选项文件的路径名称。

例如，假设有名为 thunderball 的服务器，它运行在端口 27000 上，其主机 ID 是 MAC 地址 03:42:f8:1b:b2:72。许可证文件中的 SERVER 和 DAEMON 行如下所示：

SERVER thunderball 0342f81bb271 27000
DAEMON MLM "C:\Program Files\MATLAB\R2025b\etc\win64\MLM.exe" options="C:\Program Files\MATLAB\R2025b\etc\mlm.opt"

在许可证处理过程中，安装程序会删除 MAC 地址中的冒号。

在客户端计算机上安装 MATLAB 期间

首先，您必须复制在安装网络许可证管理器期间配置的 license.dat 文件，并将其放在客户端计算机上或可通过网络访问的某个位置，然后才能运行安装程序。

然后，在安装期间，安装程序创建 license.dat 的副本，并对其进行处理以删除许可证文件中的 INCREMENT 行和 DAEMON 行，保留 SERVER 行。它还将语句 USE_SERVER 添加到该文件中。该行将客户端指向服务器上的网络许可证文件，该文件包含产品的所有密码。

它将此已配置的文件命名为 network.lic，并将该文件放在 matlabroot\licenses 中。

注意

请不要向用户提供您从许可证中心下载的许可证文件。他们只能使用在安装网络许可证管理器期间专门配置的许可证文件进行安装。

MATLAB 许可证搜索路径

MATLAB 会在启动时读取许可证文件以检查产品许可情况。MATLAB 按指定顺序在以下位置搜索许可证文件：

  1. 在 MATLAB 启动命令行上使用 -c 选项指定的许可证文件。-c 选项会覆盖整个搜索顺序，只使用在命令行中指定的内容。这是 MATLAB 搜索的唯一路径。

  2. 环境变量 MLM_LICENSE_FILE 和 LM_LICENSE_FILE。

  3. 程序启动者的用户配置文件所在的文件夹。

  4. MATLAB 安装中的 \licenses 文件夹，搜索名为 license.dat 的文件或扩展名为 .lic 的任何文件。

如果 MATLAB 是从网络许可证服务器中签出的，则同一会话中的所有工具箱签出也将来自该许可证服务器。即使路径中的许可证文件不是服务器许可证（即，它是用于个人、指定计算机或试用版的独立许可证文件），您仍然可以从该文件或许可证服务器中签出工具箱。

设置 MATLAB 许可证搜索路径

默认情况下，在客户端计算机上，MATLAB 将许可证文件安装在 MATLAB 客户端安装文件夹中的 \licenses 文件夹内。但是，您可以通过以下任一方式覆盖该位置：

  • 在 MATLAB 启动期间使用 -c 选项在命令行中指定许可证文件的路径。

    -c 选项会覆盖整个搜索顺序，包括环境变量，并且只使用在命令行中指定的内容。这是 MATLAB 搜索的唯一路径。

    您可以指定要搜索的路径列表。使用 -c 选项时，请牢记以下事项：

    • 如果许可证文件的路径包含空格，请将路径名括入引号中。

    • 如果要指定多个许可证文件，请务必将整个许可证文件列表括入引号中。

  • 设置环境变量。

    MLM_LICENSE_FILE 指定 MathWorks 产品的许可证文件的位置。MATLAB 首先搜索此环境变量。

注意

尽管您可以设置环境变量 LM_LICENSE_FILE，但不推荐使用此变量，因为它会影响所有支持 Flex 的产品。请改用 <VENDOR>_LICENSE_FILE。

注意

如果使用环境变量 MLM_LICENSE_FILE，则必须删除 matlab/licenses/network.lic。

更新网络许可证文件

当您从 MathWorks 收到新许可证时，请计划在对用户访问 MATLAB 许可证影响最小的时间来更新网络服务器上的许可证文件。

准备最新的许可证文件

下载最新的许可证文件并准备将其用于许可证服务器。

  1. 从“许可证中心”下载最新的许可证文件。要执行此步骤，您必须是许可证管理员。

    1. 在许可证中心，点击要更新的产品许可证。

    2. 在安装和激活选项卡的许可证服务器表中，找到您的许可证服务器所在的行。然后，在获取许可证文件列中，点击下载箭头或电子邮件图标。

    3. 点击下载许可证文件，然后点击完成。忽略页面上显示的其他步骤。下载的许可证文件名为 license.lic。

  2. （可选）如果您要更新多个许可证，请重复前面的步骤下载其他许可证文件。然后，将这些文件的内容合并为一个 license.lic 文件。请勿在文件中包含任何空行。

  3. 将 SERVER 和 DAEMON 行从服务器的现有许可证文件中复制到下载的许可证文件中。修改后的许可证文件应该如下所示：

    SERVER <hostname> <hostID> <portNumber>
DAEMON MLM <lmroot>/etc/<arch>/MLM
# BEGIN--------------BEGIN--------------BEGIN
<license file 1>
# END-----------------END-----------------END
# BEGIN--------------BEGIN--------------BEGIN
<license file 2>
# END-----------------END-----------------END
.
.
.
# BEGIN--------------BEGIN--------------BEGIN
<license file N>
# END-----------------END-----------------END

替换现有许可证文件。

  1. 按照针对您的平台的说明停止许可证管理器。请参阅启动和停止网络许可证管理器。

  2. 将现有服务器许可证文件替换为准备好的许可证文件。

    提示：如果您还要更新许可证管理器软件，请将现有许可证管理器二进制文件替换为当前最新的二进制文件。有关更新许可证管理器的详细信息，请参阅更新网络许可证管理器软件。

  3. 按照针对您的平台的说明重新启动许可证管理器。请参阅启动和停止网络许可证管理器。

您可以执行状态查询以确认许可证文件已更新。以下支持文章包含执行状态查询的说明：监控许可证或密钥的使用。

另请参阅

主题

外部网站