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 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