鲲鹏安装部署常见问题及答复

本文档整理了鲲鹏在安装部署、使用过程中的高频问题及对应解决方案，帮助开发者快速排查故障，提升迁移与开发效率。

一、安装部署类

Q1：安装时提示环境检查失败，找不到相关依赖包怎么办？

A：

1. 若系统默认的 yum/apt/zypper 源不可用，工具会自动从华为开源镜像站匹配对应镜像文件，若未匹配到，请自行根据操作系统版本下载对应的镜像文件。
2. 可通过鲲鹏开发套件兼容性查询助手确认当前系统与工具的适配信息，确保环境满足最低要求。

Q2：安装后 Web 界面无法访问，提示 "端口被占用" 怎么办？

A：

1. 查看端口占用情况（默认端口为 8086，根据实际端口替换）：

netstat -tuln | grep 8086

1. 强制释放占用端口：

fuser -k 8086/tcp

1. 若为 Docker 部署，需额外检查容器网络配置是否存在冲突。

Q3：解压安装包失败，提示文件损坏或磁盘不足？

A：

1. 检查压缩包完整性：重新下载安装包，对比官方提供的校验码，确保文件未损坏。
2. 检查磁盘空间：确保解压目录所在磁盘剩余空间足够，建议预留至少 10GB 以上空闲空间。
3. 解压时可添加--no-same-owner参数避免权限问题：

tar --no-same-owner -zxvf DevKit-All-x.x.x-Linux-Kunpeng.tar.gz

Q4：软件包完整性校验返回 warning 或 fail 怎么办？

A：

1. 重新下载安装包，确保下载过程中网络未中断，避免文件传输损坏。
2. 使用官方提供的校验工具重新校验，确认下载的文件与官方发布的文件哈希值一致。
3. 若使用第三方镜像下载，建议切换到华为官方渠道重新获取安装包。

二、登录与访问类

Q1：登录失败多次后账号被锁定了怎么办？

A：系统默认连续 5 次登录失败会锁定用户账号，锁定时长为 3 分钟，等待 3 分钟后即可重新尝试登录，期间请勿重复操作避免重置锁定计时。

Q2：浏览器访问登录页面时跳转其他网页或无响应？

A：

1. 检查部署地址与端口是否正确，确保输入的 IP 与端口为服务端实际部署的地址。
2. 清理浏览器缓存与 Cookie，或更换浏览器（推荐 Chrome、Edge 最新版本）重试。
3. 检查服务端是否正常启动，可通过如下命令查看服务状态：

systemctl status devkit

Q3：忘记 WebUI 登录账号密码怎么办？

A：可通过服务端的重置密码脚本进行密码重置，具体操作可参考官方用户指南中的账号重置章节，或联系管理员进行密码恢复。

Q4：登录后提示会话被挤下线是什么原因？

A：系统限制单个用户仅允许 1 个活跃会话，如果当前用户已经在其他终端登录使用，重复登录会自动挤掉前一个会话。若需多终端使用，可创建多个独立用户账号。

三、迁移工具类

Q1：迁移分析任务执行超时怎么办？

A：

1. 检查网络连接是否稳定，确保服务端与客户端网络通畅。
2. 调整任务超时配置，在工具设置中增大任务超时时间阈值。
3. 若为超大项目分析，可拆分大任务分批处理，避免单次任务负载过高。

Q2：分析完成后无迁移内容提示，是什么原因？

A：

1. 检查分析路径是否正确，确认路径下包含可分析的源码或二进制文件。
2. 确认待分析的文件未被忽略，检查是否配置了错误的忽略文件规则。
3. 检查 JDK 配置是否正确，针对 Java 应用需确保配置了正确的 JDK 路径。

Q3：迁移报告下载异常，无法正常打开？

A：

1. 检查网络连接是否稳定，避免下载过程中网络中断。
2. 清理浏览器缓存后重新尝试下载，或使用其他浏览器下载。
3. 若为大文件报告，可尝试使用断点续传工具进行下载。

Q4：依赖字典导入失败，提示格式不匹配？

A：

1. 检查字典文件格式是否正确，确保使用的是官方提供的标准依赖字典文件。
2. 确认字典文件的版本与当前 DevKit 版本匹配，不同版本的字典文件不兼容。
3. 检查文件权限，确保工具拥有字典文件的读取权限。

Q5：无源码的 X86 应用如何迁移到鲲鹏平台？

