Required Software

The following software is required to run the examples.

Java Platform, Standard Edition

To build, deploy, and run the examples, you need a copy of the Java Platform, Standard Edition 6.0 Software Development Kit (JDK 6). You can download the JDK 6 software from http://java.sun.com/javase/downloads/.

Download the current JDK update that does not include any other software (such as NetBeans or Java EE).

Java EE 6 Software Development Kit (SDK)

Sun GlassFish Enterprise Server v3 Preview is targeted as the build and runtime environment for the tutorial examples. To build, deploy, and run the examples, you need a copy of the Enterprise Server and, optionally, NetBeans IDE. To obtain the Enterprise Server, you must install the Java EE 6 Software Development Kit (SDK), which you can download from http://java.sun.com/javaee/downloads/preview/.

Scroll down to the section entitled Download the Components Independently and click the Download link next to Sun GlassFish Enterprise Server v3 Preview.

Refer to the Java EE Tutorial Compatibility Wiki page for information about the versions of the Enterprise Server with which the tutorial examples have been tested.

SDK Installation Tips

During the installation of the SDK:

  • Configure the Enterprise Server administration username and password as anonymous. This is the default setting.

  • Accept the default port values for the Admin Port (4848) and the HTTP Port (8080).

  • Allow the installer to download and configure the Update Tool. If you access the Internet through a firewall, provide the proxy host and port.

This tutorial refers to the directory where you install the Enterprise Server as as-install. For example, the default installation directory on Microsoft Windows is C:\glassfishv3, so as-install is C:\glassfishv3.

After you install the Enterprise Server, add the following directories to your PATH to avoid having to specify the full path when you use commands:

as-install/bin
as-install/glassfish/bin

Apache Ant

Ant is a Java technology-based build tool developed by the Apache Software Foundation (http://ant.apache.org/), and is used to build, package, and deploy the tutorial examples. To run the tutorial examples, you need Ant v1.7.1. If you do not already have Ant v1.7.1, you can install it from the Update Tool that is part of the Enterprise Server.

To Obtain Apache Ant

  1. Start the Update Tool.

    • From the command line, type the command updatetool.

    • On a Windows system, select the following:

      Start → All Programs → Java EE 6 SDK Preview→ Start Update Tool

  2. Expand the Sun GlassFish Enterprise Server v3 Preview node.

  3. Select the Available Add-ons node.

  4. From the list, select the Apache Ant Build Tool checkbox.

  5. Click Install.

  6. Accept the license agreement.

    After installation, Apache Ant appears in the list of installed components. The tool is installed in the as-install/ant directory.

Next Steps

To use the ant command, add as-install/ant/bin to your PATH environment variable.

Java EE 6 Tutorial Component

The tutorial example source is contained in the tutorial component. To obtain the tutorial component, use the Update Tool.

To Obtain the Tutorial Component

  1. Start the Update Tool.

    • From the command line, type the command updatetool.

    • On a Windows system, select the following:

      Start → All Programs → Java EE 6 SDK Preview→ Start Update Tool

  2. Expand the Sun GlassFish Enterprise Server v3 Preview node.

  3. Select the Available Updates node.

  4. From the list, select the Java EE 6 Tutorial checkbox.

  5. Click Install.

  6. Accept the license agreement.

    After installation, the Java EE 6 Tutorial appears in the list of installed components. The tool is installed in the as-install/glassfish/docs/javaee-tutorial directory. This directory contains two subdirectories, docs and examples. The examples directory contains subdirectories for each of the technologies discussed in the tutorial.

NetBeans IDE

The NetBeans integrated development environment (IDE) is a free, open-source IDE for developing Java applications, including enterprise applications. NetBeans IDE supports the Java EE platform. You can build, package, deploy, and run the tutorial examples from within NetBeans IDE.

To run the tutorial examples, you need NetBeans IDE version 6.7. You can download NetBeans IDE from http://www.netbeans.org/downloads/index.html.

Refer to the Java EE Tutorial Compatibility Wiki page for information about the versions of NetBeans IDE with which the tutorial examples have been tested.

Enabling Enterprise Server v3 Preview Support in NetBeans IDE 6.7

Once you have NetBeans IDE, you must configure it to support Sun GlassFish Enterprise Server v3 Preview.

  1. In NetBeans IDE, select Tools → Plugins.

  2. In the Available Plugins tab, select GlassFish v3 Enabler and click Install.

  3. Click Next.

  4. Select the License Agreement accept checkbox and click Install.

  5. After the plugins are installed, click Finish.

  6. Restart NetBeans IDE.

To Add Enterprise Server as a Server in NetBeans IDE

To run the tutorial examples in NetBeans IDE, you must register your Enterprise Server installation as a NetBeans Server Instance. Follow these instructions to register the Enterprise Server in NetBeans IDE.

  1. Select Tools → Servers to open the Servers dialog.

  2. Click Add Server.

  3. Under Server, select GlassFish v3 and click Next.

  4. Under Server Location, enter the location of your Enterprise Server installation and click Next.

  5. Select Register Local Default Domain.

  6. Click Finish.