This document describes the setup for the Descriptor Systems Apache Struts Programming Workshop.
This document applies to version 1.0.2 of the Struts Programming Workshop using IBM WebSphere Application Developer.
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 .
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.
Install the operating system and service pack. Be sure to install TCP/IP networking and give the computer a TCP/IP hostname. Install Internet Explorer if necessary.
Create a folder in the root directory of drive C: named java. You will install the required software into this directory.
Note: The trial version of WSAD 5.1.2 is no longer available from IBM and is required for this course. You are responsible for obtaining and installing WSAD 5.1.2 before beginning the setup as described in this document.
Warning: Version 5.1.2 of WSAD is required for this class. Version 5.0 will not work.
Download the Struts Student Exercise archive from http://www.descriptor.com/setupguides/struts/setup/wsad5.1.2/strutsclass.zip. Unzip the archive to the root directory on Drive C:. You should end up with a subdirectory named c:\strutsclass.
Download the Struts Course Required Software archive from http://www.descriptor.com/setupguides/struts/setup/wsad5.1.2/struts-reqsoftware-wsad-1.0.1.zip. Unzip the archive to the c:\java directory. You should end up with the following subdirectories:
Now you need to update environment variables. Go to Start - Settings - Control Panel - System and select the Environment tab. (In Windows 2000, press the Advanced Tab and then press the Environment button.) Put the following string at the beginning of the System PATH environment variable:
C:\Program Files\IBM\WebSphere Studio\Application Developer\v5.1.2\runtimes\base_v51\java\bin
Please ensure that the drive and directory of these settings match where you installed WSAD.
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 Java. Then type:
javac
You should see the sign-on message from the Java compiler.
If either step fails, re-check the PATH environment variable. Before retesting, close the command window and open a new one.
To test the WSAD installation, choose Application Developer 5.1.2 from the IBM WebSphere Studio entry on the Windows Start menu.
Repeat the Student software setup on the instructor machine.
Download the Courseware Viewer from http://www.descriptor.com/viewer/binaries/setup.exe
To install, run the setup.exe program.
Download the Screen Show Archive from http://www.descriptor.com/setupguides/struts/setup/struts-screenshow.zip
To install, unzip struts-screenshow.zip to the root of drive c:.
Test the Courseware Viewer. From the Windows Start menu, choose Descriptor Systems - Courseware Viewer. Then use the File - Open menu to open the c:\strutsclass\foils\struts.crs file. You should see the Struts Workshop instructor display.