Java Platform, Enterprise Edition 6 SDK - Release Notes

Java Platform, Enterprise Edition 6 SDK - Release Notes


These Release Notes provide the latest information about Java Platform, Enterprise Edition 6 SDK and Java Platform, Enterprise Edition 6 Web Profile SDK. The following topics are discussed:

Distributions and Their Components


The following distributions are available and include the components listed:

  • Java Platform, Enterprise Edition 6 (Java EE 6) SDK
    • Sun GlassFish Enterprise Server v3
    • Your First Cup: An Introduction to the Java EE Platform
    • Java EE 6 Samples
    • Java EE 6 API Documentation
    • Java EE 6 Tutorial, Volume I

  • Java Platform, Enterprise Edition 6 (Java EE 6) Web Profile SDK
    • Sun GlassFish Enterprise Server v3 Web Profile
    • Your First Cup: An Introduction to the Java EE Platform
    • Java EE 6 Samples
    • Java EE 6 API Documentation
    • Java EE 6 Tutorial, Volume I

Visit the Java EE downloads page for more information about each distribution. See the Java EE 6 SDK Installation Instructions for installation information.

What's New


New in Java EE 6 SDK:

Sun GlassFish Enterprise Server v3

Sun GlassFish Enterprise Server provides a server for the development and deployment of Java EE applications and web technologies. The Java EE 6 SDK bundles include Enterprise Server v3 distributions. Those distributions implement Java EE 6 technologies.

Java EE 6 introduces the concept of profiles. A profile is a collection of Java EE technologies and APIs that address specific developer communities and application types. The following profiles are implemented through the Enterprise Server v3 distributions:

  • Full Platform. This profile is implemented in Sun GlassFish Enterprise Server v3. It is installed as part of the Java EE 6 SDK installation. This profile is designed for developers who need the full set of Java EE APIs for enterprise application development.
  • Web Profile. This profile is implemented in Sun GlassFish Enterprise Server v3 Web Profile. It is installed as part of the Java EE 6 Web Profile SDK installation. This profile contains web technologies that are part of the full platform and is designed for developers who do not need the full set of Java EE APIs.

These distributions are available from the Java EE 6 SDK download page. The download page also provides more information about the contents of each distribution. See the Java EE 6 SDK Installation Instructions for installation information.

The following resources will help you get started with Enterprise Server and make the most of its capabilities.

  • Quick Start Guide. The Quick Start Guide helps you become familiar with Enterprise Server and explains how to perform basic tasks such as starting the server, accessing the Administration Console, and deploying a sample application. The guide pertains to both Enterprise Server v3 and Enterprise Server v3 Web Profile.
  • Release Notes. The Enterprise Server Release Notes provide the latest information about Enterprise Server, including what's new, known issues, and pointers to additional resources.
  • Product Documentation. The online product documentation provides detailed information about Enterprise Server.
  • Update Tool. Update Tool enables you to install and update additional technologies and frameworks. Update Tool is installed with Enterprise Server and is accessed from the Enterprise Server Administration Console or from the command line.

Your First Cup: An Introduction to the Java EE Platform

Your First Cup: An Introduction to the Java EE Platform provides a short tutorial for beginning Java EE programmers that shows how to develop a simple enterprise application from scratch. The sample application consists of four main components: a JAX-RS RESTful web service, an enterprise bean, a Java Persistence API entity, and a web application created with JavaServer Faces Facelets technology.

Java EE 6 Samples

Java EE 6 samples demonstrate Java EE 6 technologies and help you learn more about them. After installation, samples are located in install-dir /glassfish /samples/javaee6. See the index.html file in that location for more information about the samples.

Java EE 6 API Documentation

Java EE 6 API documentation provides API reference documentation for Enterprise Server packages and related APIs. This documentation is generated from the source code by the Javadoc tool and after installation is accessed from install-dir /glassfish /docs /api /index.html.

Java EE 6 Tutorial

