Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX 


The Java Enterprise System Upgrade Guide for UNIX contains the information you need to upgrade Sun Java™ Enterprise System (Java ES) software in a Sun Solaris™ Operating System (Solaris OS) or Red Hat Enterprise Linux (RHEL) operating system environment. It does not cover upgrade in an HP-UX environment.

The Guide documents upgrades from Java ES 2004Q2 (Release 2), Java ES 2005Q1 (Release 3), and Java ES 2005Q4 (Release 4) to Java ES 5 Update 1 (Release 5 Update 1).

This preface contains the following sections:

Who Should Use This Book

This book is intended for system administrators, or software technicians who wants to upgrade Java ES software.

This book assumes you are familiar with the following:

Conventions Used in This Book

The tables in this section describe the conventions used in this book.

Administrative Interfaces

For most of the upgrade procedures documented in this Upgrade Guide there are two administrative interfaces that can be used: a graphical user interface (GUI) and a command-line interface.

In most cases, the command-line interface is used in this Upgrade Guide when documenting Java ES component upgrade procedures. The command-line interface can be used in scripting the upgrade of Java ES deployments so that procedures can be easily repeated when necessary.

When procedures use the Java ES installer, however, the GUI interface is described, rather than the interactive text-based interface. Java ES installer sessions can be saved in a state file that can be used to repeat procedures when necessary.

Typographic Conventions

The following table describes the typographic changes used in this book.

Table 1 Typographic Conventions 





API and language elements, HTML tags, web site URLs, command names, file names, directory path names, onscreen computer output, sample code.

Edit your.login file.

Use ls -a to list all files.

% You have mail.

(Monospace bold)

What you type, when contrasted with onscreen computer output.

% su


Book titles, new terms, words to be emphasized.

A placeholder in a command or path name to be replaced with a real name or value.

Read Chapter 6 in the User's Guide.

These are called class options.

Do not save the file.

The file is located in the install-dir/bin directory.


The following table describes the symbol conventions used in this book.

Table 2 Symbol Conventions 





[ ]

Contains optional command options.

ls [-l]

The -l option is not required.

{ | }

Contains a set of choices for a required command option.

-d {y|n}

The -d option requires that you use either the y argument or the n argument.


Joins simultaneous multiple keystrokes.


Press the Control key while you press the A key.


Joins consecutive multiple keystrokes.


Press the Control key, release it, and then press the subsequent keys.


Indicates menu item selection in a graphical user interface.

File > New > Templates

From the File menu, choose New. From the New submenu, choose Templates.

Shell Prompts

The following table describes the shell prompts used in this book.

Table 3 Shell Prompts



C shell on UNIX or Linux


C shell superuser on UNIX or Linux


Bourne shell and Korn shell on UNIX or Linux


Bourne shell and Korn shell superuser on UNIX or Linux


Windows command line


Related Documentation

The http://docs.sun.comSM web site enables you to access Sun technical documentation online. You can browse the archive or search for a specific book title or subject.

Books in the Java ES Documentation Set

The Java ES manuals are available as online files in Portable Document Format (PDF) and Hypertext Markup Language (HTML) formats. Both formats are readable by assistive technologies for users with disabilities. The Sun™ documentation web site can be accessed here:

The Java ES documentation includes information about the system as a whole and information about its components. This documentation can be accessed here:

The following table lists the system-level manuals in the Java ES documentation set. The left column provides the name and part number location of each document and the right column describes the general contents of the document.

Table 4 Java Enterprise System Documentation 



Java Enterprise System 5 Update 1 Release Notes

Contains the latest information about Java ES, including known problems. In addition, components have their own release notes listed in the Release Notes Collection,

Sun Java Enterprise System 5 Update 1 What's New

Gives an overview of the new features and functionality introduced in Java ES 5 Update 1. Provides links to the updated documentation.

Java Enterprise System 5 Update 1 Technical Overview

Introduces the technical and conceptual foundations of Java ES. Describes components, the architecture, processes, and features.

Java Enterprise System Deployment Planning Guide

Provides an introduction to planning and designing enterprise deployment solutions based on Java ES. Presents basic concepts and principles of deployment planning and design, discusses the solution life cycle, and provides high-level examples and strategies to use when planning solutions based on Java ES.

Java Enterprise System 5 Installation Planning Guide

Helps you develop the implementation specifications for the hardware, operating system, and network aspects of your Java ES deployment. Describes issues such as component dependencies to address in your installation and configuration plan.

Java Enterprise System 5 Update 1 Installation Guide for UNIX

Guides you through the process of installing Java ES. Also shows how to configure components after installation, and verify that they function properly.

Java Enterprise System 5 Update 1 Installation Reference for UNIX

Gives additional information about configuration parameters, provides worksheets to use in your configuration planning, and lists reference material such as default directories and port numbers.

Java Enterprise System 5 Update 1 Upgrade Guide for UNIX

Java Enterprise System 5 Update 1 Upgrade Guide for Windows

Provides instructions for upgrading to Java ES 5 Update 1 from previously installed versions.

Java Enterprise System 5 Update 1 Monitoring Guide

Gives instructions for setting up the Monitoring Framework for each product component and using the Monitoring Console to view real-time data and create monitoring rules.

Java Enterprise System Glossary

Defines terms that are used in Java ES documentation.

Searching Sun Product Documentation

Besides searching Sun product documentation from the web site, you can use a search engine by typing the following syntax in the search field:


For example, to search for "broker," type the following:


To include other Sun web sites in your search (for example,,,, use in place of in the search field.

Accessing Sun Resources Online

For product downloads, professional services, patches and support, and additional developer information, go to the following:

The following location contains information about Java Enterprise System and its components:

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, go to

Third-Party Web Site References

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused or alleged to be caused by or in connection with use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions.

To share your comments, go to and click Send Comments. In the online form, provide the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document.

Previous      Contents      Index      Next     

Part No: 820-2510-10
November 2007.   Copyright 2004 Sun Microsystems, Inc. All rights reserved.