Sun ONE Application Server 7 Getting Started Guide |
Preface
This chapter describes the contents of Sun Open Net Environment (Sun ONE) Application Server 7 Getting Started Guide.
This preface contains the following sections:
About This GuideThis Getting Started Guide is intended for first-time users of the Sun ONE Application Server. It offers a brief, hands-on means of gaining familiarity with basic development and administrative facilities of the product. Following this guide will typically take one to two hours of your time. Prior application server and development experience are not prerequisites for the exercises in this guide.
The guide first introduces you to the application server, then leads you through the configuration of a typical environment. Next, it describes the basic Evaluation Installation process for users who have not yet installed the product. The guide then demonstrates some commonly performed tasks from basic administrative operations, such as starting and stopping application server instances, to building, deploying and modifying an application. Further tasks explore common administrative activities such as changing the server port number, creating virtual servers, creating application server instances, and creating administrative domains.
See the Sun ONE Application Server 7 documentation collection at http://docs.sun.com for the latest version of this document.
How This Guide is OrganizedThe following chapters are included in this guide:
- Chapter 1, "Introduction to Sun ONE Application Server 7" provides an overview of the application server.
- Chapter 2, "Evaluation Installation of Sun ONE Application Server" contains the quick installation procedures for both the Windows and UNIX� platforms. This option allows users to rapidly install the Sun ONE Application Server for evaluation purposes.
- Chapter 3, "Setting Up Your Environment" describes how to add the application server's bin directory to your PATH environment variable.
- Chapter 4, "Starting and Stopping the Application Server" describes how to start the application server environment and verify that it is running properly.
- Chapter 5, "Becoming Familiar with the Sample Applications" describes how to build and deploy a basic sample application. After successfully verifying that the application works correctly, you will modify the application and redeploy it.
- Chapter 6, "Setting Up Database Connectivity" describes how to define the necessary JDBC-related settings in the application server environment prior to deploying and exercising the sample.
- Chapter 7, "Deploying and Running the Sample Application" describes how to use the Ant facility and the sample’s build.xml file to quickly compile the application source code and reassemble the EAR file from scratch, then deploy this newly built EAR file to the application server and exercise the application.
- Chapter 8, "Modifying the Sample Application" introduces the dynamic deployment capabilities of the application server and leads you through several practical examples based on the sample application you previously deployed.
- Chapter 9, "Exploring the Server Further" leads you through several exercises that demonstrate common administrative activities.
- Chapter 10, "Summary and Next Steps" describes the tasks you’ve completed in this guide and the next steps to take in working with the product.
Using the DocumentationThe Sun ONE Application Server manuals are available as online files in Portable Document Format (PDF) and Hypertext Markup Language (HTML) formats, at:
The following table lists tasks and concepts described in the Sun ONE Application Server manuals. The left column lists the tasks and concepts, and the right column lists the corresponding manuals.
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, path names, directory names, and HTML tags.
- Italic type is 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 8 and 9 package-based installation and the Solaris 9 bundled installation, the application server files are spread across several root directories. These directories are described in this section.
- For Solaris 9 bundled installations, this guide uses the following document conventions to correspond to the various default installation directories provided:
- install_dir refers to /usr/appserver/, 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/appserver/domains, which is the default location for any domains that are created.
- install_config_dir refers to /etc/appserver/, which contains installation-wide configuration information such as licenses and the master list of administrative domains configured for this installation.
- For Solaris 8 and 9 package-based, non-evaluation, unbundled installations, 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/, which contains installation-wide configuration information such as licenses and the master list of administrative domains configured for this installation.
Product SupportIf you have problems with your system, contact customer support using one of the following mechanisms:
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
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps