Metacat

<td class="tablehead" colspan="2"><p><a name="The Table of Contents">The Table of Contents</p></td>

        <li>

         <a HREF="metacatinstall.html#Upgrade">Compilation and Upgrading Existing Metacat</a>

      </li>

<td class="tablehead" colspan="2"><p><a name="Operating System Specific Instructions">Operating System Specific Instructions</p></td>

  <p>This section is only for a fresh installation. If you are upgrading an existing Metacat, please skip

  this section and go to the next one -  <a HREF="metacatinstall.html#Upgrade">Compilation and Upgrading Existing Metacat</a>

  <p>    

  <h2>Run Ant Build</h2></p>

  'inlinedatafilepath' build properties must be writable

  <p>    

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

   do this either using the ant build system, or by manually running the

  see the instructions for <a HREF="metacatinstall.html#Upgrade">"Compilation and Upgrading Existing Metacat"</a> below.</b></p>

  <p>To run the scripts using ant, type

   <pre><b>ant installdb</b></pre> 

  <p><h2>Register schemas and DTDs</h2></p>

  <h2>Restart Tomcat</h2>

   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

   this, login as the user that runs your tomcat server (often "tomcat"),

   go to $CATALINA_HOME/bin and type:

   <pre>

   <b>

   ./shutdown.sh 

   ./startup.sh

   </b> 

   </pre>

   In the Tomcat startup messages you should see something in the log file like:

   <pre>

	Metacat: [WARN]: Metacat (1.7.1) initialized. [edu.ucsb.nceas.metacat.MetaCatServlet]

   </pre>

   If you see that message Tomcat is successfully loading the Metacat servlet.

   Next, try to run your new servlet.  Go to a web browser and type:

   <pre>http://yourserver.yourdomain.com/yourcontext/</pre>

   You should substitute your context name for "yourcontext" in the url above.

   If everything is working correctly, you should see a query page followed

   by an empty result set.  Note that if you do not have Tomcat integrated with

   Apache you will probably have to type

   <pre>http://yourserver.yourdomain.com:8080/yourcontext/</pre>

  </p>

  <p><b>Troubleshooting</b>: If you see something like java.lang.InternalError: 

  Can't connect to X11 window server using 'yourservanme:0.0' as the value of the DISPLAY variable.

  <p>You should add this line: 

  <b>JAVA_OPTS="-Djava.awt.headless=true $JAVA_OPTS"</b> at the first line of

  catalina.sh file in tomcat bin directory. The reason is that GeoServer uses X11 windows to draw graphics.

  </p>

  <h2>Deploy wsdl file (Only for EarthGrid-enabled Metacat installation) </h2>

  <p>

   Once Tomcat is running successfully, there is another step for EarthGrid-enabled Metacat installation. 

   In metacat directory, type:

   <pre><b>ant deploy-ecogrid</b></pre> 

   It will generate wsdl files for EarthGrid services.

   </p>

</td>

</tr>

</table>

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

<td class="tablehead" colspan="2"><p><a name="Upgrade"><h2>Compilation and Upgrading Existing Metacat</h2></p></td>

<tr>

<td>

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

  <p>The following instructions are for upgrading an existing Metacat.

  <p><h2>Stop the running Metacat</h2>

   <P>To do this, login as the user that runs your tomcat server (often "tomcat"),

   go to $CATALINA_HOME/bin and type:

   <pre><b>./shutdown.sh</b> </pre>

  <p>    

  <h2>Run Ant Build</h2></p>

  <p>

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

   Change into the metacat directory and type: 

   <pre><b>ant clean upgrade</b></pre>

   <p>

   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

   and you should be returned to a UNIX command prompt.  If you do not see

   the message BUILD SUCCESSFUL then there was an error that you need to 

   resolve.

   This may come up if you are logged in as a user that does not have write

   access to one or more of the directories that are listed in the build.xml

   file, or if any of the paths to files are not configured correctly in the

   "config" target.

  </p>

  <p>

  Note: The 'data' directories that are indicated in the 'datafilepath' and

  'inlinedatafilepath' build properties must be writable

  by user account under which Tomcat runs or you will not be able to upload 

  data files to the system.

  </p>

  <p class="header">To install metacat LSID support, adjust the LSID-related

    properties in the build.properties files and type:

  <p class="header"><b>ant deploy-lsid</b>

  <p><h2>Upgrade SQL Scripts</h2></p>

  <p>

   <b>

   ./startup.sh

   </b> 

	Metacat: [WARN]: Metacat (1.7.1) initialized. [edu.ucsb.nceas.metacat.MetaCatServlet]