Installation Guide for Descriptor Systems' JPA Programming with Eclipse Luna and TomEE Plus 1.7.1

This document describes the setup for the Descriptor Systems' JPA Programming with Eclipse Luna and TomEE Plus 1.7.1 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 will 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. Windows XP: Create a folder in the root directory of drive C: named java. You will install some of the required software into this directory.

    Windows Vista or later: Login in with the same user name that the students will use, and note the user name here:

    
    Student user name: ____________________________________
          
          

    In the "home" directory for that user (e.g. c:\Users\username, create a folder named java. You will install some of the required software into this directory.

  2. Download the Java 7 Java Development Kit from:

    http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html

    Get the Windows 64-bit version. The file name should be something like jdk-7u60-windows-x64.exe (the number after 'jdk-' may be different).

    Install the JDK using all of the defaults.

  3. To test the Java runtime installation, choose Start - Run, then enter cmd and press OK. In the new command prompt window, enter:

    java -fullversion

    You should see the version number of the JDK that you installed.

  4. Download the Eclipse IDE For Java EE Developers for Windows from:

    https://www.eclipse.org/downloads/packages/release/luna/sr2 .

    Warning: Be sure to download the IDE for Java EE Developers, not the IDE for just Java Developers.

    The file name should be something like eclipse-java-luna-SR2-win32-x86_64.zip.

    Windows XP: Unzip the archive to the c:\java directory. You should end up with a subdirectory named c:\java\eclipse.

    Windows Vista or later: Unzip the archive to the c:\Users\username\java directory. You should end up with a subdirectory named c:\Users\username\java\eclipse.

  5. To test the Eclipse installation, use Windows Explorer or My Computer to navigate to the c:\java\eclipse or c:\Users\username\java\eclipse directory and double-click eclipse.exe. Eclipse should start.

  6. Download TomEE Plus version 1.7.1 from:

    http://tomee.apache.org/download/tomee-1.7.1.html

    Download the Plus zip file.

    The file name should be apache-tomee-1.7.1-plus.zip.

    Windows XP: Unzip the archive to the c:\java directory. You should end up with a subdirectory named c:\java\apache-tomee-plus-1.7.1.

    Windows Vista or later: Unzip the archive to the c:\users\username\java directory. You should end up with a subdirectory named c:\users\username\java\apache-tomee-plus-1.7.1.

  7. Download the Student Exercise Archive from http://www.descriptor.com/setupguides/jpa-standalone/eclipse-luna-tomeeplus1.7.1/jpaclass.zip.

    Windows XP: Unzip the archive to the root directory on Drive C:. You should end up with a subdirectory named c:\jpaclass.

    Windows Vista or later: Unzip the archive to the user's home directory. You should end up with a subdirectory named c:\users\username\jpaclass.

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 Instructor Display Materials from http://www.descriptor.com/setupguides/jpa-standalone/jpaclass-screenshow.zip.

    Windows XP: Unzip the archive to the root directory on Drive C:. You should end up with subdirectories named c:\jpaclass\courseware.

    Windows Vista or later: Unzip the archive to the user's home directory. You should end up with subdirectories named c:\users\username\jpaclass\courseware.

  4. Start the Courseware Viewer by choosing Start - Descriptor Systems - Courseware Viewer. In the Viewer, choose File - Open and open:

    c:\jpaclass\courseware\jpaclass.crs

    or

    c:\users\username\jpaclass\courseware\jpaclass.crs

    You should see the screen show for the workshop.