NetBeans IDE 6.9.1 Release Notes

NetBeans IDE is a modular, standards-based integrated development environment (IDE), written in the Java programming language. The NetBeans project consists of a full-featured open source IDE written in the Java programming language and a rich client application platform, which can be used as a generic framework to build any kind of application. For information about how to install the software on your system, please see the NetBeans IDE 6.9.1 Installation Instructions. To learn about the new features included in this release of the IDE see the NetBeans IDE 6.9.1 Release Information page.


What's New in 6.9.1

NetBeans IDE 6.9.1 is a minor update to NetBeans IDE 6.9 and includes the following changes:

  • Availability of the latest IDE bundled with JavaFX SDK 1.3.1
  • Improvements to the JavaFX debugger
  • Important usability issues fixed in the JavaFX Composer and Editor
  • Critical bug fixes made to other modules since the 6.9 final release

The following updates to the 6.8 release included in version 6.9 also apply to 6.9.1:

  • JavaFX Composer to simplify and visualize JavaFX development
  • Support for Equinox and Felix OSGi frameworks in NetBeans Platform
  • Spring Framework 3.0 library support
  • Java CardTM 3 Connected
  • Rails 3.0 Beta support
  • PHP Zend Framework support
  • Support for JSR-299, Contexts and Dependency Injection (CDI)
  • Additional Enhancements are listed on the NetBeans IDE 6.9 New and Noteworthy page.

Note: The Java TM SE Development Kit (JDK) 5.0 is not supported on any platform for this release. You must have JDK 6.0 on your system to install and run NetBeans IDE 6.9.1.

For more about this release, see the NetBeans IDE 6.9.1 Release Information page.

Supported Technologies

NetBeans IDE 6.9.1 supports the following technologies and has been tested with the following application servers. If you plan to use versions other than those explicitly listed, please note that you may encounter unpredictable IDE behavior. See the NetBeans IDE 6.9.1 Supported Platforms page for more details on the tested platforms and runtimes for this release.

Supported technologies:
  • Java EE 5, Java EE 6 and J2EE 1.4
  • JavaFX SDK 1.3.1
  • Java ME SDK 3.0
  • Java Card 3.0.2
  • Struts 1.3.8
  • Spring 3.0, 2.5
  • Hibernate 3.2.5
  • Java API for RESTful Web Services (JAX-RS) 1.1
  • Issue Tracking
    • Bugzilla 3.4 and earlier
    • Jira 3.4 and earlier
  • PHP 5.3, 5.2, 5.1
  • Ruby 1.9, 1.8
  • JRuby 1.5.0
  • Rails 2.3.4, 3.0 Beta
  • Groovy 1.6.4
  • Grails 1.1
  • VCS
    • CVS: 1.11.x, 1.12.x
    • Subversion: 1.5.x, 1.6.x
    • Mercurial: 1.0.x or later
    • ClearCase V7.0

