The Java Platform, Enterprise Edition 5 (Java EE 5) Tools Bundle includes NetBeans IDE 5.5, NetBeans Enterprise Pack 5.5, and Java Platform, Enterprise Edition 5 SDK Update 1 or Update 2 (Java EE 5 SDK Update 1 or Update 2). The NetBeans Enterprise Pack 5.5 includes XML schema tools modules, BPEL modules, Secure Web Services modules, Project Open ESB Starter Kit, Sun Java System Access Manager 7.1, and Sun Java System Policy Agent 2.2 for Sun Java System Application Server 9.0 Update 1/ Web Services.
These release notes apply to the Java EE 5 Tools Bundle.
Note: The UML functionality is no longer available in the final (FCS) release of the NetBeans Enterprise Pack 5.5 download. Instead, the UML functionality is offered separately on the Auto Update Center.
Note: If you are looking for information about installing the software included in Java EE 5 Tools Bundle, see the Java EE 5 Tools Bundle Installation Instructions.
Supported Operating Systems
The NetBeans IDE 5.5 runs on operating systems that support the Java VM. Below is a list of platforms that the Java EE 5 Tools Bundle has been tested on.
NetBeans Enterprise Pack also runs on the following platforms:
Minimum Hardware Configuration
Note: The NetBeans IDE's minimum screen resolution is 1024x768 pixels.
Recommended Hardware Configuration
NetBeans IDE 5.5 runs on the Java SE Development Kit 5.0 Update 9 or higher (JDK 5.0, version 1.5.0_09 or higher), which consists of the Java Runtime Environment plus developer tools for compiling, debugging, and running applications written in the Java language. Sun Java System Application Server Platform Edition 9 Update 1 has been tested with JDK 5.0 update 6.
Sun Java System Application Server Requirements
In order to use the J2EE development features of the Java EE 5 Tools Bundle, you must have Sun Java System Application Server Platform Edition 9 Update 1. This Application Server is bundled with the Java EE 5 Tools Bundle download.
This topic provides configuration information that you may need in order to configure the software.
Sun Java System Application Server
The default username and password values for the default Application Server domain,
domain1, are as follows:
Sun Java System Access Manager
If you need to access the administration console for the Access Manager server, use the following values:
Limitations in this NetBeans Enterprise Pack 5.5 release are as follows:
This Java EE 5 Tools Bundle lets you explore and evaluate new functionality in the IDE. We encourage you to send us feedback by logging any issues you encounter in the Issue Tracking system at http://www.netbeans.org/community/issues.html.
Note: Refer to NetBeans IDE 5.5 Release Notes for the list of issues specific to the IDE.
The unresolved issues for this release are as follows:
Description: On Microsoft Windows, if your system is set up to use a temporary directory on your
Cdrive, and that temporary directory does not have enough space for the temporary files needed by the installer, the installer will report that there is not enough disk space on the
Cdrive. This is the case even if you chose to install to a different drive. The installer is in fact reporting that it needs additional temporary space.
The issue exists in the InstallShield framework.
Workaround: Start the installer with the
-is:tempdir custom-temp-dircommand line parameter. The
custom-temp-dirshould contain at least 130 MB of free disk space.
NoClassDefFoundError: cannot access amserveroccurs during installation.
Description: If you try to install the software a second time without cleaning up the Access Manager directory, the configuration of Access Manager may fail during installation.
- On Microsoft Windows:
Delete the directory specified in:
%SystemDrive%\Documents and Settings\ user-name\AMConfig_server_amserver_and then remove the file
%SystemDrive%\Documents and Settings\ user-name\AMConfig_server_amserver_.
- On UNIX/Mac OS X:
Delete the directory specified in:
$HOME\AMConfig_server_amserver_and then remove the file
Description: On UNIX platforms, if the installer cannot run the installation process without the graphics mode, the installer suggests that you run it using the
-silentoptions. If you try this, the installer fails.
Workaround: Ignore the message from the installer and set up the GUI environment as described below to proceed with the installation.
The most common cause for this issue is that you are connecting to the target system via telnet/ssh/rlogin, which means you must redirect the GUI to the originating system. To do this successfully, the following two requirements must be met:
- An X server should be set up and running on the system from which you are connecting.
- The DISPLAY environment variable should be set to the correct value on the target system. Assuming a bash shell, the correct value and command for the variable are:
export DISPLAY= machine-name: display-number
machine-nameis the IP address of the system from where you are connecting, and
display-numberis the number of the display, usually
Description: If you try to install the product after performing a manual uninstallation by deleting files, the installation will fail because the data in InstallShield's VPD registry is not cleaned up.
Workaround: Before starting a new installation, remove the InstallShield VPD registry. This registry resides on Microsoft Windows in
%SystemDrive%\Program Files\Common Files\InstallShield\Universalor on Linux/Solaris/Mac OS X in
Note that other applications (for example, NetBeans IDE) can use the InstallShield VPD registry to store their uninstallation data. The InstallShield VPD registry removal prevents such applications from correct uninstallation. It is strongly advised to uninstall applications that use the InstallShield Universal installer engine prior to removing the VPD registry.
Description: On Mac OS, if the default java version on your system is 1.4, you will not be able to double-click the
.jarfile to start the installation.
Workaround: Run the
.jarfile manually from the command line using java 1.5.
Description: On Microsoft Windows, if there is no preinstalled compatible JDK on the target machine, the InstallShield Windows launcher allows you to select a custom
java.exe. After you select a custom
java.exe, the installer does not perform a validation for compatibility. This means that if you select a
java.exefrom a 1.4 JRE which is not compatible with the installer, you will encounter a number of exceptions. The issue exists in the InstallShield framework.
Workaround: Select a
java.exefrom a 1.5 JRE. See Required Software for information about downloading and installing a compatible JDK.
Description: The installer fails to start correctly on UNIX when is there is little or no disk space in the root directory of the file system. The problem exists in the InstallShield framework. This issue was observed on machines with less than 2.5 MB free in the root of the file system.
Workaround: Free up enough disk space in the root of the file system and restart the installer.
Description: When dragging a tab, a black square area is being dragged. After you drop the tab problems with the Welcome screen repainting appear.
Workaround: Set -J-Dapple.awt.graphics.UseQuartz=true or use Java 1.5 for running the IDE (or _select_ Java 1.5 during the NetBeans Enterprise Pack installation).
Description: The WSDL model cannot resolve portType when the main and imported WSDL have the same targetNamespace.
Workaround: Assign a namespace for the imported WSDL file, distinct from the namespace of the importing WSDL file.
Description: The BPEL Mapper is not refreshed after adding a new element in an XSD file.
Workaround: Close and reopen the Mapper window.
Description: Import of a WSDL file into another WSDL file is not validated. Corresponding error message displays.
Workaround: Go to the Source view of the WSDL Editor, remove the import and namespace that have just been added. Go to the tree mode of the WSDL view, and add the same import again.
Description: Today all xpath expressions created in the BPEL tool have a namespace prefix. In all prior versions of the tool xpath expressions were not prefixed with namespace. If you edit an older BPEL (created with an older version of the tool) and add new assigns to it, you will get a mix of prefixed and non-prefixed expressions since the engine cannot handle this mix. The following combination of problems may occur:
- You may not get the expected result because the non-prefixed expressions may not return a result.
- You may get an exception because the code expects a result to be returned and due to the missing prefix no results are returned.
Workaround: Manually edit non-prefixed expressions to add a prefix.
Description: The Unexpected Reply Activity Encountered. Possible Cause: Potential multiple reply activities for given receive activity. server-side error occurs when running the benchmark project in a multi-thread environment, that is:
- The BPEL-SE is configured with more than 1 thread (default is 10 threads)
- The BPEL-SE is running on a multi-processor machine (might occur on a very powerful single CPU machine too)
This problem can occur in any business process which receives a fault from another business process or an external web service and is running in a multi-threaded environment.
Since the benchmark project has a business process which receives a fault from another business process, this error displays while running the longetivity test.
The issue reproduces on Solaris and Windows.
Workaround: Change the benchmark project so that the business processes do not communincate using faults, but rather using normal replies.
Description: Currently runtime does not support time-outs for a process execution. This makes a business process wait for a certain event for unlimited time.
Workaround: Consider using Pick activities with onAlarm branches where applicable.
Description: After deploying the BluePrint4Application project to the application server, the sample tests will fail if not run in a specific order. This is caused by the use of correlation in the BluePrint 4 BPEL processes.
Workaround: Run the BluePrint4Application tests in any order specified below:
- poServiceRequest -> poRequestCancel
- poServiceRequest -> poRequestConfirm
Description: If you cancel the PartnerLink dialog that appears when you drag a WSDL file or a Web Service node from a NetBeans project onto a diagram, the IDE does not roll back the retrieval of the WSDL files(s).
Workaround: If these files are not needed by the project, simply delete them manually from the Projects window, as you would delete any other project resource.
Description: If you delete a property from a correlation set using pop-up menu commands in the Navigator, the property is incorrectly deleted from the WSDL file.
Workaround: Use the correlation set property editor to delete a property from a correlation set correctly.
Description: If the interface of your partner service changes, for example, when the signature of a web service operation changes, and you have not imported the modified WSDL file, then the BPEL process hangs.
Workaround: Import the new WSDL file and redeploy the application. The BPEL service engine restart may require.
Description: The Unable to Show Diagram message displays although the BPEL file is well-formed.
Workaround: Restart the IDE.
Description: Invoking actions from the Navigator for a broken BPEL may lead to exceptions thrown or the IDE hang.
Workaround: All actions should be disabled from the Navigator when BPEL is broken. Do not invoke actions for a broken BPEL from the Navigator. Correct the BPEL first.
Description: On UNIX, after double-clicking the text field in the string literal box changes to the edit mode for a second and then goes back to the non-edit mode.
Workaround: Double-click the text field in the string literal box, then click a white place inside the BPEL Mapper editor field quickly (before it turns back to the non-edit mode). The string literal box will stay in the edit mode.
Description: NetBeans Visual Web Pack 5.5 breaks the drag and drop functionality in NetBeans Enterprise Pack 5.5 BPEL/SOA projects.
Workaround: Choose Tools > Update Center from the main NetBeans IDE menu to launch the Update Center Wizard. Install Update 1 for NetBeans Visual Web Pack 5.5 final release via the Update Center.
Note that though Update 1 is visible for the NetBeans Visual Web Pack 5.5 Technology Preview users, you need to uninstall the Technology Preview release and download and install the final release of the NetBeans Visual Web Pack 5.5 from the NetBeans Visual Web Pack 5.5 Download page for the Update 1 to take effect.
Secure Web Services
Description: Execution of secure web services enabled application with liberty profile fails if the URL is "localhost"-based. When the Run project is invoked from the IDE, the default URL generated by the IDE includes localhost.
Workaround: Access the stockclient from the browser with the hostname that does not include the localhost name.
Description: If you add Liberty Token Profile secured J2EE modules to the Enterprise Application project, the roles added to the J2EE modules need to be manually added in the Enterprise Application for end-to-end security to work.
Workaround: Manually add the lines below to the EnterpriseApplication->Configuration Files->sun-application.xml file using the xml text editor.<security-role-mapping> <role-name>AUTHENTICATED_USERS</role-name> <principal-name>AUTHENTICATED_USERS</principal-name> </security-role-mapping>
Description: On Windows, the NetBeans Enterprise Pack 5.5 uses the proxy settings for the Internet Explorer as the system proxy settings. This may cause the connection failure and makes editing of Access Manager profiles unavailable if the IE's proxy settings are incorrect.
Workaround: Set up your own proxy settings in the IDE. Open Tools > Options dialog, switch to HTTP Proxy and enter the correct proxy settings.
Description: This is an Access Manager feature. There is a setting in AMConfig.properties for a timeout limit on response from discovery service. The registration request is rejected as an "old message" due to the time difference between the system clocks.
Workaround: Put the system clocks in synch.
Description: Access Manager is not supported for Java version 1.6.
Workaround: Use Java 1.5.x to run the Access Manager.
Description: If the Access Manager server configuration is changed after an installation, the AMConfig.properties file does not get modified to reflect the changes. This can cause discrepancies between the configured Access Manager server and the AMConfig.properties file resulting in the IDE not being able to talk to the Access Manager server via the client SDK.
Workaround: Manually sync up the client's AMConfig.properties file to reflect the proper Access Manager server information.
XML Schema Tools
Description: When using the column view, sometimes only one of the multi selected nodes is removed after the Delete command from the pop-up menu is invoked on them .
Workaround: Multi select and use the Delete key, or sequentially single select and choose Delete from the context menu, or use the Tree Editor.
XML Schema Tools, BPEL, and Secure Web Services Modules
The issues described below occur with IDE when using the NetBeans Enterprise Pack 5.5 modules.
Description: On Mac OS X, Solaris, and Linux, the IDE does not recognize projects created under root directory
Workaround: Create projects in a folder.
Description: When running the IDE on Red Hat Fedora Core 3 in the zh_CN locale and possibly some other Asian locales, the text may be unreadable because of rendering problems. This problem is a result of font support issues with the JDK on the Fedora Core distribution, so this problem also might apply to other Java applications running on Fedora Core.
Workaround: There is no safe workaround for the rendering problem on Red Hat Fedora Core 3, so it is best to use a different Linux distribution or operating system in these locales. We have verified that this problem does not occur on Red Hat Enterprise Linux 3.