Java EE 5 Tools Bundle Update 7 Installation Instructions

Java EE 5 Tools Bundle Update 7 Installation Instructions


This document describes how to install the Java EE 5 Tools Bundle Update 7 software on your system. For information about supported operating systems and hardware configurations for the IDE, see the NetBeans IDE 6.7.1 Release Notes.

Contents

Required Software


Before you install the Java Tools Bundle software, the Java SE Development Kit (JDK) 5.0 Update 19 or JDK 6 Update 14 or newer, must be installed on your system. If you do not have an installation of JDK 5.0 Update 19 or newer, you cannot proceed with the installation. For more information about the required JDK version, see the Required Software section in the NetBeans IDE 6.7.1 Release Notes.

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.7.1 Release Notes.

To install the software:

  1. 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>
    • For Macintosh, the downloaded file has the .dmg extension. Double-click the .dmg file to mount the files then double-click the .mpkgto run the installer.
  2. At the Welcome page of the installation wizard, do one of the following:
    • Click Next to install all the components included in this download.
    • Click Customize to choose the components to install.
      In the Customize Installation dialog box, make your selection, click OK to close this dialog box, and then click Next at the Welcome wizard page.
  3. At the License agreement page, review the license agreement, select the acceptance check box, and click Next.
  4. 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, specify the path to an installed JDK, or cancel the installation and install the required JDK version and restart this installation.
    3. Click Next.
  5. If the installation page for the Sun GlassFish Enterprise Server (hereafter, Application Server) opens, do the following:
    1. Accept the default installation directory for the Application Server or specify another installation directory.
      Note: The installation directory you specify must be empty and not have spaces in the directory path on Mac OS X, Solaris, and Linux systems or execution errors will occur. Also note that the user profile running the installer must have read/write permissions for the installation directory.
    2. Select the JDK you want the Application Server to use from the list of compatible installations or use the Browse button to specify another JDK installation.
    3. 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.
    4. Accept the default port values (HTTP, HTTPS, and Admin) for the Application Server or change them if necessary.
    5. Click Next.
  6. 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.
  7. Click Install to begin the installation.
  8. When the installation is complete, you can choose to register the installed products and contribute anonymous usage data.
  9. Click Finish to exit the wizard.
  10. If you selected the Register... check box in 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.

Note: If you did not register the Application Server right after installation, you can do it when you open the Admin console of the Application Server.

Note: If you did not register the NetBeans IDE right after installation, you can do it when you run the IDE.

Uninstalling the Software


Microsoft Windows

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

To uninstall the IDE:

  1. Shut down the IDE.
  2. From the Control Panel, select Add or Remove Programs, then select NetBeans IDE 6.7.1 and click Remove.

To uninstall the Application Server:

  1. Shut down the IDE.
  2. From the Control Panel, select Add or Remove Programs, then select GlassFish Enterprise Server v2.1 and click Remove.

Solaris OS, Linux, and Mac OS X

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

To uninstall the IDE:

  1. Shut down the IDE.
  2. In the IDE installation directory, run the following uninstaller file:
    • For Solaris and Linux, the uninstaller file is uninstall.sh.
    • For Macintosh, the uninstaller file is uninstall.command.
      To locate the uninstall.command file for the IDE, click the Finder icon in the Dock. In the Applications section of a Finder window, right-click the NetBeans icon and choose Show Package Contents. By default, the IDE is installed to /Applications/NetBeans/NetBeans 6.7.1
  3. At the Summary page, click Uninstall.
  4. After the uninstall completes, click Finish.

To uninstall the Application Server:

  1. Shut down the IDE.
  2. 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.

    Platform Installing As... Tools Bundle Installation
    Solaris OS
    root /opt/SUNWappserver
    Solaris OS
    Linux
    user ~/SUNWappserver
    Linux root /usr/local/SUNWappserver
    Mac OS X root /Applications/SUNWappserver
    Mac OS X user ~/SUNWappserver

  3. In the Application Server installation directory, run the uninstaller file:
    • For Solaris and Linux, the uninstaller file is uninstall.sh.
    • For Macintosh, the uninstaller file is uninstall.command.
      To locate the uninstall.command file for the Application Server, click the Finder icon in the Dock. In the Applications section of a Finder window, double-click the SUNWappserver directory or the Application Server installation directory.
  4. At the Summary page, click Uninstall.
  5. After the uninstall completes, click Finish.

Upgrading from the Previous Version


To upgrade from Java EE 5 Tools Bundle Update 6 to Update 7, perform the following steps:

  1. Uninstall the Java EE 5 Tools Bundle Update 6 version from your system.
    Note that the uninstall procedure for the previous release is similar to that for the current release. For details, see Uninstalling the Software.
  2. Run the installer and install the software as described in Installing the Software.

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.

To clean up the system:

  1. Delete the installer working directory.
  2. Delete the installation directories of the IDE and the Application Server.
  3. 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

Installation on Mac OS

The installation might fail if the Application Server was previously installed using the NetBeans installer on a Mac machine. To work around make sure your user has write access to the .asadminpass and .asadmintruststore files that might exist in your user home directory.

Registering the Application Server

If you have not registered the Application Server right after installation, you can do it through the Admin Console at any time.

To register the Application Server:

  1. Run the NetBeans IDE.
  2. On the Services tab, expand the Servers node, right-click the GlassFish v2.1 node, and choose Start from the pop-up menu.
  3. After the Server starts, which is marked by a green triangle, right-click GlassFish v2.1 and choose View Admin Console.
  4. In a browser window that opens, log in using the username and password that you provided during installation. The default username and password are admin/adminadmin.
  5. Click Registration on the left and follow further instructions.

Java 8 banner (182)