| 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.
|