New Network Listener

Use the New Network Listener page to create a new network listener.

When you create a network listener, you can simultaneously create a protocol that the network listener will use, or use a protocol that you create first. Typically, there is a one-to-one relationship between a network listener and its associated protocol, but this is not required.

The New Network Listener page contains the following options.

Configuration Name

The name of the configuration to which the settings on this page apply. This field is read only.

Name

A unique listener name. A network listener name cannot begin with a number.

Protocol

The protocol associated with the network listener. The following options specify whether to create a protocol or use an existing one.

Create a New Protocol

A new protocol with default settings is created for the network listener. The default name of the protocol is the name of the network listener with -protocol appended, but you can edit this value.

Virtual Server

For a new protocol, the virtual server to be associated with the protocol.

Use an Existing Protocol

The selected protocol is used. The protocol determines whether security is enabled for the network listener.

Status

The status of the network listener. The listener can be enabled or disabled. This option is enabled by default. If the listener is disabled, any attempts to connect to the listener result in a socket exception (java.net.ConnectException).

In GlassFish Server versions prior to 9.1, a listener whose enabled attribute was set to false returned a 404 response code for any requests sent to it. To achieve this behavior in the current GlassFish Server version, set the listener's status to enabled, and set every associated virtual server's state to OFF. A virtual server lists its associated listeners in its Network Listeners drop-down list.

Security

If this option is selected, security is enabled for the protocol used by the network listener. The Security field is a read-only field.

If you are configuring the admin-listener for the domain administration server (DAS), which uses the server-config configuration, this option is read-only. To enable security for this listener, you must enable secure administration. See Secure Administration.

JK Listener

If this option is selected, the listener supports Apache's mod-jk protocol. The mod-jk protocol is a proprietary communication/network protocol between Apache's httpd (web server) and an GlassFish Server back-end instance. If the listener supports this protocol, httpd is supposed to handle all static content, whereas any requests for dynamic resources (i.e., Servlets and JSPs) are routed to the mod-jk enabled network listener of the GlassFish Server, using the mod-jk protocol. This option is disabled by default.

Port

The port number on which the listener will listen. Legal values are 1 through 65535. On a UNIX system, creating sockets that listen on ports 1 through 1024 requires superuser privileges.

Address

The IP address on which the network listener will listen. The address can be in dotted-pair or IPv6 notation. It can be any (for INADDR_ANY) to listen on all IP addresses. It can be a hostname.

Thread Pool

The thread pool associated with the network listener. Normally, you select one of the two thread pools that are configured when you install the GlassFish Server.

Transport

The type of transport for the network listener. By default, the only choice is tcp.

Related Tasks
Related asadmin Commands
Copyright © 2005, 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices