This chapter describes how to upgrade Web Proxy Server to Java ES 5 (Release 5): Sun Java System Web Proxy Server 4.0.4.
The chapter provides an overview of upgrade considerations for the different upgrade paths supported by Release 5.
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:
Java ES 5 Web Proxy Server represents a minor 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 8–1 Upgrade Paths to Java ES Release 5: Sun Java System Web Proxy Server 4.0.4
Java ES Release |
Web Proxy Server Relase |
General Approach |
Reconfiguration Required |
---|---|---|---|
Release 4 |
Sun Java System Web Proxy Server 4.0.1 2005Q4 |
Direct upgrade: Performed using patches |
None |
The following table shows the type of data that could be impacted by an upgrade of Web Proxy Server software.
Table 8–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 5 Web Proxy Server does not introduce any new public interfaces and is backwardly compatible with Release 4 Web Proxy Server. Release 5 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 5.
Web Proxy Server dependencies on other Java ES components can affect the procedure for upgrading and reconfiguring Web Proxy Server software.
Web Proxy Server has dependencies on specific Java ES shared components, as listed in Table 1–7, but has no dependencies on other Java ES product components. Web Proxy Server can be used with Directory Server, Web Server, and Application Server, but beyond this functional relationship to these components it has no dependencies on them.
This section includes information about upgrading Web Proxy Server from Java ES release 4 to Java ES release 5. The section covers the following topics:
When upgrading Java ES Release 4 Web Proxy Server to Release 5, consider the following aspects of the upgrade process:
General Upgrade Approach. The upgrade is performed using patches. No additional reconfiguration is required.
Upgrade Dependencies. Web Proxy Server has dependencies on a number of Java ES shared components, as listed in Table 1–7. However Web Proxy Server has hard upgrade dependencies only on NSS and NSPR shared components.
Backward Compatibility. Release 5 Web Proxy Server is backwardly compatible with Release 4.
Upgrade Rollback. Release 5 Web Proxy Server upgrade rollback is performed by removing the upgrade patches.
This section describes how to perform a Java ES 4 Web Proxy Server upgrade to Java ES 5. The section covers the following topics:
Before you upgrade Web Proxy Server, perform the procedures described in the following sections.
Type the following command.
WebProxyServer-base\proxy-admserv\start -version
The outputs that indicate the Web Proxy Server version are:
Sun Java System Web Proxy Server 4.0.4
Web Proxy Server 4.0.1
All Java ES components on a computer system and in a computing environment should be upgraded to Java ES Release 5.
The Web Proxy Server upgrade to Release 5 does not modify Release 4 configuration data. You do not need to back up current data.
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.
Log in as administrator.
Stop all running instances of Web Proxy Server and the Administration Server.
WebProxyServer-base\proxy-instancename\stopsvr
WebProxyServer-base\proxy-admserv\stopsvr
If you have not already done so, upgrade the NSS and NSPR shared components to Release 5 and any other shared components you wish to upgrade.
Install Release 5 Web Proxy Server upgrade patches.
Patches can be downloaded from http://sunsolve.sun.com/pub-cgi/show.pl?target=patchpage. The patch ID for Web Proxy Server core is 123533-01.
Patch revision numbers are the minimum required for upgrade to Java ES Release 5. If newer revisions become available, use the newer patches instead of the old patches.
Confirm that the patch upgrades were successful.
You can confirm patch upgrade by checking the patch installation log.
Restart the Web Proxy Server instance.
WebProxyServer-base\proxy-instancename\startsvr
Type the following command.
WebProxyServer-base\proxy-admserv\start -version
The outputs that indicate the Web Proxy Server version are:
Sun Java System Web Proxy Server 4.0.4
Web Proxy Server 4.0.1
Log in as administrator.
Stop all running instances of Web Proxy Server and the Administration Sever.
WebProxyServer-base\proxy-instancename\stopsvr
WebProxyServer-base\proxy-admserv\stopsvr
Remove the Web Proxy Server patches by typing the following command:
Uninstall_Patch_ID.bat.
Restart the Web Proxy Server instances.