Difference between revisions of "TigerVNC"

From bwHPC Wiki
Jump to: navigation, search
(TigerVNC)
Line 22: Line 22:
 
* [[Start VNC Server - bwUniCluster]]
 
* [[Start VNC Server - bwUniCluster]]
 
* [[Start VNC Server - bwForCluster Chemistry]]
 
* [[Start VNC Server - bwForCluster Chemistry]]
  +
* [[Start VNC Server - bwForCluster Chemistry - 3D Acceleration]]
   
 
== Login ==
 
== Login ==
 
The startup script of the VNC server should print detailed instructions on how to establish the connection to the VNC server from your local computer. They depend on whether you
 
The startup script of the VNC server should print detailed instructions on how to establish the connection to the VNC server from your local computer. They depend on whether you
use Windows or Linux and if you work with TightVNC Java Viewer which is a tool that can simplify the process a little bit but needs at least Java version 1.6 to run. Therefore the next steps are
+
use Windows or Linux and if you work with TurboVNC Java Viewer which is a tool that can simplify the process a little bit but needs the Java Development Kit (JDK) to run. Therefore the next steps are
 
divided into 3 cases. Each command should be issued on the local computer.
 
divided into 3 cases. Each command should be issued on the local computer.
   
* '''Login with TightVNC Java Viewer''' <br />Needed Software: [http://www.tightvnc.com/download.php TightVNC Java Viewer], Java<br /> Open TightVNC Java Viewer (the executable is called tightvnc-jviewer.jar), check "Use SSH tunneling" and fill in the parameters provided by the ''run_vncserver'' script. Now you can click on the "Connect" button and enter your passwords.
+
* '''Login with TurboVNC Java Viewer''' <br />Needed Software: [http://www.turbovnc.org/DeveloperInfo/PreReleases TurboVNC 2.0 Beta], JDK<br /> Open TurboVNC Java Viewer (the executable is called VncViewer.jar). Go to Options... -> Security -> Gateway and fill in the parameters provided by the ''run_vncserver'' script. You can save these settings in the "Global" tab if you want to. Now you can click "OK", supply the VNC server and connect to the server. You should be prompted for your ssh password and your VNC password and after that the connection is established.
   
* '''Login without TightVNC Java Viewer for Linux users'''<br />Needed Software: A VNC viewer such as tigervnc, gvncviewer or tightvnc<br />A tunnel must be created with the ssh command given by the ''run_vncserver'' script. Open a new terminal, start a VNC viewer and connect to localhost:n, where n is the display number printed by ''run_vncserver'', using a command such like this<br /><pre>$ vncviewer localhost:1</pre>
+
* '''Login without TightVNC Java Viewer for Linux users'''<br />Needed Software: A VNC viewer such as tigervnc or turbovnc<br />A tunnel must be created with the ssh command given by the ''run_vncserver'' script. Open a new terminal, start a VNC viewer and connect to localhost:n, where n is the display number printed by ''run_vncserver'', using a command such like this<br /><pre>$ vncviewer localhost:1</pre>
   
* '''Login without TightVNC Java Viewer 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 go to Connection -> SSH -> Tunnels. Choose "IPv4" and fill in the parameters provided by ''run_vncserver''. After you clicked "Add" you must navigate to Session and connect to the bwUniCluster with your username and password. Once the connection is established start the tigervnc client and connect to localhost:n where n is the display number printed by ''run_vncserver''.
+
* '''Login without TurboVNC Java Viewer 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 go to Connection -> SSH -> Tunnels. Choose "IPv4" and fill in the parameters provided by ''run_vncserver''. After you clicked "Add" you must navigate to Session and connect to the bwUniCluster with your username and password. Once the connection is established start the tigervnc client and connect to localhost:n where n is the display number printed by ''run_vncserver''.
   
 
== Shutdown ==
 
== Shutdown ==
Line 38: Line 39:
 
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 server properly.
 
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 server properly.
 
[[Category:visualization]][[Category:bwUniCluster]]
 
[[Category:visualization]][[Category:bwUniCluster]]
  +
  +
== Starting OpenGL programs ==
  +
Starting an OpenGL program in a 3D accelerated VNC session results in an error message. In order to fix this issue and redirect OpenGL commands to the graphics card on the cluster you have to use the vglrun command like in the following example:
  +
$ vglrun glxgears -info

Revision as of 17:10, 29 April 2015

1 TigerVNC

TigerVNC
module load vis/tigervnc
License GPL
Links TigerVNC Homepage

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 be used if a graphical software feels slow and has bad responsiveness.

1.1 Start

First, you need to start the VNC server. The exact startup mechanism depends on the cluster.

1.2 Login

The startup script of the VNC server should print detailed instructions on how to establish the connection to the VNC server from your local computer. They depend on whether you use Windows or Linux and if you work with TurboVNC Java Viewer which is a tool that can simplify the process a little bit but needs the Java Development Kit (JDK) to run. Therefore the next steps are divided into 3 cases. Each command should be issued on the local computer.

  • Login with TurboVNC Java Viewer
    Needed Software: TurboVNC 2.0 Beta, JDK
    Open TurboVNC Java Viewer (the executable is called VncViewer.jar). Go to Options... -> Security -> Gateway and fill in the parameters provided by the run_vncserver script. You can save these settings in the "Global" tab if you want to. Now you can click "OK", supply the VNC server and connect to the server. You should be prompted for your ssh password and your VNC password and after that the connection is established.
  • Login without TightVNC Java Viewer for Linux users
    Needed Software: A VNC viewer such as tigervnc or turbovnc
    A tunnel must be created with the ssh command given by the run_vncserver script. Open a new terminal, start a VNC viewer and connect to localhost:n, where n is the display number printed by run_vncserver, using a command such like this
    $ vncviewer localhost:1
  • Login without TurboVNC Java Viewer for Windows users
    Needed Software: tigervnc, Putty
    You need to start Putty and go to Connection -> SSH -> Tunnels. Choose "IPv4" and fill in the parameters provided by run_vncserver. After you clicked "Add" you must navigate to Session and connect to the bwUniCluster with your username and password. Once the connection is established start the tigervnc client and connect to localhost:n where n is the display number printed by run_vncserver.

1.3 Shutdown

To exit your VNC session it is not sufficient to only close the window of the viewer, because this will not terminate the VNC server. The 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 server properly.

1.4 Starting OpenGL programs

Starting an OpenGL program in a 3D accelerated VNC session results in an error message. In order to fix this issue and redirect OpenGL commands to the graphics card on the cluster you have to use the vglrun command like in the following example:

$ vglrun glxgears -info