NetBeans IDE 6.5 Installation Instructions

Last updated:
August 9, 2012

This document describes how to install NetBeans IDE 6.5 on your system. For information about supported operating systems and hardware configurations for the IDE, see the NetBeans IDE 6.5 Release Notes. See NetBeans IDE 6.5 Information to learn about the new features included in NetBeans IDE 6.5.

Required Software

Before you install the IDE, the Java SE Development Kit (JDK) 5 Update 16 (version 1.5.0_16) or newer (including JDK 6 Update 11) must be installed on your system. If you do not have an installation of JDK, you cannot proceed with the installation.

For PHP, Ruby, and C++ download options, you can install JRE instead of JDK. However, if you are planning to use any Java features, you will need JDK.

Note: The use of JDK 6 Update 12 with NetBeans IDE 6.5 might cause errors and incorrect IDE's behavior. Therefore, use only the recommended JDK versions. For more information, see the NetBeans IDE 6.5 Release Notes.

Customizing Your Installation

If you download Java or "All" download options, you can choose exactly what tools and runtimes to install. Click Customize at the Welcome page and select the features that you want to use. For more information, see Installing the Software.

If you want to add functionality to your NetBeans IDE configuration, use the NetBeans Plugin Manager. For example, assume that you start out by downloading and installing the Ruby pack. You then decide that you want to try out the C/C++ functionality. To do this, go to the NetBeans Plugin Manager from the IDE (choose Tools > Plugins) and add the C/C++ pack to your existing installation.

There are several important notes about installation and configuration of some NetBeans IDE features:

Apache Tomcat 6.0.18 is included in the "Java" and "All" download options but it is not installed by default from either of these options. To install Apache Tomcat from the Java or "All" download, launch the installer and select Apache Tomcat 6.0.18 in the Customize Installation dialog box.

For C/C++ development (applicable for the C/C++ and "All" downloads), you need to additionally install compilers and tools. For more information, refer to the Installing and Configuring C/C++ Support.

If you want to use the Sun Java System Access Manager, in addition to the "All" download option for the IDE, you need to install Java Application Platform SDK Update 5 or later from
http://java.sun.com/javaee/downloads/index.jsp. Ensure that you download the version that includes the Access Manager.

Installing the Software

Follow the instructions in this section to install the IDE on your system. These installation instructions apply to all supported platforms. For the list of supported platforms, see the NetBeans IDE 6.5 Release Notes.

For Windows, the installer executable file has the .exe extension. Double-click the installer file to run it.

For Solaris and Linux platforms, the installer file has the .sh extension. For these platforms, you need to make the installer files executable by using the following command:
chmod +x ./<installer-file-name>

To choose the tools and runtimes to install, perform the following steps at the Welcome page of the installation wizard:

Click Customize.

In the Customize Installation dialog box, make your selections.

Click OK.

At the Welcome page of the installation wizard, click Next.

At the License agreement page, review the license agreement, select the acceptance checkbox, and click Next.

At the NetBeans IDE installation page, do the following:

Accept the default installation directory for the NetBeans IDE or specify another directory.Note: The installation directory must be empty, and the user profile you are using to run the installer must have read/write permissions for this directory.

Accept the default JDK installation to use with the NetBeans IDE or select a different installation from the drop-down list.
If the installation wizard did not find a compatible JDK installation to use with the NetBeans IDE, your JDK is not installed in the default location. In this case, specify the path to an installed JDK or cancel the current installation, install the required JDK version, and restart this installation.

Click Next.

If the GlassFish V2 UR2 application server installation page opens, do the following:

Accept the default installation directory for the server or specify another installation directory. Note: The installation directory you specify must be empty, and the user profile you are using to run the installer must have read/write permissions for this directory.

From the list of compatible JDK installations, choose the JDK you want the application server to use or click the Browse button to specify another JDK installation.

Change the username and password for the default server domain or accept the defaults and click Next.
The default username and password are admin and adminadmin.

Verify the default port values (HTTP, HTTPS, and Admin) for the server or change them if necessary.

At the Summary page, verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.

Click Install to begin the installation.

When the installation is complete:

If the GlassFish application server has been installed, to register it select the Register the Sun Java System Application Server and NetBeans IDE after finishing the installer checkbox.

If the GlassFish application server has not been installed, select the Register the NetBeans IDE after finishing the installer checkbox to register the NetBeans IDE.

Click Finish to exit the wizard.

If you selected the Register... checkbox at the previous step, the Registration page opens in the browser. Click Register.

Enter your Sun Online Account or create it on the www.sun.com page, which is accessible via a link.

Note: If you encounter problems successfully completing the software installation, see Troubleshooting for descriptions and suggested workarounds for unresolved issues that could affect the installation process.

Note: If you have not registered the GlassFish application server right after the installation, you can do it when you run the NetBeans IDE or open the Admin console of the GlassFish application server.

Note: If you have not registered the NetBeans IDE 6.5 right after the installation, you can do it when you run the NetBeans IDE.

After the download completes, run the installer. The installer file has the .dmg extension.

On the panels that opens click the package icon. The package has the .mpkg extension. The installation wizard starts.

At the Welcome page of the installation wizard, click Continue.

Review the license agreement and click Continue. Click Accept in the pop-up window to accept the license.

At the Select a Destination page, select the drive and click Continue.

If you downloaded the All, Java, or Ruby bundle, you can customize your installation. On the last installation wizard panel, press the Customize button in the bottom left-hand side of the panel. The tree of products is displayed.

Select the products you want to install

Enter the administrator's name and password for your system and click OK to begin the installation.

Upgrading and Coexisting with Previous Versions

NetBeans IDE 5.5 or 5.5.1, 6.0, or 6.1 can coexist with NetBeans IDE 6.5 on the same system.
You do not have to uninstall the 5.5 or 5.5.1, 6.0, or 6.1 versions in order to install or run NetBeans IDE 6.5.

If you have NetBeans IDE 5.5, 5.5.1, 6.0, or 6.1 installed you will be able to choose whether or not to import the user settings from the existing user directory when you run NetBeans IDE 6.5 for the first time.

Troubleshooting

About the Installer Working Directory

The installer stores data about installation sessions in the installer working directory. Examples of this data are the list of components installed on your system, installation log messages, and registry data.

The default location for the installer working directory is %USERPROFILE%\.nbi on Windows and ~/.nbi on other platforms. The log subdirectory contains the installation log files.

Cleaning Up After Incomplete Installations

After incomplete or unsuccessful installations, you might need to clean up your system from previous installations.

For Microsoft Windows, Solaris OS, and Linux:

Delete the installer working directory.

Delete the installation directories of the IDE and the GlassFish application server.

On the Windows platform, delete all nbi* registry entries from the following registry keys: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\UninstallHKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

For Mac OS X:

Drag the program folders or files to the Trash.

Disabling Some Software Before Installation

It is better to disable firewall, antivirus, and monitoring applications before you start installation. Some of these applications can prevent IDE components from being configured correctly during the installation process.

For example, if you have the Logitech Process Monitor application (LVPrcSrv.exe) running on your system, switch it off before installation.