NetBeans IDE 5.5.1 Installation Instructions
The following instructions are for installation of the NetBeans IDE
5.5.1.
For installation information about NetBeans Add-on packs, see:
Note: If you want to use SOA and BPEL functionality in Enterprise Pack,
please use NetBeans IDE 5.5 with NetBeans Enterprise Pack 5.5. We do
not expect to publish any further updates to NetBeans Enterprise Pack 5.x.
All our development efforts are now focused on NetBeans 6.0 with SOA.
Contents
Note: For system requirements and other information, such as launching
the IDE with different startup parameters, see the Release
Notes.
NetBeans IDE Installation
Following are instructions for installing the standalone NetBeans IDE 5.5.1
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:
- Once you have downloaded the installer file, double-click the installer's
icon to launch the installer.
- In the install wizard, respond to the License Agreement, then click Next.
- 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.1).
- Choose the JDK you want the IDE to use from the list
of suitable choices in the list, then click Next.
- Verify that the installation location is correct and that you have adequate
space on your system for the installation.
- 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:
- Navigate to the directory that contains the installer.
- 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.
- 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.
- In the install wizard, respond to the License Agreement, then click Next.
- Specify an empty directory within which to install NetBeans IDE, then
click Next.
- 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
- Verify that the installation location is correct and that you have adequate
space on your system for the installation.
- 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:
- Navigate to the directory that contains the installer.
- 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.
- 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.
- In the install wizard, respond to the License Agreement, then click Next.
- Specify an empty directory within which to install NetBeans IDE, then
click Next.
- 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
- Verify that the installation location is correct and that you have adequate
space on your system for the installation.
- 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:
- Download the tarball to the desired location on your system.
- 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
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:
- Double-click the NetBeans IDE icon on your desktop.
- From the Start menu, select NetBeans IDE 5.5.1 > NetBeans IDE.
Solaris Operating System (Solaris OS)
To start the NetBeans IDE on Solaris systems:
- Navigate to the bin subdirectory of your installation.
- Execute the launcher script by typing ./netbeans.
Linux
To start the NetBeans IDE on Linux systems:
- Navigate to the bin subdirectory of your installation.
- Execute the launcher script by typing ./netbeans.
Macintosh OS X
To start the NetBeans IDE on Mac OS X systems:
- Navigate to the directory of your installation.
- Double-click the NetBeans IDE application icon.
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:
- Navigate to the directory that contains the archive file.
- Unpack the archive using the appropriate utilities for your system.
To launch archive NetBeans IDE distributions:
- Navigate to the bin subdirectory of your NetBeans IDE installation.
- Execute the appropriate launcher for your system.
The following launchers are included in the archive distributions:
- netbeans.exe - Windows
- nb.exe - Windows (from within a console window)
- netbeans - UNIX, Linux
- NetBeans - Mac OS X
- netbeans.cmd - OS/2
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.1 from Windows
To uninstall NetBeans IDE:
- From your system's Start menu, choose Control Panel.
- Double-click the Add or Remove Programs icon.
- Select NetBeans IDE 5.5.1 from the list and click Remove.
Uninstalling the NetBeans IDE 5.5.1 from Solaris (SPARC and x86 Platform Editions)
To uninstall NetBeans IDE:
- Navigate to the _uninst subdirectory of your NetBeans
IDE installation directory.
- Type ./uninstaller to run the InstallShield uninstaller.
Uninstalling the NetBeans IDE 5.5.1 from Linux
To uninstall NetBeans IDE:
- Navigate to the _uninst subdirectory
of your NetBeans IDE installation directory.
- In a terminal window, type ./uninstaller to run
the InstallShield uninstaller.
Uninstalling the NetBeans IDE 5.5.1 from Macintosh OS X
To uninstall NetBeans IDE:
- Navigate to the installation location of the NetBeans IDE.
By default, NetBeans is installed in the Applications directory.
- Right-click the NetBeans icon and choose Move to Trash
from the pop-up menu.
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:
- Issue #26965
Description:
When using JDK installations that include an incompatible version of sax.jar,
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 #65482 (Linux only)
Description:
Unable to install NetBeans on some Mandrake/Mandriva Linux distributions.
During initialization, the installer displays the following message:
Initializing InstallShield Wizard........
./netbeans-5_0-bin-linux.bin: line 189: bc: command not found
./netbeans-5_0-bin-linux.bin: line 404: [: : integer expression expected
Workaround:
NetBeans installer uses GNU's bc utility, which doesn't seem to install
by default in Mandriva. If you experience this problem, install GNU's
bc utility manually prior to installing NetBeans. If you have an active
Internet connection, you can run urpmi bc from the command
line to accomplish this. Note that it is also possible to download
the appropriate RPM and install using the rpm -i
<bc_package>.rpm command.
- Issue #67530
Description:
After starting the installer, you get a message that says "Welcome
to the Install Wizard for ERROR: null". This could be caused by running
multiple installers simultaneously or by running the installer after another
installer that has failed to exit.
Workaround:
Delete the contents of the \InstallShield\Universal\Common directory
and then restart the installer.
On Windows systems, this directory is located at C:\Program Files\Common files\InstallShield\Universal\Common.
On Solaris and Linux systems, this directory is located at
/$HOME/InstallShield/Universal/Common.
- Issue #52012 (only Turkish locale on Windows XP systems)
Description:
For systems set to use the Turkish locale, the installer does not successfully
finish.
Workaround:
Cancel the installer. On your system, switch to the English (United States) locale and then
restart the installer.
On Windows XP systems, you can switch locales on your system by choosing Start | Control Panel
and double-clicking Regional and Language Options. Then select the locale from the
drop-down list in the Standards and Formats section of the dialog box.
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
