<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" 
   href="file://c:/source/xslt/xml-labs/setupguide.xsl"?>
<setupguide>

  <title>
    Installation Guide for Java Part 2 Programming Workshop using RAD6.
  </title>

  <description>
    <p>
      This document describes the setup for the
      Java Part 2 Workshop using Rational Application
      Developer version 6 (RAD6).
    </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>
      768BM 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>
      RAD Version 6
    </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 RAD6) 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>
      <p>
        You should end up with a subdirectory named <i>c:\java\docs</i>.
      </p>
    </step>
    
    <step>
      <p>
        Obtain the RAD6 installation files. Since this version is no longer
        available from IBM, you will need to obtain this files in some
        other way.
      </p>
      <p>
        The required files are <b>C81N0ML.bin</b>, <b>C81N3ML.bin</b> and
        <b>extractor.exe</b>. Copy the files to a temporary directory,
        then run extractor.exe to unpack the files. 
        Accept the
        option to run the installation wizard.
      </p>
      <p>
        Install using all of the defaults.
      </p>
    </step>        
    <step>
      <p>
        To test RAD, choose <b>Rational Application Developer</b>
        from the <b>IBM Rational</b> entry on the Windows Start
        menu.        
      </p>
    </step>
    
       <step>
         <p>
           Download the <i>Student Exercise Archive</i> from
           <a 
         href="http://www.descriptor.com/setupguides/java-p2/setup/rad6/javaclass-p2.zip">
         http://www.descriptor.com/setupguides/java-p2/setup/rad6/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\Rational\ADTrial\6.0\runtimes\base_v6\java\bin;</code></p>
      <p>Make sure the drive and directory match where you actually installed RAD6.</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>
