Installation Guide for the Descriptor Systems Programming Enterprise JavaBeans (EJB3) for Eclipse/JBoss5 Workshop

This document describes the setup for the Descriptor Systems Programming Enterprise JavaBeans (EJB3) for Eclipse/JBoss5 Workshop

Important: Please print this document and as you install the software, mark up the document with the actual directory paths where you installed the software. Then leave a copy of the marked-up document for the instructor.

With the exception of the operating system, all of the required software is available at no charge for download (some packages may require you to register on a website).

If you have questions or difficulties with the installation, you can contact Joel Barnum at 319-362-3906 or email at .

Hardware Requirements - Student computers

Hardware Requirements - Instructor computer

Instructor machine hardware is the same as students, plus any additional requirements listed below.

Software Requirements - Student computers

Software Requirements - Instructor computer

Instructor machine software is the same as students, plus any additional requirements listed below.

Setup Instructions - Student computers

  1. Create a folder in the root directory of drive C: named java. You will install the required software into this directory.

  2. Download JDK 5.0 Update 17 (or other later version) for Windows from http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase5-419410.html . The filename should be jdk-1_5_0_17-windows-i586-p.exe. Warning: Be sure to download the JDK, not the JRE.

    Run the EXE to install, accepting all of the defaults EXCEPT change the installation directory to C:\Java\jdk1.5.0_17.

    You should end up with a directory named c:\java\jdk1.5.0_017.

  3. Download JBoss 5.0.0 GA from http://www.jboss.org/jbossas/downloads . The filename should be jboss-5.0.0.GA.zip. Do NOT download the jdk6 version.

    To install, unzip to the c:\java folder.

    You should end up with a directory named c:\java\jboss-5.0.0.GA.

  4. Download Eclipse Helios SR2 IDE for JEE Developers for Windows from http://www.eclipse.org/downloads/packages/release/helios/sr2 .

    Be sure to get the IDE for Java EE Developers, not the IDE for Java Developers. Also, download the 64-bit version of Eclipse if your operating system is a 64-bit OS.

    The filename should be eclipse-jee-helios-SR2-win32.zip (32-bit) or eclipse-jee-helios-SR2-win32-x86_64.zip (64-bit).

    To install, unzip to the c:\java folder.

    You should end up with a directory named c:\java\eclipse.

  5. Set Windows environment variables:

    1. Open the Windows Control Panel and click on System.
    2. In the System Properties, click on the Advanced tab then press the Environment Variables button.
    3. Find the PATH variable in the System variables category, highlight it and click the Edit button. Add C:\java\jdk1.5.0_17\jre\bin; to the FRONT of the existing text. Be sure to include the semicolon at the end of the added text (after bin). Please ensure that the directory matches where you actually installed the JDK in an earlier step.
    4. Add a new User environment variable named JAVA_HOME with a value of C:\java\jdk1.5.0_17\jre. Please ensure that the directory matches where you actually installed the JDK in an earlier step.
    5. Add a new User environment variable named JBOSS_HOME with a value of c:\java\jboss-5.0.0.GA. Please ensure that the directory matches where you actually installed JBoss in an earlier step.

  6. Test the JDK installation. Open a command-prompt window by choosing Run from the Windows Start menu and entering cmd.

    In the command-prompt window, enter the following: 

    java -fullversion

    You should see the version number of the JDK. If you don't see the version number, close the command-prompt window and recheck the PATH environment variable and test again.

  7. Test JBoss by using Windows Explorer to navigate to the c:\java\jboss-5.0.0.GA\bin folder and double-clicking the run.bat file. A command-prompt window should appear. Wait for a few moments until no more output shows up in the command-prompt window.

    Then open Internet Explorer and browse to http://localhost:8080 - you should see a JBoss Web page.

    You can close the command-prompt window.

  8. Test Eclipse by using Windows Explorer to navigate to the c:\java\eclipse folder and double-clicking on eclipse.exe. Eclipse should start and ask for a "workspace folder" - just press OK and wait for the Eclipse startup to complete.

    You can then close Eclipse.

  9. Download the Student Exercise Archive from http://www.descriptor.com/setupguides/ejb3/setup/eclipseganymede-jboss5/j2eeclass.zip. Unzip the archive to the root directory on Drive C:. You should end up with a subdirectory named c:\j2eeclass.

Setup Instructions - Instructor computers

  1. Repeat the Student software setup on the instructor machine.

  2. Download and install the Courseware Viewer program.

    Download the Viewer installation program from: http://www.descriptor.com/viewer/binaries/setup.exe

    Run the installation program, accepting all defaults.

  3. Download the presentation materials from http://www.descriptor.com/setupguides/ejb3/setup/j2eeclass-screenshow.zip

    Unzip this archive to the root directory on the same drive where you installed the Student Exercise Archive. You should end up with a subdirectory like c:\j2eeclass\courseware.

  4. Test the Courseware Viewer. From the Windows Start menu, choose Descriptor Systems - Courseware Viewer. Then use the File - Open menu to open the c:\j2eeclass\courseware\j2eeclass.crs file. You should see the screen show.