第4章 工具安装与许可配置

说实话,工具装不上、跑不起来这种事,我见过太多次了。不是工具本身多复杂,而是下载、license、环境变量这三个环节,随便哪个出点岔子,后面全白干。这一章我把整个流程拆开揉碎,你跟着走一遍,基本不会翻车。

4.1 软件下载与版本选择

下载渠道就两个:官方站点和内部镜像站。官网上一般有 Release Notes,里面会写清楚这个版本修复了哪些 bug、支持哪些 OS。我个人习惯保留上一个版本,万一新版有兼容性问题,还能快速回退。

  • 官网下载:建议直接走 HTTPS,别用 FTP,有些防火墙会拦。
  • 内部镜像:如果公司有镜像站,优先用镜像,速度稳定很多。
  • 版本选择:别追最新。选那个标了 "Stable" 或 "LTS" 的。最新版通常要等一个小版本迭代才稳。
  • 文件校验:下载完后一定要做 checksum。官网会提供 MD5 或 SHA256,用 md5sum 或 sha256sum 对一下。
小经验:压缩包下载完后,先解压到一个临时目录,看看有没有 README 或 INSTALL 文档。有些关键配置说明就藏在这些文件里。

4.2 License 许可配置

License 是大部分人翻车的重灾区。工具厂商会给你一个 license 文件,或者一个浮动 license 服务器的地址。不管哪种方式,最后都要通过环境变量告诉工具去哪找许可。

  • 文件型 License:把 license.lic 放到一个固定路径,比如 /opt/pdn_tool/license/。路径里不要有中文、空格、特殊符号。我曾经因为路径里带了个空格,工具报了半天的 "Cannot checkout license"。
  • 浮动 License:设置 LM_LICENSE_FILE=port@server_ip,比如 27000@192.168.1.100。注意防火墙要放行这个端口。
  • 多用户共享:如果团队共用一套 license,建议在服务器上配好,客户端只设 LM_LICENSE_FILE 指向服务器,别每人拷一份文件。
注意:license 文件有有效期。项目做到一半 license 过期,那真是欲哭无泪。我建议在日历上设个提醒,提前两周跟厂商续期。

验证 license 是否生效,可以用工具自带的 lmstat 命令:

lmstat -a -c /opt/pdn_tool/license/license.lic
# 或者浮动 license:
lmstat -a -c 27000@192.168.1.100

输出里能看到 feature 名称、过期时间、当前用户数。如果显示 "No such feature",说明 license 文件没配对。

4.3 环境变量配置

环境变量是工具和系统之间的"暗号"。暗号对不上,工具就找不到自己该用的库、路径、license。下面这几个变量是必须配的:

变量名 作用 示例值
PDN_TOOL_HOME 工具安装根目录 /opt/pdn_tool/v2024.1
PATH 让系统找到可执行文件 $PDN_TOOL_HOME/bin:$PATH
LM_LICENSE_FILE 指向 license 文件或服务器 /opt/pdn_tool/license/license.lic
LD_LIBRARY_PATH 动态库搜索路径(Linux) $PDN_TOOL_HOME/lib

我建议把这些变量写进 ~/.bashrc 或 ~/.cshrc,别每次手动 export。下面是一个 bash 配置示例:

# PDN 谐振排查工具环境配置
export PDN_TOOL_HOME=/opt/pdn_tool/v2024.1
export PATH=$PDN_TOOL_HOME/bin:$PATH
export LM_LICENSE_FILE=/opt/pdn_tool/license/license.lic
export LD_LIBRARY_PATH=$PDN_TOOL_HOME/lib:$LD_LIBRARY_PATH

配完后,source ~/.bashrc 让它生效。然后用 echo $PDN_TOOL_HOME 确认一下路径对不对。我建议再用 which pdn_tool 验证一下可执行文件是否能找到。

核心思路:环境变量配置的本质就三件事——告诉工具「你在哪」「你的 license 在哪」「你的库在哪」。这三个对上了,工具就能跑。
PDN谐振排查工具 安装配置流程 准备阶段 配置阶段 验证阶段 1. 软件下载与校验 官网 / 镜像站 2. 安装与目录确认 安装路径 3. License文件配置 LM_LICENSE_FILE 4. 环境变量设置 PATH / 库路径 5. 启动验证测试 运行测试用例

4.4 常见问题与排查

配完了跑不起来?别急。下面这几个问题覆盖了 90% 的安装故障,对照着查一遍基本能解决。

  • "command not found":PATH 没配对,或者 source 完没开新终端。重新 echo $PATH 看看。
  • "Cannot checkout license":LM_LICENSE_FILE 路径错了,或者 license 文件格式不对。用 lmstat 确认。
  • "Library not found":LD_LIBRARY_PATH 漏了,或者装的是 64 位工具但系统缺 32 位库。检查一下 lib 目录是否存在。
  • "Permission denied":安装目录权限不够。用 chmod +x 给执行权限,或者用 sudo 跑一遍安装脚本。
防火墙拦截:如果用浮动 license,记得检查服务器端口的连通性。在客户端执行 telnet server_ip 27000,如果连不上,去防火墙上放行这个端口。

配置完成后,我建议重启一次终端,或者干脆重新登录一下。有些环境变量在当前的 shell 会话里不会立即生效,重新登录最保险。

嗯,到这里,工具安装与许可配置这块就聊完了。你按照这个流程走一遍,基本不会遇到什么大坑。如果真碰上奇怪的问题,回头再看一遍 4.4 的排查清单,大部分都能找到答案。