Defines access log settings for each http-access-log subelement of each virtual-server.
none
The following table describes attributes for the access-log element.
Table 1–1 access-log Attributes
Attribute |
Default |
Description |
---|---|---|
%client.name% %auth-user-name% %datetime% %request% %status% %response.length% |
(optional) Specifies the format of the access log. |
|
time |
(optional) Specifies the condition that triggers log rotation. The only legal value is time, which rotates log files at the rotation-interval-in-minutes interval. |
|
15 |
(optional) Specifies the time interval between log rotations if rotation-policy is set to time. |
|
yyyy-MM-dd |
(optional) Specifies the format of the timestamp appended to the access log name when log rotation occurs. For supported formats, see http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html. The following value is supported for backward compatibility. It results in the same format as the default. %YYYY;%MM;%DD;-%hh;h%mm;m%ss;s |
|
true |
(optional) If true, enables log rotation. |
Specifies the action of a management rule. The action is implemented as an MBean.
none
The following table describes attributes for the action element.
Table 1–2 action Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the name of the mbean that performs the action of a management rule. This MBean must implement javax.management.NotificationListener. |
Defines an administered object for an inbound resource adapter.
The following table describes subelements for the admin-object-resource element.
Table 1–3 admin-object-resource Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Contains a text description of this element. |
|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the admin-object-resource element.
Table 1–4 admin-object-resource Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the JNDI name for the resource. |
|
none |
Specifies the fully qualified type of the resource. |
|
none |
Specifies the name of the inbound resource adapter, as specified in the name attribute of a connector-module element. |
|
user |
(optional) Defines the type of the resource. Allowed values are:
|
|
enabled |
true |
(optional) Determines whether this resource is enabled at runtime. |
Properties of the admin-object-resource element are the names of setter methods of the adminobject-class specified in the adminobject element of the ra.xml file. Some of the property names can be specified in the adminobject element itself. For example, in jmsra, the resource adapter used to communicate with the Sun Java System Message Queue software, jmsra, Name and Description are valid properties.
For a complete list of the available properties (called administered object attributes in the Message Queue software), see the Sun Java System Message Queue 3.7 UR1 Administration Guide.
Determines whether the server instance is a regular instance, a domain administration server, or a combination. In the Platform Edition, there is only one server instance, and it is a combination.
The following table describes subelements for the admin-service element.
Table 1–5 admin-service Subelements
Element |
Required |
Description |
---|---|---|
only one |
Defines a domain administration server configuration.
|
|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the admin-service element.
Table 1–6 admin-service Attributes
Attribute |
Default |
Description |
---|---|---|
das-and-server |
Specifies whether the server instance is a regular instance (server), a domain administration server (das), or a combination (das-and-server). modifying this value is not recommended. For the Platform Edition, the default is the only value allowed. |
Configures the alert service, which allows you to register for and receive system status alerts.
The following table describes subelements for the alert-service element.
Table 1–7 alert-service Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Configures a subscription to system status alerts. |
|
zero or more |
Specifies a property or a variable. |
Configures a subscription to system status alerts.
The following table describes subelements for the alert-subscription element.
Table 1–8 alert-subscription Subelements
Element |
Required |
Description |
---|---|---|
only one |
Configures the listener class that listens for alerts from notification emitters. |
|
zero or one |
Configures the filter class that filters alerts from notification emitters. |
The following table describes attributes for the alert-subscription element.
Table 1–9 alert-subscription Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the name of this alert subscription. |
Specifies a deployed application client container (ACC) module.
The following table describes subelements for the appclient-module element.
Table 1–10 appclient-module Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Contains a text description of this element. |
|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the appclient-module element.
Table 1–11 appclient-module Attributes
Attribute |
Default |
Description |
---|---|---|
none |
The name of the ACC module. |
|
none |
The location of the ACC module in the Application Server file system. |
|
false |
(optional) Specifies whether the application has been deployed to a directory. |
|
true |
(optional) Specifies whether Java Web Start access is permitted for this application client. |
References an application or module deployed to the server instance.
none
The following table describes attributes for the application-ref element.
Table 1–12 application-ref Attributes
Attribute |
Default |
Description |
---|---|---|
enabled |
true |
(optional) Determines whether the application or module is enabled. |
all virtual servers |
(optional) In a comma-separated list, references id attributes of the virtual-server elements to which the web-module or the web modules within this j2ee-application are deployed. |
|
false |
(optional) If true, all load-balancers consider this application available to them. |
|
30 |
(optional) Specifies the time it takes this application to reach a quiescent state after having been disabled. |
|
none |
References the name attribute of a lifecycle-module, j2ee-application, ejb-module, web-module, connector-module, or appclient-module element. |
Contains deployed Java EE applications, Java EE modules, and Lifecycle modules.
The following table describes subelements for the applications element.
Table 1–13 applications Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a deployed lifecycle module. |
|
zero or more |
Specifies a deployed Java EE application. |
|
zero or more |
Specifies a deployed EJB module. |
|
zero or more |
Specifies a deployed web module. |
|
zero or more |
Specifies a deployed connector module. |
|
zero or more |
Specifies a deployed application client container (ACC) module. |
|
zero or more |
Specifies an MBean. |
Subelements of an applications element can occur in any order.
Specifies an optional plug-in module that implements audit capabilities.
The following table describes subelements for the audit-module element.
Table 1–14 audit-module Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the audit-module element.
Table 1–15 audit-module Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the name of this audit module. |
|
none |
Specifies the Java class that implements this audit module. |
Defines a realm for authentication.
Authentication realms require provider-specific properties, which vary depending on what a particular implementation needs.
For more information about how to define realms, see the Sun Java System Application Server Platform Edition 9 Developer’s Guide.
Here is an example of the default file realm:
<auth-realm name="file" classname="com.iplanet.ias.security.auth.realm.file.FileRealm"> <property name="file" value="domain-dir/config/keyfile"/> <property name="jaas-context" value="fileRealm"/> </auth-realm>
Which properties an auth-realm element uses depends on the value of the auth-realm element’s name attribute. The file realm uses file and jaas-context properties. Other realms use different properties.
The following table describes subelements for the auth-realm element.
Table 1–16 auth-realm Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the auth-realm element.
Table 1–17 auth-realm Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the name of this realm. |
|
none |
Specifies the Java class that implements this realm. |
The standard realms provided with Application Server have required and optional properties. A custom realm might have different properties.
The following table describes properties for the auth-realm element.
Table 1–18 auth-realm Properties