Preface

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

Who Should Use This Book

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

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

Table 1 Typographic Conventions
Typeface	Meaning	Examples
AaBbCc123 (Monospace)	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.
AaBbCc123 (Monospace bold)	What you type, when contrasted with onscreen computer output.	% su Password:
AaBbCc123 (Italic)	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.

Symbols

Table 2 Symbol Conventions
Symbol	Description	Example	Meaning
[ ]	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.	Control-A	Press the Control key while you press the A key.
+	Joins consecutive multiple keystrokes.	Ctrl+A+N	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

Table 3 Shell Prompts
Shell	Prompt
C shell on UNIX or Linux	machine-name%
C shell superuser on UNIX or Linux	machine-name#
Bourne shell and Korn shell on UNIX or Linux	$
Bourne shell and Korn shell superuser on UNIX or Linux	#
Windows command line	C:\>

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
Document	Contents
Java Enterprise System 5 Update 1 Release Notes http://docs.sun.com/doc/820-2829	Contains the latest information about Java ES, including known problems. In addition, components have their own release notes listed in the Release Notes Collection, http://docs.sun.com/coll/1315.3
Sun Java Enterprise System 5 Update 1 What's New http://docs.sun.com/doc/820-2846	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 http://docs.sun.com/doc/820-2969	Introduces the technical and conceptual foundations of Java ES. Describes components, the architecture, processes, and features.
Java Enterprise System Deployment Planning Guide http://docs.sun.com/doc/819-2326	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 http://docs.sun.com/doc/819-5079	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 http://docs.sun.com/doc/820-2827	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 http://docs.sun.com/doc/820-2828	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 http://docs.sun.com/doc/820-2510 Java Enterprise System 5 Update 1 Upgrade Guide for Windows http://docs.sun.com/doc/820-2506	Provides instructions for upgrading to Java ES 5 Update 1 from previously installed versions.
Java Enterprise System 5 Update 1 Monitoring Guide http://docs.sun.com/doc/820-2743	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 http://docs.sun.com/doc/819-3875	Defines terms that are used in Java ES documentation.

Searching Sun Product Documentation

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

To include other Sun web sites in your search (for example, java.sun.com, www.sun.com, developers.sun.com), use sun.com in place of docs.sun.com 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

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 http://docs.sun.com 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
Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX