NetBeans IDE 5.5 Installation Instructions

The following instructions cover installation of both NetBeans IDE 5.5 (standalone) as well as the NetBeans IDE 5.5 and Sun Java System Application Server Platform Edition 9 Bundle.


For installation information about NetBeans add-on packs, see:


Contents

Note: For system requirements and other information, such as launching the IDE with different startup parameters, see the Release Notes.


NetBeans IDE Installation (Standalone Installer)

Following are instructions for installing the standalone NetBeans IDE 5.5 on each of the supported platforms.

Windows

On Microsoft Windows machines, the preferred method of installing NetBeans IDE is using the self-extracting installer.

To install the NetBeans IDE:

  1. Once you have downloaded the installer file, double-click the installer's icon to launch the installer.

  2. In the install wizard, respond to the License Agreement, then click Next.

  3. Specify an empty directory within which to install NetBeans IDE.

    Note: This NetBeans IDE will not disrupt the settings of your other NetBeans installations because the IDE automatically creates a new user directory when launched (${HOME}/.netbeans/5.5).

  4. Choose the JDK you want the IDE to use from the list of suitable choices in the list, then click Next.

  5. Verify that the installation location is correct and that you have adequate space on your system for the installation.

  6. Click Next to begin the installation.

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


Solaris Operating System (Solaris OS)

On machines running Solaris operating system, the binary installer is the preferred method for installing NetBeans IDE.

To install the NetBeans IDE:

  1. Navigate to the directory that contains the installer.

  2. If necessary, change the installer file's permissions to make the binary executable by typing from a command prompt:
    $ chmod +x your_binary_executable

    Note: Be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  3. Launch the installer by typing from a command prompt:
    $ ./your_binary_executable

    Note: Again, be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  4. In the install wizard, respond to the License Agreement, then click Next.

  5. Specify an empty directory within which to install NetBeans IDE, then click Next.

  6. Choose the JDK you want the IDE to use from the list of suitable choices in the list, then click Next.

    The installer searches for JDKs installed on your system and prompts you to specify which one it should use. You can also specify which JDK the IDE should use from the command line. For example:

    $ ./your_binary_executable -is:javahome path_to_your_jdk

  7. Verify that the installation location is correct and that you have adequate space on your system for the installation.

  8. Click Next to begin the installation.

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


Linux

On Linux machines, the binary installer is the preferred method for installing NetBeans IDE.

To install the NetBeans IDE:

  1. Navigate to the directory that contains the installer.

  2. If necessary, change the installer file's permissions to make the binary executable by typing from a command prompt:
    $ chmod +x your_binary_executable

    Note: Be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  3. Launch the installer by typing from a command prompt:
    $ ./your_binary_executable

    Note: Again, be sure to replace your_binary_executable
    with the actual filename of the binary that you downloaded.


  4. In the install wizard, respond to the License Agreement, then click Next.

  5. Specify an empty directory within which to install NetBeans IDE, then click Next.

  6. Choose the JDK you want the IDE to use from the list of suitable choices in the list, then click Next.

    The installer searches for JDKs installed on your system and prompts you to specify which one it should use. You can also specify which JDK the IDE should use from the command line. For example:

    $ ./your_binary_executable -is:javahome path_to_your_jdk

  7. Verify that the installation location is correct and that you have adequate space on your system for the installation.

  8. Click Next to begin the installation.

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


Macintosh OS X

On Macintosh OS X, NetBeans is packaged as a native application bundle. The preferred method of installing NetBeans IDE is using the tarball (.tar.gz) file.

To install the NetBeans IDE:

  1. Download the tarball to the desired location on your system.

  2. Double-click the file to unpack the contents on your system.

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


top


NetBeans IDE and Sun Java System Application Server Bundle Installation

Following are instructions for installing the NetBeans IDE 5.5 and Sun Java System Application Server Platform Edition 9 bundle on all supported platforms.

Windows

On Microsoft Windows machines, the preferred method of installing NetBeans IDE and Sun Java System Application Server bundle is using the self-extracting installer.

To install the NetBeans IDE 5.5 and Sun Java System Application Server Platform Edition 9 bundle:

  1. Once you have downloaded the installer file, double-click the installer's icon to launch the installer.

  2. In the install wizard, respond to the License Agreement, then click Next.

  3. Specify an empty directory within which to install the IDE.

    Note: This NetBeans IDE will not disrupt the settings of your other NetBeans installations because the IDE automatically creates a new user directory when launched (${HOME}/.netbeans/5.5).

  4. On the same page of the wizard, specify an empty directory within which to install the Application Server and click Next.

  5. Choose the JDK you want the IDE to use from the list of suitable choices in the list, then click Next.

  6. Verify that the installation location is correct and that you have adequate space on your system for the installation.

  7. Click Next to begin the installation.

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


