Upgrading Application Server from Java ES 4

This section includes information about upgrading Application Server from Java ES 4 to Java ES 5. This section covers the following topics:

• Introduction to Upgrading Application Server

• Application Server Upgrade

Introduction to Upgrading Application Server

When upgrading Java ES 4 Application Server to Java ES 5, consider the following aspects of the upgrade process:

• General Upgrade Approach. Java ES 5 does not provide any in place upgrade support.

• Upgrade Dependencies. Application Server has dependencies on a number of Java ES shared components, as listed in Table 1–7. Java ES 5 Application Server is compatible with the Release 4 version of all these components.

• Backward Compatibility. Java ES 5 Application Server is backwardly compatible with the Java ES 4 provided the shared component dependency is not broken.

• Upgrade Rollback. Rollback of the Java ES 5 upgrade to Java ES 4 is achieved by uninstallling the Java ES 5 and reinstalling Java ES 4.

Application Server Upgrade

This section describes how to perform an upgrade of Application Server from Java ES version 4 to Java ES version 5. This section covers the following topics:

• Pre-Upgrade Tasks

• To Upgrade Application Server

• Post-Upgrade Tasks

• To Roll Back the Upgrade

Pre-Upgrade Tasks

• Upgrading Application Server Dependencies

• To Verify Current Version Information

• To Stop Application Server Component

• To Back Up Application Server Data

Upgrading Application Server Dependencies

All Java ES components on a computer system and in a computing environment should be upgraded to Java ES version 5.

To Verify Current Version Information

Type the following command.

ApplicationServer-base\bin\asadmin.bat version

The outputs that indicate the Application Server version are:

Release 5

Sun Java Enterprise System Application Server Enterprise Edition 8.2

Release 4

Sun Java Enterprise System Application Server Enterprise Edition 8.1_02

To Stop Application Server Component

1. Stop all running node agents.

   ApplicationServer-base\bin\asadmin.bat stop-node-agent

2. Stop all domains.

   ApplicationServer-base\bin\asadmin.bat stop-domain

3. Stop the pointbase database server if one is installed and running.

   ApplicationServer-base\pointbase\tools\stopserver.sh

To Back Up Application Server Data

1. Back up Application Server domains.

   Create a directory outside the Application Server installation directories and back up the content of the domains directory in this new directory. The default location for the Java ES 4 domains directory is ApplicationServer-base\domains.

2. Back up Application Server node agents.

   Create a directory outside the Application Server installation directories and back up the content of the nodeagents directory in this new directory. The default location for the Java ES 4 nodeagents directory is ApplicationServer-base\nodeagents.

3. Back up pointbase binaries.

   Create a directory outside the Application Server installation directories and back up the content of the pointbase directory in this new directory. The default location for the Java ES 4 pointbase directory is ApplicationServer-base\pointbase.

4. Back up pointbase data files.

   Create a directory outside the Application Server installation directories and back up the pointbase data files in this new directory. The default location for the Java ES 4 pointbase data files is: ApplicationServer-base\pointbase.

5. Back up the Application Server configuration file.

   The default location for Application Server configuration file is ApplicationServer-base\config\asenv.conf.

6. Back up the sample configuration file.

   The default location for sample configuration file is ApplicationServer-base\samples\common.properties.

To Upgrade Application Server

Before You Begin

• Obtain Application Server administrator user ID and password for your currently installed version.

• Shut down all J2EE components running in an Application Server instance before upgrading the instance. However, if load balancing provides for high availability or scalability, this requirement can be relaxed.

• Shut down all instances of Application Server running on a single computer (all corresponding to the same installed Application Server image.

• Back up all domain, node agent, and configuration data.

In multiple node deployments, perform the upgrade procedure on each node or computer that hosts Application Server instances.

1. Install Java ES 5 Application Server with the Configure Automatically During Installation option.

   The new installed domain is started automatically.

2. Stop the domain.

   You can also delete the domain created under new installation directory.

To Verify the Upgrade

Type the following command.

ApplicationServer-base\bin\asadmin.bat version

The outputs that indicate the Application Server version are:

Release 5

Sun Java Enterprise System Application Server Enterprise Edition 8.2

Release 4

Sun Java Enterprise System Application Server Enterprise Edition 8.1_02

Post-Upgrade Tasks

To verify a successful upgrade, you need to perform the following post-upgrade tasks:

• To Restore Application Server Data

• To Validate Restored Domains

• To Validate Restored Node Agents

• To Validate Pointbase Data Files

To Restore Application Server Data

1. Restore Application Server domains.

2. Restore Application Server node agents.

3. Restore pointbase binaries.

4. Restore pointbase data files.

5. Restore the configuration settings from the Java ES 4 Application Server configuration file.

   Ensure that the new entries from the Java ES 5 configuration file are retained in this file.

6. Restore the configuration settings from the Java ES 4 sample configuration file.

   Ensure that the new entries from the Java ES 5 sample configuration file are retained in this file.

To Validate Restored Domains

1. Start the restored Java ES 4 Application Server domains.

   ApplicationServer-base\bin\asadmin.bat start-domain --user userName --domaindir JES4-Domain-location domainName

2. Check for the deployed applications.

3. Check for the configuration settings.

To Validate Restored Node Agents

Start the restored Java ES 4 node agents.

ApplicationServer-base\bin\asadmin.bat start-node-agent --user userName --agentdir JES4-node-agent-location nodeAgentName

To Validate Pointbase Data Files

1. Start the restored Java ES 4 Application Server domains.

   ApplicationServer-base\pointbase\tools\startpointbase.sh

2. Verify that the data files are accessible to the applications.

To Roll Back the Upgrade

1. Uninstall Java ES 5.

2. Start domain and node agent from Java ES4 Application Server install location.