<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" 
   href="file://c:/source/xslt/xml-labs/setupguide.xsl"?>
<setupguide>

  <title>
    Installation Guide for Descriptor Systems Mastering JEE Development workshop
  </title>

  <description>
    <p>
      This document describes the setup for the
      Descriptor Systems Master JEE Development workshop.
    </p>
    <p>
      <b>Important:</b> 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.
    </p>
    
    <p>
      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).
    </p>

    <p>
      If you have questions or difficulties with the installation,
      you can contact Joel Barnum at 319-362-3906 or email at
      <literal><![CDATA[
<script language='javascript'>
<!--
var username = "joelbarnum";
var hostname = "descriptor.com";
var linktext = username + "@" + hostname;
document.write("<a href=" + "mail" + "to:" + username +
"@" + hostname + ">" + linktext + "</a>")
//-->
</script>]]>.      
      </literal>
    </p>
  </description>

  <hardware-requirements type="Student">
    <requirement>
      A Pentium 1Ghz processor
    </requirement>
    <requirement>
      500MB of free disk space for installation
    </requirement>
    <requirement>
      1GB memory minimum
    </requirement>
    <requirement>
      1024x768 display, 65536 colors
    </requirement>
    <requirement>
      Optional Internet connection
    </requirement>
  </hardware-requirements>

  <hardware-requirements type="Instructor" >
    <requirement>Projection unit, 800x600 resolution minimum</requirement>
    <requirement>Internet connection strongly recommended</requirement>
  </hardware-requirements>

  <software-requirements type="Student">
    <requirement>
      Microsoft Windows XP or better
    </requirement>

    <requirement>
      Microsoft Internet Explorer 6.0 or higher 
    </requirement>

    <requirement>
       Unzip utility such as 7-Zip from <a 
       href="http://www.7-zip.org/">http://www.7-zip.org</a>
    </requirement>

    <requirement>
      Java Standard Edition version 6
    </requirement>

    <requirement>
      Eclipse Indigo for JEE Developers
    </requirement>
    
    <requirement>
      JBoss 7.0.2
    </requirement>
    
    <requirement>
      Student Exercises Archive
    </requirement>

  </software-requirements>
    
  <software-requirements type="Instructor" >
    <requirement>Descriptor Systems Courseware Viewer (screen-show software)</requirement>
    <requirement>Instructor Display Materials </requirement>
  </software-requirements>

  <setup-instructions type="Student">
    <step>
      <p>
        <b>Windows XP:</b> Create a folder in the root directory of drive C: named <b>java</b>. You will
        install some of the required software into this directory.
      </p>
      <p>
        <b>Windows Vista or later:</b> 
        Login in with the same user name that the students will use, and note the
        user name here:
      </p>
      <pre>

Student user name: ____________________________________
      
      </pre>
      <p>
        In the "home" directory for that user (e.g. <b>c:\Users\username</b>,
        create a folder named <b>java</b>. You will
        install some of the required software into this directory.
      </p>
    </step>
    
    <step>
      <p>
        Download the Java SE 6 JDK for Windows x86 from:
      </p>
      <code>
        <a href="http://java.sun.com/javase/downloads/index.jsp">http://java.sun.com/javase/downloads/index.jsp</a>
      </code>
      <p><b>Warning</b>: 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.
      </p>
      <p>
        The file name should be something like <i>jdk-6u27-windows-i586.exe</i>.
      </p>
      <p>
        Install the JDK using all of the defaults.
      </p>
    </step>
    
    <step>
      <p>
        To test the Java runtime installation, choose Start - Run, then
        enter <i>cmd</i> and press OK. In the new command prompt window, enter:
      </p>
      <code>
        java -fullversion
      </code>
      <p>
        You should see the version number of the JDK that you
        installed.
      </p>
    </step>

    <step>
      <p>
        Download the Eclipse IDE For Java EE Developers for Windows (32-bit) from:
      </p>
      <p>
        <a href="http://www.eclipse.org/downloads/packages/release/indigo/sr2">
          http://www.eclipse.org/downloads/packages/release/indigo/sr2
        </a>.
      </p>
      <p>
        The file name should be something like <i>eclipse-jee-indigo-SR2-win32.zip</i>.
      </p>
      <p>
        <b>WARNING: </b>Be sure to download the Eclipse IDE for Java EE Developers, not
        Eclipse for Java Developers (doesn't support EE).
      </p>
      <p>
        <b>Windows XP:</b> Unzip the archive to the c:\java directory. You should end up
        with a subdirectory named <b>c:\java\eclipse</b>.
      </p>
      <p>
        <b>Windows Vista or later:</b> Unzip the archive to the <i>c:\Users\username\java</i> directory. You should end up
        with a subdirectory named <b>c:\Users\username\java\eclipse</b>.
      </p>
    </step>
    
    <step>
      <p>
        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 <b>eclipse.exe</b>.
        Eclipse should start.
      </p>
    </step>
    
    
    <step>
      <p>
        Download JBoss Application Server version 7.0.2 Final from:
      </p>
      <p>
        <a href="http://www.jboss.org/jbossas/downloads">
          http://www.jboss.org/jbossas/downloads
        </a>
      </p>
      <p>
        Download the <i>Everything (NOT Java EE6 Certified)</i> ZIP file. 
      </p>
      <p>
        The file name should be something like <i>jboss-as-7.0.2.Final.zip</i>.
      </p>
      <p>
        <b>Windows XP:</b> Unzip the archive to the c:\java directory. You should end up
        with a subdirectory named <b>C:\java\jboss-as-7.0.2.Final</b>.
      </p>
      <p>
        <b>Windows Vista or later:</b> Unzip the archive to the <i>c:\Users\username\java</i> directory. You should end up
        with a subdirectory named <b>c:\Users\username\java\jboss-as-7.0.2.Final</b>.
      </p>
    </step>
    
    <step>
      <p>
        To test the JBoss installation, use Windows Explorer to navigate to either
        C:\java\jboss-as-7.0.2.Final\bin or c:\Users\username\java\jboss-as-7.0.2.Final\bin.
        Double-click on the <i>standalone.bat</i> file - JBoss should open a command-prompt
        window and start up, eventually displaying a message containing the text
        "JBoss AS 7.0.2.Final "Arc" started".
      </p>
      <p>
        You can close the JBoss command-prompt window when you are finished testing.
      </p>
    </step>
    
       <step>
         <p>
           Download the <i>Student Exercise Archive</i> from
           <a 
         href="http://www.descriptor.com/setupguides/mastering-jee/setup/eclipse-indigo-jboss7/j2eeclass.zip">
         http://www.descriptor.com/setupguides/mastering-jee/setup/eclipse-indigo-jboss7/j2eeclass.zip</a>.
         </p>
        <p>
          <b>Windows XP:</b> Unzip the archive to the <b>root directory on Drive C:</b>. You should end up with
          a subdirectory named <b>c:\j2eeclass</b>.           
         </p>
        <p>
          <b>Windows Vista or later:</b> Unzip the archive to the <b>user's home directory</b>. You should end up with
          a subdirectory named <b>c:\Users\username\j2eeclass</b>.           
         </p>
       </step>
         
  </setup-instructions>

  <setup-instructions type="Instructor">
    <step>
      <p>Repeat the Student software setup on the instructor machine.</p>
    </step>

    <step>
      <p>Download and install the Courseware Viewer program.</p>
      <p>Download the Viewer installation program from:
        <a href="http://www.descriptor.com/viewer/binaries/setup.exe">
        http://www.descriptor.com/viewer/binaries/setup.exe
      </a>
      </p>
      <p>
        Run the installation program, accepting all defaults.
      </p>
    </step>
    <step>
      <p>
         Download the presentation materials from 
         <a href="http://www.descriptor.com/setupguides/mastering-jee/setup/j2eeclass-screenshow.zip">
           http://www.descriptor.com/setupguides/mastering-jee/setup/j2eeclass-screenshow.zip
         </a>
      </p>
      <p>
        Unzip this archive to the <b>root directory</b> on the same drive where you installed
        the <i>Student Exercise Archive</i>. You should end up with a subdirectory like
        <b>c:\j2eeclass\courseware</b>.
      </p>
    </step>
    <step>
      <p>
        Test the Courseware Viewer. From the Windows Start menu, choose <b>Descriptor Systems -
        Courseware Viewer</b>. Then use the <b>File - Open</b> menu to open the
        <b>c:\j2eeclass\courseware\j2eeclass.crs</b> file. You should see the screen show.
      </p>
    </step>
  </setup-instructions>

</setupguide>
