Science Education and Technology: Installation Instructions for NetBeans IDE and Development Kit

NetBeans IDE 7.3.1 Installation Instructions

This document describes how to install NetBeans IDE 7.3.1 on your system. Please see the NetBeans IDE 7.3.1 Release Notes for information about supported operating systems and hardware configurations for the IDE. To learn about the new features included in this release of the IDE see the NetBeans IDE 7.3.1 Release Information page.

Required Software

The Java SE Development Kit (JDK) 6 Update 26 (or later) or JDK 7 Update 10 (or later) is required to install the NetBeans IDE. You can download the latest update of JDK 6 or 7 at http://www.oracle.com/technetwork/java/javase/downloads.
The PHP and C/C++ NetBeans bundles only require the Java Runtime Environment (JRE) 6 to be installed and run. However, if you are planning to use any of the Java features, you need JDK 7.
The JavaFX 2.2.5 SDK is required to use JavaFX 2.2.5 features in the NetBeans IDE 7.3.1. You can download the JavaFX 2.2.5 SDK from the JavaFX download site.

Note:

JavaFX 2.2.4 is bundled with the latest JDK 7 for Windows, Mac and Linux.
If you install the JDK 7 Update 10 or newer to default locations, the NetBeans IDE can create a JavaFX-enabled Java platform automatically.
To use JavaFX features in the NetBeans IDE, we strongly recommend upgrading your JDK version to JDK 7 Update 10 or newer.

top

Installer Download Options

On the NetBeans IDE Download page, you can obtain one of several installers, each of which contains the base IDE and additional tools.
The following installers are available:

Java SE. Supports all standard Java SE development features as well as support for NetBeans Platform development and JavaFX 2.2.5 SDK.
Java EE. Provides tools for developing Java SE and Java EE applications as well as support for NetBeans Platform development and JavaFX 2.2.5 SDK. This download option also includes GlassFish Server Open Source Edition 4.0, and Apache Tomcat 7.0.34 software.
C/C++. Supports development in the C, C++, Qt, Fortran and Assembly languages.
PHP. Provides tools for PHP 5.x development, Zend and Symfony Framework support.
All. This is a full download option, which contains all the runtimes and technologies available for the NetBeans IDE.

top

Customizing Your Installation

If you download the All download option, you can choose exactly what tools and runtimes to install. Click Customize at the Welcome page of the installer 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 PHP 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:

GlassFish Server Open Source Edition 4.0 is included in the Java EE and All download options but it is not installed by default from either of these options. To install GlassFish Server Open Source Edition 4.0, select the appropriate option below:
- from the Java EE download, launch the installer and select the GlassFish Server Open Source Edition 4.0 checkbox at the Welcome page;
- from the All download, launch the installer and select GlassFish Server Open Source Edition 4.0 in the Customize Installation dialog box.
You should change the default administrator password after you install the GlassFish server, refer to FaqSettingGlassFishPassword for details.
Apache Tomcat 7.0.34 is included in the Java EE and All download options but it is not installed by default from either of these options. To install Apache Tomcat, select the appropriate option below:
- from the Java EE download, launch the installer and select the Apache Tomcat 7.0.34 checkbox at the Welcome page;
- from the All download, launch the installer and select Apache Tomcat 7.0.34 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 Configuring the NetBeans IDE for C/C++/Fortran document.
To enable JavaFX 2.2.5 support in the NetBeans IDE 7.3.1 release, refer to the Setting Up NetBeans IDE With JavaFX document.
For OS X, you can customize the NetBeans IDE installation from the All and Java EE downloads. The IDE installation from Java SE, C/C++, and PHP downloads cannot be customized.
You can also download a platform-independent zip file and run the NetBeans IDE executable file. Note that the GlassFish Server Open Source Edition and Apache Tomcat are only available with platform-specific installers.
To make sample project templates unreachable in the NetBeans IDE installation, see the Hide Sample Projects FAQ page.

top

Starting the Download

Go to https://netbeans.org/downloads/
In the upper right area of the page, select the language and platform from the drop-down list. You can also choose to download and use the platform-independent zip file.
Click the Download button for the download option that you want to install.
Save the installer file to your system.

top

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 and system requirements, see the release notes.

Microsoft Windows, Solaris OS, and Linux

To install the software:

After the download completes, run the installer.
- 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>
If you downloaded the All or Java EE bundle, you can customize your installation. Perform the following steps at the Welcome page of the installation wizard:
1. Click Customize.
2. In the Customize Installation dialog box, make your selections.
3. Click OK.
At the Welcome page of the installation wizard, click Next.
At the License agreement page, review the license agreement, click the acceptance check box, and click Next.
At the JUnit License Agreement page, decide if you want to install JUnit and click the appropriate option, click Next.
At the NetBeans IDE installation page, do the following:
1. 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.
2. 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 and click Next, or cancel the current installation. After installing the required JDK version you can restart the installation.
  Note: If the JDK version is older than the recommended JDK 7 Update 10, download and install the latest JDK update from Java SE Downloads page and restart the NetBeans IDE installer. You can run the NetBeans IDE on JDK 6 as an alternative.
If the GlassFish Server Open Source Edition 4.0 installation page opens, accept the default installation directory or specify another installation location.
If you are installing Apache Tomcat, on its installation page, accept the default installation directory or specify another installation location. Click Next.
At the Summary page, do the following:
1. Verify that the list of components to be installed is correct.
2. Select the Check for Updates check box if you want to check the Update Center for possible updates and have the JUnit library installed during the installation (provided you accepted the license in step 5.)
3. Verify that you have adequate space on your system for the installation.
Click Install to begin the installation.
At the Setup Complete page, provide anonymous usage data if desired, and click Finish.

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.

OS X

To install the software:

After the download completes, run the installer. The installer file has the .dmg extension.
On the panel that opens double-click the package icon. The package has the .mpkg extension. The installation wizard starts.
Click Continue when the "This package will run a program to determine if the software can be installed." dialog box is displayed.
At the Introduction page of the installation wizard, click Continue.
Note: If the JDK version is older than the recommended JDK 7 Update 10, download and install the latest JDK update from Java SE Downloads page and restart the NetBeans IDE installer. You can run the NetBeans IDE on JDK 6 as an alternative.
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 or Java EE 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.

Platform-Independent Package

To run the software:

After the download of the platform-independent ZIP file completes, extract it to any folder on your system.
Run the executable file located in the netbeans/bin directory.
Accept the License Agreement.
At the JUnit License Agreement page, decide if you want to install JUnit and click the appropriate option, click Next. The NetBeans IDE installation starts.

Note: If a compatible JDK installation cannot be found, you might need to manually add a path to the JDK installation directory by doing the following:

Open the netbeans.conf file located in the netbeans/etc directory in a text editor.
Enter the location of a compatible JDK installation for the netbeans_jdkhome option. The default location in Windows is C:\Program Files\Java\jdk1.7.0_10 or similar.
Save the netbeans.conf file and run the executable file in the netbeans/bin directory.

Note: The GlassFish Server Open Source Edition and Apache Tomcat are available only with platform-specific installers.
Note: To use the GlassFish Server Open Source Edition and/or Apache Tomcat that are already installed on your machine, in the NetBeans IDE, click Servers on the Tools menu. This displays the Add Server Instance Wizard which helps to register an instance of the required web server with the NetBeans IDE.

top

Uninstalling the Software

Follow the instructions in this section to uninstall the IDE on your system. These uninstallation instructions apply to all supported platforms. For the list of supported platforms, see the release notes.

Microsoft Windows

If necessary, you can uninstall the NetBeans IDE, the GlassFish Server Open Source Edition 4.0, and Apache Tomcat using the following procedures.
To uninstall the IDE:

Shut down the IDE.
From the Control Panel, select Add or Remove Programs, then select NetBeans IDE 7.3.1 and click Remove.
To uninstall GlassFish and Tomcat together with the IDE, at the Summary page make sure that the correct versions are listed and check the appropriate checkboxes.
Check the NetBeans user directory checkbox if you want to remove it together with the IDE, and click Uninstall.
At the Summary page, click Uninstall.
After uninstallation completes, click Finish.

To uninstall the GlassFish Server Open Source Edition 4.0:

Shut down the IDE.
From the Control Panel, select Add or Remove Programs, then select GlassFish Server Open Source Edition 4.0 and click Remove.

To uninstall Apache Tomcat:

Shut down the IDE.
From the Control Panel, select Add or Remove Programs, then select Apache Tomcat 7.0.34 and click Remove.

Solaris OS, Linux

If necessary, you can uninstall the NetBeans IDE, the GlassFish Server Open Source Edition 4.0, and Apache Tomcat using the following procedures.
To uninstall the IDE:

Shut down the IDE.
In the IDE installation directory, run the uninstall.sh file.
To uninstall GlassFish and Tomcat together with the IDE, at the Summary page make sure that the correct versions are listed and check the appropriate checkboxes.
At the Summary page, click Uninstall.
After uninstallation completes, click Finish.

To uninstall GlassFish Server Open Source Edition 4.0:

Shut down the IDE.

Locate the application server installation directory.

Note: The default installation location is different depending on the type of installation and the platform. The following table shows the default application server installation directory for various platforms.

Platform	Installing As...	GlassFish 4.0 Installation
Windows	user with admin rights	`%ProgramFiles%\glassfish-4.0`
Windows	user	`%USERPROFILE%\glassfish-4.0`
Solaris OS	root	`/opt/glassfish-4.0`
Solaris OS, Linux	user	`~/glassfish-4.0`
Linux	root	`/usr/local/glassfish-4.0`

In the application server installation directory, run the uninstall.sh file.
At the Summary page, click Uninstall.
After uninstallation completes, click Finish.

To uninstall Apache Tomcat:

Shut down the IDE.

Locate the Apache Tomcat installation directory.

Note: The default installation location varies depending on the type of installation and the platform. The following table shows the default application server installation directory for different platforms.

Platform	Installing As...	Apache Tomcat 7.0.34 Installation
Windows	user with admin rights	`%ProgramFiles%\Apache Software Foundation\Apache Tomcat 7.0.34`
Windows	user	`%USERPROFILE%\Apache Software Foundation\Apache Tomcat 7.0.34`
Solaris OS	root	`/opt/apache-tomcat-7.0.34`
Solaris OS, Linux	user	`~/apache-tomcat-7.0.34`
Linux	root	`/usr/local/apache-tomcat-7.0.34`

In the application server installation directory, run the uninstall.sh file.
At the Summary page, click Uninstall.
After uninstallation completes, click Finish

OS X

To uninstall the IDE and application server:

Shut down the software.
Drag the program folders or files to the Trash. Note that the default location for the IDE and application server is /Applications/NetBeans/.

Platform-Independent Package

To uninstall the IDE files, delete the installation directories of the IDE.

top

Upgrading and Multiple Installation Support

Multiple installations of NetBeans IDE 5.x, 6.x, and 7.x can coexist with NetBeans IDE 7.3.1 on the same system. You do not have to uninstall the earlier versions in order to install or run NetBeans IDE 7.3.1.
If you have an existing installation of NetBeans IDE you can choose whether or not to import the user settings from the existing user directory when you run NetBeans IDE 7.3.1 for the first time.
Note: Incremental version upgrades of the IDE cannot be performed at this time. To upgrade to the most recent version you must download the latest installer.

top

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\Uninstall HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall

For 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.

top