Required Software
The following software is required to run the examples.
Tutorial Bundle
The tutorial example source is contained in the tutorial bundle. To obtain the tutorial bundle, go to http://java.sun.com/javaee/5/docs/tutorial/information/download.html. The tutorial bundle is a zip file that you can unzip in a location of your choice.
After you have installed the tutorial bundle, the example source code is in the tut-install/javaeetutorial5/examples/ directory, where tut-install is the directory where you installed the tutorial. The examples directory contains subdirectories for each of the technologies discussed in the tutorial.
Java Platform, Standard Edition
To build, deploy, and run the examples, you need a copy of Java Platform, Standard Edition 5.0 or Java Platform, Standard Edition 6.0 (J2SE 5.0 or JDK 6). You can download the J2SE 5.0 software from http://java.sun.com/javase/downloads/index_jdk5.jsp. 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).
Sun Java System Application Server 9.1
Sun Java System Application Server 9.1 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 Application Server and, optionally, NetBeans IDE. You can download the Application Server from http://java.sun.com/javaee/downloads/.
Scroll down to the section entitled Download the Components Independently and click the Download link next to Sun Java System Application Server 9.1 (based on GlassFish V2).
Note - You can also run the tutorial examples using Sun Java System Application Server 9.0, or using GlassFish V2.
Application Server Installation Tips
During the installation of the Application Server:
Accept the default admin user name, and specify a password. The default user name is admin. Remember the password you specify (for example, adminadmin). You will need this user name and password.
Select the Don't Prompt for Admin User Name and Password radio button.
Note the HTTP port at which the server is installed. This tutorial assumes that you are accepting the default port of 8080. If 8080 is in use during installation and the installer chooses another port or if you decide to change it yourself, you will need to update the common build properties file (described in the next section) and the configuration files for some of the tutorial examples to reflect the correct port.
This tutorial refers to the directory where you install the Application Server as as-install. For example, the default installation directory on Microsoft Windows is C:\Sun\AppServer, so as-install is C:\Sun\AppServer.
After you install the Application 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/lib/ant/bin
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 5 platform. You can build, package, deploy, and run the tutorial examples from within NetBeans IDE.
You can download NetBeans IDE from http://www.netbeans.org/.
The current version of NetBeans IDE is 5.5.1. Along with the IDE, you will need to install Hotfixes needed for Java EE components.
To install the NetBeans IDE 5.5.1 Hotfixes, perform these steps:
Download and install NetBeans IDE 5.5.1 FCS, then start the IDE.
In NetBeans IDE, Select Tools → Update Center.
The Update Center Wizard opens.
Select the Check the Web for Available Updates and New Modules radio button.
In the Select Update Center(s) to connect panel, select Netbeans Hotfix Update Center.
If necessary, click the Proxy Configuration button and configure the proxy settings to allow you to connect to the Update Center.
Click Next to connect to the Update Center server.
In the Available Updates and New Modules panel, select NetBeans Hotfix Update Center and click Add.
Two modules appear in the Include in Install panel.
Click Next.
Read and accept the License Agreement.
The modules you selected are downloaded and the digital signatures are checked and verified.
Click Next.
Click Finish.
In the Restart the IDE dialog, click OK.
The IDE must be restarted to install the modules.
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. Ant is included with the Application Server. To use the ant command, add as-install/lib/ant/bin to your PATH environment variable.