Table of Contents
In this section, we explain how you can install a Sesame HTTP Server. You can skip this if you are not planning to run a Sesame server but intend to use Sesame as a library to program against.
The Sesame server software requires the following software:
The Sesame 2.0 server software comes in the form of two Java Web Applications: Sesame (HTTP) server and OpenRDF Workbench.
Sesame Server provides HTTP access to Sesame repositories and is meant to be accessed by other applications. Apart from some functionality to view the server's log messages, it doesn't provide any user oriented functionality. Instead, the user oriented functionality is part of OpenRDF Workbench. OpenRDF Workbench provides a web interface for querying, updating and exploring the repositories of a Sesame Server.
If you have not done so already, you will first need to download the
Sesame 2.0 SDK.
Both Sesame Server and OpenRDF Workbench can be found in the
war directory of the SDK. The war-files in this
directory need to be deployed in a Java Servlet Container (see
Section 6.1, “Required software”). The deployment
process is container-specific, please consult the documentation for
your container on how to deploy a web application.
After you have deployed the Sesame Server webapp, you should be able
to access it, by default, at path /openrdf-sesame.
You can point your browser at this location to verify that the
deployment succeeded. Your browser should show the Sesame welcome
screen as well as some options to view the server logs, among other
things. Similarly, after deployment, the OpenRDF Workbench should be
available at path /openrdf-workbench.
Both Sesame Server and OpenRDF Workbench use the
Apache log4j
logging framework. In its default configuration, all Sesame Server
log messages are sent to the log file
[ADUNA_DATA]/OpenRDF Sesame/logs/main.log
(and log messages for the Workbench to the same file in
[ADUNA_DATA]/OpenRDF workbench). See
Chapter 5, Application directory configuration for more info about data
directories.
The default log level is INFO, indicating
that only important status messages, warnings and errors are logged.
The log level can be adjusted by modifying the
.../logs/log4j.properties.../conf/log4j.properties
file. To set the log
level to, for example, DEBUG level, modify
the line setting the log level for the org.openrdf classes:
log4j.logger.org.openrdf=DEBUG
For other logging configuration options, please consult the log4j documentation.
A clean installation of a Sesame Server has a single repository by default: the SYSTEM repository. This SYSTEM repository contains all configuration data for the server, including data on which other repositories exists and (in future releases) the access rights on these repositories. This SYSTEM repository should not be used to store data that is not related to the server configuration.
For now, the easiest way to create and manage repositories in a SYSTEM repository is to use the Sesame Console. The Sesame Console is a command-line application for interacting with Sesame, a UI-version of this application is currently being developed. See Chapter 7, Sesame Console.