###############################################################################
This is the 2dF QSO Redshift Survey (2QZ) final data release CD-ROM.  It
contains the catalogue and spectra as well as other related data
products for almost 50000 objects observed with the 2-degree Field 
instrument at the Anglo-Australian Telescope as part of the 2QZ.  We also
include data taken using the 6-degree Field instrument on the UK Schmidt
Telescope, as part of the 6QZ, the bright extension to the 2QZ.

We expect users to generally look at the catalogue via the search tool
which uses a web browser to interactively search the catalogue and
look at spectra. The search tool has the following requirements:

1) A UNIX/Linux operating system
2) write permission on /tmp
3) perl at a location in the user's $PATH. (versions 5.002 or later have
   been tested, though earlier versions probably work.)
4) netscape web browser (Only netscape has been tested. Other web
   browsers could be tried, however this would require you to copy the
   scripts which run the code to you local disk and edit them).
5) The environment variable $PWD to be set to the current working
   directory (should be the default on most/all UNIX/Linux systems).

TO RUN:
1) Close any currently running Netscape.
1) cd to the base directory of the CD-ROM (e.g. cd /cdrom/cdrom0/)
2) Type: ./2QZ.sh &
3) Follow the links to the search engine on the www page.

WHAT HAPPENS:
The above script (2QZ.sh) starts up a mini, local http/web
server via the CGIservlet-1.2.pl script.  This local http server can
then be used to run CGI scripts locally without the need to pass them
to an external server. It has been configured to only accept requests
from the actual machine it is running on and therefore cannot be contacted
by any other computer. It will not function as a general purpose
web server. We then start up netscape and point it
towards the 2QZ html pages and search engine stored locally on the
CD-ROM.  A command to kill the server is written to /tmp/2qz.log on
start up, so when netscape is quit "sh /tmp/2qz.log" will kill the web
server.  Finally if the search engine has written a 2QZ catalogue file
to /tmp/2QZ.out this is cleaned up as well.

This method of running CGI scripts is a little experimental, but has
the advantage of hopefully being platform independent within the UNIX/Linux
environment.

IF IT DOESN'T WORK:
1) Make sure that there isn't already a version of the CGI servlet
   running on your machine (from a previous run of 2QZ.sh which may
   have failed to clean up after itself).  Try: "ps -a | grep perl"
   to see if this is the case, and then kill the process.
2) Make sure the path to the CD doesn't contain a #.  The volcheck
   command which can be used to mount CDs can append random characters
   to the end of the volume name, so that your path may be: 
   /cdrom/2qz_cat#2/ when the volume name was actually 2qz_cat.
   Netscape will fail to load files with a # in their path.  If this
   is a problem use the /cdrom/cdrom0/ (or similar alternative) path which
   is a symbolic link to the volume name (or make your own symbolic
   link).  This has been found to be a problem on some Solaris machines.
3) read the html pages by loading them from the File menu on your
   browser or by typing: netscape $PWD/html/formfail.html
   from this directory.
4) use the online catalogue at www.2dfquasar.org
5) use the command line search tool: cat_search.pl

The data area available directly in the following directories:

cat/        - 2QZ catalogue files and extra info.
code/       - Assorted software for 2QZ analysis
comp/       - The coverage and completeness for the sample
composites/ - Composite spectra (From Croom et al 2002, MNRAS, 337, 275)
fits/       - FITS format spectra for every object in the data release.
html/       - Pages and scripts for the 2QZ search Tool etc. 
papers/     - related 2QZ papers.
png/        - PNG format images of the spectra.


SMC & RJS 26/05/03
###############################################################################