Metacat

              Jing Tao (tao@nceas.ucsb.edu)

              Jivka Bojilova (bojilova@nceas.ucsb.edu)

              Dan Higgins (higgins@nceas.ucsb.edu)

Metacat is a flexible database storage system for XML formatted

documents. Metacat models the structure of the XML document, therefore

allowing storage of XML documents with arbitrary schemas. Metacat supports

Release Notes

For Oracle user: At the SQLPLUS prompt type the following -

@src/xmlreplicationtable.sql

For Postgresql user: At install directory prompt type the following -

psql exp < src/xmlreplicationtable_postgres.sql

-------------

  New features in 1.2.0:

  2) New replication features

  3) Added partial SSL support

  4) Additional bugs fixed, see http://bugzilla.ecoinformatics.org

     479   Debug message level

  New features in 1.1.0:

  1) Added functionality to export a zipped data package. The zip file contains

     all of the data and metadata as well as a rendered html summary of

     the metadata.

     a document as long as the given version number is greater than the

     current one.  The new version number does not have to be exactly one

     greater than the current version.

  Fixes in 1.1.0

   1) Fixed ldap authentication bug.  Now, a user from a referred server cannot

      login with an incorrect password.

      respect to packaging.

      member document.  Previously, package members, by default, inherited

      the access control rules of the main package document.

   3) Fixed minor bugs with document access control.

   4) Allowed new version of data files to be uploaded and handled.

      the ldap server.

  Fixes in 1.0.3

   1) Fixed problem with Metacat not being able to query for group names when

      and LDAP referral server was down.  Added an LDAP timeout of 5 seconds

      for all referral activity.

   2) Fixed problem where invalid xml characters such as ampersands (&) could

  Fixes in 1.0.2

   1) Fixed problem with LDAP locking up Metacat when a referral server

      was not available.

Documentation

-------------

instructions.

the Knowledge Network for Biocomplexity (KNB):

  http://knb.ecoinformatics.org/software/metacat/

If you discover a bug

please report it, either by email (above) or by using our bug tracking

system (http://bugzilla.ecoinformatics.org). There is a list of currently

release (no, we don't have a date yet!).

Legalese

and licensed under the GNU GPL; see the 'LICENSE' file for

details.

National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.

Any opinions, findings and conclusions or recomendations expressed in this

the views of the National Science Foundation (NSF).

Foundation (http://www.apache.org/). See the LICENSE file in lib/apache

for details.

package is copyright and owned by Jason Hunter. See the cos-license.html file

Software and all enhancements, modifications, and updates to the Software.

<?xml version="1.0"?>

  *   '$RCSfile$'

  *     Authors: Matt Jones, Chad Berkley, Jivka Bojilova

  *   Copyright: 2000 Regents of the University of California and the

  * You should have received a copy of the GNU General Public License

  * along with this program; if not, write to the Free Software

  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

<project name="metacat" default="jar" basedir=".">

   <target name="oracle">

     <property name="oracle_home" value="/oracle01/app/oracle/product/8.1.6" />

     <property name="jdbc" value="${oracle_home}/jdbc/lib/classes111.zip" />

   </target>

   <target name="postgresql">

     <!-- Customize these properties if you are using postgres -->

               value="jdbc:postgresql://localhost/exp"/>

     <property name="dbDriver" value="org.postgresql.Driver"/>

               value="edu.ucsb.nceas.dbadapter.PostgresqlAdapter"/>

     <property name="jdbc" value="lib/jdbc7.1-1.2.jar" />

   </target>

   <target name="config" depends="oracle">

           metacat with postgres instead of oracle -->

      <!-- Customize these properties for your system -->

      <property name="tomcat" value="/usr/local/devtools/jakarta-tomcat" />

      <property name="webapps" value="/opt/tomcat/webapps" />

      <property name="password" value="your-pw-goes-here"/>

      <property name="forcereplicationwaitingtime" value="30000"/>

                value="http://knb.ecoinformatics.org"/>

      <property name="default-style" value="knb" />

      <property name="morphosourcedir" value="morpho" />

      <!-- Make sure these paths match the location of the jar files

           on your system, the defaults should usually work -->

                value="${tomcat}/lib/common/servlet.jar" />

                value="lib/xerces.jar" />

                value="lib/srbrmi" />

                value="lib/cos.jar" />

      <property name="morpho"

                value="lib/morpho.jar" />

      <property name="httpclient"

                value="${morphosourcedir}/lib/httpclient.jar" />

      <property name="itis"

  </target>

      <property name="name" value="metacat"/>

      <property name="Name" value="MetaCat"/>

      <property name="release" value="1.2.0"/>

                value="/${context}/servlet/replication"/>

      <property name="servlet-path" value="/${context}/servlet/metacat"/>

      <property name="html-path" value="/${context}"/>

      <property name="eml-module" value="eml" />

      <property name="eml-version" value="2.0.0beta6" />

      <property name="eml-tag" value="RELEASE_EML_2_0_0_BETA_6_REV1" />

                value=":ext:jones@cvs.ecoinformatics.org:/cvs" />

                value="${xmlp}:${xalan}:${apis}:${jdbc}:${jsdk}:${srb}:${cos}:${morpho}"/>

      <filter token="docrooturl" value="./" />

      <property name="package.home" value="edu/ucsb/nceas/metacat" />

   </target>

   <target name="prepare" depends="init">

      <mkdir dir="${build.dir}"/>

      <mkdir dir="${build.src}"/>

   </target>

   <target name="compile" depends="prepare">

             filtering="yes" />

             tofile="${build.dest}/${package.home}/srbProps.properties"/>

   <target name="jar" depends="compile">

       <delete file="${build.dir}/${name}.jar" />

       </copy>

       <jar jarfile="${build.dir}/${name}.jar" basedir="${build.dest}"

            excludes="**/protocols/" />

   <target name="protocol" depends="compile">

       <delete file="${build.dir}/protocol.jar" />

       <jar jarfile="${build.dir}/protocol.jar" basedir="${build.dest}"

            includes="**/protocols/" />

   <target name="getdtd" depends="prepare">

     <echo>Enter CVS password: </echo>

     </copy>

     <copy todir="lib/style" filtering="yes">

       <fileset dir="${build.src}/${eml-module}/style">

     </copy>

   </target>

       <mkdir dir="${datafilepath}" />

       <chmod dir="${datafilepath}" perm="ug+w" />

       <mkdir dir="${installdir}/WEB-INF/lib" />

             tofile="${installdir}/WEB-INF/lib/${name}.jar" />

             tofile="${installdir}/WEB-INF/lib/xerces.jar" />

             tofile="${installdir}/WEB-INF/lib/xalan.jar" />

             tofile="${installdir}/WEB-INF/lib/xml-apis.jar" />

             tofile="${installdir}/WEB-INF/lib/oracle-jdbc111.jar" />

             tofile="${installdir}/WEB-INF/lib/cos.jar" />

       <copy file="${morpho}"

             tofile="${installdir}/WEB-INF/web.xml" />

       <copy todir="${build.img}" filtering="no">

         <fileset dir="lib">

              done by using the "ant dtdsql" which will run it for you.

             ***********************************************************

       </echo>

   <target name="test" depends="install">

      <!-- copy and compile the tests into a jar file -->

      <mkdir dir="${build.metacattest}"/>

      <javac srcdir="${junittestsdir}"

             destdir="${build.metacattest}"

             classpath="${cpath}:${build.dir}/${name}.jar"

      <!-- use the ant "junit" task to run JUnit tests. -->

      <junit printsummary="yes" haltonfailure="no" fork="no"

   </target>

  <target name="gethttpclient" depends="prepare">

        <cvs cvsRoot=":ext:tao@cvs.ecoinformatics.org:/cvs"

             package="morpho"

             dest="." />

   <!-- run this target, we need to check out a another morpho souce dir was checked out. -->

   <target name="nettest" depends="install">

      <echo>***********************************

      </echo>

      <!-- copy and compile the tests into a jar file -->

      <mkdir dir="${build.metacatnettest}"/>

          </fileset>

        </batchtest>

     </junit>

   <target name="clean" depends="init">

       <delete dir="${build.dir}" />

      <delete dir="${ver.dir}" />

      <mkdir dir="${ver.dir}"/>

      <copy todir="${ver.dir}">

            excludes="**/CVS* **/.#* **/src* **/test* **/build* **/docs* ${dist.dir}"/>

      </copy>

      <copy todir="${ver.dir}" file="build.xml"/>

      <zip zipfile="./${name}-${release}.zip" basedir="${dist.dir}"/>

      <delete file="./${name}-${release}.tar.gz" />

      <tar tarfile="./${name}-${release}.tar" basedir="${dist.dir}"/>

                src="./${name}-${release}.tar"/>

      <delete file="./${name}-${release}.tar" />

  <target name="distsrc" depends="dist">

      <mkdir dir="${ver.src}"/>

      <zip zipfile="./${name}-src-${release}.zip" basedir="${dist.dir}"/>

      <delete file="./${name}-src-${release}.tar.gz" />

      <tar tarfile="./${name}-src-${release}.tar" basedir="${dist.dir}"/>

                src="./${name}-src-${release}.tar"/>

      <delete file="./${name}-src-${release}.tar" />

      <delete dir="${dist.dir}"/>

</project>