1 |
981
|
tao
|
#
|
2 |
666
|
jones
|
# '$RCSfile$'
|
3 |
|
|
# '$Author$'
|
4 |
|
|
# '$Revision$'
|
5 |
|
|
# '$Date$'
|
6 |
|
|
#
|
7 |
|
|
|
8 |
|
|
Metacat: XML Metadata Database
|
9 |
|
|
------------------------------
|
10 |
|
|
|
11 |
1307
|
jones
|
Version: 1.2.0 Release
|
12 |
666
|
jones
|
|
13 |
1295
|
jones
|
Send feedback and bugs to: metacat-dev@ecoinformatics.org
|
14 |
|
|
http://bugzilla.ecoinformatics.org
|
15 |
696
|
jones
|
|
16 |
666
|
jones
|
Contributors: Matt Jones (jones@nceas.ucsb.edu)
|
17 |
|
|
Chad Berkley (berkley@nceas.ucsb.edu)
|
18 |
981
|
tao
|
Jing Tao (tao@nceas.ucsb.edu)
|
19 |
666
|
jones
|
Jivka Bojilova (bojilova@nceas.ucsb.edu)
|
20 |
|
|
Dan Higgins (higgins@nceas.ucsb.edu)
|
21 |
981
|
tao
|
|
22 |
982
|
berkley
|
Metacat is a flexible database storage system for XML formatted
|
23 |
666
|
jones
|
documents. Metacat models the structure of the XML document, therefore
|
24 |
1003
|
berkley
|
allowing storage of XML documents with arbitrary schemas. Metacat supports
|
25 |
1307
|
jones
|
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 |
666
|
jones
|
|
33 |
877
|
jones
|
Release Notes
|
34 |
1308
|
tao
|
|
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 |
1310
|
tao
|
structure before installation.
|
38 |
|
|
For Oracle user: At the SQLPLUS prompt type the following -
|
39 |
1308
|
tao
|
@src/xmlreplicationtable.sql
|
40 |
1310
|
tao
|
For Postgresql user: At install directory prompt type the following -
|
41 |
|
|
psql exp < src/xmlreplicationtable_postgres.sql
|
42 |
|
|
(exp is the database name).
|
43 |
1308
|
tao
|
|
44 |
|
|
If you a new Metacat user, don't need to do it.
|
45 |
|
|
|
46 |
|
|
Moreover, in build.xml it has a peroperty named datafilepath. It should be set
|
47 |
|
|
as same as your current data file path for person who already installed Metacat
|
48 |
|
|
before.
|
49 |
|
|
|
50 |
877
|
jones
|
-------------
|
51 |
1307
|
jones
|
New features in 1.2.0:
|
52 |
|
|
1) Performance improvements through improved access control handling
|
53 |
|
|
2) New replication features
|
54 |
|
|
3) Added partial SSL support
|
55 |
|
|
4) Additional bugs fixed, see http://bugzilla.ecoinformatics.org
|
56 |
|
|
474 Metacat in Ecoinfo hang
|
57 |
|
|
475 Associate access doc to some docid which doesn't have ent...
|
58 |
|
|
478 Security hole in Metacat for data file.
|
59 |
|
|
536 Changes to Metacat build script to install stylesheets fr...
|
60 |
|
|
457 Bug in replciation
|
61 |
|
|
466 Create a JUnit class for Metacat action
|
62 |
|
|
502 Security issues in replication
|
63 |
|
|
503 Access control problem to a replicated doucment
|
64 |
|
|
537 SQL error when first insert a new record into xml_replica...
|
65 |
|
|
540 In force replication, some time has reversion number error
|
66 |
|
|
541 Update dataset document which host is not in this metacat...
|
67 |
|
|
542 Duplicate entries in xml_replication table
|
68 |
|
|
543 Metacat hang in there when delta T replication
|
69 |
|
|
554 xml_replication table in production metacat
|
70 |
|
|
479 Debug message level
|
71 |
|
|
|
72 |
987
|
berkley
|
New features in 1.1.0:
|
73 |
982
|
berkley
|
1) Added functionality to export a zipped data package. The zip file contains
|
74 |
|
|
all of the data and metadata as well as a rendered html summary of
|
75 |
|
|
the metadata.
|
76 |
1003
|
berkley
|
2) Changed version control mechanism. Metacat can now accept any version of
|
77 |
982
|
berkley
|
a document as long as the given version number is greater than the
|
78 |
|
|
current one. The new version number does not have to be exactly one
|
79 |
|
|
greater than the current version.
|
80 |
|
|
3) Update xerces.jar file to version 1.4.4
|
81 |
987
|
berkley
|
Fixes in 1.1.0
|
82 |
1003
|
berkley
|
1) Fixed ldap authentication bug. Now, a user from a referred server cannot
|
83 |
|
|
login with an incorrect password.
|
84 |
|
|
2) Changed the default behavior of the access control functionality with
|
85 |
|
|
respect to packaging.
|
86 |
|
|
If a member document in a data package doesn't have an access control list,
|
87 |
983
|
tao
|
access control rules of the main package document will not apply to the
|
88 |
1003
|
berkley
|
member document. Previously, package members, by default, inherited
|
89 |
|
|
the access control rules of the main package document.
|
90 |
982
|
berkley
|
3) Fixed minor bugs with document access control.
|
91 |
|
|
4) Allowed new version of data files to be uploaded and handled.
|
92 |
1003
|
berkley
|
5) Fixed bug where the client could not get the principals or groups from
|
93 |
|
|
the ldap server.
|
94 |
895
|
berkley
|
Fixes in 1.0.3
|
95 |
|
|
1) Fixed problem with Metacat not being able to query for group names when
|
96 |
|
|
and LDAP referral server was down. Added an LDAP timeout of 5 seconds
|
97 |
|
|
for all referral activity.
|
98 |
|
|
2) Fixed problem where invalid xml characters such as ampersands (&) could
|
99 |
|
|
be inserted into the resultset xml stream.
|
100 |
981
|
tao
|
Fixes in 1.0.2
|
101 |
|
|
1) Fixed problem with LDAP locking up Metacat when a referral server
|
102 |
|
|
was not available.
|
103 |
|
|
Fixes in 1.0.1
|
104 |
|
|
1) Fixed problem with authenticating using LDAP referrals
|
105 |
|
|
2) Fixed bug that prevent groups from being used in access documents
|
106 |
883
|
jones
|
Installation
|
107 |
|
|
------------
|
108 |
|
|
See the file "docs/user/metacatinstall.html" for detailed instructions.
|
109 |
|
|
|
110 |
861
|
jones
|
Documentation
|
111 |
|
|
-------------
|
112 |
666
|
jones
|
See the docs directory for detailed documentation and installation
|
113 |
|
|
instructions.
|
114 |
|
|
|
115 |
|
|
Details of the Metacat architecture can be found on the website for
|
116 |
|
|
the Knowledge Network for Biocomplexity (KNB):
|
117 |
|
|
|
118 |
805
|
jones
|
http://knb.ecoinformatics.org/software/metacat/
|
119 |
666
|
jones
|
|
120 |
|
|
Contributions to this work are welcome. Please see the above web site
|
121 |
|
|
for details on how to contribute.
|
122 |
|
|
|
123 |
848
|
jones
|
Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)
|
124 |
|
|
-----------------------------------------------------------------------------
|
125 |
982
|
berkley
|
If you discover a bug
|
126 |
861
|
jones
|
please report it, either by email (above) or by using our bug tracking
|
127 |
|
|
system (http://bugzilla.ecoinformatics.org). There is a list of currently
|
128 |
|
|
unimplemented features in Bugzilla that we are working on for the next
|
129 |
|
|
release (no, we don't have a date yet!).
|
130 |
805
|
jones
|
|
131 |
|
|
Legalese
|
132 |
|
|
--------
|
133 |
666
|
jones
|
This software is copyrighted by The Regents of the University of California
|
134 |
|
|
and the National Center for Ecological Analysis and Synthesis
|
135 |
|
|
and licensed under the GNU GPL; see the 'LICENSE' file for
|
136 |
|
|
details.
|
137 |
|
|
|
138 |
|
|
This material is based upon work supported by the
|
139 |
|
|
National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.
|
140 |
|
|
Any opinions, findings and conclusions or recomendations expressed in this
|
141 |
|
|
material are those of the author(s) and do not necessarily reflect
|
142 |
|
|
the views of the National Science Foundation (NSF).
|
143 |
1307
|
jones
|
|
144 |
|
|
This product includes software developed by the Apache Software
|
145 |
|
|
Foundation (http://www.apache.org/). See the LICENSE file in lib/apache
|
146 |
|
|
for details.
|
147 |
|
|
|
148 |
|
|
The source code, object code, and documentation in the com.oreilly.servlet
|
149 |
|
|
package is copyright and owned by Jason Hunter. See the cos-license.html file
|
150 |
|
|
for details of the license. Licensor retains title to and ownership of the
|
151 |
|
|
Software and all enhancements, modifications, and updates to the Software.
|