<?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 Java Part 2
    Workshop Eclipse Version.
  </title>

  <description>
    <p>
      This document describes the setup for the
      Descriptor Systems Java Part 2 Workshop Eclipse Version.
    </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>
      256MB of memory, 512MB strongly recommended
    </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 Windows 2000
    </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>
      Java2 Standard Edition SDK Version 1.4 or higher
    </requirement>

    <requirement>
      Eclipse Version 3.0.2
    </requirement>
    
    <requirement>
      Student Exercises Archive
    </requirement>

  </software-requirements>
    
  <software-requirements type="Instructor" >
    <requirement>Descriptor Systems Courseware Viewer (screen-show software)</requirement>
    <requirement>Struts Workshop Instructor Display Materials </requirement>
  </software-requirements>

  <setup-instructions type="Student">
    <step>
      <p>
        Create a folder in the root directory of drive C: named <b>java</b>. You will
        install the required software into this directory.
      </p>
    </step>
    
    <step>
      <p>
        Download the latest released Java2 Standard Edition
        Software Development Kit (JSDK) version 1.4.x for Windows and documentation package
        from:
      </p>
      <code>
        <a href="http://java.sun.com/j2se/1.4.2/download.html">http://java.sun.com/j2se/1.4.2/download.html</a>
      </code>
      <p>Note: Be sure to download the J2SE SDK, not the JRE or
      the J2EE SDK!</p>
      <p>
        Install the JSDK to the c:\java directory. You should
        end up with a subdirectory c:\java\j2sdk1.4.2 or something
        like that. Note the directory name here for a future step:
      </p>
      <pre>
      
      
JSDK Directory:  ________________________________________________      
      </pre>
    </step>
    <step>
      <p>
        Download the Java2 Standard Edition
        documentation package from:
      </p>
      <code>
        <a href="http://java.sun.com/j2se/1.4.2/download.html">http://java.sun.com/j2se/1.4.2/download.html</a>
      </code>
      <p>
         The file name should be something like <i>j2sdk-1_4_2-doc.zip</i>.
         Then unzip the
        documentation package ZIP to the same drive where you
        installed the JSDK (the goal is to get the "docs" directory as a
        a subdirectory under the JSDK directory).
      </p>
    </step>

    <step>
      <p>
        Download the Eclipse 3.02 SDK for Windows from:
      </p>
      <p>
        <a href="http://archive.eclipse.org/eclipse/downloads/index.php">
          http://archive.eclipse.org/eclipse/downloads/index.php
        </a>
      </p>
      <p>
        Click on the <i>3.0.2</i> link under Build Name,
        then click on 
        <b>eclipse-SDK-3.0.2-win32.zip</b> and download this
        archive.
        Unzip the archive to the c:\java directory. You should end up
        with a subdirectory named <b>c:\java\eclipse</b>.
      </p>
    </step>
    
       <step>
         <p>
           Download the <i>Student Exercise Archive</i> from
           <a 
         href="http://www.descriptor.com/setupguides/java-p2/setup/eclipse/javaclass-p2.zip">
         http://www.descriptor.com/setupguides/java-p2/setup/eclipse/javaclass-p2.zip</a>.
        Unzip the archive to the <b>root directory on Drive C:</b>. You should end up with
        a subdirectory named <b>c:\javaclass-p2</b>.           
         </p>
       </step>
    
    <step>
      <p>Now you need to update environment variables. Go to 
      Start - Settings - Control Panel - System and select the Environment tab.
      (In Windows 2000, press the Advanced Tab and then press the Environment button.)
      Put the following string at the beginning of the User PATH 
      environment variable:</p>
      <p><code>C:\java\j2sdk1.4.1_08\bin;</code></p>
      <p>Make sure the drive and directory match where you actually installed the software.</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 JSDK that you
        installed. Then type:
      </p>
      <code>
        javac
      </code>
      <p>
        You should see the sign-on message from the Java
        compiler.
      </p>
      <p>
        If either step fails, re-check the PATH environment variable.
      </p>
    </step>
    
    <step>
      <p>
        To test the Eclipse installation, use Windows Explorer to navigate
        to the c:\java\eclipse directory and double-click <b>eclipse.exe</b>.
        Eclipse should start.
      </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/java-p2/setup/java-p2-screenshow.zip">
           http://www.descriptor.com/setupguides/java-p2/setup/java-p2-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:\javaclass-p2\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:\javaclass-p2\courseware\java-p2.crs</b> file. You should see the screen show.
      </p>
    </step>
    
    
  </setup-instructions>

</setupguide>
