Skip to content

Commit

Permalink
doc/overview: document proxy settings
Browse files Browse the repository at this point in the history
Document the proxy settings.

Signed-off-by: Rouven Czerwinski <r.czerwinski@pengutronix.de>
  • Loading branch information
Emantor authored and jluebbe committed Jul 5, 2019
1 parent dc1e39f commit f614d27
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions doc/overview.rst
Expand Up @@ -335,3 +335,21 @@ file names refer to a shared filesystem (such as NFS or SMB).


For exporters which are not directly accessible via SSH, add the host to your For exporters which are not directly accessible via SSH, add the host to your
.ssh/config file, with a ProxyCommand when need. .ssh/config file, with a ProxyCommand when need.

Proxy Mechanism
~~~~~~~~~~~~~~~

Both client and exporter support the proxy mechanism which uses SSH to tunnel
connections to a remote host. To enable and force proxy mode on the exporter use
the :code:`-i` or :code:`--isolated` command line option. This indicates to clients that all
connections to remote resources made available by this exporter need to be
tunneled using a SSH connection.
On the other hand, clients may need to access the remote infrastrucure using a
SSH tunnel. In this case the :code:`LG_PROXY` environment variable needs to be
set to the remote host which should tunnel the connections. The client than
forwards all network traffic through SSH, even the coordinator connection is
forwarded. This means that with :code:`LG_PROXY` and :code:`LG_CROSSBAR` labgrid can be used
fully remotely with only a SSH connection as a requirement.
One remaining issue here is the forward of UDP connections, which is currently
not possible. UDP connections are used by some of the power backends in the form
of SNMP.

0 comments on commit f614d27

Please sign in to comment.