Changes in d0eb556: Merge branch 'rgfx0'

				remote_graphics.md
			
          @@ -0,0 +1,20 @@

          +# Troubleshooting using SBGrid Programs with Remote Graphics

          +

          +SBGrid programs can be used with a variety of remote graphics tools, as long as those tools are configured correctly.

          +GUI programs using OpenGL (for example, coot or chimerax - in general, a program used for 3D visualization) can be more problematic than those without it (for example, ccp4i or relion).

          +

          +## Remote Graphics Tools

          +

          +Remote graphics tools generally fall into two categories: `ssh` graphics forwarding, and remote "desktop" tools (for example, RealVNC, XPRA, OOD, FastX - although some of these can display single applications in addition to remote desktops).

          +

          +Using `ssh -Y` or `ssh -X` requires less additional software, but can be problematic to configure correctly (and even when working, tends to be less robust and performant than other approaches).

          +

          +

          +## Troubleshooting 

          +

          + 1. If the local system is MacOS and you're using `ssh -Y` or `ssh -X`, XQuartz needs to be installed and functional for local programs (in other words, `echo $DISPLAY` and `launchctl getenv DISPLAY`).

          + 1. Check the (Workstation Setup Instructions)[workstation_setup] for missing packages.

          + 1. Check if non-OpenGL programs work over the remote connection; if not, programs using OpenGL will definitely not work.  If things are failing at this stage, the XOrg logs (Linux, typically under `/var/log/Xorg.${n}.log`, where `${n}` is the session number) and XQuartz logs (MacOS, typically under `~/Library/Logs/X11/`) usually have information that's helpful for troubleshooting.  

          + 1. Check that `glxinfo` works over the remote connection, and is reporting an OpenGL version equal to or greater than that required by the program you're using.  If `glxinfo` crashes, the same logs mentioned earlier are helpful for troubleshooting.  If `glxinfo` isn't installed, please check the [workstation setup](workstation_setup) page for missing dependencies.

          + 1. If there are still problems, when putting in support requests please include the relevant Xorg/XQuartz logs, `glxinfo` output, `sbinfo` output from the local and remote systems, and (for MacOS) the output of `defaults read org.xquartz.X11` (and `defaults read org.macos.xquartz`).

          +

...	...	@@ -0,0 +1,20 @@
	1	+# Troubleshooting using SBGrid Programs with Remote Graphics
	2	+
	3	+SBGrid programs can be used with a variety of remote graphics tools, as long as those tools are configured correctly.
	4	+GUI programs using OpenGL (for example, coot or chimerax - in general, a program used for 3D visualization) can be more problematic than those without it (for example, ccp4i or relion).
	5	+
	6	+## Remote Graphics Tools
	7	+
	8	+Remote graphics tools generally fall into two categories: `ssh` graphics forwarding, and remote "desktop" tools (for example, RealVNC, XPRA, OOD, FastX - although some of these can display single applications in addition to remote desktops).
	9	+
	10	+Using `ssh -Y` or `ssh -X` requires less additional software, but can be problematic to configure correctly (and even when working, tends to be less robust and performant than other approaches).
	11	+
	12	+
	13	+## Troubleshooting
	14	+
	15	+ 1. If the local system is MacOS and you're using `ssh -Y` or `ssh -X`, XQuartz needs to be installed and functional for local programs (in other words, `echo $DISPLAY` and `launchctl getenv DISPLAY`).
	16	+ 1. Check the (Workstation Setup Instructions)[workstation_setup] for missing packages.
	17	+ 1. Check if non-OpenGL programs work over the remote connection; if not, programs using OpenGL will definitely not work. If things are failing at this stage, the XOrg logs (Linux, typically under `/var/log/Xorg.${n}.log`, where `${n}` is the session number) and XQuartz logs (MacOS, typically under `~/Library/Logs/X11/`) usually have information that's helpful for troubleshooting.
	18	+ 1. Check that `glxinfo` works over the remote connection, and is reporting an OpenGL version equal to or greater than that required by the program you're using. If `glxinfo` crashes, the same logs mentioned earlier are helpful for troubleshooting. If `glxinfo` isn't installed, please check the [workstation setup](workstation_setup) page for missing dependencies.
	19	+ 1. If there are still problems, when putting in support requests please include the relevant Xorg/XQuartz logs, `glxinfo` output, `sbinfo` output from the local and remote systems, and (for MacOS) the output of `defaults read org.xquartz.X11` (and `defaults read org.macos.xquartz`).
	20	+