Commit aa794851 authored by Pavel Jirásek's avatar Pavel Jirásek
Browse files

Merge branch 'vnc-x11-updates' into 'master'

Vnc x11 updates

See merge request !206
parents 76c18542 f1b7f28d
......@@ -76,7 +76,7 @@ username :102
```
!!! note
The VNC server runs on port 59xx, where xx is the display number. So, you get your port number simply as 5900 + display number, in our example 5900 + 61 = 5961. Another example for display number 102 is calculation of TCP port 5900 + 102 = 6002. **Please, calculate your own port number and use it instead of 5961 from examples below!**
The VNC server runs on port 59xx, where xx is the display number. So, you get your port number simply as 5900 + display number, in our example 5900 + 61 = 5961. Another example for display number 102 is calculation of TCP port 5900 + 102 = 6002 but be aware, that TCP ports above 6000 are often used by X11. **Please, calculate your own port number and use it instead of 5961 from examples below!**
To access the VNC server you have to create a tunnel between the login node using TCP port 5961 and your machine using a free TCP port (for simplicity the very same) in next step. See examples for [Linux/Mac OS](#linuxmac-os-example-of-creating-a-tunnel) and [Windows](#windows-example-of-creating-a-tunnel).
......
......@@ -7,13 +7,15 @@ The X Window system is a principal way to get GUI access to the clusters. The **
## X Display
In order to display graphical user interface GUI of various software tools, you need to enable the X display forwarding. On Linux and Mac, log in using the -X option tho ssh client:
### Linux Example
In order to display graphical user interface GUI of various software tools, you need to enable the X display forwarding. On Linux and Mac, log in using the -X option in ssh client:
```console
local $ ssh -X username@cluster-name.it4i.cz
```
## X Display Forwarding on Windows
### PuTTY on Windows
On Windows use the PuTTY client to enable X11 forwarding. In PuTTY menu, go to Connection-SSH-X11, mark the Enable X11 forwarding checkbox before logging in.
......@@ -21,6 +23,23 @@ On Windows use the PuTTY client to enable X11 forwarding. In PuTTY menu, go to C
Then log in as usual.
### WSL (Bash on Windows)
In order to display graphical user interface GUI of various software tools, you need to enable the X display forwarding. Log in using the -X option in ssh client:
```console
local $ ssh -X username@cluster-name.it4i.cz
```
!!! tip
If you are getting error message "cannot open display", then try to export DISPLAY variable, before attempting to log in:
```console
local $ export DISPLAY=localhost:0.0
```
## Verify the Forwarding
To verify the forwarding, type
```console
......@@ -39,11 +58,11 @@ then the X11 forwarding is enabled.
In order to display graphical user interface GUI of various software tools, you need running X server on your desktop computer. For Linux users, no action is required as the X server is the default GUI environment on most Linux distributions. Mac and Windows users need to install and run the X server on their workstations.
## X Server on OS X
### X Server on OS X
Mac OS users need to install [XQuartz server](https://www.xquartz.org).
## X Server on Windows
### X Server on Windows
There are variety of X servers available for Windows environment. The commercial Xwin32 is very stable and rich featured. The Cygwin environment provides fully featured open-source XWin X server. For simplicity, we recommend open-source X server by the [Xming project](http://sourceforge.net/projects/xming/). For stability and full features we recommend the
[XWin](http://x.cygwin.com/) X server by Cygwin
......@@ -94,7 +113,7 @@ In this example, we log in on the r24u35n680 compute node, with the X11 forwardi
The Gnome 2.28 GUI environment is available on the clusters. We recommend to use separate X server window for displaying the Gnome environment.
## Gnome on Linux and OS X
### Gnome on Linux and OS X
To run the remote Gnome session in a window on Linux/OS X computer, you need to install Xephyr. Ubuntu package is
xserver-xephyr, on OS X it is part of [XQuartz](http://xquartz.macosforge.org/landing/). First, launch Xephyr on local machine:
......@@ -120,11 +139,11 @@ xinit /usr/bin/ssh -XT -i .ssh/path_to_your_key yourname@cluster-namen.it4i.cz g
However this method does not seem to work with recent Linux distributions and you will need to manually source
/etc/profile to properly set environment variables for PBS.
## Gnome on Windows
### Gnome on Windows
Use XLaunch to start the Xming server or run the XWin.exe. Select the "One window" mode.
Log in to the cluster, using PuTTY. On the cluster, run the gnome-session command.
Log in to the cluster, using [PuTTY](#putty-on-windows) or [Bash on Windows](#wsl-bash-on-windows). On the cluster, run the gnome-session command.
```console
$ gnome-session &
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment