Project

General

Profile

1
Appendix: Metacat Properties
2
============================
3
The most dynamic Metacat Properties are managed using Metacat's Configuration 
4
Interface (see :doc:`configuration`). These properties, as well as other, 
5
rarely modified ones can be found in the metacat.properties file. For more 
6
information about the properties, click one of the following:
7

    
8
* Server Properties
9
* Application Properties
10
* Database Properties
11
* Authorization and Authentication Properties
12
* XML/EML Properties
13

    
14
Server Properties
15
-----------------
16
All of Metacat's server properties are managed with the form-based 
17
configuration utility, though they can also be accessed More information on 
18
each is included below.
19

    
20

    
21
Metacat Server Properties
22

    
23
+--------------------+------------------------------------------------------------------------------------------+------------------------+
24
| Property           | Description                                                                              | Example                |
25
+====================+==========================================================================================+========================+
26
| .. _server-name:   |                                                                                          |                        |
27
|                    |                                                                                          |                        |
28
| server.name        | The network host name used to access Metacat. Note that this is not necessarily          | knb.ecoinformatics.org |
29
|                    | the physical name of the server running Metacat. The host name should not                |                        |
30
|                    | include the protocol prefix (http://).                                                   |                        |
31
|                    |                                                                                          |                        |
32
|                    | Default Value: localhost                                                                 |                        |
33
+--------------------+------------------------------------------------------------------------------------------+------------------------+
34
| .. _server-httpPort:   |                                                                                          |                        |
35
|                    |                                                                                          |                        |
36
| server.httpPort    | The network port used to access Metacat for non-secure (standard) connections.           | 80                     |
37
|                    | This is usually 80 if Apache Web server is running, and 8080 if Tomcat is running alone. |                        |
38
|                    |                                                                                          |                        |
39
|                    | Default Value: 80                                                                        |                        |
40
+--------------------+------------------------------------------------------------------------------------------+------------------------+
41
| .. _server-httpSSLPort:   |                                                                                          |                        |
42
|                    |                                                                                          |                        |
43
| server.httpSSLPort | The network port used to access Metacat for secure connections. This is usually          | 443                    |
44
|                    | 443 if Apache Web server is running, and 8443 if Tomcat is running alone.                |                        |
45
|                    |                                                                                          |                        |
46
|                    | Default Value: 443                                                                       |                        |
47
+--------------------+------------------------------------------------------------------------------------------+------------------------+
48

    
49
Application Properties
50
----------------------
51

    
52
Metacat's application properties are described below. Properties that can only 
53
be edited manually in the ``metacat.properties`` file are marked. All 
54
others are managed with the properties configuration utility.
55

    
56
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
57
| Property                       | Description                                                                 | Example                       |
58
+================================+=============================================================================+===============================+
59
| application.metacatVersion*    | The Metacat version number. It is set by the build engineer                 | 1.9.0                         |
60
|                                | at build time. Usually, the value should never be changed.                  |                               |
61
|                                |                                                                             |                               |
62
|                                | Default Value: X.X.X (where X.X.X is the current version of Metacat)        |                               |
63
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
64
| application.metacatReleaseInfo*| Release information for display purposes. Typically the property            | Release Candidate 1           |
65
|                                | is set during the release candidate cycle to let users know which           |                               |
66
|                                | candidate they are downloading.                                             |                               |
67
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
68
| .. _application.deployDir:     |                                                                             |                               |
69
|                                |                                                                             |                               |
70
| application.deployDir          | The directory where Web applications are deployed. Usually, the value       | /usr/local/tomcat/webapps     |
71
|                                | is a directory named "webapps" in the Tomcat installation directory.        |                               |
72
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
73
| .. _application.context:       |                                                                             |                               |
74
|                                |                                                                             |                               |
75
| application.context            | The name of the Metacat application directory in                            | knb                           |
76
|                                | the deployment directory. This corresponds to the first part of the         |                               |
77
|                                | WAR file name (the part before .war). Most commonly, this                   |                               |
78
|                                | is "knb", but it can be changed to other things.                            |                               |
79
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
80
| .. _application.default-style: |                                                                             |                               |
81
|                                |                                                                             |                               |
82
| application.default-style      | A custom Metacat Web skin usually associated with                           | default                       |
83
|                                | an organizational theme. If your organization has no                        |                               |
84
|                                | custom skin, leave the value as "default".                                  |                               |
85
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
86
| .. _application.knbSiteURL:    |                                                                             |                               |
87
|                                |                                                                             |                               |
88
| application.knbSiteURL         | The main KNB website.                                                       | http://knb.ecoinformatics.org |
89
|                                |                                                                             |                               |
90
|                                | Default Value: http://knb.ecoinformatics.org                                |                               |
91
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
92
| .. _application.datafilepath:  |                                                                             |                               |
93
|                                |                                                                             |                               |
94
| application.datafilepath       | The directory in which to store data files. The directory should            | /var/metacat/data             |
95
|                                | be outside the Metacat installation directories so data files will not      |                               |
96
|                                | be lost when Metacat is upgraded. The data file directory must be           |                               |
97
|                                | writable by the user that starts Tomcat (and thus Metacat).                 |                               |
98
|                                |                                                                             |                               |
99
|                                | Default Value: /var/metacat/data                                            |                               |
100
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
101
| .. _application.inlinedatafilepath:             |                                                                             |                               |
102
|                                |                                                                             |                               |
103
| application.inlinedatafilepath | The directory where inline data files will be stored. Inline                | /var/metacat/inline-data      |
104
|                                | data files are created from data that is embedded in EML                    |                               |
105
|                                | metadata. The directory should be outside the Metacat installation          |                               |
106
|                                | directories so data files will not be lost when Metacat is upgraded.        |                               |
107
|                                | For clarity of data, this should probably not be the same as                |                               |
108
|                                | ``application.datafilepath``. The data file directory must be               |                               |
109
|                                | writable by the user that starts Tomcat (and thus Metacat).                 |                               |
110
|                                |                                                                             |                               |
111
|                                | Default Value: /var/metacat/inline-data                                     |                               |
112
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
113
| .. _application.documentfilepath:             |                                                                             |                               |
114
|                                |                                                                             |                               |
115
| application.documentfilepath   | The directory where metadata files will be stored.                          | /var/metacat/documents        |
116
|                                | The directory should be outside the Metacat installation directories        |                               |
117
|                                | so document files will not be lost when Metacat is upgraded. For            |                               |
118
|                                | clarity of organization, this should probably not be the same as            |                               |
119
|                                | ``application.datafilepath`` or ``application.inlinedatafilepath``.         |                               |
120
|                                | The data file directory must be writable by the user that                   |                               |
121
|                                | starts Tomcat (and thus Metacat).                                           |                               |
122
|                                |                                                                             |                               |
123
|                                | Default Value: /var/metacat/documents                                       |                               |
124
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
125
| .. _application.tempDir:       |                                                                             |                               |
126
|                                |                                                                             |                               |
127
| application.tempDir            | The directory where the Metacat data registry stores temporary              | /var/metacat/temporary        |
128
|                                | files. The directory should not be the same as ``application.datafilepath`` |                               |
129
|                                | or ``application.inlinedatafilepath`` (or any other persistent file path)   |                               |
130
|                                | because all files in this may be purged programmatically. The temporary     |                               |
131
|                                | file directory must be writable by the user that starts Apache.             |                               |
132
|                                |                                                                             |                               |
133
|                                | Default Value: /var/metacat/temporary                                       |                               |
134
+--------------------------------+-----------------------------------------------------------------------------+-------------------------------+
135

    
136
Database Properties
137
-------------------
138
Metacat's database properties are described next. Properties that can only be 
139
edited manually in the metacat.properties file are marked. All others 
140
are managed with the properties configuration utility.
141

    
142
Metacat Database Properties
143

    
144
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
145
| Property                                   | Description                                                                                              | Example                                                 |
146
+============================================+==========================================================================================================+=========================================================+
147
| .. _database-connectionURI:                |                                                                                                          |                                                         |
148
|                                            |                                                                                                          |                                                         |
149
| database.connectionURI                     | The JDBC connection URI for the main database instance of Metacat.                                       | ``jdbc:postgresql://yourserver.yourdomain.edu/metacat`` |
150
|                                            | The URI is formatted like: ``jdbc:<database_type>:thin@<your_server_name>:1521:<metacat_database_name>`` |                                                         |
151
|                                            | NOTE: You must create an empty database prior to initial Metacat configuration.                          |                                                         |
152
|                                            |                                                                                                          |                                                         |
153
|                                            | Default Value: jdbc:postgresql://localhost/metacat                                                       |                                                         |
154
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
155
| .. _database-user:                         |                                                                                                          |                                                         |
156
|                                            |                                                                                                          |                                                         |
157
| database.user                              | The user for the main database instance of Metacat. The user must                                        | metacat-user                                            |
158
|                                            | have already been created on the database.                                                               |                                                         |
159
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
160
| .. _database-password:                     |                                                                                                          |                                                         |
161
|                                            |                                                                                                          |                                                         |
162
| database.password                          | The password of the user for the main database instance of Metacat.                                      | securepassword4843                                      |
163
|                                            | The password must have already been created for the user.                                                |                                                         |
164
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
165
| .. _database-type:                         |                                                                                                          |                                                         |
166
|                                            |                                                                                                          |                                                         |
167
| database.type                              | The type of database you are running. Currently, there are two supported                                 | postgres                                                |
168
|                                            | types, Oracle and Postgres.                                                                              |                                                         |
169
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
170
| .. _database-driver:                       |                                                                                                          |                                                         |
171
|                                            |                                                                                                          |                                                         |
172
| database.driver                            | The JDBC driver to be used to access the main database instance of Metacat.                              | org.postgresql.Driver                                   |
173
|                                            | There is one driver associated with each type of database.                                               |                                                         |
174
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
175
| .. _database-adapter:                      |                                                                                                          |                                                         |
176
|                                            |                                                                                                          |                                                         |
177
| database.adapter                           | The adapter class that allows Metacat to access your database type.                                      | edu.ucsb.nceas.dbadapter.PostgresqlAdapter              |
178
|                                            | There is one adapter associated with each type of database.                                              |                                                         |
179
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
180
| .. _database-scriptsuf                     |                                                                                                          |                                                         |
181
|                                            |                                                                                                          |                                                         |
182
| database.scriptsuffix.<database_type>      | The script suffix tells the system which database scripts to run                                         | postgres.sql                                            |
183
|                                            | (postgres or oracle) when installing or updating database schema.                                        |                                                         |
184
|                                            |                                                                                                          |                                                         |
185
|                                            | Default Values:                                                                                          |                                                         |
186
|                                            | database.scriptsuffix.postgres=postgres.sql                                                              |                                                         |
187
|                                            | database.scriptsuffix.oracle=oracle.sql                                                                  |                                                         |
188
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
189
| .. _database-upgradeVersion:               |                                                                                                          |                                                         |
190
|                                            |                                                                                                          |                                                         |
191
| database.upgradeVersion.<database_version> | Which database scripts to run when updating database schema. There is a                                  | upgrade-db-to-1.2                                       |
192
|                                            | database.upgradeVersion entry for every Metacat database schema version.                                 |                                                         |
193
|                                            | Each schema version corresponds to an application version.                                               |                                                         |
194
|                                            |                                                                                                          |                                                         |
195
|                                            | Default Values:                                                                                          |                                                         |
196
|                                            | database.upgradeVersion.0.0.0=xmltables,loaddtdschema                                                    |                                                         |
197
|                                            | database.upgradeVersion.1.2.0=upgrade-db-to-1.2                                                          |                                                         |
198
|                                            | database.upgradeVersion.1.3.0=upgrade-db-to-1.3                                                          |                                                         |
199
|                                            | database.upgradeVersion.1.4.0=upgrade-db-to-1.4                                                          |                                                         |
200
|                                            | database.upgradeVersion.1.5.0=upgrade-db-to-1.5                                                          |                                                         |
201
|                                            | database.upgradeVersion.1.6.0=upgrade-db-to-1.6                                                          |                                                         |
202
|                                            | database.upgradeVersion.1.7.0=upgrade-db-to-1.7                                                          |                                                         |
203
|                                            | database.upgradeVersion.1.8.0=upgrade-db-to-1.8                                                          |                                                         |
204
|                                            | database.upgradeVersion.1.9.0=upgrade-db-to-1.9                                                          |                                                         |
205
|                                            | database.upgradeVersion.2.0.0=upgrade-db-to-2.0                                                          |                                                         |
206
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
207
| database.initialConnections*               | The number of initial connection that Metacat creates to the database.                                   | 5                                                       |
208
|                                            |                                                                                                          |                                                         |
209
|                                            | Default Value: 5                                                                                         |                                                         |
210
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
211
| database.incrementConnections*             | The number of connections Metacat creates when it requires                                               | 5                                                       |
212
|                                            | more connections.                                                                                        |                                                         |
213
|                                            |                                                                                                          |                                                         |
214
|                                            | Default Value: 5                                                                                         |                                                         |
215
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
216
| database.maximumConnections*               | The maximum number of database connections Metacat can make.                                             | 25                                                      |
217
|                                            |                                                                                                          |                                                         |
218
|                                            | Default Value: 200                                                                                       |                                                         |
219
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
220
| database.maximumConnectionAge*             | The maximum time in milliseconds that a database connection can live.                                    | 120000                                                  |
221
|                                            |                                                                                                          |                                                         |
222
|                                            | Default Value: 120000                                                                                    |                                                         |
223
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
224
| database.maximumConnectionTime*            | The maximum time in milliseconds that a database connection can                                          | 60000                                                   |
225
|                                            | accumulate in actual connection time.                                                                    |                                                         |
226
|                                            |                                                                                                          |                                                         |
227
|                                            | Default Value: 60000                                                                                     |                                                         |
228
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
229
| database.maximumUsageNumber*               | The maximum number of times a single connection can be used.                                             | 100                                                     |
230
|                                            |                                                                                                          |                                                         |
231
|                                            | Default Value: 100                                                                                       |                                                         |
232
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
233
| database.numberOfIndexingThreads*          | The number of threads available for indexing.                                                            | 5                                                       |
234
|                                            |                                                                                                          |                                                         |
235
|                                            | Default Value: 5                                                                                         |                                                         |
236
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
237
| database.indexingTimerTaskTime*            | The time in milliseconds between indexing.                                                               | 604800000                                               |
238
|                                            |                                                                                                          |                                                         |
239
|                                            | Default Value: 604800000                                                                                 |                                                         |
240
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
241
| database.indexingInitialDelay*             | The delay in milliseconds before first indexing is executed.                                             | 3600000                                                 |
242
|                                            |                                                                                                          |                                                         |
243
|                                            | Default Value: 3600000                                                                                   |                                                         |
244
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
245
| database.maximumIndexDelay*                | The time in milliseconds that an indexing thread will wait when it                                       | 5000                                                    |
246
|                                            | can't get a doc id before retrying the indexing.                                                         |                                                         |
247
|                                            |                                                                                                          |                                                         |
248
|                                            | Default Value: 5000                                                                                      |                                                         |
249
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
250
| database.runDBConnectionRecycleThread*     | Determines whether the database connection pool should run a thread to                                   | off                                                     |
251
|                                            | recycle connections. Possible values are "on" and "off"                                                  |                                                         |
252
|                                            |                                                                                                          |                                                         |
253
|                                            | Default Value: off                                                                                       |                                                         |
254
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
255
| database.cycleTimeOfDBConnection*          | The time in milliseconds between connection recycling runs.                                              | 30000                                                   |
256
|                                            |                                                                                                          |                                                         |
257
|                                            | Default Value: 30000                                                                                     |                                                         |
258
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
259
| database.queryignoredparams*               | Parameters to ignore in a structured XML query.                                                          | enableediting                                           |
260
|                                            |                                                                                                          |                                                         |
261
|                                            | Default Value: enableediting,foo                                                                         |                                                         |
262
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
263
| database.usexmlindex*                      | Determines whether to use XML indexes when finding                                                       | true                                                    |
264
|                                            | documents. Possible values are true and false.                                                           |                                                         |
265
|                                            |                                                                                                          |                                                         |
266
|                                            | Default Value: true                                                                                      |                                                         |
267
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
268
| database.appResultsetSize*                 | Determines the number of results that can be returned to an application from a query.                    | 7000                                                    |
269
|                                            |                                                                                                          |                                                         |
270
|                                            | Default Value: 7000                                                                                      |                                                         |
271
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
272
| database.webResultsetSize*                 | Determines the number of results that can be returned to a                                               | 7000                                                    |
273
|                                            | Web browser from a query.                                                                                |                                                         |
274
|                                            |                                                                                                          |                                                         |
275
|                                            | Default Value: 7000                                                                                      |                                                         |
276
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
277
| database.xmlReturnfieldCount*              | If the query results of a query are returned more times                                                  | 0                                                       |
278
|                                            | than this value, then those results will be inserted into the xml_queryresult                            |                                                         |
279
|                                            | table in the database. For example, if you want results for                                              |                                                         |
280
|                                            | a query to be stored in xml_queryresult only when it has been requested                                  |                                                         |
281
|                                            | 50 times, set this value to 50.                                                                          |                                                         |
282
|                                            |                                                                                                          |                                                         |
283
|                                            | Default Value: 0                                                                                         |                                                         |
284
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
285
| database.queryresultStringLength*          | The max size of the query result string in the queryresult table. This                                   | 500000                                                  |
286
|                                            | should be set to some number less than 4000 if an Oracle                                                 |                                                         |
287
|                                            | database is being used.                                                                                  |                                                         |
288
|                                            |                                                                                                          |                                                         |
289
|                                            | Default Value: 500000                                                                                    |                                                         |
290
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
291
| database.queryresultCacheSize*             | The number of query results that will be cached.                                                         | 500                                                     |
292
|                                            |                                                                                                          |                                                         |
293
|                                            | Default Value: 500                                                                                       |                                                         |
294
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
295
| database.queryCacheOn*                     | Determines whether query caching is turned on. Possible values are "on" and "off"                        | on                                                      |
296
|                                            |                                                                                                          |                                                         |
297
|                                            | Default Value: on                                                                                        |                                                         |
298
+--------------------------------------------+----------------------------------------------------------------------------------------------------------+---------------------------------------------------------+
299

    
300
Authorization and Authentication Properties
301
-------------------------------------------
302
Metacat's authorization and authentication properties are described in the 
303
table below. Properties that can only be edited manually in the ``metacat.properties`` 
304
file are marked. All others are managed with the properties configuration utility.
305

    
306
Authorization and Authentication Properties
307

    
308
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
309
| Property                          | Description                                                                   | Example                                       |
310
+===================================+===============================================================================+===============================================+
311
| .. _auth-class:                   |                                                                               |                                               |
312
|                                   |                                                                               |                                               |
313
| auth.class                        | The class used for user authentication. Currently, only the AuthLdap          | edu.ucsb.nceas.metacat.AuthLdap               |
314
|                                   | class is included in the Metacat distribution.                                |                                               |
315
|                                   | Note: If you implement another authentication strategy by implementing a Java |                                               |
316
|                                   | class that extends the AuthInterface interface and rebuilding Metacat,        |                                               |
317
|                                   | change this property to the fully qualified class name of your custom         |                                               |
318
|                                   | authentication mechanism.                                                     |                                               |
319
|                                   |                                                                               |                                               |
320
|                                   | Default Value: edu.ucsb.nceas.metacat.AuthLdap                                |                                               |
321
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
322
| auth.timeoutMinutes*              | The number of minutes that a user will stay logged in to Metacat              | 180                                           |
323
|                                   | without any activity.                                                         |                                               |
324
|                                   |                                                                               |                                               |
325
|                                   | Default Value: 180                                                            |                                               |
326
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
327
| .. _auth-administrators:          |                                                                               |                                               |
328
|                                   |                                                                               |                                               |
329
| auth.administrators               | A colon separated list of LDAP users or groups that have administrative       | uid=youruser,o=NCEAS,dc=ecoinformatics,dc=org |
330
|                                   | Metacat privileges. At least one user or group must be entered when           | cn=yourgroup,o=NCEAS,dc=ecoinformatics,dc=org |
331
|                                   | Metacat is first installed and configured. All accounts must exist            |                                               |
332
|                                   | in LDAP in order to continue with the configuration.                          |                                               |
333
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
334
| .. _auth-url:                     |                                                                               |                                               |
335
|                                   |                                                                               |                                               |
336
| auth.url                          | The URL of the server that Metacat should use for authentication.             | ldap://ldap.ecoinformatics.org:389/           |
337
|                                   |                                                                               |                                               |
338
|                                   | Default Value: ldap://ldap.ecoinformatics.org:389/                            |                                               |
339
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
340
| .. _auth-surl:                    |                                                                               |                                               |
341
|                                   |                                                                               |                                               |
342
| auth.surl                         | The URL of the server that Metacat should use for secure authentication.      | ldap://ldap.ecoinformatics.org:389/           |
343
|                                   |                                                                               |                                               |
344
|                                   | Default Value: ldap://ldap.ecoinformatics.org:389/                            |                                               |
345
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
346
| .. _auth-base:                    |                                                                               |                                               |
347
|                                   |                                                                               |                                               |
348
| auth.base                         | The base part of the distinguished name that Metacat uses for authentication. | dc=ecoinformatics,dc=org                      |
349
|                                   |                                                                               |                                               |
350
|                                   | Default Value: dc=ecoinformatics,dc=org                                       |                                               |
351
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
352
| .. _auth-allowedSubmitters:       |                                                                               |                                               |
353
|                                   |                                                                               |                                               |
354
| auth.allowedSubmitters            | A colon delimited list of users who should be allowed to submit documents     | uid=youruser,o=NCEAS,dc=ecoinformatics,dc=org |
355
|                                   | to Metacat. If no value is specified, all users will be                       |                                               |
356
|                                   | allowed to submit documents.                                                  |                                               |
357
|                                   |                                                                               |                                               |
358
|                                   | Default Value: (none)                                                         |                                               |
359
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
360
| .. _auth-deniedSubmitters:        |                                                                               |                                               |
361
|                                   |                                                                               |                                               |
362
| auth.deniedSubmitters             | A colon delimited list of users who should NOT be allowed to                  | uid=youruser,o=NCEAS,dc=ecoinformatics,dc=org |
363
|                                   | submit documents. If no value is specified, all users will be allowed to      |                                               |
364
|                                   | submit documents.                                                             |                                               |
365
|                                   |                                                                               |                                               |
366
|                                   | Default Value: (none)                                                         |                                               |
367
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
368
| ldap.connectTimeLimit*            | The time in milliseconds allowed for LDAP server connections.                 | 5000                                          |
369
|                                   |                                                                               |                                               |
370
|                                   | Default Value: 5000                                                           |                                               |
371
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
372
| ldap.searchTimeLimit*             | The time in milliseconds allowed for LDAP server searches.                    | 3000                                          |
373
|                                   |                                                                               |                                               |
374
|                                   | Default Value: 30000                                                          |                                               |
375
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
376
| ldap.searchCountLimit*            | The number of return entries allowed for LDAP server searches.                | 30000                                         |
377
|                                   |                                                                               |                                               |
378
|                                   | Default Value: 30000                                                          |                                               |
379
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
380
| ldap.referral*                    | The type of LDAP referrals to use. Possible values are "follow",              | follow                                        |
381
|                                   | "throw" or "none". Refer to LDAP documentation for further information.       |                                               |
382
|                                   |                                                                               |                                               |
383
|                                   | Default Value: follow                                                         |                                               |
384
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
385
| ldap.onlySecureConnection*        | Determines whether to use only a secure LDAP server.                          | false                                         |
386
|                                   | Acceptable values are "true" and "false".                                     |                                               |
387
|                                   |                                                                               |                                               |
388
|                                   | Default Value: false                                                          |                                               |
389
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
390
| ldap.onlySecureReferalsConnection*| Determines whether to only use a secure referral server.                      | false                                         |
391
|                                   | Acceptable values are "true" and "false".                                     |                                               |
392
|                                   |                                                                               |                                               |
393
|                                   | Default Value: false                                                          |                                               |
394
+-----------------------------------+-------------------------------------------------------------------------------+-----------------------------------------------+
395

    
396
XML/EML Properties
397
------------------
398
Metacat's XML/EML properties are described below. These properties can only be 
399
edited manually in the metacat.properties file. 
400

    
401
XML/EML Properties
402

    
403
+-----------------------+------------------------------------------------------------------+---------------------------------------------------+
404
| Property              | Description                                                      | Example                                           |
405
+=======================+==================================================================+===================================================+
406
| xml.saxparser         | The SAX parser used to parse XML documents. Metacat              | org.apache.xerces.parsers.SAXParser               |
407
|                       | requires a SAX2-compatible XML parser.                           |                                                   |
408
|                       |                                                                  |                                                   |
409
|                       | Default Value: org.apache.xerces.parsers.SAXParser               |                                                   |
410
+-----------------------+------------------------------------------------------------------+---------------------------------------------------+
411
| xml.eml2_0_0namespace | The namespace of EML 2.0.0 documents.                            | eml://ecoinformatics.org/eml-2.0.0                |
412
|                       |                                                                  |                                                   |
413
|                       | Default Value: eml://ecoinformatics.org/eml-2.0.0                |                                                   |
414
+-----------------------+------------------------------------------------------------------+---------------------------------------------------+
415
| xml.eml2_0_1namespace | The namespace of EML 2.0.1 documents.                            | eml://ecoinformatics.org/eml-2.0.1                |
416
|                       |                                                                  |                                                   |
417
|                       | Default Value: eml://ecoinformatics.org/eml-2.0.1                |                                                   |
418
+-----------------------+------------------------------------------------------------------+---------------------------------------------------+
419
| xml.eml2_1_0namespace | The namespace of EML 2.1.0 documents.                            | eml://ecoinformatics.org/eml-2.1.0                |
420
|                       |                                                                  |                                                   |
421
|                       | Default Value: eml://ecoinformatics.org/eml-2.1.0                |                                                   |
422
+-----------------------+------------------------------------------------------------------+---------------------------------------------------+
423
|                       |                                                                  |                                                   |
424
| xml.packagedoctype    | The doctype of a package file. The system will only              | -//ecoinformatics.org//eml-dataset-2.0.0beta6//EN |
425
|                       | recognize documents of this type as package files.               | -//ecoinformatics.org//eml-dataset-2.0.0beta4//EN |
426
|                       | See: package documentation.                                      |                                                   |
427
|                       |                                                                  |                                                   |
428
|                       | Default Value: -//ecoinformatics.org//eml-dataset-2.0.0beta6//EN |                                                   |
429
+-----------------------+------------------------------------------------------------------+---------------------------------------------------+
430
| xml.accessdoctype     | The doctype of an access control list (ACL) file. The system     | -//ecoinformatics.org//eml-access-2.0.0beta6//EN  |
431
|                       | will only recognize documents of this type as                    | -//ecoinformatics.org//eml-access-2.0.0beta4//EN  |
432
|                       | access files. See: access control documentation.                 |                                                   |
433
|                       |                                                                  |                                                   |
434
|                       | Default Value: -//ecoinformatics.org//eml-access-2.0.0beta6//EN  |                                                   |
435
+-----------------------+------------------------------------------------------------------+---------------------------------------------------+
436

    
437

    
(16-16/22)