Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Reference

- Previous: Subelements
- Next: http-protocol

### Attributes

The following table describes attributes for the `http-listener` element.

Table 1–60 `http-listener` Attributes

Attribute | Default | Description
--- | --- | ---
`id` | none | The unique listener name. An `http-listener` name cannot begin with a number.
`address` | none | IP address of the listener. Can be in dotted-pair or IPv6 notation. Can be `any` (for `INADDR_ANY`) to listen on all IP addresses. Can be a hostname.
`port` | none | Port number on which the listener listens. Legal values are `1` - `65535`. On UNIX, creating sockets that listen on ports `1` - `1024` requires superuser privileges. Configuring an SSL listener to listen on port 443 is standard.
`external-port` | none | (optional) Specifies the external port on which the connection is made.
`family` | `inet` | (optional) Specifies whether the IP address is an `inet` or `ncsa` address.
`blocking-enabled` | `false` | (optional) If `true`, enables blocking on both the external and listener ports.
`acceptor-threads` | `1` | (optional) Number of acceptor threads for the listener, typically the number of processors in the machine. Legal values are `1` - `1024` .
`security-enabled` | `false` | (optional) Determines whether the listener runs SSL. To turn SSL2 or SSL3 on or off and set ciphers, use an `ssl` subelement.
`default-virtual-server` | none | References the `id` attribute of the default virtual-server for this particular listener.
`server-name` | none | Tells the server what to put in the host name section of any URLs it sends to the client. This affects URLs the server automatically generates; it doesn’t 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.
`redirect-port` | none | (optional) If the listener is supporting non-SSL requests and a request is received for which a matching `<security-constraint>` requires SSL transport, the request is automatically redirected to the port number specified here.
`xpowered-by` | `true` | (optional) If true, `X-Powered-By` headers are used according to the Servlet 2.4 and JSP 2.0 specifications.
`enabled` | `true` | (optional) Determines whether the listener is active.

- Previous: Subelements
- Next: http-protocol

- © 2010, Oracle Corporation and/or its affiliates