8#***************************************************************************
#                        SSHUsage  -  description
#                             -------------------
#    title                : KTrafficAnalyzer
#    version              : 0.4.0
#    release-date         : 20.06.2008
#    copyright            : (C) 2003-2008 by Wolfgang 'Vir@s' Koller
#    email                : viras@suselinuxsupport.de
#***************************************************************************

#***************************************************************************
#*                                                                         *
#*   This program is free software; you can redistribute it and/or modify  *
#*   it under the terms of the GNU General Public License as published by  *
#*   the Free Software Foundation; either version 2 of the License, or     *
#*   (at your option) any later version.                                   *
#*                                                                         *
#***************************************************************************

SSH-Usage:
==========
Starting with version 0.3.7 KTA supports reading stats remotely using a SSH-Connection.
In order to use it the following settings have to be made:

- Connect to the SSH-Host once using SSH, so that the question if the host should be added to known
  Hosts doesn't appear anymore
- Setup the SSH-Connection Details in the SSH-Settings Tab of the Settings Dialog BEFORE you switch
  to the SSH-Interface-Handler
- Once all is done change the Interface-Source to SSH. If a list of the remote interfaces appears
  in the interface selection box everything went fine and you can now use it.
  
How does it work?
=================
KTA opens a SSH-session in the background (using ssh command line tool) and reads the traffic-files
with "cat" and "grep". So the tools "cat" and "grep" must be installed on the remote host. KTA keeps
the SSH session open as long as KTA is running, so only one session is needed. This has the advantage
that once the connection is made no more connects are needed, which should increase the speed of
traffic reading a lot.

Troubleshooting
===============
The SSH-Support is experimential ATM. If it doesn't work for you, please turn on debugging in the
settings dialog and send the output on the console to me.