How to Install VMLink on Ubuntu 18.04 and NVIDIA Jetpack

Reading Time: 5 minutes

VMLink is the ADLINK Edge tool of choice for visualising camera feeds and inference results. This guide explains how to install VMLink on Ubuntu 18.04 LTS and NVIDIA Jetpack systems.

Registering for an Account

Before you can download and install VMLink it is first necessary to register for an account on https://vmlink.io/. To create an account:

Downloading VMLink

To download a copy of VMLink login to the License Manager at https://vmlink.io/ and from the navigation bar select Software > Download.

Note: If you do not see the navigation bar you may need to make the web browser window wider.

To download a release click on the Ubuntu 18.04 button next to the release. ADLINK recommend downloading the latest available release.

VMLink will then be downloaded by your web browser in zip format.

Installing VMLink

To install VMLink:

$ ./artifacts/vmlink-install.sh

Launching VMLink

After installation finishes, a VMLink shortcut will be placed on your desktop. Initially, the shortcut will appear as follows:

To launch VMLink double click the shortcut. When the application is first launched you be warned that the VMLink shortcut has not been marked as trusted. Click Trust and Launch to mark the shortcut as trusted and launch VMLink.

The VMLink shortcut icon will change and the VMLink main window will appear.

Initially, the apps will be unavailable to launch due to having no license. In the next section, the process for applying a license to VMLink will be explained.

Note: If VMLink does not successfully launch at this point this could be due to out of date user configuration files being left over from a previous installation. This issue can be resolved by running the following command in the Terminal app:

$ rm -r $HOME/.vmlink

Licensing VMLink

New users of VMLink are able to register for a free trial license for the Streamer and Media Library apps which can be applied to a single VMLink installation. To acquire the trial license:

Discover and Show Streams

Now that VMLink has been registered, click the Launch button in the Streamer section of the main window. This will open the Streamer view where it will show all discovered camera streams on the ADLINK Data River. The image below shows an example with a single camera source.

VMLink Streamer showing the available streams to connect to

Click the Launch Stream button to open the camera stream and view the feed in real-time.