= Viewing Client Video on Your Local Machine =

For demos and testing it is frequently helpful to view a video or other display that would be on a client machine.  This How To explains how to tunnel HTTP traffic over an SSH tunnel onto your local machine.

{{{
#!html
<img src="http://groups.geni.net/geni/raw-attachment/wiki/HowTo/ForwardVideoOverSSH/SSHForward.png" width="800" alt="How to SSH Forward"/>
}}}

== Setup ==

 * There is a `server` machine running an apache server or equivalent
 * There is a `client` machine that is able to access `server` via the data plane
 * Your SSH keys are loaded onto `client` by GENI so that it is possible for you to SSH to the client from your local machine using a command similar to the following
{{{
ssh jdoe@pc2.instageni.ku.gpeni.net -p 34106
}}}

== Instructions ==
 1. Create an `~/.ssh/config` on your local machine contain the following (or append the following to an existing config):
{{{
Host vlc-client
  # The IP or hostname of the client you want to view the video from
  HostName pc2.instageni.ku.gpeni.net
  # The SSH port of the client you want to view the video from
  Port 34106
  # Your SSH username
  User jdoe
  # Pick a port to forward from your local machine; IP address and port of the data plane address of the server you are trying to connect to
  LocalForward 6080 10.10.1.1:80
  # The private ssh key you want to use to connect
  IdentityFile /home/jdoe/.ssh/id_geni_ssh_rsa
}}}
 1. On your local machine, run:
{{{
ssh vlc-client
}}}
 1. Leave the SSH connection open
 1. On your local machine, browse to:
{{{
http://localhost:6080
}}}