NetBeansTM IDE 5.0 Release Notes
Last Updated: 8 April 2006
Contents
Introduction
Welcome to NetBeansTM IDE 5.0. NetBeans
IDE is a modular, standards-based integrated development environment (IDE),
written in the JavaTM programming language.
The NetBeans project consists of:
For information about new development features
in NetBeans IDE, see
What's New in NetBeans IDE 5.0.
If you are looking for information about installing the IDE, see the NetBeans
Installation Instructions.
top
Supported Technologies
NetBeans IDE 5.0 supports the following technologies:
- Enterprise JavaBeans (EJB) 2.1
- Java Servlet 2.4
- JavaServer Pages (JSP) 2.0
- JavaServer Faces 1.1 (JSR-127)
- Struts 1.2.7
- Java API for XML-based Remote Procedure Calls (JAX-RPC) 1.6
- Java APIs for XML Registries (JAXR) 1.0
- Java API for XML Processing (JAXP) 1.2
- JavaServer Pages Standard Tag Library 1.1 Support
NetBeans IDE 5.0 has been tested with the following application servers:
- Sun Java System Application Server PE 8.1 update 2
- Sun Java System Application Server PE 8.2
- Tomcat 5.5.9
- JBoss 4.0.3
- WebLogic 9.0
Note: While the NetBeans IDE may work with different versions
of supported technologies or additional technologies not explicitly listed,
only those that are officially supported appear above.
top
System Requirements
Supported Operating Systems
NetBeans IDE runs on operating systems that support the JavaTM
VM. Below is a list of platforms that NetBeans IDE has been tested on.
- Microsoft Windows XP Professional SP2
- Solaris operating system (SPARC® and x86 Platform Editions)
versions 8, 9, and 10
- Red Hat Fedora Core 3
- Mac OS X 10.4
NetBeans IDE is also known to run on the following platforms:
Minimum Hardware Configuration
Note: The NetBeans IDE's minimum screen resolution is 1024x768 pixels.
- Microsoft Windows operating systems:
- Processor: 500 MHz Intel Pentium III workstation or equivalent
- Memory: 384 megabytes
- Disk space: 125 megabytes of free disk space
- SolarisTM operating system (SPARC version):
- Processor: 500 MHz Ultra 60,
SunBlade 150, or equivalent workstation
- Memory: 512 megabytes
- Disk space: 150 megabytes of free disk space
- SolarisTM operating system (x86 version):
- Processor: AMD Opteron 100 series Sun Ultra 20
workstation or equivalent
- Memory: 512 megabytes
- Disk space: 150 megabytes of free disk space
- Linux operating system:
- Processor: 500 MHz Intel Pentium III workstation or equivalent
- Memory: 384 megabytes
- Disk space: 125 megabytes of free disk space
- Macintosh OS X operating system:
- Processor: PowerPC G4
- Memory: 512 megabytes
- Disk space: 125 megabytes of free disk space
Recommended Hardware Configuration
- Microsoft Windows operating systems:
- Processor: 780 MHz Intel Pentium III workstation or equivalent
- Memory: 512 megabytes
- Disk space: 125 megabytes of free disk space
- SolarisTM operating system (SPARC version):
- Processor: UltraSPARC IIIi
1.5 GHz SunBlade 1500 workstation or equivalent
- Memory: 1 gigabyte
- Disk space: 150 megabytes of free disk space
- SolarisTM operating system (x86 version):
- Processor: AMD Opteron 100 series Sun Ultra 20
workstation or equivalent
- Memory: 1 gigabyte
- Disk space: 150 megabytes of free disk space
- Linux operating system:
- Processor: 800 MHz Intel Pentium III workstation or equivalent
- Memory: 512 megabytes
- Disk space: 125 megabytes of free disk space
- Macintosh OS X operating system:
- Processor: PowerPC G5
- Memory: 1 gigabyte
- Disk space: 125 megabytes of free disk space
Required Software
NetBeans IDE runs on the J2SE JDK 5.0 (JavaTM 2
JDK, Standard Edition), which consists of the Java Runtime Environment plus
developer tools for compiling, debugging, and running applications written
in the JavaTM language. NetBeans IDE 5.0 also runs
on J2SE SDK version 1.4.2, but it has only been tested on JDK 5.0.
Note: If you wish to run the IDE on earlier versions of the SDK or
if you prefer to install the IDE manually, you can download archived versions
of the IDE at http://java.sun.com/products/archive/index.html.
You can download the JDK for your platform from one of the sites listed
below:
Sun Java System Application Server Requirements
In order to use the J2EE development features of NetBeans IDE 5.0, you must
have the Sun Java System Application Server Platform Edition 8 installed
on your computer. You can download it here.
Note: Because you also need the Sun Java System Application Server
PE 8 to work with the J2EE features of NetBeans IDE 5.0, your computer
must also meet the application
server's minimum requirements.
Other Application Server Requirements
If you are working with other servers, confirm that your system
meets their minimum requirements as listed below:
top
Compatibility
When you first run the IDE, you can import a subset of the settings
you used in NetBeans IDE 4.1. If you choose not to import settings from a previous
release, the IDE opens using the default settings. Project-specific settings
are not importable from version 3.6.
Note: The IDE only recognizes previous installations where
the user directory resides in the default location. It does not recognize
installations where you have specified a user directory using the --userdir
switch. If you would like to import settings from an IDE that the installer
does not recognize, download an archive version of the IDE instead of the
installer.
Though it is possible to import settings from a previous IDE installation
into NetBeans IDE 5.0, it is not possible to import settings
from NetBeans IDE 5.0 into an earlier IDE release.
Note:If you edit the Project Properties for a project that was created
in NetBeans IDE 4.1 or earlier in NetBeans IDE 5.0, the project will no longer
work in the earlier NetBeans IDE versions.
top
Known Issues
Note: The NetBeans IDE and Sun Java System Application Server bundle
creates the admin user with password adminadmin by default.
Users should use these settings to log in via the web console.
The unresolved issues for this release are as follows:
- Issue
#26965
Description:
If you have an incompatible version of sax.jar in your JDK
installation, the IDE installer crashes with the following message:
"The wizard cannot continue because of the following error: could
not load wizard specified in /wizard.inf (104)"
Workaround:
Temporarily remove jre/lib/endorsed/sax.jar from the JDK
directory during IDE installation.
- Issue #32463
(Macintosh OS X only)
Description:
Right-click mouse behavior not emulated on multiple files.
Workaround:
Press and hold Control while selecting multiple files one at a
time. Note that the contextual menu will appear after each mouse click
and may obstruct subsequent selections.
- Issue #47645
Description:
Cannot run a target with a task that has failonerror=true from
within the IDE even though the same script runs outside of the IDE without
problems.
Workaround:
If this occurs, it is recommended that you run the script from the
command line. Alternately, you may rewrite the script.
- Issue #48288
Description:
Fields automatically generated by the GUI Builder that exist
within Guarded Blocks (stored in .form files) not modified when
refactoring.
Workaround:
If this happens, first rename the GUI fields by right-clicking
the corresponding node in the Inspector and choosing Rename. Next, rename
the occurences outside the Guarded Blocks by right-clicking the
node that represents the field and choosing Refactoring > Rename.
- Issue #51880
(Windows XP)
Description:
JSPs in free-form projects unable to be debugged when attaching the
debugger to a process.
Workaround:
Use an ant debug target as described in Writing
A Debug Target for a Free-Form Web Project instead.
- Issue #52856
(Windows XP only)
Description:
Sun Java System Application Server installation fails. Note that
this problem has been known to occur both when using the NetBeans IDE 5.0
IDE and Sun Java System Application Server Platform Edition 8.2 Bundle
installer as well as the stand-alone Application Server installer.
This happens when a previous installation of the Application Server has failed and
subsequent attempts at uninstallation were also unsuccessful (i.e. some
registry entries or configuration files weren't deleted).
Workaround:
If this happens, remove all previous installations of the Sun Java
System Application Server. Then delete the installer's <USERHOME>\Local
Settings\temp\ directory and
the Application Server's \Application
Data\Sun\tmp\ directory (note that files may also be located in <WINDIR>\Sun\).
If a previous uninstallation attempt of the Application Server was
unsuccessful, also delete the <SYSTEMDIR>/productregistry file.
Next, create a new directory within which to install the software
and ensure that the directory is empty and writable. Finally, reinstall
the Application Server in the new location on your system.
- Issue #54965
(Windows XP only)
Description:
When the WSDL operation qualifies for wrapper style and the output
part's element has more than one sub element, the output element does
not unwrap. This causes a conflict with JSR-109.
Workaround:
If this occurs, right-click the project node and choose Properties.
On the Web Service Clients panel of the Project Properties dialog,
select "donotunwrap" and deselect "strict".
- Issue #56885
Description:
Debugger does not stop at the beginning of websvc after pressing F7
Workaround:
There is currently no known workaround for this issue.
- Issue #56910
Description:
Sun Java System Application Server is restarted in some cases after
deployment. This occurs when a module that is deployed to the application
server has errors in its sources, such as when a remote method
does not throw a RemoteException.
Workaround:
If this occurs, run the integrated J2EE verifier to obtain
information about why the archive can not be loaded and then
edit the source file to correct any errors.
- Issue #57282
(Linux only)
Description:
Sun Java System Application Server is not installed on 64bit JDK on
Linux/AMD64. The
Application Server installer but does
not run on 64bit JDK and therefore the Application Server
cannot be installed using a 64bit JDK. This does not mean, however,
that the Application Server itself will not RUN on 64bit JDK.
Workaround:
If this occurs, run the Application Server bundle installer on a 32bit
JDK. After installation you should be able to run both the IDE and
Application Server on a 64bit JDK.
- Issue #57697 (Windows XP only)
Description:
Sun Java System Application Server installation
fails because the bundle installer cannot find the JDK.
Workaround:
If this happens, start the console application (cmd.exe), navigate
to the directory where the installer is located, and type the installer
name plus the -is:javahome <JAVA HOME DIR> switch.
Create a new directory within which to install the software and
ensure that the directory is empty and writable. If necessary, you
can also use the -is:log <log file> parameter
to generate an installer log.
Notes:
- If a previous uninstallation attempt of the Application Server was not successful,
delete the
<SYSTEMDIR>/productregistry file.
- If
one of the values specified in the silent installer statefile
is invalid (i.e. it has a null value, zero length value, or its
port is in use), add the appropriate values to the
statefile.
- See Issue
#52856 above for additional information.
- Issue #60235 (Mac OSX only)
Description:
Editor focus occasionally lost when switching tabs in Mac OSX.
Workaround:
If this happens, open any other window using the Window menu.
If this does not remedy the problem, restart the IDE.
- Issue #63084 (Linux only)
Description:
NetBeans freezes while debugging an application on the Weblogic9
server started with the Bea JDK (JRockKit).
Workaround:
If you experience this behavior, start Weblogic with the Sun JDK that
is bundled with WebLogic. To do this, set the system property JAVA_VENDOR
to value Sun. Note that the performance of the
server will also benefit from this adjustment.
- Issue #64771 (Linux only)
Description:
When starting NetBeans with the SELinux (Security-enhanced) Linux
option enabled, startup fails.
Workaround:
If this happens, disable SELinux temporarily by typing
#setenforce 0 from the command line. Note that this
requires root priviledges. Then add selinux=0 to
your kernel command line to disable SELinux at boot up.
- Issue #64840 (Linux only)
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
-J-Djava.net.preferIPv4Stack=true' switch.
Alternatively, disable IPv6 (in /etc/modules.conf
or /etc/modprobe.conf).
For more information see:
Issue #5087907.
- Issue #66860
Description:
Web Services node is disabled when running the IDE on JDK 1.4. This occurs
because Web services rely on the JAX-RPC 1.6 XML library. When running the IDE
on JDK 1.4, the necessary classes are not available to the IDE by default.
Note that in JDK 1.5 and higher, the library's classes are part of the JDK.
Workaround:
To enable web services when running on JDK 1.4.2_xx, use the Update Center to
add the JAX-RPC 1.6 XML library to the IDE.
- Issue #70779
Description:
Web samples available for English encoding character set only.
Workaround:
If this happens, set the encoding character set for the file
to UTF-8 by adding the following line:
<%@page pageEncoding="UTF-8"%>
- Issue #72102
Description:
Update Center doesn't work after uninstall of Mobility Pack.
Workaround:
After uninstalling NetBeans Mobility Pack, remove the Java ME Platform SDK Catalog from the list
of AutoUpdate Types. To do this, choose Tools > Options and switch to Advanced Options. Next, navigate
to IDE Configuration > System > AutoUpdate Types. Then right-click the Java ME Platform SDK Catalog node
and choose Delete from the pop-up menu. Restart NetBeans IDE.
top
Documentation
The built-in help system for NetBeans IDE 5.0 has not been completely updated
to cover the J2EE development features. For information about the J2EE development
features, see the following documents:
NetBeans IDE 5.0 Quick Start Guides:
NetBeans IDE 5.0 Import Guides:
Complete list of NetBeans IDE 5.0 Documentation:
Note: If you are running the NetBeans IDE on Mac OS X, see Using
NetBeans on Mac OS X for more information about keyboard equivalents,
tips and tricks, and other Mac-specific topics.
top
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 http://www.netbeans.org/.
You can keep up to date on NetBeans IDE and interact with the NetBeans community
by signing up for NetBeans project mailing lists at http://www.netbeans.org/community/lists/.
top
