Download/Run

This Swingset/Apache Tomcat bundle contains everything you need to get Swingset up and running in a matter of minutes. No installation is necessary (assuming you have a Java JRE or JDK installed), just edit one line of a batch file or shell script and you're ready to go!

Downloads

Note: Version 03b require SSL for the login demo page. Instructions are included in the version of 03b bundled with Tomcat. If you do not know how/do not want to set up SSL on your own, it is recommended that you download the ESAPI Swingset 03b bundled with Apache Tomcat below. In the root directory of the .zip file, there is a README with very simple instructions for setting up SSL for this application. A .keystore file is provided, so user's will not have to generate their own keys.

Be aware, in some browsers, navigating to the login page will provide a warning that the digital signature provided may not be legitimate. The certificate provided is self-signed for demonstration purposes. The warning can safely be ignored for this page. More detailed information will follow in the coming weeks.

Download the JRE or JDK

If it is not already installed, please download a Java JRE or JDK version 5 or later.
Please note that, Tomcat 5.5 and above uses the Eclipse JDT Java compiler for compiling
JSP pages. This means you no longer need to have the complete
Java Development Kit (JDK) to run Tomcat, but a Java Runtime Environment
(JRE) is sufficient.

Setup and Run Swingset

Setup Swingset for Windows

Open Windows Explorer and Navigate to the directory to which ESAPI_Swingset.zip was extracted

Open Tomcat_6.0.18_start.bat with notepad

Set either of the two, JRE_HOME or JAVA_HOME enviornment variable for Tomcat to run.

Save the file

To set JAVA_HOME environment variable. You need to change the line "set JAVA_HOME=jdk_directory" to your Java install directory, where "jdk_directory" is the root of your Java directory. For many, the line will look like: "set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_10". Please remember that Swingset requires JDK/JRE version 5 or higher.

To set JRE_HOME change the "JRE_HOME=C:\Program Files\Java\jre1.6.0_10" so that it points to your JRE installation directory

Running Swingset on Windows

Navigate to the ESAPI_Swingset directory

Execute Tomcat_6.0.18_start.bat. This can be done through the command line or by double clicking the file.

If you followed the installation instructions in this wiki, Tomcat should now be running

How Can I help with Swingset

The ESAPI Swingset is still in an early beta stage. Many pages within Swingset are still incomplete, and we could certainly use some help getting them finished. If you are interested in helping, please check out Swingset's [SVN repository].

If you have any ideas for how the ESAPI Swingset could be better, or if you would like to submit new code, please contact Jeff Williams.