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:

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:

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:

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.

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.