This document describes the setup for the Descriptor Systems Advanced Spring for Capital One 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.
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).
This setup guide has instructions for both Windows and Mac OS X. Each step indicates which operating system it's appropriate for.
Windows and MAC OS X Instructions:
In your "home" directory (e.g. c:\Users\username or /Users/username), create a folder named java. You will install some of the required software into this directory.
Install the Java Development Kit (JDK):
Windows Instructions:
Note: The JDK installation requires administrative privileges, so make sure you have those credentials.
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-8u65-windows-x64.exe. It's OK to download a later version than 8u65.
Install the JDK using all of the defaults, EXCEPT: Recently, on some JDK downloads, Oracle has started to bundle a browser "search" plugin named "Ask" that will take over the default search provider on your system. If you don't want that, make sure that you deselect that option if you see it during the JDK installation.
Mac OS X Instructions:
Download the Java 8 Java Development Kit from:
http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
Get the Mac OS X x64 version. The file name should be something like jdk-8u65-macosx-x64.dmg. It's OK to download a later version than 8u65.
Install the JDK using all of the defaults, EXCEPT: Recently, on some JDK downloads, Oracle has started to bundle a browser "search" plugin named "Ask" that will take over the default search provider on your system. If you don't want that, make sure that you deselect that option if you see it during the JDK installation.
Test the Java Installation:
Windows Instructions:
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.
Mac OS X Instructions:
To test the Java runtime installation, from your Applications/Utilities folder, run Terminal. In the Terminal, enter:
java -fullversion
You should see the version number of the JDK that you installed.
Install Eclipse:
Windows Instructions:
Download the Eclipse Mars IDE For Java EE Developers for Windows (64-bit) from:
https://eclipse.org/downloads/packages/release/Mars/1 .
The file name should be something like eclipse-jee-mars-1-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.
Mac OS X Instructions:
Download the Eclipse Mars IDE For Java EE Developers for Mac Cocoa (64-bit) from:
https://eclipse.org/downloads/packages/release/Mars/1 .
The file name should be something like eclipse-jee-mars-1-macosx-cocoa-x86_64.tar.gz.
WARNING: Be sure to download the Eclipse IDE for Java EE Developers, not Eclipse for Java Developers (doesn't support EE).
Expand the archive to the /Applications directory. You should end up with a subdirectory named /Applications/eclipse.
Test Eclipse:
Windows Instructions:
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.
Mac OS X Instructions:
To test the Eclipse installation, use Finder to navigate to the /Applications/eclipse directory and double-click Eclipse.app. Eclipse should start.
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: ____________________________________________
Add the Spring Boot Installation Directory bin subfolder to the Windows PATH:
To test the Spring Boot installation, choose Start - Run, then enter cmd and press OK. In the new command prompt window, enter:
spring --version
You should see the version number of the Spring Boot CLI that you installed.
MAC OS X 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.tar.gz .
Expand the downloaded file to that java folder that 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: ____________________________________________
Add the Spring Boot Installation Directory bin subfolder to the PATH:
export PATH=$PATH:/Users/username/java/spring-1.3.1.RELEASE/bin,
substituting the actual Spring Installation Directory as necessary.
To test the Spring Boot installation, from your Applications/Utilities folder, run Terminal. In the Terminal, enter:
spring -version
You should see the version number of Spring Boot that you installed.
Download Spring XD from https://repo.spring.io/libs-release/org/springframework/xd/spring-xd/1.3.0.RELEASE/spring-xd-1.3.0.RELEASE-dist.zip
Unzip the archive to the \Users\username\java folder (Windows) or /Users/username/java folder (MAC OS X).
You should end up with a folder named spring-xd-1.3.0.RELEASE.
Download the required student lab files:
Windows and Mac OS X Instructions:
Download the Student Exercise Archive from http://www.descriptor.com/setupguides/capital-one/advspring/setup/eclipse-mars-tomcat8/advspring.zip.
Install the required student lab files:
Windows Instructions: Unzip the archive to the user's home directory. You should end up with a subdirectory named c:\Users\username\advspring.
Mac OS X Instructions: Unzip the archive to the user's home directory. You should end up with a subdirectory named /Users/username/advspring.
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/capital-one/advspring/setup/advspring-screenshow.zip
Windows Vista or later: 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\javaclass\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:\javaclass\courseware\intro-java.crs or c:\Users\username\javaclass\courseware\advspring.crs file. You should see the screen show.