bea.com | products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 
Search

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

<!ELEMENT WebServer EMPTY >
<!ATTLIST WebServer
   AcceptContextPathInGetRealPath
                              (true | false)           "false"
   Charsets                   CDATA                    #IMPLIED
   ClusteringEnabled          (true | false)           "false"
   DefaultServerName          CDATA                    #IMPLIED
   DefaultWebApp              CDATA                    #IMPLIED
   DeploymentOrder            CDATA                    "1000"
   FrontendHTTPPort           CDATA                    "0"
   FrontendHTTPSPort          CDATA                    "0"
   FrontendHost               CDATA                    #IMPLIED
   HttpsKeepAliveSecs         CDATA                    "60"
   KeepAliveEnabled           (true | false)           "true"
   KeepAliveSecs              CDATA                    "30"
   LogFileBufferKBytes        CDATA                    "8"
   LogFileFlushSecs           CDATA                    "60"
   LogFileFormat              (common | extended)      "common"
   LogFileName                CDATA                    "access.log"
   LogRotationPeriodMins      CDATA                    "1440"
   LogRotationTimeBegin       CDATA                    #IMPLIED
   LogRotationType            (size | date)            "size"
   LoggingEnabled             (true | false)           "true"
   MaxLogFileSizeKBytes       CDATA                    "0"
   MaxPostSize                CDATA                    "-1"
   MaxPostTimeSecs            CDATA                    "-1"
   Name                       CDATA                    #REQUIRED
   Notes                      CDATA                    #IMPLIED
   PostTimeoutSecs            CDATA                    "30"
   SendServerHeaderEnabled    (true | false)           "true"
   SingleSignonDisabled       (true | false)           "false"
   Targets                    CDATA                    #IMPLIED
   URLResource                CDATA                    #IMPLIED
   WAPEnabled                 (true | false)           "false"
>

Parent Elements

The WebServer element is a child of the Server element.

Attributes

Table 80-1 WebServerMBean Element Attributes

Attribute

Description

Range of Values and Default

Console Label

Accept-Context-Path-In-Get-Real-Path

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 switchwill be deprecated in future releases.

Default: false

Accept Context Path In Get Real Path

Charsets

User defined mapping between internet and Java charset names

Default: null

Charsets

Clustering-Enabled

Enables HTTP clustering

Default: false

Clustering Enabled

Default-Server-Name

The HTTP defaultServerName

Default: null

Default Server Name

Default-Web-App

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

Default: null

Default Web Application

Deployment-Order

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 startup classes before it prioritizes and deploys EJBs.

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.

Default: 1000

Minimum: 0

Maximum: 2147483647

Deployment Order

Frontend-HTTPPort

The frontendHTTPPort

Default: 0

Frontend HTTPPort

Frontend-HTTPSPort

The frontendHTTPSPort

Default: 0

Frontend HTTPSPort

Frontend-Host

The HTTP frontendHost

Default: null

Frontend Host

Https-Keep-Alive-Secs

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

Default: 60

Minimum: 30

Maximum: 360

Units: seconds

HTTPS Duration

Keep-Alive-Enabled

Returns whether or not HTTP keep-alive is enabled

Default: true

Enable Keepalives

Keep-Alive-Secs

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

Default: 30

Minimum: 5

Maximum: 120

Units: seconds

Duration

Log-File-Buffer-KBytes

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 LogFileFlushSecsproperty to determine the frequency with which the server checks the size of the buffer.

Default: 8

Minimum: 0

Maximum: 1024

Units: kilobytes

Log Buffer Size

Log-File-Flush-Secs

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 LogFileBufferKBytesproperty, the server writes the data in the buffer to the HTTP request log file.

Default: 60

Minimum: 1

Maximum: 360

Units: seconds

Flush Every

Log-File-Format

Specifiesr 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.

Default: "common"

Valid values:

  • "common"

  • "extended"

Format

Log-File-Name

The name of the file that stores HTTP requests. If the pathname is not absolute, the path is assumed to be relative to the root directory of the machine on which the server is running.

This value is relevant only if HTTP logging is enabled.

Default: "access.log"

Logfile Name

Log-Rotation-Period-Mins

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 time-based rotation type.

Default: 1440

Minimum: 1

Maximum: 2147483647

Units: minutes

Rotation Period

Log-Rotation-Time-Begin

Determines the start time for a time-based rotation sequence. At the time that this value specifies, the server renames the current log file as LogFileName.n. Thereafter, the server renames the log file at an interval that you specify in LogRotationPeriodMins. You can create a recurring start time such as "every Monday at 09:00" or a non-recurring start time such as "9 January, 2002, 09:00."

Use the following java.text.SimpleDateFormat format to specify a date and time: MM-dd-yyyy-k:mm:ss. For information about this format, refer to the <a href="http://java.sun.com/j2se/1.3/docs/api/index.html">J2EE Javadoc</a>.

If the date that you specify has already past, then the day in week (E), hour in day (H), minute in hour (m) and second in minute (s) are used with the current date to recalculate a start time.


Rotation Time

Log-Rotation-Type

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.

  • Time. At each time interval that you specify in TimeSpan, 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.

Default: "size"

Valid values:

  • "size"

  • "date"

Rotation Type

Logging-Enabled

Enables logging of HTTP requests.

Default: true

Enable Logging

Max-Log-File-Size-KBytes

The maximum size (in kilobytes) of the HTTP log file. After the log file reaches this size, the server renames it as LogFileName.n. 0 causes the file to grow indefinitely.

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

Default: 0

Minimum: 0

Units: kilobytes

Max Log File SizeK Bytes

Max-Post-Size

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

Default: -1

Units: bytes

Max Post Size

Max-Post-Time-Secs

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

Default: -1

Units: seconds

Max Post Time

Name

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


Name

Notes

Optional information that you can include to describe this configuration.


Notes

Post-Timeout-Secs

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

Default: 30

Minimum: 0

Maximum: 120

Post Timeout Secs

Send-Server-Header-Enabled

Returns whether or not to send a response Server header

Default: true

Send Server Header Enabled

Single-Signon-Disabled

Disables SingleSignon in webapps

Default: false

Single Signon Disabled

Targets

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


Targets

URLResource

Adds a URL connection factory resource into JNDI

Default: null

URLResource

WAPEnabled

Enables WAP

Default: false

WAP Enabled


 

 

Back to Top Previous Next