Lattice Diamond中SALT_LICENSE_SERVER环境变量配置无效？

Question

在Lattice Diamond中，用户常遇到`SALT_LICENSE_SERVER`环境变量配置后仍提示“License checkout failed”或回退至试用模式的问题。典型表现为：变量已在系统级（Windows系统属性/ Linux `~/.bashrc`）正确设置为`port@host`格式（如`27000@lic-server`），且`lmutil lmstat -a`可连通验证，但Diamond启动时未读取该变量。根本原因在于Diamond 3.12+版本默认优先读取安装目录下`license.dat`文件或注册表项（Windows）中的`LM_LICENSE_FILE`，而忽略`SALT_LICENSE_SERVER`；该变量仅被部分后台进程（如`pnmain.exe`子任务）有限支持，且要求变量在Diamond进程启动前已生效（需重启终端/资源管理器，而非仅重载Shell）。此外，变量名大小写敏感（必须全大写）、含空格或中文路径会导致静默失效。建议统一使用`LM_LICENSE_FILE`并配合`lattice_lic.dat`文件部署，或通过Diamond GUI的License Setup向导手动指定服务器——这是官方推荐且兼容性最佳的方案。

Answer 1

一、现象层：典型故障表征与复现路径

用户在 Lattice Diamond 3.12+（含 3.13、4.0、4.1）中配置 SALT_LICENSE_SERVER=27000@lic-server 后，启动软件仍弹出 “License checkout failed” 或自动降级为 30 天试用模式。关键矛盾点在于：lmutil lmstat -a -c 27000@lic-server 可成功列出浮动许可（FLEXnet），ping lic-server 和 telnet lic-server 27000 均通，但 Diamond GUI 日志（%LATTICE_DIAMOND%\log\license.log）显示 Failed to initialize license system。

二、机制层：Diamond 许可加载优先级模型

Diamond 并非统一读取环境变量，其许可初始化遵循严格优先级链（自高到低）：

1. GUI License Setup 向导中手动指定的服务器地址（持久化至 registry: HKEY_CURRENT_USER\Software\Lattice Semiconductor\Diamond\License 或 $HOME/.lattice/diamond/license.cfg）
2. 安装目录下 license.dat 文件内容（若存在且语法合法）
3. Windows 注册表键值 LM_LICENSE_FILE（HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager）
4. LM_LICENSE_FILE 环境变量（系统级/用户级，全大写，无空格）
5. SALT_LICENSE_SERVER —— 仅被 pnmain.exe 子进程（如 place-and-route 引擎）在运行时按需读取，主 UI 进程 diamond.exe 完全忽略该变量

三、验证层：多维度诊断清单

检查项	Windows 验证命令	Linux 验证命令	预期结果
SALT_LICENSE_SERVER 是否生效	echo %SALT_LICENSE_SERVER%	echo $SALT_LICENSE_SERVER	输出 27000@lic-server（无引号、无空格、全大写）
主进程是否继承该变量	tasklist /v | findstr diamond → 查 PID → wmic process where "processid=PID" get commandline	ps aux | grep diamond → 检查 env 是否含该变量	diamond.exe 启动命令行中不出现该变量
是否存在冲突的 license.dat	dir "%LATTICE_DIAMOND%\license.dat"	ls $LATTICE_DIAMOND/license.dat	若存在，其内容将覆盖所有环境变量

四、根因层：变量作用域与进程生命周期错配

SALT_LICENSE_SERVER 的设计初衷是为后台计算任务（如 pnmain.exe, synplify.exe）提供轻量级许可入口，而非 UI 主进程。Diamond 主程序采用 Qt 框架启动，在 Win32 下以 CreateProcess 方式派生子进程时，默认不继承父 Shell 的非标准变量（除非显式调用 SetEnvironmentVariable）。更关键的是：资源管理器（explorer.exe）或终端未彻底重启时，新设置的系统环境变量不会注入到已驻留的进程树中 —— 即使重载 .bashrc 或点击“确定”保存系统属性，diamond.exe 仍运行在旧环境上下文中。

五、方案层：三阶兼容性修复策略

graph TD A[首选：GUI License Setup 向导] -->|官方认证| B[写入注册表/CFG文件
支持自动重连与failover] C[次选：LM_LICENSE_FILE + lattice_lic.dat] -->|强兼容| D[创建文本文件
SERVER lic-server 000000000000 27000
USE_SERVER] E[慎用：SALT_LICENSE_SERVER] -->|仅限调试| F[必须：1. 全大写 2. 启动前设 3. 从干净CMD/bash启动
例：start cmd /c \"set SALT_LICENSE_SERVER=27000@lic-server && diamond.exe\"]

六、部署层：lattice_lic.dat 标准模板与路径规范

在 %LATTICE_DIAMOND% 目录下新建 lattice_lic.dat，内容严格遵循 FlexNet 语法（注意：无空行、无 UTF-8 BOM、无中文注释）：

SERVER lic-server 000000000000 27000
USE_SERVER
FEATURE Diamond_Suite lattice 2030.01 permanent uncounted \
    VENDOR_STRING=\"Lattice_Diamond\" SIGNATURE=\"00000000000000000000000000000000\"

然后设置环境变量：LM_LICENSE_FILE=%LATTICE_DIAMOND%\lattice_lic.dat（Windows）或 export LM_LICENSE_FILE=$LATTICE_DIAMOND/lattice_lic.dat（Linux）。

七、运维层：长效监控与日志取证

启用完整许可日志需在启动前设置：set FLEXLM_DEBUG=1（Win）/export FLEXLM_DEBUG=1（Linux），并确保 %LATTICE_DIAMOND%\log\ 可写。关键日志字段包括：FlexNet: Found license file、FlexNet: Connecting to server、FlexNet: Cannot connect to license server。建议编写自动化巡检脚本，每小时执行：lmutil lmstat -c $LM_LICENSE_FILE -a | grep -E "(Users|Expire|Queue)"，输出至中央日志平台。