JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle GlassFish Server 3.1-3.1.1 Release Notes
search filter icon
search icon

Document Information

1.  Oracle GlassFish Server 3.1-3.1.1 Release Notes

Revision History

What's New in the GlassFish Server 3.1.1 Release?

Environment and Component Changes

Embedded GlassFish Server

Expanded Loadbalancer Plug-In Support of Web Servers

New asadmin Subcommands for Secure Admin

Enterprise OSGi Support

Support for JDBC 4.1

What's New in the GlassFish Server 3.1 Release?

GlassFish Server 3.1 Productivity Benefits

Flexible, Extensible, and Customizable

Enhancing Developer Productivity

Production Readiness

GlassFish Server Control

Oracle GlassFish Server and Oracle Fusion Middleware

Key Technology Enhancements

Extending Java EE 6 with Clustering

Load Balancing Support

JMS and Message Queue Broker

DAS Backup and Recovery

Deployment

Security

Logging Service

Hardware and Software Requirements

Supported Platforms, JDK Versions, Browsers, mod_jk, and JDBC Drivers and Databases

System Virtualization Support

Required Disk Space

Required Free Ports

Message Queue Broker Requirements

Important Patch Information

Paths and Environment Settings for the JDK Software

Use the Correct Java Version

Use the JDK Binaries

Set the JAVA_HOME Environment Variable

Set Other Environment Variables As Necessary

Known Issues

Known Issues in GlassFish Server 3.1.1

restart-instance takes a long time on Solaris 11 (sun.security.pkcs11.SunPKCS11) (15537)

Description

Workaround

Accept multiple certs for admin authentication (16437)

Description

Workaround

tcp-no-delay attribute in Http is not working (16902)

Description

Workaround

Invoking GF installer on AIX 6.1 with JDK6 64 bit gives Warning (16667)

Description

Workaround

(JDK) NLS: Crashed when tried to install the bundle in ko locale (16699)

Description

Workaround

PKG_CLIENT_READ_TIMEOUT is too small (16999)

Description

Workaround

Unable to set -server JVM options (16770)

Description

Workaround

cannot remote deploy large wars (15773)

Description

Workaround

AIX. RichAccess stress test. Multiple ArrayIndexOutOfBoundsException and NPE in server.log files (16707)

Description

Workaround

Fail to install the bundle named with -jdk7 when unset JAVA_HOME in solaris 11 Express x86 (16698)

Description

Workaround

Non-persistent timers are incorrectly canceled in a clustered environment (17060)

Description

Workaround

asadmin timeout from HA short execution on AIX (16960)

Description

Workaround

Could not upgrade from ogs-3.1-windows-ml.exe to ogs-3.1.1-b05-windows-ml.exe in Windows 7 x86 (16700)

Description

Workaround

Unable to restart Embedded GlassFish Server instance once a remote EJB is deployed (16916)

Description

Workaround

EJB Timer Service is not loaded correctly after Embedded GlassFish Server restart (16230)

Description

Workaround

list-secure-admin-principals and list-secure-admin-internal-users both incorrectly prompt for a command operand (17005)

Description

Workaround

Switching log levels persistently breaks logging service (17037)

Description

Workaround

Stopping Embedded GlassFish Server leaves several daemon threads running (11088)

Description

Workaround

Administration Guide on Patching in a Closed Network Incorrectly Lists 3.0.1 Patches (13422800)

Description

Workaround

Embedded EJB container returns null reference when META-INF/beans.xml is in the classpath (16285)

Description

Workaround

Known Issues in GlassFish Server 3.1

[OWSM] Interop Metro-WLS:NPE WSSECURTIYTOKEN NULL for WSSE:SECURITYTOKENREFERENCE (Issue 9716247)

Description

Workaround

[JDK_Issue] Performance degradation caused by invoking setSoLinger or setReuseAddress (Issue 7109)

Description

Workaround

[JDK_Issue] IO exception: invalid argument during longevity test (Issue 7529)

Description

Workaround

File permissions on domain /applications directory can cause NullProcessException (Issue 6545)

Description

Workaround

[Open Installer] Option -l to relocate log files ignored on Windows (Issue 10693)

Description

Workaround

Issues occur with ZIP distribution if UAC enabled on Windows Vista (Issue 10755)

Description

Workaround

[Open Installer] Start menus not displayed and then empty on Windows Vista (Issue 5087)

Description

Workaround

Standalone Update Tool fails with segmentation fault on Solaris (Issue 11222)

Description

Workaround

Java EE 6 Managed Bean support not available in app clients launched using Java Web Start (Issue 11257)

Description

Workaround

Warning messages when invoking appclient script on Mac OS X with Apple Java implementation (Issue 8644)

Description

Workaround

Unable to open installation log files using links on the Summary screen on Linux and Mac OS (Issue 6621)

Description

Workaround

updatetool command does not work if you reinstall into the same install directory on Windows (Issue 8233)

Description

Workaround

Problems debugging JPA (Issue 11274)

Description

Workaround

There doesn't appear to be any explanation about the classpath-prefix and classpath-suffix in the GF 3.x documentation (Issue 16082)

Description

Workaround

Windows startup menu shows single entry on multiple installation of Glassfish 3.1 (7002744)

Description

Workaround

Critical JRockit Issues (7020176)

Description

Workaround

New Grizzly integration required for http://java.net/jira/browse/GRIZZLY-970 (15909)

Description

Workaround

ReleaseNotes: document Restart Required issues (Umbrella issue 16040)

Description

Workaround

[UB]org.osgi.framework.BundleException during shutdown after upgrade (15441)

Description

Workaround

Update coordinates failure with enable-security-admin (7017384)

Description

Workaround

Man page for list-supported-cipher-suites (15998)

Description

Workaround

Description of create-jacc-provider references JSR196 but the command has nothing to do with JSR196 and JAAS (15999)

Description

Workaround

lazy-init attribute missing from admin console Edit IIOP Listener page (15975)

Description

Workaround

RMIConnectorStarter constructs invalid URLs with a literal IPv6 address (15937)

Description

Workaround

man-page-review umbrella issue (15929)

Description

Workaround

[UB]Release note security permissions required for CDI applications (15456)

Description

Workaround

build 40 : list-jmsdest for cluster1 not working, it just hangs

Description

Workaround

Create Resource Adapter Config is throwing an exception if JMS is already started (15571)

Description

Workaround

[Release Note]Samples. at ant all output was seen URL for samples that don't have a web client (12264)

Description

Workaround

Domain.xml: setting protocol.http-listener-1.http.max-connections set in 1 or -1 (16025)

Description

Workaround

Intermittent issue : Left tree not refreshed when new elements are added/removed in IE and firefox (15997)

Description

Workaround

[UB][regression] jpaRLCreateEMF failure on sybase (15763)

Description

Workaround

Admin Console: intermittent Blank Screen (15633)

Description

Workaround

Caching JMS session in a session bean causes errors when invoked by a MDB when under load (15558)

Description

Workaround

Domain fails to stop after console loaded (with secure admin enabled) (15482)

Description

Workaround

Modifying keyfile path in a newly created config does not properly list the users (15429)

Description

Workaround

[BigApps] [STRESS] ~17 occurences of "EOFException" warnings coming from JMS (15424)

Description

Workaround

Mysql ping fails when additional properties are not deleted (14547)

Description

Workaround

If TS resource had been changed, tables are not created after server restart (13873)

Description

Workaround

GlassFish/Grizzly not able to accept new request if a remote client hangs (6963818)

Description

Workaround

restore-domain from a config only backup will corrupt the domain directory (7026114)

Description

Workaround

JSF PhaseListener executed for each virtual host (15809)

Description

Workaround

could not find Factory: javax.faces.context.FacesContextFactory (16061)

Description

Workaround

NullPointerException when accessing OSGi web application (15985)

Description

Workaround

GlassFish installer needs to prompt user to set MQ admin password (12305750)

Description

Workaround

Known Issues in GlassFish Server 3.1 Fixed in 3.1.1

