📚 课程目录第3章 CarMaker软件安装与许可配置

3、CarMaker软件安装与许可配置：安装步骤、环境变量设置、许可证激活、常见安装问题排查

CarMaker作为IPG Automotive推出的整车仿真测试平台，其安装与许可配置的规范性直接决定了后续仿真环境的稳定性与开发效率。本章围绕CarMaker在Linux（Ubuntu 20.04/22.04 LTS）环境下的完整部署流程展开，涵盖安装前置检查、分步安装操作、环境变量与依赖库配置、FlexNet许可证激活机制，以及高频安装故障的系统化排查方法。通过本章学习，读者将能够独立完成从裸机到可运行CarMaker GUI与批处理仿真的全流程搭建，并具备对常见安装异常的快速定位与修复能力。

3.1 安装前置检查与系统要求

CarMaker对运行环境有明确的软硬件约束，忽略前置检查是导致安装失败的首要原因。核心原理在于：CarMaker的仿真内核依赖实时调度、GPU渲染和特定版本的数学库，若底层系统不满足要求，即使安装程序强制完成，后续运行也会出现随机崩溃或结果异常。

安装前必须逐项确认以下关键指标：

操作系统版本：官方支持Ubuntu 20.04 LTS（推荐）与22.04 LTS，内核版本需≥5.4。CentOS/RHEL 8.x也可运行，但需额外配置兼容层。
磁盘空间：完整安装（含GUI、文档、示例工程）需≥40GB可用空间，其中/opt分区建议预留20GB以上。
内存与交换分区：建议物理内存≥16GB，交换分区≥8GB。复杂场景（如多车协同）需32GB以上。
GPU与驱动：若使用3D可视化（CarMaker.GUI），需NVIDIA独立显卡且驱动版本≥470，同时安装OpenGL 4.5+支持。
依赖库：需要libX11、libXext、libXtst、libGLU、libXrender等基础库，以及Python 3.8+（用于自动化脚本）。

操作流程：在终端执行以下命令完成系统检查：

# 检查系统版本
cat /etc/os-release
# 检查内核版本
uname -r
# 检查磁盘空间
df -h /opt
# 检查内存
free -h
# 检查GPU驱动
nvidia-smi
# 检查依赖库（示例）
dpkg -l | grep libX11

实战中，某团队在Ubuntu 18.04上强行安装CarMaker 10.2，虽然安装程序未报错，但启动GUI时出现段错误（Segmentation Fault）。通过gdb回溯发现是OpenGL库版本过旧导致。因此，务必在安装前完成系统版本核对，不要跳过此步骤。

常见误区：部分用户认为“安装包能运行就说明系统兼容”。实际上，CarMaker安装程序仅检查磁盘空间和基础权限，不会深度校验GPU驱动和数学库版本。若跳过前置检查，后续排障成本将成倍增加。

3.2 安装步骤详解与组件选择

CarMaker采用图形化安装向导（基于Qt）与命令行静默安装两种模式。核心原理是：安装程序将二进制文件、共享库、Python包、示例工程和文档解压到指定目录，并生成配置文件（如carmaker.ini）。理解安装过程的文件布局，有助于后续环境变量配置和故障定位。

推荐使用图形化安装，操作步骤如下：

获取安装包：从IPG官方门户下载CarMaker_10.2_Linux.bin，并校验MD5哈希值。
赋予执行权限：chmod +x CarMaker_10.2_Linux.bin
运行安装程序：sudo ./CarMaker_10.2_Linux.bin（需root权限写入/opt）
选择安装类型：建议选择“Full Installation”，包含GUI、命令行工具、Python API和示例数据。
指定安装路径：默认/opt/ipg/carmaker，建议保持默认以简化环境变量配置。
配置组件：勾选“CarMaker for Linux”、“IPG Movie”可视化插件、“Matlab/Simulink接口”（如已安装MATLAB）。
等待安装完成：安装日志输出至/tmp/carmaker_install.log，可实时监控。

组件名称	功能说明	磁盘占用	推荐选择
CarMaker Core	仿真引擎与求解器	8.2GB	必选
CarMaker GUI	图形化建模与后处理	3.5GB	必选
IPG Movie	3D动画渲染	2.1GB	可选（需GPU）
Python API	自动化测试脚本接口	0.8GB	强烈推荐
Matlab接口	Simulink联合仿真	1.2GB	按需
示例工程库	预置测试场景与车辆模型	5.6GB	推荐

案例拆解：某智能驾驶团队需要部署CarMaker用于HIL（硬件在环）测试。他们选择了“Custom Installation”，仅安装Core、GUI和Python API，跳过Matlab接口（因为使用ROS 2通信）。安装完成后，/opt/ipg/carmaker目录结构清晰，其中bin存放可执行文件，lib存放共享库，data存放车辆模型与道路数据。这种按需安装策略节省了约8GB磁盘空间，并减少了不必要的依赖冲突。

经验提醒：安装过程中若出现“Permission denied”错误，请确认使用sudo执行，且/opt目录可写。安装完成后，建议将/opt/ipg/carmaker的所有权改为普通用户：sudo chown -R $USER:$USER /opt/ipg/carmaker，避免后续每次运行都需要sudo。

3.3 环境变量设置与依赖库配置

环境变量是CarMaker运行时的“寻址系统”。核心原理是：CarMaker通过CARMAKER_ROOT定位安装目录，通过LD_LIBRARY_PATH查找共享库，通过PATH找到可执行命令。若这些变量未正确设置，即使安装成功，运行carmaker命令也会提示“command not found”或“libcarmaker_core.so: cannot open shared object file”。

标准配置流程如下：

编辑用户环境文件：vim ~/.bashrc
添加以下内容：

# CarMaker Environment
export CARMAKER_ROOT=/opt/ipg/carmaker
export CARMAKER_DATA=$CARMAKER_ROOT/data
export CARMAKER_SCRIPTS=$CARMAKER_ROOT/scripts
export PATH=$CARMAKER_ROOT/bin:$PATH
export LD_LIBRARY_PATH=$CARMAKER_ROOT/lib:$CARMAKER_ROOT/lib/linux64:$LD_LIBRARY_PATH
export PYTHONPATH=$CARMAKER_ROOT/python:$PYTHONPATH
export IPG_LICENSE_FILE=27000@license-server-ip  # 替换为实际License服务器

使配置生效：source ~/.bashrc
验证配置：echo $CARMAKER_ROOT应输出正确路径。

依赖库配置方面，CarMaker自带大部分第三方库（如Qt、Boost），但部分系统库仍需手动安装。使用ldd命令检查可执行文件的依赖完整性：

ldd $CARMAKER_ROOT/bin/carmaker | grep "not found"

若输出为空，说明所有依赖已满足；若有缺失项，使用apt-get install安装对应库。例如，缺失libXss.so.1时执行：sudo apt-get install libxss1。

  实战场景：某测试工程师在配置环境变量后，运行carmaker -v仍提示“error while loading shared libraries: libipg_math.so”。排查过程：首先执行ldd确认缺失库，发现libipg_math.so位于$CARMAKER_ROOT/lib/linux64，但该路径未加入LD_LIBRARY_PATH。修正后问题解决。此案例说明，环境变量配置必须与安装目录结构严格对应，不能想当然地只添加lib目录。

风险提示：不要将LD_LIBRARY_PATH设置为包含多个CarMaker版本，否则可能因库版本冲突导致仿真结果异常。建议使用module工具管理多版本环境，或为每个版本创建独立的.env脚本。

3.4 许可证激活与FlexNet配置

CarMaker使用FlexNet Publisher许可证管理机制。核心原理是：客户端（CarMaker）启动时向许可证服务器请求可用feature（如carmaker_gui、carmaker_batch），服务器验证授权后发放租约。理解这一机制，有助于快速定位“无法获取许可证”类问题。

许可证激活分为两种模式：

节点锁定（Node-Locked）：许可证绑定特定MAC地址，适用于单机开发。激活时需提供主机ID（lmhostid命令获取）。
浮动许可（Floating）：许可证部署在服务器上，客户端通过网络连接。适用于团队协作。

浮动许可服务器配置步骤：

