Requirements

• 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.

X-Servers

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.

MacOS	Xquartz
Linux	Xorg
Windows	Xming

Make sure you have launched the server and it is running in the background, look for this  symbol in your taskbar 

Note

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). 

X-Forwarding

Finally your ssh tunnel must be set up to 'forward' along X-11 connections. 

OpenSSH (terminal)

Make sure the -Y or -X flag is included

ssh -Y user@lander.nesi.org.nz

ssh -Y login.nesi.org.nz

MobaXterm

 Under 'session settings' for your connection make sure the X-11 forwarding box is checked.

X-Forwarding With tmux

In order to connect X11 into your tmux session you make the following change to your config file.

tmux show -g | sed 's/DISPLAY //' > ~/.tmux.conf

Interactive sessions

In order to make use of X11 in an interactive session:

srun

Add the flag --x11

srun --ntasks 36 --mem-per-cpu 1500 --time 01:00:00 --x11 --pty bash

salloc

add the flag -Y when sshing to the node.

ssh -Y wbn001