en.help.ref-protocolnew.html Maven / Gradle / Ivy

Go to download




New Protocol

Use the New Protocol page to create a new network protocol.
After you create a protocol, you normally create a network listener with the same name, and you associate the network listener with the protocol. Alternatively, you can create a network listener and have a protocol with default settings created for you at the same time.
The New Protocol 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

The unique name of the protocol. A protocol name cannot begin with a number.

Security

If this option is selected, security is enabled for the protocol. This option is disabled by default. If you enable security, you can use the SSL tab of the Edit Protocol page to modify the security settings.

Status

If this option is selected, the file cache is enabled. This option is enabled by default.

Max Age

The maximum age, in seconds, for a valid cache entry.
This parameter controls how long cached information is used after a file has been cached. An entry older than the maximum age is replaced by a new entry for the same file. If your content changes infrequently, increase this value for improved performance.
The optimum maximum age depends on whether existing files are modified regularly. For example, if files are modified four times a day at regular intervals, consider setting the maximum age to 21600 seconds (6 hours). Otherwise, consider setting the maximum age to the longest time for which you are willing to serve the previous version of a file after the file has been modified.
The default value is 30.

Max Cache Size

The maximum total size (in bytes) of the file cache on disk. The default value is 10485760.

Max File Count

The maximum number of files that can be stored in the file cache.
If the value is too big, the server caches little-needed files, which wastes memory. If the value is too small, the benefit of caching is lost. Try different values of this attribute to find the optimal solution for specific applications.
The default value is 1024.

Server Name

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.

Default Virtual Server

The virtual server to be associated with this protocol. Use the Virtual Servers page to define virtual servers.

Redirect Port

Port value that redirects a request to another port. The GlassFish Server automatically redirects the request if these two conditions exist:


The network listener that references this protocol is supporting non-SSL requests.


A request is received for which a matching security constraint requires SSL transport.


If a redirect port is not specified, the GlassFish Server uses the port number specified in the original request. By default, no port is specified.

Max Connections

Specifies the maximum number of requests that can be pipelined until the connection is closed by the server. The Keep-Alive subsystem periodically polls idle connections. The default value is 256.
Set this property to 1 to disable HTTP/1.0 keep-alive, as well as HTTP/1.1 keep-alive and pipelining. A value of 0 means requests are always rejected. A value of -1 sets no limit to the number of keep-alive connections.

Timeout

The maximum time in seconds that a connection can be deemed as idle and kept in the keep-alive state. A value of 0 or less means that keep-alive connections are kept open indefinitely. The default value is 30 seconds.

Upload Timeout

If this option is selected, the connection for a servlet that reads bytes slowly is closed after the Connection Upload Timeout limit is reached. If this option is disabled, servlet connections do not time out. This option is disabled by default.

Connection Upload Timeout

The timeout for uploads, in milliseconds. This field is applicable only if the Upload Timeout Enabled checkbox is selected. The default value is 300000 milliseconds.

Request Timeout

The number of seconds before a request times out. If the request is not processed before the timeout value is reached, the request is ignored. The default value is 30 seconds.

Send Buffer Size

The size in bytes of the send buffer. The default value is 8192 bytes.

Header Buffer Length

The size in bytes of the buffer used by the request processing threads to read the request data. The default value is 8192 bytes.

Max Post Size

The maximum size in bytes of POST actions. The default value is 2097152 bytes.

URI Encoding

The name of the character set used to decode the request URIs received. The value must be a valid IANA character set name. The default value is UTF-8.

Version

The version of the HTTP protocol used. The default value is HTTP/1.1.

Compression

Specifies the use of HTTP/1.1 GZIP compression to save server bandwidth. Available choices are:

on

Compresses data.

off

Disables compression.

force

Forces data compression in all cases.


The default value is off.

Compressible Mime Types

A comma-separated list of MIME types for which HTTP compression is used. The default value is text/html,text/xml,text/plain.

Compression Minimum Size

The minimum size of a file when compression is applied. This value must be set if Compression is set to on or force. The default value is 2048 bytes.

No-Compression User Agents

A comma-separated list of regular expressions matching user-agents of HTTP clients for which compression should not be used. By default, this value is an empty string.

Restricted User Agent

A list of restricted user agents on which HTTP compression is applied. If no user agents are specified, HTTP compression is applied to all user agents. By default, no user agents are specified.

Default Response Type

A string that specifies the default response type. The format is a semicolon-delimited string consisting of the content-type, encoding, language, and charset. The default value is text/html; charset=iso-8859-1.

Forced Response Type

A string that specifies the request type used if no MIME mapping is available that matches the file extension. The format is a semicolon-delimited string consisting of the content-type, encoding, language, and charset. The default value is text/html; charset=iso-8859-1.

Adapter

The class name of the static resources adapter. The default value is com.sun.grizzly.tcp.StaticResourcesAdapter.

Comet Support

If this option is selected, Comet support is enabled for the network listener that references this protocol. By default, this option is disabled. If your servlet or JSP page uses Comet technology, make sure it is initialized when the GlassFish Server starts up by adding the load-on-startup element to your web.xml file. For example:
<servlet>
<servlet-name>CheckIn</servlet-name>
<servlet-class>CheckInServlet</servlet-class>
<load-on-startup>0</load-on-startup>
</servlet>

DNS Lookup

If this option is selected, DNS lookup is enabled. This option is disabled by default.

DNS Lookup

If this option is selected, DNS lookup is enabled. This option is disabled by default.

RCM Support

If this option is selected, Resource Configuration Management (RCM) is enabled. This option is disabled by default.

Trace

If this option is selected, the TRACE operation is enabled. If this option is disabled, the GlassFish Server is less susceptible to cross-site scripting attacks. This option is enabled by default.

Auth Pass Through

If this option is selected, it indicates that the network listener that uses this protocol receives traffic from an SSL-terminating proxy server. This option is disabled by default.

Chunking

If this option is selected, HTTP response chunking is enabled. This option is enabled by default.

XPowered By

If this option is selected, X-Powered-By headers are used according to the Java Servlet 3.0 and Java Server Pages 2.0 specifications. This option is enabled by default.

Encoded Slash

If this option is selected, URIs are permitted to contain encoded slashes. This option is disabled by default.

Websockets Support

If this option is selected, the WebSockets protocol is supported. This option is disabled by default.



Related Tasks


To Create a Protocol


To Edit a Protocol


To Edit SSL Settings for a Protocol


To Edit HTTP Settings for a Protocol


To Edit File Cache Settings for a Protocol


To Delete a Protocol



Related asadmin Commands


create-protocol(1)


list-protocols(1)


delete-protocol(1)




Copyright © 2005, 2017, Oracle and/or its affiliates. All rights reserved. Legal Notices