Use the New HTTP Listener page to create a new HTTP listener.
When you create an HTTP listener, the SSL tab is available for you to edit as well.
The New HTTP Listener page contains the following options.
The name of the configuration to which the settings on this page apply. This field is read only.
A unique listener name. An HTTP listener name cannot begin with a number.
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.
The status of the HTTP 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.
If this option is selected, security is enabled for the HTTP listener. This option is disabled by default.
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.
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 HTTP listener of the GlassFish Server, using the mod-jk
protocol. This option is disabled by default.
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.
The virtual server to be associated with this HTTP listener. Use the Virtual Servers page to define virtual servers.
The thread pool associated with the HTTP listener. Normally, you select one of the two thread pools that are configured when you install the GlassFish Server.
The host name to be used in the URLs the server sends to the client. This name is the alias name if your server uses an alias. If your server does not use an alias, leave this field blank.
This value affects URLs the server automatically generates; it does not affect the URLs for directories and files stored in the server. If your server uses an alias, the server-name should be the alias name. If a colon and port number are appended, that port is used in URLs the server sends to the client. If a scheme and ://
are prepended, the scheme will be used in the URLs.