<?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' Intermediate Java for Liberty,
    Eclipse Photon Version.
  </title>

  <description>
    <p>
      This document describes the setup for the
      Descriptor Systems' Intermediate Java for Liberty,
    Eclipse Photon 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>
      500MB of free disk space for installation
    </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 7 or later
    </requirement>

    <requirement>
       Unzip utility such as 7-Zip from <a 
       href="http://www.7-zip.org/">http://www.7-zip.org</a>
    </requirement>

    <requirement>
      Java Development Kit (JDK) Version 11 or higher
    </requirement>

    <requirement>
      Eclipse Photon
    </requirement>
   
    <requirement>
      Student Exercise 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>
        Login in with the same user name that the students will use, and note the
        user name here:
      </p>
      <pre>

Student user name: ____________________________________
      
      </pre>
      <p>
        In the "home" directory for that user (e.g. <b>c:\Users\username</b>,
        create a folder named <b>java</b>. You will
        install some of the required software into this directory.
      </p>
    </step>
    
    <step>
      <p>
        Download the latest Java 11 Java Development Kit from:
      </p>
      <code>
        <a href="https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html">
        https://www.oracle.com/technetwork/java/javase/downloads/jdk11-downloads-5066655.html</a>
      </code>
      <p>
        Get the Windows 64-bit version. The file name should be something like <b>jdk-11.0.3_windows-x64_bin.exe</b>.
      </p>
      <p>
        Install the JDK using all of the defaults, but note the directory in which the
        setup program installs the JDK (typically under Program Files\Java). Write down the
        JDK installation directory here:
      </p>
      <pre>
      
      
JDK Installation directory:   _____________________________________________


      </pre>
    </step>
    <step>
      <p>
         Define a Windows JAVA_HOME environment variable that references
         the JDK's installation directory:
      </p>
      <ul>
          <li>From the Windows Start menu, start the Control Panel.</li>
          <li>
             In the Search Control Panel box, start typing <b>environment</b>,
             then click <i>Edit system environment variables</i>.
          </li>
          <li>
            Press the Environment Variables button.
          </li>
          <li>
            Look under User Variables for JAVA_HOME. If it's there, highlight it,
            then click Edit. If it's not there, click New then enter JAVA_HOME for the
            variable name. For the
            variable value, enter the <i>JDK Installation Directory</i>
            you noted earlier.
          </li>
          <li>
            Press OK as many times as needed to apply the change.
          </li>
      
      </ul>
    </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 JDK that you
        installed.
      </p>
      <p>
        In the command prompt, enter:
      </p>
      <code>
SET JAVA_HOME      
      </code>
      <p>
        You should see the JDK Installation Directory.
      </p>
    </step>
    
    <step>
      <p>
        Download the Eclipse Photon IDE For Java EE Developers for Windows (64-bit) from:
      </p>
      <p>
        <a href="https://www.eclipse.org/downloads/packages/release/photon/r">
          https://www.eclipse.org/downloads/packages/release/photon/r
        </a>.
      </p>
      <p>
        The file name should be something like <i>eclipse-jee-photon-R-win32-x86_64.zip</i>.
      </p>
      <p>
        <b>WARNING: </b>Be sure to download the Eclipse IDE for Java EE Developers, not
        Eclipse for Java Developers (doesn't support EE).
      </p>
      <p>
        Unzip the archive to the <i>c:\Users\username\java</i> directory. You should end up
        with a subdirectory named <b>c:\Users\username\java\eclipse</b>.
      </p>
    </step>
    
    <step>
      <p>
        To test the Eclipse installation, use Windows Explorer or My Computer to navigate
        to the c:\java\eclipse or c:\Users\username\java\eclipse directory and double-click <b>eclipse.exe</b>.
        Eclipse should start.
      </p>
    </step>

       <step>
         <p>
           Download the <i>Student Exercise Archive</i> from
           <a 
         href="http://www.descriptor.com/setupguides/liberty/intermediate-java-2019/setup/eclipse-photon/javaclass-p2.zip">
         http://www.descriptor.com/setupguides/liberty/intermediate-java-2019/setup/eclipse-photon/javaclass-p2</a>.
         </p>
        <p>
          Unzip the archive to the <b>user's home directory</b>. You should end up with
          a subdirectory named <b>c:\Users\username\javaclass-p2</b>.           
         </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/liberty/intermediate-java-2019/setup/javaclass-p2-screenshow.zip">
           http://www.descriptor.com/setupguides/liberty/intermediate-java-2019/setup/javaclass-p2-screenshow.zip
         </a>
      </p>
      <p>
        Unzip this archive to the <b>user's home 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:\Users\username\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:\Users\username\javaclass-p2\courseware\javaclass-p2.crs</b>         
        file. You should see the screen show.
      </p>
    </step>
  </setup-instructions>

</setupguide>
