This Upgrade guide describes how to upgrade from older versions of application server to Sun GlassFishTM Enterprise Server v2.1.1.
This preface contains information about and conventions for the entire Sun GlassFish Enterprise Server documentation set.
Book Title |
Description |
---|---|
Documentation Center |
Enterprise Server documentation topics organized by task and subject. |
Release Notes |
Late-breaking information about the software and the documentation. Includes a comprehensive, table-based summary of the supported hardware, operating system, JavaTM Development Kit (JDKTM), and database drivers. |
Quick Start Guide |
How to get started with the Enterprise Server product. |
Installation Guide |
Installing the software and its components. |
Application Deployment Guide |
Deployment of applications and application components to the Enterprise Server. Includes information about deployment descriptors. |
Developer’s Guide |
Creating and implementing Java Platform, Enterprise Edition (Java EE platform) applications intended to run on the Enterprise Server that follow the open Java standards model for Java EE components and APIs. Includes information about developer tools, security, debugging, and creating lifecycle modules. |
Java EE 5 Tutorial |
Using Java EE 5 platform technologies and APIs to develop Java EE applications. |
Java WSIT Tutorial |
Developing web applications using the Web Service Interoperability Technologies (WSIT). Describes how, when, and why to use the WSIT technologies and the features and options that each technology supports. |
Administration Guide |
System administration for the Enterprise Server, including configuration, monitoring, security, resource management, and web services management. |
High Availability Administration Guide |
Setting up clusters, working with node agents, and using load balancers. |
Administration Reference |
Editing the Enterprise Server configuration file, domain.xml. |
Performance Tuning Guide |
Tuning the Enterprise Server to improve performance. |
Reference Manual |
Utility commands available with the Enterprise Server; written in man page style. Includes the asadmin command line interface. |
The following table describes the default paths and file names that are used in this book.
Table P–2 Default Paths and File Names
Placeholder |
Description |
Default Value |
---|---|---|
as-install |
Represents the base installation directory for Enterprise Server. |
SolarisTM and Linux installations, non-root user: user’s-home-directory/SUNWappserver Solaris and Linux installations, root user: /opt/SUNWappserver Windows, all installations: SystemDrive:\Sun\AppServer |
domain-root-dir |
Represents the directory containing all domains. |
All installations: as-install/domains/ |
domain-dir |
Represents the directory for a domain. In configuration files, you might see domain-dir represented as follows: ${com.sun.aas.instanceRoot} |
domain-root-dir/domain-dir |
instance-dir |
Represents the directory for a server instance. |
domain-dir/instance-dir |
samples-dir |
Represents the directory containing sample applications. |
as-install/samples |
docs-dir |
Represents the directory containing documentation. |
as-install/docs |
The following table describes the typographic changes that are used in this book.
Table P–3 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. |
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. |
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/)
Third-party URLs are referenced in this document and provide additional, related information.
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 is interested in improving its documentation and welcomes your comments and suggestions.
To share your comments, go to http://docs.sun.com and click Feedback. 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.