Sun Java System Application Server Platform Edition 8.2 Administration Guide

Admin Console Tasks for the HTTP Service

ProcedureTo configure the HTTP Service

  1. In the tree component, expand the Configuration node.

  2. Select the HTTP Service node.

  3. On the HTTP Service page, you can set properties that apply to all of the service’s HTTP listeners.

    The following table lists these properties.

    Property Name  

    Description  

    Default Value  

    bufferSize

    Specifies the size (in bytes) of the buffer to be provided for input streams created by HTTP listeners. 

    4096 

    connectionTimeout

    Specifies the number of milliseconds HTTP listeners wait, after accepting a connection, for the request URI line to be presented. 

    12000 (12 seconds) 

    maxKeepAliveRequests

    Specifies the maximum number of HTTP requests that can be pipelined until the connection is closed by the server. Set this property to 1 to disable HTTP/1.0 keep-alive, as well as HTTP/1.1 keep-alive and pipelining. 

    1000 

    traceEnabled

    If set to true, enables the TRACE operation. Set this property to false to make the Application Server less susceptible to cross-site scripting attacks. 

    true 

    accessLogBufferSize

    Specifies the size, in bytes, of the buffer where access log calls are stored. If the value is less than 5120, a warning message is issued, and the value is set to 5120. 

    32,768 bytes 

    accessLogWriterInterval

    The number of seconds before the log will be written to the disk. The access log is written when the buffer is full or when the interval expires. If the value is 0, then the buffer is always written even if it is not full. This means that each time the server is accessed, the log message is stored directly to the file. 

    300 seconds 

  4. Click the Access Log tab to configure access log rotation.

  5. Click Save.

  6. Stop and restart the Application Server.

ProcedureTo configure the HTTP Service access log

Use this page to enable and configure rotation for the access logs for the virtual servers. These logs are in the domain-dir/logs/access directory and are named as follows: virtual-server-name_access_log%YYYY;%MM;%DD-%hh;h%mm;m%ss;s.

Click Default to load the default values.

  1. Check the File Rotation box to turn on file rotation.

    By default, file rotation is enabled.

  2. From the Rotation Policy drop-down list, choose a policy.

    The only policy available is time.

  3. In the Rotation Interval field, type a numeric value to specify the number of minutes between rotations of the access log.

    This field is valid only if the Rotation Policy is time. The default is 1440 minutes.

  4. In the Rotation Suffix field, type a string value to specify the suffix to be added to the log file name after rotation.

    The default is %YYYY;%MM;%DD;-%hh;h%mm;m%ss;s.

  5. In the Format field, enter a string value to specify the format of the access log.

    Use the formats shown in the following table. The default format is %client.name% %auth-user-name% %datetime% %request% %status% %response.length%.

    Data  

    Token  

    Client Host Name 

    %client.name%

    Client DNS 

    %client.dns%

    System Date 

    %datetime%

    Full HTTP Request line 

    %request%

    Status 

    %status%

    Response Content Length 

    %response.length%

    Referer Header 

    %header.referer%

    User-agent 

    %header.user-agent%

    HTTP Method 

    %http-method%

    HTTP URI 

    %http-uri%

    HTTP Query String 

    %query-str%

    HTTP Protocol Version 

    %http-version%

    Accept Header 

    %header.accept%

    Date Header 

    %header.date%

    If-Modified-Since Header 

    %header.if-mod-since%

    Authorization Header 

    %header.auth%

    Any valid HTTP header value defined in RFC 2616 (any is also a valid header value; it is specified as a variable here)

    %header.any%

    Name of Authorized User 

    %auth-user-name%

    Value of a Cookie 

    %cookie.value%

    Virtual Server ID 

    %vs.id%

  6. Click Save to save the changes, or Load Defaults to return to the default settings.