Solaris Operating System (Solaris OS)

On machines running Solaris operating system, the binary installer is the preferred method for installing NetBeans IDE and Sun Java System Application Server bundle.

To install the NetBeans IDE 5.5 and Sun Java System Application Server Platform Edition 9 bundle:

  1. Navigate to the directory that contains the installer.

  2. If necessary, change the installer file's permissions to make the binary executable by typing from a command prompt:
    $ chmod +x your_binary_executable

    Note: Be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  3. Launch the installer by typing from a command prompt:
    $ ./your_binary_executable

    Note: Again, be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  4. In the install wizard, respond to the License Agreement, then click Next.

  5. Specify an empty directory within which to install the IDE. The installation directory must not contain spaces in its name.

  6. On the same page of the wizard, specify an empty directory within which to install the Application Server and click Next.

  7. Choose the JDK you want the IDE to use from the list of suitable choices in the list, then click Next.

    The installer searches for JDKs installed on your system and prompts you to specify which one it should use. You can also specify which JDK the IDE should use from the command line. For example:

    $ ./your_binary_executable -is:javahome path_to_your_jdk

  8. Verify that the installation location is correct and that you have adequate space on your system for the installation.

  9. Click Next to begin the installation.

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


Linux

On Linux machines, the binary installer is the preferred method for installing NetBeans IDE and Sun Java System Application Server bundle.

To install the NetBeans IDE and Sun Java System Application Server bundle:

  1. Navigate to the directory that contains the installer.

  2. If necessary, change the installer file's permissions to make the binary executable by typing from a command prompt:
    $ chmod +x your_binary_executable

    Note: Be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  3. Launch the installer by typing from a command prompt:
    $ ./your_binary_executable

    Note: Again, be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  4. In the install wizard, respond to the License Agreement, then click Next.

  5. Specify an empty directory within which to install the IDE. The installation directory must not contain spaces in its name.

  6. On the same page of the wizard, specify an empty directory within which to install the Application Server and click Next.

  7. Choose the JDK you want the IDE to use from the list of suitable choices in the list, then click Next.

    The installer searches for JDKs installed on your system and prompts you to specify which one it should use. You can also specify which JDK the IDE should use from the command line. For example:

    $ ./your_binary_executable -is:javahome path_to_your_jdk

  8. Verify that the installation location is correct and that you have adequate space on your system for the installation.

  9. Click Next to begin the installation.

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


Macintosh OS X

On Mac OS X, the NetBeans and Sun Java System Application Server bundle is packaged as a jar file.

To install the NetBeans IDE and Sun Java System Application Server bundle:

  1. Navigate to the directory that contains the installer.
  2. If necessary, change the installer file's permissions to make the binary executable by typing from a command prompt:
    $ chmod +x your_binary_executable

    Note: be sure to replace your_binary_executable with the actual filename of the binary that you downloaded.


  3. Launch the installer by double-clicking the bundle installer jar file.

  4. On the install wizard's initial panel, click Next to continue.

  5. In the install wizard, respond to the License Agreement, then click Next.

  6. Specify an empty directory within which to install the IDE. The installation directory must not contain spaces in its name. By default, NetBeans is installed in the Applications directory.

  7. On the same page of the wizard, specify an empty directory within which to install the Application Server and click Next. By default, the Application server is installed in the SUNWappserver subdirectory of your home directory.

  8. Choose the JDK you want the IDE to use from the list of suitable choices in the list, then click Next.

    The installer searches for JDKs installed on your system and prompts you to specify which one it should use. You can also specify which JDK the IDE should use from the command line. For example:

    $ ./your_binary_executable -is:javahome path_to_your_jdk

  9. Verify that the installation location is correct and that you have adequate space on your system for the installation.

  10. Click Next to begin the installation.

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


top


Launching the IDE

Following are instructions for starting the NetBeans IDE. If you are using an operating system for which there is no installer you can still use NetBeans IDE by downloading and installing archive distributions. For more information, see the Archive Distributions section below.

Windows

To start the IDE on Microsoft Windows machines, do one of the following:


Solaris Operating System (Solaris OS)

To start the NetBeans IDE on Solaris systems:

  1. Navigate to the bin subdirectory of your installation.

  2. Execute the launcher script by typing ./netbeans.

Linux

To start the NetBeans IDE on Linux systems:

  1. Navigate to the bin subdirectory of your installation.

  2. Execute the launcher script by typing ./netbeans.

