Metacat Properties File

Back | Home | Next

Metacat Server has properties that are stored in two general locations. Global properties are held in:

<CONTEXT_DIR>*/WEB_INF/metacat.properties.

Skin specific properties are set on a per-skin basis in:

<CONTEXT_DIR>*/WEB_INF/style/skins/<SKIN_NAME>/<SKIN_NAME>.properties

The most dynamic properties are modified using the internal Metacat configuration utility . However, it may be necessary to manually edit a configuration file to update more static values.

The list of properties shown on this page gives the following information about each property:

(* CONTEXT_DIR refers to the directory where the Metacat application code lives. This is a combination of the web application directory and the metacat context directory. This usually looks something like /usr/local/tomcat/webapps/knb. However, your webapps directory could be somewhere besides the tomcat directory and your context could be something other than knb.)

Index

Global Metacat Properties
Server Values
Application Values
Database Values
Authorization Values
Authentication Values
XML/EML Values

Global Metacat Properties - (metacat.properties)


server.name

Default Value:

localhost

Set Method:

Configuration Utility

Description:

The network host name that will be used to access Metacat. Note that this is not necessarily the physical name of the server running Metacat. The host name should not include the protocol prefix (http://).

Example:

knb.ecoinformatics.org

server.httpPort

Default Value:

80

Set Method:

Configuration Utility

Description:

The network port that will be used to access Metacat for non-secure (standard) connections. This is usually 80 if Apache web server is running (typical install), and 8080 if Tomcat is running alone, but both Apache and Tomcat could have been configured to listen on alternate ports.

Example:

80

server.httpSSLPort

Default Value:

443

Set Method:

Configuration Utility

Description:

The network port that will be used to access Metacat for secure connections. This is usually 443 if Apache web server is running (typical install), and 8443 if Tomcat is running alone, but both Apache and Tomcat could have been configured to listen on alternate ports.

Example:

443


application.metacatVersion

Default Value:

1.9.0

Set Method:

Manual

Description:

The Metacat version number. usually, this should never be changed. It is set by the build engineer at build time.

Example:

1.9.0

application.deployDir

Default Value:

(none)

Set Method:

Configuration Utility

Description:

The directory where web applications are deployed. Many times this is in a directory named "webapps" in the Tomcat installation directory. However, Tomcat may be configured to look in a different directory.

Example:

/usr/local/tomcat/webapps

application.context

Default Value:

(none)

Set Method:

Configuration Utility

Description:

Applications run in individual directories in the applicaton deployment directory. The name of the application directory is the application context. This corresponds to the first part of the war file name (the part before .war). Most commonly, this is "knb", but it can be changed to other things.

Example:

knb

application.default-style

Default Value:

default

Set Method:

Configuration Utility

Description:

There are some custom web skins available in Metacat. Typically these are associated with an organizational theme. If there is not a custom skin for your organization, you should leave it as "default".

Example:

default

application.knbSiteURL

Default Value:

http://knb.ecoinformatics.org

Set Method:

Configuration Utility

Description:

The KNB site to redirect to.

Example:

http://knb.ecoinformatics.org

application.datafilepath

Default Value:

/var/metacat/data

Set Method:

Configuration Utility

Description:

This is the directory whera data files will be stored. This should be some directory outside the Metacat installation directories so data files will not get lost when Metacat is upgraded. The data file directory must be writable by the user that starts Tomcat (and thus Metacat).

Example:

/var/metacat/data

application.inlinedatafilepath

Default Value:

/var/metacat/inline-data

Set Method:

Configuration Utility

Description:

This is the directory where inline data files will be stored. Inline data files are created from data that is embedded in EML metadata. This should be some directory outside the Metacat installation directories so data files will not get lost when Metacat is upgraded. For clarity of data, this should probably not be the same as application.datafilepath. The data file directory must be writable by the user that starts Tomcat (and thus Metacat).

Example:

/var/metacat/inline-data

application.documentfilepath

Default Value:

/var/metacat/documents

Set Method:

Configuration Utility

Description:

This is the directory where metadata document files will be stored. This should be some directory outside the Metacat installation directories so document files will not get lost when Metacat is upgraded. For clarity of organization, this should probably not be the same as application.datafilepath or application.inlinedatafilepath. The data file directory must be writable by the user that starts Tomcat (and thus Metacat).

Example:

/var/metacat/documents

application.tempDir

Default Value:

/var/metacat/temporary

Set Method:

Manual

Description:

This is the directory that Metacat data registry uses to store temporary files. This should not be the same as application.datafilepath or application.inlinedatafilepath (or any other persistant file path) since all files in this may be purged programatically. The temporary file directory must be writable by the user that starts Apache.

Example:

/var/metacat/temporary

application.cgiDir

Default Value:

/cgi

Set Method:

Manual

Description:

This is the directory that is configured in Apache web server to point to Metacat cgi executables. The directory is given relative to the Metacat context directory since the Metacat cgi scripts are installed with the application code. For example, if Metacat is installed in /usr/local/tomcat/knb, then an application.cgiDir of /cgi would point to
    /usr/local/tomcat/knb/cgi-dir

Example:

/cgi-bin

replication.logdir

Default Value:

none

Set Method:

Manual

Description:

If you are using replication, you will need to specify where you would like the replication log to be written. You must choose a directoy that is writable by the user that starts Tomcat.

Example:

/usr/locat/tomcat/logs


database.connectionURI

Default Value:

jdbc:postgresql://localhost/metacat

Set Method:

Configuration Utility

Description:

The jdbc connection URI for the main database instance of Metacat. The uri is formatted like:
    jdbc:<database_type>:thin@<your_server_name>:1521:<metacat_database_name>
An empty database must have been created prior to Metacat configuration.

Example:

jdbc:postgresql://yourserver.yourdomain.edu/metacat

database.user

Default Value:

(none)

Set Method:

Configuration Utility

Description:

The user for the main database instance of Metacat. The user must have already been created on the database.

Example:

metacat-user

database.password

Default Value:

(none)

Set Method:

Configuration Utility

Description:

The password of the user for the main database instance of Metacat. The password must have already been created for the user.

Example:

securepassword4843

database.type

Default Value:

(none)

Set Method:

Configuration Utility

Description:

The type of database you are running. Currently, there are two supported types, Oracle and Postgres.

Example:

postgres

database.driver

Default Value:

(none)

Set Method:

Configuration Utility

Description:

The JDBC driver to be used to access the main database instance of Metacat. There is one of these associated with each type of database.

Example:

org.postgresql.Driver

database.adapter

Default Value:

(none)

Set Method:

Configuration Utility

Description:

The adapter class that allows Metacat to access your database type. There is one of these associated with each type of database.

Example:

edu.ucsb.nceas.dbadapter.PostgresqlAdapter

database.scriptsuffix.<database_type>

Default Value:


    database.scriptsuffix.postgres=postgres.sql
    database.scriptsuffix.oracle=oracle.sql

Set Method:

Configuration Utility

Description:

There is a database.scriptsuffix entry for every supported type of database. These tell the system which database scripts to run when installing or updating database schema.

Example:

postgres.sql

database.upgradeVersion.<database_version>

Default Value:


    database.upgradeVersion.0.0.0=xmltables,loaddtdschema
    database.upgradeVersion.1.2.0=upgrade-db-to-1.2
    database.upgradeVersion.1.3.0=upgrade-db-to-1.3
    database.upgradeVersion.1.4.0=upgrade-db-to-1.4
    database.upgradeVersion.1.5.0=upgrade-db-to-1.5
    database.upgradeVersion.1.6.0=upgrade-db-to-1.6
    database.upgradeVersion.1.7.0=upgrade-db-to-1.7
    database.upgradeVersion.1.8.0=upgrade-db-to-1.8
    database.upgradeVersion.1.9.0=upgrade-db-to-1.9

Set Method:

Configuration Utility

Description:

There is a database.scriptsuffix entry for every metacat database schema version. (Note that a schema version corresponds to an application version.) These tell the system which database scripts to run when installing or updating database schema.

Example:

upgrade-db-to-1.2

database.initialConnections

Default Value:

5

Set Method:

Manual

Description:

The number of initial connection that Metacat creates to the database.

Example:

5

database.incrementConnections

Default Value:

5

Set Method:

Manual

Description:

The number of connections that are created when Metacat needs more connections.

Example:

5

database.maximumConnections

Default Value:

25

Set Method:

Manual

Description:

The maximum number of database connections Metacat can make.

Example:

25

database.maximumConnectionAge

Default Value:

120000

Set Method:

Manual

Description:

The maximum time in milliseconds that a database connection can live.

Example:

120000

database.maximumConnectionTime

Default Value:

60000

Set Method:

Manual

Description:

The maximum time in milliseconds that a database connection can accumulate in actual connection time.

Example:

60000

database.maximumUsageNumber

Default Value:

100

Set Method:

Manual

Description:

The maximum number of times a single connection can be used.

Example:

100

database.numberOfIndexingThreads

Default Value:

5

Set Method:

Manual

Description:

The number of threads available for indexing.

Example:

5

database.indexingTimerTaskTime

Default Value:

604800000

Set Method:

Manual

Description:

The time in milliseconds between indexing.

Example:

604800000

database.indexingInitialDelay

Default Value:

3600000

Set Method:

Manual

Description:

The delay in milliseconds before first indexing is executed.

Example:

3600000

database.maximumIndexDelay

Default Value:

5000

Set Method:

Manual

Description:

The time in milliseconds that an indexing thread will wait when it can't get a doc id before retrying the indexing.

Example:

5000

database.runDBConnectionRecycleThread

Default Value:

off

Set Method:

Manual

Description:

Determines whether the database connection pool should run a thread to recycle connections. Possible values are "on" and "off"

Example:

off

database.cycleTimeOfDBConnection

Default Value:

30000

Set Method:

Manual

Description:

The time in milliseconds between connection recycling runs.

Example:

30000

database.queryignoredparams

Default Value:

enableediting,foo

Set Method:

Manual

Description:

Parameters to ignore in a structured xml query.

Example:

enableediting

database.usexmlindex

Default Value:

true

Set Method:

Manual

Description:

Determines whether to use xml indexes when finding documents. Possible values are true and false.

Example:

true

database.appResultsetSize

Default Value:

7000

Set Method:

Manual

Description:

Determines the number of results that get sent back to an application from a query.

Example:

7000

database.webResultsetSize

Default Value:

7000

Set Method:

Manual

Description:

Determines the number of results that get sent back to a web browser from a query.

Example:

7000

database.xmlReturnfieldCount

Default Value:

0

Set Method:

Manual

Description:

If the results of a query have been returned more times than database.xmlReturnfieldCount, then those results will be inserted into the xml_queryresult table in the database.

Example:

0

database.queryresultStringLength

Default Value:

500000

Set Method:

Manual

Description:

This is used to set the max size of the query result string in the queryresult table. This should be set to some number less than 4000 if an Oracle database is being used.

Example:

500000

database.queryresultCacheSize

Default Value:

500

Set Method:

Manual

Description:

The number of query results that will be cached.

Example:

500

database.queryCacheOn

Default Value:

on

Set Method:

Manual

Description:

Determines whether query caching is turned on. Acceptible values are "on" and "off"

Example:

on


auth.class

Default Value:

edu.ucsb.nceas.metacat.AuthLdap

Set Method:

Configuration Utility

Description:

The class that is used for user authentication. Currently, only the AuthLdap class is included in the Metacat distribution, but it is possible for an admin to implement other authentication strategies by implementing a Java class that extends the AuthInterface interface and rebuilding Metacat. Change this to be the fully qualified class name of your custom authentication mechanism.

Example:

edu.ucsb.nceas.metacat.AuthLdap

auth.timeoutMinutes

Default Value:

180

Set Method:

Manual

Description:

The number of minutes that a user will stay logged in to Metacat without any activity.

Example:

180


auth.administrators

Default Value:

(none)

Set Method:

Configuration Utility

Description:

A colon separated list of The ldap users or groups that have administrative privileges to Metacat. Note that during the intial installation of Metacat, the installer will be asked to enter this value. At least one user or group must be entered and all accounts must exist in LDAP, or the installer will not be allowed to continue with the configuration.

Example:


uid=youruser,o=NCEAS,dc=ecoinformatics,dc=org


cn=yourgroup,o=NCEAS,dc=ecoinformatics,dc=org

auth.url

Default Value:

ldap://ldap.ecoinformatics.org:389/

Set Method:

Configuration Utility

Description:

The url of the server that Metacat should use for authentication.

Example:

ldap://ldap.ecoinformatics.org:389/

auth.surl

Default Value:

ldap://ldap.ecoinformatics.org:389/

Set Method:

Configuration Utility

Description:

The url of the server that Metacat should use for secure authentication.

Example:

ldap://ldap.ecoinformatics.org:389/

auth.allowedSubmitters

Default Value:

(none)

Set Method:

Configuration Utility

Description:

A colon delimited list of users who should be allowed to submit documents. If no value is specified, all users will be allowed to submit documents.

Example:

uid=youruser,o=NCEAS,dc=ecoinformatics,dc=org

auth.deniedSubmitters

Default Value:

(none)

Set Method:

Configuration Utility

Description:

A colon delimited list of users who should not be allowed to submit documents. If no value is specified, all users will be allowed to submit documents.

Example:

uid=youruser,o=NCEAS,dc=ecoinformatics,dc=org

ldap.connectTimeLimit

Default Value:

5000

Set Method:

Manual

Description:

The time in milliseconds allowed for ldap server connections.

Example:

5000

ldap.searchTimeLimit

Default Value:

30000

Set Method:

Manual

Description:

The time in milliseconds allowed for ldap server searches.

Example:

30000

ldap.searchCountLimit

Default Value:

30000

Set Method:

Manual

Description:

the count of return entries allowed for ldap server searches.

Example:

30000

ldap.referral

Default Value:

follow

Set Method:

Manual

Description:

The type of ldap referrals to use. Acceptible values are "follow", "throw" or "none". Refer to ldap documentation for further information.

Example:

follow

ldap.onlySecureConnection

Default Value:

false

Set Method:

Manual

Description:

Determines whether to only use secure ldap server. Acceptible values are "true" and "false".

Example:

false

ldap.onlySecureReferalsConnection

Default Value:

false

Set Method:

Manual

Description:

Determines whether to only use secure referral server. Acceptible values are "true" and "false".

Example:

false


xml.saxparser

Default Value:

org.apache.xerces.parsers.SAXParser

Set Method:

Manual

Description:

The SAX parser used to parse XML documents. See: SAX parser documentation.

Example:

org.apache.xerces.parsers.SAXParser

xml.eml2_0_0namespace

Default Value:

eml://ecoinformatics.org/eml-2.0.0

Set Method:

Manual

Description:

The namespace of EML 2.0.0 documents.

Example:

eml://ecoinformatics.org/eml-2.0.0

xml.eml2_0_1namespace

Default Value:

eml://ecoinformatics.org/eml-2.0.1

Set Method:

Manual

Description:

The namespace of EML 2.0.1 documents.

Example:

eml://ecoinformatics.org/eml-2.0.1

xml.eml2_1_0namespace

Default Value:

eml://ecoinformatics.org/eml-2.1.0

Set Method:

Manual

Description:

The namespace of EML 2.1.0 documents.

Example:

eml://ecoinformatics.org/eml-2.1.0

xml.packagedoctype

Default Value:

-//ecoinformatics.org//eml-dataset-2.0.0beta6//EN, -//ecoinformatics.org//eml-dataset-2.0.0beta4//EN

Set Method:

Manual

Description:

The doctype of a package file. The system will only recognize documents of this type as package files. See: package documentation.

Example:

-//ecoinformatics.org//eml-dataset-2.0.0beta6//EN, -//ecoinformatics.org//eml-dataset-2.0.0beta4//EN

xml.accessdoctype

Default Value:

-//ecoinformatics.org//eml-access-2.0.0beta6//EN, -//ecoinformatics.org//eml-access-2.0.0beta4//EN

Set Method:

Manual

Description:

The doctype of an access control list (ACL) file. The system will only recognize documents of this type as access files. See: access control documentation.

Example:

-//ecoinformatics.org//eml-access-2.0.0beta6//EN, -//ecoinformatics.org//eml-access-2.0.0beta4//EN


Back | Home | Next