Updating an app

Reading Time: 6 minutes

From time to time ADLINK release new versions of the same apps to improve functionality or resolve any minor issues that have been reported. This guide is designed to take you through the process of upgrading an existing app, I am providing an example of updating the OpenVINO app which has just been released (time of writing is 12th Febuary 2021) the new version 1.1.0 is available within the ADLINK Public docker hub repo which is included as standard with your Profile Builder installation.

To get started select the Projects Module and locate the profile of the application you wish to update.

As you can see, we already have a version of the OpenVINO engine app installed, under the name you can see the version number (currently 1.1.0).

Before we get to deleting this original app though, click Add application button highlighted in Red.

You will now be taken to the Marketplace, here is where you add docker apps to a profile. By default we provide you the user with the DockerHub official apps, Portainer and ADLINKTECHPublic. This is where the Vizi apps are made available to you.

To speed up the search for the OpenVINO app simply untick the dockerhub official and Portainer stores.

And in the search bar type “openvino”

You will then be presented with the OpenVINO app family that is used by Vizi.

By default, the most recent version is selected by default but if you wanted to install older versions of apps you can by the dropdown list shown below.

Once you have the 1.1.0 version selected click Add application.

Now you need to give your app a name, the name must be unique in the profile that you are adding it too as this Title will represent the name of the docker container when it is deployed to your Vizi.

Add a Title and Click Add to add the app to your profile.

This will then download and add the app to your profile. This may take a little longer and is dependent on your internet speed.

You can now see that your app has been added as the last tile within the profile.

Next we need to configure the OpenVINO app a little so that it will work with the Vizi hardware, this is not necessary for all apps but is necessary for the OpenVINO app as we need to ensure that it connects to the Intel Myriad hardware that is deployed to help with inferencing of images.

Click your new app to open it.

We do not want to change any of the configuration, the item we are interested in is located within the Docker tab, click the Docker tab to open it.

Here you will be presented with our standard Container create options.

We need to edit the container create options to say:

{
	"NetworkingConfig": {
		"EndpointsConfig": {
			"host": {}
		}
	},
	"HostConfig": {
		"NetworkMode": "host",
		"LogConfig": {
			"Type": "json-file",
			"Config": {
				"max-file": "10",
				"max-size": "1m"
			}
		},
		"Privileged": true,
		"Binds": [
			"/dev:/dev"
		]
	}
}

Next click Save Changes and the Close.

You will return to the profile screen; next we want to delete the existing OpenVINO engine app as it will have been superseded by the 1.1.0 app.

Click on the 3 dots “…” in the top hand right corner of the app and click Delete application.

You will then be asked to confirm you want to Delete this application, the reason for such a warning is that all items of the app will be deleted and cannot be recovered. Click Delete forever.

You will see that the original app has now been deleted.

To push these changes to your Vizi we must upload the changes to our device. Click Deploy

You will then be presented with three options to deploy your profile. Select Deploy directly to a device and click Next.

Please note:

If your web cam was not plugged in when you started your Vizi-Ai, we recommend plugging it in to one of the USB3.0 ports and restarting your Vizi-Ai before continuing to the next step.

You will then be given the option to select the device that you want to deploy your profile directly too.

Select the device and click deploy.

Once you see the green Success notification at the bottom of the screen this means your profile has successfully been sent to the device, it may take a minute or two for the profile to be deployed, you can now click Close to exit the deployment option.

Once you have finished the previous step your new profile will already be in the deployment phase of its journey, provided your Vizi is powered on, if your Vizi is powered off these changes will be applied when it comes back online and has an active internet connection.

Bear in mind that as we are downloading a completely new version of an app that the download time will vary on your internet connection.

In this next section I will show how you can determine whether your new version of OpenVINO has been deployed. Go to the devices tab and click on the icon of portainer.

Log in to Portainer, the assumption is that you have completed the Portainer setup instructions located here (How to use Portainer to debug a Vizi-AI application).

Enter your user name and password and click Login.

Once logged in click anywhere on the central tile.

Then click on the containers tile.

Provided your app has finished downloading and once it has received its configuration you will see it has started and the old app has been removed.

Stay in touch

Sign up to our email list to be notified of the latest industry news