Configures a profiler for use with the Enterprise Server. For more information about profilers, see the Sun GlassFish Enterprise Server v3 Prelude Developer’s Guide.
The following table describes subelements for the profiler element.
Table 1–72 profiler Subelements
Element |
Required |
Description |
---|---|---|
zero or more |
Contains profiler-specific JVM command line options. |
|
zero or more |
Specifies a property or a variable. |
Subelements of a profiler element can occur in any order.
The following table describes attributes for the profiler element.
Table 1–73 profiler Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the name of the profiler. |
|
none |
(optional) Specifies the classpath for the profiler. |
|
none |
(optional) Specifies the native library path for the profiler. |
|
enabled |
true |
(optional) Determines whether the profiler is enabled. |
Specifies a property. A property adds configuration information to its parent element that is one or both of the following:
Optional with respect to the Enterprise Server
Needed by a system or object that the Enterprise Server doesn’t have knowledge of, such as an LDAP server or a Java class
For example, an auth-realm element can include property subelements:
<auth-realm name="file" classname="com.sun.enterprise.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.
admin-service, application, audit-module, auth-realm, config, das-config, domain, ejb-container, ejb-timer-service, engine, http-listener, http-service, iiop-listener, jacc-provider, java-config, jdbc-connection-pool, jdbc-resource, jms-host, jms-service, jmx-connector, log-service, manager-properties, mdb-container, module-log-levels, module-monitoring-levels, monitoring-service, orb, profiler, provider-config, security-service, server, session-properties, store-properties, thread-pool, transaction-service, virtual-server, web-container,
none
The following table describes attributes for the property element.
Table 1–74 property Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies the name of the property or variable. |
|
none |
Specifies the value of the property or variable. |
|
none |
(optional) Specifies a text description of this element. |
Specifies a configuration for one message security provider.
Although the request-policy and response-policy subelements are optional, the provider-config element does nothing if they are not specified.
Use property subelements to configure provider-specific properties. Property values are passed to the provider when its initialize method is called.
The following table describes subelements for the provider-config element.
Table 1–75 provider-config Subelements
Element |
Required |
Description |
---|---|---|
zero or one |
Defines the authentication policy requirements of the authentication provider’s request processing. |
|
zero or one |
Defines the authentication policy requirements of the authentication provider’s response processing. |
|
zero or more |
Specifies a property or a variable. |
The following table describes attributes for the provider-config element.
Table 1–76 provider-config Attributes
Attribute |
Default |
Description |
---|---|---|
none |
Specifies a unique identifier for this provider-config element. |
|
none |
Specifies whether the provider is a client, server, or client-server authentication provider. |
|
none |
Specifies the Java implementation class of the provider. Client authentication providers must implement the com.sun.enterprise.security.jauth.ClientAuthModule interface. Server authentication providers must implement the com.sun.enterprise.security.jauth.ServerAuthModule interface. Client-server providers must implement both interfaces. |
The following table describes properties for the provider-config element.
Table 1–77 provider-config Properties
Property |
Default |
Description |
---|---|---|
domain-dir/config/wss-server-config-1.0.xml |
Specifies the location of the message security configuration file. To point to a configuration file in the domain-dir/config directory, use the system property ${com.sun.aas.instanceRoot}/config/, for example: ${com.sun.aas.instanceRoot}/config/wss-server-config-1.0.xml See system-property. |
|
false |
If true, enables dumping of server provider debug messages to the server log. |
|
false |
If true, signals the provider runtime to collect the user name and password from the CallbackHandler for each request. If false, the user name and password for wsse:UsernameToken(s) is collected once, during module initialization. This property is only applicable for a ClientAuthModule. |
|
s1as |
Specifies the encryption key used by the provider. The key is identified by its keystore alias. |
|
s1as |
Specifies the signature key used by the provider. The key is identified by its keystore alias. |