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 1775 tao
Version: 1.3.1 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 1311 berkley
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 1775 tao
Release Notes for 1.3.1:
34 1308 tao
35 1775 tao
This is a simple interim bug fix. No major functionality changes. Bugs fixed
36
include:
37 1776 tao
 1) Metacat 1.3.0 doesn't work in Java 1.3 because a subtle API differnce in
38
    Java 1.3 and Java 1.4. Currently, Metacat 1.3.1 will work in both Java 1.3
39
    and Java 1.4.
40 1775 tao
 2) Distribution package size was reduced.
41
42
43
Release Notes for 1.3.0
44
45
In 1.3.0 release, the structure of the xml_access table was changed and a new
46 1628 tao
table, xml_accesssubtree was added. If you try to update a previously
47
installed Metacat, you should run a script file to updated the table structure
48
before installation.
49
For Oracle user: At the SQLPLUS prompt type the following -
50
@src/reviseformetacat13.sql
51
For Postgresql user: At install directory prompt type the following -
52
psql exp < src/reviseformetacat13_postgres.sql
53
(where 'exp' is the database name).
54 1334 tao
55 1628 tao
After installation, user should run "ant schemasql" command to register EML2
56
schema in xml_catalog table.
57
58
If you are a new Metacat user, this step is unneeded.
59
60 1769 tao
Note: 1) We recommend to use Tomcat 4 and JAVA 1.4 to run Metacat. Otherwise,
61
         it will cause potential replication issues.
62
      2) Delete the xercesImpl.jar and xmlParserAPIs.jar files
63
         which are in $CATALINA_HOME/common/endorsed. They are old version and
64
         don't support XML schema validation.
65
66 1628 tao
New Features in 1.3.0
67
  1) Partialy support EML2 document. User can store, query, read and write
68
     EML2 documents. However, Metacat only support access control in resource
69
     level. The subtree level access control will be ignored.
70
  2) Support other xml document base on namespace/schema.
71
  3) Support query for attribute value
72
  4) Assign MIME type to data file base on metadata when user try to read it.
73
  5) Owner can assign access rules to a document which does not have access
74
     document to apply it.
75
  6) Support exporting single file, not only whole package
76 1769 tao
  7) Resupport Microsoft SQL Server.
77 1628 tao
78
Fixes in 1.3.0:
79
  1) Couldn't finish delta T replication for large set of documents.
80
  2) Couldn't create access control during delta T replication.
81
  3) Eorr will be written to a seperated log file if some documents
82
     were failed in replication.
83
  4) Decrease the time to create access rules during insert or update
84
     a package.
85
86 883 jones
Installation
87
------------
88
See the file "docs/user/metacatinstall.html" for detailed instructions.
89
90 861 jones
Documentation
91
-------------
92 1311 berkley
See the docs directory for detailed documentation and installation
93 666 jones
instructions.
94
95 1311 berkley
Details of the Metacat architecture can be found on the website for
96 666 jones
the Knowledge Network for Biocomplexity (KNB):
97
98 805 jones
  http://knb.ecoinformatics.org/software/metacat/
99 666 jones
100
Contributions to this work are welcome.  Please see the above web site
101
for details on how to contribute.
102
103 848 jones
Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)
104
-----------------------------------------------------------------------------
105 982 berkley
If you discover a bug
106 861 jones
please report it, either by email (above) or by using our bug tracking
107
system (http://bugzilla.ecoinformatics.org). There is a list of currently
108 1311 berkley
unimplemented features in Bugzilla that we are working on for the next
109 1775 tao
release.
110 805 jones
111
Legalese
112
--------
113 666 jones
This software is copyrighted by The Regents of the University of California
114
and the National Center for Ecological Analysis and Synthesis
115
and licensed under the GNU GPL; see the 'LICENSE' file for
116
details.
117
118 1311 berkley
This material is based upon work supported by the
119 666 jones
National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.
120
Any opinions, findings and conclusions or recomendations expressed in this
121 1311 berkley
material are those of the author(s) and do not necessarily reflect
122 666 jones
the views of the National Science Foundation (NSF).
123 1307 jones
124 1311 berkley
This product includes software developed by the Apache Software
125 1307 jones
Foundation (http://www.apache.org/). See the LICENSE file in lib/apache
126
for details.
127
128 1311 berkley
The source code, object code, and documentation in the com.oreilly.servlet
129 1307 jones
package is copyright and owned by Jason Hunter. See the cos-license.html file
130 1311 berkley
for details of the license.  Licensor retains title to and ownership of the
131 1307 jones
Software and all enhancements, modifications, and updates to the Software.