SuperAPI AI 工具集

holoscan-install-debian

编程与开发

查看项目

更新于 10-16 03:49

技能介绍

用途:在 Ubuntu x86_64(22.04/24.04)或 ARM64(Jetson/IGX)上,用 NVIDIA apt 仓库原生安装 Holoscan SDK 的 C++ 运行时与头文件,并选择与主机 CUDA 驱动匹配的 holoscan-cuda-* 包,最后用随附 C++ 示例验证。

前提:需 NVIDIA GPU 与可用驱动(nvidia-smi)、sudo 权限,以及能访问 developer.download.nvidia.com 与 docs.nvidia.com;cuda-keyring 包缺失时会在安装步骤中装入。建议先查阅官方 SDK 安装文档的 Debian/apt 部分,官方文档与本地步骤冲突时以官方文档为准。

用法:先用 lsb_release -a 或 cat /etc/os-release 和 nvidia-smi 确认系统与 CUDA 版本;按 nvidia-smi 的 CUDA Version 选包:13.x+ 用 holoscan-cuda-13;12.x 非 IGX 或 nvgpu 用 holoscan-cuda-12;12.x 在 IGX 上用 holoscan。若 cuda-keyring 缺失则下载并安装,再 sudo apt-get update,然后 sudo apt-get install -y holoscan-cuda-12(或 holoscan-cuda-13)。验证阶段设置 HS=/opt/nvidia/holoscan、LD_LIBRARY_PATH=$HS/lib、HOLOSCAN_INPUT_PATH=$HS/data、ulimit -s 32768,依次运行 hello_world、tensor_interop、video_replayer 示例;video_replayer 建议加 headless 配置并以 10 帧运行,数据缺失时运行 sudo $HS/examples/download_example_data。

可复用环境变量:export LD_LIBRARY_PATH=/opt/nvidia/holoscan/lib:${LD_LIBRARY_PATH};export HOLOSCAN_INPUT_PATH=/opt/nvidia/holoscan/data;ulimit -s 32768,可加入 ~/.bashrc 持久化。

限制:apt 包自 v3.0.0 起仅含 C++,不含 Python 绑定,需要 Python 时另行安装 wheel;仅支持 Ubuntu,其他发行版须用容器或 wheel;包变体必须匹配主机 CUDA 驱动,否则报 “CUDA driver version is insufficient”。常见问题:找不到 holoscan 包多因未装 cuda-keyring 或未 apt-get update;示例段错误多为未设 ulimit -s 32768;libholoscan_core.so 加载失败多为 LD_LIBRARY_PATH 未设置。