Release 5 Application Server Upgrade

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

• Pre-Upgrade Tasks

• Upgrading Release 5 Application Server

• Verifying the Upgrade

• Post-Upgrade Tasks

• Rolling Back the Upgrade

Pre-Upgrade Tasks

Before you upgrade Application Server, perform the tasks described below.

• Verify Current Version Information

• Upgrade Application Server Dependencies

• Backing Up Application Server Data

Verify Current Version Information

Verify the current version of Application Server before you upgrade.

To Verify Current Version Information

1. Type the following command:

   WebServer-base\asadmin version --verbose

   This command returns the Application Server version information.

   Release 5U1

   Sun Java Enterprise System Application Server Enterprise Edition 8.2

   Release 5

   Sun Java Enterprise System Application Server Enterprise Edition 8.2

Upgrade Application Server Dependencies

It is generally recommended that all Java ES components on a computer system (and in a computing environment) be upgraded to Release 5U1. Release 5U1 Application Server has hard upgrade dependencies on Message Queue and on the NSS shared component, so these should be upgraded before upgrading Application Server. Upgrading Application Server to Release 5U1 requires that Windows Installer patch (126910–02) is already applied.

Backing Up Application Server Data

The Application Server upgrade from Release 5 to Release 5U1 does not modify the Release 5 configuration data. You do not need to back up current data.

Upgrading Release 5 Application Server

This section discusses considerations that impact the upgrade procedure for Application Server, followed by a description of the procedure itself.

Upgrade Considerations

The upgrade of Application Server software to Java ES Release 5U1 takes into account the following considerations:

• In a deployment architecture in which there are multiple instances of Application Server running on a single computer (all corresponding to the same installed Application Server image), you only have to upgrade the Application Server image once.

• In a maintenance upgrade, you do not have to migrate schema, configuration, security or user data.

• The Release 5U1 Application Server upgrade patches for Windows are shown in the following table:

Table 9–3 Patches to Upgrade Application Server on Windows

Description	Patch ID [Patch revision numbers are the minimum required for upgrade to Release 5U1. If newer revisions become available, use the newer ones instead of those shown in the table.]
Application Server core	124684–04
Application Server Localization	The localized patch files are delivered within the core patch.

Upgrade Procedure

The procedure documented below applies to Application Server instances residing locally on the computer where the upgrade is taking place.

To Upgrade Application Server to Java ES 5 Update 1

1. Log in as administrator.

2. Shut down all Application Server instances.

   1. Stop the Domain Administration Server.

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

   2. Stop the Node Agent.

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

3. Make sure you have upgraded any Java ES components upon which Application Server has hard upgrade dependencies (see Upgrade Web Server Dependencies.

4. Obtain the required Application Server Release 5U1 upgrade patches, based on Table 9–3.

   To obtain the patch, see Accessing Java ES Patches. Patches can be downloaded to \workingDirectory.

5. Install the patch.

   Installation is generally performed by running patch-id.exe, however, be sure to consult the README.patch-id file in the patch directory for installation instructions.

   ---

   Note –

   If you are prompted to restart the system, select No. Wait till the patch installation process is completed and then restart and re-login as the same user to complete the patch installation.

   ---

6. Verify the patch log file.

   The log file is found at: %TEMP%\SUNJAVAES_<patch-id>.log

7. Verify the patch installation with the utility ListJavaESPatches.exe.

   Run ListJavaESPatches.exe and check that the output includes the patch id of the patch that you have installed in Step 5. For more information, see Identifying Installed Java ES Patches.

8. Start the Release 5U1 Application Server domains and node-agents of all the instances.

   ApplicationServer-base\bin\asadmin.bat start-domain --user admin-user-ID/ --passwordfile passwordFileName domain-name

   ApplicationServer-base\bin\asadmin.bat start-node-agent --port admin-Port --user/ admin-user-ID --password admin-password node-agent--name

Verifying the Upgrade

You can verify successful upgrade of Application Server by starting the Application Server instance as follows:

AppServer-base\bin\asadmin version --verbose

The messages that indicate the Java ES release version are:

Release 5U1

Sun Java Enterprise System Application Server 8.2 (build b30–p02)

Release 5

Sun Java Enterprise System Application Server 8.2 (build b25–fcs)

Post-Upgrade Tasks

The upgrade will not update version numbers.

To update the version string, do the following:

To Update the Version String

1. Copy unzipped installable binary\scripts\PostPatch.class to ApplicationServer-base\lib

2. Execute java PostPatch from the directory ApplicationServer-base\lib.

Rolling Back the Upgrade

1. Log in as administrator.

2. Shut down the Application Server instances.

3. Double-click Uninstall_patch-id.bat to uninstall the patch.

4. Execute java PostPatch from the directory ApplicationServer-base\lib.

5. Restart the administration server and the Application Server instances that were shut down in step 2.