Macintosh OS X

To start the NetBeans IDE on Mac OS X systems:


top


Registering and Starting the Application Server

If you used the standalone NetBeans IDE installer, you need to register the Application Server before you can use it.

Registering the Sun Java System Application Server

To register the Sun Java System Application Server:

  1. Go to Tools > Server Manager.

  2. In the Server Manager, click Add Server.

  3. In the dialog box, select Sun Java System Application Server 9 and click Next.

  4. Enter a name for the server instance. This name is used to identify the server in the IDE.

  5. Enter the location, user name, and password. You do not need to enter the installation location and domain if you are registering a remote instance of the server. You must register a local installation of the application server before you can register remote instances.

  6. Click Finish.

Note: If you used the bundle installer, the Sun Java System Application Server was installed and configured automatically so it is not necessary to carry out the registration procedure outlined above.


Starting the Sun Java System Application Server

To start the Application Server:

  1. In the Runtime window, right-click the newly-created localhost node and choose Start/Stop Server from the contextual menu.

  2. In the Server Status dialog, click Start Server.

  3. Click Close to close the dialog box.

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.


top


Archive Distributions

If you are using an operating system for which there is no installer you can still use NetBeans IDE by downloading and installing archive distributions. You can also install archive distributions of the IDE if you want to test development builds.

To install archive NetBeans IDE distributions:

  1. Navigate to the directory that contains the archive file.

  2. Unpack the archive using the appropriate utilities for your system.

To launch archive NetBeans IDE distributions:

  1. Navigate to the bin subdirectory of your NetBeans IDE installation.

  2. Execute the appropriate launcher for your system.

The following launchers are included in the archive distributions:

If there is no specific launcher for your operating system, you may need to create one by modifying the appropriate script. If your machine supports JDK 1.5.0 or greater you should, however, be able to run the IDE.

Note: If you create a launcher, you can contribute it to the NetBeans project. For more information, see Contributing to netbeans.org.


top


Uninstalling NetBeans IDE

If necessary, you can uninstall the NetBeans IDE using the following procedures.

Uninstalling the NetBeans IDE 5.5 from Windows

To uninstall NetBeans IDE:

  1. From your system's Start menu, choose Control Panel.

  2. Double-click the Add or Remove Programs icon.

  3. Select NetBeans IDE 5.5 from the list and click Remove.

To uninstall the Sun Java System Application Server Platform Edition 9:

  1. From your system's Start menu, open the Control Panel.

  2. Double-click the Add or Remove Programs icon.

  3. Select the Sun Java System Application Server Platform Edition 9 from the list and click Remove.

Uninstalling the NetBeans IDE 5.5 from Solaris (SPARC and x86 Platform Editions)

To uninstall NetBeans IDE:

  1. Navigate to the _uninst subdirectory of your NetBeans IDE installation directory.

  2. Type ./uninstaller to run the InstallShield uninstaller.

To uninstall the Sun Java System Application Server:

  1. Navigate to the installation directory of the Sun Java System Application Server Platform Edition 9.

  2. In a terminal window, type ./uninstall to run the uninstaller.

Uninstalling the NetBeans IDE 5.5 from Linux

To uninstall NetBeans IDE:

  1. Navigate to the _uninst subdirectory of your NetBeans IDE installation directory.

  2. In a terminal window, type ./uninstaller to run the InstallShield uninstaller.

To uninstall the Sun Java System Application Server:

  1. Navigate to the installation directory of the Sun Java System Application Server Platform Edition 9.

  2. In a terminal window, type ./uninstall to run the uninstaller.

Uninstalling the NetBeans IDE 5.5 from Macintosh OS X

To uninstall NetBeans IDE:

  1. Navigate to the installation location of the NetBeans IDE. By default, NetBeans is installed in the Applications directory.

  2. Right-click the NetBeans icon and choose Show Package Contents from the pop-up menu.

  3. In the window that appears, navigate to the _uninst subdirectory.

  4. In a terminal window, type ./uninstaller to run the InstallShield uninstaller.

To uninstall the Sun Java System Application Server:

  1. Navigate to the installation directory of the Sun Java System Application Server Platform Edition 9. By default, the Application server is installed in the SUNWappserver subdirectory of your home directory.

  2. In a terminal window, type ./uninstall to run the uninstaller.

top


Troubleshooting

If you experience problems installing or running the software, see the list of issues below for workarounds. For a complete list of known issues, system requirements and other useful information, see the Release Notes.

Following are the unresolved issues for this release that could affect or disrupt the installation process:

top