Java EE 5 Tools Bundle Installation Instructions

This document provides installation instructions for the Java Platform, Enterprise Edition 5 (Java EE 5) Tools Bundle. The Java EE 5 Tools Bundle includes NetBeans IDE 5.5 (hereinafter referred to as IDE), NetBeans Enterprise Pack 5.5, and to "Java Platform, Enterprise Edition 5 SDK Update 1 or Update 2 (Java EE 5 SDK Update 1 or Update 2, hereinafter referred to as SDK). The NetBeans Enterprise Pack 5.5 includes XML schema tools modules, BPEL modules, Secure Web Services modules, Project Open ESB Starter Kit, Sun Java System Access Manager 7.1, and Sun Java System Policy Agent 2.2 for Sun Web Services.

Note: The UML functionality is no longer available in the final (FCS) release of the NetBeans Enterprise Pack 5.5 download. Instead, the UML functionality is offered separately on the Auto Update Center.

Prerequisites

This topic specifies the prerequisites that must be met before you start to install the Java EE 5 Tools Bundle.

Required Software

The following software must be installed before you attempt to install the Java EE 5 Tools Bundle:

• JDK 5.0 Update 9 (version 1.5.0_09; hereinafter referred to as JDK) or higher must be installed on your system. If you do not have an installation of a JDK version 5.0 Update 1 or higher, you cannot proceed with the installation.

  Note: For Mac OS X, at least JDK 5.0 release 3 is required.

Firewall Applications

Enabled firewall applications can prevent some components from being configured correctly during the installation process. Disable any firewall applications before you start the installation.

Configuration Information

This topic provides configuration information that you may need in order to configure the software.

Sun Java System Application Server

The default username and password values for the default Application Server domain, domain1, are as follows:

username: admin

password: adminadmin

Sun Java System Access Manager

If you need to access the administration console for the Access Manager server, use the following values:

username: amadmin

password: admin123

Installing the Software: Microsoft Windows

This section contains instructions for installing the Java EE 5 Tools Bundle on the Microsoft Windows platform.

Before You Start

The following restriction applies to installation on the Microsoft Windows platform:

• The installer first extracts the required files to the default temporary space directory defined by the TEMP environment variable. If the amount of disk space in the temporary directory is less than required, the installation might fail or proceed incorrectly.

  If you encounter this problem, you can increase the space allocated for the TEMP environment variable or specify a different temporary directory that has sufficient space. To specify a temporary directory for the installation, use the following commands from a command window:

  Copy

  
  
  > cd  /d location-of-installer
  > java-tools-bundle-windows.exe  -is:tempdir  temporary-directory
  

To Install

1. When you have downloaded the installer file, java-tools-bundle-windows.exe , double-click the installer's icon to launch the installer.
2. At the Welcome page of the installation wizard, click Next.
3. Respond to the license agreement and click Next.

   The JDK installation directory selection page of the wizard opens.

4. From the list of compatible installations choose the JDK you want the IDE and SDK to use, then click Next.

   You can also type the path to another installed JDK or use the Browse button to navigate to and select another installation.

   Note: The wizard automatically highlights the most recent installation available on your machine.

5. At the NetBeans IDE and Enterprise Pack installation directory page of the installation wizard, accept the default installation directory or specify a different, empty installation directory. Then click Next.

   Note: You can also specify a non-existing directory. The installation wizard will create the directory during the installation.

6. Select the Java EE Tools Bundle components you want to install, click Next.

   Note: Clear the BPEL and Secure Web Services checkboxes if you do not intend to use these modules. This enables the Skip Application Server configuration radio button in the following step and speeds up the installation process.

   Note: Make sure you observe the dependencies listed in the table below when selecting the components for your installation.

   Required Component Name	Dependent Component Name
   NetBeans IDE 5.5	Each of the Netbeans Enterprise Pack 5.5 components: XML BPEL Secure Web Services
   XML component of the NetBeans Enterprise Pack 5.5	BPEL component of the NetBeans Enterprise Pack 5.5
   Java Platform, Enterprise Edition 5 SDK	The following of the NetBeans Enterprise Pack 5.5 components: BPEL Secure Web Services

7. Do one of the following:
   • To install the bundled Java EE SDK, follow the instructions in To Continue the Installation With the Bundled Java EE SDK.
   • If you have a preinstalled Sun Java System Application Server Platform Edition 9 or a preinstalled Application Server from Project GlassFish, follow the instructions in To Continue the Installation With a Preinstalled Application Server.

To Continue the Installation With the Bundled Java EE SDK

1. At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Install the bundled Application Server radio button, and click Next.
2. At the IDE and SDK installation directory page of the installation wizard, accept the default installation directory, specify a different, empty installation directory, or use the Browse button to navigate to and select another installation directory. Then click Next.
3. Define the username and password for the default Application Server domain, domain1, or accept the defaults and click Next.

   The default username and password are admin and adminadmin.