Tested application servers:
  • GlassFish Server Open Source Edition 3.0.1
  • GlassFish Enterprise Server v2.1.1
  • Sun Java System Application Server PE 8.2
  • WebLogic 11g (
  • Tomcat 6.0.26
  • Tomcat 5.5
  • JBoss 5.0
  • JBoss 4.2.3 (J2EE 1.4)

System Requirements

NetBeans IDE runs on operating systems that support the Java VM (Virtual Machine) and has been tested on the platforms listed below.

Note: The IDE's minimum screen resolution is 1024x768 pixels.

Supported Operating Systems

Minimum Hardware Configurations

  • Microsoft Windows XP Professional SP3/Vista SP1/Windows 7 Professional:
    • Processor: 800MHz Intel Pentium III or equivalent
    • Memory: 512 MB
    • Disk space: 750 MB of free disk space
  • Ubuntu 9.10:
    • Processor: 800MHz Intel Pentium III or equivalent
    • Memory: 512 MB
    • Disk space: 650 MB of free disk space
  • Solaris OS version 10 (SPARC):
    • Processor: UltraSPARC II 450 MHz
    • Memory: 512 MB
    • Disk space: 650 MB of free disk space
  • Solaris OS version 10 (x86/x64 Platform Edition):
    • Processor: AMD Opteron 1200 Series 1.8 GHz
    • Memory: 512 MB
    • Disk space: 650 MB of free disk space
  • Macintosh OS X 10.5 Intel:
    • Processor: Dual-Core Intel (32 or 64-bit)
    • Memory: 512 MB
    • Disk space: 650 MB of free disk space

Recommended Hardware Configurations

  • Microsoft Windows XP Professional SP3/Vista SP1/Windows 7 Professional:
    • Processor: 2.6 GHz Intel Pentium IV or equivalent
    • Memory: 2 GB
    • Disk space: 1 GB of free disk space
  • Ubuntu 9.10:
    • Processor: 2.6 GHz Intel Pentium IV or equivalent
    • Memory: 2 GB
    • Disk space: 850 MB of free disk space
  • Solaris OS version 10 (SPARC):
    • Processor: UltraSPARC IIIi 1 GHz
    • Memory: 2 GB
    • Disk space: 850 MB of free disk space
  • Solaris OS version 10 (x86/x64 platform edition):
    • Processor: AMD Opteron 1200 Series 2.8 GHz
    • Memory: 2 GB
    • Disk space: 850 MB of free disk space
  • OpenSolaris 2010.03 (x86/x64 platform edition):
    • Processor: AMD Opteron 1200 Series 2.8 GHz
    • Memory: 2 GB
    • Disk space: 650 MB of free disk space
  • Macintosh OS X 10.6 Intel:
    • Processor: Dual-Core Intel (32 or 64-bit)
    • Memory: 2 GB
    • Disk space: 850 MB of free disk space

NetBeans IDE is also known to run on the various other Linux distributions such as Oracle Enterprise Linux 5, Ubuntu 8.x and 10.04, Red Hat Enterprise Linux and many others.

Note: NetBeans Web and Java EE support are particularly demanding on system resources - especially when used in combination with application servers. While the above system requirements apply to most configurations of the IDE, for the best results make sure that your system meets at least the recommended system requirements when developing Web and Java EE applications.

Required Software

NetBeans IDE runs on the Java SE Development Kit (JDK) which consists of the Java Runtime Environment plus developer tools for compiling, debugging, and running applications written in the Java language.

The tested JDK for this release are:

  • JDK 6 Update 13 or later is required. The 6.9.1 version of the IDE cannot be installed or run using JDK 5.0.

Note: The PHP, Ruby and C/C++ NetBeans bundles only require the Java Runtime Environment (JRE) 6 to be installed and run.

You can download the JDK for your platform from one of the sites listed below:


JavaFX Support

The JavaFX 1.3.1 SDK is bundled with the NetBeans IDE 6.9.1 release. Please note the following:

  • The minimum supported JDK version for JavaFX 1.3.1 is JDK 6 Update 20 for Windows and JDK 5 Update 16 for Mac OS.
  • Note that JDK 6.0 is required to install and run NetBeans IDE 6.9.1 on Mac OS, however JDK 5.0 can be used for development using the JavaFX 1.3.1 SDK.
  • Please see the JavaFX Release Documentation page for more information about system requirements and supported features in the JavaFX SDK.


SQL Editor and Databases

The following changes have been made to the database functionality in NetBeans IDE 6.9.1:

  • Upgraded Drivers. The MySQL drivers included in NetBeans IDE have been updated to version is 5.1.6.
  • Tested Drivers

    NetBeans IDE 6.9.1 has been tested with the following databases and drivers.

    Example URL
    JavaDB Derby jdbc:derby://localhost:1527/sample (Network)
    Oracle Oracle Database 11g ( ) jdbc:oracle:thin:@//localhost:1521:ora9i
    PostgreSQL 8.x jdbc:postgresql://
    MySQL MySQL Connector/J 5.1.6 jdbc:mysql://localhost:3306/sample
  • Other Drivers

    The following drivers and databases have not been formally tested, but should work based on experience.

    Example URL
    Microsoft Microsoft SQL Server 2005 JDBC Driver 1.2.2828.100 jdbc:sqlserver://localhost:1433;databaseName=travel;selectMethod=cursor
    IBM Redistributable DB2 JDBC Type 4 driver v8 fixpack 13 jdbc:db2://localhost:50002/sample
    jTDS jTDS 1.2.1 jdbc:jtds:sqlserver://
    DataDirect DataDirect Connect for JDBC - 3.6 DataDirect Connect for JDBC - 3.6.07 jdbc:datadirect:oracle://localhost;SID=ora9i jdbc:datadirect:sqlserver://localhost:1433;DatabaseName=travel;SelectMethod=cursor jdbc:datadirect:db2://localhost:50002;databaseName=sample
    Pointbase 5.2 ECF build 294




  • For Database troubleshooting information please refer to the NetBeans Database Connectivity User FAQ.


Multilingual Support Information

NetBeans IDE is translated into the following languages: Brazilian Portuguese (BR), Japanese (JP) and Simplified Chinese(ZH).

Community translations of the IDE are also available in several additional languages and can be downloaded from the Community Contributed section of the IDE Language drop-down menu.


Compatibility with Earlier Releases

When the IDE is run for the first time after installation you have the option to import some of the settings used in a previous installation. The IDE opens using the default settings if you choose not to import the settings from the existing installation. Note the IDE only recognizes previous installations when the user directory resides in the default location. It does not recognize installations that use the --userdir switch to specify a user directory. If you would like to import settings from a location that the installer does not recognize do the following:

  1. Start the IDE go to Tools > Options in the main menu.
  2. Click the Import button at the bottom of the Options dialog.
  3. In the Select Options to Import dialog, click the Browse button and navigate to the user directory that contains the settings you want to import. For more about the location of the NetBeans IDE userdir, see the FAQ What is a userdir and where can I find it?

Note: If you edit the Project Properties in NetBeans IDE 6.9.1 for a project that was created in NetBeans IDE 4.1 or earlier, the project will no longer work in the earlier NetBeans IDE versions.


Archived Modules and Features

The SOA, UML and Visual Web modules as well as support for jMaki, JAX-RPC and adding JavaScript Libraries are no longer included in the IDE installer. For further details about removed features and the available alternatives please see the NetBeans IDE Archived Feature page.


Known Issues: Installer

The unresolved installer issues for this release are as follows:

  • Issue #93568: On Solaris and Linux, installation hangs when the network connection is lost.

    Description: On Solaris and Linux platforms, if the network connection is lost, installation hangs when the installer is searching for a compatible JDK in network directories.

    Workaround: Restore the network connection and proceed with the installation.

  • Issue #117172: A blank window when running the installer on Ubuntu.

    Description: The installer appears as the blank/gray dialog when running on Ubuntu with Beryl/Compiz/Compiz Fusion installed.

    Workaround: Execute the export AWT_TOOLKIT=MToolkit command before running the installer.

  • Issue #123300. On Fedora Core 8 the installer stops displaying the interface and returns to the console.

    Description: On Fedora Core 8, displaying the installation interface stops and the system returns to the console.

    Workaround: See

  • The NetBeans IDE 6.9.1 installation wizard does not start properly (hangs). After the user stops the installation process manually, and the installer reports that another installer instance is running.

    Description: On Windows, when Java6 is used by default and large zip files are stored on the desktop, the installation wizard does not start properly (hangs). After the user stops the installation process manually, and the installer reports that another installer instance is running.

    Workaround: Before the installation, remove all big zip files from the desktop

  • Issue #177872: On Mac OS X, GlassFish 3.01 add-on and update tools may not work properly

    Description: On Mac OS X, the pkg-based add-on and update tools do not work properly under non-root accounts if GlassFish v3.01 was installed under root.

    Workaround: Use the chown -R command to change ownership of the GlassFish installation and set it to the non-root user who needs it. For example: sudo chown -R <newuser>:admin /Applications/NetBeans/glassfish-3.0.1, where newuser is the non-root user. After this command is used, the user can directly execute the bin/updatetool and bin/pkg tools.

  • For additional Installer troubleshooting information, please refer to the NetBeans Installation User FAQ.


Known Issues: Core IDE

The unresolved issues for this release are as follows:

  • Difficulties starting the IDE (Solaris x86 and Dual-Core Opteron).

    Description: On certain Solaris x86 and Dual Core Opteron configurations, you may encounter problems starting the IDE due to a JDK bug with loading GTK look&feel libraries.

    Workaround: If you encounter this behavior, specify the following command line option: -laf javax.swing.plaf.metal.MetalLookAndFeel

  • Characters do not display properly in some Asian locales.

    Description: When running the IDE with some Asian locales on Ubuntu and some other Linux distributions, the IDE's screen text may become unreadable. On certain Linux distributions multi-byte characters may display as a rectangle due to JDK font setting issues.

    Workaround: Please see the FAQ for help with resolving this issue:

  • Issue #64840: Network communication broken on Linux with IPv6 enabled.

    Description: Network communication broken on Linux with IPv6 enabled, preventing the IDE from connecting to bundled servers, Auto Update, etc.

    Workaround: If this happens, run the IDE using the' switch. Alternatively, disable IPv6 (in /etc/modules.conf or /etc/modprobe.conf).

    For more information see: Issue #5087907.

  • Issue #167401: IDE randomly freezes on MacOS X systems using JDK 1.6.0 update 13

    Description: IDE may randomly freeze when browsing through the main menu bar due to Apple JDK bug #6993269.

    Workaround: Either switch to a different JDK version or modify the default start up options of the netbeans.conf file to -J-Dapple.laf.useScreenMenuBar=false.

  • Issue #110074: Editor periodically freezes on Solaris.

    Description: When running the IDE on Solaris with JDK 6, 6u1 or 6u2, threads may become blocked for a long time and cause the editor to be unresponsive.

    Workaround: Upgrade your JDK 6 installation to Update 3 or newer.

  • Issue #88776: Profiled application can crash when profiling using dynamic attach mode.

    Description:When running on JDK 1.6, profiling an application with dynamic attach mode can lead to the profiled application crashing.

    Workaround: Start the application you want to profile with the -Xshare:off switch.

    Also see: Issue #113847.

  • Issue #119617: Cursor lost in editor and cannot type using keyboard

    Description: It can sometimes occur that after using a hint in the editor window that the insertion point in the editor disappears and you cannot type using the keyboard. This has mostly been reported on Mac OS X 10.4, but there have been some reports on some versions of Ubuntu.

    Workaround: Use the mouse to open and then close a dialog window (for example, a properties dialog). This returns the focus to the editor and the insertion point and keyboard will work as normal.

  • Issue #130357: I18N - Mac OS won't generate javadoc if the project name or path has multibyte characters

    Description: The javadoc task is written in MacRoman, the default Mac OS encoding, when creating the temporary parameter file. This may be due to the BSD and Mach parts (system & kernel calls) accepting parameters in UTF-8, but the Mac OS and HFS only accepting MacRoman.

    Workaround: Avoid using multibyte characters in the name of the project or the path to the project.

  • Issue #152916: Difficulties starting IDE on 64-bit Mac OS X 10.5.5 using JDK 1.6_07

    Description: On certain 64-bit Mac OS X 10.5.5 configurations with JDK 1.6_07 set as the system's default Java platform, you may encounter problems starting the IDE from the Finder and from the command line.

    Workaround: Upgrade to a more recent release of JDK 6.0.

  • Issue #158421: Difficulties using the IDE with G1 Garbage Collector

    Description: If you are using G1 Garbage Collector (in JDK 6 Update 14 or newer and in JDK 7), you may encounter exceptions thrown while using the IDE.

    Workaround: Do not use G1 Garbage Collector (remove -XX:+UnlockExperimentalVMOptions -XX:+UseG1GC from netbeans.conf or the command line).

  • For additional Core IDE troubleshooting information, please refer to the NetBeans User FAQ.


Known Issues: Web and Java EE

The unresolved Web and Java EE issues for this release are as follows:

  • Issue #183614: Step Into does not work properly with EJB.

    Description: When debugging a servlet, Step Into an EJB call stops at unrelated code.

    Workaround: Set a breakpoint in the EJB implementation code and use Step Over.

  • Issue #178108: Metamodel classes for managed JPA entities are not generated automatically

    Description: Metamodel classes for the corresponding managed entities are not generated. Constructing typesafe queries that use the Criteria API and metamodel class does not work.

    Workaround: Please see the description of issue #178108 for workaround options.

  • For additional Web and Java EE troubleshooting information, please refer to the NetBeans User FAQ.


Known Issues: Java ME

NetBeans enables you to develop Java ME based applications for MIDP, CLDC and CDC devices.

The unresolved Java ME issues for this release are as follows:

  • Linux Solaris and other operating systems are not supported by the Java ME SDK 3.0.

    Description: NetBeans 6.9.1 Mobility and the Java ME SDK 3.0 bundled with this release only support the Windows and Macintosh operating systems.

    Workaround: The Linux installer come bundled with the Sun Java Wireless Toolkit 2.5.2.

  • The Java ME module does not run if a directory name, path to the installation directory, or user directory contain non-ASCII characters.

    Description: The Java ME SDK 3.0 does not support non-ASCII characters in project paths.

    Workaround: Make sure that your user directory does not contain non-ASCII characters. If it does, change the IDE's default user directory.

  • Issue #139031: Emulator does not start in Windows if the Java binary is not in the environment path.

    Description: The Java ME SDK and other emulators do not launch in Windows if Java.exe is not in the path.

    Workaround: Install the JDK using the default settings or, if performing a custom install, be sure to select the public JRE for installation. If the JDK is already installed you can add the Java.exe file to your system's path settings.

  • For additional Java ME troubleshooting information, please refer to the NetBeans Java ME/Mobility Connectivity User FAQ.


Known Issues: C/C++

NetBeans C/C++ support C and C++ applications on Microsoft Windows, Macintosh OS X, Linux, and the SolarisTM Operating System. C/C++ developers can bring existing applications into the NetBeans project system, or develop new applications and libraries. NetBeans C/C++ support covers the end-to-end development cycle: projects and templates, an advanced language-aware editor, makefile-based builds, and debugging.

For information on installing and configuring the compilers and tools for NetBeans C/C++ support, see Installing and Configuring C/C++ Support.

The unresolved C/C++ issues for this release are as follows:

  • Issue # 148204: On Windows platforms, user input does not work in Output window when debugging

    Description: On Windows platforms, when you are debugging an application and the console type for the project is set to Output Window, you cannot type input in the Output window. This issue does not affect development using a remote host.

    Workaround: Set the console type to External Terminal by right-clicking the project node in the Projects window, selecting the Run node in the Project Properties dialog box, selecting External Terminal from the Console Type drop-down list, and clicking OK.

  • Issue #121775: The latest Xcode is required for debugging on Tiger (Mac OS X 10.4)

    Description: When debugging on Mac OS Tiger (Mac OS X 10.4), the code generated by the default versions of the gcc and g++ compiler have incorrect line information and breakpoints may be ignored.

    Workaround: Apple has released an updated Xcode package (version 2.5) that fixes this problem. The correct versions of gcc, g++, and gdb are:

    • gcc: 4.0.1 - Apple build 5367
    • g++: 4.0.1 - Apple build 5367
    • gdb: 6.3.50 - Apple build 573 (10/20/2006)

    The updated version of Xcode is available here:

  • For additional C/C++ troubleshooting and support information, please refer to the NetBeans C/C++ FAQ.


More Information

You can find news, articles, additional modules, and other useful information on the NetBeans project web site. Since NetBeans is an open-source project, the web site also provides access to source code, a bug database, information on creating your own NetBeans modules, and much more. For more information, visit


To get the most out of the features in NetBeans IDE 6.9.1, check out our web-based tutorials and screencasts. Check these pages frequently because we add new content all the time.

Additional reference documentation resources include:

  • The NetBeans User FAQ has many workarounds and troubleshooting tips not included in the Release Notes.
  • The IDE's built-in help system has detailed support information for features included in all of the NetBeans IDE modules.
  • See Using NetBeans IDE on the Mac OS X for information about keyboard equivalents, tips, tricks, and other Mac-specific topics.


Keep up to date on the the latest developments and interact with the NetBeans community by signing up for NetBeans project mailing lists at

You can post questions at The forums are synchronized with the most widely used NetBeans mailing lists. Note that a separate sign up for the forums is required.

Please visit the community translation information page at to learn how to contribute to additional language localizations of the NetBeans UI, help and user documentation.


Not logged in. Log in, Register