From 0321a3210ef6bb42ef8b536d0964bef081294d1d Mon Sep 17 00:00:00 2001 From: Jerome Date: Fri, 25 Dec 2009 04:11:25 -0500 Subject: Define autossh::tunnel resource and improve initscript --- README | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) (limited to 'README') diff --git a/README b/README index e69de29..4143856 100644 --- a/README +++ b/README @@ -0,0 +1,42 @@ +This module manages autossh tunnels between hosts. + + +Prerequisites +============= + +* The user has to be able to log in to the remote ssh system automatically, + ssh-agent and/or authorized_keys can be used to accomplish this + +* SSH port forwarding must be enabled on the remote host + + +Example +======= + +autossh::tunnel { 'mysql': + ensure => present, + user => 'tunnel', + port => 3307, + hostport => 3306, + remote_host => 'mysql.example.org', +} + +This will establish an ssh connection as user 'tunnel', to remote server +'mysql.example.org' with port forwarding enabled. Connections on localhost to +port '3307' with be forwarded through the tunnel to 'localhost', port 3306. + +Only connections originating from 'localhost' will be accepted into the tunnel. +If you wish to allow other hosts on the network to use this tunnel, you may +specify an explicit interface to bind the connection to using 'bind_address'. +A value of '*' will bind to all interfaces. + +Furthermore, if you wish to use the remote host as a gateway to another host on +the network, you may specify it using the 'host' parameter. + + +More info +========= + +* AutoSSH README : http://www.harding.motd.ca/autossh/README + +* SSH manual : http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1 -- cgit v1.2.3