<?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 Java Introduction
    to Server-Side Programming
    Workshop Eclipse 2020-06/Tomcat 8.5 Version.
  </title>

  <description>
    <p>
      This document describes the setup for the
      Descriptor Systems Java Introduction to Server-Side Programming
       Workshop Eclipse 2020-06/Tomcat 8.5 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
    </requirement>

    <requirement>
      Eclipse 2020-06
    </requirement>
    
    <requirement>
       Tomcat v8.5
    </requirement>
    
    <requirement>
      Student Exercises 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 Windows environment variables that reference
         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>
            Find the entry under User Variables for PATH. Press Edit, then
            add a new entry with value <i>JDK Installation Directory/bin</i>.
          </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 2020-06 For Java EE Developers for Windows (64-bit) from:
      </p>
      <p>
        <a href="https://www.eclipse.org/downloads/packages/release/2020-06/r">
          https://www.eclipse.org/downloads/packages/release/2020-06/r
        </a>.
      </p>
      <p>
        The file name should be something like <i>eclipse-jee-2020-06-R-win32-x86_64.zip</i>.
      </p>
      <p>
        <b>WARNING: </b>Be sure to download the Eclipse IDE for ENTERPRISE Java 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 Tomcat version 8.5 from:
      </p>
      <p>
        <a href="http://tomcat.apache.org/download-80.cgi">
          http://tomcat.apache.org/download-80.cgi
        </a>
      </p>
      <p>
        Download the <i>Core zip</i> file (not the Windows zip). 
      </p>
      <p>
        The file name should be something like <i>apache-tomcat-8.5.45.zip</i>.
      </p>
      <p>
        Unzip the archive to the c:\users\username\java directory. You should end up
        with a subdirectory named <b>c:\users\username\java\apache-tomcat-8.5.45</b>.
      </p>

    </step>
    
    
       <step>
         <p>
           Download the <i>Student Exercise Archive</i> from
           <a 
         href="http://www.descriptor.com/setupguides/intro-java-serverside/setup/eclipse-2020-06/javaclass.zip">
         http://www.descriptor.com/setupguides/intro-java-serverside/setup/eclipse-eclipse-2020-06/javaclass.zip</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</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/intro-java-serverside/setup/javaclass-screenshow.zip">
           http://www.descriptor.com/setupguides/intro-java-serverside/setup/javaclass-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\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\courseware\intro-java.crs</b>         
        file. You should see the screen show.
      </p>
    </step>
  </setup-instructions>

</setupguide>
