This HTML5 document contains 61 embedded RDF statements represented using HTML+Microdata notation.

The embedded RDF content will be recognized by any processor of HTML5 Microdata.

Subject Item

n8:this

foaf:made

n2:VirtSesame2HttpRepository

Subject Item

n18:item

n19:services_of

n2:VirtSesame2HttpRepository

Subject Item

n48:this

sioc:creator_of

n2:VirtSesame2HttpRepository

Subject Item

n23:ODS

sioc:container_of

n2:VirtSesame2HttpRepository

atom:entry

n2:VirtSesame2HttpRepository

atom:contains

n2:VirtSesame2HttpRepository

Subject Item

n2:VirtSesame2HttpRepository

rdf:type

sioct:Comment atom:Entry

dcterms:created

2017-06-13T06:07:33.735257

dcterms:modified

2018-04-06T11:02:34.124633

rdfs:label

VirtSesame2HttpRepository

foaf:maker

n8:this n44:this

dc:title

VirtSesame2HttpRepository

opl:isDescribedUsing

n46:rdf

sioc:has_creator

n34:this n48:this

sioc:attachment

n13:png n14:png n16:png n17:png n21:png n22:png n24:png n26:png n27:ttl n28:jar n29:jar n30:xsl n31:jar n32:png n33:xsl n37:png n39:png n42:png n43:png

sioc:content

