Sun GlassFish Enterprise Server 2.1 Application Deployment Guide

client-container

Defines the Enterprise Server specific configuration for the application client container. This is the root element; there can only be one client-container element in a sun-acc.xml file. See The sun-acc.xml File.

Superelements

none

Subelements

The following table describes subelements for the client-container element.

Table A–23 client-container Subelements

Element 

Required 

Description 

target-server

only one (developer profile) 

one or more (cluster and enterprise profiles) 

Specifies the IIOP listener for the target server. Also specifies IIOP endpoints used for load balancing. If the Enterprise Server instance on which the application client is deployed participates in a cluster, the Enterprise Server finds all currently active IIOP endpoints in the cluster automatically. However, a client should have at least two endpoints specified for bootstrapping purposes, in case one of the endpoints has failed. 


Note –

Some topics in the documentation pertain to features that are available only in domains that are configured to support clusters. Examples of domains that support clusters are domains that are created with the cluster profile or the enterprise profile. For information about profiles, see Usage Profiles in Sun GlassFish Enterprise Server 2.1 Administration Guide.


A listener or endpoint is in the form host:port, where the host is an IP address or host name, and the port specifies the port number.

auth-realm

zero or one 

Specifies the optional configuration for JAAS authentication realm. 

client-credential

zero or one 

Specifies the default client credential that is sent to the server. 

log-service

zero or one 

Specifies the default log file and the severity level of the message. 

message-security-config

zero or more 

Specifies configurations for message security providers. 

property (with attributes)

zero or more 

Specifies a property, which has a name and a value. 

Attributes

The following table describes attributes for the client-container element.

Table A–24 client-container Attributes

Attribute 

Default 

Description 

send-password

true

If true, specifies that client authentication credentials must be sent to the server. Without authentication credentials, all access to protected EJB components results in exceptions.

Properties

The following table describes properties for the client-container element.

Table A–25 client-container Properties

Property 

Default 

Description 

com.sun.appserv.iiop.endpoints

none 

Specifies a comma-separated list of one or more IIOP endpoints used for load balancing. An IIOP endpoint is in the form host:port, where the host is an IP address or host name, and the port specifies the port number. Deprecated. Use target-server elements instead.