Preface

The Java Enterprise System Installation Reference contains the reference information you need to install the Sun Java^TM Enterprise System (Java ES) software in a Sun Solaris^TM Operating System (Solaris OS), Linux operating environment. Use this manual in conjunction with the Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.

Some instructions in the manual are specific to one platform or are different for each platform, in which case, the information is labeled by platform name. Material that is not labeled by platform name applies to all platforms.

Who Should Use This Manual

The material here is intended for any evaluator, system administrator, or software technician who is installing the Java ES software. This manual assumes you are familiar with the following:

Installation of enterprise-level software products
System administration and networking on your supported Java ES platform
Clustering model (if you are installing clustering software)
Internet and World Wide Web

Contents of This Manual

This manual contains the reference material associated with installation of the Java ES software. The material mainly consists of appendix-like lists and tables. There are no procedures in this document. The following chapters are presented in the order in which they are commonly used:

Chapter 1, Java ES Distribution Bundles. The Java ES distribution bundles are listed by operating system. Each table lists the contents of all bundles associated with that operating system. For instructions on getting the Java ES software, refer to Getting the Java ES Software in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.
Chapter 2, Default Installation Directories and Ports. The default installation directories and ports are used by the Java ES installer when installing the product components. Alternate locations and ports can be selected in most cases.
Chapter 3, Configuration Information. The configuration information for the Configure Now installation type is listed by product component. Each piece of configuration data is identified by a state file parameter that is used in the state file script for an unattended (silent) installation. In the tables, these state file parameters are listed with the field names that appear on the screen of an UNIX interactive installation. For information on postinstallation configuration, refer to Chapter 6, Completing Postinstallation Configuration, in Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX.
Chapter 4, Configuration Worksheets. The configuration worksheets correspond to the information presented in the configuration information chapter. Use the worksheets for gathering configuration information before doing an installation.
Chapter 5, List of Installable Packages. The installed Java ES packages are listed by operating system. Within each operating system section, packages are listed for the following:
- Installation
- Uninstallation
- Product components
- Shared components
- Localized versions

Java ES Documentation Set

The Java ES documentation set describes deployment planning and system installation. The URL for system documentation is http://docs.sun.com/coll/1286.3. For an introduction to Java ES, refer to the books in the order in which they are listed in the following table.

Table P–1 Java Enterprise System Documentation


Document Title	Contents
Sun 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 (`http://docs.sun.com/coll/1315.2`).
Sun Java Enterprise System 5 Update 1 Technical Overview	Introduces the technical and conceptual foundations of Java ES. Describes components, the architecture, processes, and features.
Sun 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.
Sun 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.
Sun Java Enterprise System 5 Update 1 Installation Guide for UNIX Sun Java Enterprise System 5 Installation Guide for Microsoft Windows	Guides you through the process of installing Java ES. Also shows how to configure components after installation, and verify that they function properly.
Sun 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 on the Solaris Operating System and Linux operating environment.
Sun Java Enterprise System 5 Update 1 Upgrade Guide for UNIX Sun Java Enterprise System 5 Update 1 Upgrade Guide for Microsoft Windows	Provides instructions for upgrading to Java ES 5 Update1 from previously installed versions.
Sun 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.
Sun Java Enterprise System Glossary	Defines terms that are used in Java ES documentation.

Typographic Conventions

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

Table P–2 Typographic Conventions


Typeface	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories, and onscreen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
`AaBbCc123`	What you type, contrasted with onscreen computer output	`machine_name%` `su` `Password:`
`AaBbCc123`	A placeholder to be replaced with a real name or value	The command to remove a file is `rm` `filename`.
AaBbCc123	Book titles, new terms, and terms to be emphasized (note that some emphasized items appear bold online)	Read Chapter 6 in the User's Guide. A cache is a copy that is stored locally. Do not save the file.

Shell Prompts in Command Examples

The following table shows default system prompts and superuser prompts.

Table P–3 Shell Prompts


Shell	Prompt
C shell on UNIX and Linux systems	`machine_name%`
C shell superuser on UNIX and Linux systems	`machine_name#`
Bourne shell and Korn shell on UNIX and Linux systems	`$`
Bourne shell and Korn shell superuser on UNIX and Linux systems	`#`

Symbol Conventions

The following table explains symbols that might be used in this book.

Table P–4 Symbol Conventions


Symbol	Description	Example	Meaning
`[ ]`	Contains optional arguments and 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.
`${ }`	Indicates a variable reference.	`${com.sun.javaRoot}`	References the value of the `com.sun.javaRoot` variable.
-	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.

Documentation, Support, and Training

The Sun web site provides information about the following additional resources:

Documentation (http://www.sun.com/documentation/)
Support (http://www.sun.com/support/)
Training (http://www.sun.com/training/)

Searching Sun Product Documentation

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

search-term site:docs.sun.com

For example, to search for “broker,” type the following:

broker site:docs.sun.com

To include other Sun web sites in your search (for example, java.sun.com, www.sun.com, and developers.sun.com), use sun.com in place of docs.sun.com in the search field.

Third-Party Web Site References

Third-party URLs are referenced in this document and provide additional, related information.

Note –

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 full document title and part number. The part number is a 7-digit or 9-digit number that can be found on the book's title page or in the document's URL. For example, the part number of this book is 820-2828.