<?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 Intro to Java
    Workshop.
  </title>

  <description>
    <p>
      This document describes the setup for the
      Descriptor Systems Java Part 1 Workshop.
    </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 2Ghz processor
    </requirement>
    <requirement>
      500MB of free disk space for installation
    </requirement>
    <requirement>
      1GB RAM 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>
      JDeveloper Studio 10.1.3.1
    </requirement>
    
    <requirement>
      Oracle Database 10g Express Edition for Windows
    </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 Java2 Standard Edition
        documentation package from:
      </p>
      <code>
        <a href="http://java.sun.com/javase/downloads/index_jdk5.jsp">http://java.sun.com/javase/downloads/index_jdk5.jsp</a>
      </code>
      <p>
        Find the <b>J2SE 5.0 Documentation</b> section, then click the Download
        button.
      </p>
      <p>
        Agree to the license, then download the J2SE Development Kit English documentation file,
        <b>jdk-1_5_0-doc.zip</b>.
      </p>
      <p>
        Unzip the
        documentation package ZIP to <i>c:\java</i> -- you should end up with
        a "docs" subfolder, i.e. <i>c:\java\docs</i>.
      </p>
    </step>

    <step>
      <p>
        Download JDeveloper Studio 10.1.3.1 for Windows from:
      </p>
      <p>
        <a href="http://www.oracle.com/technology/software/products/jdev/htdocs/soft10131.html">
          http://www.oracle.com/technology/software/products/jdev/htdocs/soft10131.html
        </a>
      </p>
      <p>
         Accept the license agreement, then download <b>jdevstudio10131.zip</b>.
      </p>
      <p>
        <b>Note: </b>If you don't already have a free Oracle Developer Network account,
        you will need to create one.
      </p>
      <p>
        Unzip jdevstudio10131.zip to the <i>c:\java\jdeveloper</i> directory, creating
        the "jdeveloper" subdirectory.
      </p>
    </step>
    <step>
      <p>
        Download Oracle Database 10g Express Edition for Windows from:
      </p>
      <p>
        <a href="http://www.oracle.com/technology/software/products/database/xe/htdocs/102xewinsoft.html">
          http://www.oracle.com/technology/software/products/database/xe/htdocs/102xewinsoft.html
        </a>
      </p>
      <p>
         Accept the license agreement, then download <b>OracleXE.exe</b>.
      </p>
      <p>
        <b>Note: </b>If you don't already have a free Oracle Developer Network account,
        you will need to create one.
      </p>
      <p>
        To install, run the OracleXE.exe program, accepting all defaults except:
        <ul>
          <li>Change the <i>Destination Location</i> to <b>c:\java\oraclexe</b></li>
          <li>Set the database password to <b>birdfeeder</b></li>
        </ul>
      </p>
    </step>
        
       <step>
         <p>
           Download the <i>Student Exercise Archive</i> from
           <a 
         href="http://www.descriptor.com/courseware/intro-java/licensees/setup/jdeveloper/javaclass-jdeveloper-1.0.0.zip">
         http://www.descriptor.com/courseware/intro-java/licensees/setup/jdeveloper/javaclass-jdeveloper-1.0.0.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</b>.           
         </p>
       </step>
    
    
    <step>
      <p>
        To test the JDeveloper installation, use Windows Explorer to navigate
        to the c:\java\jdeveloper directory and double-click <b>jdeveloper.exe</b>.
        JDeveloper should start.
      </p>
    </step>
    
    <step>
      <p>
        To test the Oracle Database 10g Express Edition, from the Windows Start
        menu, select <i>Programs - Oracle Database 10g Express Edition - Start Database</i>.
      </p>
      <p>
        Then select <i>Programs - Oracle Database 10g Express Edition - 
        Go to Database Home Page</i>. You should be able to log in with
        username of <b>system</b> and password of <b>birdfeeder</b>.
      </p>
    </step>
    
    <step>
      <p>Now you need to update environment variables. Go to 
      <i>Start - Settings - Control Panel - System</i> and select the <i>Advanced</i> tab
      and then press the <i>Environment</i> button.
      Put the following string at the beginning of the User PATH 
      environment variable:</p>
      <p><code>c:\java\jdeveloper\jdk\bin;</code></p>
      <p>Create the User PATH environment variable if it doesn't already exist.</p>
      <p>Make sure the drive and directory match where you actually installed JDeveloper.</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>
    
  </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/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 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\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\courseware\intro-java.crs</b> file. You should see the screen show.
      </p>
    </step>
    
    
  </setup-instructions>

</setupguide>
