A molecular modeling session can come to a halt before it even begins: you launch SAMSON on Linux, and it fails to open or reports a graphics-related error. That is frustrating, but it does not automatically mean your GPU is unsupported. The cause may be a missing window-system library, an unavailable OpenGL library, or a graphics driver that needs attention. Checking these in order can make the next step much clearer.
Start with the launch error
If the error mentions xcb, check the platform libraries first. On Ubuntu-like systems, the SAMSON troubleshooting guide suggests installing these packages:
|
1 |
sudo apt install libxcb-xinerama0 libxcb-cursor0 |
On CentOS-like systems, it suggests installing the xcb-util* packages:
|
1 |
sudo dnf install xcb-util* |
These packages address a different problem from GPU drivers. If the message is about a missing xcb component, begin here rather than changing graphics settings.
Find out which graphics hardware Linux sees
If the issue points to OpenGL, first identify the graphics device. Run this in a terminal:
|
1 |
lspci | grep VGA |
For more detail, the guide also suggests:
|
1 2 |
sudo lshw -c video lspci -nn | grep VGA |
The output can help distinguish a dedicated NVIDIA or AMD card from an integrated GPU, such as Intel graphics. This is useful context when you check which driver or OpenGL implementation is installed; it is not, on its own, proof that the driver is working correctly.
Check for OpenGL libraries
SAMSON requires system OpenGL libraries. On Linux, you can check whether OpenGL information and library files are available with:
|
1 2 3 |
glxinfo | grep OpenGL locate libOpenGL.so locate libGL.so |
For AMD graphics, the guide specifically notes the need for libOpenGL.so.0 and libGLX.so.0, and suggests checking for them as well:
|
1 2 3 4 |
sudo updatedb locate libOpenGL.so locate libGLX.so locate libGL.so |
If locate returns no result, that does not necessarily identify the exact cause; it does tell you that the library was not found in its database. The updatedb command refreshes that database before searching. If glxinfo itself is unavailable, the Mesa utilities may not be installed.
Integrated graphics and Mesa
For a system using integrated graphics, the documentation suggests checking whether Mesa and OpenGL are installed. On Debian-based systems such as Ubuntu, it gives this installation command:
|
1 |
sudo apt-get install libgl1-mesa-dev mesa-utils |
For newer Ubuntu systems with AMD graphics, it also lists Mesa as an alternative to installing an AMD driver:
|
1 |
sudo apt-get install mesa-utils libgl1-mesa-dev |
The right driver depends on your GPU and Linux distribution. If you have a dedicated NVIDIA or AMD card, consult the driver instructions for your specific platform rather than assuming that one driver package fits every system. SAMSON requires a graphics card that supports OpenGL 3.2.
A cautious order of operations
- Note the exact launch error before changing anything.
- If it mentions
xcb, check the relevant system packages. - Identify the GPU and check whether OpenGL libraries are present.
- Install or update the appropriate system driver or Mesa packages if needed.
- Only investigate library links if a required library is actually missing, and use paths that match your system and SAMSON installation.
That last point matters: the guide includes example symbolic links for missing OpenGL libraries, but the example paths are system- and installation-specific. Do not copy them blindly. A link cannot fix a missing or incompatible target, and the SAMSON-bundled-library example may need to be recreated after an application update.
For the complete troubleshooting reference and additional platform issues, see the SAMSON troubleshooting page.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
