![]() | |
Sun Java System Application Server Enterprise Edition 7 2004Q2 Getting Started Guide |
About this Guide
This preface describes the contents of Sun Java System Application Server 7 Getting Started Guide.
This preface addresses the following topics:
What’s In This GuideThis Getting Started Guide is intended for first-time users of the Sun Java System Application Server. It offers a brief, hands-on means of gaining familiarity with Sun Java System Application Server, Enterprise Edition features, with an emphasis on demonstrating the load balancing and HTTP session persistence features. Prior application server and development experience are not prerequisites for the exercises in this guide, though you must install the server using Sun Java System Application Server Installation Guide before starting.
The guide first introduces you to the Sun Java System Application Server, including a brief overview of the clustering, load balancing, and session persistence features. Next, it steps you through the configuration of an environment for running the sample application in the exercises. It shows you how to deploy a sample application to demonstrate and verify load balancing and session persistence. It contains a list of further areas of investigation, and references to where to find more information.
Using the DocumentationThe Sun Java System Application Server Standard and Enterprise Edition manuals are available as online files in Portable Document Format (PDF) and Hypertext Markup Language (HTML).
The following table lists tasks and concepts described in the Sun Java System Application Server manuals. The manuals marked (updated for 7 2004Q2) have been updated for the Sun Java System Application Server Standard and Enterprise Edition 7 2004Q2 release. The manuals not marked in this way have not been updated since the version 7 Enterprise Edition release.
How This Guide is OrganizedThis guide provides a Sun Java System Application Server overview of Enterprise Edition features for those new to Sun Java System Application Server.
The following chapters are included in this guide:
- Chapter 1, "Introduction to Sun Java System Application Server 7, Enterprise Edition" provides an overview of the product, including a brief introduction to clustering, load balancing, HTTP session persistence, and the high-availability database.
- Chapter 3, "Enterprise Features Configuration Tutorial" contains a list of task to do before starting the tutorials, a summary of steps to configure your server to use Enterprise features, and a tutorial on configuring your server to use clusters and HTTP session failover.
- Chapter 2, "Clustering Scenarios" contains procedures to configure HTTP and RMI/IIOP load balancing and failover.
- Chapter 4, "Cluster JSP Sample Application Tutorial" describes the Cluster JSP application, how to deploy it to a cluster, and how to run it. It describes how you can use this application to verify load balancing and HTTP session persistence.
- Chapter 5, "Summary and Next Steps" describes the tasks you’ve completed in this guide and the next steps to take in working with the product.
Finally, an Index is provided.
Documentation ConventionsThis section describes the types of conventions used throughout this guide:
General Conventions
The following general conventions are used in this guide:
- Font conventions include:
- The monospace font is used for sample code and code listings, API and language elements (such as function names and class names), file names, pathnames, directory names, and HTML tags.
- Italic type is used for code variables.
- Italic type is also used for book titles, emphasis, variables and placeholders, and words used in the literal sense.
- Bold type is used as either a paragraph lead-in or to indicate words used in the literal sense.
- Installation root directories for most platforms are indicated by install_dir in this document. Exceptions are noted in Conventions Referring to Directories.
By default, the location of install_dir on most platforms is:
For the platforms listed above, default_config_dir and install_config_dir are identical to install_dir. See Conventions Referring to Directories for exceptions and additional information.
- Instance root directories are indicated by instance_dir in this document, which is an abbreviation for the following:
default_config_dir/domains/domain/instance
- UNIX-specific descriptions throughout this manual apply to the Linux operating system as well, except where Linux is specifically mentioned.
Conventions Referring to Directories
By default, when using the Solaris package-based or Linux RPM-based installation, the application server files are spread across several root directories. This guide uses the following document conventions to correspond to the various default installation directories provided:
- install_dir refers to /opt/SUNWappserver7, which contains the static portion of the installation image. All utilities, executables, and libraries that make up the application server reside in this location.
- default_config_dir refers to /var/opt/SUNWappserver7/domains, which is the default location for any domains that are created.
- install_config_dir refers to /etc/opt/SUNWappserver7/config, which contains installation-wide configuration information such as licenses and the master list of administrative domains configured for this installation.
Contacting SunYou might want to contact Sun Microsystems in order to:
Give Us Feedback
If you have general feedback on the product or documentation, please send this to appserver-feedback@sun.com.
Obtain Training
Application Server training courses are available at:
http://training.sun.com/US/catalog/enterprise/web_application.html/
Visit this site often for new course availability on the Sun Java System Application Server.
Contact Product Support
If you have problems with your system, contact customer support using one of the following mechanisms:
- The online support web site at:
http://www.sun.com/supportraining/
- The telephone dispatch number associated with your maintenance contract
Please have the following information available prior to contacting support. This helps to ensure that our support staff can best assist you in resolving problems:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem. Here are some of the commonly used commands:
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
- Configuration files such as:
- For an application, whether the problem appears when it is running in a cluster or standalone