Project

General

Profile

metacat / README @ 1749

1
#
2
#  '$RCSfile$'
3
#   '$Author: tao $'
4
# '$Revision: 1730 $'
5
#     '$Date: 2003-07-15 14:08:02 -0700 (Tue, 15 Jul 2003) $'
6
#
7

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

    
11
Version: 1.3.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 structure of the xml_access table was changed and a new
36
table, xml_accesssubtree was added. If you try to update a previously 
37
installed Metacat, you should run a script file to updated the table structure 
38
before installation.
39
For Oracle user: At the SQLPLUS prompt type the following -
40
@src/reviseformetacat13.sql
41
For Postgresql user: At install directory prompt type the following -
42
psql exp < src/reviseformetacat13_postgres.sql
43
(where 'exp' is the database name).
44

    
45
After installation, user should run "ant schemasql" command to register EML2
46
schema in xml_catalog table.
47

    
48
If you are a new Metacat user, this step is unneeded.
49

    
50
New Features in 1.3.0
51
  1) Partialy support EML2 document. User can store, query, read and write
52
     EML2 documents. However, Metacat only support access control in resource
53
     level. The subtree level access control will be ignored.
54
  2) Support other xml document base on namespace/schema.
55
  3) Support query for attribute value
56
  4) Assign MIME type to data file base on metadata when user try to read it.
57
  5) Owner can assign access rules to a document which does not have access 
58
     document to apply it.
59
  6) Support exporting single file, not only whole package
60

    
61
Fixes in 1.3.0:
62
  1) Couldn't finish delta T replication for large set of documents.
63
  2) Couldn't create access control during delta T replication.
64
  3) Eorr will be written to a seperated log file if some documents
65
     were failed in replication.
66
  4) Decrease the time to create access rules during insert or update 
67
     a package.
68
     
69
Installation
70
------------
71
See the file "docs/user/metacatinstall.html" for detailed instructions.
72

    
73
Documentation
74
-------------
75
See the docs directory for detailed documentation and installation
76
instructions.
77

    
78
Details of the Metacat architecture can be found on the website for
79
the Knowledge Network for Biocomplexity (KNB):
80

    
81
  http://knb.ecoinformatics.org/software/metacat/
82

    
83
Contributions to this work are welcome.  Please see the above web site
84
for details on how to contribute.
85

    
86
Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)
87
-----------------------------------------------------------------------------
88
If you discover a bug
89
please report it, either by email (above) or by using our bug tracking
90
system (http://bugzilla.ecoinformatics.org). There is a list of currently
91
unimplemented features in Bugzilla that we are working on for the next
92
release (no, we don't have a date yet!).
93

    
94
Legalese
95
--------
96
This software is copyrighted by The Regents of the University of California
97
and the National Center for Ecological Analysis and Synthesis
98
and licensed under the GNU GPL; see the 'LICENSE' file for
99
details.
100

    
101
This material is based upon work supported by the
102
National Science Foundation under Grant No. DEB99-80154 and DBI99-04777.
103
Any opinions, findings and conclusions or recomendations expressed in this
104
material are those of the author(s) and do not necessarily reflect
105
the views of the National Science Foundation (NSF).
106

    
107
This product includes software developed by the Apache Software
108
Foundation (http://www.apache.org/). See the LICENSE file in lib/apache
109
for details.
110

    
111
The source code, object code, and documentation in the com.oreilly.servlet
112
package is copyright and owned by Jason Hunter. See the cos-license.html file
113
for details of the license.  Licensor retains title to and ownership of the
114
Software and all enhancements, modifications, and updates to the Software.