Project

General

Profile

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 861 jones
This is Metacat, 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
Update xerces.jar file in xmltodb/lib to version 1.4.4 in release 1.1
35
New feature in 1.1:
36
  1) Metacat can export a zip file for a data package with a summary of html
37
     file.
38
  2) Metacat can except new version of a dcoument only it is greater than
39
     current one, not exactly one greater.
40
  3) Create a JUnit test frame for Metacat. However, we need put more test
41
     classes there.
42
Bugs fixed include:
43
  Fixes in 1.1
44
   1) Fixed problem that if the user exists in one of the referred trees in ldap
45
      server,authentication will succeed whether the password is correct or not.
46
   2) Delete a rule in access control of documents which may cause problem:
47
      If a member document of data package doesn't have access control list,
48
      access control of data set document will apply to the member document.
49
   3) Fixed problem about dcouments access control.
50
   4) Fixed problem that data file version couldn't increase.
51
   5) Fixed problem that client couldn't get principals or groups from ldap
52
      server.
53 895 berkley
  Fixes in 1.0.3
54
   1) Fixed problem with Metacat not being able to query for group names when
55
      and LDAP referral server was down.  Added an LDAP timeout of 5 seconds
56
      for all referral activity.
57
   2) Fixed problem where invalid xml characters such as ampersands (&) could
58
      be inserted into the resultset xml stream.
59 981 tao
  Fixes in 1.0.2
60
   1) Fixed problem with LDAP locking up Metacat when a referral server
61
      was not available.
62
  Fixes in 1.0.1
63
   1) Fixed problem with authenticating using LDAP referrals
64
   2) Fixed bug that prevent groups from being used in access documents
65 883 jones
Installation
66
------------
67
See the file "docs/user/metacatinstall.html" for detailed instructions.
68
69 861 jones
Documentation
70
-------------
71 666 jones
See the docs directory for detailed documentation and installation
72
instructions.
73
74
Details of the Metacat architecture can be found on the website for
75
the Knowledge Network for Biocomplexity (KNB):
76
77 805 jones
  http://knb.ecoinformatics.org/software/metacat/
78 666 jones
79
Contributions to this work are welcome.  Please see the above web site
80
for details on how to contribute.
81
82 848 jones
Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)
83
-----------------------------------------------------------------------------
84 861 jones
There are no known bugs in the current release (yet).  If you discover one
85
please report it, either by email (above) or by using our bug tracking
86
system (http://bugzilla.ecoinformatics.org). There is a list of currently
87
unimplemented features in Bugzilla that we are working on for the next
88
release (no, we don't have a date yet!).
89 805 jones
90
Legalese
91
--------
92 666 jones
This software is copyrighted by The Regents of the University of California
93
and the National Center for Ecological Analysis and Synthesis
94
and licensed under the GNU GPL; see the 'LICENSE' file for
95
details.
96
97
This material is based upon work supported by the
98
National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.
99
Any opinions, findings and conclusions or recomendations expressed in this
100
material are those of the author(s) and do not necessarily reflect
101
the views of the National Science Foundation (NSF).