Revision 3591
Added by Duane Costa about 17 years ago
properties.html | ||
---|---|---|
13 | 13 |
--> |
14 | 14 |
<HTML> |
15 | 15 |
<HEAD> |
16 |
<TITLE>Metacat</TITLE> |
|
16 |
<TITLE>Metacat Properties File</TITLE>
|
|
17 | 17 |
<link rel="stylesheet" type="text/css" href="@docrooturl@default.css"> |
18 | 18 |
</HEAD> |
19 | 19 |
<BODY> |
... | ... | |
26 | 26 |
</td> |
27 | 27 |
</tr> |
28 | 28 |
</table> |
29 |
<p>Metacat Server has many dynamically settable properties. All of them |
|
30 |
are kept in the Metacat.properties file. Most can be set from within |
|
31 |
the build file when you first install Metacat. The following is a summary |
|
32 |
of each property and its function.</p> |
|
29 |
<p>Metacat Server has many dynamically settable properties. |
|
30 |
All of them are kept in the <em>metacat.properties</em> file. |
|
31 |
Most <a href="./metacatinstall.html#buildProperties">can be set from within |
|
32 |
the build file</a> when you first install Metacat. |
|
33 |
The following is a summary of each property and its function. |
|
34 |
</p> |
|
33 | 35 |
<table border="1"> |
34 | 36 |
<tr> |
35 | 37 |
<td><b>Property</b></td> |
... | ... | |
77 | 79 |
<tr> |
78 | 80 |
<td>maximumConnections</td> |
79 | 81 |
<td>The maximum number of database connection Metacat can make.</td> |
80 |
<td>10</td>
|
|
82 |
<td>25</td>
|
|
81 | 83 |
</tr> |
82 | 84 |
<tr> |
83 | 85 |
<td>config-dir</td> |
... | ... | |
98 | 100 |
<tr> |
99 | 101 |
<td>siteCode</td> |
100 | 102 |
<td>The code for the current site.</td> |
101 |
<td>NCEAS</td>
|
|
103 |
<td>nceas</td>
|
|
102 | 104 |
</tr> |
103 | 105 |
<tr> |
104 | 106 |
<td>accNumSeparator</td> |
... | ... | |
223 | 225 |
</td> |
224 | 226 |
</tr> |
225 | 227 |
<tr><td> </td></tr> |
226 |
<tr><td colspan="3"><b>Additional parameters probably not needing to be changed</b></td></tr> |
|
227 |
<tr><td>configured</td><td>Configuration flag, currently not used.</td><td>false</td></tr> |
|
228 |
<tr><td>version</td><td>Release version.</td><td>1.5.0-</td></tr> |
|
228 |
|
|
229 |
|
|
230 |
<tr><td colspan="3"><b>Additional properties that probably do not need to be changed</b></td></tr> |
|
231 |
<tr><td>configured</td><td>Configuration flag</td><td>true</td></tr> |
|
232 |
<tr><td>configurationPage</td><td></td>The page to do metacat configuration<td>/configure.jsp</td></tr> |
|
233 |
<tr><td>configurationSuccessPage</td><td>The page to show successful message after configuration</td><td>/configure-restart.jsp</td></tr> |
|
234 |
<tr><td>version</td><td>Release version.</td><td>1.7.1</td></tr> |
|
229 | 235 |
<tr><td>maximumConnectionAge</td><td> </td><td>120000</td></tr> |
230 | 236 |
<tr><td>maximumConnectionTime</td><td> </td><td>60000</td></tr> |
231 | 237 |
<tr><td>maximumUsageNumber</td><td> </td><td>100</td></tr> |
238 |
<tr><td>numberOfIndexingThreads</td><td> </td><td>5</td></tr> |
|
239 |
<tr><td>indexingTimerTaskTime</td><td> </td><td>604800000</td></tr> |
|
240 |
<tr><td>indexingInitialDelay</td><td> </td><td>3600000</td></tr> |
|
241 |
<tr><td>maximumIndexDelay</td><td> </td><td>5000</td></tr> |
|
232 | 242 |
<tr><td>runDBConnectionRecycleThread</td><td> </td><td>off</td></tr> |
233 | 243 |
<tr><td>cycleTimeOfDBConnection</td><td> </td><td>30000</td></tr> |
244 |
<tr> |
|
245 |
<td>timedreplication</td> |
|
246 |
<td>Determines whether timed replication to other metacat servers is being used.</td> |
|
247 |
<td>Default: |
|
248 |
<code>false</code> |
|
249 |
<br><br>Other possible values: |
|
250 |
<code>true</code> |
|
251 |
</td> |
|
252 |
</tr> |
|
253 |
<tr> |
|
254 |
<td>firsttimedreplication</td> |
|
255 |
<td>The time for starting first timed replication if timedreplication is true. |
|
256 |
(See comments in build.properties file for additional details.)</td> |
|
257 |
<td>Default: |
|
258 |
<code>10:00 PM</code> |
|
259 |
<code> </code> |
|
260 |
</td> |
|
261 |
</tr> |
|
262 |
<tr> |
|
263 |
<td>timedreplicationinterval</td> |
|
264 |
<td>The interval to next timed replication if timedreplication is true. |
|
265 |
The value is in milliseconds and default value is 48 hours.</td> |
|
266 |
<td>Default: |
|
267 |
<code>172800000</code> |
|
268 |
<code> </code> |
|
269 |
</td> |
|
270 |
</tr> |
|
234 | 271 |
<tr><td>forcereplicationwaitingtime</td><td> </td><td></td></tr> |
235 | 272 |
<tr><td>eml2_0_0namespace</td><td>Namespace of EML 2.0.0 documents.</td><td>eml://ecoinformatics.org/eml-2.0.0</td></tr> |
236 | 273 |
<tr><td>eml2_0_1namespace</td><td>Namespace of EML 2.0.1 documents.</td><td>eml://ecoinformatics.org/eml-2.0.1</td></tr> |
... | ... | |
238 | 275 |
<tr><td>physicaldoctype</td><td> </td><td>-//ecoinformatics.org//eml-physical-2.0.0beta6//EN, -//ecoinformatics.org//eml-physical-2.0.0beta4//EN</td></tr> |
239 | 276 |
<tr><td>entitydoctype</td><td> </td><td>-//ecoinformatics.org//eml-entity-2.0.0beta6//EN, -//ecoinformatics.org//eml-entity-2.0.0beta4//EN</td></tr> |
240 | 277 |
<tr><td>packagedoctypeset</td><td> </td><td> </td></tr> |
241 |
<tr><td>httpserver</td><td> </td><td></td></tr> |
|
278 |
<tr> |
|
279 |
<td>httpserver</td> |
|
280 |
<td>httpserver is the plain HTTP address and port number that Metacat uses for purposes |
|
281 |
other than replication. Since this property is usually composed of the <code>config.hosthame</code> and <code>config.port</code> |
|
282 |
properties (described above), the default setting can be used in most cases.</td> |
|
283 |
<td>Default: <code>${config.hostname}:${config.port}</code> |
|
284 |
</td> |
|
285 |
</tr> |
|
242 | 286 |
<tr><td>junittesturl</td><td>The url of the test server.</td><td></td></tr> |
243 | 287 |
<tr><td>replicationerrorlog</td><td> </td><td></td></tr> |
244 | 288 |
<tr><td>schemaPath</td><td>Path to installed XSD schemas.</td><td></td></tr> |
... | ... | |
254 | 298 |
<tr><td>app_resultsetsize</td><td>Used for the setting the size of resultset that is processed at a time for applications like morpho</td><td>400</td></tr> |
255 | 299 |
<tr><td>web_resultsetsize</td><td>Used for the setting the size of resultset for search done using browser</td><td>900</td></tr> |
256 | 300 |
<tr><td>queryresult_string_length</td><td>Used for the setting the size of queryresult_string in queryresult table</td><td>4000</td></tr> |
301 |
<tr> |
|
302 |
<td>queryresult_cache_size</td> |
|
303 |
<td>The size of query result cache.</td> |
|
304 |
<td>Default: 500</td> |
|
305 |
</tr> |
|
306 |
<tr> |
|
307 |
<td>query_cache_on</td> |
|
308 |
<td>Turn the query result cache on or off</td> |
|
309 |
<td>Default: true</td> |
|
310 |
</tr> |
|
257 | 311 |
<tr><td>xml_returnfield_count</td><td>Value of xml_returnfield.usage_count should be more than this value for records to be entered into xml_queryresult</td><td>0</td></tr> |
312 |
<tr> |
|
313 |
<td>moderators</td> |
|
314 |
<td>Moderator accounts, in a colon-separated list. Special users who will review general user's submission. |
|
315 |
Moderators can approve, revise and reject the submission after reviewing. This property is only used in ESA skin.</td> |
|
316 |
<td>Default: <code>cn=knb-prod,o=NCEAS,dc=ecoinformatics,dc=org</code></td> |
|
317 |
</tr> |
|
318 |
<tr> |
|
319 |
<td>allowedSubmitters</td> |
|
320 |
<td>Specifies the list of users who should be allowed to submit documents. |
|
321 |
If no value is specified (the default setting), all users will be allowed to submit documents. |
|
322 |
</td> |
|
323 |
<td>Default: (no value)</td> |
|
324 |
</tr> |
|
325 |
<tr> |
|
326 |
<td>deniedSubmitters</td> |
|
327 |
<td>Specify the list of users who should not be allowed to submit documents. |
|
328 |
If no value is specified (the default setting), all users will be allowed to submit documents.</td> |
|
329 |
<td>Default: (no value)</td> |
|
330 |
</tr> |
|
331 |
<tr> |
|
332 |
<td>indexNamespaces</td> |
|
333 |
<td>A comma-separated list of doctypes which will be indexed</td> |
|
334 |
<td>Default: @eml2_0_0namespace@,@eml2_0_1namespace@</td> |
|
335 |
</tr> |
|
336 |
<tr> |
|
337 |
<td>indexPaths</td> |
|
338 |
<td>See <a href="./metacatinstall.html#buildProperties">description of build properties</a></td> |
|
339 |
<td>Default: <code>organizationName,originator/individualName/surName,...</code></td> |
|
340 |
</tr> |
|
341 |
<tr> |
|
342 |
<td>ldapconnecttimelimit</td> |
|
343 |
<td>The time in milliseconds allowed for ldap server connections.</td> |
|
344 |
<td>Default: 5000</td> |
|
345 |
</tr> |
|
346 |
<tr> |
|
347 |
<td>ldapsearchtimelimit</td> |
|
348 |
<td>The time in milliseconds allowed for ldap server searches.</td> |
|
349 |
<td>Default: 30000</td> |
|
350 |
</tr> |
|
351 |
<tr> |
|
352 |
<td>ldapsearchcountlimit</td> |
|
353 |
<td>The count of return entries allowed for ldap server searches.</td> |
|
354 |
<td>Default: 30000</td> |
|
355 |
</tr> |
|
356 |
<tr> |
|
357 |
<td>onlySecureLDAPConnection</td> |
|
358 |
<td>When set to true, connects main LDAP server only by SSL</td> |
|
359 |
<td>Default: false</td> |
|
360 |
</tr> |
|
361 |
<tr> |
|
362 |
<td>onlySecureLDAPReferalsConnection</td> |
|
363 |
<td>When set to true, connects referal LDAP server only by SSL</td> |
|
364 |
<td>Default: false</td> |
|
365 |
</tr> |
|
366 |
<tr> |
|
367 |
<td>skinconfigfiles</td> |
|
368 |
<td>List of skins which have configure files</td> |
|
369 |
<td>Default: esa,nceas,knb,obfs,nrs,sanparks</td> |
|
370 |
</tr> |
|
371 |
<tr> |
|
372 |
<td>writeDebugToFile</td> |
|
373 |
<td>Used for writing debug info into a another output file.</td> |
|
374 |
<td>Default: true</td> |
|
375 |
</tr> |
|
376 |
<tr> |
|
377 |
<td>debugOutputFile</td> |
|
378 |
<td>Output file name where debug info will be written.</td> |
|
379 |
<td>Default: /tmp/metacat.debug</td> |
|
380 |
</tr> |
|
381 |
<tr> |
|
382 |
<td>delimiteredOutputFile</td> |
|
383 |
<td>Delimited text output file name where debug info will be written.</td> |
|
384 |
<td>Default: /tmp/metacat.debug.delimitered</td> |
|
385 |
</tr> |
|
386 |
<tr> |
|
387 |
<td><em>Metacat Harvester properties</em>:<br/><br/> |
|
388 |
connectToMetacat, delay, harvesterAdministrator, |
|
389 |
logPeriod, maxHarvests, period, smtpServer, GetDocError, GetDocSuccess, GetHarvestListError, |
|
390 |
GetHarvestListSuccess, HarvesterStartup, HarvesterShutdown, InsertDocError, InsertDocSuccess, |
|
391 |
MetacatHasDoc, UpdateDocError, UpdateDocSuccess, ValidateDocError, ValidateDocSuccess, |
|
392 |
ValidateHarvestListError, ValidateHarvestListSuccess</td> |
|
393 |
<td>See <a href="./harvester.html">Metacat Harvester</a> documentation</td> |
|
394 |
<td></td> |
|
395 |
</tr> |
|
396 |
<tr> |
|
397 |
<td><em>Spatial properties</em>:<br/><br/> |
|
398 |
runSpatialOption, |
|
399 |
regenerateCacheOnRestart, |
|
400 |
spatialDocnameList, |
|
401 |
eml_westBoundingCoordinatePath, |
|
402 |
eml_eastBoundingCoordinatePath, |
|
403 |
eml_southBoundingCoordinatePath, |
|
404 |
eml_northBoundingCoordinatePath, |
|
405 |
fgdc_westBoundingCoordinatePath, |
|
406 |
fgdc_eastBoundingCoordinatePath, |
|
407 |
fgdc_southBoundingCoordinatePath, |
|
408 |
fgdc_northBoundingCoordinatePath, |
|
409 |
metadata_westBoundingCoordinatePath, |
|
410 |
metadata_eastBoundingCoordinatePath, |
|
411 |
metadata_southBoundingCoordinatePath, |
|
412 |
metadata_northBoundingCoordinatePath, |
|
413 |
docTitle, |
|
414 |
metacatUrl, |
|
415 |
baseUrl |
|
416 |
</td> |
|
417 |
<td>See <a href="./spatial_option.html">Metacat Spatial Option</a> documentation</td> |
|
418 |
<td></td> |
|
419 |
</tr> |
|
420 |
<tr> |
|
421 |
<td>sitemapDirectory</td> |
|
422 |
<td>The relative directory path in which sitemap files should be written.</td> |
|
423 |
<td>Default: @install-dir@/sitemaps</td> |
|
424 |
</tr> |
|
425 |
<tr> |
|
426 |
<td>sitemapInterval</td> |
|
427 |
<td>The time interval (in milliseconds) between rebuilding the sitemap.</td> |
|
428 |
<td>Default: 86400000</td> |
|
429 |
</tr> |
|
258 | 430 |
</table> |
259 | 431 |
|
260 | 432 |
<br> |
Also available in: Unified diff
Update documentation of build.properties and metacat.properties prior to the metacat 1.7.1 release.
The main goal here was to ensure that all previously undocumented properties are now present in these documents. Some minor edits were also made to a few of the already documented properties.
A fairly lengthy description was written for the 'indexPaths' build property. Perhaps in future documentation there should be a sub-section of the "Query and Results" document that describes indexPaths at greater length.
These revisions were made by costa and tao.