Listener property
names begin with com.sybase.jaguar.listener. Listeners
define the protocols, port numbers, and optional SSL security profiles
for client connections to a server.
Specifies the host name or IP address for the listener.
The host name or IP address, or one of the following placeholders:
Placeholder |
To indicate |
|---|---|
|
The name of the host where the server process is running. |
|
The IP address of the host where the server is running. |
Use one of the placeholders if you must use the same listener configuration in multiple EAServer installations. Include the domain if your server accepts internet connections, otherwise clients outside your domain cannot connect.
If your machine supports multiple network addresses, you can
enter each host name or IP address in a list separated by commas.
You can also enter the special value 0.0.0.0,
which causes EAServer to listen on all of the machine’s
host or IP addresses. When using multiple host addresses, EAServer
creates a listener for each host on the specified port.
Specifies the time in seconds to keep open the server side of an idle HTTP connection.
The time in seconds. If not specified, the default is 120.
Specifies the maximum number of HTTP requests to service before closing each connection.
The maximum, as a positive integer. If not specified, the default is 100.
Must be set to true if you use the EAServer Web server redirector between HTTP clients and the EAServer HTTP listener.
true or false.
The default is false.
WARNING! This property must be set to true when clients connect via the Web server redirector. Otherwise, the HTTP response can be incorrect.
Specifies whether to log additional SSL error information for connections handled by the listener.
true or false.
The default is false.
com.sybase.jaguar.security.logsslerr
Specifies the maximum allowable response time for each request. If the average response time rises above this limit, EAServer blocks additional connections until the average drops below the specified limit.
The maximum allowable response time, in seconds. The default is -1, which indicates no time limit.
com.sybase.jaguar.listener.monitor.MinInstance
Chapter 9, “Using the Performance Monitor,” in the EAServer Performance and Tuning Guide.
When response time monitoring is in effect (com.sybase.jaguar.listener.monitor.MaxRespTime is set to a non-negative value), specifies the minimum numer of clients that must be allowed to execute regardless of observed response times.
The minimum number of clients. The default is -1, which means no new connections are blocked by the Performance Monitor.
com.sybase.jaguar.listener.monitor.MaxRespTime
Chapter 9, “Using the Performance Monitor,” in the EAServer Performance and Tuning Guide.
Specifies the listener name.
Server_listener
Where Server is the server name where this listener is installed, and listener is the unqualified listener name. For example:
Jaguar_iiops1
Specifies the port number.
The integer port number.
Specifies the protocol for connections accepted by this listener.
Allowable values are:
HTTP
IIOP
TDS
HTTPS
IIOPS
For listeners that use a tunnelled SSL protocol (such as HTTPS or IIOPS), specifies the security profile used to configure the SSL session settings.
The name of the security profile, which must match the com.sybase.jaguar.security.name property of the security profile.
When running on Solaris, specifies the pool size for outstanding connection requests.
Values must be a positive integer less than or equal to 4096. If this property is not set, the default is 128. Values greater than 4096 are truncated to 4096 to avoid excessive memory allocation at startup.
This property is used on Solaris only. When the server is very busy, all available threads may be in use when a connect request arrives. These pending connect requests are pooled until they can be handled. If the pool size is too small, client connection requests may time out before the server can handle the request.
You can configure different request pool sizes for different protocols. For example, if the server is handling mostly HTTP requests, you can increase the request pool size for the HTTP listener while leaving the IIOP request pool size at a low value.
The connection request pool size affects the server memory requirements:
mem = entries * 20K
That is, each entry requires about 20K of memory reserved at server startup.
For TDS listeners, specifies whether this listener accepts Open Server client connections.
The only allowable value for this property is os.
If the property is set with no value, or not set, the listener will
not accept Open Server client connections.
EAServer allows you to install Open Server event handlers so that you can migrate legacy Sybase Open Server applications to EAServer. The event handlers are called only for connections to a listener that uses the TDS protocol and that has the com.sybase.jaguar.listener.type property set to “os”. For more information on this feature, see Appendix B, “Migrating Open Server Applications to EAServer,” in the EAServer Programmer’s Guide.
