Configuring servers  Starting the server

Chapter 3: Creating and Configuring Servers

Configuring listeners

A listener is an EAServer port that communicates to clients using various protocols. For protocols that use SSL security features (HTTPS and IIOPS), you assign a security profile to the listener. The profile defines security characteristics of the listener. For protocols that do not use SSL (HTTP, IIOP, and TDS), no security profile is required.

This section describes the tasks required to configure listeners. You can:

Preconfigured listeners

EAServer comes with preconfigured listeners for all protocols. Secure protocols are assigned a predefined security profile.

The default settings for the preconfigured listeners are described in Table 3-9. Only secure listeners use security profiles.

Table 3-9: Default listener settings

Listener name


Security profile





















The default host for these listeners is the name of the machine where the server is started. The host is defined in the setup script ( or setenv.bat) using the JAGUAR_HOST_NAME environment variable. When you install EAServer, the installation process sets JAGUAR_HOST_NAME to the name of your machine. To change the host for a listener, use EAServer Manager or jagtool. For more information, see “Modifying an existing listener” or the jagtool command set_props.

The OpenServer listener is intended for migrating existing Open Server™ applications to EAServer. See Appendix B, “Migrating Open Server Applications to EAServer,” in the EAServer Programmer’s Guide for more information.

NoteYou must restart the server for your changes to take effect. If you have changed the server’s host name and port number, you must also restart EAServer Manager and reconnect to the server using the new host name and port number.

Listener failover

If a server cannot retrieve listener information from the repository for an IIOP listener or if an IIOP listener has not been configured, the server attempts to open a listener at this address:

IIOP: localhost, 9000

Listener start-up can fail if a port is already in use. You can verify the listener addresses in use by viewing the initial log entries in the server_name.log file (where server_name is the name of the server). If the log messages indicate a listener configuration problem, use EAServer Manager to connect to the indicated IIOP address and reconfigure the server’s listener properties.

Creating and configuring listeners

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:

  1. Double-click the Servers folder.

  2. Double-click the server for which you want to create, modify, or delete a listener.

  3. Click the Listeners folder on the left side of the window.

StepsCreating a new listener

  1. Select File | New Listener.

  2. Enter the name of the new listener, then click Create New Listener.

  3. 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.

StepsModifying an existing listener

  1. Highlight the listener you want to modify.

  2. Select File | Properties.

  3. Make your modifications and click Save. Listener properties are described in Table 3-10.

Table 3-10: Listener profile properties




General/ Protocol

Select the protocol from the drop-down list:

  • HTTP

  • IIOP

  • TDS



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 ( 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

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, 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.

NoteIn 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.

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.


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.

StepsDeleting a listener

  1. Highlight the listener you want to delete.

  2. Right-click the listener and select Delete.

Copyright © 2005. Sybase Inc. All rights reserved. Starting the server