Metacat

  <p>You'll need a recent Java SDK; j2sdk1.4.2 or later is required.  We haven't 

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

    We recommend that you install Tomcat version 4.0.  More details about 

    Tomcat installation is available <a href=" http://jakarta.apache.org/tomcat/index.html">here</a>.

  <p><h2>Edit <code>build.properties</code> File</h2></p>

   metacat directory and edit the file called "<code>build.properties</code>".  You will need 

   your system.

  The properties that you will likely need to change will include 

  <code>tomcat</code>, <code>tomcatversion</code>, <code>webapps</code>, 

  <code>context</code>, <code>server</code>, <code>httpserver</code>, 

  <code>database</code>, <code>jdbc-connect</code>, <code>jdbc-base</code>, 

  <code>user</code>, <code>password</code>, <code>datafilepath</code>, 

  <code>inlinedatafilepath</code>, <code>cvsroot</code>, 

  <code>cvsroot-alternate</code>, and <code>default-style</code>. 

  Each is described in detail in the table below.

  Properties you will likely need to change:

  <br><br>

  <table border="1">

    <tr>

      <td><b>Property</b></td>

      <td><b>Description</b></td>

      <td><b>Default value and examples of other values</b></td>

    </tr>

    <tr>

      <td>tomcat</td>

      <td>The tomcat property is the location in which tomcat is installed.</td>

      <td>Default:&nbsp;&nbsp;

          <code>/usr/local/devtools/jakarta-tomcat</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>C:/Tomcat4</code></td>

    </tr>

    <tr>

      <td>tomcatversion</td>

      <td>The tomcatversion property is the version of your Tomcat. You should 

          put tomcat3 or tomcat4 here.</td>

      <td>Default:&nbsp;&nbsp;

          <code>tomcat4</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>tomcat3</code>

      </td>

    </tr>

    <tr>

      <td>webapps</td>

      <td>The webapps property is the location in which your tomcat servlet 

          contexts are installed. This is typically "TOMCAT_HOME/webapps",

          where TOMCAT_HOME is the same value that you entered for the 'tomcat'

          property above.

      </td>

      <td>Default:&nbsp;&nbsp;

          <code>/var/www/org.ecoinformatics.knb</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>C:/Tomcat4/webapps</code>

      </td>

    </tr>

    <tr>

      <td>context</td>

      <td>The context property is the name of the servlet context in which you 

          want Metacat to be installed. This will determine the installation 

          directory for the servlet and many of the URLs that are used to access

          the installed Metacat server.</td>

      <td>Default:&nbsp;&nbsp;

          <code>knb</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>mycontext</code>

      </td>

    </tr>

    <tr>

      <td>server</td>

      <td>The server property is the secure HTTPS address on which Metacat is 

          running (note that you should not include the 'http://' in the server 

          property). The server setting should include the SSL port number 

          appended to the end if Tomcat is running stand-alone (see example).</td>

      <td>Default:&nbsp;&nbsp;

         <code>knb.ecoinformatics.org</code>

      <br><br>Example:&nbsp;&nbsp;

         <code>somehost.university.edu:8443</code>

      </td>

    </tr>

    <tr>

      <td>httpserver</td>

      <td>httpserver is the plain HTTP address on which Metacat is running 

          (note that you should not include the 'http://' in the httpserver property).

          The httpserver setting should include the HTTP plain port number 

          appended to the end if Tomcat is running stand-alone (see example).</td>

      <td>Default:&nbsp;&nbsp;

          <code>knb.ecoinformatics.org</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>somehost.university.edu:8080</code>

      </td>

    </tr>

    <tr>

      <td>ldapUrl</td>

      <td>URL to the LDAP server</td>

      <td>Default:&nbsp;&nbsp;

          <code>ldap://ldap.ecoinformatics.org/dc=ecoinformatics,dc=org</code>

      </td>

    </tr>

    <tr>

      <td>database</td>

      <td>Select the database to use for metadata storage.

          Valid values are <code>oracle</code>, <code>postgresql</code>, or

          <code>sqlserver</code>.

      </td>

      <td>Default:&nbsp;&nbsp;

          <code>oracle</code>

      <br><br>Other possible values:&nbsp;&nbsp;

          <code>postgresql</code>&nbsp;&nbsp;

          <code>sqlserver</code>

      </td>

    </tr>

    <tr>

      <td>jdbc-connect</td>

      <td>The JDBC connection string used to connect to the database.</td>

      <td>Default:&nbsp;&nbsp;

          <code>jdbc:oracle:thin:@metacat.nceas.ucsb.edu:1521:knb</code>

      </td>

    <tr>

      <td>jdbc-base</td>

      <td>The base directory for locating JDBC jar files (not needed for postgresql).</td>

      <td>Default:&nbsp;&nbsp;

          <code>/usr/oracle/jdbc/lib</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>C:/jdev10g/jdbc/lib</code><br>

      </td>

    </tr>

    <tr>

      <td>user</td>

      <td>The database user name that you set up to use Metacat. For example, 

          an Oracle username.</td>

      <td>Default:&nbsp;&nbsp;

          <code>knb</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>metacatdb</code>

      </td>

    </tr>

    <tr>

      <td>password</td>

      <td>The database password that you set up to use Metacat.</td>

      <td>Default:&nbsp;&nbsp;

          <code>yourPasswordHere</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>metacat123</code>

      </td>

    </tr>

    <tr>

      <td>datafilepath</td>

      <td>The datafilepath is the directory to store the data file.</td>

      <td>Default:&nbsp;&nbsp;

          <code>/var/metacat/data</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>C:/Tomcat4/data/knb/data</code>

      </td>

    </tr>

    <tr>

      <td>inlinedatafilepath</td>

      <td>The inlinedatafilepath is the directory to store inline data.</td>

      <td>Default:&nbsp;&nbsp;

          <code>/var/metacat/inline-data</code>

      <br><br>Example:&nbsp;&nbsp;

          <code>C:/Tomcat4/data/knb/inlinedata</code>

      </td>

    </tr>

    <tr>

      <td>cvsroot</td>

      <td>CVS access to retrieve latest EML.</td>

      <td>Default:&nbsp;&nbsp;

          <code><pre>:ext:${env.USER}@cvs.ecoinformatics.org:/cvs</pre></code>

          Example:  

          <code><pre>:ext:myaccount@cvs.ecoinformatics.org:/cvs</pre></code>

      </td>

    </tr>

    <tr>

      <td>cvsroot-alternate</td>

      <td>CVS access to retrieve latest conversion styles.</td>

      <td>Default:&nbsp;&nbsp;

          <code><pre>:ext:${env.USER}@cvs.nceas.ucsb.edu:/cvs/pbi</pre></code>

          Example:  

          <code><pre>:ext:myaccount@cvs.nceas.ucsb.edu:/cvs/pbi</pre></code>

      </td>

    </tr>

    <tr>

      <td>default-style</td>

      <td>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 one of the styles that 

          ships with the default metacat distribution. Other possible settings

          are shown in the examples to the right.</td>

      <td>Default:&nbsp;&nbsp;

          <code>knb</code>

      <br><br>Examples:&nbsp;&nbsp;

          <pre><code>default   esa   knb2   nceas   nrs   obfs   specnet</code></pre>

      </td>

    </tr>

  </table>

  <br>

   Oracle, PostgreSQL, or Microsoft SQL Server as a backend database.  

   To change the database system, simply change the value of the 'database' 

   property to be the name of the database target that you wish to use 

   (either 'oracle', 'postgresql', or 'sqlserver').

  Other properties in <code>build.properties</code> that you can (but generally need not) change:<br />

  <br>

  <table border="1">

    <tr>

      <td><b>Property</b></td>

      <td><b>Description</b></td>

      <td><b>Default value and examples of other values</b></td>

    </tr>

    <tr>

      <td>inst.cgi.dir</td>

      <td>Installation directory for registry CGI scripts</td>

      <td>Default:&nbsp;&nbsp;

          <code>/var/www/cgi-knb</code>

      </td>

    </tr>

    <tr>

      <td>cgi-prefix</td>

      <td>&nbsp;</td>

      <td>Default:&nbsp;&nbsp;

          <code>http://knb.ecoinformatics.org/cgi-bin</code>

      </td>

    </tr>

    <tr>

      <td>knb-site-url</td>

      <td>This is the URL to the web context root for the knb site. 

          It is used for the qformat=knb skin only.</td>

      <td>Default:&nbsp;&nbsp;

          <code>http://knb.ecoinformatics.org</code>

      </td>

    </tr>

    <tr>

      <td>forcereplicationwaitingtime</td>

      <td>The waiting time before replication is forced to begin after

          uploading a package. The default value should usually suffice.</td>

      <td>Default:&nbsp;&nbsp;

          <code>30000</code>

          <code>&nbsp;</code>

      </td>

    </tr>

  </table>

  <p>

  Metacat has a number of additional settable properties in file

  <code>metacat/lib/metacat.properties</code>. Under most circumstances,

  you will not need to modify this file because the properties of interest

  to you can be controlled by editing <code>build.properties</code> as

  described above. To learn more about Metacat's additional properties,

  see <a href="./properties.html">Metacat Properties File</a>.

  </p>

   Note: When setting properties, DO NOT add a trailing slash [/] to the end of any paths that are specified.

   Metacat will not function correctly if you do so.

   metacat/build/src directory.  Then run you RDBMS's SQL utility.  In Oracle it is

   xmltables-postgres.sql and for Microsoft SQL server is 

    to 1.4, you would need to run all three scripts in sequence:

    upgrade-db-to-1.2.sql, upgrade-db-to-1.3.sql, and upgrade-db-to-1.4.sql. 

    However, if you were starting from a Metacat 1.3.x

    installation, you would only need to run the upgrade-db-to-1.4.sql script.

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