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

关于网络许可证

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

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

更改许可证服务器名称时（例如，如果许可证现托管于新服务器上）。请参阅更新网络许可证。
更改端口号时（例如，如果服务器的端口地址已更改）。请参阅当许可证服务器改变时，我如何将我的 MATLAB 客户端迁移到新的许可证服务器？。
使用新许可证文件更新网络安装时。请参阅 MATLAB^® Answer 如何更新许可证管理器使用的许可证文件？

在网络许可证文件内

网络许可证文件是一种特殊格式的 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 行用于确认服务器主机和端口号。DAEMON 行用于确认网络许可证管理器守护进程的名称。
对于网络指定用户许可证，当安装程序在安装期间创建选项文件时，还会将 Options= 语法添加到您的许可证文件中的 DAEMON 行。该语法指定选项文件的路径名称。
例如，如果服务器名为 thunderball 并且其 MAC 地址为 03:42:f8:1b:b2:72，则您的许可证文件中的 SERVER 和 DAEMON 行将如下所示：
```
SERVER thunderball 03:42:f8:1b:b2:71
DAEMON MLM "C:\Program Files\MATLAB\R2024a\etc\win64\MLM.exe" \
            options="C:\Program Files\MATLAB\R2024a\etc\mlm.opt"
```

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

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

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

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

注意

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

MATLAB 许可证搜索路径

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

在 MATLAB 启动命令行上使用 -c 选项指定的许可证文件。-c 选项会覆盖整个搜索顺序，只使用在命令行中指定的内容。这是 MATLAB 搜索的唯一路径。
环境变量 MLM_LICENSE_FILE 和 LM_LICENSE_FILE。
程序启动者的用户配置文件所在的文件夹
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 许可证影响最小的时间段来更新网络服务器上的许可证文件。此过程要求您停止并重启网络许可证管理器（不执行重新读取，因为它可能会干扰某些许可证）。

此过程假定您尚未更新许可证管理器软件。如果您在更新该软件，另请参阅更新网络许可证管理器软件。

注意

如果是要升级到新版本的 MATLAB，请勿参照此过程。要升级到更高版本，请参阅获取新的 MATLAB 版本。

您必须是许可证管理员才能执行许可证文件更新。

要更新服务器上的许可证文件，请执行下列操作：

请转至 MathWorks 网站上的许可证中心，并登录到您的帐户。
选择要更新的许可证。
点击安装和激活。
获取您正在更新的服务器的许可证文件。
停止网络许可证管理器。
在编辑器中打开服务器上的现有许可证和新许可证。您将按照以下说明将新许可证的大部分内容复制到旧许可证中：
1. 在现有许可证中，删除除文件顶部的 SERVER 和 DAEMON 行之外的所有内容。
2. 在新许可证中，复制 SERVER 和 DAEMON 行下方到末尾的所有内容。
3. 将复制的内容粘贴到现有许可证的 SERVER 和 DAEMON 行的下方。
4. 保存现有许可证。您可以保存新许可证作为备份，切记将 SERVER 和 DAEMON 行替换为贵组织特定的内容。
如果您有选项文件，则视其具体配置，您可能需要加以更新。如果您没有选项文件，请跳过此步骤。
启动网络许可证管理器。