Chapter 1 Overview

The Sun Java^TM System Application Server product is a Java EE 5 platform-compatible server for the development and deployment of Java EE applications and Java Web Services. Production use of this server is free of charge. Sun Java System Application Server is free for development, deployment and redistribution. If you are a customer who is interested in redistribution, contact Sun OEM sales for a redistribution license.

The Sun Java System Application Server product greatly simplifies the task of creating and administering Web services applications. It provides superior performance, clustering, and high availability features for scalable services that continue to operate despite software and hardware faults. The Application Server provides a development path for web services that simplifies the development process while providing uniquely flexible growth opportunities.

About These Notes

These Release Notes contain important information available at the time of release of Sun Java System Application Server 9.1 and 9.1 Update 2. Enhancements, known problems, and other late-breaking issues are addressed here. Read this document before you begin using Application Server 9.1 or 9.1 Update 2.

The most up-to-date version of these release notes can be found at the Sun Java System Application Server documentation web site. Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and product documentation.

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 by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Release Notes Revision History

This section lists the changes that have been made in these release notes after the initial release of the Sun Java System Application Server 9.1 product.

Table 1–1 Release Notes Revision History


Revision Date	Description
December 2007	FCS release of the Sun Java System Application Server 9.1 product.
February 2008	Ubuntu Linux FCS release of the Sun Java System Application Server 9.1 product.
April 2008	Release of the Sun Java System Application Server 9.1 Update 2 product.
June 2008	Changed Sun Java Web Server supported to 6.1, 7.0. Added System Virtualization Support section.
November 2008	Added text on Message Queue version limitations in the Hardware and Software Requirements section. Added procedure To Switch to the Supported J2SE Version in the Hardware and Software Requirements section. Added Macintosh to Platforms Supported section, for development only. Added Note below the platforms table to explain how to get Mac software. Added bug 6740794 to Message Queue Known Issues. Updated Known Issue 6516068 to specify Internet Explorer 7.0 in addition to 6.0.
December 2008	Added bug 6774663 to Installation Known Issues.
February 2009	Updated Supported Platforms to remove Java SE 6 from support for AIX.
April 2009	Added bug 6796171 to Installation Known Issues.

Ubuntu Operating System Default Paths

Path variables in the Sun Java System Application Server 9.1 documentation set have the following default values in the Ubuntu Linux operating system:

as-install is located at /usr/share/glassfishv2
domain-root-dir is located at /var/lib/glassfishv2/domains
domain-dir is a domain directory under domain-root-dir, as in other operating systems
instance-dir is a server instance directory under domain-dir, as in other operating systems

By default, the /usr/bin/asadmin command creates domains in the user-home-directory/glassfishv2/domains directory. For more information, see the asadmin(1) man page.

Accessibility Features

To obtain accessibility features that have been released since the publishing of this media, consult Section 508 product assessments available from Sun upon request to determine which versions are best suited for deploying accessible solutions. Updated versions of applications can be found at: http://sun.com/software/javaenterprisesystem/get.html

For information on Sun's commitment to accessibility, visit http://sun.com/access.

Related Documentation

Table 1–2 Books in the Application Server Documentation Set


Book Title	Description
Documentation Center	Application 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, Java Development Kit (JDK^TM), and database drivers.
Quick Start Guide	How to get started with the Application Server product.
Installation Guide	Installing the software and its components.
Deployment Planning Guide	Evaluating your system needs and enterprise to ensure that you deploy the Application Server in a manner that best suits your site. General issues and concerns that you must be aware of when deploying the server are also discussed.
Application Deployment Guide	Deployment of applications and application components to the Application 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 Application 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 Application Server, including configuration, monitoring, security, resource management, and web services management.
High Availability Administration Guide	Post-installation configuration and administration instructions for the high-availability database.
Administration Reference	Editing the Application Server configuration file, `domain.xml`.
Upgrade and Migration Guide	Upgrading from an older version of Application Server or migrating Java EE applications from competitive application servers. This guide also describes differences between adjacent product releases and configuration options that can result in incompatibility with the product specifications.
Performance Tuning Guide	Tuning the Application Server to improve performance.
Troubleshooting Guide	Solving Application Server problems.
Error Message Reference	Solving Application Server error messages.
Reference Manual	Utility commands available with the Application Server; written in man page style. Includes the `asadmin` command line interface.

How to Report Problems and Provide Feedback

If you have problems with Sun Java System Application Server, contact Sun customer support using one of the following mechanisms:

Feedback Submittal form — A form for submitting feedback on the Application Server product
GlassFish mailing lists — A variety of GlassFish community mailing lists for various interests and feedback
Bug database on Java Developer Connection — To view bugs or to submit a bug, use the Java Developer Connection Bug Parade
Java Technology Forums — An interactive message board for sharing knowledge and questions about Java technologies and programming techniques; use the Java EE 5 SDK forum for discussions related to the Sun Java System Application Server 9.1 product
Sun Software Support services — Links to the Knowledge Base, Online Support Center, and Product Tracker, as well as to maintenance programs and support contact numbers
The telephone dispatch number associated with your maintenance contract

So that we can best assist you in resolving problems, please have the following information available when you contact support:
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

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 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. For example, the title of this book is Sun Java System Application Server 9.1 Release Notes, and the part number is 820-3530-18.

Additional Sun Resources

Useful information can be found at the following locations: