Commit b6ef204b authored by Carsten Richter's avatar Carsten Richter

Merge branch 'doc' into 'master'

Add ssh/OpenGL trouble shooting

See merge request !79
parents 40058875 959b5772
Pipeline #5234 passed with stages
in 6 minutes and 5 seconds
......@@ -14,6 +14,7 @@ films, surfaces or even embedded structures.
install.rst
using.rst
tutorials.rst
troubleshooting.rst
:doc:`install`
How to install *X-SOCS* on Linux
......@@ -24,6 +25,9 @@ films, surfaces or even embedded structures.
:doc:`tutorials`
Video tutorials
:doc:`troubleshooting`
When things do not work as expected
Project Resources
- `Source code repository <https://gitlab.esrf.fr/kmap/xsocs>`_
- `Issue tracker <https://gitlab.esrf.fr/kmap/xsocs/issues>`_
......
Trouble shooting
================
Using XSocs through ssh
-----------------------
XSocs is using OpenGL2.1 for QSpace visualization.
When running through ssh, there are a few reasons that can avoid the display of the 3D QSpace visualization:
- Make sure to use ``ssh -X`` to enable X11 forwarding.
- Both server and client computers must have the same kind of GPU drivers
(either both using proprietary NVidia drivers or both using open source drivers),
otherwise only OpenGL1.4 is available.
- "Indirect GLX" must be enabled on the local computer.
This can be set in the configuration of the display manager or the X server (requires root access).
On Debian 8, for kdm, add ``+iglx`` after ``ServerArgsLocal=...`` in ``/etc/kde4/kdm/kdmrc`` and restart the x server.
\ No newline at end of file
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment