Notes for using MILARQ

This file available at: http://code.google.com/p/milarq/source/browse/README.text

See also documents in the MILARQ project wiki:

• http://code.google.com/p/milarq/wiki/ServerConfiguration
• http://code.google.com/p/milarq/wiki/CLAROS_server_setup_notes (specific to CLAROS, but information may be helpful for other projects)

The MILARQ project includes copies of the relevant Jena/ARQ/TDB ARQ library files in the webapp/WEB-INF/lib directory. It does not work with older versions, and probably does not work yet with newer versions.

See: http://code.google.com/p/milarq/source/browse/#hg%2Fwebapp%2FWEB-INF%2Flib

TDB and ARQ command line tools

The command line utilities used for loading and querying a TDB database are in the Jena library .jar files, in directory webapp/WEB-INF/lib. Project file workspace/tools/define_paths.sh contains a shell script that sets up the Java environment and defines commands to run these utilities.

Logging output from the command line utilities is controlled by webapp/WEB-INF/classes/log4j.properties. [[@@I think - need to confirm this]]

For details about how to use the standard ARQ and TDB command line tools, see: http://jena.sourceforge.net/tools.html

Preparing composite indexes

See workspace/tools/process.sh

Configuring and running a SPARQLite servlet using the extra indexing

See docs/howto.text

Directories

src/

• all java sources src/cmd/
• utilities for augmenting data, creating alternative indexes, and performance-testing src/propertyfunctions/
• additional ARQ property functions used to process additional indexes src/uk.ac.ox.zoo.sparqlite/...
• original SPARQlite code, reorganized, integrated with new property functions and with new/updated configuration mechanisms src/util/
• bits of support code. TF.java defines local vocabularies (mainly for testing?)

JUnit3/ Apache Tomcat .../ JRE System Library/ Referenced Libraries/

• instantiated by some Eclipse magic, it seems: they aren't present in the code repository

docs/

• servlet setup HOWTO and project plan. More to come.

lib/

• servlet API JAR (?)

test/

• unused hangover from SPARQLite?

webapp/

• web application (servlet) directories webapp/WEB-INF/data/ webapp/WEB-INF/tdb/
• test data from SPARQLite (is this used?) webapp/WEB-INF/classes/... ? can't tell if this is used or up to date - it appears to contain some new class files, but I don't see any of the exception classes here. webapp/WEB-INF/lib/...
• java support libraries used (ARQ, TDB and much more) webapp/lib/...
• stuff used by the SPARQLite javascript applications (YUI, etc.)

Testing

(What tests should be runnable out-of-box with properly configured system?)