X11_forwarding.md - #317
Open
Graviton28 wants to merge 1 commit into
Open
Graviton28 wants to merge 1 commit into
Graviton28 wants to merge 1 commit into
Conversation
Tested the non-visual parts of the documented pipeline end-to-end on Easley: ssh -Y correctly forwards a DISPLAY to the login node (confirmed with a real XQuartz session and xauth list), srun --x11 --pty bash is accepted by Slurm (not rejected as an invalid flag - some clusters don't build Slurm with X11 support, which would have made this whole doc wrong) and forwards a fresh DISPLAY to the allocated compute node, module load matlab succeeds there, and matlab launches cleanly with no early fatal errors (prints its banner, runs a test command successfully). Added a note documenting the "No DISPLAY variable set" error srun gives if --x11 is used without ssh -Y/-X first, since that's a real, easy-to-hit mistake worth calling out explicitly. Could not verify the one thing this environment has no way to test: whether the MATLAB GUI window actually renders on a local screen, since there's no display attached to run this from. Documented that as an explicit, inherent limitation rather than implying it was confirmed. All three external links (xquartz.org, mobaxterm.mobatek.net, YouTube video, and the XQuartz releases page) confirmed live (200 OK). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Graviton28
marked this pull request as draft
August 4, 2026 02:43
Graviton28
marked this pull request as ready for review
August 4, 2026 04:54
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
verified everything non-visual in this doc live on easley: ssh -Y forwards a DISPLAY (confirmed with a real local xquartz session and xauth list on the remote side), srun --x11 --pty bash is accepted by slurm without error and forwards DISPLAY to the compute node (confirming easley's slurm build actually has x11 forwarding support enabled, not guaranteed on every cluster), module load matlab succeeds, and matlab launches cleanly with no early fatal errors.
added one small fix: a note about the "srun: error: No DISPLAY variable set, cannot setup x11 forwarding." error you get if you run srun --x11 without having connected with ssh -Y/-X first, an easy mistake to make.
heads up on what i couldn't verify: whether the matlab gui window actually renders on a local screen. that's inherently outside what's testable from an environment with no attached display, it depends on the user's own local x server working correctly. everything upstream of that (ssh forwarding, slurm's --x11 support, matlab launching) is confirmed live now rather than just asserted.