Setting Up Containers for OpenPV 5.x

OpenPV 5.x integrates AOT (Ahead of Time Compiling) into its build process (generate) which requires compiling in a Linux environment. This converts everything down into machine code for faster boot times and a smaller memory footprint. To facilitate this, all development paths utilize Containers. Either Podman or Docker container managers can be used. The actual containers needed are pre-built and installed from the OpenPV Plugins downloader.

Follow these steps to install Podman or Docker before downloading the containers from the OpenPV Plugin window. These instructions apply to a Windows environment.

Step 1 - Enable WSL 2

Skip Steps 1 and 2 if developing on a Mac.

Microsoft WSL Reference

• From a Command Prompt run the following command.
  • wsl --install
• Note: Must be logged in as an administrator

Step 2 - Install Ubuntu 22.04

Ubuntu Reference Information

• Reboot after enabling WSL/Linux. If Ubuntu is not already preinstalled follow these steps.
• From a Command Prompt type the following to get a listing of all the distributions available:
  • wsl --list --online

• Verify Ubuntu 22.04 is available in the list
• Install 22.04 by running the following command
  • wsl --install -d Ubuntu-22.04

• Launch Ubuntu from the command line - it may already be running after the install but after rebooting will need to re-launch.
  • wsl -d Ubuntu-22.04

Step 3 - Install Podman or Docker Desktop 

Podman is the preferred container environment and is supported in 5.x and newer.

For Mac users please follow the MAC install instructions. 

Podman Download Site

Docker Download Site

Both of these container managers can be installed however it is recommended that only one is active at a time.

Podman Install:

• Podman will install correctly using the default settings.
• If OpenPV returns a Domain Name resolution error when installing the container plugins from OpenPV, then follow these steps to resolve the domain name error.
  • podman machine stop
  • podman machine rm
  • podman machine init  --user-mode-networking
  • podman machine start

Docker Install:

• When downloading Docker use the default settings (Use WSL-2), when complete you will see this message.

• Launch Docker Desktop to verify it is working correctly. If you get a "Access Denied" error you will need to add yourself to the users group.
• Launch the Command Prompt in administrator mode then execute the following command
  • net localgroup docker-users DOMAIN\user name /add
  • To find your username and domain (used on corporate computers)go to your Windows Setting->Acccounts 

• Reboot after completing this command successfully.
• Launch Docker Desktop and verify engine is running in the system tray hidden icons.

• In Docker Desktop and go to Tools->Resources-> WSL Integration and verify integration is enabled and Ubuntu 22.04 appears and is enabled.

Step 4 - Install Plugins

From the Openview Plugins window select the development path you will be using and select "Setup Profile".

Verify all needed containers are installed. Notice there are separate containers for the Select Series and Pro Series of displays.

In Podman you will see the containers in the "Images" view.