Page History

...

• eaglei.repository.namespace - The namespace URI prefix for Eagle-I resource instances created in the repository.
  • Every administrator should set this to a reasonable value for his/her site, because the default is NOT desireable.
  • The value must be a fully qualified, resolvable, HTTP URL.
  • For example, http://foo.bar.edu/i/
  • Use the http scheme, NOT https, since the container will redirect to https if necessary, but it is not possible to direct back if it becomes preferable to use http later.
  • The system-generated default is the hostname followed by /i/ -- but this is often wrong, since Java's determination of hostnames in a servlet container environment is not reliable.
• eaglei.repository.title - the decorative title for UI pages, should be set for cosmetic reasons.
  • Set this to the name of your site, e.g. "Miskatonic University School of Medicine".
• eaglei.repository.logo - URL of the logo image for your site, may be either relative URL (to refer to a image embedded in the webapp) or an absolute URL to use an image hosted elsewhere. It should be about 50 pixels high and a suitable with given the proportions.
• eaglei.repository.index.url - Set this to the URL to which you want the site's "root" (top-level index) page redirected. Although the repository is installed as the root webapp to have control over resolving Semantic Web URIs, it does not need the root page so this allows you to configure your site as you like.
• eaglei.repository.admin.backgroundColor - Lets you change the background color for admin web UI pages, to give admins an obvious cue when they are operating on e.g. the production vs. test repos. Value is CSS color expression, e.g. crayon name like "bisque" or hex #CCFFCC (Added in Release 1.2MS2 or 3)
• eaglei.repository.instance.xslt - path to XSL stylesheet used to transform the HTML output of the instance dissemination service. A value for this key is required to produce XHTML in the dissemination service; without it, the service returns the internal XML document describing the instance.
  • If it is a relative path then it must be located relative to the root of the web application, if absolute then it is in the filesystem at large.
  • The advantage of keeping your stylesheets external to the webapp is that you can change them easily, and don't have to modify the webapp from its default installation.
  • An example is provided at repository/styles/example.xsl which creates very simple HTML, as a demonstration of how to write an XSL stylesheet.
• eaglei.repository.instance.css - URI of the CSS stylesheet resource to be used to style instance dissemination pages. It must be an absolute path or absolute URL. The default is:

  No Format
  eaglei.repository.instance.css = /repository/styles/i.css

• eaglei.repository.tbox.graphs - a comma-separated list of graph URIs making up the "TBox".
  You should never have to set this! It is configurable "just in case", and for testing/experimenting. For more information, see the section on inferencing in the API Manual.
  By default, the TBox consists of:
  • The repository's internal ontology, http://eagle-i.org/ont/repo/1.0/
  • The eagle-i data model ontology, http://purl.obolibrary.org/obo/ero.owl
• eaglei.repository.datamodel.source - the full name of a resource within the webapp which its itself a property file describing the RDF data model ontology. You should not need to set this, the default is adequate for the eagle-i applicaiton. Default is eaglei-datamodel.properties which is a built-in resource file.
  For a description of the contents of this properties file, see the separate document Guide to Data Model Configuration Properties
• eaglei.repository.sesame.dir - directory where Sesame RDF database files are created.
  • Defaults to sesame subdirectory of home dir.
• eaglei.repository.log.dir - Directory where log files are created.
  • Defaults to logs subdirectory of the home dir. 
  • You can also configure log4j explicitly by adding log4j properties to this file.
• eaglei.repository.sesame.indexes - index configuration for Sesame triple store. Must be a comma-separated list of index specifiers, see Sesame NativeStore configuration documentation for details. Use this to change the internal indexes Sesame maintains to process queries. It takes effect on next servlet container (tomcat) restart.

  Warning
  title WARNING
  If you have a configured value and wish to go back to the default, do NOT just delete this configuration property. If you do, Sesame will simply keep the existing indexes. You must change it to the original default value, which is documented int he default configuration file.

• eaglei.repository.slow.query - Value in seconds of time after which a SPARQL query should be considered "slow" and logged as such. Only affects the SPARQL Protocol endpoint service. Default is 0, which never logs. Use this to check for performance problems, since it logs the full text of the query and time of occurance in the regular log at INFO level.
• eaglei.repository.sparqlprotocol.max.time - Time limit, in seconds, of the maximum time allowed for a query invoked by the SPARQL Protocol endpoint. Note that this does not affect any internally-generated SPARQL queries.
  • Any user can override this setting to impose a shorter timeout by giving a value for the nonstandard time argument.
  • Only the Administrator can override with a longer timeout.
  • The built-in default is 600 seconds (10 min) if nothing is configured.
  • If a SPARQL Protocol request cannot be complted within the timeout, it returns an HTTP 413 status (result too large - it was the standard response code that comes closest to the concept).
• eaglei.repository.anonymous.user - This is a hack, only intended for testing the Anonymous role. Its value is a username, e.g. "nobody". If configured, when the designated user logs in, their session is downgraded to the Anonymous role; this allows explicit testing of Anonymous (vs. Authenticated) access even when the webapp configuration does not allow unauthenticated access. ONLY TESTERS SHOULD EVER NEED TO SET THIS.
• Configuring Contact Hiding:*The following properties control the contact hiding extension, which restricts the display of "contact location" properties of instances and instead offers an anonymous email option. Red properties are required *only if you enable contact hiding:
  • eaglei.repository.hideContacts - true|false, enables the contact hiding function. When it is false, none of the other properties are used.
  • eaglei.repository.postmaster - email address of repository administrator(s). User-generated messages about resources without a contact email address get sent here, as well as diagnostic messages. We recommend using an email list or alias so it can be changed or directed to multiple people.
  • eaglei.repository.mail.host - hostname of SMTP server for outgoing mail, defaults to localhost.
  • eaglei.repository.mail.port - TCP port number of SMTP server for outgoing mail, only necessary if using a non-default port for your chosen type of service.
  • eaglei.repository.mail.ssl - Use SSL for connection to SMTP server for outgoing mail, value is true or false.
  • eaglei.repository.mail.username - Username with which to authenticate to SMTP server for outgoing mail, default is unauthenticated.
  • eaglei.repository.mail.password - password with which to authenticate to SMTP server for outgoing mail, default is none.

...

2.0 Release

...

The following optional properties are valid after the 2.0 release.

• eaglei.repository.searchBar.javascript.url - Location of the source of the JavaScript for the search bar. The default value is sufficient unless custom search bar code needs to be loaded.
• eaglei.repository.centralSearch.url - Location of the destination of the actual searches from the search bar. The default value is sufficient unless search is to be performed by a specific application.

Note that the properties file may also contain Log4J configuration properties. For example you can turn on debugging log output by adding this line:

...