Metacat

  it can be run in either of two ways: (A) in a command window, or, (B)

  as a servlet. If you wish only to test that Harvester is functioning, 

  or if you expect to use Harvester infrequently, it may desirable to run it from a 

  command window. However, under most circumstances you will want Harvester to 

  run continuously as a background servlet process. This eliminates the

  need to keep a command window continuously open while Harvester is running.

  Both of these procedures are described below.

  <ul>

  <li> (A) Running Harvester in a Command Window

 </ol>

  number of harvests have been completed, or until you interrupt the process by

  hitting CTRL/C in the command window.

  </li>

  <li> (B) Running Harvester as a Servlet

  <ol>

  <li>Edit the file in your Metcat installation, <code>lib/web.xml.<em>tomcatN</em></code>, where <em>tomcatN</em> corresponds to the

  version of Tomcat you are running. For example, if you are running Tomcat 5,

  edit file <code>lib/web.xml.tomcat5</code>.</li>

  <li>Remove the comment symbols around the HarvesterServlet entry, so that:

  <pre><code>

  <!--

  <servlet>

  <servlet-name>HarvesterServlet</servlet-name>

  <servlet-class>edu.ucsb.nceas.metacat.harvesterClient.HarvesterServlet</servlet-class>

  <init-param>

    <param-name>debug</param-name>

    <param-value>1</param-value>

  </init-param>

  <init-param>

    <param-name>listings</param-name>

    <param-value>true</param-value>

  </init-param>

  <load-on-startup>1</load-on-startup>

  </servlet>

  -->

  </code></pre>

  is changed to:

  <pre><code>

  <servlet>

  <servlet-name>HarvesterServlet</servlet-name>

  <servlet-class>edu.ucsb.nceas.metacat.harvesterClient.HarvesterServlet</servlet-class>

  <init-param>

    <param-name>debug</param-name>

    <param-value>1</param-value>

  </init-param>

  <init-param>

    <param-name>listings</param-name>

    <param-value>true</param-value>

  </init-param>

  <load-on-startup>1</load-on-startup>

  </servlet>

  </code></pre>

  Save the edited file.

  </li>

  <li>Shutdown Tomcat.</li>

  <li>Redeploy Metacat by running the following two ant commands from the top-level

  directory of your Metacat installation:

  <code><pre>

  ant cleanweb

  ant install</code></pre>

  </li>

  <li>Restart Tomcat.</li>

 </ol>

  <p>About thirty seconds after you restart Tomcat, the Harvester servlet will 

  start executing. It will begin its first

  harvest after <code><b>delay</b></code> number of hours (as specified in the

  <a href=../../lib/metacat.properties>metacat.properties</a>

  file). The servlet will continue running a new harvest every

  <code><b>period</b></code> number of hours until a <code><b>maxHarvests</b></code>

  number of harvests have been completed, or until Tomcat shuts down.

  </p>

  </li>

   <h5><a name="Reviewing Harvester">