This document describes the setup for the Installation Guide for Descriptor Systems' Building REST and SOAP Web Services for Eclipse Photon/JBoss EAP 7.1 course.
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 jbarnum@descriptor.com. or 319-362-3906.
Instructor machine hardware is the same as students, plus any additional requirements listed below.
Instructor machine software is the same as students, plus any additional requirements listed below.
Windows Vista or later: 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.
Download the Java SE 8 Development Kit for Windows x86 from:
https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html
Download the Windows x64 JDK. The file name should be something like jdk-8u251-windows-x64.exe.
Install the JDK using all of the defaults.
Look in the c:\Program Files\Java folder to see the JDK installation directory and write it down here:
JDK Installation Directory: _________________________________________________________
The directory should be something like:
C:\Program Files\Java\jdk1.8.0_251
In the Windows Start menu, search for Environment variables, choose Edit the System Environment Variables to open the Windows Control Panel's System Properties, Advanced tab. Click the Environment Variables button.
Add a new User Variable named JAVA_HOME and set its value to the JDK Installation Directory you noted previously.
Either Add or Edit the User Variable named Path and set its value to the JDK Installation Directory with /bin appended, for example:
C:\Program Files\Java\jdk1.8.0_211\bin
Press OK twice to save the environment variables.
To test the JDK installation, choose Start - Run, then enter cmd and press OK. In the new command prompt window, enter:
javac -version
You should see a version number, e.g. javac 1.8.0_251.
Enter:
wsimport -version
You should see a version number, e.g. wsimport version "2.2.9".
Download the Eclipse Photon IDE For Java EE Developers for 64-bit Windows from:
https://www.eclipse.org/downloads/packages/release/photon/r .
Warning: Be sure to download the IDE for Java EE Developers, not the IDE for just Java Developers.
The file name should be something like eclipse-jee-photon-R-win32-x86_64.zip.
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:\java\eclipse or c:\Users\username\java\eclipse directory and double-click eclipse.exe. Eclipse should start.
Download JBoss EAP 7.1.0 from:
https://developers.redhat.com/products/eap/download
Scroll down to find the 7.1.0 section then click the Download button for the ZIP File.
The file name should be jboss-eap-7.1.0.zip.
Unzip the archive to the c:\Users\username\java directory. You should end up with a subdirectory named c:\Users\username\java\jboss-eap-7.1.
To test the JBoss installation, use Windows Explorer to navigate to c:\Users\username\java\jboss-eap-7.1\bin. Double-click on the standalone.bat file - JBoss should open a command-prompt window and start up, eventually displaying a message containing the text "JBoss EAP 7.1.0.GA .... started".
You can close the JBoss command-prompt window when you are finished testing.
Download the Student Labs Archive from http://www.descriptor.com/setupguides/irs/webservices-2020/setup/eclipse-photon-jboss-eap-7.1/websrvclass.zip
Unzip websrvclass.zip to the c:\Users\username directory. You should end up with a subdirectory named c:\Users\username\websrvclass.
Repeat the Student setup instructions on the Instruction 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/irs/webservices-2020/setup/websrvclass-screenshow.zip
Unzip this archive to the same directory where you installed the Student Exercise Archive. You should end up with a subdirectory like c:\Users\username\websrvclass\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\websrvclass\courseware\websrvclass.crs file. You should see the screen show.