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 2313 jones
Version: 1.4.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 2313 jones
              Saurabh Garg (sgarg@nceas.ucsb.edu)
22
              Duane Costa (dcosta@lternet.edu)
23 1311 berkley
24 982 berkley
Metacat is a flexible database storage system for XML formatted
25 2313 jones
documents and associated binary files. Metacat models the structure of the
26
XML document, therefore allowing storage of XML documents with arbitrary
27
schemas. Metacat supports several databases on the back-end, including Oracle,
28
PostgreSQL and SQL Server (limited).  The server supports XML document
29
storage, retrievel, query, validation, and transformation (using the XSLT
30
stylesheet language).  In addition, there is a mechanism for replicating the
31
database to other metacat instances for backup and load balancing purposes.
32
Metacat currently uses an LDAP database for authenticating users, but was
33
written to accomodate other authentication services as well.
34 666 jones
35 2321 jones
Installation
36
------------
37
See the file "docs/user/metacatinstall.html" for detailed instructions.
38
39 2313 jones
Release Notes for 1.4.0:
40
------------------------
41
42
This is a major release, and is the first to introduce many new features to
43
Metacat.  Some of the major new features in this version of Metacat include:
44
45
* Added a new 'Harvester' that allows documents to be periodically pulled
46
  from distributed sources into metacat, useful for interfacing with other
47
  system types. See the Metacat Tour for details.
48
* Added new 'skins' capability to allow the GUI for the metacat web interface
49
  to be more easily customized to fit into site needs.  The skin is based on
50
  a flexible mix of XSLT, CSS, and Javascript.
51 2321 jones
* Added a web-based metadata entry form for submitting limited EML documents
52 2313 jones
  as part of a data registry.  The GUI for the registry is customizable and
53
  is integrated with the 'skins' system for the main metacat interface.  The
54
  registry subsystem is written in Perl, and can simultaneously be used to
55
  present multiple 'registry' interfaces.
56
* A new 'client API' has been developed and implemented in Java and in Perl
57
  so that metacat functions can be accessed from any program in those
58
  languages.  The client API supports the major metacat servlet actions,
59
  including login(), logout(), query(), insert(), update(), delete(), and
60
  upload(). See the Metacat Tour for details.
61
* Added a new 'getlog' action that produces a usage history for all major
62
  events.  So now an XML report can be generated for document reads, inserts,
63
  deletes, etc.  See the new section in the Metacat Tour.
64
* Added a new 'buildindex' action that can rebuild the index entries for any
65
  document in the database.
66
* The configuration file for metacat (metacat.properties) has been moved out
67
  of the jar file and into the WEB-INF directory, allowing far easier changes
68
  to the configuration parameters.
69 2321 jones
* Results in default web interface are sorted by title in the XSLT
70
  (configurable)
71
* Many bugs were fixed.
72 2313 jones
73
Details of all changes can be found in the bug database here:
74
http://bugzilla.ecoinformatics.org/buglist.cgi?product=Metacat&target_milestone=1.4
75
76 1775 tao
Release Notes for 1.3.1:
77 2313 jones
------------------------
78 1308 tao
79 1775 tao
This is a simple interim bug fix. No major functionality changes. Bugs fixed
80
include:
81 1776 tao
 1) Metacat 1.3.0 doesn't work in Java 1.3 because a subtle API differnce in
82
    Java 1.3 and Java 1.4. Currently, Metacat 1.3.1 will work in both Java 1.3
83
    and Java 1.4.
84 1775 tao
 2) Distribution package size was reduced.
85
86
87
Release Notes for 1.3.0
88 2313 jones
------------------------
89 1775 tao
90
In 1.3.0 release, the structure of the xml_access table was changed and a new
91 1628 tao
table, xml_accesssubtree was added. If you try to update a previously
92
installed Metacat, you should run a script file to updated the table structure
93
before installation.
94
For Oracle user: At the SQLPLUS prompt type the following -
95
@src/reviseformetacat13.sql
96
For Postgresql user: At install directory prompt type the following -
97
psql exp < src/reviseformetacat13_postgres.sql
98
(where 'exp' is the database name).
99 1334 tao
100 1628 tao
After installation, user should run "ant schemasql" command to register EML2
101
schema in xml_catalog table.
102
103
If you are a new Metacat user, this step is unneeded.
104
105 1769 tao
Note: 1) We recommend to use Tomcat 4 and JAVA 1.4 to run Metacat. Otherwise,
106
         it will cause potential replication issues.
107
      2) Delete the xercesImpl.jar and xmlParserAPIs.jar files
108
         which are in $CATALINA_HOME/common/endorsed. They are old version and
109
         don't support XML schema validation.
110
111 1628 tao
New Features in 1.3.0
112
  1) Partialy support EML2 document. User can store, query, read and write
113
     EML2 documents. However, Metacat only support access control in resource
114
     level. The subtree level access control will be ignored.
115
  2) Support other xml document base on namespace/schema.
116
  3) Support query for attribute value
117
  4) Assign MIME type to data file base on metadata when user try to read it.
118
  5) Owner can assign access rules to a document which does not have access
119
     document to apply it.
120
  6) Support exporting single file, not only whole package
121 1769 tao
  7) Resupport Microsoft SQL Server.
122 1628 tao
123
Fixes in 1.3.0:
124
  1) Couldn't finish delta T replication for large set of documents.
125
  2) Couldn't create access control during delta T replication.
126
  3) Eorr will be written to a seperated log file if some documents
127
     were failed in replication.
128
  4) Decrease the time to create access rules during insert or update
129
     a package.
130
131 861 jones
Documentation
132
-------------
133 1311 berkley
See the docs directory for detailed documentation and installation
134 666 jones
instructions.
135
136 1311 berkley
Details of the Metacat architecture can be found on the website for
137 666 jones
the Knowledge Network for Biocomplexity (KNB):
138
139 805 jones
  http://knb.ecoinformatics.org/software/metacat/
140 666 jones
141
Contributions to this work are welcome.  Please see the above web site
142
for details on how to contribute.
143
144 848 jones
Major Known Bugs or Feature Requests (see http://bugzilla.ecoinformatics.org)
145
-----------------------------------------------------------------------------
146 2313 jones
If you discover a bug please report it, either by email (above) or by using
147
our bug tracking system (http://bugzilla.ecoinformatics.org). There is a
148
list of currently unimplemented features in Bugzilla that we are working on
149
for the next release.
150 805 jones
151
Legalese
152
--------
153 666 jones
This software is copyrighted by The Regents of the University of California
154
and the National Center for Ecological Analysis and Synthesis
155
and licensed under the GNU GPL; see the 'LICENSE' file for
156
details.
157
158 1311 berkley
This material is based upon work supported by the
159 2313 jones
National Science Foundation under Grant No. DEB99-80154, DBI99-04777, and
160
0225676.  Any opinions, findings and conclusions or recomendations expressed
161
in this material are those of the author(s) and do not necessarily reflect
162 666 jones
the views of the National Science Foundation (NSF).
163 1307 jones
164 1311 berkley
This product includes software developed by the Apache Software
165 1307 jones
Foundation (http://www.apache.org/). See the LICENSE file in lib/apache
166
for details.
167
168 1311 berkley
The source code, object code, and documentation in the com.oreilly.servlet
169 1307 jones
package is copyright and owned by Jason Hunter. See the cos-license.html file
170 1311 berkley
for details of the license.  Licensor retains title to and ownership of the
171 1307 jones
Software and all enhancements, modifications, and updates to the Software.