remote_graphics.md
... ...
@@ -12,9 +12,9 @@ Using `ssh -Y` or `ssh -X` requires less additional software, but can be problem
12 12
13 13
## Troubleshooting
14 14
15
- 1. If the local system is MacOS and you'r using `ssh -Y` or `ssh -X`, XQuartz needs to be installed and functional. (TODO - more details)
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.
16 17
1. Check if non-OpenGL programs work over the remote connection; if not, programs using OpenGL will definately 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.
17 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.
18
- 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`.
19
-
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 20