FLEXnet许可证错误-97,121排查与解决方案

1. FLEXnet许可证错误解析：-97,121问题深度排查指南

作为嵌入式开发工具链的核心组件，Keil MDK和ARM编译器的许可证管理经常困扰着工程师们。其中FLEXnet Licensing Error: -97,121这个特定错误代码，通常发生在启动或重新读取许可证文件时。根据我处理过数十个同类案例的经验，这个错误往往源于许可证文件与服务器环境的不匹配。

关键提示：-97,121错误本质上是一个许可证验证失败的错误，表明许可证管理器(lmgrd)无法正确识别或读取许可证文件。这与服务器HostID变更、环境变量冲突或文件权限问题密切相关。

1.1 错误发生的典型场景

当出现这个错误时，工程师通常处于以下三种工作场景之一：

1. 首次安装FLEXnet许可证服务器，启动服务时立即报错
2. 服务器迁移或硬件更换后，原有许可证无法重新加载
3. 系统环境变更（如Windows更新、杀毒软件安装）后，原本正常的许可证突然失效

我曾遇到一个典型案例：某汽车电子研发团队在更换服务器网卡后，所有开发机突然无法编译代码，就是因为新网卡的MAC地址改变了HostID，而许可证文件仍绑定旧HostID。

2. 错误根源的逐层诊断方法

2.1 首要检查：HostID一致性验证

FLEXnet许可证的核心安全机制就是绑定服务器的HostID（通常是主网卡MAC地址）。使用以下步骤验证：

# 在许可证服务器上获取当前HostID lmutil lmhostid # 对比许可证文件中的HOST行 grep "HOST" license.dat

不一致时的解决方案：

1. 联系ARM重新生成许可证文件（需提供新的HostID）
2. 临时方案：在BIOS中恢复原网卡MAC地址（不推荐长期使用）

2.2 环境变量冲突排查

LMTOOLS的环境变量处理机制有个"坑"：当勾选"忽略环境变量"选项时，它会同时忽略系统设置和工具自身的配置。建议按以下流程检查：

1. 打开LMTOOLS → Config Services选项卡
2. 确认"License File Path"指向正确的license.dat
3. 切换到Server Status选项卡 → Perform Status Enquiry
4. 检查输出中是否包含"license file path: xxxx"的预期路径

经验之谈：我习惯在服务器上设置ARMLMD_LICENSE_FILE环境变量后，永远不勾选那个忽略选项。这能避免90%的路径相关问题。

2.3 杀毒软件干扰处理

现代杀毒软件常误判lmgrd.exe为可疑程序。需要为以下文件添加白名单：

• C:\Keil_v5\ARM\BIN\lmgrd.exe
• C:\Keil_v5\ARM\BIN\armlmd.exe
• 许可证文件所在目录

典型症状：服务能启动但立即崩溃，Windows事件查看器中出现"应用程序错误"记录。

3. 许可证文件损坏与恢复方案

3.1 文件完整性验证

有效的ARM许可证文件应包含以下特征：

• 以SERVER行开头，包含HostID和端口号
• 有对应的DAEMON行指定armlmd路径
• 每个特性(FEATURE)行包含完整的签名校验

使用这个命令快速验证基础结构：

head -n 5 license.dat # Linux/macOS type license.dat | more # Windows

3.2 重新获取许可证文件

通过ARM Silver门户重新下载的步骤：

1. 登录silver.arm.com
2. 进入License Management → Download Licenses
3. 选择对应PSN（许可证序列号）
4. 确保下载时选择的HostID与当前服务器匹配

避坑指南：浏览器直接下载可能会破坏文件格式。建议用"另存为"纯文本格式，避免记事本自动添加BOM头。

4. 高级调试技巧与日志分析

4.1 启用FLEXnet调试日志

在LMTOOLS中：

1. 进入Server/License File选项卡
2. 勾选"Debug Logging"
3. 指定日志路径（如C:\flexlog.log）
4. 重启服务后检查日志

关键日志信息解读：

• Unable to talk to lmgrd→ 通信端口被占用
• Invalid license file syntax→ 文件格式错误
• No such feature exists→ 特性名称不匹配

4.2 网络端口冲突排查

默认端口27000经常被其他服务占用。修改方法：

1. 在license.dat中修改SERVER行：

   SERVER myserver ANY 28000

2. 同步修改LMTOOLS中Config Services的端口设置
3. 防火墙放行新端口

5. 长效预防措施与最佳实践

根据我为多家企业部署ARM工具链的经验，推荐以下维护方案：

1. HostID固化策略：

   • 在服务器BIOS中锁定网卡MAC地址
   • 使用USB硬件加密狗作为辅助HostID（需ARM支持）

2. 环境标准化：

   # 示例：部署时自动设置环境变量 [System.Environment]::SetEnvironmentVariable( 'ARMLMD_LICENSE_FILE', '28000@license-server', [System.EnvironmentVariableTarget]::Machine)

3. 监控方案：

   • 定期运行lmutil lmstat -a检查许可证状态
   • 设置Nagios/Zabbix监控lmgrd进程状态

对于持续出现的许可证问题，建议考虑迁移到ARM的浮动许可证（Flexible License）方案，它通过云端验证大幅降低了本地配置的复杂度。我在某无人机项目上实施后，许可证相关故障下降了80%。

最后分享一个诊断小工具包制作方法：将lmutil、最新license.dat和调试脚本打包成紧急恢复包，放在开发团队共享目录中。当出现问题时，运行diag.bat即可自动收集所有关键信息：

@echo off lmutil lmhostid > debug_info.txt lmutil lmstat -a >> debug_info.txt type "%ARMLMD_LICENSE_FILE%" >> debug_info.txt