Document Information

Document ID: 

app2012-031

 

Pre-installation:

$sudo apt-get install tomcat6

$sudo apt-get install apache2

$sudo apt-get update

 

Install Sesame Server and Workbench:

Download the openRDF Sesame SDK: http://sourceforge.net/projects/sesame/files/Sesame%202/2.6.2/openrdf-sesame-2.6.2-sdk.zip

Extract “war/openrdf-sesame.war” and “war/openrdf-workbench.war”

 

Download Elda:

https://cgsrv1.arrc.csiro.au/swrepo/VocabService/jenkins/branches/Version-3.0/

Extract “sissvoc.war”

 

Copy openrdf-sesame.war, openrdf-workbench.war and sissvoc.war on the server’s Tomcat container (/var/lib/tomcat6/webapps), and restart tomcat6 ($sudo service tomcat6 restart)

 

Configure Services:

Create directory “/var/lib/tomcat6/data”

Change permission of data directory ($sudo chown tomcat6:tomcat6 /var/lib/tomcat6/data), or create a symbolic link for data directory ($ sudo ln –s /mnt/data/)

 

Edit “/etc/default/tomcat6”, and add to JAVA_OPTS: "-Dinfo.aduna.platform.appdata.basedir=/var/lib/tomcat6/data". (The repositories on sesame server will be deployed in this data directory.)

 

Add “ProxyPass/ProxyPassReverse” to the VirtualHost section in apache config “/etc/apache2/sites-enabled/000-default”, since our server does not open its 8080 port (Tomcat) to outside user:

ProxyPass /openrdf-workbench ajp://localhost:8009/openrdf-workbench

ProxyPassReverse /openrdf-workbench ajp://localhost:8009/openrdf-workbench

ProxyPass /openrdf-sesame ajp://localhost:8009/openrdf-sesame

ProxyPassReverse /openrdf-sesame ajp://localhost:8009/openrdf-sesame

ProxyPass /sissvoc ajp://localhost:8009/sissvoc

ProxyPassReverse /sissvoc ajp://localhost:8009/sissvoc

 

Edit apache config (“/etc/apache2/sites-enabled/000-default”) to avoid people from outside to change the sesame repositories:

#Only allow the server to change the repositories

<Location "/openrdf-sesame/repositories/">

     <LimitExcept GET>

           Order deny,allow

           Deny from all

           Allow from 23.21.155.132

     </LimitExcept>

</Location>

 

#Authentication to workbench

<Location "/openrdf-workbench">

     AuthType Basic

     AuthName "Input your username and password to access Sesame server"

     AuthUserFile /etc/apache2/auth/.htpasswd

     Require valid-user

</Location>

 

Note: .htpasswd file includes all the usernames and passwords. Use “$htpasswd –c /etc/apache2/auth/.htpasswd username” to generate the password.

 

Publish the vocabulary:

You can use OpenRDF Sesame Workbench, Sesame console and Sesame Windows Client (http://sourceforge.net/projects/sesamewinclient/) to load the vocabulary. Then you can get the vocabulary SPARQL endpoint, e.g. http://vocabulary.usgin.org/openrdf-sesame/repositories/usgin.vocabulary

 

Configure the http URI for concepts, so that http requests for these URIs are redirected to the suitable SISSvoc endpoints. Go to http://resources.usgin.org/admin/ for rewrite rule change using Regular Expression.

 

Clone and modify template specs/SISSvoc3-template-ELDAConfig.ttl to configure SISSvoc. Modify xsltsheets/ashtml.xsl to style the results. Create or change the LandingPage.jsp for the vocabulary.

 

Modify WEB-INF/web.xml, replacing the example configuration (in “servlet/param-value”) with a comma separated list of LDA specification files (e.g. ./usginVocab/usgin-vocabulary.ttl) you wish to load. Also replace welcome file (in “welcome-file-list/welcome-file”) with any page you want. Then you will need to restart Tomcat.

 

Test the Vocabulary Service:

http://vocabulary.usgin.org/sissvoc

http://vocabulary.usgin.org/openrdf-workbench/

http://vocabulary.usgin.org/sissvoc/api/meta/ (display all the sissvoc enpoints)