<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" 
   href="file://c:/source/xslt/xml-labs/setupguide.xsl"?>
<setupguide>

  <title>
    Installation Guide for the Descriptor Systems Introduction to
    Object Orientation and UML Workshop -- Rational Software
    Modeler 6.0 Version
  </title>

  <description>
    <p>
      This document describes the setup for the
      Descriptor Systems Introduction to Object Orientation and 
      UML Workshop - RSM 6 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 may 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 2Ghz processor
    </requirement>
    <requirement>
      2GB of free disk space for installation
    </requirement>
    <requirement>
      1GB RAM 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 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>
      RSM 6.0 Trial Version
    </requirement>
        
    <requirement>
      OOAD Lab Software 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>
        The Rational Software Modeler version 6 (RSM6) is no longer 
        available from IBM, so you will need to obtain the installation
        files in some other way. Once you have the installation files,
        copy the following to a temporary folder on your hard disk:
      </p>
      <ul>
        <li>
          ESD Extractor (extractor.exe)
        </li>
        <li>
          Core installation files (C81SFML.bin )
        </li>
      </ul>
      <p>
        Install RSM 6 by running extractor.exe, which will verify
        the downloaded components and extract them. Accept the
        option to run the installation wizard.
      </p>
      <p>
        Install using all of the defaults.
      </p>
    </step>
        
    <step>
      <p>
        To test the RSM 6 installation, start RSM 6 from
        the Windows Start menu.
      </p>
    </step>
    <step>
      <p>
        Download the OOAD Lab Software Archive from
        <a href="http://www.descriptor.com/setupguides/ooad/setup/rsm6.0/ooadclass.zip">
         http://www.descriptor.com/setupguides/ooad/setup/rsm6.0/ooadclass.zip</a>.
      </p>
      <p>
        Unzip this archive to the root directory on drive C: -- you should
        end up with a subdirectory named <i>c:\ooadclass</i>.
      </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\SMTrial\6.0\eclipse\jre\bin;</code></p>
      <p>Make sure the drive and directory match where you actually installed RSM6.</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 <i>Instructor Display Materials</i> from
           <a 
         href="http://www.descriptor.com/setupguides/ooad/setup/intro-ooad-screenshow.zip">
         http://www.descriptor.com/setupguides/ooad/setup/intro-ooad-screenshow.zip</a>.
       </p>
       <p>
        Unzip the archive to the <b>root directory on Drive C:</b>. You should end up with a
        subdirectory named <b>c:\ooadclass\courseware</b>.
       </p>
     </step>
    
    
    <step>
      <p>
        Test the Courseware Viewer by choosing
        Start - Descriptor Systems - Courseware Viewer. In the Viewer,
        choose File - Open and open:
      </p>
      <code>
        \ooadclass\courseware\intro-ooad.crs
      </code>
      <p>You should see the screen show for the workshop. </p>
    </step>

  </setup-instructions>

</setupguide>
