Cannot Open Shared Object File

The following error messages may appear on Linux systems when you try to launch QuantumATK for the first time:

  • OSError: libGL.so: cannot open shared object file: No such file or directory

  • ImportError: libGLU.so.1: cannot open shared object file: No such file or directory

For a missing libGL.so, create a new link:

$ sudo ln -s /usr/lib/libGL.so.1.2 <quantumatk_installation_path>/lib/libGL.so

If you have a 64-bit Linux, use /usr/lib64 instead.

However, first check that you actually have libGL.so.1.2 in /usr/lib or /usr/lib64. It might be called libGL.so.1 or something else instead, or located in another directory, depending on the video drivers. You can use:

$ locate libGL

to find the correct file to link to. On some systems we have seen that the same link needs to be created for libGLU.so as well. Note that in this case, the error message may still complain about libGL.so!

For a missing libGLU.so.1, install the related OpenGL utility library:

  • On Ubuntu, the package name is libglu1-mesa.

  • On openSUSE, the package name is libGLU1.

  • On RHEL, AlmaLinux, or Rocky Linux, the package name is mesa-libGLU.

Up to date details can be found in System Requirements.