<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" 
   href="file://c:/source/xslt/xml-labs/setupguide.xsl"?>
<setupguide>

  <title>
    Installation Guide for Java Programming, Part 2 Workshop, WSAD version.
  </title>

  <description>
    <p>
      This document describes the setup for the
      Java Programming, Part 2 Workshop, WSAD 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 800Mhz processor
    </requirement>
    <requirement>
      500MB of free disk space for installation
    </requirement>
    <requirement>
      512BM RAM minimum, 1024MB 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, Service Pack 3 or later
    </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>
      WSAD Version 5.1.x
    </requirement>

    <requirement>
      Student Labs Archive
    </requirement>
    
  </software-requirements>
    
  <software-requirements type="Instructor" >
    <requirement>Descriptor Systems Courseware Viewer (screen-show software)</requirement>
    <requirement>Screen Show Materials Archive</requirement>
  </software-requirements>

  <setup-instructions type="Student">
    <step>
      <p>
       Install the operating system and service pack. Be sure to install
       TCP/IP networking and give the computer a TCP/IP hostname.
       Install Internet Explorer if necessary.
      </p>
    </step>    
    <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>
        <b>Warning:</b> Version 5.1.x of WSAD is required for
        this class. Version 5.0 will not work.
      </p>
      <p>
        Since WSAD is no longer available from IBM, you must obtain
        the WSAD installation files in some other way.
      </p>
      <p>
        Copy the following installation files to a temporary directory: 
      </p>
      <ul>
        <li>
          Wsextract.exe (Core installation file)
        </li>
        <li>
          Required.bin (Core installation file)
        </li>
        <li>
          WAS51.bin
        </li>
      </ul>
      <p>
        Navigate to the temporary directory and run the <b>wsextract.exe</b> program.
      </p>
      <p>
        Accept all defaults during installation.
      </p>
    </step>        
    <step>
      <p>
        To test the WSAD installation, choose <b>Application Developer 5.1</b>
        from the <b>IBM WebSphere Studio</b> entry on the Windows Start
        menu.
      </p>
    </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 <i>java</i> folder.
      </p>
    </step>

       <step>
         <p>
           Download the <i>Student Exercise Archive</i> from
           <a 
         href="http://www.descriptor.com/setupguides/java-p2/setup/wsad5.1.2/javaclass-p2.zip">
         http://www.descriptor.com/setupguides/java-p2/setup/wsad5.1.2/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:\Program Files\IBM\WebSphere Studio\Application Developer\v5.1.2\runtimes\base_v51\java\jre\bin;</code></p>
      <p>Make sure the drive and directory match where you actually installed WSAD.</p>
    </step>

    <step>
      <p>
        To test the Java environment variable setting, 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 a Java version number message.
      </p>
      <p>
        If this fails, close the command window,
        re-check the PATH environment variable and test again.
      </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>
