Installation Guide for Descriptor Systems Liberty Web Development Workshop.

This document describes the setup for the Descriptor Systems Liberty Web Development Workshop.

Important: 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.

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).

If you have questions or difficulties with the installation, you can contact Joel Barnum at 319-362-3906 or email at .

Hardware Requirements - Student computers

A Pentium 1Ghz processor
500MB of free disk space for installation
256MB of memory, 512MB strongly recommended
1024x768 display, 65536 colors
Optional Internet connection

Hardware Requirements - Instructor computer

Instructor machine hardware is the same as students, plus any additional requirements listed below.

Projection unit, 800x600 resolution minimum
Internet connection strongly recommended

Software Requirements - Student computers

Microsoft Windows 7 or later
Unzip utility such as 7-Zip from http://www.7-zip.org
Java Development Kit (JDK) Version 8
Eclipse Neon
Tomcat 8
Gradle
Spring Boot
Student Exercises Archive

Software Requirements - Instructor computer

Instructor machine software is the same as students, plus any additional requirements listed below.

Descriptor Systems Courseware Viewer (screen-show software)
Instructor Display Materials

Setup Instructions - Student computers

NOTE: This course's labs REQUIRE direct access to the internet from the command-line gradle and spring programs. These programs download dependent libraries from internet-based repositories to the local workstation and cannot do so if there's an authenticating proxy server configured. Please ensure that the workstations on which the labs will run allow direct internet access.
Login in with the same user name that the students will use, and note the user name here:
```
Student user name: ____________________________________
      
      
```
In the "home" directory for that user (e.g. c:\Users\username, create a folder named java. You will install some of the required software into this directory.

Then create another folder named gradlehome in the "home" directory.
Download the Java 8 Java Development Kit from:
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
Get the Windows 64-bit version. The file name should be something like jdk-8u91-windows-x64.exe. It's OK to use a later version than 8u91.

Install the JDK using all of the defaults.
To test the Java runtime installation, choose Start - Run, then enter cmd and press OK. In the new command prompt window, enter:
java -fullversion
You should see the version number of the JDK that you installed.
Download the Eclipse Neon IDE For Java EE Developers for Windows (64-bit) from:

https://www.eclipse.org/downloads/packages/release/Neon/2 .

The file name should be something like eclipse-jee-neon-2-win32-x86_64.zip.

WARNING: Be sure to download the Eclipse IDE for Java EE Developers, not Eclipse for Java Developers (doesn't support EE).

Unzip the archive to the c:\Users\username\java directory. You should end up with a subdirectory named c:\Users\username\java\eclipse.
To test the Eclipse installation, use Windows Explorer or My Computer to navigate to the c:\Users\username\java\eclipse directory and double-click eclipse.exe. Eclipse should start.
Download Tomcat version 8 from:

http://tomcat.apache.org/download-80.cgi

Download the Core zip file (not the Windows zip).

Note: Be sure to get version 8.0.xx, NOT 8.5.xx.

The file name should be something like apache-tomcat-8.0.45.zip.

Unzip the archive to the c:\users\username\java directory. You should end up with a subdirectory named c:\users\username\java\apache-tomcat-8.0.45.
Download Gradle from:

https://gradle.org/releases/

Get the "Binary only" distribution v 2.14. The file name should be something like gradle-2.14-bin.zip.

Unzip the archive to the c:\users\username\java. You should end up with a subdirectory named c:\users\username\java\gradle-2.14.
Download and install Spring Boot:

Windows Instructions:

Download the Spring CLI distribution from http://repo.spring.io/release/org/springframework/boot/spring-boot-cli/1.3.1.RELEASE/spring-boot-cli-1.3.1.RELEASE-bin.zip .

Unzip the downloaded file to the java folder you created in an earlier step. You should end up with a directory that matches the version of the Spring Boot CLI that you downloaded, for example: \Users\username\java\spring-1.3.1.RELEASE. Please write down the directory name here:
```
        
Spring Boot Installation Directory: ____________________________________________        
        
```
Establish environment variables. Open the Windows Control Panel and in the upper-right corner, start typing Environment then click Edit the system environment variables. Press the Environment variables button.

Establish three new User environment variables:
```
GRADLE_HOME=c:\users\username\java\gradle-2.14
GRADLE_USER_HOME=c:\users\username\gradlehome
PATH=%GRADLE_HOME%\bin;\Users\username\java\spring-1.3.1.RELEASE\bin;%PATH%      
      
```
Be sure to substitute the actual user name in these variables.
Test gradle. Close any open command-prompt windows, then open a new one. Enter:
gradle -version
You should see the version of Gradle you installed.

Next, test gradle's access to internet-based repositories. In a temporary directory on the workstation, create a file named build.gradle with the following contents:
```
repositories {
    maven {
       mavenCentral()
        url 'https://repo.spring.io/libs-release'
    }
}

apply plugin: 'java'
apply plugin: 'eclipse'

dependencies {
    runtime 'log4j:log4j:1.2.17'
}      
```
Then open a command-prompt and change to the temporary directory containing the build.gradle file and enter:
```
gradle eclipse      
      
```
You should see gradle downloading dependencies, including the line shown below:
```
Download https://repo1.maven.org/maven2/log4j/log4j/1.2.17/log4j-1.2.17.jar      
      
```
If you do NOT see log4j being downloaded, please verify that the workstation has proxyless access to the internet.
Test Spring Boot. Close any open command-prompt windows, then open a new one. Enter:
```
        spring --version
      
```
You should see the version number of the Spring Boot CLI that you installed.

Next, test Spring Boot's access to the internet. In the command-prompt, change to a temporary directory on the workstation, then enter:
```
spring init -b 1.3.1.RELEASE --build gradle -x      
      
```
If you see the message Failed to retrieve metadata from service at 'https://start.spring.io', then please verify that the workstation has proxyless access to the internet.
Download the Student Exercise Archive from http://www.descriptor.com/setupguides/liberty/techstart/2017/webdev/eclipse-neon-spring4-springboot/webclass.zip.

Unzip the archive to the user's home directory. You should end up with a subdirectory named c:\Users\username\webclass.

Setup Instructions - Instructor computers

Repeat the Student software setup on the instructor machine.
Download and install the Courseware Viewer program.

Download the Viewer installation program from: http://www.descriptor.com/viewer/binaries/setup.exe

Run the installation program, accepting all defaults.
Download the presentation materials from http://www.descriptor.com/setupguides/liberty/techstart/2017/webdev/webclass-screenshow.zip

Unzip this archive to the user's home directory on the same drive where you installed the Student Exercise Archive. You should end up with a subdirectory like c:\Users\username\webclass\courseware.
Test the Courseware Viewer. From the Windows Start menu, choose Descriptor Systems - Courseware Viewer. Then use the File - Open menu to open the c:\Users\username\webclass\courseware\webclass.crs file. You should see the screen show.