Sun ONE Application Server 7 Administrator's Guide |
About This Guide
This guide describes how to configure and administer Sun ONE Application Server 7. It is intended for information technology administrators in the corporate enterprise who want to extend client-server applications to a broader audience through the World Wide Web.
This preface includes the following sections:
What’s In This Guide?This guide explains how to configure and administer the Sun ONE Application Server. After configuring your server, use this guide to help maintain your server.
How This Guide Is OrganizedThis guide is divided into four parts, plus a comprehensive index. Begin with “Part 1, "Server Basics and Administering Global Settings," for an overview of the product. “Part 2, "Managing an Individual Server Instance," introduces you to using the Administration Server, and to using other server functions that affect all server instances.
Once you are familiar with the fundamentals of using the Administration Server, you can refer to “Part 3, "Managing HTTP Server Features and Virtual Servers," which provides information for using programs and configuration styles.
Finally, Appendixes addresses specific reference topics that describe the various topics, including internationalization issues, server extensions, and the Sun ONE Application Server command line interface documentation.
Part I: Server Basics and Administering Global Settings
This part provides an overview of the Sun ONE Application Server. The following chapters are included:
- Chapter 1, "Getting Started with Sun ONE Application Server Administration," provides an overview of Sun ONE Application Server.
- Chapter 2, "Setting Administration Server Preferences," describes how to manage your Administration Server.
- Chapter 3, "Configuring Administrative Domains," describes how to use multiple domains.
Part II: Managing an Individual Server Instance
This part provides conceptual and procedural details about configuring, managing, and using server instances. The following chapters are included:
- Chapter 4, "Using Application Server Instances," describes how to configure server preferences for your Sun ONE Application Server.
- Chapter 5, "Using Logging," describes the foundation for logging, and the logging features and functions within Sun ONE Application Server.
- Chapter 6, "Monitoring the Sun ONE Application Server," contains information about the monitoring and Simple Network Management Protocol (SNMP) features and functions available within Sun ONE Application Server.
- Chapter 7, "Configuring the Web Server Plugin," explains how Sun ONE Application Server processes HTTP requests, and how to configure and use the web server plugin with Sun ONE Application Server.
- Chapter 8, "Configuring J2EE Containers," explains how to configure and use the container that provide runtime support for J2EE application components such as Enterprise Java Beans (EJBs) and Message Driven Beans (MDBs).
- Chapter 9, "Using Transaction Services," explains database transactions and how to use manage them.
- Chapter 10, "Configuring Naming and Resources," explains how to configure J2EE resources.
- Chapter 11, "Using the JMS Service," provides information needed to understand and administer the built-in JMS Service provided through Sun ONE Message Queue, the native JMS provider.
- Chapter 12, "Configuring the Server For CORBA/IIOP Clients," explains how to configure support for CORBA-based clients, using the RMI/IIOP protocol within an Sun ONE Application Server environment.
- Chapter 13, "Deploying Applications," describes how to deploy applications to the Sun ONE Application Server.
Part III: Managing HTTP Server Features and Virtual Servers
This part provides information for using the Administration interface to programs and configuration styles. The following chapters are included:
- Chapter 14, "Configuring HTTP Features," describes how to configure preferences for your HTTP-related features of your Sun ONE Application Server.
- Chapter 15, "Using Virtual Servers," describes how to set up and administer virtual servers using your Sun ONE Application Server.
- Chapter 16, "Managing Virtual Server Content," describes how you can configure and manage your server’s content.
Part IV: Appendixes
This section includes various appendixes with reference material that you may wish to review. This section includes the following appendixes:
- Appendix A, "Using the Command Line Interface," provides instructions for using command line utilities in place of the user interface screens.
- Appendix B, "Third Party Copyright Notices," contains additional copyright information.
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 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/config, 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/domainswhich 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.
Product Line OverviewSun ONE Application Server 7 is a J2EE 1.3 specification-compatible application server which also supports emerging Java Web Services standards as well as standard HTTP server programming facilities. Three editions of the application server are offered to suit a variety of needs for both production and development environments:
Platform Edition
Platform Edition forms the core of the Sun ONE Application Server 7 product line. This free-for-production-use product offers a high-performance, small-footprint J2EE 1.3 specification-compatible runtime environment that is ideally suited for basic operational deployments, as well as for embedding in third-party applications. Web-services ready, the Platform Edition includes built-in technologies proven by the Sun ONE Web Server and Sun ONE Message Queue products.
Platform Edition deployments are limited to single application server instances (i.e. single virtual machines for the Java platform (“Java virtual machine” or “JVM”)). Multi-tier deployment topologies are supported by the Platform edition, but the web server tier proxy does not perform load balancing. In Platform Edition, administrative utilities are limited to local clients only.
Platform Edition is integrated into Solaris 9.
Standard Edition
This is the edition that is the focus of this Administrator’s Guide. The Standard Edition layers enhanced, remote-management capabilities on top of the Platform Edition. Enhanced management capabilities, remote command-line, and web-based administration are all included as part of the Standard Edition. This edition also includes the ability to partition web application traffic through a web server tier proxy. Standard Edition supports configuration of multiple application server instances (JVMs) per machine.
Enterprise Edition
Enterprise Edition enhances the core application server platform with greater high availability, load balancing and clustering capabilities suited for the most demanding J2EE-based application deployments. The management capabilities of the Standard Edition are extended in Enterprise Edition to account for multi-instance and multi-machine deployments.
Clustering support includes easy-to-configure groups of cloned application server instances to which client requests can be load balanced. Both external load balancers and load balancing web tier-based proxies are supported by this edition. HTTP session, stateful session bean instance and Java Message Service (JMS) resource failover are included in the Enterprise Edition. The patented “Always On” highly available database technology forms the basis for the HA persistence store in the Enterprise Edition.
For more product information, see the Sun ONE Application Server page on the Sun Microsystems web site.
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.
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