Troubleshooting

If you have trouble installing SAMSON and cannot find an answer below, please check the SAMSON Connect Forum.

I have a high DPI monitor and icons in SAMSON look small

Windows

  • Right click on the SAMSON executable program to open its properties and go to the "Compatibility" tab:
HighDPI-Compatibility.png
Properties: Compatibility
  • Click on "Change high DPI settings" and check the lower check box ("Override high DPI scaling behavior") and for the "Scaling performed by" select "System" from the list:
HighDPI-ScalingOverride.png
Properties: Scaling override
  • Restart SAMSON if it was launched.

Full Disk Access In MacOS

It might be necessary to provide a full disk access on macOS for SAMSON, e.g., to be able to access ~/Documents, desktop files, etc. Please check an example of the procedure to add full disk access here: https://www.tech-otaku.com/mac/manually-granting-applications-full-disk-access-macos-catalina/. Please note that you will need to perform this for SAMSON and you will need to use sh instead of bash.

Installation

Installing OpenGL drivers on Linux

Please, check how to install GPU driver and OpenGL library for your platform.

Below are suggestion for Debian-based systems (e.g. Ubuntu).

First, to check which GPU you have run the following command in the terminal:

lspci | grep VGA

If you have NVIDIA or AMD graphics card, you can install their proprietary drivers. Please, check how to do it for you platform and your GPU.

If you have only an integrated GPU (Graphics Processing Unit), you may see only something like:

00:02.0 VGA compatible controller: Intel Corporation ... process Graphics Controller

In this case you might need to install Mesa.

First check whether you have Mesa with OpenGL already installed in your system:

glxinfo | grep OpenGL
locate libOpenGL.so
locate libGL.so

To install Mesa execute the following command in the terminal:

sudo apt-get install libgl1-mesa-dev mesa-utils

Running SAMSON on Linux with an AMD GPU

SAMSON requires a graphics card supporting OpenGL 3.2. To detect which GPU you have you may run several commands:

sudo lshw -c video
lspci -nn | grep VGA

SAMSON depends on libOpenGL.so and libGLX.so (to be precise, libOpenGL.so.0 and libGLX.so.0), which are not provided by SAMSON and should be installed on your system. To check whether these libraries are installed on your system, you may run the following commands:

sudo updatedb
locate libOpenGL.so
locate libGLX.so
locate libGL.so

If you have no libOpenGL.so library in your system, you can make links to either the libQt5OpenGL.so shipped with SAMSON, or to your system library, e.g. by compiz:

ln -s $HOME/OneAngstrom/SAMSON-Application/3.0.0/Binaries/SAMSONQtLibs/libQt5OpenGL.so $HOME/OneAngstrom/SAMSON-Application/3.0.0/Binaries/SAMSONQtLibs/libOpenGL.so.0

or

sudo ln -s /usr/lib/x86_64-linux-gnu/compiz/libopengl.so /usr/lib/x86_64-linux-gnu/libOpenGL.so.0

In the first case, you will need to create this link every time your SAMSON has been updated. If you have no libGLX.so library, you may create a link to libGL.so, e.g. depending on where you have libGL.so:

sudo ln -s /usr/lib/x86_64-linux-gnu/libGL.so /usr/lib/x86_64-linux-gnu/libGLX.so.0

or

sudo ln -s /usr/lib/x86_64-linux-gnu/mesa/libGL.so.1 /usr/lib/x86_64-linux-gnu/libGLX.so.0

Otherwise, these libraries can be installed through a GPU driver or mesa. If, for example, you have Ubuntu 14.04 (up to Xorg 1.16) you may install the fglrx driver (we refer to https://help.ubuntu.com/community/BinaryDriverHowto/AMD").

For a newer version of Ubuntu, if you have a recent AMD GPU, you may install the AMDGPU Driver or the AMDGPU-PRO Driver. Alternatively, you may install mesa:

sudo apt-get install mesa-utils libgl1-mesa-dev