Follow this guide to set up your system to run the ONVIF Device Service.
- Intel™ Core® processor
- Ubuntu 22.04 LTS
- USB-compliant Camera
The software has dependencies, including Git, Docker, Docker Compose, and assorted tools. Follow the instructions from the following link to install any dependency that are not already installed.
Install Git from the official repository as documented on the Git SCM site.
Update installation repositories:
sudo apt update
Add the Git repository:
sudo add-apt-repository ppa:git-core/ppa -y
sudo apt install git
Install Docker from the official repository as documented on the Docker site.
To enable running Docker commands without the preface of sudo, add the user to the Docker group. Then run Docker with the
Create Docker group:
sudo groupadd docker
If the group already exists,
groupaddoutputs a message:
groupadd: group docker already exists. This is OK.
Add User to group:
sudo usermod -aG docker $USER
Please logout or reboot for the changes to take effect.
To verify the Docker installation, run
docker run hello-world
A Hello from Docker! greeting indicates successful installation.
Unable to find image 'hello-world:latest' locally latest: Pulling from library/hello-world 2db29710123e: Pull complete Digest: sha256:10d7d58d5ebd2a652f4d93fdd86da8f265f5318c6a73cc5b6a9798ff6d2b2e67 Status: Downloaded newer image for hello-world:latest Hello from Docker! This message shows that your installation appears to be working correctly. ...
Install Docker Compose
Install Docker compose from the official repository as documented on the Docker Compose site.
Install the build, media streaming, and parsing tools:
sudo apt install build-essential jq curl v4l-utils mplayer
The device service ONLY works on Linux with kernel v5.10 or higher.
The table below lists command line tools this guide uses to help with EdgeX configuration and device setup.
|build-essential||Developer tools such as libc, gcc, g++ and make.|
|jq||Parses the JSON object returned from the
|curl||Allows the user to connect to services such as EdgeX.||Use curl to get transfer information either to or from this service. In the tutorial, use
|v4l-utils||USB camera utility tools||This will be used to determine camera paths on the system for manual addition of cameras.|
|mplayer||Video player||Use this to view the camera stream.|
|>Table 1: Command Line Tools|
Download EdgeX Compose Repository
Create a directory for the EdgeX compose repository:
Change into newly created directory:
Clone the EdgeX compose repository
git clone https://github.com/edgexfoundry/edgex-compose.git
While not recommended, you can follow the process for manually building the images.