Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Upgrade and Migration Guide

- Previous: Authenticating a Client in Sun Java System Application Server 8.1
- Next: Migrating Applications to Support HTTP Failover (Enterprise Edition)

### Load-balancing and Failover Features in ACC Clients (Enterprise Edition)

Load balancing is handled implicitly by the CXS engine in SunONE Application Server 6.5 upon number of Java engines registered. In Application Server 8.1 Enterprise Edition, this feature requires explicit configuration details from the clients.

After migrating the deployment descriptors from 6.x to 8.1, provide the configuration details in the `sun-acc.xml` file to enable failover capabilities in your ACC client. See Migrating Deployment Descriptors for information on migrating deployment descriptors.

Define the load balancing properties in the `sun-acc.xml` file to provide a highly available ACC client. The properties are defined as property elements in the `sun-acc.xml` file.

- `com.sun.appserv.iiop.endpoints`

  This property defines the list of one or more IIOP endpoints. An endpoint is specified as host:port where host is the name or IP address of the system where Application Server 8.1 is running. Port is the IIOP port at which the server is listening for IIOP requests.

- `com.sun.appserv.iiop.loadbalancingpolicy`

  If the endpoint property is specified, then, this property is used to specify the load balancing policy. The value for this property must be InitialContext-based.

For example:

    <client-container>
       <target-server name="qasol-e1" address="qasol-e1" port="3700">
       <property name="com.sun.appserv.iiop.loadbalancingpolicy" value="ic-based" />
       <property name="com.sun.appserv.iiop.endpoints" value="qasol-e1:3700,qasol-e1:3800" />
    </client-container>

To failover an ACC client on the RMI/IIOP path, information about all the endpoints in a cluster to which the RMI/ IIOP requests can be failed over must be available. You must have defined the IIOP endpoints in the `domain.xml` file. The `iiop-cluster` element under the `availability-service` element defines the IIOP endpoints.

For more information, see Chapter 4, Configuring Load Balancing and Failover, in Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide.

- Previous: Authenticating a Client in Sun Java System Application Server 8.1
- Next: Migrating Applications to Support HTTP Failover (Enterprise Edition)

- © 2010, Oracle Corporation and/or its affiliates