SDK 安装

设置您的开发者套件

^{* iGPU 和 dGPU 可以同时在 dGPU 模式下的单个开发者套件上使用。请参阅此处的详细信息。}

此版本的 Holoscan SDK 已在配备 Ubuntu 22.04 的 Grace-Hopper 超级芯片 (GH200) 上进行测试。请按照此处的设置说明进行操作。

支持的 x86_64 发行版

¹ ^{未经正式测试或支持，但如果使用足够的依赖项构建裸机，则有望可以工作。}
² ^{未经正式测试或支持，但如果 NVIDIA 容器工具包支持，则有望可以工作。}
³ ^{未经正式测试或支持，但如果发行版的 glibc 版本为 2.35 或更高版本，则有望可以工作。}

NVIDIA 独立 GPU (dGPU) 要求

• 建议使用 Ampere 或更高版本以获得最佳性能

• GPUDirect RDMA 支持需要Quadro/NVIDIA RTX

• 已使用 NVIDIA Quadro RTX 6000 和 NVIDIA RTX A6000 进行测试

• NVIDIA dGPU 驱动程序：535 或更高版本

• dGPU (x86_64, IGX Orin dGPU, Clara AGX dGPU, GH200)

  复制

  已复制！

              
  
              
  docker pull nvcr.io/nvidia/clara-holoscan/holoscan:v2.9.0-dgpu
          

• iGPU (Jetson, IGX Orin iGPU, Clara AGX iGPU)

  复制

  已复制！

              
  
              
  docker pull nvcr.io/nvidia/clara-holoscan/holoscan:v2.9.0-igpu
          

有关详细信息和使用说明，请参阅 NGC。

尝试以下方法来安装 Holoscan SDK

            

            
sudo apt update
sudo apt install holoscan
        

故障排除

如果使用 apt 找不到 holoscan

            

            
E: Unable to locate package holoscan
        

在重复上述安装步骤之前，请尝试以下操作

• IGX Orin：确保计算堆栈已正确安装，这应配置 L4T 存储库源。如果您仍然无法安装 Holoscan SDK，请使用 CUDA 存储库中的 arm64-sbsa。

• Jetson：确保 JetPack 已正确安装，这应配置 L4T 存储库源。如果您仍然无法安装 Holoscan SDK，请使用 CUDA 存储库中的 aarch64-jetson。

• GH200：使用 CUDA 存储库中的 arm64-sbsa。

• x86_64：使用 CUDA 存储库中的 x86_64。

如果您在运行时遇到缺少 CUDA 库（如下所示）

            

            
ImportError: libcudart.so.12: cannot open shared object file: No such file or directory
        

如果您的系统安装了多个 CUDA 工具包组件版本，则可能会发生这种情况。使用 find /usr/local/cuda* -name libcudart.so.12 查找缺少的 CUDA 库 (libcudart.so.12 在此处) 的路径，并在 sudo update-alternatives --config cuda 中选择该路径。如果找不到该库，或者之后缺少其他 CUDA 工具包库，您可以尝试完全重新安装 CUDA 工具包

            

            
sudo apt update && sudo apt install -y cuda-toolkit-12-6
        

如果您在编译时遇到缺少 CUDA 头文件（如下所示）

            

            
the link interface contains: CUDA::nppidei but the target was not found. [...] fatal error: npp.h: No such file or directory
        

通常与上述问题相同，原因是您的环境中混合了 CUDA 工具包组件版本。使用 find /usr/local/cuda-* -name npp.h 确认缺少的 CUDA 头文件 (npp.h 在此处) 的路径，并按照与上述相同的说明进行操作。

如果您在运行时遇到缺少 TensorRT 库（如下所示）

            

            
Error: libnvinfer.so.8: cannot open shared object file: No such file or directory
...
Error: libnvonnxparser.so.8: cannot open shared object file: No such file or directory
        

如果您的系统安装的主要版本与版本 8 不同，则可能会发生这种情况。尝试重新安装 TensorRT 8，方法是

            

            
sudo apt update && sudo apt install -y libnvinfer-bin="8.6.*"
        

如果您无法导入 holoscan Python 模块

            

            
ModuleNotFoundError: No module named 'holoscan'
        

要利用 Debian 包中包含的 Python 模块（而不是安装 Python wheel），请将以下路径包含到您的 Python 路径中

            

            
export PYTHONPATH="/opt/nvidia/holoscan/python/lib"
        

            

            
pip install holoscan
        

有关详细信息和故障排除，请参阅 PyPI。