e-docs > WebLogic Server > WebLogic Server Configuration Reference > WebServer

WebLogic Server Configuration Reference

 Previous Next Contents Index View as PDF  

WebServer

 

Description

This bean represents the configuration of virtual web server within a weblogic server. Note that a server may define multiple web servers to support virtual hosts.

This MBean represents a virtual host.

 

Syntax

<WebServer
  AcceptContextPathInGetRealPath=( "true" | "false" )
  AuthCookieEnabled=( "true" | "false" )
  Charsets="java.util.Map"
  ChunkedTransferDisabled=( "true" | "false" )
  ClusteringEnabled=( "true" | "false" )
  DefaultServerName="String"
  DefaultWebApp="WebAppComponent name"
  DeploymentOrder="number"
  FrontendHTTPPort="number"
  FrontendHTTPSPort="number"
  FrontendHost="String"
  HttpsKeepAliveSecs="number of seconds"
  KeepAliveEnabled=( "true" | "false" )
  KeepAliveSecs="number of seconds"
  LogFileBufferKBytes="number of kilobytes"
  LogFileFlushSecs="number of seconds"
  LogFileFormat=( "common" | "extended" )
  LogFileName="String"
  LogRotationPeriodMins="number of minutes"
  LogRotationTimeBegin="String"
  LogRotationType=( "size" | "date" )
  LogTimeInGMT=( "true" | "false" )
  LoggingEnabled=( "true" | "false" )
  MaxLogFileSizeKBytes="number of kilobytes"
  MaxPostSize="number of bytes"
  MaxPostTimeSecs="number of seconds"
  Name="String"
  Notes="String"
  PostTimeoutSecs="number"
  SendServerHeaderEnabled=( "true" | "false" )
  SingleSignonDisabled=( "true" | "false" )
  Targets="list of Target names"
  URLResource="java.util.Map"
  UseHeaderEncoding=( "true" | "false" )
  UseHighestCompatibleHTTPVersion=( "true" | "false" )
  WAPEnabled=( "true" | "false" )
/>

 

Parent Elements

 

Attributes

Table 67-1 WebServer attributes

Attribute

Description

Range of Values and Default

AcceptContextPathInGetRealPath

Beginning with this release inclusion of the contextPath in the virtualPath to the context.getRealPath() will not be allowed as it breaks the case when the subdirectories have the same name as contextPath. In order to support applications which might have been developed according to the old behaviour we are providing a compatibility switch. This switch will be deprecated in future releases.

Admin Console field label: Accept Context Path In Get Real Path

Required: no

Default: false

AuthCookieEnabled

Enables use of additional secure AuthCookie to make access to https pages with security constraints more secure. The session cookie will not be sufficient to gain access.

Required: no

Default: false

Secure value: true

Charsets

User defined mapping between internet and Java charset names

Required: no

ChunkedTransferDisabled

Disables the use of Chunk Transfer-Encoding in HTTP/1.1

Required: no

Default: false

ClusteringEnabled

Enables HTTP clustering

Required: no

Default: false

Secure value: false

DefaultServerName

Sets the HTTP defaultServerName

Admin Console field label: Default Server Name

Required: no

DefaultWebApp

Servlet 2.3 Web Application that maps to the "default" servlet context (where ContextPath = "/")

Admin Console field label: Default Web Application

Required: no

DeploymentOrder

A priority that the server uses to determine when it deploys an item. The priority is relative to other deployable items of the same type. For example, the server prioritizes and deploys all EJBs before it prioritizes and deploys startup classes.

Items with the lowest Deployment Order value are deployed first. There is no guarantee on the order of deployments with equal Deployment Order values. There is no guarantee of ordering across clusters.

Required: no

Default: 1000

Minimum: 0

Maximum: 231-1

FrontendHTTPPort

Sets the frontendHTTPPort

Admin Console field label: Frontend HTTP Port

Required: no

Default: 0

FrontendHTTPSPort

Sets the frontendHTTPSPort

Admin Console field label: Frontend HTTPS Port

Required: no

Default: 0

FrontendHost

Sets the HTTP frontendHost

Admin Console field label: Frontend Host

Required: no

HttpsKeepAliveSecs

Number of seconds to maintain HTTPS keep-alive before timing out the request.

Admin Console field label: HTTPS Duration

Required: no

Units: seconds

Default: 60

Secure value: 60

Minimum: 30

Maximum: 360

KeepAliveEnabled

Returns whether or not HTTP keep-alive is enabled

Admin Console field label: Enable Keepalives

Required: no

Default: true

Secure value: true

KeepAliveSecs

Number of seconds to maintain HTTP keep-alive before timing out the request.

Admin Console field label: Duration

Required: no

Units: seconds

Default: 30

Secure value: 30

Minimum: 5

Maximum: 300

LogFileBufferKBytes

The maximum size (in kilobytes) of the buffer that stores HTTP requests. When the buffer reaches this size, the server writes the data to the HTTP log file. Use the LogFileFlushSecs property to determine the frequency with which the server checks the size of the buffer.

Admin Console field label: Log Buffer Size

Required: no

Units: kilobytes

Default: 8

Minimum: 0

Maximum: 1024

LogFileFlushSecs

The interval (in seconds) at which the server checks the size of the buffer that stores HTTP requests. When the buffer exceeds the size that is specified in the LogFileBufferKBytes property, the server writes the data in the buffer to the HTTP request log file.

Admin Console field label: Flush Every

Required: no

Units: seconds

Default: 60

Minimum: 1

Maximum: 360

LogFileFormat