Java EE 6 Tutorial, Volume I provides a beginner's guide to developing enterprise applications for Enterprise Server. The tutorial includes working examples and instructions for creating applications with Java EE 6 technologies, including Java Servlets, JavaServer Faces, Facelets, RESTful Web Services, Enterprise JavaBeans, Java Persistence API, Contexts and Dependency Injection for the Java EE platform, and more. The document is also available through Update Tool.

The Java EE 6 Tutorial, Volume II includes everything in The Java EE 6 Tutorial, Volume I and adds advanced topics, additional technologies, and case studies. The document is available to registered users of Enterprise Server and also at https://www.sun.com/offers/details/java_ee6_tutorial.xml.

System Requirements


Java EE 6 SDK distributions require a minimum of 200 Mbytes of free disk space to install, and 100 Mbytes of free memory to run. The following table lists supported operating systems and provides minimum memory, recommended memory, minimum disk space, recommended disk space, and Java virtual machine (JVM) for each.

Java EE 6 SDK distributions require JDK release 6. The minimum (and certified version) of the JDK that is required for Java EE 6 SDK distributions is 1.6.0_15.

Ensure that the required JDK software is installed on your system and that the JAVA_HOME environment variable points to the JDK installation directory, not the Java Runtime Environment (JRE) software.

For Mac OS X systems, the SDK uses the JDK that is part of the Macintosh operating system. If necessary, obtain the required JDK version from the Mac OS X Updates site.

Operating System Minimum Memory Recommended Memory Minimum Disk Space Recommended Disk Space JVM

Solaris Operating System

Solaris 10 (SPARC platform)

1 GB

1 GB

250 MB free

500 MB free

Java SE 6

Solaris 10 (x86 platform)

1 GB

1 GB

250 MB free

500 MB free

Java SE 6

OpenSolaris 2009.06

1 GB

1 GB

250 MB free

500 MB free

Java SE 6

Linux

Red Hat Enterprise Linux 5.0

1 GB

1 GB

250 MB free

500 MB free

Java SE 6

Windows

Windows XP Professional SP2

1 GB

2 GB

250 MB free

500 MB free

Java SE 6

Windows 7 Professional (32- and 64-bit)


1 GB

2 GB

250 MB free

500 MB free

Java SE 6

Windows Vista (Business Edition)

1 GB

2 GB

250 MB free

500 MB

Java SE 6

Windows Server 2008

1 GB

2 GB

250 MB free

500 MB

Java SE 6

Mac OS

Mac OS X 10.5

1 GB

1 GB

250 MB free

500 MB free

Java SE 6



Known Issues and Limitations

The following issues are related to the Java EE 6 SDK distributions. Consult the Sun GlassFish Enterprise Server v3 Release Notes for issues related to the Enterprise Server distributions included in the SDK.

ID Description / Workaround

Installer

6621

Unable to open installation log files by clicking the links on the Summary screen on Linux and Mac OS.

Workaround:
Access the files manually. The names of the installation log and summary files are timestamp -install.log and timestamp -install-summary.html. On Linux and Mac systems these files are generated in the $TMP directory. 

Samples

9969 Run-app-client exception when running hello-webserviceref sample on Mac OS X.

This issue is related to a bug in the Apple JDK and does not prevent the sample from functioning.

The issue pertains to install-dir /samples/javaee6/webservices/hello-webserviceref and is experienced in certain Mac OS X environments, including those with JDK 1.6.0_15 and 1.6.0_17. An exception is seen at bpp-run-app-client when you run the ant run target.
11172
ServletContainerInitializer sample hangs in certain Windows XP environments.

This issue pertains to install-dir /samples/javaee6/web/servlet/servletcontainerinitializer-war and is experienced only on Windows XP systems with MKS tools and JDK 1.6.0_16. The sample hangs when trying to start the domain.

Workaround
Run the sample using the NetBeans IDE, as described in the sample documentation ( install-dir /samples/javaee6/web/servlet/servletcontainerinitializer-war/docs/index.html), or comment out the stop domain and start domain targets in the build.xml file.

Left Curve
Java SDKs and Tools
Right Curve
Left Curve
Java Resources
Right Curve