The document summarizes the iCarnegie Servlet Workbench, a lightweight Java web server and framework. Version 1.1 includes opening Internet Explorer instances separately on Windows and warnings for non-class file loads. It provides installation instructions, requirements of a Java 1.3+ VM and Windows/Linux/Mac OS X, and getting started steps of running via .jar or .bat files. Issues covered include untested platforms and needing shell scripts to run JSP. The document concludes with how to report problems and credits to included third party software.
1. I C A R N E G I E S E R V L E T W O R K B E N C H
V E R S I O N 1.1
CONTENTS
--------
1. What's new in 1.1?
2. What is it?
3. The Latest Version
4. Requirements
5. Installation Instructions
6. Getting Started
7. Known Issues
8. Reporting Problems
9. Licensing and legal issues
10. Credits
1. What's new in 1.1?
-----------------------
o If the user is using a Windows operating system, has not specified
a web browser in Edit|Preferences, and has Internet Explorer as the
default web browser the Servlet Workbench will attempt to open each
instance of Internet Explorer in a new process.
o The user will now be warned if they attempt to load other than class
files during the "Load Java" action.
2. What is it?
---------------
The iCarnegie Servlet Workbench is a Java application designed to provide
students with a lightweight web server and servlet framework for use in
their iCarnegie courses.
3. The Latest Version
----------------------
The latest version of the iCarnegie Servlet Workbench is always available
by following the "course information" link on the Trestle course outline.
Once the program is installed you can determine its version by selecting
Help|About from the menu.
4. Requirements
----------------
The following requirements exist for installing the
iCarnegie Servlet Workbench:
o Microsoft Windows (The iCarnegie Servlet Workbench has been tested on
machines with 128 MB RAM running Windows 9x, Windows ME, Windows NT,
Windows 2000, and Windows XP.)
-or-
Linux or an equivalent *NIX platform with 128 MB RAM
-or-
Apple Macintosh computers running Mac OS X.
2. o A Java virtual machine version 1.3 or higher.
To use the iCarnegie Servlet Workbench, the Java Development Kit (JDK)
or Java Runtime Environment (JRE) must be installed on the machine, and
must be in the path. (To check this, open a command prompt and type
in "java -?" and hit return. If you get a usage list, then you are
ready to use the iCarnegie Servlet Workbench. If you get an error, you
must install the JDK/JRE from http://java.sun.com, or you must set the
path to include the JDK/JRE bin directory.)
5. Installation Instructions
-----------------------------
After downloading the ZIP file containing the iCarnegie Servlet Workbench,
unpack it to a directory of your choice (e.g., c:Workbench on
a Windows platform).
If you are on a UNIX platform and are using the "unzip" utility
to uncompress the workbench.zip file you may run into the
problem where you cannot start the application.
The "unzip" utility may not create execute permissions for the
directories that it creates. If you cd into the directory where
you uncompressed the workbench.zip file and type:
find . -type d -exec chmod u+x {} ;
it should take care of the problem and allow you to proceed.
6. Getting Started
-------------------
You run the iCarnegie Servlet Workbench on a Windows platform by double
clicking on workbench.jar, or by running workbench.bat (it will be
necessary to modify workbench.bat by specifying JAVA_HOME and
WORKBENCH_HOME), or by typing java -jar workbench.jar on the command line.
On a Linux/UNIX/Mac OSX platform you can execute the workbench.sh file
(which needs tweaking for your particular environment) or by typing
java -jar workbench.jar.
7. Known Issues
----------------
o The iCarnegie Servlet Workbench should be able to work on any platform
that supports a Java Virtual Machine. However, it has only been tested
on the Windows, Mac, and Linux platforms. If you have an interest in
using the iCarnegie Servlet Workbench on other platforms contact
iCarnegie.
o In order to be able to run Java Server Pages (JSP) it is necessary to
run the iCarnegie Servlet Workbench with the enclosed batch/shell script.
o On a Windows platform if you get an error in the console view that
looks like the following, it is probably related to a known bug with
older versions of the Java VM. Either install the latest version of the
Java SDK, or try first running the SwingSet2 demo (that comes with the
SDK) as the machine's Administrator.
Aug 11, 2003 8:08:36 AM java.util.prefs.WindowsPreferences <init>
WARNING: Could not open/create prefs root node SoftwareJavaSoftPrefs
at root 0x80000002. Windows RegCreateKeyEx(...) returned error code 5.
3. Aug 11, 2003 8:08:36 AM java.util.prefs.WindowsPreferences
WindowsRegOpenKey1 WARNING: Trying to recreate Windows registry node
SoftwareJavaSoftPrefs at root 0x80000002.
Aug 11, 2003 8:08:36 AM java.util.prefs.WindowsPreferences openKey
WARNING: Could not open windows registry node SoftwareJavaSoftPrefs
at root 0x80000002. Windows RegOpenKey(...) returned error code 2.
8. Reporting Problems
----------------------
Problems with the iCarnegie Servlet Workbench should be forwarded via
email to help@icarnegie.com. The following information will be helpful in
resolving the problem:
1. Can you reproduce the problem? If you can't, chances are we will have
trouble reproducing it as well. What are the exact steps required to
reproduce the error?
2. What is the Servlet Workbench version, operating system, Java Virtual
Machine, and computer specifics? (e.g., Servlet Workbench version
1.0, Windows NT Version 4.0 SP6, JDK 1.3.1_02, Pentium III 800 MHz
with 128MB RAM.) The iCarnegie Servlet Workbench version is found by
clicking on "Help|About" from the main menu.
3. In the installation directory of the iCarnegie Servlet Workbench there
should be a log directory containing three log files for each day the
iCarnegie Servlet Workbench was run. If you can, include the log
files from the date when the error occurred.
4. Verify nothing is already listening on the port that the iCarnegie
Servlet Workbench is attempting to use for its embedded server.
Typing "netstat -an" at the command shell prompt will show all local
ports currently in use. If the default port 4615 is being used, pick
an unused port greater than 1024.
9. Licensing and legal issues
------------------------------
For legal, licensing, and redistribution issues, please contact iCarnegie.
Thank you for using the iCarnegie Servlet Workbench.
10. Credits
------------
This product includes software developed by:
Apache Software Foundation (http://www.apache.org/).
Mort Bay Consulting (Jetty:// Web Server & Servlet Container
http://jetty.mortbay.org)
World Wide Web Consortium (http://www.w3.org/)
JTidy - http://lempinen.net/sami/jtidy/
ICE Engineering (http://www.trustice.com/)
JNIRegistry - http://www.trustice.com/java/jnireg/