Barracuda DiscRack - Setup & Installation
barracuda.gif (11456 bytes)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:

  1. Download and unpack the latest BarracudaDiscRack release at barracuda.enhydra.org/software/downloads/. This will give you everything in the current build.

  2. See instructions above about jar dependencies and notes about running in Enhydra/Aonyx or another appserver such as Tomcat.

  3. 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.

  4. 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.

  5. 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...