Ubuntu20.04下NVIDIA nvCOMP安装及示例运行分步指南咨询

1. 需下载的准确安装包 #

• 直接下载官方预编译发行包nvcomp_install_CUDA_11.x.tgz即可，该包结构与官方README描述完全一致，包含预编译好的库文件、头文件、示例代码，开箱即用。
• 注意：通过git clone拉取的仓库是未编译的源码开发版，需要手动拉取第三方依赖、全量编译nvcomp本体，结构和预编译包不一致，新手不推荐使用。

2. 安装包推荐存放路径 #

• 下载完成后执行解压命令：tar -zxvf nvcomp_install_CUDA_11.x.tgz
• 解压后会生成名为nvcomp的文件夹，推荐移动到系统级软件存放目录：sudo mv nvcomp /usr/local/nvcomp

3. cmake命令说明与疑问解答 #

• 你下载的是预编译包，nvcomp核心库已经编译完成，不需要额外执行cmake命令编译安装nvcomp本体。
• 第三方站点给出的cmake -DNVCOMP_EXTS_ROOT=/path/to/nvcomp_exts/${CUDA_VERSION} .. make -j是git源码编译场景下的命令，不适用于预编译包安装流程，相关参数疑问解答如下：
  • CUDA_VERSION不是系统预定义环境变量，也不是固定字符串，是需要手动替换的版本占位符，你的环境对应值为11.4
  • nvcomp_exts是源码编译时用来存放第三方依赖组件的缓存目录，预编译包已经内置了所有依赖，不需要配置该参数

4. .bashrc 环境变量配置 #

执行gedit ~/.bashrc打开配置文件，在文件末尾追加以下内容：

# nvCOMP 环境配置
export NVCOMP_ROOT=/usr/local/nvcomp
export LD_LIBRARY_PATH=$NVCOMP_ROOT/lib:$LD_LIBRARY_PATH
export CPATH=$NVCOMP_ROOT/include:$CPATH

保存退出后执行source ~/.bashrc让配置生效，再执行sudo ldconfig /usr/local/nvcomp/lib刷新系统库缓存，避免运行时找不到动态库。

5. 示例代码编译路径与cmake命令 #

• 终端工作目录切换到示例目录下的build文件夹：

  cd /usr/local/nvcomp/examples
  mkdir -p build && cd build
  

• 执行以下cmake命令配置编译选项，其中-DCMAKE_CUDA_ARCHITECTURES=86是适配RTX3060（安培架构，算力8.6）的必填参数，缺失会导致编译出的程序无法运行：

  cmake .. -DNVCOMP_ROOT=/usr/local/nvcomp -DCMAKE_CUDA_ARCHITECTURES=86
  

• 配置完成后执行编译命令：make -j$(nproc)

6. high_level_quickstart_example.cpp 运行步骤 #

• 该示例源文件的绝对路径为/usr/local/nvcomp/examples/high_level_quickstart_example.cpp，执行完上述编译步骤后，会在/usr/local/nvcomp/examples/build目录下生成同名可执行文件。
• 保持当前在build目录下，直接执行以下命令即可运行示例：

  ./high_level_quickstart_example
  

• 运行成功后终端会输出压缩/解压测试的压缩率、吞吐速率等日志，无报错即代表nvcomp安装配置完成。

内容的提问来源于stack exchange，提问作者xyzabc