Metacat Source Download and Build Instructions
	KNB Home	Data	People	Informatics	Biocomplexity	Education	Software

Metacat source can be downloaded either by getting and extracting the source distribution, or by checking out the code from the repository.

Reasons for choosing one versus the other might be:

• Source Distribution - this is a faster download since the code is compressed. You might choose this if you want a stable versioned release, but you prefer to have all of your applications built on the server where it will run. (Although it shouldn't matter where a java application is built.)
• SVN Checkout - there are several reasons for choosing a checked out version of the code. One is that you may want to build from the head of the code to pick up new changes that are not yet in a versioned build. Conversely, you may want to build off of an older tag, to avoid an issue that was introduced in a build. Lastly, you may want to develop and submit code to the Metacat repository

In order to check out Metacat, you will need both Subversion (SVN) and CVS clients installed and configured on your system. This is because, while Metacat has been migrated to SVN, some of its supporting libraries (eml, utlities and seek) have not yet been migrated. Eventually, SVN will be the only versioning client you will need. You will need to make sure you have the appropriate permissions on these systems

For more information on installing SVN and CVS, please visit the following sites:

• The Subversion homepage
• The Ximbiot CVS homepage

• The Apache Ant homepage

To get the Metacat source distribution, browse to the KNB Software Download Page. In the Metacat section, for Linux based systems, select the link that looks like:

for Windows systems, select the link that looks like:

where X.X.X is the latest version of Metacat. Choose to save the file locally in the directory where your source should live.

Extract the Metacat package files on Linux systems by typing:

or, on Windows, use your system unzip utility to extract the zip file.

You should see the full Metacat source tree.

To check out the code from SVN, go to the directory where you would like the code to live and type:

If you are trying to check out the head, type:

You should see a list of files as they check out.

You should now have the Metacat source in a directory named "metacat" in your code directory (We will refer to the metacat source directory as <metacat_src_dir>.

Edit the file at:

Make sure that the "build.tomcat.dir" property is set to your tomcat installation directory. For instance:

Metacat will use some of the native Tomcat libraries during the build.

If your cvs user is something other than the user your are logged in as, you will need to change the ${env.USER} part of the cvsroot property to be your cvs user. For instance:

where your cvs user name is "cvs-user"

In the <metacat_src_dir>, run:

You will see the individual modules get built. You will be prompted for your cvs password several times. You should see a "BUILD SUCCESSFUL" message at the end.

You should see a new file named:

This file will be used during the Metacat Installation.