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 986 berkley
Version: 1.1.0 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 1003 berkley
allowing storage of XML documents with arbitrary schemas. Metacat supports
24
several databases on the back-end, including Oracle, PostgeSQL and SQL Server.
25
The server supports XML document
26 666 jones
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 987 berkley
  New features in 1.1.0:
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 1003 berkley
  2) Changed version control mechanism.  Metacat can now accept any version of
39 982 berkley
     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 987 berkley
  Fixes in 1.1.0
44 1003 berkley
   1) Fixed ldap authentication bug.  Now, a user from a referred server cannot
45
      login with an incorrect password.
46
   2) Changed the default behavior of the access control functionality with
47
      respect to packaging.
48
      If a member document in a data package doesn't have an access control list,
49 983 tao
      access control rules of the main package document will not apply to the
50 1003 berkley
      member document.  Previously, package members, by default, inherited
51
      the access control rules of the main package document.
52 982 berkley
   3) Fixed minor bugs with document access control.
53
   4) Allowed new version of data files to be uploaded and handled.
54 1003 berkley
   5) Fixed bug where the client could not get the principals or groups from
55
      the ldap 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).