Sun Java Enterprise System Upgrade Guide for Microsoft Windows |
Chapter 5
Web ServerThis chapter describes how to upgrade Web Server software from previous Java ES versions to Java ES 2005Q4 Release 4: Web Server 6.1 2005Q4 SP5.
The chapter provides a general overview of upgrade issues and procedures for the different upgrade paths supported by Java ES Release 4. The chapter covers the following:
Overview of Web Server UpgradesThis section describes the following general aspects of Web Server that impact upgrading to Java ES Release 4:
About Java ES Release 4 Web Server
Java ES Release 4 versions of Web Server represents a number of bug fixes, including security fixes that depend upon the NSS shared component.
For details, see the appropriate release notes.
Web Server Upgrade Roadmap
Table 5-1 shows the supported Web Server upgrade paths to Java ES Release 4.
Web Server Data
The following table shows the type of data that could be impacted by an upgrade of Web Server software.
Compatibility Issues
Release 4 Web Server does not introduce any interface changes and is backwardly compatible with earlier versions.
Web Server Dependencies
Web Server has no dependencies on other Java ES components other than on Java ES shared components (see Table 1-6).
Upgrading Web Server from Java ES Release 3This section includes information about upgrading Web Server from Java ES Release 3 to Java ES Release 4. The section covers the following topics:
Introduction
When upgrading Java ES Release 3 Web Server to Release 4, consider the following aspects of the upgrade process:
General Upgrade Approach. The upgrade is performed by applying patches to the Release 3 version. No re-configuration of Web Server is required in upgrading from Java ES Release 3 Web Server to Release 4.
Upgrade Dependencies. While Web Server has dependencies on a number of Java ES shared components (see Table 1-6), Release 4 Web Server requires only that NSS be upgraded to Release 4. Upgrade of other shared components is optional with respect to upgrade of Web Server to Release 4.
Backward Compatibility. Release 4 Web Server is backwardly compatible with the Release 3 version.
Upgrade Rollback. Rollback of the Release 4 upgrade to Release 3 is achieved by removing the patches applied during the upgrade.
Web Server Upgrade
This section describes how to perform an upgrade of Web Server from Java ES Release 3 to Java ES Release 4. Where a topic depends on platform-specific procedures, the topic will indicate the operating system to which it applies. The section covers the following topics:
Pre-Upgrade Tasks
Before you upgrade Web Server you should perform the tasks described below.
Verify Current Version Information
You can verify the current version of Web Server in Web Server administration server page.
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 Java ES Release 4. However, the upgrade of Web Server to Release 4 requires only that the NSS shared component be upgraded from Release 3 to its Release 4 version before upgrading Web Server. Instructions for upgrading NSS to Release 4, or other Java ES shared components you might wish to upgrade, are provided in Chapter 2, "Upgrading Java ES Shared Components."
Back Up Web Server Data
The Web Server upgrade from Release 3 to Release 4 does not modify configuration data. There is no need to back up current data.
Obtain Required Configuration Information and Passwords
No special information about your currently installed version is needed. However you will have to log in as superuser to perform the upgrade.
Upgrading 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 4 takes into account the following considerations:
- Any J2EE components running in an Web Server instance should be shut down before you upgrade that instance.
- All Web Server instances corresponding to the same installed Web Server image are upgraded at the same time. All such instances should be shut down when patches are being applied to the installed image.
- The Release 4 upgrade patches are shown in the Table 1-3.
Upgrade Procedure
The procedure documented below applies to all Web Server instances corresponding to the same installed Web Server image on the computer where the upgrade is taking place.
- Obtain the required patches, based on Table 1-3.
Patches can be downloaded from:
http://sunsolve.sun.com
- Log in as administrator
- Stop all running instances of Web Server and the Administration Server.
# web_svr_base/https-instanceName/stopsvr.bat
# web_svr_base/https-admserv/stopsvr.bat
- If not already done, upgrade the NSS shared component to Release 4 and any other shared components you wish to upgrade by running 121523.01.exe.
- Apply the Web Server patch in Table 1-3.
Double-click the <patch_id>.exe file
- Restart the Web Server instances that were stopped in Step 3.
Verifying the Upgrade
You can verify the upgrade of Web Server to Release 4 in Web Server administration server page.
See Table 5-3 for output values.
Post-Upgrade Tasks
There are no post-upgrade tasks beyond the steps described in Upgrade Procedure.
Rolling Back the Upgrade
This section describes considerations that impact the upgrade rollback procedure for Web Server followed by the procedure itself.
Rollback Considerations
The procedure for rolling back the upgrade to Release 4 of Web Server is pretty much the reverse of the procedure for upgrading to Release 4. The patches are removed.
Rollback Procedure
- Log in as administrator.
- Stop all running instances of Web Server and the Administration Server.
# web_svr_base/https-instancename/stopsvr.bat
# web_svr_base/https-admserv/stopsvr.bat
- Remove the respective patches mentioned in Table 1-3.
Double-click Uninstall_<Patch-id>.bat
- Restart the Web Server instances that were stopped in Step 2.