Joseki Installation

Joseki is downloadable in several forms. There is a full, "download-and-go" form that contains everything you need running a standalone server; this includes copies of all the JARs files needed from other systems. Other packaging may be available. This page assumes you have downloaded the full version.

Download structure

The Joseki server is packaged under a single directory named "Joseki-<version>", where "<version>" is the release version number. The main directories and files are:

lib/ : all the JARs files needed.
bin/ : helper scripts to build the classpath and run the server standalone.
etc/ : configuration files
Data/ : a few data files
Examples/ : examples of clients (including scipts for wget and cwm).
src/ : the complete source code
build.xml : the ant build file.

Installation process

Having unpacked the download file, go to the root directory of the download.

Set up

Set the classpath: put all the JAR files in the lib/ directory on your classpath.

# Linux/Unix/Cygwin:
cd <the root directory>
export JOSEKI_HOME="$PWD"
export CLASSPATH="$(bin/joseki_path)"

@REM Windows
cd <the root directory>
set JOSEKI_HOME=<the root directory>
bin\joseki_path
set CLASSPATH=%CP%

Test

Still in that directory, run some of the test suite.

 java junit.textui.TestRunner org.joseki.test.JosekiTests

This loads configuration from etc/. There should be the server log file output on the standard output stream. The JUnit should produce a green line. Some of the log messages say "error"; this is expected as the tests are of incorrect requests.

Publish your model

You should be able to write a configuration file and run the server:

java joseki.rdfserver <YourConfigurationFile>

The server prints its log file to standard out and this process does not terminate until the server exits.

Querying a model

From another shell or window, you can query the running server. A plain GET can be done using wget:

wget -q -O - http://localhost:2020/<YourModel>

and RDQL queries can be executed on the server with (making sure you have the classpath set):

# Linux/Unix/Cygwin: NB Single quotes on the query
java joseki.rdfqueryremote --model http://localhost:2020/<YourModel> \
     'SELECT * WHERE (?x, ?y, ?z)'

REM Windows
java joseki.rdfqueryremote --model http://localhost:2020/<YourModel> \
     "SELECT * WHERE (?x, ?y, ?z)"

Helper Scripts

There are scripts in the bin/ directory to run each of the applications. They need JOSEKI_HOME environment variable set but will set the classpath themselves. They have not been widely tested.

Support

Please email jena-dev@groups.yahoo.com with any questions you might have.