Release 5 Web Server Upgrade

This section describes how to perform an upgrade of Web Server from Java ES 5 to Java ES 5 Update 1. This section covers the following topics:

• Pre-Upgrade Tasks

• Upgrading Release 5 Web Server

• Verifying the Upgrade

• Post-Upgrade Tasks

• Rolling Back the Upgrade

Pre-Upgrade Tasks

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

• Verify Current Version Information

• Upgrade Web Server Dependencies

Verify Current Version Information

Verify the current version of Web Server before you upgrade.

To Verify Current Version Information

1. Examine the subcomponent error log at:

   WebServer-base\admin-server\logs\error

   WebServer-base\https-hostname.domain\logs\error

   The Web Server version information is as follows.

   Release 5U1

   Sun Java System Web Server 7.0 U1

   Release 5

   Sun Java System Web Server 7.0

Upgrade Web 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 Web Server has no hard upgrade dependencies, but upgrade is only certified when shared components have also been upgraded. The upgrade from Release 5 to Release 5U1 requires that Windows Installer patch (126910–02) is already applied.

Backing Up Web Server Data

The Web 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 Web Server

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

Upgrade Considerations

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

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

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

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

Table 5–4 Patches to Upgrade Web 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.]
Web Server core	125441–10
Web Server localization	The localized patch files are delivered within the core patch.

Upgrade Procedure

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

To Upgrade Web Server to Java ES 5 Update 1

1. Log in as administrator.

2. Shut down the Release 5 Web Server instances and the administration server.

   1. Choose Start > Sun Java Enterprise System 5 > Web Server 7.0 > Administration Console.

      The Web Server 7.0 Administration Server Login page appears.

   2. Type the User Name and Password, then click OK.

      The Web Server 7.0 Administration Server page appears.

   3. Select a Server from the drop down list, and click Manage.

      The Server Manager page appears.

   4. Click Server Off.

      Using the Command-Line Interface:

      • Change to WebServer-base\admin-server\bin.

      • Run the stopserv.bat command to stop the Web Server processes.

        The Web Server stops and a confirmation dialog box appears.

   5. To stop the Web Server instance, change to WebServer-base\https-hostName.domainName\bin.

   6. Run the stopserv.bat command.

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

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

   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 Web Server instances and the administration server.

   WebServer-base\admin-server\bin\startserv.bat

   WebServer-base\https-hostName.domainName\bin\startserv.bat

Verifying the Upgrade

You can verify successful upgrade of Web Server by examining the subcomponent error logs at:

WebServer-base\admin-server\logs\error

WebServer-base\https-hostname.domain\logs\error

The messages that indicate the Java ES release version are:

Release 5U1

Sun Java System Web Server 7.0 U1 (Build Date Time)

Release 5

Sun Java System Web Server 7.0 (Build Date Time)

Post-Upgrade Tasks

There are no post-upgrade tasks beyond the steps described in Upgrade Considerations.

Rolling Back the Upgrade

1. Log in as administrator.

2. Shut down the Web Server instances and the administration server.

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

4. Restart the administration server and the Web Server instances that were shut down in step 2.