Win. Deployment with contextroot: Application [] contains no valid components (13774)

Description

Workaround

[UB]Accessing encoded URLS throws 403: Forbidden (15709)

Description

Workaround

injection points in one bean deployment archive cannot be satisfied by a bean in a separate bean archive, even when they are from libraries in the same module (web archive) (15721)

Description

Workaround

Glassfish Installer does not update MQ config file (imqenv.conf) with values (15724)

Description

Workaround

Remote EJBs fail with ClassCastException in embeddable GlassFish (15775)

Description

Workaround

Column APPLICATIONID is missing from bundled SQL scripts for EJB timer table creation. (15986)

Description

Workaround

create-jvm-options subcommand options incorrectly parsed by asadmin (16037)

Description

Workaround

appclient in cygwin passing extra empty string (16044)

Description

Workaround

3.1 GlassFish installer takes longer to bootstrap Update Center than in 3.0.1 (16067)

Description

Workaround

On Windows the first time pkg.bat or updatetool.bat is run they may echo garbage (16094)

Description

Workaround

Admin GUI hangs on first access after installation on some Solaris Server Hardware. (16153)

Description

Workaround

asupgrade Fails Without Internet Connection (16159)

Description

Workaround

Application info page: status not shown correctly and virtual servers changes not saved (16048)

Description

Workaround

Log Viewer: details garbled after navigating to earlier records, exception in server.log (16029)

Description

Workaround

Cluster -> Resources tab: Should not include resources not included in the web distribution in the table dropdown (15925)

Description

Workaround

Firefox 4.0 does not work for the Admin Console Targeting dialogs (16385)

Description

Workaround

@DSD defined in EJBs bundled in a .war is not available for JPA during prepare() phase (15865)

Description

Workaround

Restrictions and Deprecated Functionality

Node Agent Support

HADB and hadbm Command Support

asadmin Subcommands

Deprecated, Unsupported, and Obsolete Options

Applications That Use Java DB

No Support for Client VM on Windows AMD64

Metro Reliable Messaging in InOrder Delivery Mode

No Support for Kerberos on AIX

Update Center Client Limitations on AIX Platform

Persistence of EJB References in HTTP Sessions Not Supported for Coherence*Web

GlassFish Server Documentation Set

Features Available Only in the Full Platform Profile

Java EE 6 Standards Support

Java EE 6 SDK

How to Report Problems and Provide Feedback

Additional Resources

Third-Party Web Site References

Accessibility Features

What’s New in the GlassFish Server 3.1 Release?

Oracle GlassFish Server 3.1 is the world's first full implementation of the Java Platform, Enterprise Edition (Java EE) 6 specification. GlassFish Server 3.1 delivers a flexible, lightweight and extensible Java EE 6 platform. Completely supported for commercial deployment, GlassFish Server 3.1 delivers a small footprint, fully featured, and production-ready Java EE application server.

The following topics are addressed here:

If you will be using the GlassFish Server 3.1.1 update release, also be sure to see What's New in the GlassFish Server 3.1.1 Release?.

GlassFish Server 3.1 Productivity Benefits

The following sections briefly summarize some of the important new productivity benefits provided by GlassFish Server 3.1.

Flexible, Extensible, and Customizable

GlassFish Server 3.1 offers significant enhancements:

Enhancing Developer Productivity

GlassFish Server 3.1 delivers a new, efficient model for developing and deploying production-level applications. Developers can begin with just the Web Profile and grow to the full Java EE 6 platform when needed. Because GlassFish Server runs on the OSGi runtime, modular features can be added as necessary. It also keeps the footprint as small as possible by loading only modules required to service deployed applications, improving startup time and reducing resource utilization. Smaller downloads, faster startup times, and reduced memory footprints are only some of the capabilities that help developers deliver applications more efficiently. GlassFish Server also provides multiple developer tooling options, including support for Eclipse and NetBeans. GlassFish Server supports developers' favorite tools: GUI and command line interface (CLI), Maven, Ant, RESTful API, and others.

