Sun Java Enterprise System 2005Q4 Upgrade Guide |
Chapter 10
Web Proxy ServerThis chapter describes how to upgrade Web Proxy Server to Java ES 2005Q4 (Release 4): Sun Java System Web Proxy Server 4.0 2005Q4.
The chapter provides a general overview of upgrade issues as well as the upgrade procedure. The upgrade of Web Proxy Server is supported only on Solaris platforms:
Overview of Web Proxy Server UpgradesThis section describes the following general aspects of Web Proxy Server that impact upgrading to Java ES 2005Q4 (Release 4):
About Java ES Release 4 Web Proxy Server
Java ES Release 4 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 Java Enterprise System.
Web Proxy Server Upgrade Roadmap
Table 10-1 shows the Web Proxy Server upgrade path to Java ES Release 4. Web Proxy Server was not included in previous Java ES releases. The table applies to the Solaris operating system only, because Web Proxy Server was not previously supported on the Linux operating system.
Web Proxy Server Data
The following table shows the type of data that could be impacted by an upgrade of Web Proxy Server software.
Compatibility Issues
Release 4 Web Proxy Server represents a major change in the Netscape Server API (NSAPI) interface supported by Version 3.6. Any NSAPI plug-ins developed for Version 3.6 will need to be recompiled against the current version of NSAPI to resolve incompatibilities.
Web Proxy Server Dependencies
Web Proxy Server dependencies on other Java ES components can impact the procedure for upgrading and re-configuring Web Proxy Server software.
Web Proxy Server has dependencies on specific Java ES shared components (see Table 1-6), but has no dependencies on other Java ES product components. It can be used with Directory Server, Web Server, and Application Server, but has no dependencies on these components.
Upgrading Web Proxy Server to Release 4This section includes information about upgrading Web Proxy Server from Version 3.6 to Java ES 2005Q4 (Release 4). The section covers the following topics:
Introduction
When upgrading Web Proxy Server to Release 4, consider the following aspects of the upgrade process:
- General Upgrade Approach. The upgrade is performed by using the Java ES installer to install Release 4 Web Proxy Server in a directory different from version 3.6. The Web Proxy Server administration server is then used to migrate configuration settings (but not the cache content) from Version 3.6 to Release 4.
- Upgrade Dependencies. While Web Proxy Server has dependencies on a number of Java ES shared components (see Table 1-6), Release 4 Web Proxy Server is compatible with the Release 3 versions of these components. Upgrade of these shared components, however, is automatically performed by the Java installer when upgrading Web Proxy Server to Release 4.
- Backward Compatibility. Release 4 Web Proxy Server is backwardly compatible with Version 3.6, except that plug-ins developed using the NSAPI interface supported by Version 3.6 must be recompiled with the NSAPI interface supported by Release 4.
- Upgrade Rollback. Rollback of the Release 4 upgrade of Web Proxy Server is achieved by reverting to Version 3.6, which was left unchanged by the upgrade.
- Platform Issues. The approach for upgrading Web Proxy Server is the same on all Solaris platforms, however Version 3.6 is not supported on Linux platforms.
Web Proxy Server Upgrade
This section provides an overview of how to perform an upgrade of Web Proxy Server to Java ES Release 4. Web Proxy Server was not previously supported on the Linux platform. Hence upgrade of Web Proxy Server to Java ES Release 4 is only performed on the Solaris platform. The section covers the following topics:
Pre-Upgrade Tasks
Before you upgrade Web Proxy Server you should perform the tasks described below.
Verify Current Version Information
You can verify the current version of Web Proxy Server by entering the following command:
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 Java ES Release 4. However, the Java ES installer that is used to upgrade Web Proxy Server to Release 4 automatically upgrades all shared components upon which Web Proxy Server depends (see Table 1-6).
Back Up Web Proxy Server Data
The Web Proxy Server upgrade to Release 4 does not modify Version 3.6 configuration data. However any unsaved changes to Version 3.6 configuration data made using the administration interface must be saved before performing the upgrade.
Obtain Required Configuration Information and Passwords
To upgrade from Version 3.6, you need to know the installation directory path for that installed version.
Upgrading 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
All Web Proxy Server instances corresponding to the same installed Web Proxy Server image are upgraded at the same time. However, the migration of configuration data has to be done separately for each instance. All such instances should be shut down when patches are being applied to the installed image.
Upgrade Procedure
The procedure documented below applies to Web Proxy Server software on the computer where the upgrade is taking place.
- Log in as root or become superuser.
su -
- Install Web Proxy Server Release 4.
- Migrate configuration settings to the newly installed version.
This operation must be performed separately for each Web Proxy Server instance.
- Start the Web Proxy Server Administration Server.
WebProxyServer-base/proxy-admserv/start
- Log in to the administration graphical interface.
- Click on the Server tab and then click Migrate Server.
- Specify the Version 3.6 installation directory path.
- Select the instance to migrate.
- Click the Migrate button.
After successful migration, the migration screen provides a list of additional configurations that must be performed manually. It provides the data that needs to be added and the corresponding configuration file.
For more information on migrating configuration settings refer to Sun Java System Web Proxy Server 4 2005Q4 Installation and Migration Guide (http://docs.sun.com/doc/819-3649)
- Make any additional configuration changes specified in Step f.
Refer to the Sun Java System Web Proxy Server 4 2005Q4 Configuration File Reference (http://docs.sun.com/doc/819-3651) for more information.
Verifying the Upgrade
You can verify the upgrade of Web Proxy Server to Release 4 by starting a Web Proxy Server instance with the -version option:
See Table 10-3 for output values.
Post-Upgrade Tasks
There are no post-upgrade tasks beyond the steps described in Upgrade Procedure.
Rolling Back the Upgrade
The upgrade of Web Proxy Server to Release 4, documented in Upgrading Web Proxy Server, cannot be rolled back. However, you can revert to Version 3.6, which was left in tact by the Release 4 upgrade procedure.