A listener is part of a service. It defines a port or an "ip:port" couple to listen for incoming TCP connections.

Listeners are identified by a name and the name of the containing service. Allowed characters include alpha-numeric, dot, dash, and underscore.

address

  • Definition: IP address to listen on

  • Type: ip

  • Default value: Mandatory, no default available.

  • Particular value: 0.0.0.0 to listen on all IP addresses present on load balancer

port

  • Definition: TCP port to listen on

  • Type: port

  • Default value: Mandatory, no default available.

SSL

Note

This attribute can be set and it is mandatory if SSl is enabled.

  • Definition: Enable ssl processing on incoming connections.

  • Type: enum

  • Default value: SSL processing is disabled

Value

Description

enabled

SSl processing is enabled

SSL-certificate

  • Definition: Certificate name used to process SSL on this listener

  • Type: string

  • Default value: SSL processing is disabled

TCP-user-timeout

  • Definition: Set the TCP User Timeout for the connections handled by this listener. It corresponds to a period without acknowledgment by a client.

  • Type: integer

  • Default value: 0, means not set

transparent

  • Definition: Incoming connections to listener's IP and port are intercepted even if the IP is not present on the load balancer (i. e. a router routes connections to the load balancer).

  • Type: enum

  • Default value: Intercept only connections to IP configured on the load balancer.