- Have working terminal set up.
X-11 is a protocol for rendering graphical user interfaces (GUIs) that can be sent along an SSH tunnel. If you plan on using a GUI on a NeSI cluster you will need to have an X-Server and X-Forwarding set up.
You must have a X-server running on your local machine in order for a GUI to be rendered.
Download links for X-servers can be found below.
Make sure you have launched the server and it is running in the background, look for this symbol in your taskbar
MobaXterm has a build in X server, no setup required. By default the server is started alongside MobaXterm. You can check it's status in the top left hand corner (=on, =off).
Finally your ssh tunnel must be set up to 'forward' along X-11 connections.
Make sure the
-X flag is included
ssh -Y email@example.com
ssh -Y login.nesi.org.nz
Under 'session settings' for your connection make sure the X-11 forwarding box is checked.
If the button in the top right corner of your window is coloured, the X-server should be running.
X-Forwarding with tmux
In order to connect X11 into a tmux session you make the following change to your config file.
tmux show -g | sed 's/DISPLAY //' > ~/.tmux.conf
Interactive Slurm jobs
In order to make use of X11 in an interactive Slurm job:
Add the flag
srun --ntasks 36 --mem-per-cpu 1500 --time 01:00:00 --x11 --pty bash
add the flag -Y when sshing to the node.
ssh -Y wbn001