- Download WebCAT.tar.gz from our
NIST Web Metrics download page.
- Unpack the distribution. For example, using GNU unzip and tar:
tar xvf WebCAT.tar
The following directory structure is created.
HTML pages will reside in the WebTools/WebCAT/ directory. The
associated WebCAT executable resides in cgi-bin/. Java classes are
stored in classes/. The Experiments/ subdirectory is the location
where subdirectories are created for each card sorting experiment you
create. The Nursery/ subdirectory is used during design creation and
- The programs in this distribution are compiled for RedHat Linux 8.0. If
you need to compile them for another platform, change your working
directory to WebTools/WebCAT/cgi-bin/sources and "make clean install."
You will need to fix any compilation or linking errors that might occur.
In order to do the following steps, you typically need root privileges.
- Change the owner of the Experiments and Nursery directories, and
all their contents, to the user as whom the web server runs, typically
nobody or apache, and make sure that the user and
group have read, write, and execute permission. It is also useful to
set the set-group-ID bit, so that files created in these directories
will be owned by the same group as the directories. For example:
chown -R <web user> Experiments Nursery
chmod ug=rwx,g+s Experiments Nursery
- Verify that the other directories and files have the right access
controls. The directories need to be readable and executable by the
web server user, the html files need to be readable, and the
executable files in cgi-bin need to be executable.
- Edit your httpd configuration file so that the server can find the
files and CGI programs it will need for WebCAT. e.g., for apache
server we added the following two lines to the configuration file in
ScriptAlias /WebTools/WebCAT/cgi-bin/ /<path>/WebTools/WebCAT/cgi-bin/
Alias /WebTools/ /<path>/WebTools/
(Beware of line wrapping in your web browser. Replace
"<path>" with the actual location on your system
where you untarred the WebCAT distribution.)
- Create the file: .../WebTools/WebVIP/cgi-bin/webmetrics.env. Supply a
URL for the cgi-bin directory and path for WebTools. For example:
- restart httpd