4. Verify the port values ( Admin, HTTP, and HTTPS) for the default Application Server and change them if necessary. Then click Next.
5. Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.
6. Click Install to begin the installation.
7. When the installation is complete, click Finish to exit the wizard.

To Continue the Installation With a Preinstalled Application Server

1. At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Use an Existing Installation radio button, and click Next.
2. At the Application Server installation directory page of the installation wizard, choose the Application Server you want the IDE to use, or define a custom location. Then click Next.
3. If the default domain, domain1, exists in the selected Application Server, enter the username and password for the default Application Server domain and click Next.

   The installation wizard verifies the username and password information you entered.

   Note: The verification process may take some time.

   -or-

   If the default domain, domain1, does not exist in the selected Application Server, do the following:

   1. Define the username and password for the default Application Server domain, domain1, or accept the defaults and click Next.
      The default username and password are admin and adminadmin.
   2. Verify the port values ( Admin, HTTP, and HTTPS) for the Application Server and change them if necessary. Then click Next.
4. Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.
5. Click Install to begin the installation.
6. When the installation is complete, click Finish to exit the wizard.

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

Installing the Software: Solaris OS, Linux

Following are instructions for installing the Java EE 5 Tools Bundle on the Solaris OS and Linux platforms.

In the instructions below, replace your_binary_executable with one of the following:

• Linux: java-tools-bundle-linux.sh
• Solaris™ OS, SPARC®: java-tools-bundle-solaris-sparc.sh
• Solaris™ OS, x86/x64 Platform Edition: java-tools-bundle-solaris-x86.sh

To Install

1. When you have downloaded the installer file, your_binary_executable , navigate to the directory that contains the file.
2. At the Welcome page of the installation wizard, click Next.
3. Respond to the license agreement and click Next.
   The JDK installation directory selection page of the wizard opens.
4. From the list of compatible installations choose the JDK you want the IDE and SDK to use, then click Next.

   You can also type the path to another installed JDK or use the Browse button to navigate to and select another installation.

   Note: The wizard automatically highlights the most recent installation available on your machine.

5. At the NetBeans IDE and Enterprise Pack installation directory page of the installation wizard, accept the default installation directory or specify a different, empty installation directory. Then click Next.

   Note: You can also specify a non-existing directory. The installation wizard will create the directory during the installation.

6. Select the Java EE Tools Bundle components you want to install, click Next.

   Note: Clear the BPEL and Secure Web Services checkboxes if you do not intend to use these modules. This enables the Skip Application Server configuration radio button in the following step and speeds up the installation process.

   Note: Make sure you observe the dependencies listed in the table below when selecting the components for your installation.

   Required Component Name	Dependent Component Name
   NetBeans IDE 5.5	Each of the Netbeans Enterprise Pack 5.5 components: XML BPEL Secure Web Services
   XML component of the NetBeans Enterprise Pack 5.5	BPEL component of the NetBeans Enterprise Pack 5.5
   Java Platform, Enterprise Edition 5 SDK	The following of the NetBeans Enterprise Pack 5.5 components: BPEL Secure Web Services

7. Do one of the following:
   • To install the bundled Java EE SDK, follow the instructions in To Continue the Installation With the Bundled Java EE SDK.
   • If you have a preinstalled Sun Java System Application Server Platform Edition 9 or a preinstalled Application Server from Project GlassFish, follow the instructions in To Continue the Installation With a Preinstalled Application Server.

To Continue the Installation With the Bundled Java EE SDK

1. At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Install the bundled Application Server radio button, and click Next.
2. At the IDE and SDK installation directory page of the installation wizard, accept the default installation directory, specify a different, empty installation directory, or use the Browse button to navigate to and select another installation directory. Then click Next.
3. Define the username and password for the default Application Server domain, domain1, or accept the defaults and click Next.

   The default username and password are admin and adminadmin.

4. Verify the port values ( Admin, HTTP, and HTTPS) for the Application Server and change them if necessary. Then click Next.
5. Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.
6. Click Install to begin the installation.
7. When the installation is complete, click Finish to exit the wizard.

To Continue the Installation With a Preinstalled Application Server

1. At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Use an Existing Installation radio button, and click Next.
2. At the Application Server installation directory page of the installation wizard, choose the Application Server you want the IDE to use, or define a custom location. Then click Next.
3. If the default domain, domain1, exists in the selected Application Server, enter the username and password for the default Application Server domain and click Next.

   The installation wizard verifies the username and password information you entered.

   Note: The verification process may take some time.

   -or-

   If the default domain, domain1, does not exist in the selected Application Server, do the following:

   1. Define the username and password for the default Application Server domain, domain1, or accept the defaults and click Next.

      The default username and password are admin and adminadmin.

   2. Verify the port values ( Admin, HTTP, and HTTPS) for the Application Server and change them if necessary. Then click Next.