A：可使用鲲鹏 DevKit 提供的 ExaGear 二进制指令翻译工具，无需修改代码即可在鲲鹏平台运行 X86 应用，工具会动态将 X86 指令翻译为鲲鹏指令，整体性能损耗低于 10%，可快速完成无源码应用的迁移。

四、性能分析类

Q1：多节点分析时频繁出现 "节点无法连接"，如何排查？

A：此问题多由网络配置或时间同步异常导致，可按以下步骤处理：

1. 校准时区：确保所有节点时区一致，例如统一设置为 Asia/Shanghai：

ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime

1. 关闭防火墙：临时关闭防火墙测试连通性：

systemctl stop firewalld

1. 检查 SSH 密钥：确认 Agent 节点已正确配置无密码登录，确保节点间通信权限正常。

Q2：HPC 场景分析时，如何定位 MPI 通信瓶颈？

A：可通过资源调度分析模块获取关键指标进行定位：

• 查看跨节点通信占比：若超过 30% 需优化进程绑定策略。
• 分析通信时延分布：关联MPI_Send/Recv调用栈定位高延迟操作。
• 检查NUMA 节点间访问频率：使用numastat验证内存分配策略是否合理。

Q3：Python 应用性能分析为何无法显示热点函数？

A：

1. 检查解释器路径是否添加到应用程序路径配置（默认不包含/usr/bin/python3）。
2. 确认是否使用--enable-profiling参数启动解释器，开启性能分析支持。
3. 针对 C 扩展模块（如 NumPy），需配合perf子系统采集底层调用信息。
4. 可配置PYTHONPROFILEDIR环境变量，帮助工具捕获 Python 层的调用数据。

Q4：Java 应用内存泄漏诊断为何频繁误报？

A：

1. 确认堆转储文件完整，建议启动应用时添加-XX:+HeapDumpOnOutOfMemoryError参数，确保 OOM 时自动生成完整的堆转储文件。
2. 排除 JVM 内部对象（如 Metaspace 的类加载器）的干扰，避免将 JVM 自身对象误判为泄漏对象。
3. 结合调用栈验证对象生命周期，确认对象是否已经无法被访问但未被释放。

Q5：如何分析容器化应用的性能问题？

A：

1. 启动容器时添加监控权限参数，确保工具可以采集容器内的性能数据：

docker run -it --cap-add=sys_ptrace --security-opt seccomp=unconfined your_image

1. 确保 cgroup 版本与工具兼容，推荐使用 cgroup v2 模式以获得更准确的监控数据。

Q6："Self Cost" 与 "Total Cost" 在热点函数分析中如何区分？

A：

• Self Cost：函数自身执行耗时，不包含子函数调用的耗时，用于衡量函数本身的执行开销。
• Total Cost：包含所有被调用子函数的总耗时，用于衡量整个调用链路的总开销。

例如某排序算法中，std::sort的 Self Cost 仅占 15%，但 Total Cost 高达 68%，提示需要优化比较函数或选择更高效的排序算法。

Q7：Roofline 分析模型如何指导代码优化？

A：通过计算强度（FLOP/Byte）判断优化方向：

• 低于最低线：内存带宽瓶颈，需优化内存带宽利用率，减少无效内存访问。
• 介于最低与理想线：计算瓶颈，可尝试算法级优化，提升计算效率。
• 高于理想线：硬件特性瓶颈，可考虑利用鲲鹏的 SIMD 指令等硬件特性进行加速。

五、IDE 插件类

Q1：VS Code 插件安装后无法连接到 DevKit 服务端？

A：

1. 检查服务端是否正常启动，确保服务端 IP 与端口配置正确。
2. 检查网络连通性，确保 VS Code 所在机器可以访问服务端的端口。
3. 确认插件版本与服务端版本匹配，不同大版本的插件与服务端可能存在兼容性问题。

Q2：安装 IDE 插件后，亲和分析功能不生效？

A：

1. 检查是否已正确登录鲲鹏 DevKit 服务，未登录状态下部分高级功能无法使用。
2. 确认待分析的代码项目已正确加载，且配置了正确的编译环境。
3. 更新插件到最新版本，旧版本插件可能存在功能兼容问题。

Q3：插件安装失败，提示不兼容当前 VS Code 版本？

A：

1. 检查当前 VS Code 版本是否满足插件的最低要求，鲲鹏 DevKit 插件要求 VS Code 版本不低于 1.75.0。
2. 升级 VS Code 到最新稳定版本，然后重新安装插件。
3. 若无法升级 VS Code，可下载适配旧版本 VS Code 的历史版本插件进行安装。