This chapter describes how to upgrade Web Proxy Server from Java ES 5 (Release 5) to Java ES 5 Update 1 (Release 5): Sun Java System Web Proxy Server 4.0.5.
The chapter provides an overview of upgrade considerations for the different upgrade paths supported by Release 5U1.
File locations in this chapter are specified with respect to a directory path referred to as WebProxyServer-base. At least part of this path might have been specified as an installation directory when Web Proxy Server was initially installed. If not, the Java ES installer assigned a default value.
The default value of WebProxyServer-base is C:\Program Files\Sun\JavaES5\webproxyserver.
The following sections describe general aspects of Web Proxy Server that affect upgrading to Java ES 5 Update 1 :
Release 5U1 Web Proxy Server is a maintenance release that fixes bugs in Release 5 Web Proxy Server. Release 5 Web Proxy Server, in turn , was a bug-fix release with respect to Release 4.
However, Release 5 Web Proxy Server includes better performance, more scalable architecture, better standards compliance, and a new administration interface as compared to Sun ONE Web Proxy Server 3.6 before its inclusion in the Java Enterprise System software.
The following table shows the supported Web Proxy Server upgrade paths to Java ES Release 5.
Table 11–1 Upgrade Paths to Java ES Release 5 Update 1: Sun Java System Web Proxy Server 4.0.5
Java ES Release |
Web Proxy Server Relase |
General Approach |
Reconfiguration Required |
---|---|---|---|
Release 5 |
Sun Java System Web Proxy Server 4.0.4 |
Maintenance upgrade. Apply patches. |
None |
Release 4 |
Sun Java System Web Proxy Server 4.0.1 |
Upgrade of Web Proxy Server from Release 4 to Release 5U1 is not supported. |
The following table shows the type of data that could be impacted by an upgrade of Web Proxy Server software.
Table 11–2 Web Proxy Server Data Usage
Type of Data |
Location |
Usage |
---|---|---|
Configuration data |
WebProxyServer-base\proxy-serverid\config This directory contains files, such as server,xml, magnus.conf, and obj.conf |
Stores configuration information for the server, cache, filters, routing, and other functional aspects of Web Proxy Server |
Release 5U1 Web Proxy Server does not introduce any new public interfaces and is backwardly compatible with Release 4 and Release 51 Web Proxy Server. Release 5U1 Web Proxy Server is also compatible with release 3.6, except that plug-ins developed using the NSAPI interface supported by release 3.6 must be recompiled with the NSAPI interface supported by Release 5U1.
Web Proxy Server has dependencies on the following Java ES components:
Shared Components. Web Proxy Server has dependencies on specific Java ES shared components (see Table 1–8. Web Proxy Server upgrades might depend upon upgraded versions of these shared components.
Directory Server. Web Proxy Server has an optional dependency on Directory Server for providing LDAP-based authentication.
Web Server.Web Proxy Server has a co-dependency on Web Server for providing improved security and performance for HTTP requests.
This section includes information about upgrading Web Proxy Server from Java ES 5 to Java ES 5 Update 1 . The section covers the following topics:
When upgrading Release 5 Web Proxy Server to Release 5U1, consider the following aspects of the upgrade process:
General Upgrade Approach. The upgrade is performed using patches. There is no additional reconfiguration required.
Upgrade Dependencies. Web Proxy Server has dependencies on a number of Java ES shared components (see Table 1–8).
Backward Compatibility. Release 5UI Web Proxy Server is backwardly compatible with the Release 5 version.
Upgrade Rollback. Rollback of the Release 5U1 upgrade of Web Proxy Server is achieved by removing the upgrade patches.
This section describes how to perform an upgrade of Web Proxy Server from Java ES 5 to Java ES 5 Update 1. This section covers the following topics:
Before you upgrade Web Proxy Server, perform the tasks described below.
Verify the current version of Web Proxy Server before you upgrade.
Examine the subcomponent error log at:
WebProxyServer-base\proxy-admserv\logs\error
The Web Proxy Server version information is as follows.
Sun Java System Web Proxy Server 4.0.5 (Build Date)
Sun Java System Web Proxy Server 4.0.4 (Build Date)
It is generally recommended that all Java ES components on a computer system (and in a computing environment) be upgraded to Release 5U1. However, the upgrade of Web Proxy Server to Release 5U1 only requires that Windows Installer patch (126910–02) is already applied.
The Web Proxy Server upgrade to Release 5U1 does not modify the Release 5 configuration data. There is no need to back up current data.
This section discusses considerations that impact the upgrade procedure for Web Proxy Server, followed by a description of the procedure itself.
The upgrade of Web Proxy Server software to Java ES Release 5U1 takes into account the following considerations:
All Web Proxy Server instances corresponding to the same installed Web Proxy 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 5U1 Web Proxy Server upgrade patches for Windows are shown in the following table:
The procedure documented below applies to Web Proxy Server instances residing locally on the computer where the upgrade is taking place.
Log in as administrator.
Shut down the Release 5 Web Proxy Server instances and the administration server.
C:\Program Files\Sun\JavaES5\webproxyserver\proxy-admserv\stopsockd.bat
C:\Program Files\Sun\JavaES5\webproxyserver\proxy-server1\stopsvr.bat
C:\Program Files\Sun\JavaES5\webproxyserver\proxy-server1\stopsockd.bat
Make sure you have upgraded any Java ES components upon which Web Proxy Server has hard upgrade dependencies (see Upgrade Web Proxy Server Dependencies.
Obtain the required Web Proxy Server Release 5U1 upgrade patches, based on Table 11–3.
To obtain the patch, see Accessing Java ES Patches. Patches can be downloaded to \workingDirectory.
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.
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.
Verify the patch log file.
The log file is found at: %TEMP%\SUNJAVAES_<patch-id>.log
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.
Start the Release 5U1 Web Proxy Server instances and the administration server.
C:\Program Files\Sun\JavaES5\webproxyserver\proxy-admserv\startsvr.bat
C:\Program Files\Sun\JavaES5\webproxyserver\proxy-server1\startsvr.bat
C:\Program Files\Sun\JavaES5\webproxyserver\proxy-server1\startsockd.bat
You can verify successful upgrade of Web Proxy Server by examining the subcomponent error logs at :
WebProxyServer-base\proxy-admserv\logs\error
WebProxyServer-base\proxy-server1\logs\error
The messages that indicate the Java ES release version are:
Sun Java System Web Proxy Server 4.0.5
Sun Java System Web Proxy Server 4.0.4
There are no post-upgrade tasks beyond the steps described in Upgrade Considerations.
Log in as administrator.
Shut down the Proxy Server instances and the administration server.
Double-click uninstall_patch-id.bat to uninstall the patch.
Restart the administration server and the Proxy Server instances that were shut down in step 2.