Java Platform, Enterprise Edition 6 SDK - Release Notes

Java Platform, Enterprise Edition 6 SDK Update 1 - Release Notes

 

These Release Notes provide the latest information about Java Platform, Enterprise Edition 6 SDK Update 1 and Java Platform, Enterprise Edition 6 Web Profile SDK Update 1. 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 Update 1
    • GlassFish Server Open Source Edition 3.0.1
    • Your First Cup: An Introduction to the Java EE Platform
    • Java EE 6 Samples
    • Java EE 6 API Documentation
    • Java EE 6 Tutorial
  • Java Platform, Enterprise Edition 6 (Java EE 6) Web Profile SDK Update 1
    • GlassFish Server Open Source Edition 3.0.1 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

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

What's New

New in Java EE 6 SDK Update 1:

GlassFish Server Open Source Edition 3.0.1

GlassFish Server Open Source Edition provides a server for the development and deployment of Java EE applications and web technologies. The Java EE 6 SDK Update 1 bundles include GlassFish Server Open Source Edition 3.0.1 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 GlassFish Server distributions:

  • Full Platform. This profile is implemented in GlassFish Server Open Source Edition 3.0.1. It is installed as part of the Java EE 6 SDK Update 1 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 GlassFish Server Open Source Edition 3.0.1 Web Profile. It is installed as part of the Java EE 6 Web Profile SDK Update 1 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 Update 1 download page. The download page also provides more information about the contents of each distribution. See the Java EE 6 SDK Update 1 Installation Instructions for installation information.

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

  • Quick Start Guide. The Quick Start Guide helps you become familiar with GlassFish 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 GlassFish Server and GlassFish Server Web Profile.
  • Release Notes. The Oracle GlassFish Server 3.0.1 Release Notes provide the latest information about Oracle GlassFish Server, including what's new, known issues, and pointers to additional resources.
  • Product Documentation. The online product documentation provides detailed information about Oracle GlassFish Server.
  • Update Tool. Update Tool enables you to install and update additional technologies and frameworks. Update Tool is installed with GlassFish Server and is accessed from the GlassFish 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 GlassFish 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.

The Java EE 6 Tutorial

The Java EE 6 Tutorial is a guide to developing enterprise applications for GlassFish 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 tutorial is also available through Update Tool.

System Requirements

Java EE 6 SDK Update 1 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 Update 1 distributions require JDK release 6. The minimum (and certified version) of the JDK that is required for Java EE 6 SDK Update 1 distributions is 1.6.0_20.

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
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 Update 1 distributions. Consult the Oracle GlassFish Server 3.0.1 Release Notes for issues related to the GlassFish Server distributions included in the SDK.

Category/ID Description / Workaround
Installer
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-warand 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.