Project

General

Profile

1
#
2
#  '$RCSfile$'
3
#   '$Author: tao $'
4
# '$Revision: 1308 $'
5
#     '$Date: 2002-10-14 15:53:41 -0700 (Mon, 14 Oct 2002) $'
6
#
7

    
8
Metacat: XML Metadata Database
9
------------------------------
10

    
11
Version: 1.2.0 Release
12

    
13
Send feedback and bugs to: metacat-dev@ecoinformatics.org
14
                           http://bugzilla.ecoinformatics.org
15

    
16
Contributors: Matt Jones (jones@nceas.ucsb.edu)
17
              Chad Berkley (berkley@nceas.ucsb.edu)
18
              Jing Tao (tao@nceas.ucsb.edu)
19
              Jivka Bojilova (bojilova@nceas.ucsb.edu)
20
              Dan Higgins (higgins@nceas.ucsb.edu)
21
              
22
Metacat is a flexible database storage system for XML formatted
23
documents. Metacat models the structure of the XML document, therefore
24
allowing storage of XML documents with arbitrary schemas. Metacat supports
25
several databases on the back-end, including Oracle, PostgreSQL and SQL
26
Server.  The server supports XML document storage, retrievel, query,
27
validation, and transformation (using the XSLT stylesheet language).
28
In addition, there is a mechanism for replicating the database
29
to other metacat instances for backup and load balancing purposes.
30
Metacat currently uses an LDAP database for authenticating users, but
31
was written to accomodate other authentication services as well.
32

    
33
Release Notes
34

    
35
In this release, the sturcture of xml_replication table was changed. If you try 
36
to update a installed Metacat, you should run a script file to updated the table
37
structure before installation. For Oracle user: At the SQLPLUS prompt type the 
38
following:
39
@src/xmlreplicationtable.sql
40

    
41
If you a new Metacat user, don't need to do it. 
42

    
43
Moreover, in build.xml it has a peroperty named datafilepath. It should be set
44
as same as your current data file path for person who already installed Metacat
45
before.
46

    
47
-------------
48
  New features in 1.2.0:
49
  1) Performance improvements through improved access control handling
50
  2) New replication features
51
  3) Added partial SSL support
52
  4) Additional bugs fixed, see http://bugzilla.ecoinformatics.org
53
     474   Metacat in Ecoinfo hang     
54
     475   Associate access doc to some docid which doesn't have ent...     
55
     478   Security hole in Metacat for data file.     
56
     536   Changes to Metacat build script to install stylesheets fr...     
57
     457   Bug in replciation     
58
     466   Create a JUnit class for Metacat action     
59
     502   Security issues in replication     
60
     503   Access control problem to a replicated doucment     
61
     537   SQL error when first insert a new record into xml_replica...     
62
     540   In force replication, some time has reversion number error     
63
     541   Update dataset document which host is not in this metacat...     
64
     542   Duplicate entries in xml_replication table     
65
     543   Metacat hang in there when delta T replication     
66
     554   xml_replication table in production metacat     
67
     479   Debug message level
68

    
69
  New features in 1.1.0:
70
  1) Added functionality to export a zipped data package. The zip file contains
71
     all of the data and metadata as well as a rendered html summary of
72
     the metadata.
73
  2) Changed version control mechanism.  Metacat can now accept any version of 
74
     a document as long as the given version number is greater than the
75
     current one.  The new version number does not have to be exactly one
76
     greater than the current version.
77
  3) Update xerces.jar file to version 1.4.4
78
  Fixes in 1.1.0
79
   1) Fixed ldap authentication bug.  Now, a user from a referred server cannot
80
      login with an incorrect password.
81
   2) Changed the default behavior of the access control functionality with 
82
      respect to packaging.
83
      If a member document in a data package doesn't have an access control list, 
84
      access control rules of the main package document will not apply to the 
85
      member document.  Previously, package members, by default, inherited
86
      the access control rules of the main package document.
87
   3) Fixed minor bugs with document access control.
88
   4) Allowed new version of data files to be uploaded and handled.
89
   5) Fixed bug where the client could not get the principals or groups from 
90
      the ldap server.
91
  Fixes in 1.0.3
92
   1) Fixed problem with Metacat not being able to query for group names when
93
      and LDAP referral server was down.  Added an LDAP timeout of 5 seconds
94
      for all referral activity.
95
   2) Fixed problem where invalid xml characters such as ampersands (&) could
96
      be inserted into the resultset xml stream.  
97
  Fixes in 1.0.2
98
   1) Fixed problem with LDAP locking up Metacat when a referral server
99
      was not available.
100
  Fixes in 1.0.1
101
   1) Fixed problem with authenticating using LDAP referrals
102
   2) Fixed bug that prevent groups from being used in access documents
103
Installation
104
------------
105
See the file "docs/user/metacatinstall.html" for detailed instructions.
106

    
107
Documentation
108
-------------
109
See the docs directory for detailed documentation and installation 
110
instructions.
111

    
112
Details of the Metacat architecture can be found on the website for 
113
the Knowledge Network for Biocomplexity (KNB):
114

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

    
117
Contributions to this work are welcome.  Please see the above web site
118
for details on how to contribute.
119

    
120
Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)
121
-----------------------------------------------------------------------------
122
If you discover a bug
123
please report it, either by email (above) or by using our bug tracking
124
system (http://bugzilla.ecoinformatics.org). There is a list of currently
125
unimplemented features in Bugzilla that we are working on for the next 
126
release (no, we don't have a date yet!).
127

    
128
Legalese
129
--------
130
This software is copyrighted by The Regents of the University of California
131
and the National Center for Ecological Analysis and Synthesis
132
and licensed under the GNU GPL; see the 'LICENSE' file for
133
details.
134

    
135
This material is based upon work supported by the 
136
National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.
137
Any opinions, findings and conclusions or recomendations expressed in this
138
material are those of the author(s) and do not necessarily reflect 
139
the views of the National Science Foundation (NSF).
140

    
141
This product includes software developed by the Apache Software 
142
Foundation (http://www.apache.org/). See the LICENSE file in lib/apache
143
for details.
144

    
145
The source code, object code, and documentation in the com.oreilly.servlet 
146
package is copyright and owned by Jason Hunter. See the cos-license.html file
147
for details of the license.  Licensor retains title to and ownership of the 
148
Software and all enhancements, modifications, and updates to the Software.
(2-2/4)