Metacat

#

#   '$Author$'

# '$Revision$'

#     '$Date$'

#

Metacat: XML Metadata Database

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

                           http://bugzilla.ecoinformatics.org

              Chad Berkley (berkley@nceas.ucsb.edu)

              Dan Higgins (higgins@nceas.ucsb.edu)

              Duane Costa (dcosta@lternet.edu)

XML document, therefore allowing storage of XML documents with arbitrary

schemas. Metacat supports several databases on the back-end, including Oracle,

PostgreSQL and SQL Server (limited).  The server supports XML document

storage, retrievel, query, validation, and transformation (using the XSLT

stylesheet language).  In addition, there is a mechanism for replicating the

database to other metacat instances for backup and load balancing purposes.

Metacat currently uses an LDAP database for authenticating users, but was

written to accomodate other authentication services as well.

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

This is a major release, and is the first to introduce many new features to

Metacat.  Some of the major new features in this version of Metacat include:

* Added a new 'Harvester' that allows documents to be periodically pulled

  from distributed sources into metacat, useful for interfacing with other

  system types. See the Metacat Tour for details.

* Added new 'skins' capability to allow the GUI for the metacat web interface

  to be more easily customized to fit into site needs.  The skin is based on

  a flexible mix of XSLT, CSS, and Javascript.

* Added a web-based metadata entry form for submitting EML limited EML documents

  as part of a data registry.  The GUI for the registry is customizable and

  is integrated with the 'skins' system for the main metacat interface.  The

  registry subsystem is written in Perl, and can simultaneously be used to

  present multiple 'registry' interfaces.

* A new 'client API' has been developed and implemented in Java and in Perl

  so that metacat functions can be accessed from any program in those

  languages.  The client API supports the major metacat servlet actions,

  including login(), logout(), query(), insert(), update(), delete(), and

  upload(). See the Metacat Tour for details.

* Added a new 'getlog' action that produces a usage history for all major

  events.  So now an XML report can be generated for document reads, inserts,

  deletes, etc.  See the new section in the Metacat Tour.

* Added a new 'buildindex' action that can rebuild the index entries for any

  document in the database.

* The configuration file for metacat (metacat.properties) has been moved out

  of the jar file and into the WEB-INF directory, allowing far easier changes

  to the configuration parameters.

* Results in default web interface are sorted by title in the XSLT (configurable)

* Several significant and insignificant bugs were fixed.

Details of all changes can be found in the bug database here:

http://bugzilla.ecoinformatics.org/buglist.cgi?product=Metacat&target_milestone=1.4

include:

    Java 1.3 and Java 1.4. Currently, Metacat 1.3.1 will work in both Java 1.3

    and Java 1.4.

Release Notes for 1.3.0

In 1.3.0 release, the structure of the xml_access table was changed and a new

installed Metacat, you should run a script file to updated the table structure

before installation.

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

@src/reviseformetacat13.sql

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

psql exp < src/reviseformetacat13_postgres.sql

(where 'exp' is the database name).

schema in xml_catalog table.

If you are a new Metacat user, this step is unneeded.

         it will cause potential replication issues.

      2) Delete the xercesImpl.jar and xmlParserAPIs.jar files

         which are in $CATALINA_HOME/common/endorsed. They are old version and

         don't support XML schema validation.

  1) Partialy support EML2 document. User can store, query, read and write

     EML2 documents. However, Metacat only support access control in resource

     level. The subtree level access control will be ignored.

  2) Support other xml document base on namespace/schema.

  3) Support query for attribute value

  4) Assign MIME type to data file base on metadata when user try to read it.

  5) Owner can assign access rules to a document which does not have access

     document to apply it.

  6) Support exporting single file, not only whole package

Fixes in 1.3.0:

  1) Couldn't finish delta T replication for large set of documents.

  2) Couldn't create access control during delta T replication.

  3) Eorr will be written to a seperated log file if some documents

     were failed in replication.

  4) Decrease the time to create access rules during insert or update

     a package.

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

See the file "docs/user/metacatinstall.html" for detailed instructions.

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

Contributions to this work are welcome.  Please see the above web site

for details on how to contribute.

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

our bug tracking system (http://bugzilla.ecoinformatics.org). There is a

list of currently unimplemented features in Bugzilla that we are working on

for the next release.

Legalese

--------

and the National Center for Ecological Analysis and Synthesis

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

details.

0225676.  Any opinions, findings and conclusions or recomendations expressed

in this material are those of the author(s) and do not necessarily reflect

for details.