Sun Java Enterprise System 5 Upgrade Guide for UNIX |
Chapter 13
Web Proxy ServerThis 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. The chapter covers upgrades on both the Solaris and Linux operating systems:
Overview of Web Proxy Server UpgradesThis section describes the following general aspects of Web Proxy Server that impact upgrading to Java ES 5 (Release 5):
About Java ES Release 5 Web Proxy Server
Java ES Release 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 Java Enterprise System.
Web Proxy Server Upgrade Roadmap
Table 13-2 shows the Web Proxy Server upgrade path to Java ES Release 5. Web Proxy Server was not included in previous Java ES releases. The table applies to the Solaris OS only, because Web Proxy Server was not previously supported on the Linux OS.
Web Proxy Server Data
The following table shows the type of data that could be impacted by an upgrade of Web Proxy Server software.
Web Proxy Server Upgrade Strategy
Your strategy for upgrading Web Proxy Server generally depends on the many considerations discussed in Chapter 1, "Planning for Upgrades": upgrade path, dependencies between Java ES components, selective upgrade versus upgrade all, multi-instance deployments, and so forth.
This section is to particularize that general discussion to Web Proxy Server by presenting issues that might influence your Web Proxy Server upgrade plan.
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 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 5.
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-9).
- 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.
Dual Upgrade
Dual upgrades, in which both Web Proxy Server and operating system are upgraded (as described in Dual Upgrades: Java ES and Operating System Softwared) can be performed using the in-place operating system upgrade approach:
- Back up existing Web Proxy Server data.
See Web Proxy Server Data for the location of essential data.
- Upgrade the operating system.
The upgrade leaves the existing file system in place.
- Upgrade to Release 5 Web Proxy Server.
See the appropriate section of this chapter, depending on upgrade path.
Upgrading Web Proxy Server from Java ES Release 4This section includes information about upgrading Web Proxy Server from Java ES 2005Q4 (Release 4) to Java ES 5 (Release 5). The section covers the following topics:
Introduction
When upgrading Web Proxy Server to Release 5, 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-9), 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. Rollback of the Release 5 upgrade of Web Proxy Server is achieved by removing the upgrade patches.
- Platform Issues. The general approach for upgrading Web Proxy Server is the same on both Solaris and Linux operating systems, however the patching technologies are different. The upgrade process therefore includes platform-specific procedures.
Release 4 Web Proxy Server Upgrade
This section provides an overview of how to perform an upgrade of Web Proxy Server to Java ES Release 5. The section covers the following topics:
Pre-Upgrade Tasks
Before you upgrade Web Proxy Server, you should perform the following tasks:
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 5. However, the upgrade of Web Proxy Server to Release 5 only requires that the NSS and NSPR shared components be upgraded. If these shared components have not yet been upgraded, you should synchronize all shared components to their Release 5 versions using the Synchronize Shared Components option. Instructions are provided in Chapter 2, "Upgrading Java ES Shared Components".
Back Up Web Proxy Server Data
The Web Proxy Server upgrade to Release 5 does not modify Release 4 configuration data. There is no need to back up current data.
Obtain Required Configuration Information and Passwords
No special information about your currently installed version is needed. However you will have to log in as superuser to perform the upgrade.
Upgrading Release 4 Web Proxy Server (Solaris)
This section discusses considerations that impact the upgrade procedure for Web Proxy Server followed by a description of the procedure itself.
Upgrade Considerations (Solaris)
The upgrade of Web Proxy Server software to Java ES Release 5 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 5 Web Proxy Server upgrade patches for Solaris OS are shown in the following table:
Table 13-5 Patches1 to Upgrade Web Proxy Server on Solaris
Description
Patch ID: SPARC
Solaris 9 & 10
Patch ID: X86
Solaris 9 & 10
Web Proxy Server core
120981-10
120982-10
Web Proxy Server localization
122963-01
122964-01
1Patch revision numbers are the minimum required for upgrade to Java ES Release 5. If newer revisions become available, use the newer ones instead of those shown in the table.
Upgrade Procedure (Solaris)
The procedure documented below applies to Web Proxy Server on the computer where the upgrade is taking place.
- Log in as root or become superuser.
su -
- Stop all running instances of Web Proxy Server and the Administration Server.
WebProxyServer-base/proxy-instanceName/stop
WebProxyServer-base/proxy-admserv/stop- If you have not already done so, synchronize all shared component to Release 5.
Instructions are provided in Chapter 2, "Upgrading Java ES Shared Components".
- Obtain the required patches, based on Table 13-5.
Patches can be downloaded to /tmp from: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- Apply the appropriate Web Proxy Server core and, if needed, localization patches in Table 13-5, in that order.
patchadd /tmp/patch_ID
- Confirm that the patch upgrades were successful:
showrev -p | grep proxy
The output should return the versions of patch IDs applied in Step 5.
- Restart the Web Proxy Server instances that were stopped in Step 2.
WebProxyServer-base/proxy-instanceName/start
Upgrading Release 4 Web Proxy Server (Linux)
This section discusses considerations that impact the upgrade procedure for Web Proxy Server followed by a description of the procedure itself.
Upgrade Considerations (Linux)
The upgrade of Web Proxy Server software to Java ES Release 5 on the Linux platform takes into account the same considerations as on the Solaris platform (see Upgrade Considerations), except that the Linux Release 5 upgrade patches differ from the Solaris patches.
The Release 5 Web Proxy Server upgrade patches for Linux OS are shown in the following table:
Table 13-6 Patches1 to Upgrade Web Proxy Server on Linux
Description
Patch ID and RPM names
Web Proxy Server core
120983-10
Web Proxy Server localization
122965-01
1Patch revision numbers are the minimum required for upgrade to Java ES Release 5. If newer revisions become available, use the newer ones instead of those shown in the table.
Upgrade Procedure (Linux)
The procedure documented below applies to Web Proxy Server on the computer where the upgrade is taking place.
- Log in as root or become superuser.
su -
- Stop all running instances of Web Proxy Server and the Administration Server.
WebProxyServer-base/proxy-instanceName/stop
WebProxyServer-base/proxy-admserv/stop- If you have not already done so, synchronize all shared component to Release 5.
See Upgrade Web Proxy Server Dependencies.
- Obtain the required patches using the patch numbers and RPM names from Table 13-6. Use this information to obtain the version numbers for the RPM.
Patches can be downloaded to /tmp from: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- Apply the core and, if needed, localization RPMs for Web Proxy Server in Table 13-6, in that order.
rpm -Fvh sun-proxyserver-version.i386.rpm
- Confirm that the patch upgrades were successful:
rpm -qa | grep sun-proxyserver
The new version numbers of the RPMs should be returned.
- Restart the Web Proxy Server instances that were stopped in Step 2.
WebProxyServer-base/proxy-instanceName/start
Verifying the Upgrade
You can verify the upgrade of Web Proxy Server to Release 5 by starting a Web Proxy Server instance with the -version option:
WebProxyServer-base/proxy-admserv/start -version
See Table 13-4 for output values.
Post-Upgrade Tasks
There are no post-upgrade tasks beyond the steps described in Upgrade Procedure (Solaris) and Upgrade Procedure (Linux).
Rolling Back the Upgrade (Solaris)
This section describes considerations that impact the upgrade rollback procedure for Web Proxy Server followed by the procedure itself.
Rollback Considerations (Solaris)
The procedure for rolling back the upgrade to Release 5 of Web Proxy Server is pretty much the reverse of the procedure for upgrading to Release 5.
Rollback Procedure (Solaris)
- Log in as root or become superuser.
su -
- Stop all running instances of Web Proxy Server and the Administration Server.
WebProxyServer-base/proxy-instanceName/stop
WebProxyServer-base/proxy-admserv/stop- Remove the patches in Table 13-5.
patchrm patch_ID
- Restart the Web Proxy Server instances that were stopped in Step 2.
WebProxyServer-base/proxy-instanceName/start
Upgrading Web Proxy Server from Version 3.6This section includes information about upgrading Web Proxy Server from Version 3.6 to Java ES 5 (Release 5). The section covers the following topics:
Introduction
When upgrading Web Proxy Server to Release 5, consider the following aspects of the upgrade process:
- General Upgrade Approach. The upgrade is performed by using the Java ES installer to install Release 5 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 5.
- Upgrade Dependencies. Installation of shared components is automatically performed by the Java ES installer when upgrading Web Proxy Server to Release 5.
- Backward Compatibility. Release 5 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 5.
- Upgrade Rollback. Rollback of the Release 5 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.
Version 3.6 Web Proxy Server Upgrade
This section provides an overview of how to perform an upgrade of Web Proxy Server to Java ES Release 5. Web Proxy Server was not previously supported on the Linux platform. Hence upgrade of Web Proxy Server to Java ES Release 5 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 following tasks:
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 5. However, the Java ES installer that is used to upgrade Web Proxy Server to Release 5 automatically upgrades all shared components upon which Web Proxy Server depends (see Table 1-9).
Back Up Web Proxy Server Data
The Web Proxy Server upgrade to Release 5 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 Version 3.6 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 can be upgraded. However, the migration of configuration data has to be done separately for each instance. All such instances should be shut down when migration is performed to make sure that no port conflicts arise when migrated instance is started.
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 5.
- 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.0.4 Installation and Migration Guide, http://docs.sun.com/doc/819-5492.
- Make any additional configuration changes specified in Step f.
Refer to the Sun Java System Web Proxy Server 4.0.4 Configuration File Reference, http://docs.sun.com/doc/819-5494, for more information.
Verifying the Upgrade
You can verify the upgrade of Web Proxy Server to Release 5 by starting a Web Proxy Server instance with the -version option:
See Table 13-7 for output values.
Post-Upgrade Tasks
There are no post-upgrade tasks beyond the steps described in Upgrade Procedure.
Rolling Back the Version 3.6 Upgrade
The upgrade of Web Proxy Server to Release 5, documented in Upgrading Version 3.6 Web Proxy Server, cannot be rolled back. However, you can revert to Version 3.6, which was left intact by the Release 5 upgrade procedure.