Specifies the format of the HTTP log file. Both formats are defined by the W3C. With the extended log format, you use server directives in the log file to customize the information that the server records.

Admin Console field label: Format

Required: no

Default: common

LogFileName

The name of the file that stores the HTTP-request log. If the pathname is not absolute, the path is assumed to be relative to the server's root directory.

This value is relevant only if HTTP logging is enabled.

The current logfile is always the one whose name equals value of the this attribute. If you have enabled log file rotation, when the current file exceeds the size or time limit, it is renamed.

To include a time and date stamp in the file name when the log file is rotated, add java.text.SimpleDateFormat variables to the file name. Surround each variable with percentage (%) characters.

For example, if the file name is defined to be access_%yyyy%_%MM%_%dd%_%hh%_%mm%.log, the log file will be named access_yyyy_mm_dd_hh_mm.log.

When the log file is rotated, the rotated file name contains the date stamp. For example, if the log file is rotated on 2 April, 2003 at 10:05 AM, the log file that contains the old messages will be named access_2003_04_02_10_05.log.

If you do not include a time and date stamp, the rotated log files are numbered in order of creation. For example, access.log0007.

Admin Console field label: Logfile Name

Required: no

Default: access.log

LogRotationPeriodMins

The interval (in minutes) at which the server saves old HTTP requests to another log file. This value is relevant only if you use the date-based rotation type.

Admin Console field label: Rotation Period

Required: no

Units: minutes

Default: 1440

Minimum: 1

Maximum: 231-1

LogRotationTimeBegin

Determines the start time for a time-based rotation sequence. At the time that this value specifies, the server renames the current log file. Thereafter, the server renames the log file at an interval that you specify in LogRotationPeriodMins.

Use the following format: MM-dd-yyyy-k:mm:ss where

  • MM is the month as expressed in the Gregorian calendar

  • dd is the day of the month

  • yyyy is the year

  • k is the hour in a 24-hour format.

  • mm is the minute

  • ss is the second

If the time that you specify has already past, then the server starts its file rotation immediately.

By default, rotation starts 24 hours from the time that you restart the server instance.

Admin Console field label: Rotation Time

Required: no

LogRotationType

Criteria for moving old HTTP requests to a separate log file:

  • size . When the log file reaches the size that you specify in MaxLogFileSizeKBytes, the server renames the file as LogFileName.n.

  • date . At each time interval that you specify in LogRotationPeriodMin, the server renames the file as LogFileName.n.

After the server renames a file, subsequent messages accumulate in a new file with the name that you specified in LogFileName.

Admin Console field label: Rotation Type

Required: no

Default: size

LogTimeInGMT

Specifies whether the time stamps for HTTP log messages are in Greenwich Mean Time (GMT) regardless of the local time zone that the host computer specifies.

Use this method to comply with the W3C specification for Extended Format Log Files. The specification states that all time stamps for Extended Format log entries be in GMT.

This method applies only if you have specified the extended message format.

Admin Console field label: Log Time In GMT

Required: no

Default: false

LoggingEnabled

Enables logging of HTTP requests.

Admin Console field label: Enable Logging

Required: no

Default: true

Secure value: true

MaxLogFileSizeKBytes

The size (1 - 65535 kilobytes) that triggers the server to move log messages to a separate file. After the log file reaches the specified size, the next time the server checks the file size, it will rename the current log file as FileName.n and create a new one to store subsequent messages.

0 causes the file to grow indefinitely.

This property is relevant only if you choose to rotate files by size.

Admin Console field label: Max Log File SizeK Bytes

Required: no

Units: kilobytes

Default: 0

Minimum: 0

MaxPostSize

Max Post Size (in bytes) for reading HTTP POST data in a servlet request. MaxPostSize < 0 means unlimited

Admin Console field label: Max Post Size

Required: no

Units: bytes

Default: -1

MaxPostTimeSecs

Max Post Time (in seconds) for reading HTTP POST data in a servlet request. MaxPostTime < 0 means unlimited

Admin Console field label: Max Post Time

Required: no

Units: seconds

Default: -1

Name

The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.

Admin Console field label: Name

Required: no

Notes

Optional information that you can include to describe this configuration.

Admin Console field label: Notes

Required: no

PostTimeoutSecs

Timeout (in seconds) for reading HTTP POST data in a servlet request.

Admin Console field label: Post Timeout Secs

Required: no

Default: 30

Secure value: 30

Minimum: 0

Maximum: 120

SendServerHeaderEnabled

Determines whether this server instance includes its name and WebLogic Server version number in HTTP response headers. Providing this information poses a potential security risk if an attacker knows about some vulnerability in a specific version of WebLogic Server.

Admin Console field label: Send Server Header Enabled

Required: no

Default: false

Secure value: false

SingleSignonDisabled

Disables SingleSignon in webapps

Required: no

Default: false

Targets

The targets in the current domain on which this item can be deployed.

Required: no

URLResource

Adds a URL connection factory resource into JNDI

Required: no

UseHeaderEncoding

Enables use of Content-Type encoding for specific headers that are known to contain non-ISO-8859_1 characters.

Required: no

Default: false

Secure value: false

UseHighestCompatibleHTTPVersion

Enables use of the highest compatible HTTP protocol version-string in the response. E.g. HTTP spec suggests that HTTP/1.1 version-string should be used in response to a request using HTTP/1.0. This does not necessarily affect the response format.

Required: no

Default: false

WAPEnabled

Enables WAP

Admin Console field label: WAP Enabled

Required: no

Default: false

 

Back to Top Previous Next