Error in DeepStream 7.1 installation instructions - symlink fails to create

Accelerated Computing Intelligent Video Analytics DeepStream SDK
, ,
1

Please provide complete information as applicable to your setup.

• Hardware Platform (Jetson / GPU)
Both
• DeepStream Version
7.0 and 7.1
• JetPack Version (valid for Jetson only)
• TensorRT Version
• NVIDIA GPU Driver Version (valid for GPU only)
• Issue Type( questions, new requirements, bugs)
Documentation error
• How to reproduce the issue ? (This is for bugs. Including which sample app is using, the configuration files content, the command line used and other details for reproducing)

This issue was first reported with Error in DeepStream 7.0 installation instructions - symlink fails to create at which time the Topic was labeled with "nvbugs". However, the error still exists in the 7.1 installation instructions.

If you follow the directions and Install librdkafka using the following commands:

 $ sudo mkdir -p /opt/nvidia/deepstream/deepstream/lib
 $ sudo cp /usr/local/lib/librdkafka* /opt/nvidia/deepstream/deepstream/lib

and then install the DeepStream SDK, you are left with the following directory setup

Screenshot from 2025-03-15 17-23-41
Screenshot from 2025-03-15 17-23-41725×379 28.8 KB

with the Kafka libs under /opt/nvidia/deepstream/deepstream/libs
and the SDK installed under /opt/nvidia/deepstream/deepstream-7.1/...

with a missing symlink that’s required from /opt/nvidia/deepstream/deepstream/ to /opt/nvidia/deepstream/deepstream-7.1/

The DeepStream installer is failing to create the symlink since the /opt/nvidia/deepstream/deepstream/ folder all ready exists… as it was created in the Kafka install section.

Any application that tries to link the DeepStream code using the symlink will fail after the upgrade.

The easiest way to fix the documentation is to just change the order of the installation steps and install the DeepStream SDK before copying the Kafka libs.

I’ve confirmed that the installation completes with all files correctly under deepstream-7.1 and a valid symlink as show below.

Screenshot from 2025-03-15 17-46-03
Screenshot from 2025-03-15 17-46-03725×379 28.6 KB

An alternative fix would be to go back to the approach used in releases prior to 7.0… see 6.3 Kafka install

3

Thank you for your feedback, but this issue has been fixed in the DS-7.1 documentation.

Please refer to /opt/nvidia/deepstream/deepstream/sources/libs/kafka_protocol_adaptor/README

  git clone https://github.com/confluentinc/librdkafka.git
  cd librdkafka
  git checkout tags/v2.2.0
  ./configure --enable-ssl
  make
  sudo make install
  sudo cp /usr/local/lib/librdkafka* /opt/nvidia/deepstream/deepstream-<version>/lib/
  sudo ldconfig
4

The DS installation instructions for both Jetson and dGPU still have

image
image872×151 14 KB

see Installation — DeepStream documentation

5

Thanks for your feedback, We will fix this remaining issue ASAP.

1 Like
6

For those that followed the installation instructions, the install can be fixed with the following commands.

sudo mv /opt/nvidia/deepstream/deepstream/lib/* /opt/nvidia/deepstream/deepstream-7.1/lib/
sudo rm -r /opt/nvidia/deepstream/deepstream
sudo ln -s /opt/nvidia/deepstream/deepstream-7.1/ /opt/nvidia/deepstream/deepstream