Get Started

  • 2021.2
  • 03/26/2021
  • Public Content

Troubleshooting

This section describes known problems you may encounter when using the
Intel® oneAPI Rendering Toolkit
(
Render Kit
).

Issue: Errors related to
Intel® oneAPI Threading Building Blocks

Intel® oneAPI Threading Building Blocks
(
oneTBB
) included in the
Intel® oneAPI Base Toolkit
conflicts with the
oneTBB
included in the
Render Kit
binary package.
Solution
: Uninstall the
Intel® oneAPI Base Toolkit
and retry the Configure Your System steps for the
Intel® oneAPI Rendering Toolkit
. The
Render Kit
does not require the
Intel® oneAPI Base Toolkit
.

Issue: A sample application cannot load shared libraries

When you run a sample application of a
Render Kit
component, you might get an error saying that the sample cannot load one of the following shared libraries:
  • libimf.so
  • libsvml.so
  • libirng.so
  • libintlc.so.5
For example, for an Intel® OSPRay sample, you might get the following error:
error while loading shared libraries: libimf.so: cannot open shared object file: No such file or directory
.
Solution
: Make sure the runtime libraries are installed and visible to a program executed:
  1. Install
    Intel® oneAPI
    DPC++/C++
    Compiler
    from the
    Intel® oneAPI Base Toolkit
    .
  2. Set up the compiler environment variables:
    source <basekit_install_dir>/compiler/latest/env/vars.sh
  3. Set up the environment for the
    Render Kit
    component using the component-specific script. For example, to set the environment for the Intel OSPRay:
    source <renderkit_install_dir>/ospray/latest/env/vars.sh
    Do not set up environment for
    oneTBB
    . Do not use the global setvars.sh script.

Issue: Errors when running the Intel® OSPRay sample

You may encounter errors when installing the Intel® OSPRay sample with CMake* if the
Render Kit
installation path does not match the installation path in the
CMakeLists.txt
file. It currently works with the default
/opt/intel/oneapi/
installation path.
Solution
: Make sure that the Render Kit installation path in the
CMakeLists.txt
file matches the actual installation path of the
Render Kit
. If you installed it into a different directory, update the
CMakeLists.txt
file accordingly.

Issue: Missing dependencies when building and running the Intel® Embree sample

Aptitude-based installations (with
apt install
) of the
Render Kit
prerequisites
bring in many dependencies automatically. If you work on a one-off platform, you may need to verify that all the dependencies are present.
You may also need to go back to choose and validate exactly which of the dependencies you will use to support your end-user program.
Solution
: To verify that you have all the required dependencies, see the
Ubuntu_embree_advanced_package_dependencies.txt
attachment of the Intel® oneAPI Rendering Toolkit: build configuration guide. This file is a list of dynamically loaded run-time libraries for the tutorial programs to simplify your investigation. This list was captured with the List Dynamic Dependencies (ldd) utility for all result executables on the Ubuntu* OS 18.04 test system (December 10, 2019).

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.