Difference between revisions of "Using a VNC Server/Client"

From Hall A Wiki
Jump to: navigation, search
Line 2: Line 2:
 
== Downloading the Software ==
 
== Downloading the Software ==
 
You'll need two pieces of software:
 
You'll need two pieces of software:
[[Image:puttyvncicons.png|thumb|UltraVNC and PuTTY icons on the Desktop]]
+
[[Image:puttyvncicons.png|right|UltraVNC and PuTTY icons on the Desktop]]
* putty (lets the client talk to the remote machine through the firewall):  [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY].
+
** You want to save the '''putty.exe''' to your Desktop.
+
  
 
* VNC client (lets you view the remote screen): [http://www.uvnc.com/download/ UltraVNC]
 
* VNC client (lets you view the remote screen): [http://www.uvnc.com/download/ UltraVNC]
 
** UltraVNC comes in a zip file.  Open it and drag the executable inside to your desktop next to putty.
 
** UltraVNC comes in a zip file.  Open it and drag the executable inside to your desktop next to putty.
  
== Setting up PuTTY ==
+
* putty (lets the client talk to the remote machine through the firewall):  [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html PuTTY].
 +
** You want to save the '''putty.exe''' to your Desktop.
  
==== Run '''putty.exe''' ====
+
 
[[Image:puttystart.png|thumb|PuTTY's connect dialog]]
+
== Setting up PuTTY ==
  
 
==== Configure host name of remote machine ====
 
==== Configure host name of remote machine ====
Fill in the 'Host Name' and 'Saved Sessions' field as shown.
+
* Fill in the '''Host Name''' and '''Saved Sessions''' field as shown.
 +
[[Image:puttystart.png|center|PuTTY's connect dialog]]
  
 
==== Configure user name ====
 
==== Configure user name ====
Select the 'Data' entry under 'Connection' in the left column.   
+
* Select the '''Data''' entry under '''Connection''' in the left column.   
Fill in the 'Auto-login username' field.
+
* Fill in the '''Auto-login username''' field.
[[Image:puttyconfig2.png|thumb|PuTTY's config, username ]]
+
[[Image:puttyconfig2.png|center|PuTTY's config, username ]]
  
 
==== Configure tunnel ====
 
==== Configure tunnel ====
* Click on the '+' next to 'SSH' in the list on the left, then select 'Tunnels'.   
+
* Click on the '''+''' next to '''SSH''' in the list on the left, then select '''Tunnels'''.   
[[Image:puttyconfig2.png|thumb|PuTTY's config, SSH Option ]]
+
* Fill in the '''Source port''' and '''Destination''' fields as shown.
* Fill in the 'Source port' and 'Destination' fields as shown.
+
* ''Then click on the '''Add''' button.''
* '''Then click on the 'Add' button.'''
+
[[Image:puttyconfig1.png|center|PuTTY's config, Tunnel Config ]]
[[Image:puttyconfig2.png|thumb|PuTTY's config, Tunnel Config ]]
+
  
 
==== Save configuration ====
 
==== Save configuration ====
Select the 'Session' entry in the left column (scroll up if you have to),
+
* Select the '''Session''' entry in the left column (scroll up if you have
and click on the 'Save' button.  This will save your settings.
+
* to), and click on the '''Save''' button.  This will save your settings.
[[Image:puttystart.png|thumb|PuTTY's config, main ]]
+
[[Image:puttystart.png|center|PuTTY's config, main ]]
  
 
==== Open the session ====
 
==== Open the session ====
* Select 'hacuser@hacweb2' from the Saved Sessions list and click 'Load'.
+
* Select '''hacuser@hacweb2''' from the Saved Sessions list and click '''Load'''.
* Click on the 'Open' button at the bottom of the dialog box.  A black terminal will open and prompt you for the usual 'hacuser' password.  Type it in and you should get a normal shell prompt.
+
* Click on the '''Open''' button at the bottom of the dialog box.  A black terminal will open and prompt you for the usual '''hacuser''' password.  Type it in and you should get a normal shell prompt.
[[Image:puttyshell.png|thumb|PuTTY's shell ]]
+
 
* You can now minimize this window and setup UltraVNC.
 
* You can now minimize this window and setup UltraVNC.
 +
[[Image:puttyshell.png|center|PuTTY's shell ]]
  
  
Line 44: Line 43:
  
 
====  Run '''vncviewer.exe''' ====
 
====  Run '''vncviewer.exe''' ====
* Enter 'localhost:5901' in the "VNC Server:" field at the top.
+
* Enter '''localhost:5901''' in the "VNC Server:" field at the top.
* Enable the 'Save connection settings as default' at the bottom.
+
* Enable the '''Save connection settings as default''' at the bottom.
[[Image:vncconfig.png|thumb|UltraVNC config window]]
+
[[Image:vncconfig.png|center|UltraVNC config window]]
  
 
====  Connect to the VNC session ====
 
====  Connect to the VNC session ====
 
* Click on the Connect button and you should see a couple of windows pop up:
 
* Click on the Connect button and you should see a couple of windows pop up:
[[Image:vncauth.png|thumb|UltraVNC auth and status windows]]
+
* Enter the '''hacuser''' password in the appropriate box and hit return.
* Enter the 'hacuser' password in the appropriate box and hit return.
+
[[Image:vncauth.png|center|UltraVNC auth and status windows]]
 
* You should be rewarded with the hacuser X session.
 
* You should be rewarded with the hacuser X session.
[[Image:vncwindow.png|thumb|UltraVNC Session]]
 
 
* '''NOTE''': If you get a black screen with yet another password prompt, it means the screen saver software has kicked in.  Just type in the 'hacuser' password again and you'll be good to go.
 
* '''NOTE''': If you get a black screen with yet another password prompt, it means the screen saver software has kicked in.  Just type in the 'hacuser' password again and you'll be good to go.
 +
[[Image:vncwindow.png|center|UltraVNC Session]]
  
 
====  Quitting the VNC session ====
 
====  Quitting the VNC session ====
* Be sure to close the UltraVNC window, '''not''' one of the windows running
+
* Be sure to close the UltraVNC window, ''not'' one of the windows running
 
inside the VNC session.
 
inside the VNC session.
 
* Any program/stripchart that you start inside the VNC session will keep
 
* Any program/stripchart that you start inside the VNC session will keep
Line 66: Line 65:
 
* Type the following at a shell prompt (ie. in an xterm)
 
* Type the following at a shell prompt (ie. in an xterm)
 
   vncviewer -Shared -via hacuser@hacweb2 :1
 
   vncviewer -Shared -via hacuser@hacweb2 :1
* When prompted, enter the 'hacuser' password (twice)
+
* When prompted, enter the '''hacuser''' password (twice)
 
* '''NOTE''': If you get a black screen with yet another password prompt, it means the screen saver software has kicked in.  Just type in the 'hacuser' password again and you'll be good to go.
 
* '''NOTE''': If you get a black screen with yet another password prompt, it means the screen saver software has kicked in.  Just type in the 'hacuser' password again and you'll be good to go.

Revision as of 15:24, 10 November 2009

Instructions for Windows

Downloading the Software

You'll need two pieces of software:

UltraVNC and PuTTY icons on the Desktop
  • VNC client (lets you view the remote screen): UltraVNC
    • UltraVNC comes in a zip file. Open it and drag the executable inside to your desktop next to putty.
  • putty (lets the client talk to the remote machine through the firewall): PuTTY.
    • You want to save the putty.exe to your Desktop.


Setting up PuTTY

Configure host name of remote machine

  • Fill in the Host Name and Saved Sessions field as shown.
PuTTY's connect dialog

Configure user name

  • Select the Data entry under Connection in the left column.
  • Fill in the Auto-login username field.
PuTTY's config, username

Configure tunnel

  • Click on the + next to SSH in the list on the left, then select Tunnels.
  • Fill in the Source port and Destination fields as shown.
  • Then click on the Add button.
PuTTY's config, Tunnel Config

Save configuration

  • Select the Session entry in the left column (scroll up if you have
  • to), and click on the Save button. This will save your settings.
PuTTY's config, main

Open the session

  • Select hacuser@hacweb2 from the Saved Sessions list and click Load.
  • Click on the Open button at the bottom of the dialog box. A black terminal will open and prompt you for the usual hacuser password. Type it in and you should get a normal shell prompt.
  • You can now minimize this window and setup UltraVNC.
PuTTY's shell


Setting up UltraVNC

Run vncviewer.exe

  • Enter localhost:5901 in the "VNC Server:" field at the top.
  • Enable the Save connection settings as default at the bottom.
UltraVNC config window

Connect to the VNC session

  • Click on the Connect button and you should see a couple of windows pop up:
  • Enter the hacuser password in the appropriate box and hit return.
UltraVNC auth and status windows
  • You should be rewarded with the hacuser X session.
  • NOTE: If you get a black screen with yet another password prompt, it means the screen saver software has kicked in. Just type in the 'hacuser' password again and you'll be good to go.
UltraVNC Session

Quitting the VNC session

  • Be sure to close the UltraVNC window, not one of the windows running

inside the VNC session.

  • Any program/stripchart that you start inside the VNC session will keep

running and updating in the background. You can reconnect to the VNC session anytime from (nearly) any machine.

Instructions for Linux

  • Type the following at a shell prompt (ie. in an xterm)
 vncviewer -Shared -via hacuser@hacweb2 :1
  • When prompted, enter the hacuser password (twice)
  • NOTE: If you get a black screen with yet another password prompt, it means the screen saver software has kicked in. Just type in the 'hacuser' password again and you'll be good to go.