The X Window System is a basic framework for a GUI enviroment which allows for drawing and moving windows on the display
device. The project is maintained by the x.org foundation where you can
find more documentation.
X Window supports GUI applications such as MATLAB, adding a visual component to SSHing into a node.
Pick your operating system
Windows Tutorial
MobaXTerm
- If you are off-campus ensure you are connected to UofSC’s VPN see connecting to an HPC
- Launch MobaXTerm and click on the session tab
- Click on the SSH tab. Then select the "Advanced SSH Settings" tab and then make sure the
"X11-Forwarding" box is checked
- Now enter the remote host, for Hyperion this is login.rci.sc.edu, see getting started for the other
systems, all ports are 222. Press open to connect.
- Type in your username and password and confirm Duo Multifactor Authentication as prompted
- Now you’re on the login node. Type “idevx_11” to launch your own session. This can take some time to
process the allocation. Do not run X11 sessions on the login node.
- Use “xeyes &” as a test program.
- You should see an eyes animation window appear from MobaXTerm
- Exit your “idev_x11” session as soon as is practical.
PuTTY with MobaXTerm
- If you are off-campus ensure you are connected to UofSC’s VPN see connecting to an HPC
- Launch an X Server application. For this example we'll be using MobaXTerm but you can also use the vt100 application, XMing or another X11 fowarding client
- Launch PuTTY, ensure that the X11 forwarding is enabled. This
option can be found under
Connections -> SSH -> X11
and then check the “Enable X11
forwarding” box.
- In the "X display location" box enter
localhost:0
- Now under the session tab in PuTTY enter the hostname, for Hyperion this is login.rci.sc.edu, see getting started for the other
systems, all ports are 222. Press open to connect.
- Type in your username and password and confirm Duo Multifactor Authentication as prompted
- Now you’re on the login node. Type “idevx_11” to launch your own session. This can take some time to
process the allocation. Do not run X11 sessions on the login node.
- Use “xeyes &” as a test program.
- You should see an eyes animation window appear from the X Server Application (not PuTTY/SSH terminal)
- Exit your “idev_x11” session as soon as is practical.
Mac OS X Catalina Tutorial
- If you are off-campus ensure you are connected to UofSC’s VPN see connecting to an HPC
- Download and install the latest version of XQuartz from https://www.xquartz.org
- Start XQuartz.
- Under the
XQuartz > Preferences… > Security tab
, make sure both the “Authenticate connections” and
“Allow connections from network clients” check boxes are checked.
- I exited and restarted XQuartz, just to be sure. It is possible this step is not necessary.
- When connecting to the HPC, use the ssh “-Y” flag instead of the “-X” flag to force trusted connections.
Use a command like
ssh -Y -P <port>
<username>@<host>
- It appears that the “Warning: No xauth data; using fake authentication data for X11 forwarding” message
can be safely ignored.
- Use “idev_x11” from the login node to get an interactive session with X11 forwarding. Do not run X11
sessions on the login node.
- Use “xeyes &” as a test program.
- Exit your “idev_x11” session as soon as is practical.
Linux
- If you are off-campus ensure you are connected to UofSC’s VPN see connecting to an HPC
- To connect to the a server with X Window:
ssh -X -P[port] [username]@[loginnode]
- Use “idev_x11” from the login node to get an interactive session with X11 forwarding. Do not run X11
sessions on the login node.
- Use “xeyes &” as a test program.
- Exit your “idev_x11” session as soon as is practical.