Difference between revisions of "JUSTUS2/Visualization"

From bwHPC Wiki
Jump to: navigation, search
m
(159 intermediate revisions by 8 users not shown)
Line 1: Line 1:
  +
{{Softwarepage|vis/tigervnc}}
= TigerVNC =
 
  +
{|{{Softwarebox}}
 
  +
{| width=600px class="wikitable"
 
|-
 
|-
  +
! Description !! Content
! colspan="2" style="text-align:center" | TigerVNC
 
 
|-
 
|-
 
| module load
 
| module load
Line 8: Line 9:
 
|-
 
|-
 
| License
 
| License
  +
| [https://en.wikipedia.org/wiki/GNU_General_Public_License GPL]
| GPL
 
  +
|-
  +
| Citing
  +
| n/a
 
|-
 
|-
 
| Links
 
| Links
| [http://www.tigervnc.org TigerVNC Homepage]
+
| [http://www.tigervnc.org/ Homepage]
|
 
 
|-
 
|-
 
| Graphical Interface
 
| Graphical Interface
 
| No
 
| No
 
|}
 
|}
  +
= Description =
'''TigerVNC''' is a high-performance implementation of VNC (Virtual Network Computing), a client/server application that allows
 
  +
users to launch and interact with graphical applications on remote machines. It should be faster than standard X11 forwarding and thus can
 
  +
'''TigerVNC''' is a high-performance implementation of Virtual Network Computing (VNC). VNC is a client/server application that allows
  +
users to launch and interact with graphical applications on remote machines. It is usually faster than standard X11 forwarding and thus should
 
be used if a graphical software feels slow and has bad responsiveness.
 
be used if a graphical software feels slow and has bad responsiveness.
   
== Instructions ==
+
= Overview =
  +
  +
You will need to do the following steps to use VNC on the cluster:
  +
* start a vnc server on the cluster - This will create a virtual desktop on that node
  +
* make an ssh tunnel to allow outside access for yourself to the server
  +
* use a vnc client on your home desktop to connect to the virtual desktop
  +
* kill the vnc server after you finshed
  +
  +
= VNC Server =
  +
  +
First, you have to start the VNC Server on the cluster. The startup procedure depends on the cluster and hardware you are using.
  +
  +
* [[VNC Server - bwUniCluster 2.0]]
  +
* [[VNC Server - bwForCluster Chemistry]]
  +
* [[VNC Server - bwForCluster Chemistry - 3D Acceleration]]
  +
  +
The VNC server will open a virtual display with a display number. It will e.g. be called ":01"
  +
  +
= Create a Tunnel =
  +
  +
* VNC port: The connection port is on 59XX. A display :01 will have port 5901, a display :02 will have port 5902 etc.
  +
  +
The script <code>run_vncserver </code> gives you instructions on how to create the tunnel. It will fill in the correct user name and port for your case.
  +
  +
* '''Linux/Unix Commandline'''
  +
<code>ssh -fCL port:localhost:port user@justus2-login03.rz.uni-ulm.de</code>
  +
  +
-f: sends the ssh into the background
  +
  +
-C: compress all data
  +
  +
-L local_port:host:hostport: "local" port forwarding. The port on the remote machine can be accessed on the machine from where you run ssh
  +
  +
If you have to go via more than one linux machine, you can chain several of these ssh tunnels.
  +
  +
* '''Putty on Windows '''
  +
<code> Connection -> SSH -> Tunnels</code>
  +
  +
Source Port: 59XX
  +
  +
Destination: justus2-login03.rz.uni-ulm.de:59XX
  +
  +
* ''' TightVNC (Java Client) '''
  +
  +
This client (and only the Java version of the client!) allows to configure ssh tunneling as part of opening the VNC connection. See description in the following client section
  +
  +
= VNC Client =
  +
  +
The startup script of the VNC Server should have printed out detailed instructions about how to establish a connection to the VNC Server from your local computer. These instructions depend on the operating system (e.g., Linux/macOS, MS Windows) you are using and if you work with TurboVNC Java Viewer which is a tool that can simplify the handling but needs the Java Development Kit (JDK) to run. Therefore, the next steps are divided into three cases. The commands should be executed on the local computer.
  +
  +
* '''Login using TurboVNC Java Viewer''' <br />Needed software: [http://turbovnc.org/ TurboVNC], JDK<br /> Open the TurboVNC Java Viewer and navigate to Options... -> Security -> Gateway to fill in the parameters provided by the ''run_vncserver'' script. You can save these settings in the "Global" tab if you want to. Subsequently, click "OK" and connect to the cluster by supplying the VNC Server as given to you by ''run_vncserver''. Before the connection is established, you should be prompted for your SSH and VNC password, respectively.
  +
  +
* '''TigerVNCLinux Debian-based''' <code>sudo apt install tigervnc-viewer</code> fill in information supplied by ''run_vncserver'', e.g. <code>xtigervncviewer :3</code>
  +
  +
* '''Login using TightVNC Java Viewer''' <br />Needed software: [http://www.tightvnc.com/download.php TightVNC] <br />Start the TightVNC Viewer: On Linux, open a terminal and execute the following command: <code>$ java -jar tightvnc-jviewer.jar</code>. On Windows, just double-click ''tightvnc-jviewer.jar'' in the Windows Explorer. <br />Fill in the parameters given to you by the ''run_vncserver'' script (see example below), add your username at SSH User, and press connect to establish a VNC session.
  +
  +
{| style="width: 100%; border-spacing: 20px;"
  +
| [[File:TightVNC.png|left|500px]]
  +
|}
  +
  +
* '''Login without TurboVNC Java Viewer for Linux users''' <br />Needed software: A VNC Client such as TurboVNC <br />A SSH tunnel must be created with the command given to you by the ''run_vncserver'' script, e.g.: <code>$ ssh -fCL 5903:localhost:5903 <UserID>@justus2-vis01.rz.uni-ulm.de</code> <br />Start your VNC Client and connect to localhost:n, where n is the display number, using the command given to you by the ''run_vncserver'' script. E.g.: <code>$ vncviewer localhost:3</code>
  +
  +
* '''Login without TurboVNC Java Viewer for Windows users'''<br />Needed software: [https://tigervnc.org/ TigerVNC], [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty] <br />Start Putty and navigate to Connection -> SSH -> Tunnels to fill in the parameters provided by the ''run_vncserver'' script. Subsequently, clicked "Add" and navigate to Session to connect with the cluster using your username and password. Once the connection is established, start the TigerVNC Client and connect to localhost:n, where n is the display number provided by ''run_vncserver''.
  +
<br>
  +
  +
= Shutdown your VNC session =
  +
  +
To exit your VNC session it is not sufficient to only close the VNC viewer, since this will not terminate the VNC Server. The VNC Server will keep running and you will run into problems when you try to start a new VNC session later on. Please use the "log out" function of the desktop environment inside the VNC session, this will terminate the VNC server properly. Alternatively, you can terminate the VNC Server on the compute cluster using
  +
<pre>
  +
$ vncserver -kill :n
  +
</pre>
  +
with n specifying the display number.
   
  +
= OpenGL applications within VNC sessions =
First, you need to start the VNC server on the bwunicluster. Therefore you must log into the bwunicluster with your username and password as usual.
 
You should not start the server on a login node but request an interactive job using for example the following command.
 
$ msub -v HOME,TERM,USER,DISPLAY -S /bin/bash -I -l nodes=1:ppn=1 -l walltime=0:02:00:00
 
On your assigned compute node start the VNC server with
 
$ module load vis/tigervnc
 
$ run_vncserver
 
If you start a VNC server for the first time you will be asked to set a password. Use a strong password as usual
 
because otherwise an attacker could take control of your VNC session.
 
The script prints detailed instructions on how to establish the connection to the VNC server with your computer. They depend on whether you
 
use Windows or Linux and if you work with ssvnc which is a tool that can simplify the process a little bit. Therefore the next steps are
 
divided into 3 cases. Each command should be issued on the local computer.
 
   
  +
Executing an OpenGL program during a 3D accelerated VNC session will issue an error. In order to fix this, open a terminal window and run your application through the VirtualGL wrapper using the vglrun command like in the following example for the benchmark application glxgears:
* '''Login with ssvnc''' <br />Needed Software: [http://www.karlrunge.com/x11vnc/ssvnc.html ssvnc]<br /> Open ssvnc and fill in the parameters provided by the run_vncserver script. Check "Use SSH" and click on the "Connect" button.
 
  +
<pre>
  +
$ vglrun glxgears -info
  +
</pre>
   
* '''Login without ssvnc for Linux users'''<br />Needed Software: A VNC viewer such as tigervnc, gvncviewer or tightvnc<br />A tunnel must be created with the command given by the run_vncserver script. Open a new terminal, start a VNC viewer and connect to localhost:1 using a command such like this<br /><pre>$ vncviewer localhost:1</pre>
 
   
* '''Login without ssvnc for Windows users'''<br />Needed Software: [http://sourceforge.net/projects/tigervnc/files/tigervnc/1.3.0 tigervnc], [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty]<br />You need to start Putty and add a tunnel in Connection -> SSH -> Tunnels with the parameters provided by run_vncserver. Now you can start tigervnc and connect to localhost:1
 
   
  +
[[Category:Visualization]]
== Shutdown ==
 
  +
[[Category:BwUniCluster_2.0]]
If you want to exit your VNC session don't just close the window because then the VNC server won't terminate and you will run into problems
 
  +
[[Category:BwForCluster_JUSTUS_2]]
when you try to start a new VNC session later. If you log out of Gnome properly the VNC server will terminate automatically.
 

Revision as of 15:38, 21 December 2021

The main documentation is available via module help vis/tigervnc on the cluster. Most software modules for applications provide working example batch scripts.


Description Content
module load vis/tigervnc
License GPL
Citing n/a
Links Homepage
Graphical Interface No

1 Description

TigerVNC is a high-performance implementation of Virtual Network Computing (VNC). VNC is a client/server application that allows users to launch and interact with graphical applications on remote machines. It is usually faster than standard X11 forwarding and thus should be used if a graphical software feels slow and has bad responsiveness.

2 Overview

You will need to do the following steps to use VNC on the cluster:

  • start a vnc server on the cluster - This will create a virtual desktop on that node
  • make an ssh tunnel to allow outside access for yourself to the server
  • use a vnc client on your home desktop to connect to the virtual desktop
  • kill the vnc server after you finshed

3 VNC Server

First, you have to start the VNC Server on the cluster. The startup procedure depends on the cluster and hardware you are using.

The VNC server will open a virtual display with a display number. It will e.g. be called ":01"

4 Create a Tunnel

  • VNC port: The connection port is on 59XX. A display :01 will have port 5901, a display :02 will have port 5902 etc.

The script run_vncserver gives you instructions on how to create the tunnel. It will fill in the correct user name and port for your case.

  • Linux/Unix Commandline

ssh -fCL port:localhost:port user@justus2-login03.rz.uni-ulm.de

-f: sends the ssh into the background

-C: compress all data

-L local_port:host:hostport: "local" port forwarding. The port on the remote machine can be accessed on the machine from where you run ssh

If you have to go via more than one linux machine, you can chain several of these ssh tunnels.

  • Putty on Windows

Connection -> SSH -> Tunnels

Source Port: 59XX

Destination: justus2-login03.rz.uni-ulm.de:59XX

  • TightVNC (Java Client)

This client (and only the Java version of the client!) allows to configure ssh tunneling as part of opening the VNC connection. See description in the following client section

5 VNC Client

The startup script of the VNC Server should have printed out detailed instructions about how to establish a connection to the VNC Server from your local computer. These instructions depend on the operating system (e.g., Linux/macOS, MS Windows) you are using and if you work with TurboVNC Java Viewer which is a tool that can simplify the handling but needs the Java Development Kit (JDK) to run. Therefore, the next steps are divided into three cases. The commands should be executed on the local computer.

  • Login using TurboVNC Java Viewer
    Needed software: TurboVNC, JDK
    Open the TurboVNC Java Viewer and navigate to Options... -> Security -> Gateway to fill in the parameters provided by the run_vncserver script. You can save these settings in the "Global" tab if you want to. Subsequently, click "OK" and connect to the cluster by supplying the VNC Server as given to you by run_vncserver. Before the connection is established, you should be prompted for your SSH and VNC password, respectively.
  • TigerVNCLinux Debian-based sudo apt install tigervnc-viewer fill in information supplied by run_vncserver, e.g. xtigervncviewer :3
  • Login using TightVNC Java Viewer
    Needed software: TightVNC
    Start the TightVNC Viewer: On Linux, open a terminal and execute the following command: $ java -jar tightvnc-jviewer.jar. On Windows, just double-click tightvnc-jviewer.jar in the Windows Explorer.
    Fill in the parameters given to you by the run_vncserver script (see example below), add your username at SSH User, and press connect to establish a VNC session.
TightVNC.png
  • Login without TurboVNC Java Viewer for Linux users
    Needed software: A VNC Client such as TurboVNC
    A SSH tunnel must be created with the command given to you by the run_vncserver script, e.g.: $ ssh -fCL 5903:localhost:5903 <UserID>@justus2-vis01.rz.uni-ulm.de
    Start your VNC Client and connect to localhost:n, where n is the display number, using the command given to you by the run_vncserver script. E.g.: $ vncviewer localhost:3
  • Login without TurboVNC Java Viewer for Windows users
    Needed software: TigerVNC, Putty
    Start Putty and navigate to Connection -> SSH -> Tunnels to fill in the parameters provided by the run_vncserver script. Subsequently, clicked "Add" and navigate to Session to connect with the cluster using your username and password. Once the connection is established, start the TigerVNC Client and connect to localhost:n, where n is the display number provided by run_vncserver.


6 Shutdown your VNC session

To exit your VNC session it is not sufficient to only close the VNC viewer, since this will not terminate the VNC Server. The VNC Server will keep running and you will run into problems when you try to start a new VNC session later on. Please use the "log out" function of the desktop environment inside the VNC session, this will terminate the VNC server properly. Alternatively, you can terminate the VNC Server on the compute cluster using

$ vncserver -kill :n

with n specifying the display number.

7 OpenGL applications within VNC sessions

Executing an OpenGL program during a 3D accelerated VNC session will issue an error. In order to fix this, open a terminal window and run your application through the VirtualGL wrapper using the vglrun command like in the following example for the benchmark application glxgears:

$ vglrun glxgears -info