Chapter 11 Web Proxy Server

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.

• Overview of Web Proxy Server Upgrade

• Upgrading Web Proxy Server from Java ES 5

---

Note –

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.

---

Overview of Web Proxy Server Upgrade

The following sections describe general aspects of Web Proxy Server that affect upgrading to Java ES 5 Update 1 :

• About Java ES 5 Web Proxy Server

• Web Proxy Server Upgrade Roadmap

• Web Proxy Server Data

• Web Proxy Server Compatibility Issues

• Web Proxy Server Dependencies

About Java ES 5 Web Proxy Server

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.

Web Proxy Server Upgrade Roadmap

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.

Web Proxy Server Data

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

Web Proxy Server Compatibility Issues

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 Dependencies

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.

Upgrading Web Proxy Server from Java ES 5

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:

• Introduction

• Release 5 Web Proxy Server Upgrade

Introduction

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.

Release 5 Web Proxy Server Upgrade

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:

• Pre-Upgrade Tasks

• Upgrading Release 5 Web Proxy Server

• Verifying the Upgrade

• Post-Upgrade Tasks

Pre-Upgrade Tasks

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

• Verify Current Version Information

• Upgrade Web Proxy Server Dependencies

• Backing Up Web Proxy Server Data

Verify Current Version Information

Verify the current version of Web Proxy Server before you upgrade.

To Verify Current Version Information

1. Examine the subcomponent error log at:

   WebProxyServer-base\proxy-admserv\logs\error

   The Web Proxy Server version information is as follows.

   Release 5U1

   Sun Java System Web Proxy Server 4.0.5 (Build Date)

   Release 5

   Sun Java System Web Proxy Server 4.0.4 (Build Date)

Upgrade Web Proxy 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. However, the upgrade of Web Proxy Server to Release 5U1 only requires that Windows Installer patch (126910–02) is already applied.

Backing Up Web Proxy Server Data

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.

Upgrading Release 5 Web Proxy Server

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

Upgrade Considerations

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:

Table 11–3 Patches¹ to Upgrade Web Proxy 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 Proxy Server core	126325–02
Web Proxy Server localization	The localized patch files are delivered within the core patch.

Upgrade Procedure

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

To Upgrade Web Proxy Server to Java ES 5U1

1. Log in as administrator.

2. 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

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

4. 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.

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 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

Verifying the Upgrade

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:

Release 5U1

Sun Java System Web Proxy Server 4.0.5

Release 5

Sun Java System Web Proxy Server 4.0.4

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

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

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