When combined with Eclipse or NetBeans, GlassFish Server can significantly improve iterative development. Instead of six time-consuming steps (edit, save, compile, package, deploy, re-populate session data), the same process is reduced to three steps (edit, save, and refresh browser). Active Redeploy allows session data in HTTP session and stateful EJBs to be retained across application deployments, eliminating the need to repopulate the session data when deploying new code to test. Application-scoped resources enable developers to limit the scope of resources to a deployed application.

The Java EE 6 platform improves developer productivity by supporting the use of annotations in place of XML configuration, simplifying packaging of business components, and enabling the construction of more Plain Old Java Objects (POJOs). The result is getting more done in less time with fewer artifacts to manage over time.

In addition, GlassFish Server includes multi-language support and is available in the following languages: English, French, German, Spanish, Japanese, Simplified Chinese, Traditional Chinese, Korean and Brazilian Portuguese.

Production Readiness

GlassFish Server Control

GlassFish Server Control is a suite of tools that improves manageability of production deployments.

Oracle GlassFish Server and Oracle Fusion Middleware

Oracle GlassFish Server 3.1 is part of the Oracle Fusion Middleware application grid portfolio and is ideally suited for applications requiring lightweight infrastructure with the most upto-date implementation of enterprise Java, Java EE 6, and Java Web Services infrastructure.

Oracle GlassFish Server complements Oracle WebLogic Server, which is designed to run the broader portfolio of Oracle Fusion Middleware and large-scale enterprise applications.

Oracle GlassFish Server 3.1 release improves application portability by offering support for WebLogic web deployment descriptors, and shared runtime components like JPA, JAX-RS, JAXB, JAX-WS. Oracle GlassFish Server 3.1 provides certified interoperability with Oracle Fusion Middleware Products including: Oracle Internet Directory, Oracle Virtual Directory, Oracle Coherence, Oracle Web Services Manager, and Oracle Access Manager.

Key Technology Enhancements

The following sections provide more detail about the key technology enhancements and new features in GlassFish Server 3.1.

The following topics are addressed here:

Extending Java EE 6 with Clustering

GlassFish Server 3.1 is based on the Java EE 6 Reference Implementation and is the first application server to support the full Java EE 6 platform and the new Java EE 6 Web Profile, which is designed specifically for Web applications.

The Java EE 6 platform is backward compatible, so existing Java EE applications will continue to run on the newer platform. Extensive support for clustering across the entire product provides production grade reliability, scalability, fault tolerance and performance for GlassFish Server applications. This support extends from the installer to administration functions, and from native Web server plug-ins to Metro Web Services, JMS and stateful EJBs. These capabilities allow application clusters to be provisioned dynamically and adjusted on the fly, and makes it possible for administrators to redeploy or upgrade applications to meet user demand without service interruption. A single GlassFish Server domain server can manage up to 100 instances, supporting multiple clusters simultaneously.

The enhanced GlassFish Server 3.1 clustering infrastructure includes the following features:

Load Balancing Support

As mentioned in the previous section, Oracle GlassFish Server 3.1 supports clusters and clustered server instances, which provide excellent performance, load balancing failover and recovery, and transaction security.

An important aspect of clustering support in GlassFish Server 3.1 is that clustered configurations can be optimized by means of performance tuning and load balancing tools in a number of command-line subcommands. In addition, the GlassFish Loadbalancer Plug-In makes it easy to configure your Web server to work with Oracle GlassFish Server.

Complete details about configuring load balancing in GlassFish Server 3.1 are provided in the Oracle GlassFish Server 3.1-3.1.1 High Availability Administration Guide.

JMS and Message Queue Broker

GlassFish Server 3.1 includes the following JMS and Message Queue Broker enhancements:

DAS Backup and Recovery

Enhanced domain backup and recovery features in GlassFish Server 3.1 include:

Deployment

A number of deployment enhancements have been introduced in GlassFish Server 3.1:

Security

An entirely new Oracle GlassFish Server 3.1 Security Guide has been written for GlassFish Server 3.1. Some of the important new security features covered in this guide include:

Logging Service

Enhancements to logging features in GlassFish Server 3.1 include: