Configuring tunnel connections
About this task
Tunnel connections provide a way for targets to connect to the server when there is no other way to connect to each other. You can define multiple tunnel connections. The gateway supports two types of connection, one for each end of a tunnel. The gateway supports tunnels to multiple destinations. For example, if you have a single site with multiple instances of BigFix® Remote Control to support multiple customers. You must define a prefix for each connection parameter so that the gateway can find all required settings for each connection.
Tunnel Connections are configured by using the following parameters:
- ConnectionType
- Defines the type of connection. For example:
tunnel.1.ConnectionType=InboundTunnel
- InboundTunnel
- An inbound tunnel connection is used to configure a gateway to listen for incoming connections from endpoints that want to connect to the server.
- OutboundTunnel
- An outbound tunnel connection, is used to connect the tunnel to the destination, for example the BigFix® Remote Control server.
- The connection types use the following parameters.
-
- Inbound connections.
-
- TunnelID
- The TunnelID is used to associate an inbound connection with the correct outbound connections.
The default value is TRCSERVER. For example:
tunnel.1.TunnelID = TRCSERVER
. This parameter is optional. - PortToListen
- Defines the TCP port that the target must use to connect to the tunnel connection. This parameter is required.
- BindTo
- Defines the IP address that is used to create the connection. This parameter is optional.
- RetryDelay
- Defines the time in seconds to wait before the gateway listens for new connections. This parameter is optional.
- Outbound connections.
-
- TunnelID
- The TunnelID is used to associate an inbound connection with the correct outbound connections.
The default value is TRCSERVER. For example:
tunnel.1.TunnelID = TRCSERVER
. This parameter is optional. - BindTo
- Defines the IP address that is used to create the connection. This parameter is optional.
- Destination Address.
- Defines the IP address of the BigFix® Remote Control Server that the tunnel connection is being made to. This parameter is required.
- DestinationPort
- Defines the TCP port that the BigFix® Remote Control Server is listening on. This parameter is required.
- Timeout
- Defines the time in seconds to wait before a connection attempt is considered to be timed out. This parameter is optional.