This document describes the setup for the Installation Guide for Descriptor Systems Spring and Hibernate/JPA Programming for Juno/JBoss 7.1.1.Final course.
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 jbarnum@descriptor.com. or 319-362-3906.
Instructor machine hardware is the same as students, plus any additional requirements listed below.
Instructor machine software is the same as students, plus any additional requirements listed below.
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.
Download the Java SE 6 JDK for Windows x86 from:
http://java.sun.com/javase/downloads/index.jsp
Warning: Be sure to download the JDK, not the JRE or a JDK "bundle". Also be sure to get Java SE 6, not Java SE 7.
The file name should be something like jdk-6u45-windows-i586.exe.
Install the JDK using all of the defaults.
Look in the c:\Program Files\Java folder to see the JDK installation directory and write it down here:
JDK Installation Directory: _________________________________________________________
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.
Next, ensure that Java JAR files have the proper file association for Windows Explorer. Choose Start - Run then enter cmd.
VERY CAREFULLY, enter the following into the command prompt, substituting the JDK Installation Directory noted above:
ftype jarfile="C:\Program Files\Java\**** JDK INSTALL DIR ****\bin\javaw.exe" -jar "%1" %*
To test, start Windows Explorer (or My Computer) than
Download the Eclipse IDE For Java EE Developers for Windows from:
http://www.eclipse.org/downloads/ .
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-jee-juno-SR2-win32.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.
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.
Download JBoss 7.1.1.Final from:
https://www.jboss.org/jbossas/downloads
Find the JBoss 7.1.1.Final "AS Certified Java EE 6 Full Profile" and click the ZIP link.
The file name should be jboss-as-7.1.1.Final.zip.
Windows XP: Unzip the archive to the c:\java directory. You should end up with a subdirectory named C:\java\jboss-as-7.1.1.Final.
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\jboss-as-7.1.1.Final.
To test the JBoss installation, use Windows Explorer to navigate to either C:\java\jboss-as-7.1.1.Final\bin or c:\Users\username\java\jboss-as-7.1.1.Final\bin. Double-click on the standalone.bat file - JBoss should open a command-prompt window and start up, eventually displaying a message containing the text "JBoss AS 7.1.1.Final "Brontes" started".
You can close the JBoss command-prompt window when you are finished testing.
Next, ensure that Java JAR files have the proper file association for Windows Explorer. Choose Start - Run then enter cmd.
VERY CAREFULLY, enter the following into the command prompt, substituting the JDK Installation Directory noted above:
ftype jarfile="C:\Program Files\Java\**** JDK INSTALL DIR ****\bin\javaw.exe" -jar "%1" %*
For example, the command might look like:
ftype jarfile="c:\Program Files\Java\jdk1.6.0_31\bin\javaw.exe" -jar "%1" %*
To test, start Windows Explorer (or My Computer) than navigate to:
C:\java\jboss-as-7.1.1.Final\modules\com\h2database\h2\main
Double-click on the h2-1.3.161.jar entry, then wait a couple of seconds - a Web browser window should start showing an H2 Database Login Console. If you see this window, then the file association is correct and you can close the Web browser.
Download the Student Labs Archive from http://www.descriptor.com/setupguides/spring-hibernate/setup/eclipse-juno-jboss7.1.1.Final/springclass.zip
Unzip springclass.zip to the root directory of drive C. You should end up with a subdirectory named c:\springclass.
Repeat the Student setup instructions on the Instruction machine.
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.
Download the presentation materials from http://www.descriptor.com/setupguides/spring-hibernate/setup/springclass-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:\springclass\courseware or c:\Users\username\springclass\courseware.
Test the Courseware Viewer. From the Windows Start menu, choose Descriptor Systems - Courseware Viewer. Then use the File - Open menu to open the c:\springclass\courseware\springclass.crs file. You should see the screen show.