Subject: Admin

Keywords: ::vnc

Title: vncviewer

--------------------------------------------------
  
We expect users will interact with nuprl using vnc.
Vnc is remote desktop. There is server that will run
on host running nuprl, and viewer that will run on users
local machine. One big advantage to using vnc is that you
can close the viewer without affecting open windows in the 
viewer as they actually exist in the server.

The vncserver runs on the nuprl server, so users
need only install the viewer. Different OS's use different clients.
We've had positive experinces with these viewers: 
Ubuntu Vinagre Remote Desktop Viewer.
Windows TightVNC
Mac Chicken of the VNC

Nuprl uses TWM (see twmas window manager.

*** Note: if you are connecting to nuprl.cs.cornell.edu (ie not 128.84.105.105)
the vncserver will likely be managed for you.

When you first ssh to the nuprl server you do need to start
vncserver. We have various scripts to use depending on the
geometry you desire; vnc1, vnc1t, vnc2, vnc2t, vnc3, or vnc3t.
These will start vncserver with the corresponding geometries:
1280x1024, 1280x1536, 2048x1024, 2048x1536, 3072x1024, or 3072x1536.
These scripts take single argument which will be the name of the
vnc session. Using your userid is helpful if other people might 
view your session. The script will print message such as:
VNC <name> 2048x1024 started. Display is :11. 
The :11 in that message is your display number. It correleates with
vnc socketport. The port number will be 5900 display number. In
this example 5911 would be the port number. The port number 
is needed when tunneling the vnc session and the display number is
needed by your vncviewer.

Note: when you kill your vncviewer and exit your ssh connection, your vnc server
remains running. When you next use nuprl, you need only connect with same tunnel
and restart your vncviewer and your nuprl desktop will be as you left it.  

Vnc ports will normally be tunnelled through SSH (see ssh). This
tunneling makes it appear to your local machine as though the VNC is local,
thus you would connect to localhost:5911. As the vncviewer expects ports
starting with 59xx you can  connect to localhost:11.
Note: Chicken of the VNC users should specify host as localhost and display as 11. 


Since SSH provides secure
access the vnc password is generally nuprlvnc. If using nuprl's 
public servers, that does allow other users to acces your DeskTop 
but that is considered good thing if you need help.

--------------------------------------------------

Authors: NUPRL:t

Contributors: VINCENT:t



Home