target-server (Sun GlassFish Enterprise Server 2.1 Application Deployment Guide)

Sun GlassFish Enterprise Server 2.1 Application Deployment Guide

target-server

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.

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.

Not used if the deprecated endpoints property is defined for load balancing. For more information, see client-container.

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.

Superelements

client-container (sun-acc.xml)

Subelements

The following table describes subelements for the target-server element.

Table A–127 target-server subelements


Element	Required	Description
description	zero or one	Specifies the description of the target server.
security	zero or one	Specifies the security configuration for the IIOP/SSL communication with the target server.

Attributes

The following table describes attributes for the target-server element.

Table A–128 target-server attributes


Attribute	Default	Description
`name`	none	Specifies the name of the application server instance accessed by the client container.
`address`	none	Specifies the host name or IP address (resolvable by DNS) of the server to which this client attaches.
`port`	none	Specifies the naming service port number of the server to which this client attaches. For a new server instance, assign a port number other than 3700. You can change the port number in the Admin Console. Click the Help button in the Admin Console for more information.