CVW Files

README file for CVW 4.0 Document server
Stephen Jones, The MITRE Corporation

This is my first *very rough* cut at putting together some documentation. A lot of this will come off the top
of my head, but I wanted to get this out there  for people to try out. I highly recommend reading the documentation
for both MySQL and Tomcat, as these two programs make up the bulk of the new document server. For an overview of 
what I was trying to do from an architectural perspective, see http://cvw.sourceforge.net/cvw/info/docs40/ArchOverview.php3.
You can look over the Installation Guide also, but this particular release is a bit different. 

How to install the 4.0 Document Server

1) Download the tarball off the SourceForge site and save to a temporary directory. Move to the directory where you want
to install the document server and unpackage. By default, I set up the document server to be at /opt/CVWdocserver40, but
you can change that to whatever you like:

	mkdir /opt/CVWdocserver40
	cd /opt/CVWdocserver40
	gunzip cvw-Linux2-docserver-4.0.tar.gz | tar xvf -

2) The Tomcat server needs to have some variables configured for it to start correctly. First, you need to set the port
that the CVW client will look to connect to the document server. This is defined in jakarta/tomcat/conf/server.xml with
a default value of 8080. If needed, you could also change the port the document server uses to connect to the servlets,
but I would recommend keeping the default 8007 value.

Next, we need to define some startup values for the servlet. Move to jakarta/tomcat/webapps/app/WEB-INF and modify 
web.xml. Most of the default values should be ok, unless you run the database server on another machine (which can
be done and maybe someday I'll go into that in more detail). The logfile is used by the DbConnectionBroker library and
can be whatever you like. The driver is the JDBC driver used to connect the servlet to the database; if you want to use
another driver, then change that value. The username and password values are a wide open MySQL account I've set up by 
default; you can change these also if you want to create another account or change the password of dsuser. (See MySQL docs 
for that)

3) Ok, as a last step modify the cvwds.boot script. Here you will have to make changes if you installed in a directory other
than /opt/CVWdocserver40. 

4) Now you should be able to startup the document server. As root and using the script just modified, type the following 
command:

	cvwds.boot start

The server can be halted using 

	cvwds.boot stop

As a check, you should see both mysql and tomcat processes running. The tomcat documents also describe test servlets you
can run to make sure everything works. Also check out the CVW Admin Guide for further information.