Metacat

  <p class="header">Tomcat</p>

  <p>

    Install tomcat into the directory of your choice. The directory in which 

  </p>

</tr>

</table>

<table class="tabledefault" width="100%">

<tr>

<td>

  <p>

   version of the source distribution of Metacat.  You can get it two ways.

   Authorized users can check it out of the NCEAS 

   <a href="http://www.nceas.ucsb.edu/cgi-bin/cvsweb.cgi/xmltodb/">CVS</a>

   <a href="@server@/software/download.html">download</a> a gzipped tar file

   from this site.

  </p>

  <p>

   Once you have either checked out or unzipped and untarred the source

   distribution, you can begin the installation process.  Change into the 

   to change a number of configuration properties to match the setup on

   your system.  If you are using oracle, you'll need to customize the

   properties in the "oracle" target.  If you are using Postgres, you'll

   access the installed Metacat server.

  </li>

  <li>

   Web-base-url is the URL from which you want to load any stylesheets 

   or supplementary images.

  </li>

   any DTDs.

  </li>

  <li>

  </li>

  <li>

   The default-style parameter defines the "style-set" that is to be used

   by default when the qformat parameter is missing or set to "html" during

   a query.  It is set to "knb", which is the only style that ships with the

   config-dir (e.g., mystyle.xml) and then change the default-style to use

   your custom style (e.g., "mystyle").

  </li>

  </ul>

  Other properties that you can but generaly need not change:<br />

   Note: DO NOT add a slash [/] to the end of these paths.  Metacat will not

   function correctly if you do so.

  </p>

  <p>

   You now need to set up the table structure in your database.  Change to the

   SQLPlus.  This tutorial assumes an Oracle database so this example is for

   SQLPlus.  Login as the oracle user that was set up for use with Metacat.

   You should see a bunch of output showing the creation of the Metacat table

   space. The first time you run this script you will get several errors at the 

   beginning saying that you cannot drop a table/index/trigger because it 

   does not exist.  This is normal.  Any other errors besides this need to be

  </p>

  <p>

   If the script has run correctly you should be able to type 

</table>

<table class="tabledefault" width="100%">

<tr>

<td>

  <a name="protocol"></a>

  <p>

   Ant allows compilation and installation to be done in one step.

   Change into the metacat directory and type: 

   You should see a bunch of messages telling you the progress of compilation

   and installation.  When it is done you should see the message 

   BUILD SUCCESSFUL

  </p>

  <p>Once metacat itself is installed, you should also register

  the Ecological Metadata Language (EML) DTDs and schemas. This process is done most

  metacat server.  Your database username and password have to be set correctly

  for this to work.

  </p>

  Note: The 'data' directory in the installation directory must be writeable

  by whatever user is running Tomcat or you will not be able to upload data 

  files to the system.

  <p>

   Once you have successfully installed Metacat, there is one more step.  Tomcat

   (and Apache if you have Tomcat integrated with it) must be restarted.  To do

   <pre>

   </pre>

   <pre>

    MetacatServlet Initialize

    Context log path="/metadata" :Metacat: init