Skip to content

Latest commit

 

History

History
150 lines (131 loc) · 5.6 KB

installing-dependencies.md

File metadata and controls

150 lines (131 loc) · 5.6 KB

Installing DSL Dependencies

The DeepStream Services Library (DSL) is built on the NVIDIA® DeepStream SDK and requires all SDK components to be installed and verified.

Please consult the NVIDIA DeepStream Quick Start Guide for complete Installation Instructions.

Contents

Minimal (Base) Install

Copy and execute one of the following commands according to your Target Device, Jetson or dGPU.

Jetson Base Install

sudo apt update && sudo apt-get install \
    libgstrtspserver-1.0-dev \
    gstreamer1.0-rtsp \
    libapr1 \
    libapr1-dev \
    libaprutil1 \
    libaprutil1-dev \
    libgeos-dev \
    libcurl4-openssl-dev

dGPU Base Install

sudo apt update && sudo apt-get install \
    libgstrtspserver-1.0-dev \
    gstreamer1.0-rtsp \
    libapr1 \
    libapr1-dev \
    libaprutil1 \
    libaprutil1-dev \
    libgeos-dev \
    libcurl4-openssl-dev \
    libjson-glib-1.0-0 \
    libsoup-gnome2.4-dev

Enabling Extended Image Services (Optional)

Additional installation steps are required to use DSL's extended image services, which include:

DSL provides a choice of using FFmpeg or OpenCV. Note: that installing OpenCV when using a dGPU NVIDIA Docker Image can be problematic.

Building FFmpeg

To use FFmpeg, DSL requires that you clone, build and install the latest version of the FFmpeg development libraries. Any previously installed versions of FFmpeg must be removed first. Enter the following command to check for an existing version.

$ ffmpeg -version

If a version exists, enter the following command to remove it.

$ sudo apt-get autoremove ffmpeg

Copy and execute each of the following commands, one at a time, to setup the required dependencies.

$ mkdir ~/ffmpeg; cd ~/ffmpeg
$ git clone https://github.com/FFmpeg/FFmpeg.git
$ cd FFmpeg
$ ./configure --enable-shared --disable-lzma
$ make
$ sudo make install

Important Notes:

  • Building the FFmpeg libraries can take > 15 minutes, depending on the platform.
  • If builing in an NVIDIA DeepStream container, you may need to install yasm first
    • apt-get install yasm

Installing OpenCV

Copy and execute the following command to install the OpenCV development library (as an alternative to using FFmpeg).

sudo apt-get install -y libopencv-dev

Updating the Makefile

After installing FFmpeg or OpenCV, search for the following section in the DSL Makefile and set the appropriate BUILD_WITH flag to true.

# To enable the extended Image Services, install either the FFmpeg or OpenCV 
# development libraries (See /docs/installing-dependencies.md), and
#  - set either BUILD_WITH_FFMPEG or BUILD_WITH_OPENCV:=true (NOT both)
BUILD_WITH_FFMPEG:=false
BUILD_WITH_OPENCV:=false

Enabling Interpipe Services (Optional)

The Interpipe Sink and Source are optional/conditional DSL components. To enable, you will need to build and install the RidgeRun plugins. Then update the DSL Makefile to include/build the DSL Sink and Source components. Search for the following section and set BUILD_INTER_PIPE to true,

# To enable the InterPipe Sink and Source components
# - set BUILD_INTER_PIPE:=true
BUILD_INTER_PIPE:=true

Documentation and Debug Dependencies (Optional)

Installing dot by graphviz

Doxygen requires dot to convert calling graphs to .png files and Pipeline graphs can be generated using dot as well

sudo apt-get install graphviz imagemagick

Installing Doxygen

To install Doxygen on Ubuntu

sudo apt-get install doxygen

Getting Started

API Reference