Chapter 2. Setup RDF Graph

Table of Contents

Setup the System Environment
Setup the SPARQL Service
Deploy joseki.war
Use Apache Tomcat
Use Oracle WebLogic Server
Configuring an Oracle NoSQL Database connection in the SPARQL service
Configuring the SPARQL Service: Oracle NoSQL Database

Setup the System Environment

To use the RDF Graph feature, you must first ensure that the system environment has the necessary software. Please refer to Prerequisite Software for the prerequisite software list.

  1. Download the RDF Graph feature (rdf_graph_for_nosql_database.zip) from Oracle's Software Delivery Cloud, and unzip it into a temporary directory, such as (on a Linux system) /tmp/jena_adapter. (If this temporary directory does not already exist, create it before the unzip operation.)

    See Prerequisite Software for complete download instructions.

  2. The RDF Graph feature directories and files have the following structure:

    jar/ 
        jar/sdordfnosqlclient.jar
    javadoc/ 
    	javadoc/javadoc.zip
    joseki/ 
        joseki/index.html 
    	joseki/application.xml 
    	joseki/update.html 
    	joseki/xml-to-html.xsl 
    	joseki/joseki-config.ttl
    web/ 
    	web/web.xml
    war/
    	war/joseki.war
    examples/ 
        examples/Examples1.java 
        examples/Examples1b.java 
        examples/Examples1c.java 
        examples/Examples1d.java 
        examples/Examples2.java 
        examples/Examples2b.java 
        examples/Examples3.java 
        examples/Examples4.java 
        examples/Examples4b.java 
        examples/Examples5.java 
        examples/Examples5b.java 
        examples/Examples5c.java 
        examples/Examples5d.java 
        examples/Examples5e.java 
        examples/Examples5f.java 
        examples/Examples5g.java 
        examples/Examples5h.java 
        examples/Examples6.java
        examples/Examples7.java 
        examples/Examples8.java 
        examples/Examples9.java
        examples/Examples10.java 
        examples/Examples11.java 
        examples/Examples12.java 
        examples/Examples13.java 
        examples/Examples14.java 
        examples/Examples15.java 
        examples/Examples16.java
        examples/Examples16b.java
        examples/Examples17.java
        examples/example.nt
  3. The structure of directories and file should also include the following lines:

    examples/family.rdf
    sparqlgateway/
    sparqlgateway.war

    Copy kvclient.jar into <Jena_DIR>/lib (Linux) or <Jena_DIR>\lib (Windows). (kvclient.jar is included in $KVHOME/lib or $KVHOME/lib).

  4. If the JAVA_HOME environment variable does not already refer to the JDK 1.6 (update 25 or later) installation, define it accordingly. For example:

    setenv JAVA_HOME /usr/local/packages/jdk16_u25/
  5. If the SPARQL service to support the SPARQL protocol is not set up, set it up as explained in Setup the SPARQL Service.