dietForwarder man page

dietForwarder — DIET tool to manage ssh tunnels between DIET components


dietForwarder - Tool for creating DIET forwarders. Forwarders are special components that serve as proxies and manage ssh tunnels between DIET components in complex networks.


dietForwarder [options] ...


Deploying DIET on heterogeneous networks that are not reachable by means other than ssh tunnels is a delicate task. DIET forwarders are special DIET components that serve as proxies between DIET components by creating ssh tunnels.

dietForwarder is a command to instantiate DIET forwarders. Forwarders simplify the maintenance of ssh tunnels between DIET components, thus improving DIET's scalability and ease of configuration in complex network topologies.

Before starting a DIET forwarder, you must:

[Remark: forwarders must be launched before the DIET hierarchy.]


--name [name]

String identifying the forwarder.

--peer-name [name]

String identifying its peer on the other network.

--ssh-host [host]

Host hosting the ssh tunnel.

--ssh-login [login]

Login used to establish the ssh connection (default: current user login).

--ssh-key [/path/to/ssh/key]

Path to the ssh key (the private one!) used to establish the ssh connection (default: $HOME/.ssh/id_rsa).

--remote-port [port]

Port the ssh host is listening on.

--remote-host [host]

Host to which the connection is made by the tunnel (corresponds to ssh options -L and -R).

--nb-retry [nb]

Number of times that the local forwarder will try to bind itself to the remote forwarder (default: 3).

--peer-ior [IOR]

Passes the remote forwarder's IOR. By default, the local forwarder will retrieve its peer's IOR.

--tunnel-wait [seconds]

Set the number of seconds to wait before considering that the tunnel has been created.


Here is a simple configuration example:

Command line for launching Fwd1

fwd.net1$ dietForwarder --name Fwd1 --peer-name Fwd2 \
  --ssh-host fwd.net2 --ssh-login dietUser \
  --ssh-key id rsa net2 --remote-port 50000

Command line to launch Fwd2

fwd.net2$ dietForwarder --name Fwd2


DIET uses CORBA as its communication layer. While it is a flexible and robust middleware, it remains hard to deploy DIET on heterogeneous networks that are not reachable except through ssh tunnels. DIET forwarders help the administrator to configure their grid without manually setting-up ssh tunnels, which is arguably neither simple nor scalable. DIET forwarders make it very easy to configure networks with such topologies.


GRAAL INRIA Rhone-Alpes 46 allee d'Italie 69364 Lyon cedex 07, FRANCE Email: <> WWW:

See Also

omniNames(1), DIETAgent(1)


On some systems, forwarder rules will not work unless you use IP addresses instead of hostnames.


License: CeCILL

Referenced By

dietAgent(1), logForwarder(1), maDagAgent(1).

2011-01-10 0.1