Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows

Overview of Web Server Upgrades

The following sections describe general aspects of Web Server that impact upgrading to Release 5U1:

About Release 5U1 Web Server

Release 5U1 Web Server is a maintenance release that fixes bugs in Release 5 Web Server. Release 5 Web Server was a feature release with respect to Release 4. It has a number of new features and interface enhancements.

Release 5 Web Server introduced a new administrative infrastructure with new administrative tools. The administrative infrastructure includes an Administration Server instance which hosts configuration information for any number of Web Server instances. A new command line interface (wadm) and a new graphical user interface are used to create Web Server instances, either locally or on remote computers, and to configure and manage these instances. The new administrative tools require an administrator user name and password.

For more information about the new administrative infrastructure introduced in Release 5 Web Server, see Web Server 7.0 Administrator's Guide.

These changes in the Web Server administrative interface have a significant impact on upgrade.

Web Server Upgrade Roadmap

The following table shows the supported Web Server upgrade paths to Release 5U1.

Table 5–1 Upgrade Paths to Java ES 5 Update 1 Web Server 7.0

Java ES Release  

Web Server Release  

General Approach 

Reconfiguration Required  

Release 5 

Sun Java System Web Server 7.0 

Maintenance upgrade. Apply patches. 


Release 4 


Direct upgrade of Web Server from Release 4 to Release 5U1 is not supported. This upgrade path is supported by first upgrading Release 4 Web Server to Release 5 Web Server and then upgrading Release 5 to Release 5U1. The information about upgrading Release 4 to Release 5 is documented in Sun Java ES 5 Upgrade Guide for Microsoft Windows.


Web Server Data

The following table shows the type of Web Server data.

Table 5–2 Web Server Data Usage

Type of Data 



Configuration data 

Web Server 6.x (Java ES 4): 


Web Server 7.0 (Java ES Release 5 and 5U1): 


Central Configuration Store. This is not a public interface that is managed by the admin-server instance.

Configuration of Web Server instance 

Web Server Compatibility Issues

The new administrative interfaces introduced in Release 5 Web Server are not backwardly compatible with earlier administrative interfaces. This impacts the upgrade and redeployment of web applications (including, for example, Java ES components).

Caution – Caution –

Web Server 7.0 Update 1 has compatibility issues with Portal Server. On a Java ES 5 setup that has Portal Server on Web Server, upgrading Web Server to Java ES 5 Update 1 level renders Portal Server as unusable. Release 5U1 Web Server uses JSF 1.2. But JSF-Portlet bridge in Release 5 Portal Server does not support JSF 1.2. So Portal Server will not work. Do not upgrade Web Server to Release 5U1 in case you want to continue using Release 5 Portal Server.

If you have deployed Web Server 7.0 and Portal Server on Windows, contact Sun Support for more information on how to upgrade to Web Server 7.0 Update 1.

In particular, Release 5 and Release 5U1 Web Server use defaults for instance directories and virtual server names different from earlier releases, as shown in the following table.

Table 5–3 Web Server Instance Directories and Virtual Server Names


Java ES 4 Web Server 6.x Default

Java ES 5 Web Server 7.0 Default 

Configuration name  



Instance directory path 



Virtual server name 



Web Server Dependencies

Web Server has dependencies on the following Java ES components: