|
 |
 |
 |
 |
 |
 |
Barracuda DiscRack - Setup & Installation |
 |
 |
 |
This document describes how to setup and install
the Barracuda Disc Rack application. Dependencies:
Barracuda - As of 08/17/02 DiscRack is running against Barracuda
latest CVS (which will be 1.1.1 Final shortly), which has been compiled against XMLC-2.1.
However, XMLC-2.1 does not exist in WEB-INF/lib by default. The reason for this is that, normally, you
probably already have XMLC apps running on your server and have XMLC-2.1 and its required libraries
available globally to all webapps. If this assumption doesn't match your situation, you will need to
add the following jars to either WEB-INF/lib or this application or, better yet, put them in a position
globally available to all webapps. In Tomcat-4.x.x, that would be $CATALINA_HOME/lib
($CATALINA_HOME/shared/lib in Tomcat-4.1.x). The jars you need to put there are gnu-regexp-1.1.4.jar,
jtidy-r7-xmlc-2.1.jar, xerces-1.4.4-xmlc-2.1.jar, and xmlc-2.1.jar. These jars are located in
BarracudaDiscRack/WEB-INF/jars for your convenience. Everything else is set to go.
Enhydra - Unfortunately XMLC-2.1 will not run in Enhydra 3.1;
you will need to upgrade to Enhydra 3.1.1b1. Even then, there are some incompatibilities, but
those are fixed by some patches by James Carnegie. Query the Barracua mailing list to get the patches. Even better,
there is a new project called Aonyx which is, basically, the Enhydra open source
server (3.1.1b1) renamed, revitalized, and made to support XMLC-2.1 and the latest Barracuda.
Get it at www.sf.net/projects/webdocwf/. Note that if you use Enhydra or Aonyx,
you will need to remove the hacked enhydra.jar (removed xmlc and related libs) which currently exists in the
WEB-INF/lib of BarracudaDiscRack. Late breaking news... Aonyx (Enhydra 5.0) has moved back to
enhydra.enhydra.org!
Installation:
Download and unpack the latest BarracudaDiscRack release at barracuda.enhydra.org/software/downloads/.
This will give you everything in the current build.
See instructions above about jar dependencies and notes about running in Enhydra/Aonyx
or another appserver such as Tomcat.
Make sure that IDB is working and that your discRack.conf
file in the WEB-INF directory is pointing to the IDB database in your /db directory (you
can create a version of this from sample.discRack.conf in the same
directory). See lines 107 and 108. They are the only ones to concern yourself about.
If you wish to compile the system, just cd to the /src directory and run
"ant clean dist". This assumes that you already have Apache Jakarta Ant
1.4.1 or greater installed with $ANT_HOME/bin added to your system $PATH variable. To see other available Ant "targets",
type "ant -projecthelp". Generally, you should only be concerned about the following
targets:
- ant clean - this will clean the system
- ant compile - will compile all the source
- ant dist - will generate the disc rack war file (default)
- ant javadocs - will generate the javadocs for the project
If you just type 'ant' without any parameters, it will do an 'ant dist' by default.
Add the example as a WAR application to your appserver. Restart the
server and you should be in business...
If you see something missing from here, please
let us know... |
|
 |
 |
 |
 |
 |
 |
For all the latest information on
Barracuda, please refer to http://barracuda.enhydra.org
Questions, comments, feedback? Let
us know... |
|