---+ Virtuoso Sesame HTTP Repository Configuration and Usage %TOC% ---++What Sesame is an open source Java framework for storing, querying and reasoning with RDF and RDF Schema. It can be used as a database for RDF and RDF Schema, or as a Java library for applications that need to work with RDF internally. The Sesame HTTP repository serves as a proxy for a RDF store hosted on a remote Sesame server, enabling the querying of the RDF store using the Sesame HTTP protocol. ---++Why The Sesame HTTP repository endpoint provides users with the greater flexibility for manipulating the RDF store via a common interface. Sesame provides you with the necessary tools to parse, interpret, query and store all this information, embedded in your own application if you want, or, if you prefer, in a separate database or even on a remote server. ---++How To create a new Sesame HTTP repository, the Console needs to create such an RDF document and submit it to the SYSTEM repository. The Console uses so called repository configuration templates to accomplish this. Repository configuration templates are simple Turtle RDF files that describe a repository configuration, where some of the parameters are replaced with variables. The Console parses these templates and asks the user to supply values for the variables. The variables are then substituted with the specified values, which produces the required configuration data. ---++Setup and Testing This section details the steps required for configuring and testing a Virtuoso Sesame Repository, both using the HTTP and Console Sesame repositories. ---+++Requirements * [[http://www.openrdf.org/download.jsp][Sesame 2.3.1]] or higher * Appropriate <a href="http://wiki.intranet.openlinksw.com:8891/dataspace/owiki/wiki/ODS/VOSDownload#Sesame%20Provider" target="_blank">Virtuoso Sesame Provider and JDBC Driver</a> * Virtuoso System Repository config file for <a href="%ATTACHURLPATH%/create.xsl" style="wikiautogen">Sesame 2.x</a> or [[http://download3.openlinksw.com/uda/virtuoso/rdfproviders/sesame/40/create.xsl][Sesame 4.x]] (create.xsl) * Virtuoso Repository config file for <a href="%ATTACHURLPATH%/create-virtuoso.xsl" style="wikiautogen">Sesame 2.x </a> or [[http://download3.openlinksw.com/uda/virtuoso/rdfproviders/sesame/40/create-virtuoso.xsl][Sesame 4.x]] (create-virtuoso.xsl) * Configuration Template file for a Virtuoso Repository for <a href="%ATTACHURLPATH%/virtuoso.ttl" style="wikiautogen">Sesame 2.x </a> or [[http://download3.openlinksw.com/uda/virtuoso/rdfproviders/sesame/40/virtuoso.ttl][Sesame 4.x]] (virtuoso.ttl) * [[http://tomcat.apache.org/download-60.cgi][Apache Tomcat]] version 5 or higher ---+++Setup Sesame HTTP Repository This section details the steps required for configuring and testing a Virtuoso HTTP Sesame Repository. 1 Install [[http://tomcat.apache.org/tomcat-6.0-doc/index.html][Apache Tomcat]] web server 1 From the Sesame 2.3.1 or higher "lib" directory copy the "openrdf-sesame.war" and "openrdf-worbbench.war" files to the tomcat "webapps" directory where they will automatically be deployed creating two new sub directories "openrdf-sesame" and "openrdf-workbench". 1 Place the corresponding Virtuoso Sesame Provider "virt_sesame2.jar" or "virt_sesame4.jar" and JDBC Driver "virtjdbc4.jar" into the Tomcat <code>~/webapps/openrdf-sesame/WEB-INF/lib/</code> and <code>~/webapps/openrdf-workbench/WEB-INF/lib/</code> directories for use by the Sesame HTTP Repository for accessing the Virtuoso RDF repository. 1 Place the "create.xsl" and "create-virtuoso.xsl" files in the Tomcat <code>~/webapps/openrdf-workbench/transformations/</code> directory. Note "create.xsl" replaces the default provided with Sesame and contains the necessary entries required to reference the new "create-virtuoso.xsl" template file for Virtuoso repository configuration. 1 The Sesame HTTP Repository will now be accessible on the URLs <verbatim> http://localhost:8080/openrdf-sesame http://localhost:8080/openrdf-workbench </verbatim> 1 The Sesame <nop>OpenRDF Workbench is used for accessing the Sesame HTTP Repositories, loading "http://localhost:8080/openrdf-workbench" will enable the default "SYSTEM" repository to be accessed. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository02.png" style="wikiautogen"/> %BR%%BR% 1 Click on the "New Repository" link in the left frame to create a new Sesame Repository. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository03.png" style="wikiautogen"/> %BR%%BR% 1 Select the "Virtuoso RDF Store" from the "Type" drop down list box presented. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository04.png" style="wikiautogen"/> %BR%%BR% 1 Choose suitable repository "ID" and "Title" for the Virtuoso repository to be created and click "Next". %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository05.png" style="wikiautogen"/> %BR%%BR% 1 Fill in the connection parameters for the target Virtuoso sever the repository is to be created for and click the "create" button. The minimum required are the hostname, port number, username and password of the Virtuoso Server. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository06.png" style="wikiautogen"/> %BR%%BR% 1 The new Virtuoso respository will be created and its summary page displayed. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository07.png" style="wikiautogen"/> %BR%%BR% 1 Click on the "Namespaces" link in the left frame to obtain a list of the available namespaces in the Virtuoso repository. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository08.png" style="wikiautogen"/> %BR%%BR% 1 Click on the "Context" link in the left frame to obtain a list of the available contexts in the Virtuoso repository. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository09.png" style="wikiautogen"/> %BR%%BR% 1 Click on the "Types" link in the left frame to obtain a list of the available types in the Virtuoso repository. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository10.png" style="wikiautogen"/> %BR%%BR% 1 Click on the "Query" link in the left frame, enter a suitable SPARQL query to execute against the Virtuoso repository and click the "execute" button. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository11.png" style="wikiautogen"/> %BR%%BR% 1 The results of the SPARQL query are returned. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository12.png" style="wikiautogen"/> %BR%%BR% 1 Click on the "Repositories" link in the left frame and the newly created Virtuoso repository entry is displayed along side the default SYSTEM repository. %BR%%BR% <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository13.png" style="wikiautogen"/> %BR% ---+++Setup Sesame Console Repository This section details the steps required for configuring and testing a Virtuoso Sesame Console Repository 1 Extract Sesame 2.3.1 or higher archive to a location of choice and place the <code>virt_sesame2.jar</code> or <code>virt_sesame4.jar</code> and <code>virtjdbc4.jar</code> files to the sesame "lib" directory 1 Start the [[http://www.openrdf.org/doc/sesame2/users/ch07.html#section-console-repository-creation][sesame console application]] by running the "console.bat" script in the sesame "bin" directory and then "exit." the program <verbatim> $ sh console.sh SLF4J: Class path contains multiple SLF4J bindings. SLF4J: Found binding in [jar:file:/Users/myuser/openrdf-sesame-2.3.1/lib/logback-classic-0.9.18.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: Found binding in [jar:file:/Users/myuser/openrdf-sesame-2.3.1/lib/slf4j-jdk14-1.5.10.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation. 10:32:38.317 [main] DEBUG info.aduna.platform.PlatformFactory - os.name <http://os.name> <http://os.name> = mac os x 10:32:38.351 [main] DEBUG info.aduna.platform.PlatformFactory - Detected Mac OS X platform Connected to default data directory Commands end with '.' at the end of a line Type 'help.' for help exit. </verbatim> 1 This will create the necessary sesame application data directories as detailed in the sesame [[http://www.openrdf.org/doc/sesame2/2.3.1/users/userguide.html#chapter-datadir-config][data directory configuration]] documentation. <verbatim> Windows - C:\Documents and Settings\LocalService\Application Data\Aduna\ Mac OS X - /Users/myuser/Library/Application Support/Aduna/ Linux - $HOME/.aduna/ </verbatim> 1 If you do not want to use the default sesame data directory location the Sesame console application can be started by specifying a custom data directory location with the "-d" option. Note in this case the directory "<nop>OpenRDF Sesame console" always has to be manually appended to the directory as Sesame assumes the data file will reside in a sub directory of this name. <verbatim> $ sh console.sh -d /Users/myuser/OpenRDF Sesame console </verbatim> 1 Add the <code>virtuoso.ttl</code> file to the <code>~/OpenRDF Sesame console/templates</code> folder, to enable the Virtuoso repository default configuration parameters to be located. 1 Start the sesame console application with the required data directory location and create a Virtuoso repository as detailed in the steps below, the key parameters to be specified being the target Virtuoso server hostname, port number, username, password and a unique "Repository ID". <verbatim> $ sh console.sh SLF4J: Class path contains multiple SLF4J bindings. SLF4J: Found binding in [jar:file:/Users/myuser/openrdf-sesame-2.3.1/lib/logback-classic-0.9.18.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: Found binding in [jar:file:/Users/myuser/openrdf-sesame-2.3.1/lib/slf4j-jdk14-1.5.10.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation. 10:32:38.317 [main] DEBUG info.aduna.platform.PlatformFactory - os.name <http://os.name> <http://os.name> = mac os x 10:32:38.351 [main] DEBUG info.aduna.platform.PlatformFactory - Detected Mac OS X platform Connected to default data directory Commands end with '.' at the end of a line Type 'help.' for help create virtuoso . Please specify values for the following variables: Host list [localhost:1111]: Username [dba]: Password [dba]: Default graph name [sesame:nil]: Enable using batch optimization (false|true) [false]: Use RoundRobin for connection (false|true) [false]: Buffer fetch size [200]: Inference RuleSet name [null]: Repository ID [virtuoso]: myvirt Repository title [Virtuoso repository]: Repository created show r . +---------- |SYSTEM |myvirt ("Virtuoso repository") +---------- open myvirt . Opened repository 'myvirt' myvirt> show n . +---------- |bif bif: |dawgt http://www.w3.org/2001/sw/DataAccess/tests/test-dawg# |dbpedia http://dbpedia.org/resource/ |dbpprop http://dbpedia.org/property/ |dc http://purl.org/dc/elements/1.1/ |foaf http://xmlns.com/foaf/0.1/ |geo http://www.w3.org/2003/01/geo/wgs84_pos# |go http://purl.org/obo/owl/GO# |math http://www.w3.org/2000/10/swap/math# |mesh http://purl.org/commons/record/mesh/ |mf http://www.w3.org/2001/sw/DataAccess/tests/test-manifest# |nci http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl# |obo http://www.geneontology.org/formats/oboInOwl# |owl http://www.w3.org/2002/07/owl# |protseq http://purl.org/science/protein/bysequence/ |rdf http://www.w3.org/1999/02/22-rdf-syntax-ns# |rdfdf http://www.openlinksw.com/virtrdf-data-formats# |rdfs http://www.w3.org/2000/01/rdf-schema# |sc http://purl.org/science/owl/sciencecommons/ |scovo http://purl.org/NET/scovo# |skos http://www.w3.org/2004/02/skos/core# |sql sql: |vcard http://www.w3.org/2001/vcard-rdf/3.0# |virtrdf http://www.openlinksw.com/schemas/virtrdf# |void http://rdfs.org/ns/void# |xf http://www.w3.org/2004/07/xpath-functions |xml http://www.w3.org/XML/1998/namespace |xsd http://www.w3.org/2001/XMLSchema# |xsl10 http://www.w3.org/XSL/Transform/1.0 |xsl1999 http://www.w3.org/1999/XSL/Transform |xslwd http://www.w3.org/TR/WD-xsl |yago http://dbpedia.org/class/yago/ +---------- exit. </verbatim> ---+++Connection to Sesame HTTP repository from Console repository The Sesame Console repository can connect to a Sesame HTTP repository and vice-versa, enabling access to remote Sesame HTTP repositories from a local server. 1 The Sesame Console repository can connect to a Sesame HTTP repository and query it as if local using the "connect" command. <verbatim> $ sh console.sh SLF4J: Class path contains multiple SLF4J bindings. SLF4J: Found binding in [jar:file:/Users/myuser/openrdf-sesame-2.3.1/lib/logback-classic-0.9.18.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: Found binding in [jar:file:/Users/myuser/openrdf-sesame-2.3.1/lib/slf4j-jdk14-1.5.10.jar!/org/slf4j/impl/StaticLoggerBinder.class] SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation. 10:32:38.317 [main] DEBUG info.aduna.platform.PlatformFactory - os.name <http://os.name> <http://os.name> = mac os x 10:32:38.351 [main] DEBUG info.aduna.platform.PlatformFactory - Detected Mac OS X platform Connected to default data directory Commands end with '.' at the end of a line Type 'help.' for help > connect http://localhost:8080/openrdf-sesame. Connected to http://localhost:8080/openrdf-sesame > show r. +---------- |SYSTEM ("System configuration repository") |VirtSesRep ("Virtuoso Sesame HTTP Repository") +---------- > open VirtSesRep. Opened repository 'VirtSesRep' VirtSesRep> sparql select * from <http://localhost:8890/Northwind> where {?s ?p ?o} Limit 10. Evaluating query... +------------------------+------------------------+------------------------+ | s | p | o | +------------------------+------------------------+------------------------+ | <http://localhost:8890/Northwind/CustomerContact/ALFKI#this>| rdf:type | foaf:Person | | <http://localhost:8890/Northwind/CustomerContact/ALFKI#this>| rdf:type | northwind:CustomerContact| | <http://localhost:8890/Northwind/CustomerContact/ALFKI#this>| opl:isDescribedUsing | northwind: | | <http://localhost:8890/Northwind/CustomerContact/ANATR#this>| rdf:type | foaf:Person | | <http://localhost:8890/Northwind/CustomerContact/ANATR#this>| rdf:type | northwind:CustomerContact| | <http://localhost:8890/Northwind/CustomerContact/ANATR#this>| opl:isDescribedUsing | northwind: | | <http://localhost:8890/Northwind/CustomerContact/ANTON#this>| rdf:type | foaf:Person | | <http://localhost:8890/Northwind/CustomerContact/ANTON#this>| rdf:type | northwind:CustomerContact| | <http://localhost:8890/Northwind/CustomerContact/ANTON#this>| opl:isDescribedUsing | northwind: | | <http://localhost:8890/Northwind/CustomerContact/AROUT#this>| rdf:type | foaf:Person | +------------------------+------------------------+------------------------+ 10 result(s) (530 ms) VirtSesRep> show n. +---------- |SearchResults http://www.zillow.com/static/xsd/SearchResults.xsd |UpdatedPropertyDetails http://www.zillow.com/static/xsd/UpdatedPropertyDetails.xsd |a http://www.w3.org/2005/Atom |aapi http://rdf.alchemyapi.com/rdf/v1/s/aapi-schema# |address http://schemas.talis.com/2005/address/schema# |admin http://webns.net/mvcb/ |amz http://webservices.amazon.com/AWSECommerceService/2005-10-05 |atom http://atomowl.org/ontologies/atomrdf# |audio http://purl.org/media/audio# |awol http://bblfish.net/work/atom-owl/2006-06-06/# |aws http://soap.amazon.com/ |b3s http://b3s.openlinksw.com/ </verbatim> 1 Conversely the Sesame HTTP repository can be configured to access the repository created by the Sesame console. To do this the location of the data directory for both needs to be reconfigured using the Java system property info.aduna.platform.appdata.basedir (does not include "<nop>OpenRDF Sesame console directory) to point to the same location. When you are using Tomcat as the servlet container then you can set this property using the JAVA_OPTS parameter. Note, if you are using Apache Tomcat as a Windows Service you should use the Windows Services configuration tool to set this property. Other users can either edit the Tomcat startup script or set the property some other way. <verbatim> * set JAVA_OPTS=-Dinfo.aduna.platform.appdata.basedir=\path\to\other\dir\ (on Windows) * export JAVA_OPTS='-Dinfo.aduna.platform.appdata.basedir=/path/to/other/dir/' (on Linux/UNIX/Mac OS X) </verbatim> <img src="%ATTACHURLPATH%/VirtSesame2HttpRepository01.png" style="wikiautogen"/> %BR% ---+++ Remote Sesame HTTP Repository Connections There are two methods of making a remote Sesame HTTP connection to a Virtuoso repository: * <b>Sesame Remote Repository Manager</b> class - A manager for Repositorys that reside on a remote server, allowing one to access repositories over HTTP similar to how local repositories are accessed using the LocalRepositoryManager. A connection via this method is made via the Virtuoso Sesame provider which will be faster and provide better support for transactions, than making a direct connection to the SPARQL endpoint using the HTTPRepository class. This is analogous to the ODBC Driver Manager in the ODBC realm for generic access to a data store via a suitable ODBC Driver. * <b>Sesame HTTP Repository</b> class - A repository that serves as a proxy for a remote repository on a Sesame server or directly to a SPARQL endpoint. This method does not make use of the Virtuoso Sesame Provider, using instead the HTTP protocol to make requests directly Sesame server or other SPARQL endpoint. ---++++ Using the Sesame Remote Repository Manager class If a Sesame HTTP Repository endpoint, as detailed above already exists, the [[http://www.openrdf.org/doc/sesame2/api/org/openrdf/repository/manager/RemoteRepositoryManager.html][Remote Repository Manager class]] can be used to make a remote connection as follows by specify the URL to the remote Sesame HTTP Server and the <nop>RepositoryID for the repository the connection is to be made to: <verbatim> //Initialize Remote Repository Manager RepositoryManager repositoryManager = new RemoteRepositoryManager( "http://hostname:portno/openrdf-sesame" ); repositoryManager.initialize(); //Set Virtuoso (or any other) repositoryID on http://hostname:portno/openrdf-sesame Repository repository = repositoryManager.getRepository("RepositoryID"); // Open a connection to this repository con = repository.getConnection(); // ... do something </verbatim> ---++++ Using the Sesame HTTP Repository class A direct connection to the default built-in Virtuoso SPARQL Endpoint can be made using the [[http://www.openrdf.org/doc/sesame2/api/org/openrdf/repository/http/HTTPRepository.html][Sesame HTTP Repository class]] by simply specifying the URL to the Virtuoso SPARQL Endpoint i.e. <code>http://{host}:{port}/sparql</code> as follows: <verbatim> // Initialize Direct SPARQL Endpoint HTTP Repository connection String endpointURL = "http://hostname:portno/sparql"; HTTPRepository sparqlEndpoint = new HTTPRepository(endpointURL, ""); sparqlEndpoint.initialize(); // Open a connection to this repository con = sparqlEndpoint.getConnection(); // ... do something </verbatim> ---++Related * [[VirtSesame2Provider][Virtuoso Sesame Provider]]

sioc:id

b7846d9d0506c56e299176be5d3b0472

sioc:link

n2:VirtSesame2HttpRepository

sioc:has_container

n23:ODS

n19:has_services

n18:item

atom:title

VirtSesame2HttpRepository

sioc:links_to

n4:html n6:jsp n7:html n15:section-console-repository-creation n20:openrdf-workbench n25:chapter-datadir-config n35:xsl n36:ttl n38:LocalRepositoryManager n40:xsl n47:html n49:cgi

atom:source

n23:ODS

atom:author

n8:this

atom:published

2017-06-13T06:07:33Z

atom:updated

2018-04-06T11:02:34Z

sioc:topic

n23:ODS

Subject Item

n2:VirtSesame2Provider

sioc:links_to

n2:VirtSesame2HttpRepository

Subject Item

n34:this

sioc:creator_of

n2:VirtSesame2HttpRepository