Sun Java System Application Server Enterprise Edition 8.1 2005Q2 High Availability Administration Guide

- Previous: Application Compatibility
- Next: Upgrading in Multiple Clusters

## Upgrading In a Single Cluster

You can perform a rolling upgrade of an application deployed to a single cluster, providing the cluster’s configuration is not shared with any other cluster.

### To upgrade an application in a single cluster

1. Save an old version of the application or back up the domain.

   To back up the domain use the `asadmin backup-domain` command.

2. Turn off dynamic reconfiguration (if enabled) for the cluster.

   To do this with Admin Console:

   1. Expand the Configurations node.

   2. Click the name of the cluster’s configuration.

   3. On the Configuration System Properties page, uncheck the Dynamic Reconfiguration Enabled box.

   4. Click Save

   Alternatively, use this command:

   `asadmin set --user user --passwordfile password_file cluster_name -config.dynamic-reconfiguration-enabled=false`

3. Redeploy the upgraded application to the target `domain`.

   If you redeploy using the Admin Console, the domain is automatically the target. If you use `asadmin`, specify the target `domain`. Because dynamic reconfiguration is disabled, the old application continues to run on the cluster.

4. Enable the redeployed application for the instances using `asadmin enable-http-lb-application`.

5. Quiesce one server instance in the cluster from the load balancer.

   Follow these steps:

   1. Disable the server instance using `asadmin disable-http-lb-server.`

   2. Export the load balancer configuration file using `asadmin export-http-lb-config`.

   3. Copy the exported configuration file to the web server instance’s configuration directory.

      For example, for Sun Java System Web Server, the location is web_server_install_dir/ `https-` host-name `/config/loadbalancer.xml` . To ensure that the load balancer loads the new configuration file, be sure that dynamic reconfiguration is enabled by setting the `reloadinterval` in the load balancer configuration.

   4. Wait until the timeout has expired.

      Monitor the load balancer’s log file to make sure the instance is offline. If users see a retry URL, skip the quiescing period and restart the server immediately.

6. Restart the disabled server instance while the other instances in the cluster are still running.

   Restarting causes the server to synchronize with the domain and update the application.

7. Test the application on the restarted server to make sure it runs correctly.

8. Re-enable the server instance in load balancer.

   Follow these steps:

   1. Enable the server instance using `asadmin enable-http-lb-server.`

   2. Export the load balancer configuration file using `asadmin export-http-lb-config`.

   3. Copy the configuration file to the web server’s configuration directory as described in Upgrading In a Single Cluster of Upgrading In a Single Cluster .

9. Repeat steps 5 through 8 for each instance in the cluster.

10. When all server instances have the new application and are running, you can re-enable dynamic reconfiguration for the cluster again.

- Previous: Application Compatibility
- Next: Upgrading in Multiple Clusters

- © 2010, Oracle Corporation and/or its affiliates