| 1 |
981
|
tao
|
#
|
| 2 |
666
|
jones
|
# '$RCSfile$'
|
| 3 |
|
|
# '$Author$'
|
| 4 |
|
|
# '$Revision$'
|
| 5 |
|
|
# '$Date$'
|
| 6 |
|
|
#
|
| 7 |
|
|
|
| 8 |
|
|
Metacat: XML Metadata Database
|
| 9 |
|
|
------------------------------
|
| 10 |
|
|
|
| 11 |
981
|
tao
|
Version: 1.1 Release
|
| 12 |
666
|
jones
|
|
| 13 |
861
|
jones
|
Send feedback and bugs to: knb-software@nceas.ucsb.edu
|
| 14 |
696
|
jones
|
|
| 15 |
666
|
jones
|
Contributors: Matt Jones (jones@nceas.ucsb.edu)
|
| 16 |
|
|
Chad Berkley (berkley@nceas.ucsb.edu)
|
| 17 |
981
|
tao
|
Jing Tao (tao@nceas.ucsb.edu)
|
| 18 |
666
|
jones
|
Jivka Bojilova (bojilova@nceas.ucsb.edu)
|
| 19 |
|
|
Dan Higgins (higgins@nceas.ucsb.edu)
|
| 20 |
981
|
tao
|
|
| 21 |
982
|
berkley
|
Metacat is a flexible database storage system for XML formatted
|
| 22 |
666
|
jones
|
documents. Metacat models the structure of the XML document, therefore
|
| 23 |
|
|
allowing storage of XML documents with arbitrary schemas. The current
|
| 24 |
|
|
implementation stores data in a backend Oracle RDBMS, but was designed
|
| 25 |
|
|
to support other RDBMS systems as well. The server supports XML document
|
| 26 |
|
|
storage, retrievel, query, validation, and transformation (using the XSLT
|
| 27 |
|
|
stylesheet language). In addition, there is a mechanism for replicating
|
| 28 |
861
|
jones
|
the database to other metacat instances for backup and load balancing
|
| 29 |
666
|
jones
|
purposes. Metacat currently uses an LDAP database for authenticating
|
| 30 |
|
|
users, but was written to accomodate other authentication services as well.
|
| 31 |
|
|
|
| 32 |
877
|
jones
|
Release Notes
|
| 33 |
|
|
-------------
|
| 34 |
981
|
tao
|
New feature in 1.1:
|
| 35 |
982
|
berkley
|
1) Added functionality to export a zipped data package. The zip file contains
|
| 36 |
|
|
all of the data and metadata as well as a rendered html summary of
|
| 37 |
|
|
the metadata.
|
| 38 |
|
|
2) Changed version control mechanism. Metacat can now except any version of
|
| 39 |
|
|
a document as long as the given version number is greater than the
|
| 40 |
|
|
current one. The new version number does not have to be exactly one
|
| 41 |
|
|
greater than the current version.
|
| 42 |
|
|
3) Update xerces.jar file to version 1.4.4
|
| 43 |
981
|
tao
|
Bugs fixed include:
|
| 44 |
|
|
Fixes in 1.1
|
| 45 |
|
|
1) Fixed problem that if the user exists in one of the referred trees in ldap
|
| 46 |
982
|
berkley
|
server, now authentication will not succeed when the password is
|
| 47 |
|
|
incorrect.
|
| 48 |
|
|
2) Changed the default behavior of the access control functionality
|
| 49 |
|
|
If a member document of data package doesn't have an access control list,
|
| 50 |
983
|
tao
|
access control rules of the main package document will not apply to the
|
| 51 |
982
|
berkley
|
member document.
|
| 52 |
|
|
3) Fixed minor bugs with document access control.
|
| 53 |
|
|
4) Allowed new version of data files to be uploaded and handled.
|
| 54 |
|
|
5) Fixed bug where the client couldn't get principals or groups from ldap
|
| 55 |
981
|
tao
|
server.
|
| 56 |
895
|
berkley
|
Fixes in 1.0.3
|
| 57 |
|
|
1) Fixed problem with Metacat not being able to query for group names when
|
| 58 |
|
|
and LDAP referral server was down. Added an LDAP timeout of 5 seconds
|
| 59 |
|
|
for all referral activity.
|
| 60 |
|
|
2) Fixed problem where invalid xml characters such as ampersands (&) could
|
| 61 |
|
|
be inserted into the resultset xml stream.
|
| 62 |
981
|
tao
|
Fixes in 1.0.2
|
| 63 |
|
|
1) Fixed problem with LDAP locking up Metacat when a referral server
|
| 64 |
|
|
was not available.
|
| 65 |
|
|
Fixes in 1.0.1
|
| 66 |
|
|
1) Fixed problem with authenticating using LDAP referrals
|
| 67 |
|
|
2) Fixed bug that prevent groups from being used in access documents
|
| 68 |
883
|
jones
|
Installation
|
| 69 |
|
|
------------
|
| 70 |
|
|
See the file "docs/user/metacatinstall.html" for detailed instructions.
|
| 71 |
|
|
|
| 72 |
861
|
jones
|
Documentation
|
| 73 |
|
|
-------------
|
| 74 |
666
|
jones
|
See the docs directory for detailed documentation and installation
|
| 75 |
|
|
instructions.
|
| 76 |
|
|
|
| 77 |
|
|
Details of the Metacat architecture can be found on the website for
|
| 78 |
|
|
the Knowledge Network for Biocomplexity (KNB):
|
| 79 |
|
|
|
| 80 |
805
|
jones
|
http://knb.ecoinformatics.org/software/metacat/
|
| 81 |
666
|
jones
|
|
| 82 |
|
|
Contributions to this work are welcome. Please see the above web site
|
| 83 |
|
|
for details on how to contribute.
|
| 84 |
|
|
|
| 85 |
848
|
jones
|
Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)
|
| 86 |
|
|
-----------------------------------------------------------------------------
|
| 87 |
982
|
berkley
|
If you discover a bug
|
| 88 |
861
|
jones
|
please report it, either by email (above) or by using our bug tracking
|
| 89 |
|
|
system (http://bugzilla.ecoinformatics.org). There is a list of currently
|
| 90 |
|
|
unimplemented features in Bugzilla that we are working on for the next
|
| 91 |
|
|
release (no, we don't have a date yet!).
|
| 92 |
805
|
jones
|
|
| 93 |
|
|
Legalese
|
| 94 |
|
|
--------
|
| 95 |
666
|
jones
|
This software is copyrighted by The Regents of the University of California
|
| 96 |
|
|
and the National Center for Ecological Analysis and Synthesis
|
| 97 |
|
|
and licensed under the GNU GPL; see the 'LICENSE' file for
|
| 98 |
|
|
details.
|
| 99 |
|
|
|
| 100 |
|
|
This material is based upon work supported by the
|
| 101 |
|
|
National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.
|
| 102 |
|
|
Any opinions, findings and conclusions or recomendations expressed in this
|
| 103 |
|
|
material are those of the author(s) and do not necessarily reflect
|
| 104 |
|
|
the views of the National Science Foundation (NSF).
|