How to setup OpenCL drivers for SARscape on Linux

 

SARscape requires a working OpenCL 1.2 runtime (or higher) version to run. You can check if your SARscape installation is detecting a valid OpenCL runtime installation using the below SARscape tool:

/SARscape/Administration/View Files/OpenCL Info

See also the link below for more details: 

https://www.nv5geospatialsoftware.com/Support/Self-Help-Tools/Help-Articles/Help-Articles-Detail/ArtMID/10220/ArticleID/23897/How-to-check-if-the-OpenCL-configuration-of-your-machine-is-valid-to-run-SARscape

 

In case your Linux machine does not include a valid OpenCL installation, the process to install an OpenCL CPU-only runtime platform is proposed below
 

• Install ENVI.

 

• Install SARscape. For example, use the commands below:

sudo gunzip SARscape_linux_v562.tgz

sudo tar -xf SARscape_linux_v562.tar

sudo ./install.sh /usr/local /usr/local/harris/envi56

Note that the fist path in the above command -/usr/local- refers to the path where SARscape will be installed while the second path -/usr/local/harris/envi56- refers to the ENVI installation directory

At the end of the installation a message may inform you that your system does not support OpenCL.

This computer does not seem to have any OpenCL platform suitable for SARscape.
Please read the SARscape_OpenCL_Installation.pdf document for more information.

 

• Move to the SARscape installation directory:

         cd /usr/local/SARscape/config_file

 

• Unzip/untar the below OpenCl installer included with the SARscape installation

      sudo tar -zxvf l_opencl_p_18.1.0.015.tgz

 

• Move to the opencl_p_18.1.0.015 folder and run the installer

cd /usr/local/SARscape/config_file/l_opencl_p_18.1.0.015

sudo ./install.sh

Or

sudo ./install_GUI.sh (to run it as a GUI)

 

• After the installation succeeds, run the SARscape OpenCL info file to confirm your SARscape installation now supports a valid OpenCL CPU device

 

Notes:

- Depending on your Linux flavor, the OpenCl installer may complain about some missing dependencies such as lsb-core or libnuma. If this is the case, abort the installation, install the missing packages - from your Linux distribution- and then restart the OpenCL installer. For exmaple for Ubuntu flavor you may use the below commands

sudo apt-get update
sudo apt-get -y install lsb-core

 

- If the OpenCL installer complains about an unsupported Linux version, just ignore the warning and move forward with the installation 

 

- The installation of the drivers provided within SARscape distribution may fail on recent Operating System. If this is the case, or if you want to benefit of the last version of OpenCL drivers, we invite you to follow instructions from the below document available in the SARscape distribution.

/usr/local/SARscape/doc/SARscape_OpenCL_Installation.pdf

 

 

If any questions, please contact Tech Support

 

 

--------------

writen by BC on 05/27/2020 - reviewed by MM on 05/27/2020

updated by BC on 5/25/2022 - reviewed by MM on 05/27/2025