How to install Percept

If you have Docker installed and set up, we can now load the Percept image into the local Docker registry.

These steps are the same for Windows and Ubuntu

  1. Extract the downloaded archive and navigate to the folder:

    1. for Percept licensed version: cd Downloads/blickfeld-percept-v1.x.x_licensed/blickfeld-percept-v1.x.x_licensed

    2. for Percept trial version: cd Downloads/blickfeld-percept-v1.x.x_trial/blickfeld-percept-v1.x.x_trial

  2. Load the Percept image into the local Docker registry by executing the following command on the command line:

    1. docker load -i percept-v1.x.x.tar.gz

  3. To make sure, that the image was loaded correctly, check the Docker image registry contents (the output should be similar to the one shown in the image List of Docker Images below, the "TAG" depends on the Percept version used):

    1. docker images

List of Docker Images
Figure 1. List of Docker Images
Loading the Percept image into the docker registry might take some time

Additional steps required on Ubuntu

On Ubuntu some additional configuration has to be done to complete the setup. For your convenience we included a configure.sh script in the zip folder of Percept (needs root permission). The script will configure the user to have the right permissions to interact with Percept and the docker volume permissions so that Percept is able to store data e.g. project related files on your machine. Please follow the step below:

  • sudo bash configure.sh --user=your_user_name --volumes (replace your_user_name with your user name)

In case you receive this output after running the configure script, you are missing the "ACL (Access Control List)" package on your system (this is not always bundled with all linux distros). To fix this issue you could install this package from your package manger of choice or simply call this command: sudo apt install acl
Missing ACL package
Figure 2. Missing ACL package