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:

Create a new listener and assign a profile to it.
Assign a profile to an existing listener.
Modify listener settings for both secure (IIOPS and HTTPS) and unsecure protocols (TDS, IIOP, and HTTP).

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-1. Only secure listeners use security profiles.

Table 3-1: Default listener settings
Listener name	Port	Security profile
http	8080
https1	8081	sample1
https2	8082	sample2
iiop	9000
iiops1	9001	sample1
iiops2	9002	sample2
tds	7878
OpenServer	7979

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 (setenv.sh 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 Jaguar Manager or jagtool. For more information, see "Modifying an existing listener" or Chapter 13, "Using jagtool and jagant"

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

You 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 Jaguar 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 Jaguar 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 Jaguar 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.

Creating a new listener

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-2 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 | Listener Properties.
Make your modifications and click Save. Listener properties are described in Table 3-2.

Table 3-2: Listener profile properties
Property	Description	Comments
Protocol	Select the protocol from the drop-down list: HTTP IIOP TDS HTTPS IIOPS	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.
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. Sybase recommends that you provide the IP address of the host instead of the host name. 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.
Port	The port number on the host to which the listener is assigned.	Make sure that the port is not in use by any other service.
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 "Security profiles" in the EAServer Security Administration and Programming Guide.
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.

Deleting a listener

Highlight the listener you want to delete.
Select File | Delete Listener Profile.