====== Windows VNC connection ======

Connections from Windows computers have not been extensively tested. Please test your connection ahead of time.

  * Tested Software
    * Windows XP, 7, or 8.1
    * [[wp>PuTTY]] 
    * [[wp>TightVNC]] viewer

==== Setup ====

  - Install TightVNC
    * Only the viewer is necessary.
  - Install PuTTY 
    * Install in ''c:\program files\putty\''
    * The firewall exception may not work if the executable (''putty.exe'') is in another location
  - Add a firewall rule. Only do this once.
    * In Windows 7
<code>
  Control Panel
    Windows Firewall
     Inbound Rules
       New Rule
         type
           program
         program
           putty      # enter path to putty.exe
         action
           allow
         apply
           all
         name
           putty
</code>
  *
    * In Windows 8.1
<code>
  Control Panel
    Windows Firewall
      Allow app through firewall
        change settings
        add another app
          putty       # browse to app
</code>

  * Configue ssh tunnels
    * Replace //**user**// with your user name on kilauea.
    * If additional vnc desktops are needed, add additional tunnels to the putty configuration. Change the source and destination ports appropriately. For example, 12347 and 5903 for session kilauea:3 (dsos).
<code>
  Putty
   configuration
     connection
       ssh
         tunnels
           source
             12345               # or other available port
           destination
             localhost:5901      # port for spectrometer display
           Local
           Add                   # Must add the tunnel
           source
             12346               # or other available port
           destination
             localhost:5902      # port for uip windows
           Local
           Add                   # Must add the tunnel
     session
       host
         user@kilauea.caltech.edu   # kilauea user id
       saved sessions
         kilauea                 # enter name before saving
       save  
</code>


==== Connection ====

  * Start ssh connection with tunnels

<code>
  Putty
   configuration
     session
       saved sessions
         kilauea
           load       
   open
  # enter password 
</code>

  * Start the VNC viewer.
    * Open as many VNC viewers as needed. Change the port numbers appropriately.
<code>
  TightVNC viewer
   new connection
     remote host
       localhost:12345           # match putty source port for spectrometers
   new connection
     remote host
       localhost:12346           # match putty source port for uip
</code>