test

Sun Java Enterprise System 5 Upgrade Guide for Microsoft Windows

Chapter 8 Web Proxy Server

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.

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:

About Java ES 5 Web Proxy Server

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.

Web Proxy Server Upgrade Roadmap

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 

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

Web Proxy Server Compatibility Issues

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

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.

Upgrading Web Proxy Server from Java ES Release 4

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:

Introduction

When upgrading Java ES Release 4 Web Proxy Server to Release 5, consider the following aspects of the upgrade process:

Release 4 Web Proxy Server Upgrade

This section describes how to perform a Java ES 4 Web Proxy Server upgrade to Java ES 5. The section covers the following topics:

Pre-Upgrade Tasks

Before you upgrade Web Proxy Server, perform the procedures described in the following sections.

ProcedureTo Verify Current Version Information

    Type the following command.

    WebProxyServer-base\proxy-admserv\start -version

    The outputs that indicate the Web Proxy Server version are:

    Release 5

    Sun Java System Web Proxy Server 4.0.4

    Release 4

    Web Proxy Server 4.0.1

Upgrading Web Proxy Server Dependencies

All Java ES components on a computer system and in a computing environment should be upgraded to Java ES Release 5.

Backing Up Web Proxy Server Data

The Web Proxy Server upgrade to Release 5 does not modify Release 4 configuration data. You do not need to back up current data.

ProcedureTo Upgrade Web Proxy Server

Before You Begin

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.

  1. Log in as administrator.

  2. Stop all running instances of Web Proxy Server and the Administration Server.

    WebProxyServer-base\proxy-instancename\stopsvr

    WebProxyServer-base\proxy-admserv\stopsvr

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

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

    Note –

    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.

    1. Download Patch-ID.zip.

    2. Unzip the zip file.

    3. Execute Patch-ID.exe.

  5. Confirm that the patch upgrades were successful.

    You can confirm patch upgrade by checking the patch installation log.

  6. Restart the Web Proxy Server instance.

    WebProxyServer-base\proxy-instancename\startsvr

ProcedureTo Verify Web Proxy Server Upgrade

    Type the following command.

    WebProxyServer-base\proxy-admserv\start -version

    The outputs that indicate the Web Proxy Server version are:

    Release 5

    Sun Java System Web Proxy Server 4.0.4

    Release 4

    Web Proxy Server 4.0.1

ProcedureTo Remove Web Proxy Server Patches

  1. Log in as administrator.

  2. Stop all running instances of Web Proxy Server and the Administration Sever.

    WebProxyServer-base\proxy-instancename\stopsvr

    WebProxyServer-base\proxy-admserv\stopsvr

  3. Remove the Web Proxy Server patches by typing the following command:

    Uninstall_Patch_ID.bat.

  4. Restart the Web Proxy Server instances.