| <!-- |
| |
| Copyright (c) 2005, 2018 Oracle and/or its affiliates. All rights reserved. |
| |
| This program and the accompanying materials are made available under the |
| terms of the Eclipse Public License v. 2.0, which is available at |
| http://www.eclipse.org/legal/epl-2.0. |
| |
| This Source Code may also be made available under the following Secondary |
| Licenses when the conditions for such availability set forth in the |
| Eclipse Public License v. 2.0 are satisfied: GNU General Public License, |
| version 2 with the GNU Classpath Exception, which is available at |
| https://www.gnu.org/software/classpath/license.html. |
| |
| SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 |
| |
| --> |
| |
| <p><a id="task-protocolhttpedit" name="task-protocolhttpedit"></a><a id="GHWEB00045" name="GHWEB00045"></a></p> |
| |
| <h4><a id="sthref59" name="sthref59"></a><a id="sthref60" name="sthref60"></a>To Edit HTTP Settings for a Protocol</h4> |
| <a name="BEGIN" id="BEGIN"></a> |
| <ol> |
| <li> |
| <p>In the navigation tree, expand the Configuration node.</p> |
| </li> |
| <li> |
| <p>Under the Configuration node, expand the Network Config node.</p> |
| </li> |
| <li> |
| <p>Under the Network Config node, select the Protocols node.</p> |
| <p>The Protocols page opens.</p> |
| </li> |
| <li> |
| <p>On the Protocols page, click the name of the protocol that you are editing.</p> |
| <p>The Edit Protocol page opens.</p> |
| </li> |
| <li> |
| <p>On the Edit Protocol page, click the HTTP tab.</p> |
| <p>The HTTP page opens.</p> |
| </li> |
| <li> |
| <p>In the Server Name field, type the host name to be used in the URLs the server sends to the client.</p> |
| <p>This name is the alias name if your server uses an alias. If your server does not use an alias, leave this field blank.</p> |
| </li> |
| <li> |
| <p>From the Default Virtual Server drop-down list, select the virtual server to be associated with the protocol.</p> |
| <p>Use the Virtual Servers page to define virtual servers.</p> |
| </li> |
| <li> |
| <p>In the Redirect Port field, type the port value to be used to redirect a request to another port.</p> |
| <p>The GlassFish Server automatically redirects the request if these two conditions exist:</p> |
| <ul> |
| <li> |
| <p>This protocol is supporting non-SSL requests.</p> |
| </li> |
| <li> |
| <p>A request is received for which a matching security constraint requires SSL transport.</p> |
| </li> |
| </ul> |
| <p>If a redirect port is not specified, the GlassFish Server uses the port number specified in the original request.</p> |
| </li> |
| <li> |
| <p>In the Max Connections field, type the maximum number of persistent connections to be maintained in Keep-Alive mode.</p> |
| <p>The Keep-Alive subsystem periodically polls idle connections.</p> |
| </li> |
| <li> |
| <p>In the Timeout field, type the maximum time in seconds that a connection can be deemed as idle and kept in the keep-alive state.</p> |
| <p>A value of 0 or less means that keep-alive connections are kept open indefinitely. The default value is 30 seconds.</p> |
| </li> |
| <li> |
| <p>Select the Upload Timeout Enabled checkbox to cause the connection for a servlet that reads bytes slowly to be closed after the Connection Upload Timeout limit is reached.</p> |
| <p>If this option is disabled, servlet connections do not time out. This option is disabled by default.</p> |
| </li> |
| <li> |
| <p>In the Connection Upload Timeout field, type the timeout for uploads, in milliseconds.</p> |
| <p>This field is applicable only if the Upload Timeout Disabled checkbox is selected. The default value is 300000 milliseconds.</p> |
| </li> |
| <li> |
| <p>In the Request Timeout field, type the number of seconds before a request times out.</p> |
| <p>If the request is not processed before the timeout value is reached, the request is ignored. The default value is 30 seconds.</p> |
| </li> |
| <li> |
| <p>In the Send Buffer Size field, type the size in bytes of the send buffer.</p> |
| <p>The default value is 8192 bytes.</p> |
| </li> |
| <li> |
| <p>In the Header Buffer Length field, type the size in bytes of the buffer used by the request processing threads to read the request data.</p> |
| <p>The default value is 8192 bytes.</p> |
| </li> |
| <li> |
| <p>In the Max Post Size field, type the maximum size in bytes of POST actions.</p> |
| <p>The default value is 2097152 bytes.</p> |
| </li> |
| <li> |
| <p>In the URI Encoding field, type the name of the character set used to decode the request URIs received.</p> |
| <p>The value must be a valid IANA character set name. The default value is UTF-8.</p> |
| </li> |
| <li> |
| <p>In the Version field, type the version of the HTTP protocol used.</p> |
| <p>The default value is HTTP/1.1.</p> |
| </li> |
| <li> |
| <p>From the Compression drop-down list, select the use of HTTP/1.1 GZIP compression to save server bandwidth.</p> |
| <p>Available choices are:</p> |
| <dl> |
| <dt><code>on</code></dt> |
| <dd> |
| <p>Compresses data.</p> |
| </dd> |
| <dt><code>off</code></dt> |
| <dd> |
| <p>Disables compression.</p> |
| </dd> |
| <dt><code>force</code></dt> |
| <dd> |
| <p>Forces data compression in all cases.</p> |
| </dd> |
| </dl> |
| <p>The default value is <code>off</code>.</p> |
| </li> |
| <li> |
| <p>In the Compressible Mime Type field, type a comma-separated list of MIME types for which HTTP compression is used.</p> |
| <p>The default value is <code>text/html,text/xml,text/plain</code>.</p> |
| </li> |
| <li> |
| <p>In the Compression Minimum Size field, type the minimum size of a file when compression is applied.</p> |
| <p>This value must be set if Compression is set to <code>on</code> or <code>force</code>. The default value is 2048 bytes.</p> |
| </li> |
| <li> |
| <p>In the No-Compression User Agents field, type a comma-separated list of regular expressions matching user-agents of HTTP clients for which compression should not be used.</p> |
| <p>By default, this value is an empty string.</p> |
| </li> |
| <li> |
| <p>In the Restricted User Agents field, type a list of restricted user agents on which HTTP compression is applied.</p> |
| <p>If no user agents are specified, HTTP compression is applied to all user agents. By default, no user agents are specified.</p> |
| </li> |
| <li> |
| <p>In the Default Response Type field, type a string that specifies the default response type.</p> |
| <p>The format is a semicolon-delimited string consisting of the content-type, encoding, language, and charset. The default value is <code>text/html; charset=iso-8859-1</code>.</p> |
| </li> |
| <li> |
| <p>In the Forced Response Type field, type a string that specifies the request type used if no MIME mapping is available that matches the file extension.</p> |
| <p>The format is a semicolon-delimited string consisting of the content-type, encoding, language, and charset. The default value is <code>text/html; charset=iso-8859-1</code>.</p> |
| </li> |
| <li> |
| <p>In the Adapter field, type the class name of the static resources adapter.</p> |
| <p>The default value is <code>com.sun.grizzly.tcp.StaticResourcesAdapter</code>.</p> |
| </li> |
| <li> |
| <p>Select the Comet Support Enabled checkbox to enable Comet support for the protocol.</p> |
| <p>This option is disabled by default.</p> |
| </li> |
| <li> |
| <p>Select the DNS Lookup Enabled checkbox to enable Domain Name System (DNS) lookup.</p> |
| <p>This option is disabled by default.</p> |
| </li> |
| <li> |
| <p>Select the RCM Support Enabled checkbox to enable Resource Configuration Management (RCM).</p> |
| <p>This option is disabled by default.</p> |
| </li> |
| <li> |
| <p>Select the Trace Enabled checkbox to enable the TRACE operation.</p> |
| <p>If this option is disabled, the GlassFish Server is less susceptible to cross-site scripting attacks. This option is enabled by default.</p> |
| </li> |
| <li> |
| <p>Select the Auth Pass Through checkbox to indicate that the network listener that uses this protocol receives traffic from an SSL-terminating proxy server.</p> |
| <p>This option is disabled by default.</p> |
| </li> |
| <li> |
| <p>Select the Chunking Enabled checkbox to enable HTTP response chunking.</p> |
| <p>This option is enabled by default.</p> |
| </li> |
| <li> |
| <p>Select the XPowered By Enabled checkbox to tell the GlassFish Server to use <code>X-Powered-By</code> headers according to the Java Servlet 3.0 and Java Server Pages 2.0 specifications.</p> |
| <p>This option is enabled by default.</p> |
| </li> |
| <li> |
| <p>Click Save.</p> |
| |
| <hr> |
| <p><b>Tip:</b></p> |
| <p>To return to the default settings, click the Load Defaults button, then click Save.</p> |
| |
| <hr> |
| |
| </li> |
| </ol> |
| <a id="sthref61" name="sthref61"></a> |
| <h5>See Also</h5> |
| <ul> |
| <li> |
| <p><a href="task-networklistenernew.html">To Create a Network Listener</a></p> |
| </li> |
| <li> |
| <p><a href="task-networklisteneredit.html">To Edit a Network Listener</a></p> |
| </li> |
| <li> |
| <p><a href="task-networklistenerdelete.html">To Delete a Network Listener</a></p> |
| </li> |
| <li> |
| <p><a href="task-protocolnew.html">To Create a Protocol</a></p> |
| </li> |
| <li> |
| <p><a href="task-protocoledit.html">To Edit a Protocol</a></p> |
| </li> |
| <li> |
| <p><a href="task-protocolssledit.html">To Edit SSL Settings for a Protocol</a></p> |
| </li> |
| <li> |
| <p><a href="task-protocolfilecacheedit.html">To Edit File Cache Settings for a Protocol</a></p> |
| </li> |
| <li> |
| <p><a href="task-protocoldelete.html">To Delete a Protocol</a></p> |
| </li> |
| <li> |
| <p><a href="task-transportnew.html">To Create a Transport</a></p> |
| </li> |
| <li> |
| <p><a href="task-transportedit.html">To Edit a Transport</a></p> |
| </li> |
| <li> |
| <p><a href="task-transportdelete.html">To Delete a Transport</a></p> |
| </li> |
| </ul> |
| |
| |
| <small>Copyright © 2005, 2017, Oracle and/or its affiliates. All rights reserved. <a href="docinfo.html">Legal Notices</a></small> |