安装FlexNet服务：CarMaker安装包自带lmgrd和lmutil工具，位于$CARMAKER_ROOT/bin。
创建License文件：将IPG提供的license.dat放置于/opt/ipg/licenses/目录。
启动服务：sudo $CARMAKER_ROOT/bin/lmgrd -c /opt/ipg/licenses/license.dat -l /var/log/ipg_license.log
验证服务状态：$CARMAKER_ROOT/bin/lmstat -a -c /opt/ipg/licenses/license.dat

客户端配置只需设置IPG_LICENSE_FILE环境变量指向服务器地址和端口（默认27000）。例如：export IPG_LICENSE_FILE=27000@192.168.1.100。

检查项	命令	预期结果
License服务器进程	`ps aux \| grep lmgrd`	lmgrd进程存在
端口监听	`netstat -anp \| grep 27000`	LISTEN状态
Feature可用性	`lmstat -f carmaker_gui`	显示可用数量
客户端连接	`lmdiag -c $IPG_LICENSE_FILE`	连接成功

案例拆解：某企业部署浮动许可后，所有客户端报“Cannot connect to license server”。排查过程：首先在服务器上执行lmstat -a，发现服务正常；然后在客户端telnet 192.168.1.100 27000，发现端口不通。进一步检查防火墙，发现ufw未放行27000端口。执行sudo ufw allow 27000/tcp后问题解决。此案例说明，网络层连通性是许可证激活中最易被忽略的环节。

经验提醒：建议在/etc/hosts中配置服务器主机名与IP映射，避免DNS解析失败。同时，定期备份license.dat文件，并记录许可证到期时间，提前与IPG销售续期。

3.5 常见安装问题排查与系统化排障

安装与许可问题通常呈现“现象相似、根因多样”的特点。建立系统化排障方法论，比零散搜索解决方案更高效。核心原理是：按照“环境变量→依赖库→许可证→硬件资源”的层次逐层排查，避免在错误层面浪费时间。

以下为高频问题及对应排查策略：

问题现象	可能原因	排查命令/方法	解决方案
命令找不到	PATH未包含bin目录	`echo $PATH`	重新source环境变量
共享库加载失败	LD_LIBRARY_PATH缺失	`ldd carmaker`	添加lib/linux64路径
许可证超时	服务器防火墙/端口	`telnet server 27000`	放行TCP端口
GUI启动崩溃	GPU驱动/OpenGL版本	`glxinfo \| grep OpenGL`	更新驱动或禁用3D
磁盘空间不足	/opt分区满	`df -h /opt`	清理或扩容
版本不兼容	系统库过旧	`cat /etc/os-release`	升级系统或使用容器

排障实战：某用户安装后运行carmaker，终端无任何输出直接退出。初步判断为许可证问题，但lmstat显示许可证正常。进一步使用strace跟踪系统调用：

strace -f -o /tmp/carmaker_trace.log carmaker 2>&1 | tail -50

发现程序在访问/opt/ipg/carmaker/data/vehicles时返回EACCES（权限拒绝）。检查目录权限，发现该目录属于root且权限为750，普通用户无法读取。执行sudo chmod -R 755 /opt/ipg/carmaker/data后问题解决。此案例说明，文件权限问题常被误判为许可证或环境变量问题，使用strace可快速定位系统调用层面的错误。

重要提醒：若使用NFS挂载的共享目录存放CarMaker数据，需确保no_root_squash选项已配置，否则客户端写入权限会异常。同时，避免在/tmp目录运行大型仿真，因其空间有限且可能被系统清理。

总结复盘：安装与许可配置是CarMaker使用的“第一道门槛”。通过本章学习，应掌握以下核心能力：一是安装前系统检查的标准化流程；二是环境变量与依赖库的精确配置方法；三是FlexNet许可证的激活与验证技巧；四是基于系统化分层法的排障思路。建议读者在完成安装后，立即运行carmaker -v和示例工程（DemoProjects/QuickStart），验证全链路功能。同时，将安装过程中的关键输出（如install.log、lmstat结果）保存为基线文档，便于后续版本升级或问题对比。