4. Verify that the installation location is correct and that you have adequate space on your system for the installation.
5. Click Install to begin the installation.
6. When the installation is complete, click Finish to exit the wizard.

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

Installing the Software: Mac OS X

Following are instructions for installing the Java EE 5 Tools Bundle on the Mac OS X platform.

Before You Start

The following restrictions apply to the installation on the Mac OS X platform:

• To ensure correct operation of the installer and uninstaller, you must configure Java to use JDK 5.0: In the Finder window, go to Applications | Utilities | Java | J2SE5.0 and open the Java Preferences utility. In the Java Application Runtime Settings section, move J2SE5.0 to the top of the list.
• To allow the operating system to correctly recognize the Java EE 5 Tools Bundle components, the installation directory must end with the string .app.

To Install

1. When you have downloaded the installer file, java-tools-bundle-macosx.jar, navigate to the directory that contains the file and double-click the installer's icon to launch the installer.

   Note: If the default java version on your system is 1.4, you will not be able to double-click the .jar file to start the installation. In this case, run the .jar file manually from the command line using java 1.5.

2. At the Welcome page of the installation wizard, click Next.
3. Respond to the license agreement and click Next.

   The JDK installation directory selection page of the wizard opens.

4. From the list of compatible installations choose the JDK you want the IDE and SDK to use, then click Next.

   You can also type the path to another installed JDK or use the Browse button to navigate to and select another installation.

   Note: The wizard automatically highlights the most recent installation available on your machine.

5. At the NetBeans IDE and Enterprise Pack installation directory page of the installation wizard accept the default installation directory or specify a different, empty installation directory. Then click Next.

   Note: You can also specify a non-existing directory. The installation wizard will create the directory during the installation.

6. Select the Java EE Tools Bundle components you want to install, click Next.

   Note: Clear the BPEL and Secure Web Services checkboxes if you do not intend to use these modules. This enables the Skip Application Server configuration radio button in the following step and speeds up the installation process.

   Note: Make sure you observe the dependencies listed in the table below when selecting the components for your installation.

   Required Component Name	Dependent Component Name
   NetBeans IDE 5.5	Each of the Netbeans Enterprise Pack 5.5 components: XML BPEL Secure Web Services
   XML component of the NetBeans Enterprise Pack 5.5	BPEL component of the NetBeans Enterprise Pack 5.5
   Java Platform, Enterprise Edition 5 SDK	The following of the NetBeans Enterprise Pack 5.5 components: BPEL Secure Web Services

