GlassFish Tools Bundle for Eclipse Release Notes

The GlassFish^TM Tools Bundle for Eclipse Release Notes contain important information on the release, including limitations and known issues.

Check this document prior to installing the software. Revisit this document periodically for up-to-date information.

Revision History
What's New
Platforms
Limitations and Known Issues
Fixed Issues
Documentation
Additional Resources

Revision History

This section provides a record of changes in Release Notes.

Table 1-1 Revision History

Date	Description of Changes
March 2009	Initial release.
May 2009	1.0 release
July 2009	1.1 release
December 2009	1.2 release

What's New

This section provides an overview of the product and what is new in this release.

The GlassFish Tools Bundle for Eclipse is a open source project. It is a co-bundle of Eclipse IDE, GlassFish Server and the plug-in that integrates these products.

The following new features are available in 1.2 release:

The bundled Eclipse IDE has been upgraded from 3.4.2 to 3.5.1.
The bundled GlassFish plug-in for Eclipse has been upgraded from version 1.0.29 to 1.0.50.
Support for Windows 7 Professional platform
Support for GlassFish v3 Server automatic domain configuration
Partial support for Java EE 6:
- Bundled Java EE 6 Wizards
- Java EE 5 and 6 APIs registered for code completion with JavaDoc
Support for Eclipse Profiler on Windows platform
Support for JavaDB configuration, Sun resource wizards

Platforms

This section provides information on product availability on platforms.

The product distributions are available with JDK (version J2SE 6 1.6.0_16) option (Mac OS distribution is not available with JDK option).

If you are selecting an installer without the JDK, make sure you have a recommended, pre-installed Sun JDK in your environment.

The following table lists the product availability on platforms and the recommended JDK version.

Table 1-2 Platforms

Operating System	Recommended JDK
Windows XP Professional SP2 Windows 7 Professional	J2SE 5^TM – 1.5.0_21 or later J2SE 6^TM – 1.6.0_16 or later
Mac OS X 10.6	J2SE 5 – 1.5.0_21 or later J2SE 6 – 1.6.0_16 or later
RedHat Enterprise Linux 5.x	J2SE 5 – 1.5.0_21 or later J2SE 6 – 1.6.0_16 or later
Ubuntu Linux 9.04	J2SE 5 – 1.5.0_21 or later J2SE 6 – 1.6.0_16 or later
Open Solaris 2009.06	J2SE 5^TM – 1.5.0_21 or later J2SE 6 – 1.6.0_16 or later

Limitations and Known Issues

This section lists the limitations of the product and known issues in this release.

Limitations

Support for Java EE 6 functionality requires GlassFish Server version 3. If you use an older (non-bundled) version of the server, some GlassFish Server features will not be available.

Upgrades

An upgrade from an earlier installation is not supported in this release. To install a new version of software, uninstall the earlier installation and reinstall the new version.

Known Issues

This section lists the known issues in the current release.

Issue 288: On Ubuntu platform, icons are not visible on views, and Eclipse update sites cannot be enabled

Description

On Ubuntu 9.10 platform, icons on views are not visible. For example, the Start icon on the Server tab. You also cannot enable Eclipse Update Sites, i.e. the enable/disable button does nothing.

This is a known Ubuntu bug. For details, see http://n2.nabble.com/Ubuntu-9-10-td3941186.html.

For a complete description of the issue, see Issue 288.

Workaround

The workaround for this issue is to export the following environment variable before starting the bundle.

export GDK_NATIVE_WINDOWS=1

Issue 284: On Open Solaris platform, clicking link causes fatal Java error

Description

On Open Solaris platform, after starting the IDE, a welcome screen is displayed. If a user clicks the Overview icon, and then on the overview screen tries to click the GlassFish Web site link, the IDE is terminated.

The user sees the following error message from the terminal window:

ld.so.1: eclipse: fatal: relocation error: file
/usr/jdk/instances/jdk1.6.0/jre/plugin/i386/ns7/libjavaplugin_oji.so: symbol
PR_NewMonitor: referenced symbol not found
Killed

This is a known Open Solaris bug. For details, see http://defect.opensolaris.org/bz/show_bug.cgi?id=8814.

For a complete description of the issue, see Issue 284.

Workaround

None.

Issue: Cannot update GlassFish plug-in for Eclipse using New Server wizard

Description

Updating the plug-in using the New Server wizard results in conflicting dependency errors.

This is a known eclipse bug. For details see, https://bugs.eclipse.org/bugs/show_bug.cgi?id=291822.

Workaround

The workaround for this issue is to use the update site wizard instead of the New Server wizard.

Issue 256: Bundle does not work on Linux 64 bit

Description

The bundle does not work on Linux 64 bit platforms. This is known and the bundle is not supported on Linux 64 bit.

For a complete description of the issue, see Issue 256.

Workaround

None.

Issue 252: Servers view returns error if not in Java EE Perspective

Description

Servers view returns error for label decorator if not in Java EE perspective.

The user may see the following error message when using the bundle:

"if you see java.lang.NoClassDefFoundError: 
Could not initialize class 
org.eclipse.wst.server.ui.internal.provisional.UIDecoratorManager

This is a known Eclipse bug. For details, see https://bugs.eclipse.org/bugs/show_bug.cgi?id=279479.

For a complete description of the issue, see Issue 252.

Workaround

The workaround for this issue is to open the bundle IDE in Java EE Perspective.

Issue 241: On Ubuntu platform, extra icons appear on Applications Menu

Description

After being installed on Ubuntu, an icon representing a shortcut to the bundle appears on the Applications menu. However, instead of just one, extra shortcut icons are created .

This is a known Izpack bug. For details, see http://jira.codehaus.org/browse/IZPACK-439.

For a complete description of the issue, see Issue 241.

Workaround

None.

Issue 240: Default JRE in Mac OS older than Snow Leopard won't work with v3

Description

The bundle supports Mac Snow Leopard platform on which JDK 1.6 is the default JVM. When a user uses a platform older than Snow Leopard or has a default JVM version lower than JDK 1.6, GlassFish v3 server will not start.

For a complete description of the issue, see Issue 240.

Workaround

The workaround is either to set the default JVM on the system to JDK 1.6, or to set the JRE in the bundled GlassFish v3 server's runtime environment to JDK 1.6.

Issue 294: Cannot launch on Mac OS if app included in Security/Firewall app list

Description

Mac OS has a Security->Firewall tab under System Preferences. If your choice is set to "Set access for specific services and applications" and you add the 1.2 version of the bundle to that list, the app will not start (even if you subsequently remove it from that list). You must reinstall once you get to this situation.

For a complete description of the issue, see Issue 294.

Workaround

The workaround is either to skip adding the application to the list or to add use "Show Package Contents" on the top level bundle app to navigate to the "Eclipse.app" inside the bundle and add that to the list.

Fixed Issues

This section lists the fixed issues in the current release.

Over 25 issues were fixed in the plug-in since the last release of the bundle. For a chronological list of bug fixes and improvements to the plug-in, see the plug-in release notes. The following table contains a list of issues fixed outside the plug-in this release.

Table 1-3

Issue	Description
Issue 233	If you are updating the GlassFish plug-in which comes with GlassFish Tools Bundle for Eclipse 1.1 version, and use the New->Server wizard approach to do so, it will result in failure because of a permission problem.

Documentation

The GlassFish Tools Bundle for Eclipse provides a user guide for the product to help you get started. The product documentation is available from GlassFish Tools Bundle for Eclipse User Guide.

Additional Resources

Additional useful information can be found at the following locations: