<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" 
   href="file://c:/source/xslt/xml-labs/setupguide.xsl"?>
<setupguide>

  <title>
    Installation Guide for Intro to Java Programming Workshop using WSAD.
  </title>

  <description>
    <p>
      This document describes the setup for the
      Intro to Java Programming Workshop using WSAD.
    </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
        <a href="mailto:jbarnum@descriptor.com">jbarnum@descriptor.com</a>.
      or 319-362-3906.
    </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 WinZip from <a 
       href="http://www.winzip.com">www.winzip.com</a>
    </requirement>

    <requirement>
      WSAD Version 5.1.2
    </requirement>

    <requirement>
      J2SDK Documentation
    </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 (except for WSAD) into this directory.
      </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>c:\java</i> folder.
      </p>
    </step>
    
    <step>
      <p>
        <b>Warning:</b> Version 5.1.2 of WSAD is required for
        this class. Version 5.0 will not work.
      </p>
      <p>
        Download WSAD 5.1.2 Trial Version for Windows from:
      </p>
      <p>
        <a href="http://www.ibm.com/developerworks/websphere/downloads/wsad/">
          http://www.ibm.com/developerworks/websphere/downloads/wsad/
        </a>
      </p>
      <p>
        Download all required parts and optional part <i>WAS51_Part1.bin</i>, then run the 
        <i>wsextract</i> utility to extract the downloaded files. 
      </p>
      <p>
        When wsextract finishes, accept the option to run the installation,
        then install accepting all defaults.
      </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 <i>Student Labs Archive</i> from:
        <a 
          href="http://www.descriptor.com/courseware/intro-java/licensees/setup/wsad/javaclass.zip">
          http://www.descriptor.com/courseware/intro-java/licensees/setup/wsad/javaclass.zip</a>
      </p>
      <p>
        Unzip this file to the root directory of drive C: -- you should
        end up with a folder named <i>c:\javaclass</i> with several
        subfolders.
      </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 from:
        <a href="http://www.descriptor.com/viewer/no-ad/winsetup.zip">http://www.descriptor.com/viewer/binaries/winsetup.zip</a>
      </p>
      <p>Unzip this archive to a
        temporary directory on the Instructor machine. Then run
        the "setup.exe" program to install the Courseware Viewer. During installation,
        you will need to reference a 1.4 or newer Java Virtual Machine
        (java.exe). Assuming you installed WSAD in its default
        location, you can find such a JVM at:
      </p>
      <pre>
C:\Program Files\IBM\WebSphere Studio\Application Developer\v5.1.2\runtimes\base_v51\java\bin      
      </pre>
    </step>
    <step>
      <p>
         Download the <i>Screen Show Materials Archive</i> from
         <a 
          href="http://www.descriptor.com/courseware/intro-java/licensees/setup/intro-java-screenshow.zip">
          http://www.descriptor.com/courseware/intro-java/licensees/setup/intro-java-screenshow.zip</a>
      </p>
      <p>
        Unzip this file to the root directory of drive C: -- you should
        end up with a folder named <i>javaclass\courseware</i> with several
        subfolders.
      </p>
    </step>
    <step>
      Test the screen show. Use the Windows Start menu
      to run <i>Descriptor Systems - Courseware Viewer</i>. Then
      choose <i>File - Open</i> and navigate to the <b>
      c:\javaclass\courseware</b> folder and open the
      <b>intro-java.crs</b> file. You should see the screen show.
    </step>
  </setup-instructions>

</setupguide>
