This section describes how to create, modify, and delete a listener. All of the configuration tasks require you to first access the Listeners folder from EAServer Manager:
Double-click the Servers folder.
Double-click the server for which you want to create, modify, or delete a listener.
Click the Listeners folder on the left side of the window.
Select File | New Listener.
Enter the name of the new listener, then click Create New Listener.
Complete the information in the Listener Info window. See Table 3-10 for the listener property descriptions.
The new listener appears on the right side of the window when you highlight the Listeners folder.
Modifying
an existing listener
Highlight the listener you want to modify.
Select File | Properties.
Make your modifications and click Save. Listener properties are described in Table 3-10.
Property |
Description |
Comments |
|---|---|---|
General/ Protocol |
Select the protocol from the drop-down list:
|
HTTPS and IIOPS are secure protocols that provide all of the security features made available by SSL, including authentication and encryption. TDS, IIOP, and HTTP do not provide encryption. TDS and IIOP provide user name and password-based authentication. |
General/ Host |
The name or IP address of the EAServer host to which the listener is being assigned. |
For predefined listeners, the value is set to the name of the machine where the server is started using the JAGUAR_HOST_NAME environment variable, which is defined in the setup script (setenv.sh or setenv.bat). You can also set the value to the IP address of the machine where the server is started using the JAGUAR_IP_ADDRESS environment variable. For servers that accept Internet connections, include the domain name to allow clients outside your domain to connect, as in www.trysybase.com. 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
|
General/ Port |
The port number on the host to which the listener is assigned. |
Verify that the port is not in use by any other service. |
General/ Jaguar Security Profile |
Select one of the preconfigured security profiles from the drop-down list. This field is enabled for only the secure protocols (HTTPS or IIOPS). |
You can create new security profiles that can be assigned to a listener. For more information, see “Configuring security profiles” in the EAServer Security Administration and Programming Guide. |
General/ Enable Open Server Events |
When selected, the TDS port accepts Open Server client connections; if not, only MASP requests are accepted. |
You must use TDS as the protocol for Open Server events. |
General/ Log SSL Errors |
When selected, additional information about SSL errors is logged. |
|
General/ Connection Request Pool Size |
For Solaris only. Configures 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. |
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. |
HTTP/ Keep Alive |
For HTTP or HTTPS only. Specifies the time in seconds to keep open the server side of an idle HTTP connection. |
If not specified, the default is 120. |
HTTP// Maximum Requests |
For HTTP or HTTPS only. Specifies the maximum number of HTTP requests to service before closing each connection. |
If not specified, the default is 100. |
HTTP// Enable Connector |
For HTTP or HTTPS only. You must enable this option if you use the EAServer Web server redirector between HTTP clients and the EAServer HTTP listener. |
WARNING! This property must be set to true when clients connect via the Web server redirector. Otherwise, the HTTP response can be incorrect. |
Resources/ Maximum Response Time |
The maximum allowable average response time for each request, in seconds. |
If the average response time rises above this limit, EAServer blocks additional connections until the average drops below the specified limit. The default is -1, which indicates no time limit. |
Resources/ Minimum Number of Connections |
When the Maximum Response Time is set to a non-default value, specifies the minimum number of clients that must be allowed to execute regardless of observed response times. |
The default is -1, which means no new connections are blocked by the Performance Monitor. For more information on this feature, see Chapter 9, “Using the Performance Monitor,” in the EAServer Performance and Tuning Guide. |
Advanced |
Allows you to configure properties in their “raw” format. |
See Listener properties. |
Using ports less than 1024 On UNIX platforms, if you configure listeners using port numbers less than 1024, you must start the server with a user ID that has root privileges. See “Changing the effective user ID of the server process”for more information.
Highlight the listener you want to delete.
Right-click the listener and select Delete.
In certain cases, a client may not be able to resolve
a host name. For example, the client’s DNS server or hosts file
does not have an entry for the specified host. To avoid issues with such
clients, specify the IP address in the listener configuration. 