7. Do one of the following:
   • To install the bundled Java EE SDK, follow the instructions in To Continue the Installation With the Bundled Java EE SDK.
   • If you have a preinstalled Sun Java System Application Server Platform Edition 9 or a preinstalled Application Server from Project GlassFish, follow the instructions in To Continue the Installation With a Preinstalled Application Server.

   • To Continue the Installation With the Bundled Java EE SDK

     1. At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Install the bundled Application Server radio button, and click Next.
     2. At the IDE and SDK installation directory page of the installation wizard, accept the default installation directory, specify a different, empty installation directory, or use the Browse button to navigate to and select another installation directory. Then click Next.
     3. Define the username and password for the default Application Server domain, domain1, or accept the defaults and click Next.

        The default username and password are admin and adminadmin.

     4. Verify the port values ( Admin, HTTP, and HTTPS) for the default Application Server domain and change them if necessary. Then click Next.
     5. Verify that the list of components to be installed is correct and that you have adequate space on your system for the installation.
     6. Click Install to begin the installation.
     7. When the installation is complete, click Finish to exit the wizard.

     To Continue the Installation With a Preinstalled Application Server

     1. At the NetBeans Enterprise Pack installation options page of the installation wizard, select the Use an Existing Installation radio button, and click Next.
     2. At the Application Server installation directory page of the installation wizard, choose the Application Server you want the IDE to use, or define a custom location. Then click Next.
     3. If the default domain, domain1, exists in the selected Application Server, enter the username and password for the default Application Server domain and click Next.

        The installation wizard verifies the username and password information you entered.

        Note: The verification process may take some time.

        -or-

        If the default domain, domain1, does not exist in the selected Application Server, do the following:

        1. Define the username and password for the default Application Server domain, domain1, or accept the defaults and click Next.

           The default username and password are admin and adminadmin.

        2. Verify the port values ( Admin, HTTP, and HTTPS) for the Application Server and change them if necessary. Then click Next.
     4. Verify that the installation location is correct and that you have adequate space on your system for the installation.
     5. Click Install to begin the installation.
     6. When the installation is complete, click Finish to exit the wizard.

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

     Uninstalling the Software

     If you installed the bundled Application Server, the uninstallation removes NetBeans Enterprise Pack 5.5, Sun Java System Application Server Platform Edition 9 Update 1, Project Open ESB Starter Kit, and Sun Java System Access Manager from your system. If you chose to use a preinstalled Application Server, the uninstallation removes NetBeans Enterprise Pack 5.5 from your system. In this case, to remove the Project Open ESB Starter Kit, you must uninstall the preinstalled Application Server.

     To Uninstall on Microsoft Windows

     1. Shut down the IDE.
     2. From the Control Panel, select Add or Remove Programs, then select Java EE 5 Tools Bundle and click Change/Remove.
     3. Follow the instructions in the uninstaller.

     To Uninstall on Solaris OS or Linux

     1. Shut down the IDE.
     2. Navigate to the bin/_uninst subdirectory of your Java EE 5 Tools Bundle installation directory.
     3. Execute the uninstall.sh script.

     To Uninstall on Mac OS X

     1. Shut down the IDE.
     2. Navigate to the bin/_uninst subdirectory of your Java EE 5 Tools Bundle installation directory.
     3. Execute the uninstall.jar executable file.

        Note: If the default java version on your system is 1.4, you will not be able to double-click the .jar file to start the uninstallation. In this case, run the .jar file manually from the command line using java 1.5.

     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.

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

     • Installer fails to start correctly with little or no free disk space in the temp directory.

       Description: On Microsoft Windows, if your system is set up to use a temporary directory on your C drive, and that temporary directory does not have enough space for the temporary files needed by the installer, the installer will report that there is not enough disk space on the C drive. This will occur even if you chose to install to a different drive. The installer is in fact reporting that it needs additional temporary space.

       The issue exists in the InstallShield framework.

       Workaround: Start the installer with the -is:tempdir custom-temp-dir command line parameter. The custom-temp-dir should contain at least 130 MB of free disk space.

     • NoClassDefFoundError: cannot access amserver occurs during installation.

       Description: If you try to install the software a second time without cleaning up the Access Manager directory, the configuration of Access Manager may fail during installation.

       Workaround:

       • On Microsoft Windows:

         Delete the directory specified in: %SystemDrive%\Documents and Settings\ user-name\AMConfig_server_amserver_ and then remove the file %SystemDrive%\Documents and Settings\ user-name\AMConfig_server_amserver_ .

       • On UNIX/Mac:

         Delete the directory specified in: $HOME\AMConfig_server_amserver_ and then remove the file $HOME\AMConfig_server_amserver_ .

     • Installer fails when using the -console and -silent options.

       Description: On UNIX platforms, if the installer cannot perform the installation process without the graphics mode, the installer suggests that you run the installer with the -console and -silent options. If you try this, the installer fails.

       Workaround: Ignore the message from the installer and set up the GUI environment as described below to proceed with the installation.

       The most common cause for this issue is that you are connecting to the target system via telnet/ssh/rlogin, which means you must redirect the GUI to the originating system. To do this successfully, the following two requirements must be met:

       1. An X server should be set up and running on the system from which you are connecting.
       2. The DISPLAY environment variable should be set to the correct value on the target system. Assuming a bash shell, the correct value and command for the variable are:

          export DISPLAY= machine-name: display-number

          Where machine-name is the IP address of the system from where you are connecting, and display-number is the number of the display, usually 0.0.

     • Installation fails after manual uninstallation.

       Description: If you try to install the product after performing a manual uninstallation by deleting files, the installation will fail because the data in InstallShield's VPD registry is not cleaned up.

       Workaround: Before starting a new installation, remove the InstallShield VPD registry. This registry resides in %SystemDrive%\Program Files\Common Files\InstallShield\Universal or in ~/InstallShield.

     • On Mac OS X, cannot launch installation by double-clicking .jar file.

       Description: If the default java version on your system is 1.4, you will not be able to double-click the .jar file to start the installation.

       Workaround: In this case, run the .jar file manually from the command line using java 1.5.

     • Installer exceptions when running on JRE 1.4.

       Description: On Microsoft Windows, if there is no preinstalled compatible JDK on the target machine, the InstallShield Windows launcher allows you to select a custom java.exe. After you select a custom java.exe the installer does not perform a validation for compatibility. This means that if you select a java.exe from a 1.4 JRE which is not compatible with the installer, you will encounter a number of exceptions. The issue exists in the InstallShield framework.

       Workaround: Select a java.exe from a 1.5 JRE.

     • Installer fails to start correctly on UNIX.

       Description: The installer fails to start correctly on UNIX when is there is little or no disk space in the root directory of the filesystem. The problem exists in the InstallShield framework. This issue was observed on machines with less than 2.5 MB free in the root of the filesystem.

       Workaround: Free up enough disk space in the root of the filesystem and restart the installer.