Skip to main content
Version: v5.9.0

Scripted Installation

The quadra_quick_installer.sh script is provided for the installation of the Firmware to the Quadra device, and also to install a default configuration of the Software on the host system.

note

The quick installer script is supported on Ubuntu, CentOS, and MacOS, not Windows or Android.

The quick install script can be found at the top level of the NETINT release package, along with the compressed firmware and software release files in the .zip format.

  1. Copy the following file from the release package to the host system. Note that the compressed filename syntax will be as follows :
Quadra_V5.4.0.zip
  1. Uncompress the main Quadra_VN.N.N release package zip file
unzip Quadra_V5.4.0.zip
  1. Now change directory to the new Quadra release folder
 cd Quadra_V5.4.0
  1. Check you can see the uncompressed files in the new folder using the ls command, note that the file names with versions will change, depending on the release version you are installing.
note

Ensure the Quadra_FW_VN.N.N_RCN and Quadra_SW_VN.N.N_RCN folders are contained in the new folder, as well as the quadra_quick_installer.sh script.

  1. Execute the quick installer BASH script
bash quadra_quick_installer.sh

The install script scans the host system seeking both installed Quadra devices, as well as any release upgrade packages. It then prompts the user to confirm which packages to install.

Check the correct packages have been chosen for installation and then press the ‘y’ key

Press [Y/y] to confirm the use of these two release packages.

  1. The following menu options are displayed and can be used to set up the system and install the listed frameworks
Choose an option:
1) Setup Environment variables
2) Unlock CPU governor
3) Install OS prerequisite packages
4) Install NVMe CLI
5) Install Libxcoder
6) Install FFmpeg-n4.3.1
7) Install FFmpeg-n5.1.2
8) Install FFmpeg-n6.1
9) Install FFmpeg-n7.1 
10) Install FFmpeg-n8.0.1
11) Install gstreamer-1.22.2
12) Install gstreamer-1.24.4
13) Install gstreamer-1.24.9
14) Install gstreamer-1.26.2
15) Firmware Update
16) Quit
  1. Type in 1 and press enter to setup the environment variables. Make sure the action was successful
  2. Type in 3 and press enter to install all the prerequisite software libraries for your OS (Ubuntu/CentOS/MacOS). Again, check the action was successful without any warnings or errors.
  3. Type in 4 and press enter to install the nvme-cli tool

If the OS version does not support nvme-cli 1.16 you may see this build error message

Install NVMe CLI failed

To fix the above error and install the latest nvme-cli package, manually install the tool

sudo apt install nvme-cli
  1. Type  5 and press enter to install libxcoder

If the libxcoder is installed, then a background systemd service that automatically initializes all Quadra VPU devices on system startup can be configured. Choose Y at this prompt. 

Would you like to install a systemd service for libxcoder? Press [Y/y] to confirm.
  1. Depending on version of FFmpeg desired, use an option from 6 to 10 to install FFmpeg. You can use the prompts to compile the libav shared libraries, add Gstreamer support or interface with the libavcodec.
  2. If you also wish to install Gstreamer with Netint support through gst-libav, use an option from 11 to 14 and press enter. The pre-requisites are that an FFmpeg version >= n4.3.1 is installed with shared libraries and Gstreamer support.
note

Gstreamer support in libavcodec changes some of the timestamp handling to use the Gstreamer style over the FFmpeg style.

  1. Type in 15 and press Enter to start the guided Firmware upgrade process.
warning

It is vital that the firmware update process (once started), is NOT interrupted. Any interruptions during firmware update may cause the device to malfunction. If a cold upgrade fails before completion then a system reboot may resolve the issue. The firmware update process should then be repeated to update the device firmware.

note

The behavior of the warm upgrade process is identical to the cold upgrade except that a system reboot is not required for the warm upgrade. However if the warm upgrade fails then a system reboot should resolve the issue, and the warm upgrade process can be repeated. However, if warm upgrade repeatedly fails then a cold upgrade and reboot should be used instead.

  1. Type in 16 and press Enter to quit the script

If any individual steps fail during the quadra_quick_installer.sh execution then it is recommended the output errors are inspected and to take the necessary action to resolve all issues. Once all issues are resolved repeat that installation step. If any errors persist, please contact NETINT support.

note

Additional information captured during the update process can be found in the ./upgrade_log.txt file generated by the update script.